Repository: israellot/esp-ginx Branch: master Commit: b063b0901e6a Files: 379 Total size: 3.7 MB Directory structure: gitextract_iq5ciyeb/ ├── LICENSE ├── Makefile ├── README.md ├── app/ │ ├── .gitignore │ ├── Makefile │ ├── dns/ │ │ ├── Makefile │ │ ├── dns.c │ │ └── dns.h │ ├── driver/ │ │ ├── Makefile │ │ ├── gpio16.c │ │ ├── i2c_master.c │ │ ├── key.c │ │ ├── onewire.c │ │ ├── pwm.c │ │ ├── readline.c │ │ ├── relay.c │ │ ├── spi.c │ │ └── uart_interrupt.c │ ├── http/ │ │ ├── Makefile │ │ ├── app.c │ │ ├── app.h │ │ ├── cgi.c │ │ ├── cgi.h │ │ ├── cgi_relay.c │ │ ├── cgi_relay.h │ │ ├── cgi_wifi.c │ │ ├── cgi_wifi.h │ │ ├── html/ │ │ │ ├── .bak/ │ │ │ │ └── bootstrap.css │ │ │ ├── bootstrap.css │ │ │ ├── cats.html │ │ │ ├── index.html │ │ │ ├── index.js │ │ │ ├── lib.js │ │ │ └── speed_test.html │ │ ├── http.h │ │ ├── http_client.c │ │ ├── http_client.h │ │ ├── http_helper.c │ │ ├── http_helper.h │ │ ├── http_parser.c │ │ ├── http_parser.h │ │ ├── http_process.c │ │ ├── http_process.h │ │ ├── http_server.c │ │ ├── http_server.h │ │ ├── http_websocket_server.c │ │ ├── http_websocket_server.h │ │ ├── rofs.c │ │ ├── rofs.h │ │ ├── rofs_data.c │ │ ├── websocket.c │ │ ├── websocket.h │ │ ├── ws_app.c │ │ └── ws_app.h │ ├── include/ │ │ ├── arch/ │ │ │ ├── cc.h │ │ │ ├── perf.h │ │ │ └── sys_arch.h │ │ ├── driver/ │ │ │ ├── gpio16.h │ │ │ ├── i2c_master.h │ │ │ ├── key.h │ │ │ ├── onewire.h │ │ │ ├── pwm.h │ │ │ ├── relay.h │ │ │ ├── spi.h │ │ │ ├── spi_master.h │ │ │ ├── spi_register.h │ │ │ ├── uart.h │ │ │ └── uart_register.h │ │ ├── json/ │ │ │ └── cJson.h │ │ ├── lwip/ │ │ │ ├── api.h │ │ │ ├── api_msg.h │ │ │ ├── app/ │ │ │ │ ├── dhcpserver.h │ │ │ │ ├── espconn.h │ │ │ │ ├── espconn_tcp.h │ │ │ │ ├── espconn_udp.h │ │ │ │ └── ping.h │ │ │ ├── arch.h │ │ │ ├── autoip.h │ │ │ ├── debug.h │ │ │ ├── def.h │ │ │ ├── dhcp.h │ │ │ ├── dns.h │ │ │ ├── err.h │ │ │ ├── icmp.h │ │ │ ├── igmp.h │ │ │ ├── inet.h │ │ │ ├── inet_chksum.h │ │ │ ├── init.h │ │ │ ├── ip.h │ │ │ ├── ip_addr.h │ │ │ ├── ip_frag.h │ │ │ ├── mdns.h │ │ │ ├── mem.h │ │ │ ├── memp.h │ │ │ ├── memp_std.h │ │ │ ├── netbuf.h │ │ │ ├── netdb.h │ │ │ ├── netif.h │ │ │ ├── netifapi.h │ │ │ ├── opt.h │ │ │ ├── pbuf.h │ │ │ ├── puck_def.h │ │ │ ├── raw.h │ │ │ ├── sio.h │ │ │ ├── snmp.h │ │ │ ├── snmp_asn1.h │ │ │ ├── snmp_msg.h │ │ │ ├── snmp_structs.h │ │ │ ├── sntp.h │ │ │ ├── sockets.h │ │ │ ├── stats.h │ │ │ ├── sys.h │ │ │ ├── tcp.h │ │ │ ├── tcp_impl.h │ │ │ ├── tcpip.h │ │ │ ├── timers.h │ │ │ └── udp.h │ │ ├── lwipopts.h │ │ ├── mem_manager.h │ │ ├── netif/ │ │ │ ├── etharp.h │ │ │ ├── if_llc.h │ │ │ ├── ppp_oe.h │ │ │ └── wlan_lwip_if.h │ │ ├── pp/ │ │ │ └── esf_buf.h │ │ ├── serial_number.h │ │ ├── ssl/ │ │ │ ├── app/ │ │ │ │ ├── espconn_secure.h │ │ │ │ └── espconn_ssl.h │ │ │ ├── cert.h │ │ │ ├── private_key.h │ │ │ ├── ssl_bigint.h │ │ │ ├── ssl_bigint_impl.h │ │ │ ├── ssl_cert.h │ │ │ ├── ssl_config.h │ │ │ ├── ssl_crypto.h │ │ │ ├── ssl_crypto_misc.h │ │ │ ├── ssl_os_int.h │ │ │ ├── ssl_os_port.h │ │ │ ├── ssl_private_key.h │ │ │ ├── ssl_ssl.h │ │ │ ├── ssl_tls1.h │ │ │ └── ssl_version.h │ │ ├── user_config.h │ │ └── xtensa/ │ │ ├── cacheasm.h │ │ ├── cacheattrasm.h │ │ ├── config/ │ │ │ ├── core-isa.h │ │ │ ├── core-matmap.h │ │ │ ├── core.h │ │ │ ├── defs.h │ │ │ ├── specreg.h │ │ │ ├── system.h │ │ │ ├── tie-asm.h │ │ │ └── tie.h │ │ ├── coreasm.h │ │ ├── corebits.h │ │ ├── hal.h │ │ ├── sim.h │ │ ├── simcall-errno.h │ │ ├── simcall-fcntl.h │ │ ├── simcall.h │ │ ├── specreg.h │ │ ├── tie/ │ │ │ ├── xt_MUL32.h │ │ │ ├── xt_core.h │ │ │ ├── xt_debug.h │ │ │ ├── xt_density.h │ │ │ ├── xt_exceptions.h │ │ │ ├── xt_externalregisters.h │ │ │ ├── xt_interrupt.h │ │ │ ├── xt_misc.h │ │ │ ├── xt_mmu.h │ │ │ ├── xt_mul.h │ │ │ ├── xt_timer.h │ │ │ └── xt_trace.h │ │ ├── xtensa-libdb-macros.h │ │ ├── xtensa-xer.h │ │ ├── xtruntime-frames.h │ │ └── xtruntime.h │ ├── json/ │ │ ├── Makefile │ │ └── cJson.c │ ├── libc/ │ │ ├── Makefile │ │ ├── c_ctype.c │ │ ├── c_ctype.h │ │ ├── c_errno.h │ │ ├── c_fcntl.h │ │ ├── c_limits.h │ │ ├── c_locale.h │ │ ├── c_math.c │ │ ├── c_math.h │ │ ├── c_signal.h │ │ ├── c_stdarg.h │ │ ├── c_stddef.h │ │ ├── c_stdint.h │ │ ├── c_stdio.c │ │ ├── c_stdio.h │ │ ├── c_stdlib.c │ │ ├── c_stdlib.h │ │ ├── c_string.c │ │ └── c_string.h │ ├── lwip/ │ │ ├── Makefile │ │ ├── api/ │ │ │ ├── Makefile │ │ │ ├── api_lib.c │ │ │ ├── api_msg.c │ │ │ ├── err.c │ │ │ ├── netbuf.c │ │ │ ├── netdb.c │ │ │ ├── netifapi.c │ │ │ ├── sockets.c │ │ │ └── tcpip.c │ │ ├── app/ │ │ │ ├── Makefile │ │ │ ├── dhcpserver.c │ │ │ ├── espconn.c │ │ │ ├── espconn_mdns.c │ │ │ ├── espconn_tcp.c │ │ │ ├── espconn_udp.c │ │ │ ├── netio.c │ │ │ └── ping.c │ │ ├── core/ │ │ │ ├── Makefile │ │ │ ├── def.c │ │ │ ├── dhcp.c │ │ │ ├── dns.c │ │ │ ├── init.c │ │ │ ├── ipv4/ │ │ │ │ ├── Makefile │ │ │ │ ├── autoip.c │ │ │ │ ├── icmp.c │ │ │ │ ├── igmp.c │ │ │ │ ├── inet.c │ │ │ │ ├── inet_chksum.c │ │ │ │ ├── ip.c │ │ │ │ ├── ip_addr.c │ │ │ │ └── ip_frag.c │ │ │ ├── mdns.c │ │ │ ├── mem.c │ │ │ ├── memp.c │ │ │ ├── netif.c │ │ │ ├── pbuf.c │ │ │ ├── raw.c │ │ │ ├── sntp.c │ │ │ ├── stats.c │ │ │ ├── sys.c │ │ │ ├── sys_arch.c │ │ │ ├── tcp.c │ │ │ ├── tcp_in.c │ │ │ ├── tcp_out.c │ │ │ ├── timers.c │ │ │ └── udp.c │ │ └── netif/ │ │ ├── Makefile │ │ └── etharp.c │ ├── mqtt/ │ │ ├── Makefile │ │ ├── app.c │ │ ├── app.h │ │ ├── mqtt.c │ │ ├── mqtt.h │ │ ├── mqtt_msg.c │ │ ├── mqtt_msg.h │ │ ├── proto.c │ │ ├── proto.h │ │ ├── queue.c │ │ ├── queue.h │ │ ├── ringbuf.c │ │ ├── ringbuf.h │ │ ├── typedef.h │ │ ├── utils.c │ │ └── utils.h │ ├── platform/ │ │ ├── Makefile │ │ ├── common.c │ │ ├── common.h │ │ ├── config.c │ │ ├── config.h │ │ ├── cpu_esp8266.h │ │ ├── flash_api.c │ │ ├── flash_api.h │ │ ├── flash_fs.c │ │ ├── flash_fs.h │ │ ├── pin_map.c │ │ ├── pin_map.h │ │ ├── platform.c │ │ └── platform.h │ ├── sensor/ │ │ ├── Makefile │ │ ├── bmp180.c │ │ ├── bmp180.h │ │ ├── dht22.c │ │ ├── dht22.h │ │ ├── ds18b20.c │ │ ├── ds18b20.h │ │ ├── sensors.c │ │ └── sensors.h │ ├── smart/ │ │ ├── Makefile │ │ ├── smart.c │ │ └── smart.h │ ├── spiffs/ │ │ ├── Makefile │ │ ├── docs/ │ │ │ ├── IMPLEMENTING │ │ │ ├── INTEGRATION │ │ │ ├── TECH_SPEC │ │ │ └── TODO │ │ ├── params_test.h │ │ ├── spiffs.c │ │ ├── spiffs.h │ │ ├── spiffs_cache.c │ │ ├── spiffs_check.c │ │ ├── spiffs_config.h │ │ ├── spiffs_gc.c │ │ ├── spiffs_hydrogen.c │ │ ├── spiffs_nucleus.c │ │ └── spiffs_nucleus.h │ ├── ssl/ │ │ ├── Makefile │ │ ├── app/ │ │ │ ├── Makefile │ │ │ ├── espconn_secure.c │ │ │ └── espconn_ssl.c │ │ ├── crypto/ │ │ │ ├── Makefile │ │ │ ├── ssl_aes.c │ │ │ ├── ssl_bigint.c │ │ │ ├── ssl_crypto_misc.c │ │ │ ├── ssl_hmac.c │ │ │ ├── ssl_md2.c │ │ │ ├── ssl_md5.c │ │ │ ├── ssl_rc4.c │ │ │ ├── ssl_rsa.c │ │ │ └── ssl_sha1.c │ │ └── ssl/ │ │ ├── Makefile │ │ ├── ssl_asn1.c │ │ ├── ssl_gen_cert.c │ │ ├── ssl_loader.c │ │ ├── ssl_openssl.c │ │ ├── ssl_os_port.c │ │ ├── ssl_p12.c │ │ ├── ssl_tls1.c │ │ ├── ssl_tls1_clnt.c │ │ ├── ssl_tls1_svr.c │ │ └── ssl_x509.c │ ├── user/ │ │ ├── Makefile │ │ └── user_main.c │ └── util/ │ ├── Makefile │ ├── base64.c │ ├── base64.h │ ├── linked_list.c │ └── linked_list.h ├── bin/ │ └── .gitignore ├── include/ │ ├── at_custom.h │ ├── c_types.h │ ├── eagle_soc.h │ ├── espconn.h │ ├── espnow.h │ ├── ets_sys.h │ ├── gpio.h │ ├── ip_addr.h │ ├── mem.h │ ├── mesh.h │ ├── os_type.h │ ├── osapi.h │ ├── ping.h │ ├── pwm.h │ ├── queue.h │ ├── smartconfig.h │ ├── sntp.h │ ├── spi_flash.h │ ├── upgrade.h │ └── user_interface.h ├── ld/ │ ├── eagle.app.v6.ld │ └── eagle.rom.addr.v6.ld ├── lib/ │ ├── libat.a │ ├── libcrypto.a │ ├── libespnow.a │ ├── libjson.a │ ├── liblwip.a │ ├── liblwip_536.a │ ├── libmain.a │ ├── libmesh.a │ ├── libnet80211.a │ ├── libphy.a │ ├── libpp.a │ ├── libpwm.a │ ├── libsmartconfig.a │ ├── libssl.a │ ├── libupgrade.a │ ├── libwpa.a │ └── libwps.a └── tools/ ├── .gitattributes ├── esptool.py ├── makefile.sh └── mkfs.py ================================================ FILE CONTENTS ================================================ ================================================ FILE: LICENSE ================================================ The MIT License (MIT) Copyright (c) 2015 Israel Lot 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. ================================================ FILE: Makefile ================================================ # copyright (c) 2010 Espressif System # ifndef PDIR endif # Base directory for the compiler XTENSA_TOOLS_ROOT ?= /opt/xtensa-lx106-elf/bin ############################################################# # Select compile # ifeq ($(OS),Windows_NT) # WIN32 # We are under windows. ifeq ($(XTENSA_CORE),lx106) # It is xcc AR = xt-ar CC = xt-xcc NM = xt-nm CPP = xt-cpp OBJCOPY = xt-objcopy #MAKE = xt-make CCFLAGS += -Os --rename-section .text=.irom0.text --rename-section .literal=.irom0.literal else # It is gcc, may be cygwin # Can we use -fdata-sections? CCFLAGS += -Os -ffunction-sections -fno-jump-tables AR = xtensa-lx106-elf-ar CC = xtensa-lx106-elf-gcc NM = xtensa-lx106-elf-nm CPP = xtensa-lx106-elf-cpp OBJCOPY = xtensa-lx106-elf-objcopy endif FIRMWAREDIR = ..\\bin\\ ifndef COMPORT ESPPORT = com1 else ESPPORT = $(COMPORT) endif ifeq ($(PROCESSOR_ARCHITECTURE),AMD64) # ->AMD64 endif ifeq ($(PROCESSOR_ARCHITECTURE),x86) # ->IA32 endif else # We are under other system, may be Linux. Assume using gcc. # Can we use -fdata-sections? ifndef COMPORT ESPPORT = /dev/ttyUSB0 else ESPPORT = $(COMPORT) endif CCFLAGS += -Os -ffunction-sections -fno-jump-tables AR = xtensa-lx106-elf-ar CC = xtensa-lx106-elf-gcc NM = xtensa-lx106-elf-nm CPP = xtensa-lx106-elf-cpp OBJCOPY = xtensa-lx106-elf-objcopy FIRMWAREDIR = ../bin/ UNAME_S := $(shell uname -s) ifeq ($(UNAME_S),Linux) # LINUX endif ifeq ($(UNAME_S),Darwin) # OSX endif UNAME_P := $(shell uname -p) ifeq ($(UNAME_P),x86_64) # ->AMD64 endif ifneq ($(filter %86,$(UNAME_P)),) # ->IA32 endif ifneq ($(filter arm%,$(UNAME_P)),) # ->ARM endif endif ############################################################# ESPTOOL ?= ../tools/esptool.py MKFSTOOL ?= tools/mkfs.py CSRCS ?= $(wildcard *.c) ASRCs ?= $(wildcard *.s) ASRCS ?= $(wildcard *.S) SUBDIRS ?= $(patsubst %/,%,$(dir $(wildcard */Makefile))) ODIR := .output OBJODIR := $(ODIR)/$(TARGET)/$(FLAVOR)/obj OBJS := $(CSRCS:%.c=$(OBJODIR)/%.o) \ $(ASRCs:%.s=$(OBJODIR)/%.o) \ $(ASRCS:%.S=$(OBJODIR)/%.o) DEPS := $(CSRCS:%.c=$(OBJODIR)/%.d) \ $(ASRCs:%.s=$(OBJODIR)/%.d) \ $(ASRCS:%.S=$(OBJODIR)/%.d) LIBODIR := $(ODIR)/$(TARGET)/$(FLAVOR)/lib OLIBS := $(GEN_LIBS:%=$(LIBODIR)/%) IMAGEODIR := $(ODIR)/$(TARGET)/$(FLAVOR)/image OIMAGES := $(GEN_IMAGES:%=$(IMAGEODIR)/%) BINODIR := $(ODIR)/$(TARGET)/$(FLAVOR)/bin OBINS := $(GEN_BINS:%=$(BINODIR)/%) CCFLAGS += \ -g \ -O2 \ -Wpointer-arith \ -Wundef \ -Werror \ -Wl,-EL \ -fno-inline-functions \ -nostdlib \ -mlongcalls \ -mtext-section-literals \ # -Wall CFLAGS = $(CCFLAGS) $(DEFINES) $(EXTRA_CCFLAGS) $(INCLUDES) DFLAGS = $(CCFLAGS) $(DDEFINES) $(EXTRA_CCFLAGS) $(INCLUDES) ############################################################# # Functions # define ShortcutRule $(1): .subdirs $(2)/$(1) endef define MakeLibrary DEP_LIBS_$(1) = $$(foreach lib,$$(filter %.a,$$(COMPONENTS_$(1))),$$(dir $$(lib))$$(LIBODIR)/$$(notdir $$(lib))) DEP_OBJS_$(1) = $$(foreach obj,$$(filter %.o,$$(COMPONENTS_$(1))),$$(dir $$(obj))$$(OBJODIR)/$$(notdir $$(obj))) $$(LIBODIR)/$(1).a: $$(OBJS) $$(DEP_OBJS_$(1)) $$(DEP_LIBS_$(1)) $$(DEPENDS_$(1)) @mkdir -p $$(LIBODIR) $$(if $$(filter %.a,$$?),mkdir -p $$(EXTRACT_DIR)_$(1)) $$(if $$(filter %.a,$$?),cd $$(EXTRACT_DIR)_$(1); $$(foreach lib,$$(filter %.a,$$?),$$(AR) xo $$(UP_EXTRACT_DIR)/$$(lib);)) $$(AR) ru $$@ $$(filter %.o,$$?) $$(if $$(filter %.a,$$?),$$(EXTRACT_DIR)_$(1)/*.o) $$(if $$(filter %.a,$$?),$$(RM) -r $$(EXTRACT_DIR)_$(1)) endef define MakeImage DEP_LIBS_$(1) = $$(foreach lib,$$(filter %.a,$$(COMPONENTS_$(1))),$$(dir $$(lib))$$(LIBODIR)/$$(notdir $$(lib))) DEP_OBJS_$(1) = $$(foreach obj,$$(filter %.o,$$(COMPONENTS_$(1))),$$(dir $$(obj))$$(OBJODIR)/$$(notdir $$(obj))) $$(IMAGEODIR)/$(1).out: $$(OBJS) $$(DEP_OBJS_$(1)) $$(DEP_LIBS_$(1)) $$(DEPENDS_$(1)) @mkdir -p $$(IMAGEODIR) $$(CC) $$(LDFLAGS) $$(if $$(LINKFLAGS_$(1)),$$(LINKFLAGS_$(1)),$$(LINKFLAGS_DEFAULT) $$(OBJS) $$(DEP_OBJS_$(1)) $$(DEP_LIBS_$(1))) -o $$@ endef $(BINODIR)/%.bin: $(IMAGEODIR)/%.out @mkdir -p $(BINODIR) $(ESPTOOL) elf2image $< -o $(FIRMWAREDIR) ############################################################# # Rules base # Should be done in top-level makefile only # all: .subdirs $(OBJS) $(OLIBS) $(OIMAGES) $(OBINS) $(SPECIAL_MKTARGETS) clean: $(foreach d, $(SUBDIRS), $(MAKE) -C $(d) clean;) $(RM) -r $(ODIR)/$(TARGET)/$(FLAVOR) clobber: $(SPECIAL_CLOBBER) $(foreach d, $(SUBDIRS), $(MAKE) -C $(d) clobber;) $(RM) -r $(ODIR) flash: ifndef PDIR $(MAKE) -C ./app flash else $(ESPTOOL) --port $(ESPPORT) write_flash 0x00000 $(FIRMWAREDIR)0x00000.bin 0x10000 $(FIRMWAREDIR)0x10000.bin endif html: $(MKFSTOOL) -s app/http/html/ -d app/http/rofs_data.c .subdirs: @set -e; $(foreach d, $(SUBDIRS), $(MAKE) -C $(d);) #.subdirs: # $(foreach d, $(SUBDIRS), $(MAKE) -C $(d)) ifneq ($(MAKECMDGOALS),clean) ifneq ($(MAKECMDGOALS),clobber) ifdef DEPS sinclude $(DEPS) endif endif endif $(OBJODIR)/%.o: %.c @mkdir -p $(OBJODIR); $(CC) $(if $(findstring $<,$(DSRCS)),$(DFLAGS),$(CFLAGS)) $(COPTS_$(*F)) -o $@ -c $< $(OBJODIR)/%.d: %.c @mkdir -p $(OBJODIR); @echo DEPEND: $(CC) -M $(CFLAGS) $< @set -e; rm -f $@; \ $(CC) -M $(CFLAGS) $< > $@.$$$$; \ sed 's,\($*\.o\)[ :]*,$(OBJODIR)/\1 $@ : ,g' < $@.$$$$ > $@; \ rm -f $@.$$$$ $(OBJODIR)/%.o: %.s @mkdir -p $(OBJODIR); $(CC) $(CFLAGS) -o $@ -c $< $(OBJODIR)/%.d: %.s @mkdir -p $(OBJODIR); \ set -e; rm -f $@; \ $(CC) -M $(CFLAGS) $< > $@.$$$$; \ sed 's,\($*\.o\)[ :]*,$(OBJODIR)/\1 $@ : ,g' < $@.$$$$ > $@; \ rm -f $@.$$$$ $(OBJODIR)/%.o: %.S @mkdir -p $(OBJODIR); $(CC) $(CFLAGS) -D__ASSEMBLER__ -o $@ -c $< $(OBJODIR)/%.d: %.S @mkdir -p $(OBJODIR); \ set -e; rm -f $@; \ $(CC) -M $(CFLAGS) $< > $@.$$$$; \ sed 's,\($*\.o\)[ :]*,$(OBJODIR)/\1 $@ : ,g' < $@.$$$$ > $@; \ rm -f $@.$$$$ $(foreach lib,$(GEN_LIBS),$(eval $(call ShortcutRule,$(lib),$(LIBODIR)))) $(foreach image,$(GEN_IMAGES),$(eval $(call ShortcutRule,$(image),$(IMAGEODIR)))) $(foreach bin,$(GEN_BINS),$(eval $(call ShortcutRule,$(bin),$(BINODIR)))) $(foreach lib,$(GEN_LIBS),$(eval $(call MakeLibrary,$(basename $(lib))))) $(foreach image,$(GEN_IMAGES),$(eval $(call MakeImage,$(basename $(image))))) ############################################################# # Recursion Magic - Don't touch this!! # # Each subtree potentially has an include directory # corresponding to the common APIs applicable to modules # rooted at that subtree. Accordingly, the INCLUDE PATH # of a module can only contain the include directories up # its parent path, and not its siblings # # Required for each makefile to inherit from the parent # INCLUDES := $(INCLUDES) -I $(PDIR)include -I $(PDIR)include/$(TARGET) PDIR := ../$(PDIR) sinclude $(PDIR)Makefile ================================================ FILE: README.md ================================================ esp-ginx -------- ##Robust HTTP server for the ESP8266 This project was inspired esp-httpd by Sprite_tm, NodeMcu ( https://github.com/nodemcu/nodemcu-firmware ) and NGINX Main features ============= 1. Event-driven, single threaded. No blocking, nowhere. 2. DNS Server built in, means we have a captive portal ( will open upon connection os most phones and computers ) 3. Host check, means we can ensure server is on here.com and not there.com 4. Redirects ( so #2 will work ) 5. HTTP Method enforcement 7. URL rewrite ( very simple one but gives us friendly urls) 8. CGI ( similar to esp-httpd but with more features ) 9. CORS enabled 10. Zero-copy ( or almost ) request parse, inspired on NGINX parse. 11. ROFS compressed with gzip 12. WebSockects! 12. Bonus http client :) Overview ------- After playing around with esp-httpd I decided to extend it and ended up deciding to take it to the next level. I've used the NodeMcu firmware as base, removed all the lua related code and got a solid framework to work on. Later I ported Joyent's http parser (https://github.com/joyent/http-parser), which is almost the NGINX implementation, to the esp and developed from there. The File System --------------- I personally didn't like the overhead of decompressing static files to send over http as in esp-httpd, so I created a rom file system that consists of a static FS descriptor and an array with the data concatenated. To keep size short, I compress the files with gzip and send the compressed data stream with the gzip content-encoding. I could fit the whole bootstrap css+js files even if I didn't need to, plus cats pictures to honor Sprite_tm. Static files are placed in the folder 'html' and there's a tool written in python to create the file system. The file system in the end id just a c file. Issuing 'Make html' creates/updates the file system. There's a Spiffs built on the firmware, so a next step should be use it instead, but for my needs right now a static FS is enough. CGI --- I don't believe in template html for such low memory devices. I rather prefer the static html + json api approach. So that's what you will see. When a request arrives, the server will start to parse it and call a cgi dispatcher on several points of the process, mainly on the http parser callbacks. This allows me to reject a request even before the body was received for example. It also allows me not to copy unnecessary data to the precious ESP memory. CGI functions can say which headers they need to read and the parser will extract them as the data comes. We never save the whole request on a buffer. CGI functions are very flexible. They can allow other rules to proccess or keep the processing to themselfs. We can plugin features like request filtering by inserting wildcard cgi functions on the pipe for example. CORS cgi will plug itself on the pre-headers received and post headers received only. DNS server and Captive Portal --------- I wanted to have captive portal-like featured on the server. To do so the first step was to compile our own version of LwIP stack so we can enable DNS server announce via DHCP. Fortunatelly NodeMCU had LwIP sources already. We then need to answer some known domains queries with our own ip, so we can capture those requests. Iphones for example to detect captive portal will issue a request to some random apple owned domains expecting 200 OK response, if we respond those requests with a redirect, voilà, the phone will open a login page with anything we like. It also works on PCs, windows will issue a requet to msftncsi.com to check for internet connection. When we redirect it, it will open our esp-ginx server on our loved browser. There's a list of knows domains on the DNS server. I could just answer all DNS queries with our esp ip, but it would then flood our little esp with nonsense http requests. Websockets --- Why? Mostly because I didn't see it around. I use it to speed test the esp's tcp capabilities, so a very simple application is written on top of the websocket stack that will keep flushing tcp packets of the chosen size so we can measure how many bytes / second we receive on the other end. The Demo -------- This demo application assumes: * Relays connects to GPIO 5 and 4 * DHT22 sensor connected to GPIO 2 You can : * Scan available wifi networks * Connect to an wifi network * Direct test the relays * Read temperature and humidity data * Do a tcp speed test on ESP8266 using websockets ( no more discussion about it, data wins ) * See the required pictures of cats ![Speed Test](http://i.gyazo.com/89e3fcea70641e871a3bfbaf5d116d66.png) ================================================ FILE: app/.gitignore ================================================ *.output* !.gitignore ================================================ FILE: app/Makefile ================================================ ############################################################# # Required variables for each makefile # Discard this section from all parent makefiles # Expected variables (with automatic defaults): # CSRCS (all "C" files in the dir) # SUBDIRS (all subdirs with a Makefile) # GEN_LIBS - list of libs to be generated () # GEN_IMAGES - list of object file images to be generated () # GEN_BINS - list of binaries to be generated () # COMPONENTS_xxx - a list of libs/objs in the form # subdir/lib to be extracted and rolled up into # a generated lib/image xxx.a () # TARGET = eagle #FLAVOR = release FLAVOR = debug #EXTRA_CCFLAGS += -u ifndef PDIR # { GEN_IMAGES= eagle.app.v6.out GEN_BINS= eagle.app.v6.bin SPECIAL_MKTARGETS=$(APP_MKTARGETS) SUBDIRS= \ user \ http \ dns \ driver \ lwip \ json \ platform \ libc \ mqtt \ smart \ util \ sensor \ spiffs endif # } PDIR APPDIR = . LDDIR = ../ld CCFLAGS += -Os TARGET_LDFLAGS = \ -nostdlib \ -Wl,-EL \ --longcalls \ --text-section-literals ifeq ($(FLAVOR),debug) TARGET_LDFLAGS += -g -O2 endif ifeq ($(FLAVOR),release) TARGET_LDFLAGS += -g -O0 endif LD_FILE = $(LDDIR)/eagle.app.v6.ld ifeq ($(APP), 1) LD_FILE = $(LDDIR)/eagle.app.v6.app1.ld endif ifeq ($(APP), 2) LD_FILE = $(LDDIR)/eagle.app.v6.app2.ld endif COMPONENTS_eagle.app.v6 = \ user/libuser.a \ http/http.a \ dns/dns.a \ driver/libdriver.a \ lwip/liblwip.a \ json/libjson.a \ platform/libplatform.a \ libc/liblibc.a \ mqtt/mqtt.a \ smart/smart.a \ util/util.a \ sensor/sensors.a \ spiffs/spiffs.a LINKFLAGS_eagle.app.v6 = \ -L../lib \ -nostdlib \ -T$(LD_FILE) \ -Wl,--no-check-sections \ -u call_user_start \ -Wl,-static \ -Wl,--start-group \ -lc \ -lgcc \ -lhal \ -lphy \ -lpp \ -lnet80211 \ -lwpa \ -lmain \ -ljson \ -lsmartconfig \ -lssl \ $(DEP_LIBS_eagle.app.v6) \ -Wl,--end-group DEPENDS_eagle.app.v6 = \ $(LD_FILE) \ $(LDDIR)/eagle.rom.addr.v6.ld ############################################################# # Configuration i.e. compile options etc. # Target specific stuff (defines etc.) goes in here! # Generally values applying to a tree are captured in the # makefile at its root level - these are then overridden # for a subtree within the makefile rooted therein # #UNIVERSAL_TARGET_DEFINES = \ # Other potential configuration flags include: # -DTXRX_TXBUF_DEBUG # -DTXRX_RXBUF_DEBUG # -DWLAN_CONFIG_CCX CONFIGURATION_DEFINES = -D__ets__ \ -DICACHE_FLASH \ -DLWIP_OPEN_SRC \ -DPBUF_RSV_FOR_WLAN \ -DEBUF_LWIP DEFINES += \ $(UNIVERSAL_TARGET_DEFINES) \ $(CONFIGURATION_DEFINES) DDEFINES += \ $(UNIVERSAL_TARGET_DEFINES) \ $(CONFIGURATION_DEFINES) ############################################################# # Recursion Magic - Don't touch this!! # # Each subtree potentially has an include directory # corresponding to the common APIs applicable to modules # rooted at that subtree. Accordingly, the INCLUDE PATH # of a module can only contain the include directories up # its parent path, and not its siblings # # Required for each makefile to inherit from the parent # INCLUDES := $(INCLUDES) -I $(PDIR)include INCLUDES += -I ./ PDIR := ../$(PDIR) sinclude $(PDIR)Makefile .PHONY: FORCE FORCE: ================================================ FILE: app/dns/Makefile ================================================ ############################################################# # Required variables for each makefile # Discard this section from all parent makefiles # Expected variables (with automatic defaults): # CSRCS (all "C" files in the dir) # SUBDIRS (all subdirs with a Makefile) # GEN_LIBS - list of libs to be generated () # GEN_IMAGES - list of images to be generated () # COMPONENTS_xxx - a list of libs/objs in the form # subdir/lib to be extracted and rolled up into # a generated lib/image xxx.a () # ifndef PDIR GEN_LIBS = dns.a endif ############################################################# # Configuration i.e. compile options etc. # Target specific stuff (defines etc.) goes in here! # Generally values applying to a tree are captured in the # makefile at its root level - these are then overridden # for a subtree within the makefile rooted therein # #DEFINES += ############################################################# # Recursion Magic - Don't touch this!! # # Each subtree potentially has an include directory # corresponding to the common APIs applicable to modules # rooted at that subtree. Accordingly, the INCLUDE PATH # of a module can only contain the include directories up # its parent path, and not its siblings # # Required for each makefile to inherit from the parent # INCLUDES := $(INCLUDES) -I $(PDIR)include INCLUDES += -I ./ INCLUDES += -I ../libc PDIR := ../$(PDIR) sinclude $(PDIR)Makefile ================================================ FILE: app/dns/dns.c ================================================ #include "c_types.h" #include "user_interface.h" #include "user_config.h" #include "espconn.h" #include "mem.h" #include "osapi.h" //Listening connection data static struct espconn dnsConn; static esp_udp dnsUdp; static const char *localDomains[]={ INTERFACE_DOMAIN, //because I can be anybody //captive portal domains "google.com", //android , yes I can be Google too "gsp1.apple.com", //iphone "akamaitechnologies.com", "apple.com", "appleiphonecell.com", "itools.info", "ibook.info", "airport.us", "thinkdifferent.us", "apple.com.edgekey.net", "akamaiedge.net", "msftncsi.com", //for windows and windows phone, "microsoft.com", NULL }; static int ICACHE_FLASH_ATTR isKnownDNS(char *dns){ int i=0; while(true){ const char *cmp = localDomains[i]; if(cmp==NULL) break; if(strstr(dns,cmp)) return 1; i++; } return 0; } static void ICACHE_FLASH_ATTR dnsQueryReceived(void *arg, char *data, unsigned short length) { // parse incoming query domain char domain[30]; char *writePos=domain; memset(domain,0,30); int offSet=12; int len=data[offSet]; while(len!=0 && offSetproto.udp->remote_ip; //NODE_DBG("UDP send res : %d ip: %d.%d.%d.%d , port: %d",ret,ip[0],ip[1],ip[2],ip[3],conn->proto.udp->remote_port); } void ICACHE_FLASH_ATTR init_dns() { uint8_t mode = 1; wifi_softap_set_dhcps_offer_option(OFFER_ROUTER, &mode); wifi_set_broadcast_if(3); //espconn_disconnect(&dnsConn); espconn_delete(&dnsConn); dnsConn.type=ESPCONN_UDP; dnsConn.state=ESPCONN_NONE; dnsUdp.local_port=(int)53; dnsConn.proto.udp=&dnsUdp; espconn_regist_recvcb(&dnsConn, dnsQueryReceived); int res = espconn_create(&dnsConn); NODE_DBG("DNS server init, conn=%p , status=%d", &dnsConn,res); } ================================================ FILE: app/dns/dns.h ================================================ #ifndef DNS_H #define DNS_H void ICACHE_FLASH_ATTR init_dns(); #endif ================================================ FILE: app/driver/Makefile ================================================ ############################################################# # Required variables for each makefile # Discard this section from all parent makefiles # Expected variables (with automatic defaults): # CSRCS (all "C" files in the dir) # SUBDIRS (all subdirs with a Makefile) # GEN_LIBS - list of libs to be generated () # GEN_IMAGES - list of images to be generated () # COMPONENTS_xxx - a list of libs/objs in the form # subdir/lib to be extracted and rolled up into # a generated lib/image xxx.a () # ifndef PDIR GEN_LIBS = libdriver.a endif ############################################################# # Configuration i.e. compile options etc. # Target specific stuff (defines etc.) goes in here! # Generally values applying to a tree are captured in the # makefile at its root level - these are then overridden # for a subtree within the makefile rooted therein # #DEFINES += ############################################################# # Recursion Magic - Don't touch this!! # # Each subtree potentially has an include directory # corresponding to the common APIs applicable to modules # rooted at that subtree. Accordingly, the INCLUDE PATH # of a module can only contain the include directories up # its parent path, and not its siblings # # Required for each makefile to inherit from the parent # INCLUDES := $(INCLUDES) -I $(PDIR)include INCLUDES += -I ./ INCLUDES += -I ../ INCLUDES += -I ../platform INCLUDES += -I ../libc PDIR := ../$(PDIR) sinclude $(PDIR)Makefile ================================================ FILE: app/driver/gpio16.c ================================================ #include "ets_sys.h" #include "osapi.h" #include "driver/gpio16.h" void ICACHE_FLASH_ATTR gpio16_output_conf(void) { WRITE_PERI_REG(PAD_XPD_DCDC_CONF, (READ_PERI_REG(PAD_XPD_DCDC_CONF) & 0xffffffbc) | (uint32)0x1); // mux configuration for XPD_DCDC to output rtc_gpio0 WRITE_PERI_REG(RTC_GPIO_CONF, (READ_PERI_REG(RTC_GPIO_CONF) & (uint32)0xfffffffe) | (uint32)0x0); //mux configuration for out enable WRITE_PERI_REG(RTC_GPIO_ENABLE, (READ_PERI_REG(RTC_GPIO_ENABLE) & (uint32)0xfffffffe) | (uint32)0x1); //out enable } void ICACHE_FLASH_ATTR gpio16_output_set(uint8 value) { WRITE_PERI_REG(RTC_GPIO_OUT, (READ_PERI_REG(RTC_GPIO_OUT) & (uint32)0xfffffffe) | (uint32)(value & 1)); } void ICACHE_FLASH_ATTR gpio16_input_conf(void) { WRITE_PERI_REG(PAD_XPD_DCDC_CONF, (READ_PERI_REG(PAD_XPD_DCDC_CONF) & 0xffffffbc) | (uint32)0x1); // mux configuration for XPD_DCDC and rtc_gpio0 connection WRITE_PERI_REG(RTC_GPIO_CONF, (READ_PERI_REG(RTC_GPIO_CONF) & (uint32)0xfffffffe) | (uint32)0x0); //mux configuration for out enable WRITE_PERI_REG(RTC_GPIO_ENABLE, READ_PERI_REG(RTC_GPIO_ENABLE) & (uint32)0xfffffffe); //out disable } uint8 ICACHE_FLASH_ATTR gpio16_input_get(void) { return (uint8)(READ_PERI_REG(RTC_GPIO_IN_DATA) & 1); } ================================================ FILE: app/driver/i2c_master.c ================================================ /****************************************************************************** * Copyright 2013-2014 Espressif Systems (Wuxi) * * FileName: i2c_master.c * * Description: i2c master API * * Modification history: * 2014/3/12, v1.0 create this file. *******************************************************************************/ #include "ets_sys.h" #include "osapi.h" #include "gpio.h" #include "driver/i2c_master.h" #include "pin_map.h" LOCAL uint8 m_nLastSDA; LOCAL uint8 m_nLastSCL; LOCAL uint8 pinSDA = 2; LOCAL uint8 pinSCL = 15; /****************************************************************************** * FunctionName : i2c_master_setDC * Description : Internal used function - * set i2c SDA and SCL bit value for half clk cycle * Parameters : uint8 SDA * uint8 SCL * Returns : NONE *******************************************************************************/ LOCAL void ICACHE_FLASH_ATTR i2c_master_setDC(uint8 SDA, uint8 SCL) { SDA &= 0x01; SCL &= 0x01; m_nLastSDA = SDA; m_nLastSCL = SCL; if ((0 == SDA) && (0 == SCL)) { I2C_MASTER_SDA_LOW_SCL_LOW(); } else if ((0 == SDA) && (1 == SCL)) { I2C_MASTER_SDA_LOW_SCL_HIGH(); } else if ((1 == SDA) && (0 == SCL)) { I2C_MASTER_SDA_HIGH_SCL_LOW(); } else { I2C_MASTER_SDA_HIGH_SCL_HIGH(); } } /****************************************************************************** * FunctionName : i2c_master_getDC * Description : Internal used function - * get i2c SDA bit value * Parameters : NONE * Returns : uint8 - SDA bit value *******************************************************************************/ LOCAL uint8 ICACHE_FLASH_ATTR i2c_master_getDC(void) { uint8 sda_out; sda_out = GPIO_INPUT_GET(GPIO_ID_PIN(I2C_MASTER_SDA_GPIO)); return sda_out; } /****************************************************************************** * FunctionName : i2c_master_init * Description : initilize I2C bus to enable i2c operations * Parameters : NONE * Returns : NONE *******************************************************************************/ void ICACHE_FLASH_ATTR i2c_master_init(void) { uint8 i; i2c_master_setDC(1, 0); i2c_master_wait(5); // when SCL = 0, toggle SDA to clear up i2c_master_setDC(0, 0) ; i2c_master_wait(5); i2c_master_setDC(1, 0) ; i2c_master_wait(5); // set data_cnt to max value for (i = 0; i < 28; i++) { i2c_master_setDC(1, 0); i2c_master_wait(5); // sda 1, scl 0 i2c_master_setDC(1, 1); i2c_master_wait(5); // sda 1, scl 1 } // reset all i2c_master_stop(); return; } uint8 i2c_master_get_pinSDA(){ return pinSDA; } uint8 i2c_master_get_pinSCL(){ return pinSCL; } /****************************************************************************** * FunctionName : i2c_master_gpio_init * Description : config SDA and SCL gpio to open-drain output mode, * mux and gpio num defined in i2c_master.h * Parameters : NONE * Returns : NONE *******************************************************************************/ void ICACHE_FLASH_ATTR i2c_master_gpio_init(uint8 sda, uint8 scl) { pinSDA = pin_num[sda]; pinSCL = pin_num[scl]; ETS_GPIO_INTR_DISABLE() ; // ETS_INTR_LOCK(); PIN_FUNC_SELECT(I2C_MASTER_SDA_MUX, I2C_MASTER_SDA_FUNC); PIN_FUNC_SELECT(I2C_MASTER_SCL_MUX, I2C_MASTER_SCL_FUNC); GPIO_REG_WRITE(GPIO_PIN_ADDR(GPIO_ID_PIN(I2C_MASTER_SDA_GPIO)), GPIO_REG_READ(GPIO_PIN_ADDR(GPIO_ID_PIN(I2C_MASTER_SDA_GPIO))) | GPIO_PIN_PAD_DRIVER_SET(GPIO_PAD_DRIVER_ENABLE)); //open drain; GPIO_REG_WRITE(GPIO_ENABLE_ADDRESS, GPIO_REG_READ(GPIO_ENABLE_ADDRESS) | (1 << I2C_MASTER_SDA_GPIO)); GPIO_REG_WRITE(GPIO_PIN_ADDR(GPIO_ID_PIN(I2C_MASTER_SCL_GPIO)), GPIO_REG_READ(GPIO_PIN_ADDR(GPIO_ID_PIN(I2C_MASTER_SCL_GPIO))) | GPIO_PIN_PAD_DRIVER_SET(GPIO_PAD_DRIVER_ENABLE)); //open drain; GPIO_REG_WRITE(GPIO_ENABLE_ADDRESS, GPIO_REG_READ(GPIO_ENABLE_ADDRESS) | (1 << I2C_MASTER_SCL_GPIO)); I2C_MASTER_SDA_HIGH_SCL_HIGH(); ETS_GPIO_INTR_ENABLE() ; // ETS_INTR_UNLOCK(); i2c_master_init(); } /****************************************************************************** * FunctionName : i2c_master_start * Description : set i2c to send state * Parameters : NONE * Returns : NONE *******************************************************************************/ void ICACHE_FLASH_ATTR i2c_master_start(void) { i2c_master_setDC(1, m_nLastSCL); i2c_master_wait(5); i2c_master_setDC(1, 1); i2c_master_wait(5); // sda 1, scl 1 i2c_master_setDC(0, 1); i2c_master_wait(5); // sda 0, scl 1 } /****************************************************************************** * FunctionName : i2c_master_stop * Description : set i2c to stop sending state * Parameters : NONE * Returns : NONE *******************************************************************************/ void ICACHE_FLASH_ATTR i2c_master_stop(void) { i2c_master_wait(5); i2c_master_setDC(0, m_nLastSCL); i2c_master_wait(5); // sda 0 i2c_master_setDC(0, 1); i2c_master_wait(5); // sda 0, scl 1 i2c_master_setDC(1, 1); i2c_master_wait(5); // sda 1, scl 1 } /****************************************************************************** * FunctionName : i2c_master_setAck * Description : set ack to i2c bus as level value * Parameters : uint8 level - 0 or 1 * Returns : NONE *******************************************************************************/ void ICACHE_FLASH_ATTR i2c_master_setAck(uint8 level) { i2c_master_setDC(m_nLastSDA, 0); i2c_master_wait(5); i2c_master_setDC(level, 0); i2c_master_wait(5); // sda level, scl 0 i2c_master_setDC(level, 1); i2c_master_wait(8); // sda level, scl 1 i2c_master_setDC(level, 0); i2c_master_wait(5); // sda level, scl 0 i2c_master_setDC(1, 0); i2c_master_wait(5); } /****************************************************************************** * FunctionName : i2c_master_getAck * Description : confirm if peer send ack * Parameters : NONE * Returns : uint8 - ack value, 0 or 1 *******************************************************************************/ uint8 ICACHE_FLASH_ATTR i2c_master_getAck(void) { uint8 retVal; i2c_master_setDC(m_nLastSDA, 0); i2c_master_wait(5); i2c_master_setDC(1, 0); i2c_master_wait(5); i2c_master_setDC(1, 1); i2c_master_wait(5); retVal = i2c_master_getDC(); i2c_master_wait(5); i2c_master_setDC(1, 0); i2c_master_wait(5); return retVal; } /****************************************************************************** * FunctionName : i2c_master_checkAck * Description : get dev response * Parameters : NONE * Returns : true : get ack ; false : get nack *******************************************************************************/ bool ICACHE_FLASH_ATTR i2c_master_checkAck(void) { if(i2c_master_getAck()){ return FALSE; }else{ return TRUE; } } /****************************************************************************** * FunctionName : i2c_master_send_ack * Description : response ack * Parameters : NONE * Returns : NONE *******************************************************************************/ void ICACHE_FLASH_ATTR i2c_master_send_ack(void) { i2c_master_setAck(0x0); } /****************************************************************************** * FunctionName : i2c_master_send_nack * Description : response nack * Parameters : NONE * Returns : NONE *******************************************************************************/ void ICACHE_FLASH_ATTR i2c_master_send_nack(void) { i2c_master_setAck(0x1); } /****************************************************************************** * FunctionName : i2c_master_readByte * Description : read Byte from i2c bus * Parameters : NONE * Returns : uint8 - readed value *******************************************************************************/ uint8 ICACHE_FLASH_ATTR i2c_master_readByte(void) { uint8 retVal = 0; uint8 k, i; i2c_master_wait(5); i2c_master_setDC(m_nLastSDA, 0); i2c_master_wait(5); // sda 1, scl 0 for (i = 0; i < 8; i++) { i2c_master_wait(5); i2c_master_setDC(1, 0); i2c_master_wait(5); // sda 1, scl 0 i2c_master_setDC(1, 1); i2c_master_wait(5); // sda 1, scl 1 k = i2c_master_getDC(); i2c_master_wait(5); if (i == 7) { i2c_master_wait(3); //// } k <<= (7 - i); retVal |= k; } i2c_master_setDC(1, 0); i2c_master_wait(5); // sda 1, scl 0 return retVal; } /****************************************************************************** * FunctionName : i2c_master_writeByte * Description : write wrdata value(one byte) into i2c * Parameters : uint8 wrdata - write value * Returns : NONE *******************************************************************************/ void ICACHE_FLASH_ATTR i2c_master_writeByte(uint8 wrdata) { uint8 dat; sint8 i; i2c_master_wait(5); i2c_master_setDC(m_nLastSDA, 0); i2c_master_wait(5); for (i = 7; i >= 0; i--) { dat = wrdata >> i; i2c_master_setDC(dat, 0); i2c_master_wait(5); i2c_master_setDC(dat, 1); i2c_master_wait(5); if (i == 0) { i2c_master_wait(3); //// } i2c_master_setDC(dat, 0); i2c_master_wait(5); } } ================================================ FILE: app/driver/key.c ================================================ /****************************************************************************** * Copyright 2013-2014 Espressif Systems (Wuxi) * * FileName: key.c * * Description: key driver, now can use different gpio and install different function * * Modification history: * 2014/5/1, v1.0 create this file. *******************************************************************************/ #include "ets_sys.h" #include "os_type.h" #include "osapi.h" #include "mem.h" #include "gpio.h" #include "user_interface.h" #include "driver/key.h" LOCAL void key_intr_handler(struct keys_param *keys); /****************************************************************************** * FunctionName : key_init_single * Description : init single key's gpio and register function * Parameters : uint8 gpio_id - which gpio to use * uint32 gpio_name - gpio mux name * uint32 gpio_func - gpio function * key_function long_press - long press function, needed to install * key_function short_press - short press function, needed to install * Returns : single_key_param - single key parameter, needed by key init *******************************************************************************/ struct single_key_param *ICACHE_FLASH_ATTR key_init_single(uint8 gpio_id, uint32 gpio_name, uint8 gpio_func, key_function long_press, key_function short_press) { struct single_key_param *single_key = (struct single_key_param *)os_zalloc(sizeof(struct single_key_param)); single_key->gpio_id = gpio_id; single_key->gpio_name = gpio_name; single_key->gpio_func = gpio_func; single_key->long_press = long_press; single_key->short_press = short_press; return single_key; } /****************************************************************************** * FunctionName : key_init * Description : init keys * Parameters : key_param *keys - keys parameter, which inited by key_init_single * Returns : none *******************************************************************************/ void ICACHE_FLASH_ATTR key_init(struct keys_param *keys) { uint8 i; ETS_GPIO_INTR_ATTACH(key_intr_handler, keys); ETS_GPIO_INTR_DISABLE(); for (i = 0; i < keys->key_num; i++) { keys->single_key[i]->key_level = 1; PIN_FUNC_SELECT(keys->single_key[i]->gpio_name, keys->single_key[i]->gpio_func); gpio_output_set(0, 0, 0, GPIO_ID_PIN(keys->single_key[i]->gpio_id)); gpio_register_set(GPIO_PIN_ADDR(keys->single_key[i]->gpio_id), GPIO_PIN_INT_TYPE_SET(GPIO_PIN_INTR_DISABLE) | GPIO_PIN_PAD_DRIVER_SET(GPIO_PAD_DRIVER_DISABLE) | GPIO_PIN_SOURCE_SET(GPIO_AS_PIN_SOURCE)); //clear gpio14 status GPIO_REG_WRITE(GPIO_STATUS_W1TC_ADDRESS, BIT(keys->single_key[i]->gpio_id)); //enable interrupt gpio_pin_intr_state_set(GPIO_ID_PIN(keys->single_key[i]->gpio_id), GPIO_PIN_INTR_NEGEDGE); } ETS_GPIO_INTR_ENABLE(); } /****************************************************************************** * FunctionName : key_5s_cb * Description : long press 5s timer callback * Parameters : single_key_param *single_key - single key parameter * Returns : none *******************************************************************************/ LOCAL void ICACHE_FLASH_ATTR key_5s_cb(struct single_key_param *single_key) { os_timer_disarm(&single_key->key_5s); // low, then restart if (0 == GPIO_INPUT_GET(GPIO_ID_PIN(single_key->gpio_id))) { if (single_key->long_press) { single_key->long_press(); } } } /****************************************************************************** * FunctionName : key_50ms_cb * Description : 50ms timer callback to check it's a real key push * Parameters : single_key_param *single_key - single key parameter * Returns : none *******************************************************************************/ LOCAL void ICACHE_FLASH_ATTR key_50ms_cb(struct single_key_param *single_key) { os_timer_disarm(&single_key->key_50ms); // high, then key is up if (1 == GPIO_INPUT_GET(GPIO_ID_PIN(single_key->gpio_id))) { os_timer_disarm(&single_key->key_5s); single_key->key_level = 1; gpio_pin_intr_state_set(GPIO_ID_PIN(single_key->gpio_id), GPIO_PIN_INTR_NEGEDGE); if (single_key->short_press) { single_key->short_press(); } } else { gpio_pin_intr_state_set(GPIO_ID_PIN(single_key->gpio_id), GPIO_PIN_INTR_POSEDGE); } } /****************************************************************************** * FunctionName : key_intr_handler * Description : key interrupt handler * Parameters : key_param *keys - keys parameter, which inited by key_init_single * Returns : none *******************************************************************************/ LOCAL void key_intr_handler(struct keys_param *keys) { uint8 i; uint32 gpio_status = GPIO_REG_READ(GPIO_STATUS_ADDRESS); for (i = 0; i < keys->key_num; i++) { if (gpio_status & BIT(keys->single_key[i]->gpio_id)) { //disable interrupt gpio_pin_intr_state_set(GPIO_ID_PIN(keys->single_key[i]->gpio_id), GPIO_PIN_INTR_DISABLE); //clear interrupt status GPIO_REG_WRITE(GPIO_STATUS_W1TC_ADDRESS, gpio_status & BIT(keys->single_key[i]->gpio_id)); if (keys->single_key[i]->key_level == 1) { // 5s, restart & enter softap mode os_timer_disarm(&keys->single_key[i]->key_5s); os_timer_setfn(&keys->single_key[i]->key_5s, (os_timer_func_t *)key_5s_cb, keys->single_key[i]); os_timer_arm(&keys->single_key[i]->key_5s, 5000, 0); keys->single_key[i]->key_level = 0; gpio_pin_intr_state_set(GPIO_ID_PIN(keys->single_key[i]->gpio_id), GPIO_PIN_INTR_POSEDGE); } else { // 50ms, check if this is a real key up os_timer_disarm(&keys->single_key[i]->key_50ms); os_timer_setfn(&keys->single_key[i]->key_50ms, (os_timer_func_t *)key_50ms_cb, keys->single_key[i]); os_timer_arm(&keys->single_key[i]->key_50ms, 50, 0); } } } } ================================================ FILE: app/driver/onewire.c ================================================ /* Adaptation of Paul Stoffregen's One wire library to the NodeMcu The latest version of this library may be found at: http://www.pjrc.com/teensy/td_libs_OneWire.html 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. Much of the code was inspired by Derek Yerger's code, though I don't think much of that remains. In any event that was.. (copyleft) 2006 by Derek Yerger - Free to distribute freely. The CRC code was excerpted and inspired by the Dallas Semiconductor sample code bearing this copyright. //--------------------------------------------------------------------------- // Copyright (C) 2000 Dallas Semiconductor Corporation, 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 DALLAS SEMICONDUCTOR 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. // // Except as contained in this notice, the name of Dallas Semiconductor // shall not be used except as stated in the Dallas Semiconductor // Branding Policy. //-------------------------------------------------------------------------- */ #include "driver/onewire.h" #include "platform.h" #include "osapi.h" #define noInterrupts ets_intr_lock #define interrupts ets_intr_unlock #define delayMicroseconds os_delay_us #if ONEWIRE_SEARCH // global search state static unsigned char ROM_NO[NUM_OW][8]; static uint8_t LastDiscrepancy[NUM_OW]; static uint8_t LastFamilyDiscrepancy[NUM_OW]; static uint8_t LastDeviceFlag[NUM_OW]; #endif void onewire_init(uint8_t pin) { // pinMode(pin, INPUT); platform_gpio_mode(pin, PLATFORM_GPIO_INPUT, PLATFORM_GPIO_PULLUP); #if ONEWIRE_SEARCH onewire_reset_search(pin); #endif } // Perform the onewire reset function. We will wait up to 250uS for // the bus to come high, if it doesn't then it is broken or shorted // and we return a 0; // // Returns 1 if a device asserted a presence pulse, 0 otherwise. // uint8_t onewire_reset(uint8_t pin) { uint8_t r; uint8_t retries = 125; noInterrupts(); DIRECT_MODE_INPUT(pin); interrupts(); // wait until the wire is high... just in case do { if (--retries == 0) return 0; delayMicroseconds(2); } while ( !DIRECT_READ(pin)); noInterrupts(); DIRECT_WRITE_LOW(pin); DIRECT_MODE_OUTPUT(pin); // drive output low interrupts(); delayMicroseconds(480); noInterrupts(); DIRECT_MODE_INPUT(pin); // allow it to float delayMicroseconds(70); r = !DIRECT_READ(pin); interrupts(); delayMicroseconds(410); return r; } // // Write a bit. Port and bit is used to cut lookup time and provide // more certain timing. // static void onewire_write_bit(uint8_t pin, uint8_t v) { if (v & 1) { noInterrupts(); DIRECT_WRITE_LOW(pin); DIRECT_MODE_OUTPUT(pin); // drive output low delayMicroseconds(10); DIRECT_WRITE_HIGH(pin); // drive output high interrupts(); delayMicroseconds(55); } else { noInterrupts(); DIRECT_WRITE_LOW(pin); DIRECT_MODE_OUTPUT(pin); // drive output low delayMicroseconds(65); DIRECT_WRITE_HIGH(pin); // drive output high interrupts(); delayMicroseconds(5); } } // // Read a bit. Port and bit is used to cut lookup time and provide // more certain timing. // static uint8_t onewire_read_bit(uint8_t pin) { uint8_t r; noInterrupts(); DIRECT_MODE_OUTPUT(pin); DIRECT_WRITE_LOW(pin); delayMicroseconds(3); DIRECT_MODE_INPUT(pin); // let pin float, pull up will raise delayMicroseconds(10); r = DIRECT_READ(pin); interrupts(); delayMicroseconds(53); return r; } // // Write a byte. The writing code uses the active drivers to raise the // pin high, if you need power after the write (e.g. DS18S20 in // parasite power mode) then set 'power' to 1, otherwise the pin will // go tri-state at the end of the write to avoid heating in a short or // other mishap. // void onewire_write(uint8_t pin, uint8_t v, uint8_t power /* = 0 */) { uint8_t bitMask; for (bitMask = 0x01; bitMask; bitMask <<= 1) { onewire_write_bit(pin, (bitMask & v)?1:0); } if ( !power) { noInterrupts(); DIRECT_MODE_INPUT(pin); DIRECT_WRITE_LOW(pin); interrupts(); } } void onewire_write_bytes(uint8_t pin, const uint8_t *buf, uint16_t count, bool power /* = 0 */) { uint16_t i; for (i = 0 ; i < count ; i++) onewire_write(pin, buf[i], 0); if (!power) { noInterrupts(); DIRECT_MODE_INPUT(pin); DIRECT_WRITE_LOW(pin); interrupts(); } } // // Read a byte // uint8_t onewire_read(uint8_t pin) { uint8_t bitMask; uint8_t r = 0; for (bitMask = 0x01; bitMask; bitMask <<= 1) { if (onewire_read_bit(pin)) r |= bitMask; } return r; } void onewire_read_bytes(uint8_t pin, uint8_t *buf, uint16_t count) { uint16_t i; for (i = 0 ; i < count ; i++) buf[i] = onewire_read(pin); } // // Do a ROM select // void onewire_select(uint8_t pin, const uint8_t rom[8]) { uint8_t i; onewire_write(pin, 0x55, 0); // Choose ROM for (i = 0; i < 8; i++) onewire_write(pin, rom[i], 0); } // // Do a ROM skip // void onewire_skip(uint8_t pin) { onewire_write(pin, 0xCC, 0); // Skip ROM } void onewire_depower(uint8_t pin) { noInterrupts(); DIRECT_MODE_INPUT(pin); interrupts(); } #if ONEWIRE_SEARCH // // You need to use this function to start a search again from the beginning. // You do not need to do it for the first search, though you could. // void onewire_reset_search(uint8_t pin) { // reset the search state LastDiscrepancy[pin] = 0; LastDeviceFlag[pin] = FALSE; LastFamilyDiscrepancy[pin] = 0; int i; for(i = 7; ; i--) { ROM_NO[pin][i] = 0; if ( i == 0) break; } } // Setup the search to find the device type 'family_code' on the next call // to search(*newAddr) if it is present. // void onewire_target_search(uint8_t pin, uint8_t family_code) { // set the search state to find SearchFamily type devices ROM_NO[pin][0] = family_code; uint8_t i; for (i = 1; i < 8; i++) ROM_NO[pin][i] = 0; LastDiscrepancy[pin] = 64; LastFamilyDiscrepancy[pin] = 0; LastDeviceFlag[pin] = FALSE; } // // Perform a search. If this function returns a '1' then it has // enumerated the next device and you may retrieve the ROM from the // OneWire::address variable. If there are no devices, no further // devices, or something horrible happens in the middle of the // enumeration then a 0 is returned. If a new device is found then // its address is copied to newAddr. Use OneWire::reset_search() to // start over. // // --- Replaced by the one from the Dallas Semiconductor web site --- //-------------------------------------------------------------------------- // Perform the 1-Wire Search Algorithm on the 1-Wire bus using the existing // search state. // Return TRUE : device found, ROM number in ROM_NO buffer // FALSE : device not found, end of search // uint8_t onewire_search(uint8_t pin, uint8_t *newAddr) { uint8_t id_bit_number; uint8_t last_zero, rom_byte_number, search_result; uint8_t id_bit, cmp_id_bit; unsigned char rom_byte_mask, search_direction; // initialize for search id_bit_number = 1; last_zero = 0; rom_byte_number = 0; rom_byte_mask = 1; search_result = 0; // if the last call was not the last one if (!LastDeviceFlag[pin]) { // 1-Wire reset if (!onewire_reset(pin)) { // reset the search LastDiscrepancy[pin] = 0; LastDeviceFlag[pin] = FALSE; LastFamilyDiscrepancy[pin] = 0; return FALSE; } // issue the search command onewire_write(pin, 0xF0, 0); // loop to do the search do { // read a bit and its complement id_bit = onewire_read_bit(pin); cmp_id_bit = onewire_read_bit(pin); // check for no devices on 1-wire if ((id_bit == 1) && (cmp_id_bit == 1)) break; else { // all devices coupled have 0 or 1 if (id_bit != cmp_id_bit) search_direction = id_bit; // bit write value for search else { // if this discrepancy if before the Last Discrepancy // on a previous next then pick the same as last time if (id_bit_number < LastDiscrepancy[pin]) search_direction = ((ROM_NO[pin][rom_byte_number] & rom_byte_mask) > 0); else // if equal to last pick 1, if not then pick 0 search_direction = (id_bit_number == LastDiscrepancy[pin]); // if 0 was picked then record its position in LastZero if (search_direction == 0) { last_zero = id_bit_number; // check for Last discrepancy in family if (last_zero < 9) LastFamilyDiscrepancy[pin] = last_zero; } } // set or clear the bit in the ROM byte rom_byte_number // with mask rom_byte_mask if (search_direction == 1) ROM_NO[pin][rom_byte_number] |= rom_byte_mask; else ROM_NO[pin][rom_byte_number] &= ~rom_byte_mask; // serial number search direction write bit onewire_write_bit(pin, search_direction); // increment the byte counter id_bit_number // and shift the mask rom_byte_mask id_bit_number++; rom_byte_mask <<= 1; // if the mask is 0 then go to new SerialNum byte rom_byte_number and reset mask if (rom_byte_mask == 0) { rom_byte_number++; rom_byte_mask = 1; } } } while(rom_byte_number < 8); // loop until through all ROM bytes 0-7 // if the search was successful then if (!(id_bit_number < 65)) { // search successful so set LastDiscrepancy,LastDeviceFlag,search_result LastDiscrepancy[pin] = last_zero; // check for last device if (LastDiscrepancy[pin] == 0) LastDeviceFlag[pin] = TRUE; search_result = TRUE; } } // if no device found then reset counters so next 'search' will be like a first if (!search_result || !ROM_NO[pin][0]) { LastDiscrepancy[pin] = 0; LastDeviceFlag[pin] = FALSE; LastFamilyDiscrepancy[pin] = 0; search_result = FALSE; } int i; for (i = 0; i < 8; i++) newAddr[i] = ROM_NO[pin][i]; return search_result; } #endif #if ONEWIRE_CRC // The 1-Wire CRC scheme is described in Maxim Application Note 27: // "Understanding and Using Cyclic Redundancy Checks with Maxim iButton Products" // #if ONEWIRE_CRC8_TABLE // This table comes from Dallas sample code where it is freely reusable, // though Copyright (C) 2000 Dallas Semiconductor Corporation static const uint8_t dscrc_table[] = { 0, 94,188,226, 97, 63,221,131,194,156,126, 32,163,253, 31, 65, 157,195, 33,127,252,162, 64, 30, 95, 1,227,189, 62, 96,130,220, 35,125,159,193, 66, 28,254,160,225,191, 93, 3,128,222, 60, 98, 190,224, 2, 92,223,129, 99, 61,124, 34,192,158, 29, 67,161,255, 70, 24,250,164, 39,121,155,197,132,218, 56,102,229,187, 89, 7, 219,133,103, 57,186,228, 6, 88, 25, 71,165,251,120, 38,196,154, 101, 59,217,135, 4, 90,184,230,167,249, 27, 69,198,152,122, 36, 248,166, 68, 26,153,199, 37,123, 58,100,134,216, 91, 5,231,185, 140,210, 48,110,237,179, 81, 15, 78, 16,242,172, 47,113,147,205, 17, 79,173,243,112, 46,204,146,211,141,111, 49,178,236, 14, 80, 175,241, 19, 77,206,144,114, 44,109, 51,209,143, 12, 82,176,238, 50,108,142,208, 83, 13,239,177,240,174, 76, 18,145,207, 45,115, 202,148,118, 40,171,245, 23, 73, 8, 86,180,234,105, 55,213,139, 87, 9,235,181, 54,104,138,212,149,203, 41,119,244,170, 72, 22, 233,183, 85, 11,136,214, 52,106, 43,117,151,201, 74, 20,246,168, 116, 42,200,150, 21, 75,169,247,182,232, 10, 84,215,137,107, 53}; #ifndef pgm_read_byte #define pgm_read_byte(addr) (*(const uint8_t *)(addr)) #endif // // Compute a Dallas Semiconductor 8 bit CRC. These show up in the ROM // and the registers. (note: this might better be done without to // table, it would probably be smaller and certainly fast enough // compared to all those delayMicrosecond() calls. But I got // confused, so I use this table from the examples.) // uint8_t onewire_crc8(const uint8_t *addr, uint8_t len) { uint8_t crc = 0; while (len--) { crc = pgm_read_byte(dscrc_table + (crc ^ *addr++)); } return crc; } #else // // Compute a Dallas Semiconductor 8 bit CRC directly. // this is much slower, but much smaller, than the lookup table. // uint8_t onewire_crc8(const uint8_t *addr, uint8_t len) { uint8_t crc = 0; while (len--) { uint8_t inbyte = *addr++; uint8_t i; for (i = 8; i; i--) { uint8_t mix = (crc ^ inbyte) & 0x01; crc >>= 1; if (mix) crc ^= 0x8C; inbyte >>= 1; } } return crc; } #endif #if ONEWIRE_CRC16 // Compute the 1-Wire CRC16 and compare it against the received CRC. // Example usage (reading a DS2408): // // Put everything in a buffer so we can compute the CRC easily. // uint8_t buf[13]; // buf[0] = 0xF0; // Read PIO Registers // buf[1] = 0x88; // LSB address // buf[2] = 0x00; // MSB address // WriteBytes(net, buf, 3); // Write 3 cmd bytes // ReadBytes(net, buf+3, 10); // Read 6 data bytes, 2 0xFF, 2 CRC16 // if (!CheckCRC16(buf, 11, &buf[11])) { // // Handle error. // } // // @param input - Array of bytes to checksum. // @param len - How many bytes to use. // @param inverted_crc - The two CRC16 bytes in the received data. // This should just point into the received data, // *not* at a 16-bit integer. // @param crc - The crc starting value (optional) // @return True, iff the CRC matches. bool onewire_check_crc16(const uint8_t* input, uint16_t len, const uint8_t* inverted_crc, uint16_t crc) { crc = ~onewire_crc16(input, len, crc); return (crc & 0xFF) == inverted_crc[0] && (crc >> 8) == inverted_crc[1]; } // Compute a Dallas Semiconductor 16 bit CRC. This is required to check // the integrity of data received from many 1-Wire devices. Note that the // CRC computed here is *not* what you'll get from the 1-Wire network, // for two reasons: // 1) The CRC is transmitted bitwise inverted. // 2) Depending on the endian-ness of your processor, the binary // representation of the two-byte return value may have a different // byte order than the two bytes you get from 1-Wire. // @param input - Array of bytes to checksum. // @param len - How many bytes to use. // @param crc - The crc starting value (optional) // @return The CRC16, as defined by Dallas Semiconductor. uint16_t onewire_crc16(const uint8_t* input, uint16_t len, uint16_t crc) { static const uint8_t oddparity[16] = { 0, 1, 1, 0, 1, 0, 0, 1, 1, 0, 0, 1, 0, 1, 1, 0 }; uint16_t i; for (i = 0 ; i < len ; i++) { // Even though we're just copying a byte from the input, // we'll be doing 16-bit computation with it. uint16_t cdata = input[i]; cdata = (cdata ^ crc) & 0xff; crc >>= 8; if (oddparity[cdata & 0x0F] ^ oddparity[cdata >> 4]) crc ^= 0xC001; cdata <<= 6; crc ^= cdata; cdata <<= 1; crc ^= cdata; } return crc; } #endif #endif ================================================ FILE: app/driver/pwm.c ================================================ /****************************************************************************** * Copyright 2013-2014 Espressif Systems (Wuxi) * * FileName: pwm.c * * Description: pwm driver * * Modification history: * 2014/5/1, v1.0 create this file. *******************************************************************************/ #include "platform.h" #include "ets_sys.h" #include "os_type.h" #include "osapi.h" #include "gpio.h" #include "user_interface.h" #include "driver/pwm.h" // #define PWM_DBG os_printf #define PWM_DBG LOCAL struct pwm_single_param pwm_single_toggle[2][PWM_CHANNEL + 1]; LOCAL struct pwm_single_param *pwm_single; LOCAL struct pwm_param pwm; // LOCAL uint8 pwm_out_io_num[PWM_CHANNEL] = {PWM_0_OUT_IO_NUM, PWM_1_OUT_IO_NUM, PWM_2_OUT_IO_NUM}; LOCAL int8 pwm_out_io_num[PWM_CHANNEL] = {-1, -1, -1, -1, -1, -1}; LOCAL uint8 pwm_channel_toggle[2]; LOCAL uint8 *pwm_channel; LOCAL uint8 pwm_toggle = 1; LOCAL uint8 pwm_timer_down = 1; LOCAL uint8 pwm_current_channel = 0; LOCAL uint16 pwm_gpio = 0; LOCAL uint8 pwm_channel_num = 0; //XXX: 0xffffffff/(80000000/16)=35A #define US_TO_RTC_TIMER_TICKS(t) \ ((t) ? \ (((t) > 0x35A) ? \ (((t)>>2) * ((APB_CLK_FREQ>>4)/250000) + ((t)&0x3) * ((APB_CLK_FREQ>>4)/1000000)) : \ (((t) *(APB_CLK_FREQ>>4)) / 1000000)) : \ 0) //FRC1 #define FRC1_ENABLE_TIMER BIT7 typedef enum { DIVDED_BY_1 = 0, DIVDED_BY_16 = 4, DIVDED_BY_256 = 8, } TIMER_PREDIVED_MODE; typedef enum { TM_LEVEL_INT = 1, TM_EDGE_INT = 0, } TIMER_INT_MODE; LOCAL void ICACHE_FLASH_ATTR pwm_insert_sort(struct pwm_single_param pwm[], uint8 n) { uint8 i; for (i = 1; i < n; i++) { if (pwm[i].h_time < pwm[i - 1].h_time) { int8 j = i - 1; struct pwm_single_param tmp; os_memcpy(&tmp, &pwm[i], sizeof(struct pwm_single_param)); os_memcpy(&pwm[i], &pwm[i - 1], sizeof(struct pwm_single_param)); while (tmp.h_time < pwm[j].h_time) { os_memcpy(&pwm[j + 1], &pwm[j], sizeof(struct pwm_single_param)); j--; if (j < 0) { break; } } os_memcpy(&pwm[j + 1], &tmp, sizeof(struct pwm_single_param)); } } } LOCAL volatile uint8 critical = 0; #define LOCK_PWM(c) do { \ while( (c)==1 ); \ (c) = 1; \ } while (0) #define UNLOCK_PWM(c) do { \ (c) = 0; \ } while (0) void ICACHE_FLASH_ATTR pwm_start(void) { uint8 i, j; PWM_DBG("--Function pwm_start() is called\n"); PWM_DBG("pwm_gpio:%x,pwm_channel_num:%d\n",pwm_gpio,pwm_channel_num); PWM_DBG("pwm_out_io_num[0]:%d,[1]:%d,[2]:%d\n",pwm_out_io_num[0],pwm_out_io_num[1],pwm_out_io_num[2]); PWM_DBG("pwm.period:%d,pwm.duty[0]:%d,[1]:%d,[2]:%d\n",pwm.period,pwm.duty[0],pwm.duty[1],pwm.duty[2]); LOCK_PWM(critical); // enter critical struct pwm_single_param *local_single = pwm_single_toggle[pwm_toggle ^ 0x01]; uint8 *local_channel = &pwm_channel_toggle[pwm_toggle ^ 0x01]; // step 1: init PWM_CHANNEL+1 channels param for (i = 0; i < pwm_channel_num; i++) { uint32 us = pwm.period * pwm.duty[i] / PWM_DEPTH; local_single[i].h_time = US_TO_RTC_TIMER_TICKS(us); PWM_DBG("i:%d us:%d ht:%d\n",i,us,local_single[i].h_time); local_single[i].gpio_set = 0; local_single[i].gpio_clear = 1 << pin_num[pwm_out_io_num[i]]; } local_single[pwm_channel_num].h_time = US_TO_RTC_TIMER_TICKS(pwm.period); local_single[pwm_channel_num].gpio_set = pwm_gpio; local_single[pwm_channel_num].gpio_clear = 0; PWM_DBG("i:%d period:%d ht:%d\n",pwm_channel_num,pwm.period,local_single[pwm_channel_num].h_time); // step 2: sort, small to big pwm_insert_sort(local_single, pwm_channel_num + 1); *local_channel = pwm_channel_num + 1; PWM_DBG("1channel:%d,single[0]:%d,[1]:%d,[2]:%d,[3]:%d\n",*local_channel,local_single[0].h_time,local_single[1].h_time,local_single[2].h_time,local_single[3].h_time); // step 3: combine same duty channels for (i = pwm_channel_num; i > 0; i--) { if (local_single[i].h_time == local_single[i - 1].h_time) { local_single[i - 1].gpio_set |= local_single[i].gpio_set; local_single[i - 1].gpio_clear |= local_single[i].gpio_clear; for (j = i + 1; j < *local_channel; j++) { os_memcpy(&local_single[j - 1], &local_single[j], sizeof(struct pwm_single_param)); } (*local_channel)--; } } PWM_DBG("2channel:%d,single[0]:%d,[1]:%d,[2]:%d,[3]:%d\n",*local_channel,local_single[0].h_time,local_single[1].h_time,local_single[2].h_time,local_single[3].h_time); // step 4: cacl delt time for (i = *local_channel - 1; i > 0; i--) { local_single[i].h_time -= local_single[i - 1].h_time; } // step 5: last channel needs to clean local_single[*local_channel-1].gpio_clear = 0; // step 6: if first channel duty is 0, remove it if (local_single[0].h_time == 0) { local_single[*local_channel - 1].gpio_set &= ~local_single[0].gpio_clear; local_single[*local_channel - 1].gpio_clear |= local_single[0].gpio_clear; for (i = 1; i < *local_channel; i++) { os_memcpy(&local_single[i - 1], &local_single[i], sizeof(struct pwm_single_param)); } (*local_channel)--; } // if timer is down, need to set gpio and start timer if (pwm_timer_down == 1) { pwm_channel = local_channel; pwm_single = local_single; // start gpio_output_set(local_single[0].gpio_set, local_single[0].gpio_clear, pwm_gpio, 0); // yeah, if all channels' duty is 0 or 255, don't need to start timer, otherwise start... if (*local_channel != 1) { pwm_timer_down = 0; RTC_REG_WRITE(FRC1_LOAD_ADDRESS, local_single[0].h_time); } } if (pwm_toggle == 1) { pwm_toggle = 0; } else { pwm_toggle = 1; } UNLOCK_PWM(critical); // leave critical PWM_DBG("3channel:%d,single[0]:%d,[1]:%d,[2]:%d,[3]:%d\n",*local_channel,local_single[0].h_time,local_single[1].h_time,local_single[2].h_time,local_single[3].h_time); } /****************************************************************************** * FunctionName : pwm_set_duty * Description : set each channel's duty params * Parameters : uint8 duty : 0 ~ PWM_DEPTH * uint8 channel : channel index * Returns : NONE *******************************************************************************/ void ICACHE_FLASH_ATTR pwm_set_duty(uint16 duty, uint8 channel) { uint8 i; for(i=0;i= PWM_DEPTH) { pwm.duty[channel] = PWM_DEPTH; } else { pwm.duty[channel] = duty; } UNLOCK_PWM(critical); // leave critical } /****************************************************************************** * FunctionName : pwm_set_freq * Description : set pwm frequency * Parameters : uint16 freq : 100hz typically * Returns : NONE *******************************************************************************/ void ICACHE_FLASH_ATTR pwm_set_freq(uint16 freq, uint8 channel) { LOCK_PWM(critical); // enter critical if (freq > PWM_FREQ_MAX) { pwm.freq = PWM_FREQ_MAX; } else if (freq < 1) { pwm.freq = 1; } else { pwm.freq = freq; } pwm.period = PWM_1S / pwm.freq; UNLOCK_PWM(critical); // leave critical } /****************************************************************************** * FunctionName : pwm_set_freq_duty * Description : set pwm frequency and each channel's duty * Parameters : uint16 freq : 100hz typically * uint16 *duty : each channel's duty * Returns : NONE *******************************************************************************/ LOCAL void ICACHE_FLASH_ATTR pwm_set_freq_duty(uint16 freq, uint16 *duty) { uint8 i; pwm_set_freq(freq, 0); for (i = 0; i < PWM_CHANNEL; i++) { // pwm_set_duty(duty[i], i); if(pwm_out_io_num[i] != -1) pwm_set_duty(duty[i], pwm_out_io_num[i]); } } /****************************************************************************** * FunctionName : pwm_get_duty * Description : get duty of each channel * Parameters : uint8 channel : channel index * Returns : NONE *******************************************************************************/ uint16 ICACHE_FLASH_ATTR pwm_get_duty(uint8 channel) { uint8 i; for(i=0;i= (*pwm_channel - 1)) { // *pwm_channel may change outside pwm_single = pwm_single_toggle[local_toggle]; pwm_channel = &pwm_channel_toggle[local_toggle]; gpio_output_set(pwm_single[*pwm_channel - 1].gpio_set, pwm_single[*pwm_channel - 1].gpio_clear, pwm_gpio, 0); pwm_current_channel = 0; if (*pwm_channel != 1) { RTC_REG_WRITE(FRC1_LOAD_ADDRESS, pwm_single[pwm_current_channel].h_time); } else { pwm_timer_down = 1; } } else { gpio_output_set(pwm_single[pwm_current_channel].gpio_set, pwm_single[pwm_current_channel].gpio_clear, pwm_gpio, 0); pwm_current_channel++; RTC_REG_WRITE(FRC1_LOAD_ADDRESS, pwm_single[pwm_current_channel].h_time); } } /****************************************************************************** * FunctionName : pwm_init * Description : pwm gpio, params and timer initialization * Parameters : uint16 freq : pwm freq param * uint16 *duty : each channel's duty * Returns : NONE *******************************************************************************/ void ICACHE_FLASH_ATTR pwm_init(uint16 freq, uint16 *duty) { uint8 i; RTC_REG_WRITE(FRC1_CTRL_ADDRESS, //FRC2_AUTO_RELOAD| DIVDED_BY_16 | FRC1_ENABLE_TIMER | TM_EDGE_INT); RTC_REG_WRITE(FRC1_LOAD_ADDRESS, 0); // PIN_FUNC_SELECT(PWM_0_OUT_IO_MUX, PWM_0_OUT_IO_FUNC); // PIN_FUNC_SELECT(PWM_1_OUT_IO_MUX, PWM_1_OUT_IO_FUNC); // PIN_FUNC_SELECT(PWM_2_OUT_IO_MUX, PWM_2_OUT_IO_FUNC); // GPIO_OUTPUT_SET(GPIO_ID_PIN(PWM_0_OUT_IO_NUM), 0); // GPIO_OUTPUT_SET(GPIO_ID_PIN(PWM_1_OUT_IO_NUM), 0); // GPIO_OUTPUT_SET(GPIO_ID_PIN(PWM_2_OUT_IO_NUM), 0); for (i = 0; i < PWM_CHANNEL; i++) { // pwm_gpio |= (1 << pwm_out_io_num[i]); pwm_gpio = 0; pwm.duty[0] = 0; } pwm_set_freq(500, 0); // pwm_set_freq_duty(freq, duty); pwm_start(); ETS_FRC_TIMER1_INTR_ATTACH(pwm_tim1_intr_handler, NULL); TM1_EDGE_INT_ENABLE(); ETS_FRC1_INTR_ENABLE(); } bool ICACHE_FLASH_ATTR pwm_add(uint8 channel){ PWM_DBG("--Function pwm_add() is called. channel:%d\n", channel); PWM_DBG("pwm_gpio:%x,pwm_channel_num:%d\n",pwm_gpio,pwm_channel_num); PWM_DBG("pwm_out_io_num[0]:%d,[1]:%d,[2]:%d\n",pwm_out_io_num[0],pwm_out_io_num[1],pwm_out_io_num[2]); PWM_DBG("pwm.duty[0]:%d,[1]:%d,[2]:%d\n",pwm.duty[0],pwm.duty[1],pwm.duty[2]); uint8 i; for(i=0;ipWritePos == pRxBuff->pReadPos){ // empty return false; } // ETS_UART_INTR_DISABLE(); ETS_INTR_LOCK(); *c = (char)*(pRxBuff->pReadPos); if (pRxBuff->pReadPos == (pRxBuff->pRcvMsgBuff + RX_BUFF_SIZE)) { pRxBuff->pReadPos = pRxBuff->pRcvMsgBuff ; } else { pRxBuff->pReadPos++; } // ETS_UART_INTR_ENABLE(); ETS_INTR_UNLOCK(); return true; } #if 0 int readline4lua(const char *prompt, char *buffer, int length){ char ch; int line_position; start: /* show prompt */ uart0_sendStr(prompt); line_position = 0; os_memset(buffer, 0, length); while (1) { while (uart_getc(&ch)) { /* handle CR key */ if (ch == '\r') { char next; if (uart_getc(&next)) ch = next; } /* backspace key */ else if (ch == 0x7f || ch == 0x08) { if (line_position > 0) { uart_putc(0x08); uart_putc(' '); uart_putc(0x08); line_position--; } buffer[line_position] = 0; continue; } /* EOF(ctrl+d) */ else if (ch == 0x04) { if (line_position == 0) /* No input which makes lua interpreter close */ return 0; else continue; } /* end of line */ if (ch == '\r' || ch == '\n') { buffer[line_position] = 0; uart_putc('\n'); if (line_position == 0) { /* Get a empty line, then go to get a new line */ goto start; } else { return line_position; } } /* other control character or not an acsii character */ if (ch < 0x20 || ch >= 0x80) { continue; } /* echo */ uart_putc(ch); buffer[line_position] = ch; ch = 0; line_position++; /* it's a large line, discard it */ if (line_position >= length) line_position = 0; } } } #endif ================================================ FILE: app/driver/relay.c ================================================ #include "ets_sys.h" #include "os_type.h" #include "osapi.h" #include "mem.h" #include "c_types.h" #include "c_string.h" #include "c_stdlib.h" #include "c_stdio.h" #include "gpio.h" #include "user_interface.h" #include "user_config.h" #include "platform.h" #include "config.h" #include "driver/relay.h" #define MAX_RELAY_LISTENERS 5 uint8_t relay_init_ok=0; relay_change_callback listeners[MAX_RELAY_LISTENERS]; void ICACHE_FLASH_ATTR relay_register_listener(relay_change_callback f){ NODE_DBG("Relay listener add %p",f); int i=0; while(listeners[i]!=NULL) i++; if(i>=MAX_RELAY_LISTENERS){ NODE_DBG("No more listener space %d",i); return; } NODE_DBG("Relay listener add index %d",i); listeners[i]=f; } void ICACHE_FLASH_ATTR relay_unregister_listener(relay_change_callback f){ NODE_DBG("Relay listener remove %p",f); int i=0; while(listeners[i]!=f) i++; if(i>=MAX_RELAY_LISTENERS) return; listeners[i]=NULL; } static void ICACHE_FLASH_ATTR relay_notify_listeners(int relayId,int state){ NODE_DBG("relay_notify_listeners"); int i; for(i=0;i=RELAY_COUNT) return NULL; config_data * config = config_read(); return &config->relay_state.relay[relayNumber]; } int ICACHE_FLASH_ATTR relay_get_state(int relayNumber){ relay * r = find_relay(relayNumber); if(r==NULL) return -1; return r->state; } int ICACHE_FLASH_ATTR relay_set_state(int relayNumber,unsigned state){ relay * r = find_relay(relayNumber); if(r==NULL) return -1; r->state=state; platform_gpio_write(r->gpioPin,r->state); config_save(NULL); relay_notify_listeners(relayNumber,state); return r->state; } int ICACHE_FLASH_ATTR relay_toggle_state(int relayNumber){ relay * r = find_relay(relayNumber); if(r==NULL) return -1; r->state=!r->state; platform_gpio_write(r->gpioPin,r->state); config_save(NULL); relay_notify_listeners(relayNumber,r->state); return r->state; } void ICACHE_FLASH_ATTR relay_init(){ if(relay_init_ok) return; relay_init_ok=1; NODE_DBG("Relay init"); //zero listeners int i; for(i=0;irelay_state.init_ok){ #ifdef DEVELOP_VERSION NODE_DBG("Relay init ok"); int j; for(j=0;jrelay_state.relay[j].gpioPin,config->relay_state.relay[j].state); NODE_DBG(""); #endif int i; for(i=0;irelay_state.relay[i].gpioPin,config->relay_state.relay[i].state); return; } //relay #0 on pin 1 config->relay_state.relay[0].gpioPin=1; config->relay_state.relay[0].state=0; platform_gpio_mode(1,PLATFORM_GPIO_OUTPUT,PLATFORM_GPIO_FLOAT); //relay #1 on pin 2 config->relay_state.relay[1].gpioPin=2; config->relay_state.relay[1].state=0; platform_gpio_mode(2,PLATFORM_GPIO_OUTPUT,PLATFORM_GPIO_FLOAT); config->relay_state.init_ok=1; config_save(config); } int ICACHE_FLASH_ATTR relay_count(){ return RELAY_COUNT; } ================================================ FILE: app/driver/spi.c ================================================ #include "driver/spi.h" /****************************************************************************** * FunctionName : spi_lcd_mode_init * Description : SPI master initial function for driving LCD TM035PDZV36 * Parameters : uint8 spi_no - SPI module number, Only "SPI" and "HSPI" are valid *******************************************************************************/ void spi_lcd_mode_init(uint8 spi_no) { uint32 regvalue; if(spi_no>1) return; //handle invalid input number //bit9 of PERIPHS_IO_MUX should be cleared when HSPI clock doesn't equal CPU clock //bit8 of PERIPHS_IO_MUX should be cleared when SPI clock doesn't equal CPU clock if(spi_no==SPI){ WRITE_PERI_REG(PERIPHS_IO_MUX, 0x005); //clear bit9,and bit8 PIN_FUNC_SELECT(PERIPHS_IO_MUX_SD_CLK_U, 1);//configure io to spi mode PIN_FUNC_SELECT(PERIPHS_IO_MUX_SD_CMD_U, 1);//configure io to spi mode PIN_FUNC_SELECT(PERIPHS_IO_MUX_SD_DATA0_U, 1);//configure io to spi mode PIN_FUNC_SELECT(PERIPHS_IO_MUX_SD_DATA1_U, 1);//configure io to spi mode }else if(spi_no==HSPI){ WRITE_PERI_REG(PERIPHS_IO_MUX, 0x105); //clear bit9 PIN_FUNC_SELECT(PERIPHS_IO_MUX_MTDI_U, 2);//configure io to spi mode PIN_FUNC_SELECT(PERIPHS_IO_MUX_MTCK_U, 2);//configure io to spi mode PIN_FUNC_SELECT(PERIPHS_IO_MUX_MTMS_U, 2);//configure io to spi mode PIN_FUNC_SELECT(PERIPHS_IO_MUX_MTDO_U, 2);//configure io to spi mode } SET_PERI_REG_MASK(SPI_USER(spi_no), SPI_CS_SETUP|SPI_CS_HOLD|SPI_USR_COMMAND); CLEAR_PERI_REG_MASK(SPI_USER(spi_no), SPI_FLASH_MODE); // SPI clock=CPU clock/8 WRITE_PERI_REG(SPI_CLOCK(spi_no), ((1&SPI_CLKDIV_PRE)<1) return; //handle invalid input number if(high_bit) bytetemp=(low_8bit>>1)|0x80; else bytetemp=(low_8bit>>1)&0x7f; regvalue= ((8&SPI_USR_COMMAND_BITLEN)<1) return; //handle invalid input number if(spi_no==SPI){ WRITE_PERI_REG(PERIPHS_IO_MUX, 0x005); PIN_FUNC_SELECT(PERIPHS_IO_MUX_SD_CLK_U, 1);//configure io to spi mode PIN_FUNC_SELECT(PERIPHS_IO_MUX_SD_CMD_U, 1);//configure io to spi mode PIN_FUNC_SELECT(PERIPHS_IO_MUX_SD_DATA0_U, 1);//configure io to spi mode PIN_FUNC_SELECT(PERIPHS_IO_MUX_SD_DATA1_U, 1);//configure io to spi mode } else if(spi_no==HSPI){ WRITE_PERI_REG(PERIPHS_IO_MUX, 0x105); PIN_FUNC_SELECT(PERIPHS_IO_MUX_MTDI_U, 2);//configure io to spi mode PIN_FUNC_SELECT(PERIPHS_IO_MUX_MTCK_U, 2);//configure io to spi mode PIN_FUNC_SELECT(PERIPHS_IO_MUX_MTMS_U, 2);//configure io to spi mode PIN_FUNC_SELECT(PERIPHS_IO_MUX_MTDO_U, 2);//configure io to spi mode } SET_PERI_REG_MASK(SPI_USER(spi_no), SPI_CS_SETUP|SPI_CS_HOLD|SPI_DOUTDIN|SPI_USR_MOSI); //set clock polarity // TODO: This doesn't work //if (cpol == 1) { // SET_PERI_REG_MASK(SPI_CTRL2(spi_no), (SPI_CK_OUT_HIGH_MODE<1) return; //handle invalid input number while(READ_PERI_REG(SPI_CMD(spi_no))&SPI_USR); WRITE_PERI_REG(SPI_W0(spi_no), *data); SET_PERI_REG_MASK(SPI_CMD(spi_no), SPI_USR); while(READ_PERI_REG(SPI_CMD(spi_no))&SPI_USR); *data = (uint8)(READ_PERI_REG(SPI_W0(spi_no))&0xff); } /****************************************************************************** * FunctionName : spi_byte_write_espslave * Description : SPI master 1 byte transmission function for esp8266 slave, * transmit 1byte data to esp8266 slave buffer needs 16bit transmission , * first byte is command 0x04 to write slave buffer, second byte is data * Parameters : uint8 spi_no - SPI module number, Only "SPI" and "HSPI" are valid * uint8 data- transmitted data *******************************************************************************/ void spi_byte_write_espslave(uint8 spi_no,uint8 data) { uint32 regvalue; if(spi_no>1) return; //handle invalid input number while(READ_PERI_REG(SPI_CMD(spi_no))&SPI_USR); SET_PERI_REG_MASK(SPI_USER(spi_no), SPI_USR_MOSI); CLEAR_PERI_REG_MASK(SPI_USER(spi_no), SPI_USR_MISO|SPI_USR_ADDR|SPI_USR_DUMMY); //SPI_FLASH_USER2 bit28-31 is cmd length,cmd bit length is value(0-15)+1, // bit15-0 is cmd value. //0x70000000 is for 8bits cmd, 0x04 is eps8266 slave write cmd value WRITE_PERI_REG(SPI_USER2(spi_no), ((7&SPI_USR_COMMAND_BITLEN)<1) return; //handle invalid input number while(READ_PERI_REG(SPI_CMD(spi_no))&SPI_USR); SET_PERI_REG_MASK(SPI_USER(spi_no), SPI_USR_MISO); CLEAR_PERI_REG_MASK(SPI_USER(spi_no), SPI_USR_MOSI|SPI_USR_ADDR|SPI_USR_DUMMY); //SPI_FLASH_USER2 bit28-31 is cmd length,cmd bit length is value(0-15)+1, // bit15-0 is cmd value. //0x70000000 is for 8bits cmd, 0x06 is eps8266 slave read cmd value WRITE_PERI_REG(SPI_USER2(spi_no), ((7&SPI_USR_COMMAND_BITLEN)<1) return; //handle invalid input number //clear bit9,bit8 of reg PERIPHS_IO_MUX //bit9 should be cleared when HSPI clock doesn't equal CPU clock //bit8 should be cleared when SPI clock doesn't equal CPU clock ////WRITE_PERI_REG(PERIPHS_IO_MUX, 0x105); //clear bit9//TEST if(spi_no==SPI){ PIN_FUNC_SELECT(PERIPHS_IO_MUX_SD_CLK_U, 1);//configure io to spi mode PIN_FUNC_SELECT(PERIPHS_IO_MUX_SD_CMD_U, 1);//configure io to spi mode PIN_FUNC_SELECT(PERIPHS_IO_MUX_SD_DATA0_U, 1);//configure io to spi mode PIN_FUNC_SELECT(PERIPHS_IO_MUX_SD_DATA1_U, 1);//configure io to spi mode }else if(spi_no==HSPI){ PIN_FUNC_SELECT(PERIPHS_IO_MUX_MTDI_U, 2);//configure io to spi mode PIN_FUNC_SELECT(PERIPHS_IO_MUX_MTCK_U, 2);//configure io to spi mode PIN_FUNC_SELECT(PERIPHS_IO_MUX_MTMS_U, 2);//configure io to spi mode PIN_FUNC_SELECT(PERIPHS_IO_MUX_MTDO_U, 2);//configure io to spi mode } //regvalue=READ_PERI_REG(SPI_FLASH_SLAVE(spi_no)); //slave mode,slave use buffers which are register "SPI_FLASH_C0~C15", enable trans done isr //set bit 30 bit 29 bit9,bit9 is trans done isr mask SET_PERI_REG_MASK( SPI_SLAVE(spi_no), SPI_SLAVE_MODE|SPI_SLV_WR_RD_BUF_EN| SPI_SLV_WR_BUF_DONE_EN|SPI_SLV_RD_BUF_DONE_EN| SPI_SLV_WR_STA_DONE_EN|SPI_SLV_RD_STA_DONE_EN| SPI_TRANS_DONE_EN); //disable general trans intr //CLEAR_PERI_REG_MASK(SPI_SLAVE(spi_no),SPI_TRANS_DONE_EN); CLEAR_PERI_REG_MASK(SPI_USER(spi_no), SPI_FLASH_MODE);//disable flash operation mode SET_PERI_REG_MASK(SPI_USER(spi_no),SPI_USR_MISO_HIGHPART);//SLAVE SEND DATA BUFFER IN C8-C15 //////**************RUN WHEN SLAVE RECIEVE*******************/////// //tow lines below is to configure spi timing. SET_PERI_REG_MASK(SPI_CTRL2(spi_no),(0x2&SPI_MOSI_DELAY_NUM)<>8)&0xff; spi_data[(idx<<2)+2] = (recv_data>>16)&0xff; spi_data[(idx<<2)+3] = (recv_data>>24)&0xff; idx++; } //add system_os_post here GPIO_OUTPUT_SET(0, 1); } if(regvalue&SPI_SLV_RD_BUF_DONE){ //it is necessary to call GPIO_OUTPUT_SET(2, 1), when new data is preped in SPI_W8-15 and needs to be sended. GPIO_OUTPUT_SET(2, 0); //add system_os_post here //system_os_post(USER_TASK_PRIO_1,WR_RD,regvalue); } }else if(READ_PERI_REG(0x3ff00020)&BIT9){ //bit7 is for i2s isr, } } #ifdef SPI_SLAVE_DEBUG void ICACHE_FLASH_ATTR set_miso_data() { if(GPIO_INPUT_GET(2)==0){ WRITE_PERI_REG(SPI_W8(HSPI),0x05040302); WRITE_PERI_REG(SPI_W9(HSPI),0x09080706); WRITE_PERI_REG(SPI_W10(HSPI),0x0d0c0b0a); WRITE_PERI_REG(SPI_W11(HSPI),0x11100f0e); WRITE_PERI_REG(SPI_W12(HSPI),0x15141312); WRITE_PERI_REG(SPI_W13(HSPI),0x19181716); WRITE_PERI_REG(SPI_W14(HSPI),0x1d1c1b1a); WRITE_PERI_REG(SPI_W15(HSPI),0x21201f1e); GPIO_OUTPUT_SET(2, 1); } } void ICACHE_FLASH_ATTR disp_spi_data() { uint8 i = 0; for(i=0;i<32;i++){ os_printf("data %d : 0x%02x\n\r",i,spi_data[i]); } //os_printf("d31:0x%02x\n\r",spi_data[31]); } void ICACHE_FLASH_ATTR spi_task(os_event_t *e) { uint8 data; switch(e->sig){ case MOSI: disp_spi_data(); break; case STATUS_R_IN_WR : os_printf("SR ERR in WRPR,Reg:%08x \n",e->par); break; case STATUS_W: os_printf("SW ERR,Reg:%08x\n",e->par); break; case TR_DONE_ALONE: os_printf("TD ALO ERR,Reg:%08x\n",e->par); break; case WR_RD: os_printf("WR&RD ERR,Reg:%08x\n",e->par); break; case DATA_ERROR: os_printf("Data ERR,Reg:%08x\n",e->par); break; case STATUS_R_IN_RD : os_printf("SR ERR in RDPR,Reg:%08x\n",e->par); break; default: break; } } void ICACHE_FLASH_ATTR spi_task_init(void) { spiQueue = (os_event_t*)os_malloc(sizeof(os_event_t)*SPI_QUEUE_LEN); system_os_task(spi_task,USER_TASK_PRIO_1,spiQueue,SPI_QUEUE_LEN); } os_timer_t spi_timer_test; void ICACHE_FLASH_ATTR spi_test_init() { os_printf("spi init\n\r"); spi_slave_init(HSPI); os_printf("gpio init\n\r"); gpio_init(); os_printf("spi task init \n\r"); spi_task_init(); #ifdef SPI_MISO os_printf("spi miso init\n\r"); set_miso_data(); #endif //os_timer_disarm(&spi_timer_test); //os_timer_setfn(&spi_timer_test, (os_timer_func_t *)set_miso_data, NULL);//wjl //os_timer_arm(&spi_timer_test,50,1); } #endif ================================================ FILE: app/driver/uart_interrupt.c ================================================ #include "ets_sys.h" #include "osapi.h" #include "driver/uart.h" #include "osapi.h" #include "driver/uart_register.h" #include "user_config.h" #include "mem.h" #include "os_type.h" #include "util/linked_list.h" // UartDev is defined and initialized in rom code. extern UartDevice UartDev; #define UART_RX_INTR_DISABLE(uart) CLEAR_PERI_REG_MASK(UART_INT_ENA(uart), UART_RXFIFO_FULL_INT_ENA|UART_RXFIFO_TOUT_INT_ENA) #define UART_RX_INTR_ENABLE(uart) SET_PERI_REG_MASK(UART_INT_ENA(uart), UART_RXFIFO_FULL_INT_ENA|UART_RXFIFO_TOUT_INT_ENA) #define UART_TX_INTR_DISABLE(uart) CLEAR_PERI_REG_MASK(UART_INT_ENA(uart), UART_TXFIFO_EMPTY_INT_ENA) #define UART_TX_INTR_ENABLE(uart) SET_PERI_REG_MASK(UART_CONF1(uart), (UART_TX_EMPTY_THRESH_VAL & UART_TXFIFO_EMPTY_THRHD)<>UART_RXFIFO_CNT_S)&UART_RXFIFO_CNT #define UART_TX_FIFO_COUNT(uart) (READ_PERI_REG(UART_STATUS(uart))>>UART_TXFIFO_CNT_S)&UART_TXFIFO_CNT #define UART0_READ_CHAR() READ_PERI_REG(UART_FIFO(UART0)) & 0xFF #define UART_WRITE_CHAR(uart,c) WRITE_PERI_REG(UART_FIFO(uart), c) static uart0_data_received_callback_t uart0_data_received_callback=NULL; LOCAL void uart_rx_intr_handler(void *para); LOCAL void uart_transmit(uint8_t uart); #define TX_ITEM_LEN 128 struct tx_item{ uint8_t data[TX_ITEM_LEN]; int len; }; linked_list tx_list[2]; os_timer_t tx_timer[2]; //UART TRANSMIT ------------------------------------------------------------ STATUS uart_tx_one_char(uint8_t uart, uint8_t TxChar) { while (true){ uint8_t fifo_cnt = UART_TX_FIFO_COUNT(uart); if (fifo_cnt < 126) { break; } } UART_WRITE_CHAR(uart,TxChar); return OK; } STATUS uart_tx_one_char_no_wait(uint8_t uart, uint8_t TxChar) { uint8_t fifo_cnt = UART_TX_FIFO_COUNT(uart); if (fifo_cnt < 126) { UART_WRITE_CHAR(uart,TxChar); } return OK; } static void tx_timer_timeout(void *arg){ //NODE_DBG("u tout"); if(arg==(void*)0){ uart_transmit(0); } else{ uart_transmit(1); } } void uart_write(uint8_t uart,uint8_t *data,int len){ linked_list *list = &tx_list[uart]; uint8_t fifo_cnt = UART_TX_FIFO_COUNT(uart); if (fifo_cnt > len && list->size==0) { //we can write on uart buffer while(len>0){ UART_WRITE_CHAR(uart,*data); data++; len--; } return; } //if fifo is full, buffer on our own while(len>0){ struct tx_item *tx = (struct tx_item *)list_get_first(list); if(tx==NULL || tx->len >= TX_ITEM_LEN){ tx = (struct tx_item*)os_zalloc(sizeof(struct tx_item)); list_add_first(list,tx); } int remLen = TX_ITEM_LEN-tx->len; if(len <= remLen){ os_memcpy(tx->data+tx->len,data,len); tx->len+=len; len=0; } else{ os_memcpy(tx->data+tx->len,data,remLen); tx->len+=remLen; len-=remLen; data+=remLen; } } os_timer_disarm(&tx_timer[uart]); os_timer_arm(&tx_timer[uart], 20, 0); } void uart_write_char(uint8_t uart,char c){ uart_write(uart,&c,1); } void uart_write_string(uint8_t uart,const char *s){ int str_len = os_strlen(s); uart_write(uart,(uint8_t*)s,str_len); } void ICACHE_FLASH_ATTR uart_config(uint8_t uart_no) { if (uart_no == UART1){ PIN_FUNC_SELECT(PERIPHS_IO_MUX_GPIO2_U, FUNC_U1TXD_BK); }else{ /* rcv_buff size if 0x100 */ ETS_UART_INTR_ATTACH(uart_rx_intr_handler, &(UartDev.rcv_buff)); PIN_PULLUP_DIS(PERIPHS_IO_MUX_U0TXD_U); PIN_FUNC_SELECT(PERIPHS_IO_MUX_U0TXD_U, FUNC_U0TXD); #if UART_HW_RTS PIN_FUNC_SELECT(PERIPHS_IO_MUX_MTDO_U, FUNC_U0RTS); //HW FLOW CONTROL RTS PIN #endif #if UART_HW_CTS PIN_FUNC_SELECT(PERIPHS_IO_MUX_MTCK_U, FUNC_U0CTS); //HW FLOW CONTROL CTS PIN #endif } uart_div_modify(uart_no, UART_CLK_FREQ / (UartDev.baut_rate));//SET BAUDRATE WRITE_PERI_REG(UART_CONF0(uart_no), ((UartDev.exist_parity & UART_PARITY_EN_M) << UART_PARITY_EN_S) //SET BIT AND PARITY MODE | ((UartDev.parity & UART_PARITY_M) <len > fifo_remain?fifo_remain:item->len; if(fifo_remain >= item->len){ for(i = 0; ilen;i++) UART_WRITE_CHAR(uart,item->data[i]); os_free(item); goto process; } else{ for(i=0;idata[i]); os_memmove(item->data, item->data+fifo_remain, item->len - fifo_remain); item->len -= fifo_remain; list_add_last(list,item); //put back on list } if(tx_list->size>0) UART_TX_INTR_ENABLE(uart); //enable interrupt so we may send data again } } LOCAL void uart0_data_received(){ uint8_t data_len = UART_RX_FIFO_COUNT(0); if(data_len<=0) return; if(uart0_data_received_callback!=NULL){ uint8_t *tmp_data = (uint8_t*)os_malloc(data_len); int i; uint8_t c; for(i=0;i and Jeroen Domburg * wrote this file. As long as you retain this notice you can do whatever you * want with this stuff. If we meet some day, and you think this stuff is * worth it, you can buy us a beer in return. * ---------------------------------------------------------------------------- */ #include "c_types.h" #include "user_interface.h" #include "espconn.h" #include "mem.h" #include "osapi.h" #include "cgi.h" #include "cgi_wifi.h" #include "cgi_relay.h" #include "user_config.h" #include "http_server.h" #include "ws_app.h" #define HTTP_PORT 80 static http_server_url api_urls[]={ //------URL-------------------------CGI----------------------ARGUMENT--------METHOD-------------FLAGS------ {"/api/wifi/status", http_wifi_api_get_status, NULL, HTTP_POST, NO_FLAG}, {"/api/wifi/scan", http_wifi_api_scan, NULL, HTTP_POST, NO_FLAG}, {"/api/wifi/connect", http_wifi_api_connect_ap, NULL, HTTP_POST, NEED_BODY}, {"/api/wifi/disconnect", http_wifi_api_disconnect, NULL, HTTP_POST, NO_FLAG}, {"/api/wifi/checkInternet", http_wifi_api_check_internet, NULL, HTTP_POST, NO_FLAG}, {"/api/relay/state", http_relay_api_status, NULL, HTTP_POST, NO_FLAG}, {"/api/relay/toggle", http_relay_api_toggle, NULL, HTTP_POST, NEED_BODY}, {"/api/dht/read", http_dht_api_read, NULL, HTTP_POST, NO_FLAG}, {NULL, NULL, NULL, HTTP_ANY_METHOD, NO_FLAG} }; static url_rewrite rewrites[]={ //----PATH---------REWRITE------- {"/" , "/index.html"}, {"/speed-test" , "/speed_test.html"}, {"/cats" , "/cats.html"}, {NULL,NULL} }; void ICACHE_FLASH_ATTR init_http_server(){ //general max tcp conns espconn_tcp_set_max_con(20); http_server_init(); http_server_bind_domain(INTERFACE_DOMAIN); http_server_enable_captive_portal(); http_server_enable_cors(); http_server_rewrite(&rewrites); http_server_bind_urls((http_server_url *)&api_urls); http_server_start(); //ws init_ws_server(); } ================================================ FILE: app/http/app.h ================================================ /* * ---------------------------------------------------------------------------- * "THE BEER-WARE LICENSE" (Revision 42): * Israel Lot and Jeroen Domburg * wrote this file. As long as you retain this notice you can do whatever you * want with this stuff. If we meet some day, and you think this stuff is * worth it, you can buy us a beer in return. * ---------------------------------------------------------------------------- */ #ifndef __HTTP_H #define __HTTP_H void ICACHE_FLASH_ATTR init_http_server(); #endif ================================================ FILE: app/http/cgi.c ================================================ /* * ---------------------------------------------------------------------------- * "THE BEER-WARE LICENSE" (Revision 42): * Israel Lot and Jeroen Domburg * wrote this file. As long as you retain this notice you can do whatever you * want with this stuff. If we meet some day, and you think this stuff is * worth it, you can buy us a beer in return. * ---------------------------------------------------------------------------- */ #include "c_string.h" #include "osapi.h" #include "user_interface.h" #include "c_stdio.h" #include "mem.h" #include "user_config.h" #include "http.h" #include "http_parser.h" #include "http_server.h" #include "http_process.h" #include "http_helper.h" #include "rofs.h" #include "cgi.h" // If a request to transmit data overflows the send buffer, the cgi function will be temporarely // replaced by this one and later restored when all data is sent. int ICACHE_FLASH_ATTR cgi_transmit(http_connection *connData){ NODE_DBG("cgi_transmit"); struct cgi_transmit_arg *arg = (struct cgi_transmit_arg*)connData->cgi.data; if(arg->len > 0){ NODE_DBG("cgi_transmit %d bytes",arg->len); int rem = connData->output.buffer + HTTP_BUFFER_SIZE - connData->output.bufferPos; int bytesToWrite = rem; if(arg->len < rem ) bytesToWrite = arg->len; http_nwrite(connData,arg->dataPos,bytesToWrite); arg->len -= bytesToWrite; arg->dataPos+=bytesToWrite; } if(arg->len==0){ //all written //free data os_free(arg->data); //copy old cgi back os_memcpy(&connData->cgi,&arg->previous_cgi,sizeof(cgi_struct)); //free cgi arg os_free(arg); } return HTTPD_CGI_MORE; } // This makes sure we aren't serving static files on POST requests for example int ICACHE_FLASH_ATTR cgi_enforce_method(http_connection *connData) { enum http_method *method = (enum http_method *)connData->cgi.argument; if(connData->state == HTTPD_STATE_BODY_END) if(connData->parser.method!=*method && (int)*method>=0) { NODE_DBG("Wrong HTTP method. Enforce is %d and request is %d",method,connData->parser.method); http_response_BAD_REQUEST(connData); return HTTPD_CGI_DONE; } return HTTPD_CGI_NEXT_RULE; } // This makes sure we have a body int ICACHE_FLASH_ATTR cgi_enforce_body(http_connection *connData) { if(connData->state ==HTTPD_STATE_ON_URL){ http_set_save_body(connData); //request body to be saved } //wait for whole body if(connData->state body.len <=0){ http_response_BAD_REQUEST(connData); NODE_DBG("No body"); return HTTPD_CGI_DONE; } else return HTTPD_CGI_NEXT_RULE; } //cgi that adds CORS ( Cross Origin Resource Sharing ) to our server int ICACHE_FLASH_ATTR cgi_cors(http_connection *connData) { http_server_config *config = (http_server_config*)connData->cgi.argument;; if(config==NULL) return HTTPD_CGI_NEXT_RULE; if(!config->enable_cors) return HTTPD_CGI_NEXT_RULE; if(connData->state==HTTPD_STATE_ON_URL){ //save cors headers http_set_save_header(connData,HTTP_ACCESS_CONTROL_REQUEST_HEADERS); http_set_save_header(connData,HTTP_ACCESS_CONTROL_REQUEST_METHOD); return HTTPD_CGI_NEXT_RULE; } if(connData->state==HTTPD_STATE_HEADERS_END){ //SET CORS Allow Origin for every request http_SET_HEADER(connData,HTTP_ACCESS_CONTROL_ALLOW_ORIGIN,"*"); header * allow_headers = http_get_header(connData,HTTP_ACCESS_CONTROL_REQUEST_HEADERS); header * allow_methods = http_get_header(connData,HTTP_ACCESS_CONTROL_REQUEST_METHOD); if(allow_headers!=NULL) http_SET_HEADER(connData,HTTP_ACCESS_CONTROL_ALLOW_HEADERS,allow_headers->value); if(allow_methods!=NULL) http_SET_HEADER(connData,HTTP_ACCESS_CONTROL_ALLOW_METHODS,allow_methods->value); // Browsers will send an OPTIONS pre-flight request when posting data on a cross-domain situation // If that's the case here, we can safely return 200 OK with our CORS headers set if(connData->parser.method==HTTP_OPTIONS) { http_response_OK(connData); return HTTPD_CGI_DONE; } } return HTTPD_CGI_NEXT_RULE; } //Simple static url rewriter, allows us to process the request as another url without redirecting the user //Used to serve index files on root / requests for example int ICACHE_FLASH_ATTR cgi_url_rewrite(http_connection *connData) { if(connData->state==HTTPD_STATE_HEADERS_END){ NODE_DBG("Rewrite %s to %s",connData->url,(char*)connData->cgi.argument); int urlSize = strlen((char*)connData->cgi.argument); if(urlSize < URL_MAX_SIZE){ strcpy(connData->url,(char*)connData->cgi.argument); //re-parse url http_parse_url(connData); } } return HTTPD_CGI_NEXT_RULE; } //Simple cgi that redirects the user int ICACHE_FLASH_ATTR cgi_redirect(http_connection *connData) { http_response_REDIRECT(connData, (char*)connData->cgi.argument); return HTTPD_CGI_DONE; } //Cgi that check the request has the correct HOST header //Using it we can ensure our server has a domain of our choice int ICACHE_FLASH_ATTR cgi_check_host(http_connection *connData) { http_server_config *config = (http_server_config*)connData->cgi.argument; if(config==NULL) return HTTPD_CGI_NEXT_RULE; if(config->host_domain==NULL) return HTTPD_CGI_NEXT_RULE; if(connData->state==HTTPD_STATE_ON_URL){ http_set_save_header(connData,HTTP_HOST); return HTTPD_CGI_NEXT_RULE; } if(connData->state==HTTPD_STATE_HEADERS_END){ header *hostHeader = http_get_header(connData,HTTP_HOST); if(hostHeader==NULL){ NODE_DBG("Host header not found"); http_response_BAD_REQUEST(connData); return HTTPD_CGI_DONE; } const char * domain = config->host_domain; NODE_DBG("Host header found: %s, domain: %s",hostHeader->value,domain); if(os_strncmp(hostHeader->value,domain,strlen(domain))==0) //compare ignoring http:// and last / { NODE_DBG("Hosts match"); return HTTPD_CGI_NEXT_RULE; } else{ NODE_DBG("Hosts don't match"); if(config->enable_captive){ //to enable a captive portal we should redirect here char * redirectUrl = (char *)os_zalloc(strlen(domain)+9); // domain lenght + http:// + / + \0 os_strcpy(redirectUrl,"http://"); os_strcat(redirectUrl,domain); os_strcat(redirectUrl,"/"); http_response_REDIRECT(connData, redirectUrl); os_free(redirectUrl); } else{ //bad request http_response_BAD_REQUEST(connData); } return HTTPD_CGI_DONE; } } return HTTPD_CGI_NEXT_RULE; } typedef struct{ RO_FILE *f; char *buff; } cgi_fs_state; //cgi for static file serving int ICACHE_FLASH_ATTR cgi_file_system(http_connection *connData) { cgi_fs_state *state = (cgi_fs_state *)connData->cgi.data; int len; char buff[HTTP_BUFFER_SIZE]; //wait for body end state if(connData->stateurl_parsed.field_set & (1<f = f; connData->cgi.data=state; //save state for next time //set headers http_SET_HEADER(connData,HTTP_CONTENT_TYPE,http_get_mime(connData->url)); http_SET_HEADER(connData,HTTP_CACHE_CONTROL,HTTP_DEFAULT_CACHE); http_SET_CONTENT_LENGTH(connData,f->file->size); if(f->file->gzip) http_SET_HEADER(connData,HTTP_CONTENT_ENCODING,"gzip"); http_response_OK(connData); return HTTPD_CGI_MORE; } else{ //file found, transmit data len=f_read(state->f, buff, HTTP_BUFFER_SIZE); if (len>0){ NODE_DBG("Sending %d bytes of data",len); http_nwrite(connData,(const char*)buff,len); //http_response_transmit(connData); } if (state->f->eof) { NODE_DBG("End of file reached"); //We're done. f_close(state->f); os_free(state); return HTTPD_CGI_DONE; } else { //not done yet return HTTPD_CGI_MORE; } } } ================================================ FILE: app/http/cgi.h ================================================ /* * ---------------------------------------------------------------------------- * "THE BEER-WARE LICENSE" (Revision 42): * Israel Lot and Jeroen Domburg * wrote this file. As long as you retain this notice you can do whatever you * want with this stuff. If we meet some day, and you think this stuff is * worth it, you can buy us a beer in return. * ---------------------------------------------------------------------------- */ #ifndef CGI_H #define CGI_H #include "http.h" struct cgi_transmit_arg{ cgi_struct previous_cgi; uint8_t *data; uint8_t *dataPos; uint16_t len; }; int ICACHE_FLASH_ATTR cgi_transmit(http_connection *connData); int ICACHE_FLASH_ATTR cgi_cors(http_connection *connData); int ICACHE_FLASH_ATTR cgi_url_rewrite(http_connection *connData); int ICACHE_FLASH_ATTR cgi_redirect(http_connection *connData); int ICACHE_FLASH_ATTR cgi_check_host(http_connection *connData); int ICACHE_FLASH_ATTR cgi_file_system(http_connection *connData); int ICACHE_FLASH_ATTR cgi_enforce_method(http_connection *connData); #endif ================================================ FILE: app/http/cgi_relay.c ================================================ /* * ---------------------------------------------------------------------------- * "THE BEER-WARE LICENSE" (Revision 42): * Israel Lot and Jeroen Domburg * wrote this file. As long as you retain this notice you can do whatever you * want with this stuff. If we meet some day, and you think this stuff is * worth it, you can buy us a beer in return. * ---------------------------------------------------------------------------- */ #include "c_string.h" #include "osapi.h" #include "user_interface.h" #include "mem.h" #include "c_stdio.h" #include "platform.h" #include "user_config.h" #include "driver/relay.h" #include "sensor/sensors.h" #include "cgi.h" #include "http.h" #include "http_parser.h" #include "http_server.h" #include "http_process.h" #include "http_helper.h" #include "http_client.h" #include "json/cJson.h" int ICACHE_FLASH_ATTR http_relay_api_status(http_connection *c) { NODE_DBG("http_wifi_api_get_status"); //wait for whole body if(c->state state body.data); if(root==NULL) goto badrequest; cJSON * relay = cJSON_GetObjectItem(root,"relay"); if(relay==NULL) goto badrequest; int relayNumber = relay->valueint; cJSON_Delete(root); if(relayNumber<0 || relayNumber >=relay_count()){ http_response_BAD_REQUEST(c); NODE_DBG("Wrong relay"); return HTTPD_CGI_DONE; } else{ //valid relay unsigned status = relay_get_state(relayNumber); status = relay_toggle_state(relayNumber); //write headers http_SET_HEADER(c,HTTP_CONTENT_TYPE,JSON_CONTENT_TYPE); http_response_OK(c); //create json root = cJSON_CreateObject(); cJSON_AddNumberToObject(root,"relay",relayNumber); cJSON_AddNumberToObject(root,"state",status); http_write_json(c,root); //delete json struct cJSON_Delete(root); return HTTPD_CGI_DONE; } badrequest: http_response_BAD_REQUEST(c); return HTTPD_CGI_DONE; } //TODO move to own file int ICACHE_FLASH_ATTR http_dht_api_read(http_connection *c) { NODE_DBG("http_dht_api_read"); //wait for whole body if(c->state and Jeroen Domburg * wrote this file. As long as you retain this notice you can do whatever you * want with this stuff. If we meet some day, and you think this stuff is * worth it, you can buy us a beer in return. * ---------------------------------------------------------------------------- */ #ifndef CGI_RELAY_H #define CGI_RELAY_H int ICACHE_FLASH_ATTR http_relay_api_status(http_connection *c); int ICACHE_FLASH_ATTR http_relay_api_toggle(http_connection *c); int ICACHE_FLASH_ATTR http_dht_api_read(http_connection *c); #endif ================================================ FILE: app/http/cgi_wifi.c ================================================ /* * ---------------------------------------------------------------------------- * "THE BEER-WARE LICENSE" (Revision 42): * Israel Lot and Jeroen Domburg * wrote this file. As long as you retain this notice you can do whatever you * want with this stuff. If we meet some day, and you think this stuff is * worth it, you can buy us a beer in return. * ---------------------------------------------------------------------------- */ #include "c_string.h" #include "osapi.h" #include "user_interface.h" #include "mem.h" #include "espconn.h" #include "c_stdio.h" #include "user_config.h" #include #include "cgi.h" #include "http.h" #include "http_parser.h" #include "http_server.h" #include "http_process.h" #include "http_helper.h" #include "http_client.h" #include "json/cJson.h" //WiFi access point data typedef struct { char ssid[32]; char rssi; char enc; char channel; } ap; //Scan result typedef struct { ap **ap; int ap_count; } scan_result_data; typedef struct { uint8_t scanning; uint8_t connecting; scan_result_data scan_result; uint8_t mode; uint8_t station_status; struct station_config station_config; } wifi_status_t; typedef struct { uint8_t state; ETSTimer timer; } api_cgi_status; typedef struct { uint8_t state; ETSTimer timer; char ssid[32]; char pwd[64]; } api_cgi_connect_status; typedef struct { uint8_t state; http_connection *http_client; } api_cgi_check_internet_status; static wifi_status_t wifi_status; struct station_config *wifi_st_config; int ICACHE_FLASH_ATTR http_wifi_api_get_status(http_connection *c) { NODE_DBG("http_wifi_api_get_status"); //wait for whole body if(c->state cgi.data; if(status==NULL){ //first call, send headers NODE_DBG("\tSending headers"); status = (api_cgi_status*)os_malloc(sizeof(api_cgi_status)); status->state=1; c->cgi.data=status; http_SET_HEADER(c,HTTP_CONTENT_TYPE,JSON_CONTENT_TYPE); http_response_OK(c); NODE_DBG("\tHeaders done"); return HTTPD_CGI_MORE; } else if(status->state==1){ //json data NODE_DBG("\tSending json"); wifi_station_get_config(&wifi_status.station_config); uint8_t c_status = wifi_station_get_connect_status(); cJSON *root = cJSON_CreateObject(); cJSON_AddBoolToObject(root,"scanning",wifi_status.scanning); cJSON_AddStringToObject(root,"ssid",(const char *)wifi_status.station_config.ssid); cJSON_AddNumberToObject(root,"mode",wifi_get_opmode()); cJSON_AddNumberToObject(root,"station_status",c_status); if(c_status==5){ //got ip struct ip_info ip; wifi_get_ip_info(0x0,&ip); char *ip_str = ipaddr_ntoa(&ip.ip); cJSON_AddStringToObject(root,"ip",ip_str); } else{ cJSON_AddStringToObject(root,"ip",""); } http_write_json(c,root); cJSON_Delete(root); status->state=99; return HTTPD_CGI_MORE; } else{ os_free(c->cgi.data); return HTTPD_CGI_DONE; } } static void ICACHE_FLASH_ATTR http_wifi_api_scan_callback(void *arg, STATUS status){ int n; struct bss_info *bss_link = (struct bss_info *)arg; NODE_DBG("Wifi Scan Done, status: %d", status); if (status!=OK) { wifi_status.scanning=0; return; } //Clear prev ap data if needed. if (wifi_status.scan_result.ap!=NULL) { for (n=0; nnext.stqe_next; n++; } //Allocate memory for access point data wifi_status.scan_result.ap=(ap **)os_malloc(sizeof(ap *)*n); wifi_status.scan_result.ap_count=n; NODE_DBG("Scan done: found %d APs", n); //Copy access point data to the static struct n=0; bss_link = (struct bss_info *)arg; while (bss_link != NULL) { if (n>=wifi_status.scan_result.ap_count) { //This means the bss_link changed under our nose. Shouldn't happen! //Break because otherwise we will write in unallocated memory. NODE_DBG("Huh? I have more than the allocated %d aps!", wifi_status.scan_result.ap_count); break; } //Save the ap data. if(strlen(bss_link->ssid)>0){ wifi_status.scan_result.ap[n]=(ap *)os_malloc(sizeof(ap)); wifi_status.scan_result.ap[n]->rssi=bss_link->rssi; wifi_status.scan_result.ap[n]->enc=bss_link->authmode; wifi_status.scan_result.ap[n]->channel=bss_link->channel; strncpy(wifi_status.scan_result.ap[n]->ssid, (char*)bss_link->ssid, 32); n++; } else{ wifi_status.scan_result.ap_count--; } bss_link = bss_link->next.stqe_next; } //We're done. wifi_status.scanning=0; } typedef struct { uint8_t state; ETSTimer timer; int ap_index; } api_cgi_scan_status; int ICACHE_FLASH_ATTR http_wifi_api_scan(http_connection *c) { NODE_DBG("http_wifi_api_scan"); //wait for whole body if(c->state cgi.data; if(status==NULL){ //first call, create status //create status status = (api_cgi_scan_status*)os_malloc(sizeof(api_cgi_scan_status)); status->state=1; status->ap_index=0; c->cgi.data=status; if(!wifi_status.scanning){ //if not already scanning, request scan NODE_DBG("Starting scan"); wifi_station_scan(NULL,http_wifi_api_scan_callback); wifi_status.scanning=1; } //write headers http_SET_HEADER(c,HTTP_CONTENT_TYPE,JSON_CONTENT_TYPE); http_response_OK(c); //set state to 1 - waiting status->state=1; return HTTPD_CGI_MORE; } else{ if(wifi_status.scanning){ NODE_DBG("Waiting scan done"); //set timer to check again os_timer_disarm(&status->timer); os_timer_setfn(&status->timer, http_execute_cgi, c); os_timer_arm(&status->timer, 500, 0); return HTTPD_CGI_MORE; } else if(status->state==1){ //clear timer os_timer_disarm(&status->timer); NODE_DBG("Scan complete %d",status->ap_index); //create json cJSON *root = cJSON_CreateObject(); cJSON_AddNumberToObject(root,"ap_count",wifi_status.scan_result.ap_count); cJSON * array; cJSON * item; cJSON_AddItemToObject(root, "ap", array = cJSON_CreateArray()); //check max count on query string char *query=http_url_get_query_param(c,"max"); int max = INT_MAX; if(query!=NULL) max = atoi(query); int i; for(i=0;i< wifi_status.scan_result.ap_count && issid); cJSON_AddNumberToObject(item,"rssi",wifi_status.scan_result.ap[i]->rssi); cJSON_AddNumberToObject(item,"enc",wifi_status.scan_result.ap[i]->enc); cJSON_AddNumberToObject(item,"channel",wifi_status.scan_result.ap[i]->channel); } http_write_json(c,root); //delete json struct cJSON_Delete(root); status->state=99; return HTTPD_CGI_MORE; } else{ //free resources NODE_DBG("Freeing alloced memory"); os_free(c->cgi.data); return HTTPD_CGI_DONE; } } } int ICACHE_FLASH_ATTR http_wifi_api_disconnect(http_connection *c){ NODE_DBG("http_wifi_disconnect"); //wait for whole body if(c->state state cgi.data; if(status==NULL){ NODE_DBG("http_wifi_api_connect_ap status NULL"); status = (api_cgi_connect_status*)os_malloc(sizeof(api_cgi_connect_status)); status->state=1; c->cgi.data=status; //parse json and validate cJSON * root = cJSON_Parse(c->body.data); if(root==NULL) goto badrequest; cJSON * ssid = cJSON_GetObjectItem(root,"ssid"); if(ssid==NULL) goto badrequest; else if(ssid->type != cJSON_String) goto badrequest; cJSON * pwd = cJSON_GetObjectItem(root,"pwd"); if(pwd==NULL) goto badrequest; else if(pwd->type!=cJSON_String) goto badrequest; //parse ok strncpy(status->ssid,ssid->valuestring,32); strncpy(status->pwd,pwd->valuestring,64); //set timer to connect os_timer_disarm(&status->timer); os_timer_setfn(&status->timer, http_execute_cgi, c); os_timer_arm(&status->timer, 10, 0); return HTTPD_CGI_MORE; } else if(status->state==1){ NODE_DBG("http_wifi_api_connect_ap status %d",status->state); //try connect if(strlen(status->ssid)>32 || strlen(status->pwd)>64) goto badrequest; NODE_DBG("http_wifi_api_connect_ap ssid %s",status->ssid); NODE_DBG("http_wifi_api_connect_ap pwd %s",status->pwd); strcpy(wifi_status.station_config.ssid,status->ssid); strcpy(wifi_status.station_config.password,status->pwd); wifi_status.station_config.bssid_set=0; wifi_station_disconnect(); wifi_station_set_config(&wifi_status.station_config); wifi_station_connect(); //set timer to check status os_timer_disarm(&status->timer); os_timer_setfn(&status->timer, http_execute_cgi, c); os_timer_arm(&status->timer, 500, 0); status->state=2; return HTTPD_CGI_MORE; } else if(status->state==2){ NODE_DBG("http_wifi_api_connect_ap status %d",status->state); uint8_t c_status = wifi_station_get_connect_status(); NODE_DBG("http_wifi_api_connect_ap wifi status %d",c_status); if(c_status>=2 && c_status <= 4 ){ wifi_station_disconnect(); strcpy(wifi_status.station_config.ssid,""); strcpy(wifi_status.station_config.password,""); wifi_station_set_config(&wifi_status.station_config); } if(c_status==1){ //set timer to check status os_timer_disarm(&status->timer); os_timer_setfn(&status->timer, http_execute_cgi, c); os_timer_arm(&status->timer, 500, 0); return HTTPD_CGI_MORE; } else{ //write headers http_SET_HEADER(c,HTTP_CONTENT_TYPE,JSON_CONTENT_TYPE); http_response_OK(c); //create json cJSON *root = cJSON_CreateObject(); cJSON_AddNumberToObject(root,"status",c_status); if(c_status==5){ //got ip struct ip_info ip; wifi_get_ip_info(0x0,&ip); char *ip_str = ipaddr_ntoa(&ip.ip); cJSON_AddStringToObject(root,"ip",ip_str); } else{ cJSON_AddStringToObject(root,"ip",""); } http_write_json(c,root); //delete json struct cJSON_Delete(root); status->state=99; return HTTPD_CGI_MORE; } } else{ //=99 NODE_DBG("http_wifi_api_connect_ap status %d",status->state); //clean os_free(c->cgi.data); return HTTPD_CGI_DONE; } badrequest: http_response_BAD_REQUEST(c); status->state=99; return HTTPD_CGI_MORE; //shut up compiler return HTTPD_CGI_DONE; } int ICACHE_FLASH_ATTR http_wifi_api_check_internet_cb(http_connection *c){ NODE_DBG("http_wifi_api_check_internet_cb state: %d",c->state); http_connection *request=c->reverse; if(request->espConnection==NULL) { //client request has been aborted return HTTP_CLIENT_CGI_DONE; } api_cgi_check_internet_status * status = (api_cgi_check_internet_status *)request->cgi.data; if(c->state==HTTP_CLIENT_DNS_NOT_FOUND){ status->state=3; http_execute_cgi(request); return HTTP_CLIENT_CGI_DONE; } //wait whole body if(c->state==HTTPD_STATE_BODY_END){ if(c->parser.status_code==200) status->state=2; else status->state=3; http_execute_cgi(request); return HTTP_CLIENT_CGI_DONE; } return HTTP_CLIENT_CGI_MORE; } int ICACHE_FLASH_ATTR http_wifi_api_check_internet(http_connection *c){ NODE_DBG("http_wifi_api_check_internet"); //wait for whole body if(c->state cgi.data; if(status==NULL){ //first call, send headers NODE_DBG("http_wifi_api_check_internet null"); status = (api_cgi_check_internet_status*)os_malloc(sizeof(api_cgi_check_internet_status)); status->state=1; c->cgi.data=status; http_SET_HEADER(c,HTTP_CONTENT_TYPE,JSON_CONTENT_TYPE); http_response_OK(c); status->http_client = http_client_new(http_wifi_api_check_internet_cb); http_client_GET(status->http_client,"http://www.msftncsi.com/ncsi.txt"); status->http_client->reverse = c; //mark reverse so we can find on callback c->reverse=&status->http_client; //reverse other way around return HTTPD_CGI_MORE; } else if(status->state==1){ // just signal we aren't finished NODE_DBG("http_wifi_api_check_internet 1"); return HTTPD_CGI_MORE; } else if(status->state==2){ //DNS FOUND NODE_DBG("http_wifi_api_check_internet 2"); status->state=99; //create json cJSON *root = cJSON_CreateObject(); cJSON_AddNumberToObject(root,"status",1); http_write_json(c,root); //delete json struct cJSON_Delete(root); return HTTPD_CGI_MORE; } else if(status->state==3){ //DNS NOT FOUND status->state=99; //create json cJSON *root = cJSON_CreateObject(); cJSON_AddNumberToObject(root,"status",0); http_write_json(c,root); //delete json struct cJSON_Delete(root); return HTTPD_CGI_MORE; } else{ NODE_DBG("http_wifi_api_check_internet 99"); os_free(c->cgi.data); return HTTPD_CGI_DONE; } } ================================================ FILE: app/http/cgi_wifi.h ================================================ /* * ---------------------------------------------------------------------------- * "THE BEER-WARE LICENSE" (Revision 42): * Israel Lot and Jeroen Domburg * wrote this file. As long as you retain this notice you can do whatever you * want with this stuff. If we meet some day, and you think this stuff is * worth it, you can buy us a beer in return. * ---------------------------------------------------------------------------- */ #ifndef CGI_WIFI_H #define CGI_WIFI_H int ICACHE_FLASH_ATTR http_wifi_api_get_status(http_connection *c); int ICACHE_FLASH_ATTR http_wifi_api_scan(http_connection *c); int ICACHE_FLASH_ATTR http_wifi_api_connect_ap(http_connection *c); int ICACHE_FLASH_ATTR http_wifi_api_disconnect(http_connection *c); int ICACHE_FLASH_ATTR http_wifi_api_check_internet(http_connection *c); #endif ================================================ FILE: app/http/html/.bak/bootstrap.css ================================================ /*! * bootswatch v3.3.4+1 * Homepage: http://bootswatch.com * Copyright 2012-2015 Thomas Park * Licensed under MIT * Based on Bootstrap */ /*! normalize.css v3.0.2 | MIT License | git.io/normalize */ html { font-family: sans-serif; -ms-text-size-adjust: 100%; -webkit-text-size-adjust: 100%; } body { margin: 0; } article, aside, details, figcaption, figure, footer, header, hgroup, main, menu, nav, section, summary { display: block; } audio, canvas, progress, video { display: inline-block; vertical-align: baseline; } audio:not([controls]) { display: none; height: 0; } [hidden], template { display: none; } a { background-color: transparent; } a:active, a:hover { outline: 0; } abbr[title] { border-bottom: 1px dotted; } b, strong { font-weight: bold; } dfn { font-style: italic; } h1 { font-size: 2em; margin: 0.67em 0; } mark { background: #ff0; color: #000; } small { font-size: 80%; } sub, sup { font-size: 75%; line-height: 0; position: relative; vertical-align: baseline; } sup { top: -0.5em; } sub { bottom: -0.25em; } img { border: 0; } svg:not(:root) { overflow: hidden; } figure { margin: 1em 40px; } hr { -moz-box-sizing: content-box; -webkit-box-sizing: content-box; box-sizing: content-box; height: 0; } pre { overflow: auto; } code, kbd, pre, samp { font-family: monospace, monospace; font-size: 1em; } button, input, optgroup, select, textarea { color: inherit; font: inherit; margin: 0; } button { overflow: visible; } button, select { text-transform: none; } button, html input[type="button"], input[type="reset"], input[type="submit"] { -webkit-appearance: button; cursor: pointer; } button[disabled], html input[disabled] { cursor: default; } button::-moz-focus-inner, input::-moz-focus-inner { border: 0; padding: 0; } input { line-height: normal; } input[type="checkbox"], input[type="radio"] { -webkit-box-sizing: border-box; -moz-box-sizing: border-box; box-sizing: border-box; padding: 0; } input[type="number"]::-webkit-inner-spin-button, input[type="number"]::-webkit-outer-spin-button { height: auto; } input[type="search"] { -webkit-appearance: textfield; -moz-box-sizing: content-box; -webkit-box-sizing: content-box; box-sizing: content-box; } input[type="search"]::-webkit-search-cancel-button, input[type="search"]::-webkit-search-decoration { -webkit-appearance: none; } fieldset { border: 1px solid #c0c0c0; margin: 0 2px; padding: 0.35em 0.625em 0.75em; } legend { border: 0; padding: 0; } textarea { overflow: auto; } optgroup { font-weight: bold; } table { border-collapse: collapse; border-spacing: 0; } td, th { padding: 0; } /*! Source: https://github.com/h5bp/html5-boilerplate/blob/master/src/css/main.css */ @media print { *, *:before, *:after { background: transparent !important; color: #000 !important; -webkit-box-shadow: none !important; box-shadow: none !important; text-shadow: none !important; } a, a:visited { text-decoration: underline; } a[href]:after { content: " (" attr(href) ")"; } abbr[title]:after { content: " (" attr(title) ")"; } a[href^="#"]:after, a[href^="javascript:"]:after { content: ""; } pre, blockquote { border: 1px solid #999; page-break-inside: avoid; } thead { display: table-header-group; } tr, img { page-break-inside: avoid; } img { max-width: 100% !important; } p, h2, h3 { orphans: 3; widows: 3; } h2, h3 { page-break-after: avoid; } select { background: #fff !important; } .navbar { display: none; } .btn > .caret, .dropup > .btn > .caret { border-top-color: #000 !important; } .label { border: 1px solid #000; } .table { border-collapse: collapse !important; } .table td, .table th { background-color: #fff !important; } .table-bordered th, .table-bordered td { border: 1px solid #ddd !important; } } * { -webkit-box-sizing: border-box; -moz-box-sizing: border-box; box-sizing: border-box; } *:before, *:after { -webkit-box-sizing: border-box; -moz-box-sizing: border-box; box-sizing: border-box; } html { font-size: 10px; -webkit-tap-highlight-color: rgba(0, 0, 0, 0); } body { font-family: "Lato", "Helvetica Neue", Helvetica, Arial, sans-serif; font-size: 15px; line-height: 1.42857143; color: #ebebeb; background-color: #2b3e50; } input, button, select, textarea { font-family: inherit; font-size: inherit; line-height: inherit; } a { color: #df691a; text-decoration: none; } a:hover, a:focus { color: #df691a; text-decoration: underline; } a:focus { outline: thin dotted; outline: 5px auto -webkit-focus-ring-color; outline-offset: -2px; } figure { margin: 0; } img { vertical-align: middle; } .img-responsive, .thumbnail > img, .thumbnail a > img, .carousel-inner > .item > img, .carousel-inner > .item > a > img { display: block; max-width: 100%; height: auto; } .img-rounded { border-radius: 0; } .img-thumbnail { padding: 4px; line-height: 1.42857143; background-color: #2b3e50; border: 1px solid #dddddd; border-radius: 0; -webkit-transition: all 0.2s ease-in-out; -o-transition: all 0.2s ease-in-out; transition: all 0.2s ease-in-out; display: inline-block; max-width: 100%; height: auto; } .img-circle { border-radius: 50%; } hr { margin-top: 21px; margin-bottom: 21px; border: 0; border-top: 1px solid #596a7b; } .sr-only { position: absolute; width: 1px; height: 1px; margin: -1px; padding: 0; overflow: hidden; clip: rect(0, 0, 0, 0); border: 0; } .sr-only-focusable:active, .sr-only-focusable:focus { position: static; width: auto; height: auto; margin: 0; overflow: visible; clip: auto; } [role="button"] { cursor: pointer; } h1, h2, h3, h4, h5, h6, .h1, .h2, .h3, .h4, .h5, .h6 { font-family: inherit; font-weight: 300; line-height: 1.1; color: inherit; } h1 small, h2 small, h3 small, h4 small, h5 small, h6 small, .h1 small, .h2 small, .h3 small, .h4 small, .h5 small, .h6 small, h1 .small, h2 .small, h3 .small, h4 .small, h5 .small, h6 .small, .h1 .small, .h2 .small, .h3 .small, .h4 .small, .h5 .small, .h6 .small { font-weight: normal; line-height: 1; color: #ebebeb; } h1, .h1, h2, .h2, h3, .h3 { margin-top: 21px; margin-bottom: 10.5px; } h1 small, .h1 small, h2 small, .h2 small, h3 small, .h3 small, h1 .small, .h1 .small, h2 .small, .h2 .small, h3 .small, .h3 .small { font-size: 65%; } h4, .h4, h5, .h5, h6, .h6 { margin-top: 10.5px; margin-bottom: 10.5px; } h4 small, .h4 small, h5 small, .h5 small, h6 small, .h6 small, h4 .small, .h4 .small, h5 .small, .h5 .small, h6 .small, .h6 .small { font-size: 75%; } h1, .h1 { font-size: 39px; } h2, .h2 { font-size: 32px; } h3, .h3 { font-size: 26px; } h4, .h4 { font-size: 19px; } h5, .h5 { font-size: 15px; } h6, .h6 { font-size: 13px; } p { margin: 0 0 10.5px; } .lead { margin-bottom: 21px; font-size: 17px; font-weight: 300; line-height: 1.4; } @media (min-width: 768px) { .lead { font-size: 22.5px; } } small, .small { font-size: 86%; } mark, .mark { background-color: #f0ad4e; padding: .2em; } .text-left { text-align: left; } .text-right { text-align: right; } .text-center { text-align: center; } .text-justify { text-align: justify; } .text-nowrap { white-space: nowrap; } .text-lowercase { text-transform: lowercase; } .text-uppercase { text-transform: uppercase; } .text-capitalize { text-transform: capitalize; } .text-muted { color: #4e5d6c; } .text-primary { color: #df691a; } a.text-primary:hover { color: #b15315; } .text-success { color: #ebebeb; } a.text-success:hover { color: #d2d2d2; } .text-info { color: #ebebeb; } a.text-info:hover { color: #d2d2d2; } .text-warning { color: #ebebeb; } a.text-warning:hover { color: #d2d2d2; } .text-danger { color: #ebebeb; } a.text-danger:hover { color: #d2d2d2; } .bg-primary { color: #fff; background-color: #df691a; } a.bg-primary:hover { background-color: #b15315; } .bg-success { background-color: #5cb85c; } a.bg-success:hover { background-color: #449d44; } .bg-info { background-color: #5bc0de; } a.bg-info:hover { background-color: #31b0d5; } .bg-warning { background-color: #f0ad4e; } a.bg-warning:hover { background-color: #ec971f; } .bg-danger { background-color: #d9534f; } a.bg-danger:hover { background-color: #c9302c; } .page-header { padding-bottom: 9.5px; margin: 42px 0 21px; border-bottom: 1px solid #ebebeb; } ul, ol { margin-top: 0; margin-bottom: 10.5px; } ul ul, ol ul, ul ol, ol ol { margin-bottom: 0; } .list-unstyled { padding-left: 0; list-style: none; } .list-inline { padding-left: 0; list-style: none; margin-left: -5px; } .list-inline > li { display: inline-block; padding-left: 5px; padding-right: 5px; } dl { margin-top: 0; margin-bottom: 21px; } dt, dd { line-height: 1.42857143; } dt { font-weight: bold; } dd { margin-left: 0; } @media (min-width: 768px) { .dl-horizontal dt { float: left; width: 160px; clear: left; text-align: right; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; } .dl-horizontal dd { margin-left: 180px; } } abbr[title], abbr[data-original-title] { cursor: help; border-bottom: 1px dotted #4e5d6c; } .initialism { font-size: 90%; text-transform: uppercase; } blockquote { padding: 10.5px 21px; margin: 0 0 21px; font-size: 18.75px; border-left: 5px solid #4e5d6c; } blockquote p:last-child, blockquote ul:last-child, blockquote ol:last-child { margin-bottom: 0; } blockquote footer, blockquote small, blockquote .small { display: block; font-size: 80%; line-height: 1.42857143; color: #ebebeb; } blockquote footer:before, blockquote small:before, blockquote .small:before { content: '\2014 \00A0'; } .blockquote-reverse, blockquote.pull-right { padding-right: 15px; padding-left: 0; border-right: 5px solid #4e5d6c; border-left: 0; text-align: right; } .blockquote-reverse footer:before, blockquote.pull-right footer:before, .blockquote-reverse small:before, blockquote.pull-right small:before, .blockquote-reverse .small:before, blockquote.pull-right .small:before { content: ''; } .blockquote-reverse footer:after, blockquote.pull-right footer:after, .blockquote-reverse small:after, blockquote.pull-right small:after, .blockquote-reverse .small:after, blockquote.pull-right .small:after { content: '\00A0 \2014'; } address { margin-bottom: 21px; font-style: normal; line-height: 1.42857143; } code, kbd, pre, samp { font-family: Menlo, Monaco, Consolas, "Courier New", monospace; } code { padding: 2px 4px; font-size: 90%; color: #c7254e; background-color: #f9f2f4; border-radius: 0; } kbd { padding: 2px 4px; font-size: 90%; color: #ffffff; background-color: #333333; border-radius: 0; -webkit-box-shadow: inset 0 -1px 0 rgba(0, 0, 0, 0.25); box-shadow: inset 0 -1px 0 rgba(0, 0, 0, 0.25); } kbd kbd { padding: 0; font-size: 100%; font-weight: bold; -webkit-box-shadow: none; box-shadow: none; } pre { display: block; padding: 10px; margin: 0 0 10.5px; font-size: 14px; line-height: 1.42857143; word-break: break-all; word-wrap: break-word; color: #333333; background-color: #f5f5f5; border: 1px solid #cccccc; border-radius: 0; } pre code { padding: 0; font-size: inherit; color: inherit; white-space: pre-wrap; background-color: transparent; border-radius: 0; } .pre-scrollable { max-height: 340px; overflow-y: scroll; } .container { margin-right: auto; margin-left: auto; padding-left: 15px; padding-right: 15px; } @media (min-width: 768px) { .container { width: 750px; } } @media (min-width: 992px) { .container { width: 970px; } } @media (min-width: 1200px) { .container { width: 1170px; } } .container-fluid { margin-right: auto; margin-left: auto; padding-left: 15px; padding-right: 15px; } .row { margin-left: -15px; margin-right: -15px; } .col-xs-1, .col-sm-1, .col-md-1, .col-lg-1, .col-xs-2, .col-sm-2, .col-md-2, .col-lg-2, .col-xs-3, .col-sm-3, .col-md-3, .col-lg-3, .col-xs-4, .col-sm-4, .col-md-4, .col-lg-4, .col-xs-5, .col-sm-5, .col-md-5, .col-lg-5, .col-xs-6, .col-sm-6, .col-md-6, .col-lg-6, .col-xs-7, .col-sm-7, .col-md-7, .col-lg-7, .col-xs-8, .col-sm-8, .col-md-8, .col-lg-8, .col-xs-9, .col-sm-9, .col-md-9, .col-lg-9, .col-xs-10, .col-sm-10, .col-md-10, .col-lg-10, .col-xs-11, .col-sm-11, .col-md-11, .col-lg-11, .col-xs-12, .col-sm-12, .col-md-12, .col-lg-12 { position: relative; min-height: 1px; padding-left: 15px; padding-right: 15px; } .col-xs-1, .col-xs-2, .col-xs-3, .col-xs-4, .col-xs-5, .col-xs-6, .col-xs-7, .col-xs-8, .col-xs-9, .col-xs-10, .col-xs-11, .col-xs-12 { float: left; } .col-xs-12 { width: 100%; } .col-xs-11 { width: 91.66666667%; } .col-xs-10 { width: 83.33333333%; } .col-xs-9 { width: 75%; } .col-xs-8 { width: 66.66666667%; } .col-xs-7 { width: 58.33333333%; } .col-xs-6 { width: 50%; } .col-xs-5 { width: 41.66666667%; } .col-xs-4 { width: 33.33333333%; } .col-xs-3 { width: 25%; } .col-xs-2 { width: 16.66666667%; } .col-xs-1 { width: 8.33333333%; } .col-xs-pull-12 { right: 100%; } .col-xs-pull-11 { right: 91.66666667%; } .col-xs-pull-10 { right: 83.33333333%; } .col-xs-pull-9 { right: 75%; } .col-xs-pull-8 { right: 66.66666667%; } .col-xs-pull-7 { right: 58.33333333%; } .col-xs-pull-6 { right: 50%; } .col-xs-pull-5 { right: 41.66666667%; } .col-xs-pull-4 { right: 33.33333333%; } .col-xs-pull-3 { right: 25%; } .col-xs-pull-2 { right: 16.66666667%; } .col-xs-pull-1 { right: 8.33333333%; } .col-xs-pull-0 { right: auto; } .col-xs-push-12 { left: 100%; } .col-xs-push-11 { left: 91.66666667%; } .col-xs-push-10 { left: 83.33333333%; } .col-xs-push-9 { left: 75%; } .col-xs-push-8 { left: 66.66666667%; } .col-xs-push-7 { left: 58.33333333%; } .col-xs-push-6 { left: 50%; } .col-xs-push-5 { left: 41.66666667%; } .col-xs-push-4 { left: 33.33333333%; } .col-xs-push-3 { left: 25%; } .col-xs-push-2 { left: 16.66666667%; } .col-xs-push-1 { left: 8.33333333%; } .col-xs-push-0 { left: auto; } .col-xs-offset-12 { margin-left: 100%; } .col-xs-offset-11 { margin-left: 91.66666667%; } .col-xs-offset-10 { margin-left: 83.33333333%; } .col-xs-offset-9 { margin-left: 75%; } .col-xs-offset-8 { margin-left: 66.66666667%; } .col-xs-offset-7 { margin-left: 58.33333333%; } .col-xs-offset-6 { margin-left: 50%; } .col-xs-offset-5 { margin-left: 41.66666667%; } .col-xs-offset-4 { margin-left: 33.33333333%; } .col-xs-offset-3 { margin-left: 25%; } .col-xs-offset-2 { margin-left: 16.66666667%; } .col-xs-offset-1 { margin-left: 8.33333333%; } .col-xs-offset-0 { margin-left: 0%; } @media (min-width: 768px) { .col-sm-1, .col-sm-2, .col-sm-3, .col-sm-4, .col-sm-5, .col-sm-6, .col-sm-7, .col-sm-8, .col-sm-9, .col-sm-10, .col-sm-11, .col-sm-12 { float: left; } .col-sm-12 { width: 100%; } .col-sm-11 { width: 91.66666667%; } .col-sm-10 { width: 83.33333333%; } .col-sm-9 { width: 75%; } .col-sm-8 { width: 66.66666667%; } .col-sm-7 { width: 58.33333333%; } .col-sm-6 { width: 50%; } .col-sm-5 { width: 41.66666667%; } .col-sm-4 { width: 33.33333333%; } .col-sm-3 { width: 25%; } .col-sm-2 { width: 16.66666667%; } .col-sm-1 { width: 8.33333333%; } .col-sm-pull-12 { right: 100%; } .col-sm-pull-11 { right: 91.66666667%; } .col-sm-pull-10 { right: 83.33333333%; } .col-sm-pull-9 { right: 75%; } .col-sm-pull-8 { right: 66.66666667%; } .col-sm-pull-7 { right: 58.33333333%; } .col-sm-pull-6 { right: 50%; } .col-sm-pull-5 { right: 41.66666667%; } .col-sm-pull-4 { right: 33.33333333%; } .col-sm-pull-3 { right: 25%; } .col-sm-pull-2 { right: 16.66666667%; } .col-sm-pull-1 { right: 8.33333333%; } .col-sm-pull-0 { right: auto; } .col-sm-push-12 { left: 100%; } .col-sm-push-11 { left: 91.66666667%; } .col-sm-push-10 { left: 83.33333333%; } .col-sm-push-9 { left: 75%; } .col-sm-push-8 { left: 66.66666667%; } .col-sm-push-7 { left: 58.33333333%; } .col-sm-push-6 { left: 50%; } .col-sm-push-5 { left: 41.66666667%; } .col-sm-push-4 { left: 33.33333333%; } .col-sm-push-3 { left: 25%; } .col-sm-push-2 { left: 16.66666667%; } .col-sm-push-1 { left: 8.33333333%; } .col-sm-push-0 { left: auto; } .col-sm-offset-12 { margin-left: 100%; } .col-sm-offset-11 { margin-left: 91.66666667%; } .col-sm-offset-10 { margin-left: 83.33333333%; } .col-sm-offset-9 { margin-left: 75%; } .col-sm-offset-8 { margin-left: 66.66666667%; } .col-sm-offset-7 { margin-left: 58.33333333%; } .col-sm-offset-6 { margin-left: 50%; } .col-sm-offset-5 { margin-left: 41.66666667%; } .col-sm-offset-4 { margin-left: 33.33333333%; } .col-sm-offset-3 { margin-left: 25%; } .col-sm-offset-2 { margin-left: 16.66666667%; } .col-sm-offset-1 { margin-left: 8.33333333%; } .col-sm-offset-0 { margin-left: 0%; } } @media (min-width: 992px) { .col-md-1, .col-md-2, .col-md-3, .col-md-4, .col-md-5, .col-md-6, .col-md-7, .col-md-8, .col-md-9, .col-md-10, .col-md-11, .col-md-12 { float: left; } .col-md-12 { width: 100%; } .col-md-11 { width: 91.66666667%; } .col-md-10 { width: 83.33333333%; } .col-md-9 { width: 75%; } .col-md-8 { width: 66.66666667%; } .col-md-7 { width: 58.33333333%; } .col-md-6 { width: 50%; } .col-md-5 { width: 41.66666667%; } .col-md-4 { width: 33.33333333%; } .col-md-3 { width: 25%; } .col-md-2 { width: 16.66666667%; } .col-md-1 { width: 8.33333333%; } .col-md-pull-12 { right: 100%; } .col-md-pull-11 { right: 91.66666667%; } .col-md-pull-10 { right: 83.33333333%; } .col-md-pull-9 { right: 75%; } .col-md-pull-8 { right: 66.66666667%; } .col-md-pull-7 { right: 58.33333333%; } .col-md-pull-6 { right: 50%; } .col-md-pull-5 { right: 41.66666667%; } .col-md-pull-4 { right: 33.33333333%; } .col-md-pull-3 { right: 25%; } .col-md-pull-2 { right: 16.66666667%; } .col-md-pull-1 { right: 8.33333333%; } .col-md-pull-0 { right: auto; } .col-md-push-12 { left: 100%; } .col-md-push-11 { left: 91.66666667%; } .col-md-push-10 { left: 83.33333333%; } .col-md-push-9 { left: 75%; } .col-md-push-8 { left: 66.66666667%; } .col-md-push-7 { left: 58.33333333%; } .col-md-push-6 { left: 50%; } .col-md-push-5 { left: 41.66666667%; } .col-md-push-4 { left: 33.33333333%; } .col-md-push-3 { left: 25%; } .col-md-push-2 { left: 16.66666667%; } .col-md-push-1 { left: 8.33333333%; } .col-md-push-0 { left: auto; } .col-md-offset-12 { margin-left: 100%; } .col-md-offset-11 { margin-left: 91.66666667%; } .col-md-offset-10 { margin-left: 83.33333333%; } .col-md-offset-9 { margin-left: 75%; } .col-md-offset-8 { margin-left: 66.66666667%; } .col-md-offset-7 { margin-left: 58.33333333%; } .col-md-offset-6 { margin-left: 50%; } .col-md-offset-5 { margin-left: 41.66666667%; } .col-md-offset-4 { margin-left: 33.33333333%; } .col-md-offset-3 { margin-left: 25%; } .col-md-offset-2 { margin-left: 16.66666667%; } .col-md-offset-1 { margin-left: 8.33333333%; } .col-md-offset-0 { margin-left: 0%; } } @media (min-width: 1200px) { .col-lg-1, .col-lg-2, .col-lg-3, .col-lg-4, .col-lg-5, .col-lg-6, .col-lg-7, .col-lg-8, .col-lg-9, .col-lg-10, .col-lg-11, .col-lg-12 { float: left; } .col-lg-12 { width: 100%; } .col-lg-11 { width: 91.66666667%; } .col-lg-10 { width: 83.33333333%; } .col-lg-9 { width: 75%; } .col-lg-8 { width: 66.66666667%; } .col-lg-7 { width: 58.33333333%; } .col-lg-6 { width: 50%; } .col-lg-5 { width: 41.66666667%; } .col-lg-4 { width: 33.33333333%; } .col-lg-3 { width: 25%; } .col-lg-2 { width: 16.66666667%; } .col-lg-1 { width: 8.33333333%; } .col-lg-pull-12 { right: 100%; } .col-lg-pull-11 { right: 91.66666667%; } .col-lg-pull-10 { right: 83.33333333%; } .col-lg-pull-9 { right: 75%; } .col-lg-pull-8 { right: 66.66666667%; } .col-lg-pull-7 { right: 58.33333333%; } .col-lg-pull-6 { right: 50%; } .col-lg-pull-5 { right: 41.66666667%; } .col-lg-pull-4 { right: 33.33333333%; } .col-lg-pull-3 { right: 25%; } .col-lg-pull-2 { right: 16.66666667%; } .col-lg-pull-1 { right: 8.33333333%; } .col-lg-pull-0 { right: auto; } .col-lg-push-12 { left: 100%; } .col-lg-push-11 { left: 91.66666667%; } .col-lg-push-10 { left: 83.33333333%; } .col-lg-push-9 { left: 75%; } .col-lg-push-8 { left: 66.66666667%; } .col-lg-push-7 { left: 58.33333333%; } .col-lg-push-6 { left: 50%; } .col-lg-push-5 { left: 41.66666667%; } .col-lg-push-4 { left: 33.33333333%; } .col-lg-push-3 { left: 25%; } .col-lg-push-2 { left: 16.66666667%; } .col-lg-push-1 { left: 8.33333333%; } .col-lg-push-0 { left: auto; } .col-lg-offset-12 { margin-left: 100%; } .col-lg-offset-11 { margin-left: 91.66666667%; } .col-lg-offset-10 { margin-left: 83.33333333%; } .col-lg-offset-9 { margin-left: 75%; } .col-lg-offset-8 { margin-left: 66.66666667%; } .col-lg-offset-7 { margin-left: 58.33333333%; } .col-lg-offset-6 { margin-left: 50%; } .col-lg-offset-5 { margin-left: 41.66666667%; } .col-lg-offset-4 { margin-left: 33.33333333%; } .col-lg-offset-3 { margin-left: 25%; } .col-lg-offset-2 { margin-left: 16.66666667%; } .col-lg-offset-1 { margin-left: 8.33333333%; } .col-lg-offset-0 { margin-left: 0%; } } table { background-color: transparent; } caption { padding-top: 6px; padding-bottom: 6px; color: #4e5d6c; text-align: left; } th { text-align: left; } .table { width: 100%; max-width: 100%; margin-bottom: 21px; } .table > thead > tr > th, .table > tbody > tr > th, .table > tfoot > tr > th, .table > thead > tr > td, .table > tbody > tr > td, .table > tfoot > tr > td { padding: 10px; line-height: 1.42857143; vertical-align: top; border-top: 1px solid #4e5d6c; } .table > thead > tr > th { vertical-align: bottom; border-bottom: 2px solid #4e5d6c; } .table > caption + thead > tr:first-child > th, .table > colgroup + thead > tr:first-child > th, .table > thead:first-child > tr:first-child > th, .table > caption + thead > tr:first-child > td, .table > colgroup + thead > tr:first-child > td, .table > thead:first-child > tr:first-child > td { border-top: 0; } .table > tbody + tbody { border-top: 2px solid #4e5d6c; } .table .table { background-color: #2b3e50; } .table-condensed > thead > tr > th, .table-condensed > tbody > tr > th, .table-condensed > tfoot > tr > th, .table-condensed > thead > tr > td, .table-condensed > tbody > tr > td, .table-condensed > tfoot > tr > td { padding: 3px; } .table-bordered { border: 1px solid #4e5d6c; } .table-bordered > thead > tr > th, .table-bordered > tbody > tr > th, .table-bordered > tfoot > tr > th, .table-bordered > thead > tr > td, .table-bordered > tbody > tr > td, .table-bordered > tfoot > tr > td { border: 1px solid #4e5d6c; } .table-bordered > thead > tr > th, .table-bordered > thead > tr > td { border-bottom-width: 2px; } .table-striped > tbody > tr:nth-of-type(odd) { background-color: #4e5d6c; } .table-hover > tbody > tr:hover { background-color: #485563; } table col[class*="col-"] { position: static; float: none; display: table-column; } table td[class*="col-"], table th[class*="col-"] { position: static; float: none; display: table-cell; } .table > thead > tr > td.active, .table > tbody > tr > td.active, .table > tfoot > tr > td.active, .table > thead > tr > th.active, .table > tbody > tr > th.active, .table > tfoot > tr > th.active, .table > thead > tr.active > td, .table > tbody > tr.active > td, .table > tfoot > tr.active > td, .table > thead > tr.active > th, .table > tbody > tr.active > th, .table > tfoot > tr.active > th { background-color: #485563; } .table-hover > tbody > tr > td.active:hover, .table-hover > tbody > tr > th.active:hover, .table-hover > tbody > tr.active:hover > td, .table-hover > tbody > tr:hover > .active, .table-hover > tbody > tr.active:hover > th { background-color: #3d4954; } .table > thead > tr > td.success, .table > tbody > tr > td.success, .table > tfoot > tr > td.success, .table > thead > tr > th.success, .table > tbody > tr > th.success, .table > tfoot > tr > th.success, .table > thead > tr.success > td, .table > tbody > tr.success > td, .table > tfoot > tr.success > td, .table > thead > tr.success > th, .table > tbody > tr.success > th, .table > tfoot > tr.success > th { background-color: #5cb85c; } .table-hover > tbody > tr > td.success:hover, .table-hover > tbody > tr > th.success:hover, .table-hover > tbody > tr.success:hover > td, .table-hover > tbody > tr:hover > .success, .table-hover > tbody > tr.success:hover > th { background-color: #4cae4c; } .table > thead > tr > td.info, .table > tbody > tr > td.info, .table > tfoot > tr > td.info, .table > thead > tr > th.info, .table > tbody > tr > th.info, .table > tfoot > tr > th.info, .table > thead > tr.info > td, .table > tbody > tr.info > td, .table > tfoot > tr.info > td, .table > thead > tr.info > th, .table > tbody > tr.info > th, .table > tfoot > tr.info > th { background-color: #5bc0de; } .table-hover > tbody > tr > td.info:hover, .table-hover > tbody > tr > th.info:hover, .table-hover > tbody > tr.info:hover > td, .table-hover > tbody > tr:hover > .info, .table-hover > tbody > tr.info:hover > th { background-color: #46b8da; } .table > thead > tr > td.warning, .table > tbody > tr > td.warning, .table > tfoot > tr > td.warning, .table > thead > tr > th.warning, .table > tbody > tr > th.warning, .table > tfoot > tr > th.warning, .table > thead > tr.warning > td, .table > tbody > tr.warning > td, .table > tfoot > tr.warning > td, .table > thead > tr.warning > th, .table > tbody > tr.warning > th, .table > tfoot > tr.warning > th { background-color: #f0ad4e; } .table-hover > tbody > tr > td.warning:hover, .table-hover > tbody > tr > th.warning:hover, .table-hover > tbody > tr.warning:hover > td, .table-hover > tbody > tr:hover > .warning, .table-hover > tbody > tr.warning:hover > th { background-color: #eea236; } .table > thead > tr > td.danger, .table > tbody > tr > td.danger, .table > tfoot > tr > td.danger, .table > thead > tr > th.danger, .table > tbody > tr > th.danger, .table > tfoot > tr > th.danger, .table > thead > tr.danger > td, .table > tbody > tr.danger > td, .table > tfoot > tr.danger > td, .table > thead > tr.danger > th, .table > tbody > tr.danger > th, .table > tfoot > tr.danger > th { background-color: #d9534f; } .table-hover > tbody > tr > td.danger:hover, .table-hover > tbody > tr > th.danger:hover, .table-hover > tbody > tr.danger:hover > td, .table-hover > tbody > tr:hover > .danger, .table-hover > tbody > tr.danger:hover > th { background-color: #d43f3a; } .table-responsive { overflow-x: auto; min-height: 0.01%; } @media screen and (max-width: 767px) { .table-responsive { width: 100%; margin-bottom: 15.75px; overflow-y: hidden; -ms-overflow-style: -ms-autohiding-scrollbar; border: 1px solid #4e5d6c; } .table-responsive > .table { margin-bottom: 0; } .table-responsive > .table > thead > tr > th, .table-responsive > .table > tbody > tr > th, .table-responsive > .table > tfoot > tr > th, .table-responsive > .table > thead > tr > td, .table-responsive > .table > tbody > tr > td, .table-responsive > .table > tfoot > tr > td { white-space: nowrap; } .table-responsive > .table-bordered { border: 0; } .table-responsive > .table-bordered > thead > tr > th:first-child, .table-responsive > .table-bordered > tbody > tr > th:first-child, .table-responsive > .table-bordered > tfoot > tr > th:first-child, .table-responsive > .table-bordered > thead > tr > td:first-child, .table-responsive > .table-bordered > tbody > tr > td:first-child, .table-responsive > .table-bordered > tfoot > tr > td:first-child { border-left: 0; } .table-responsive > .table-bordered > thead > tr > th:last-child, .table-responsive > .table-bordered > tbody > tr > th:last-child, .table-responsive > .table-bordered > tfoot > tr > th:last-child, .table-responsive > .table-bordered > thead > tr > td:last-child, .table-responsive > .table-bordered > tbody > tr > td:last-child, .table-responsive > .table-bordered > tfoot > tr > td:last-child { border-right: 0; } .table-responsive > .table-bordered > tbody > tr:last-child > th, .table-responsive > .table-bordered > tfoot > tr:last-child > th, .table-responsive > .table-bordered > tbody > tr:last-child > td, .table-responsive > .table-bordered > tfoot > tr:last-child > td { border-bottom: 0; } } fieldset { padding: 0; margin: 0; border: 0; min-width: 0; } legend { display: block; width: 100%; padding: 0; margin-bottom: 21px; font-size: 22.5px; line-height: inherit; color: #ebebeb; border: 0; border-bottom: 1px solid #4e5d6c; } label { display: inline-block; max-width: 100%; margin-bottom: 5px; font-weight: bold; } input[type="search"] { -webkit-box-sizing: border-box; -moz-box-sizing: border-box; box-sizing: border-box; } input[type="radio"], input[type="checkbox"] { margin: 4px 0 0; margin-top: 1px \9; line-height: normal; } input[type="file"] { display: block; } input[type="range"] { display: block; width: 100%; } select[multiple], select[size] { height: auto; } input[type="file"]:focus, input[type="radio"]:focus, input[type="checkbox"]:focus { outline: thin dotted; outline: 5px auto -webkit-focus-ring-color; outline-offset: -2px; } output { display: block; padding-top: 9px; font-size: 15px; line-height: 1.42857143; color: #2b3e50; } .form-control { display: block; width: 100%; height: 39px; padding: 8px 16px; font-size: 15px; line-height: 1.42857143; color: #2b3e50; background-color: #ffffff; background-image: none; border: 1px solid transparent; border-radius: 0; -webkit-box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.075); box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.075); -webkit-transition: border-color ease-in-out .15s, -webkit-box-shadow ease-in-out .15s; -o-transition: border-color ease-in-out .15s, box-shadow ease-in-out .15s; transition: border-color ease-in-out .15s, box-shadow ease-in-out .15s; } .form-control:focus { border-color: transparent; outline: 0; -webkit-box-shadow: inset 0 1px 1px rgba(0,0,0,.075), 0 0 8px rgba(0, 0, 0, 0.6); box-shadow: inset 0 1px 1px rgba(0,0,0,.075), 0 0 8px rgba(0, 0, 0, 0.6); } .form-control::-moz-placeholder { color: #cccccc; opacity: 1; } .form-control:-ms-input-placeholder { color: #cccccc; } .form-control::-webkit-input-placeholder { color: #cccccc; } .form-control[disabled], .form-control[readonly], fieldset[disabled] .form-control { background-color: #ebebeb; opacity: 1; } .form-control[disabled], fieldset[disabled] .form-control { cursor: not-allowed; } textarea.form-control { height: auto; } input[type="search"] { -webkit-appearance: none; } @media screen and (-webkit-min-device-pixel-ratio: 0) { input[type="date"], input[type="time"], input[type="datetime-local"], input[type="month"] { line-height: 39px; } input[type="date"].input-sm, input[type="time"].input-sm, input[type="datetime-local"].input-sm, input[type="month"].input-sm, .input-group-sm input[type="date"], .input-group-sm input[type="time"], .input-group-sm input[type="datetime-local"], .input-group-sm input[type="month"] { line-height: 31px; } input[type="date"].input-lg, input[type="time"].input-lg, input[type="datetime-local"].input-lg, input[type="month"].input-lg, .input-group-lg input[type="date"], .input-group-lg input[type="time"], .input-group-lg input[type="datetime-local"], .input-group-lg input[type="month"] { line-height: 52px; } } .form-group { margin-bottom: 15px; } .radio, .checkbox { position: relative; display: block; margin-top: 10px; margin-bottom: 10px; } .radio label, .checkbox label { min-height: 21px; padding-left: 20px; margin-bottom: 0; font-weight: normal; cursor: pointer; } .radio input[type="radio"], .radio-inline input[type="radio"], .checkbox input[type="checkbox"], .checkbox-inline input[type="checkbox"] { position: absolute; margin-left: -20px; margin-top: 4px \9; } .radio + .radio, .checkbox + .checkbox { margin-top: -5px; } .radio-inline, .checkbox-inline { position: relative; display: inline-block; padding-left: 20px; margin-bottom: 0; vertical-align: middle; font-weight: normal; cursor: pointer; } .radio-inline + .radio-inline, .checkbox-inline + .checkbox-inline { margin-top: 0; margin-left: 10px; } input[type="radio"][disabled], input[type="checkbox"][disabled], input[type="radio"].disabled, input[type="checkbox"].disabled, fieldset[disabled] input[type="radio"], fieldset[disabled] input[type="checkbox"] { cursor: not-allowed; } .radio-inline.disabled, .checkbox-inline.disabled, fieldset[disabled] .radio-inline, fieldset[disabled] .checkbox-inline { cursor: not-allowed; } .radio.disabled label, .checkbox.disabled label, fieldset[disabled] .radio label, fieldset[disabled] .checkbox label { cursor: not-allowed; } .form-control-static { padding-top: 9px; padding-bottom: 9px; margin-bottom: 0; min-height: 36px; } .form-control-static.input-lg, .form-control-static.input-sm { padding-left: 0; padding-right: 0; } .input-sm { height: 31px; padding: 5px 10px; font-size: 13px; line-height: 1.5; border-radius: 0; } select.input-sm { height: 31px; line-height: 31px; } textarea.input-sm, select[multiple].input-sm { height: auto; } .form-group-sm .form-control { height: 31px; padding: 5px 10px; font-size: 13px; line-height: 1.5; border-radius: 0; } select.form-group-sm .form-control { height: 31px; line-height: 31px; } textarea.form-group-sm .form-control, select[multiple].form-group-sm .form-control { height: auto; } .form-group-sm .form-control-static { height: 31px; padding: 5px 10px; font-size: 13px; line-height: 1.5; min-height: 34px; } .input-lg { height: 52px; padding: 12px 24px; font-size: 19px; line-height: 1.3333333; border-radius: 0; } select.input-lg { height: 52px; line-height: 52px; } textarea.input-lg, select[multiple].input-lg { height: auto; } .form-group-lg .form-control { height: 52px; padding: 12px 24px; font-size: 19px; line-height: 1.3333333; border-radius: 0; } select.form-group-lg .form-control { height: 52px; line-height: 52px; } textarea.form-group-lg .form-control, select[multiple].form-group-lg .form-control { height: auto; } .form-group-lg .form-control-static { height: 52px; padding: 12px 24px; font-size: 19px; line-height: 1.3333333; min-height: 40px; } .has-feedback { position: relative; } .has-feedback .form-control { padding-right: 48.75px; } .form-control-feedback { position: absolute; top: 0; right: 0; z-index: 2; display: block; width: 39px; height: 39px; line-height: 39px; text-align: center; pointer-events: none; } .input-lg + .form-control-feedback { width: 52px; height: 52px; line-height: 52px; } .input-sm + .form-control-feedback { width: 31px; height: 31px; line-height: 31px; } .has-success .help-block, .has-success .control-label, .has-success .radio, .has-success .checkbox, .has-success .radio-inline, .has-success .checkbox-inline, .has-success.radio label, .has-success.checkbox label, .has-success.radio-inline label, .has-success.checkbox-inline label { color: #ebebeb; } .has-success .form-control { border-color: #ebebeb; -webkit-box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.075); box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.075); } .has-success .form-control:focus { border-color: #d2d2d2; -webkit-box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.075), 0 0 6px #ffffff; box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.075), 0 0 6px #ffffff; } .has-success .input-group-addon { color: #ebebeb; border-color: #ebebeb; background-color: #5cb85c; } .has-success .form-control-feedback { color: #ebebeb; } .has-warning .help-block, .has-warning .control-label, .has-warning .radio, .has-warning .checkbox, .has-warning .radio-inline, .has-warning .checkbox-inline, .has-warning.radio label, .has-warning.checkbox label, .has-warning.radio-inline label, .has-warning.checkbox-inline label { color: #ebebeb; } .has-warning .form-control { border-color: #ebebeb; -webkit-box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.075); box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.075); } .has-warning .form-control:focus { border-color: #d2d2d2; -webkit-box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.075), 0 0 6px #ffffff; box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.075), 0 0 6px #ffffff; } .has-warning .input-group-addon { color: #ebebeb; border-color: #ebebeb; background-color: #f0ad4e; } .has-warning .form-control-feedback { color: #ebebeb; } .has-error .help-block, .has-error .control-label, .has-error .radio, .has-error .checkbox, .has-error .radio-inline, .has-error .checkbox-inline, .has-error.radio label, .has-error.checkbox label, .has-error.radio-inline label, .has-error.checkbox-inline label { color: #ebebeb; } .has-error .form-control { border-color: #ebebeb; -webkit-box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.075); box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.075); } .has-error .form-control:focus { border-color: #d2d2d2; -webkit-box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.075), 0 0 6px #ffffff; box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.075), 0 0 6px #ffffff; } .has-error .input-group-addon { color: #ebebeb; border-color: #ebebeb; background-color: #d9534f; } .has-error .form-control-feedback { color: #ebebeb; } .has-feedback label ~ .form-control-feedback { top: 26px; } .has-feedback label.sr-only ~ .form-control-feedback { top: 0; } .help-block { display: block; margin-top: 5px; margin-bottom: 10px; color: #ffffff; } @media (min-width: 768px) { .form-inline .form-group { display: inline-block; margin-bottom: 0; vertical-align: middle; } .form-inline .form-control { display: inline-block; width: auto; vertical-align: middle; } .form-inline .form-control-static { display: inline-block; } .form-inline .input-group { display: inline-table; vertical-align: middle; } .form-inline .input-group .input-group-addon, .form-inline .input-group .input-group-btn, .form-inline .input-group .form-control { width: auto; } .form-inline .input-group > .form-control { width: 100%; } .form-inline .control-label { margin-bottom: 0; vertical-align: middle; } .form-inline .radio, .form-inline .checkbox { display: inline-block; margin-top: 0; margin-bottom: 0; vertical-align: middle; } .form-inline .radio label, .form-inline .checkbox label { padding-left: 0; } .form-inline .radio input[type="radio"], .form-inline .checkbox input[type="checkbox"] { position: relative; margin-left: 0; } .form-inline .has-feedback .form-control-feedback { top: 0; } } .form-horizontal .radio, .form-horizontal .checkbox, .form-horizontal .radio-inline, .form-horizontal .checkbox-inline { margin-top: 0; margin-bottom: 0; padding-top: 9px; } .form-horizontal .radio, .form-horizontal .checkbox { min-height: 30px; } .form-horizontal .form-group { margin-left: -15px; margin-right: -15px; } @media (min-width: 768px) { .form-horizontal .control-label { text-align: right; margin-bottom: 0; padding-top: 9px; } } .form-horizontal .has-feedback .form-control-feedback { right: 15px; } @media (min-width: 768px) { .form-horizontal .form-group-lg .control-label { padding-top: 16.9999996px; } } @media (min-width: 768px) { .form-horizontal .form-group-sm .control-label { padding-top: 6px; } } .btn { display: inline-block; margin-bottom: 0; font-weight: normal; text-align: center; vertical-align: middle; -ms-touch-action: manipulation; touch-action: manipulation; cursor: pointer; background-image: none; border: 1px solid transparent; white-space: nowrap; padding: 8px 16px; font-size: 15px; line-height: 1.42857143; border-radius: 0; -webkit-user-select: none; -moz-user-select: none; -ms-user-select: none; user-select: none; } .btn:focus, .btn:active:focus, .btn.active:focus, .btn.focus, .btn:active.focus, .btn.active.focus { outline: thin dotted; outline: 5px auto -webkit-focus-ring-color; outline-offset: -2px; } .btn:hover, .btn:focus, .btn.focus { color: #ffffff; text-decoration: none; } .btn:active, .btn.active { outline: 0; background-image: none; -webkit-box-shadow: inset 0 3px 5px rgba(0, 0, 0, 0.125); box-shadow: inset 0 3px 5px rgba(0, 0, 0, 0.125); } .btn.disabled, .btn[disabled], fieldset[disabled] .btn { cursor: not-allowed; pointer-events: none; opacity: 0.65; filter: alpha(opacity=65); -webkit-box-shadow: none; box-shadow: none; } .btn-default { color: #ffffff; background-color: #4e5d6c; border-color: transparent; } .btn-default:hover, .btn-default:focus, .btn-default.focus, .btn-default:active, .btn-default.active, .open > .dropdown-toggle.btn-default { color: #ffffff; background-color: #39444e; border-color: rgba(0, 0, 0, 0); } .btn-default:active, .btn-default.active, .open > .dropdown-toggle.btn-default { background-image: none; } .btn-default.disabled, .btn-default[disabled], fieldset[disabled] .btn-default, .btn-default.disabled:hover, .btn-default[disabled]:hover, fieldset[disabled] .btn-default:hover, .btn-default.disabled:focus, .btn-default[disabled]:focus, fieldset[disabled] .btn-default:focus, .btn-default.disabled.focus, .btn-default[disabled].focus, fieldset[disabled] .btn-default.focus, .btn-default.disabled:active, .btn-default[disabled]:active, fieldset[disabled] .btn-default:active, .btn-default.disabled.active, .btn-default[disabled].active, fieldset[disabled] .btn-default.active { background-color: #4e5d6c; border-color: transparent; } .btn-default .badge { color: #4e5d6c; background-color: #ffffff; } .btn-primary { color: #ffffff; background-color: #df691a; border-color: transparent; } .btn-primary:hover, .btn-primary:focus, .btn-primary.focus, .btn-primary:active, .btn-primary.active, .open > .dropdown-toggle.btn-primary { color: #ffffff; background-color: #b15315; border-color: rgba(0, 0, 0, 0); } .btn-primary:active, .btn-primary.active, .open > .dropdown-toggle.btn-primary { background-image: none; } .btn-primary.disabled, .btn-primary[disabled], fieldset[disabled] .btn-primary, .btn-primary.disabled:hover, .btn-primary[disabled]:hover, fieldset[disabled] .btn-primary:hover, .btn-primary.disabled:focus, .btn-primary[disabled]:focus, fieldset[disabled] .btn-primary:focus, .btn-primary.disabled.focus, .btn-primary[disabled].focus, fieldset[disabled] .btn-primary.focus, .btn-primary.disabled:active, .btn-primary[disabled]:active, fieldset[disabled] .btn-primary:active, .btn-primary.disabled.active, .btn-primary[disabled].active, fieldset[disabled] .btn-primary.active { background-color: #df691a; border-color: transparent; } .btn-primary .badge { color: #df691a; background-color: #ffffff; } .btn-success { color: #ffffff; background-color: #5cb85c; border-color: transparent; } .btn-success:hover, .btn-success:focus, .btn-success.focus, .btn-success:active, .btn-success.active, .open > .dropdown-toggle.btn-success { color: #ffffff; background-color: #449d44; border-color: rgba(0, 0, 0, 0); } .btn-success:active, .btn-success.active, .open > .dropdown-toggle.btn-success { background-image: none; } .btn-success.disabled, .btn-success[disabled], fieldset[disabled] .btn-success, .btn-success.disabled:hover, .btn-success[disabled]:hover, fieldset[disabled] .btn-success:hover, .btn-success.disabled:focus, .btn-success[disabled]:focus, fieldset[disabled] .btn-success:focus, .btn-success.disabled.focus, .btn-success[disabled].focus, fieldset[disabled] .btn-success.focus, .btn-success.disabled:active, .btn-success[disabled]:active, fieldset[disabled] .btn-success:active, .btn-success.disabled.active, .btn-success[disabled].active, fieldset[disabled] .btn-success.active { background-color: #5cb85c; border-color: transparent; } .btn-success .badge { color: #5cb85c; background-color: #ffffff; } .btn-info { color: #ffffff; background-color: #5bc0de; border-color: transparent; } .btn-info:hover, .btn-info:focus, .btn-info.focus, .btn-info:active, .btn-info.active, .open > .dropdown-toggle.btn-info { color: #ffffff; background-color: #31b0d5; border-color: rgba(0, 0, 0, 0); } .btn-info:active, .btn-info.active, .open > .dropdown-toggle.btn-info { background-image: none; } .btn-info.disabled, .btn-info[disabled], fieldset[disabled] .btn-info, .btn-info.disabled:hover, .btn-info[disabled]:hover, fieldset[disabled] .btn-info:hover, .btn-info.disabled:focus, .btn-info[disabled]:focus, fieldset[disabled] .btn-info:focus, .btn-info.disabled.focus, .btn-info[disabled].focus, fieldset[disabled] .btn-info.focus, .btn-info.disabled:active, .btn-info[disabled]:active, fieldset[disabled] .btn-info:active, .btn-info.disabled.active, .btn-info[disabled].active, fieldset[disabled] .btn-info.active { background-color: #5bc0de; border-color: transparent; } .btn-info .badge { color: #5bc0de; background-color: #ffffff; } .btn-warning { color: #ffffff; background-color: #f0ad4e; border-color: transparent; } .btn-warning:hover, .btn-warning:focus, .btn-warning.focus, .btn-warning:active, .btn-warning.active, .open > .dropdown-toggle.btn-warning { color: #ffffff; background-color: #ec971f; border-color: rgba(0, 0, 0, 0); } .btn-warning:active, .btn-warning.active, .open > .dropdown-toggle.btn-warning { background-image: none; } .btn-warning.disabled, .btn-warning[disabled], fieldset[disabled] .btn-warning, .btn-warning.disabled:hover, .btn-warning[disabled]:hover, fieldset[disabled] .btn-warning:hover, .btn-warning.disabled:focus, .btn-warning[disabled]:focus, fieldset[disabled] .btn-warning:focus, .btn-warning.disabled.focus, .btn-warning[disabled].focus, fieldset[disabled] .btn-warning.focus, .btn-warning.disabled:active, .btn-warning[disabled]:active, fieldset[disabled] .btn-warning:active, .btn-warning.disabled.active, .btn-warning[disabled].active, fieldset[disabled] .btn-warning.active { background-color: #f0ad4e; border-color: transparent; } .btn-warning .badge { color: #f0ad4e; background-color: #ffffff; } .btn-danger { color: #ffffff; background-color: #d9534f; border-color: transparent; } .btn-danger:hover, .btn-danger:focus, .btn-danger.focus, .btn-danger:active, .btn-danger.active, .open > .dropdown-toggle.btn-danger { color: #ffffff; background-color: #c9302c; border-color: rgba(0, 0, 0, 0); } .btn-danger:active, .btn-danger.active, .open > .dropdown-toggle.btn-danger { background-image: none; } .btn-danger.disabled, .btn-danger[disabled], fieldset[disabled] .btn-danger, .btn-danger.disabled:hover, .btn-danger[disabled]:hover, fieldset[disabled] .btn-danger:hover, .btn-danger.disabled:focus, .btn-danger[disabled]:focus, fieldset[disabled] .btn-danger:focus, .btn-danger.disabled.focus, .btn-danger[disabled].focus, fieldset[disabled] .btn-danger.focus, .btn-danger.disabled:active, .btn-danger[disabled]:active, fieldset[disabled] .btn-danger:active, .btn-danger.disabled.active, .btn-danger[disabled].active, fieldset[disabled] .btn-danger.active { background-color: #d9534f; border-color: transparent; } .btn-danger .badge { color: #d9534f; background-color: #ffffff; } .btn-link { color: #df691a; font-weight: normal; border-radius: 0; } .btn-link, .btn-link:active, .btn-link.active, .btn-link[disabled], fieldset[disabled] .btn-link { background-color: transparent; -webkit-box-shadow: none; box-shadow: none; } .btn-link, .btn-link:hover, .btn-link:focus, .btn-link:active { border-color: transparent; } .btn-link:hover, .btn-link:focus { color: #df691a; text-decoration: underline; background-color: transparent; } .btn-link[disabled]:hover, fieldset[disabled] .btn-link:hover, .btn-link[disabled]:focus, fieldset[disabled] .btn-link:focus { color: #4e5d6c; text-decoration: none; } .btn-lg, .btn-group-lg > .btn { padding: 12px 24px; font-size: 19px; line-height: 1.3333333; border-radius: 0; } .btn-sm, .btn-group-sm > .btn { padding: 5px 10px; font-size: 13px; line-height: 1.5; border-radius: 0; } .btn-xs, .btn-group-xs > .btn { padding: 1px 5px; font-size: 13px; line-height: 1.5; border-radius: 0; } .btn-block { display: block; width: 100%; } .btn-block + .btn-block { margin-top: 5px; } input[type="submit"].btn-block, input[type="reset"].btn-block, input[type="button"].btn-block { width: 100%; } .fade { opacity: 0; -webkit-transition: opacity 0.15s linear; -o-transition: opacity 0.15s linear; transition: opacity 0.15s linear; } .fade.in { opacity: 1; } .collapse { display: none; } .collapse.in { display: block; } tr.collapse.in { display: table-row; } tbody.collapse.in { display: table-row-group; } .collapsing { position: relative; height: 0; overflow: hidden; -webkit-transition-property: height, visibility; -o-transition-property: height, visibility; transition-property: height, visibility; -webkit-transition-duration: 0.35s; -o-transition-duration: 0.35s; transition-duration: 0.35s; -webkit-transition-timing-function: ease; -o-transition-timing-function: ease; transition-timing-function: ease; } .caret { display: inline-block; width: 0; height: 0; margin-left: 2px; vertical-align: middle; border-top: 4px dashed; border-right: 4px solid transparent; border-left: 4px solid transparent; } .dropup, .dropdown { position: relative; } .dropdown-toggle:focus { outline: 0; } .dropdown-menu { position: absolute; top: 100%; left: 0; z-index: 1000; display: none; float: left; min-width: 160px; padding: 5px 0; margin: 2px 0 0; list-style: none; font-size: 15px; text-align: left; background-color: #4e5d6c; border: 1px solid transparent; border-radius: 0; -webkit-box-shadow: 0 6px 12px rgba(0, 0, 0, 0.175); box-shadow: 0 6px 12px rgba(0, 0, 0, 0.175); -webkit-background-clip: padding-box; background-clip: padding-box; } .dropdown-menu.pull-right { right: 0; left: auto; } .dropdown-menu .divider { height: 1px; margin: 9.5px 0; overflow: hidden; background-color: #2b3e50; } .dropdown-menu > li > a { display: block; padding: 3px 20px; clear: both; font-weight: normal; line-height: 1.42857143; color: #ebebeb; white-space: nowrap; } .dropdown-menu > li > a:hover, .dropdown-menu > li > a:focus { text-decoration: none; color: #ebebeb; background-color: #485563; } .dropdown-menu > .active > a, .dropdown-menu > .active > a:hover, .dropdown-menu > .active > a:focus { color: #ffffff; text-decoration: none; outline: 0; background-color: #df691a; } .dropdown-menu > .disabled > a, .dropdown-menu > .disabled > a:hover, .dropdown-menu > .disabled > a:focus { color: #2b3e50; } .dropdown-menu > .disabled > a:hover, .dropdown-menu > .disabled > a:focus { text-decoration: none; background-color: transparent; background-image: none; filter: progid:DXImageTransform.Microsoft.gradient(enabled = false); cursor: not-allowed; } .open > .dropdown-menu { display: block; } .open > a { outline: 0; } .dropdown-menu-right { left: auto; right: 0; } .dropdown-menu-left { left: 0; right: auto; } .dropdown-header { display: block; padding: 3px 20px; font-size: 13px; line-height: 1.42857143; color: #2b3e50; white-space: nowrap; } .dropdown-backdrop { position: fixed; left: 0; right: 0; bottom: 0; top: 0; z-index: 990; } .pull-right > .dropdown-menu { right: 0; left: auto; } .dropup .caret, .navbar-fixed-bottom .dropdown .caret { border-top: 0; border-bottom: 4px solid; content: ""; } .dropup .dropdown-menu, .navbar-fixed-bottom .dropdown .dropdown-menu { top: auto; bottom: 100%; margin-bottom: 2px; } @media (min-width: 768px) { .navbar-right .dropdown-menu { left: auto; right: 0; } .navbar-right .dropdown-menu-left { left: 0; right: auto; } } .btn-group, .btn-group-vertical { position: relative; display: inline-block; vertical-align: middle; } .btn-group > .btn, .btn-group-vertical > .btn { position: relative; float: left; } .btn-group > .btn:hover, .btn-group-vertical > .btn:hover, .btn-group > .btn:focus, .btn-group-vertical > .btn:focus, .btn-group > .btn:active, .btn-group-vertical > .btn:active, .btn-group > .btn.active, .btn-group-vertical > .btn.active { z-index: 2; } .btn-group .btn + .btn, .btn-group .btn + .btn-group, .btn-group .btn-group + .btn, .btn-group .btn-group + .btn-group { margin-left: -1px; } .btn-toolbar { margin-left: -5px; } .btn-toolbar .btn-group, .btn-toolbar .input-group { float: left; } .btn-toolbar > .btn, .btn-toolbar > .btn-group, .btn-toolbar > .input-group { margin-left: 5px; } .btn-group > .btn:not(:first-child):not(:last-child):not(.dropdown-toggle) { border-radius: 0; } .btn-group > .btn:first-child { margin-left: 0; } .btn-group > .btn:first-child:not(:last-child):not(.dropdown-toggle) { border-bottom-right-radius: 0; border-top-right-radius: 0; } .btn-group > .btn:last-child:not(:first-child), .btn-group > .dropdown-toggle:not(:first-child) { border-bottom-left-radius: 0; border-top-left-radius: 0; } .btn-group > .btn-group { float: left; } .btn-group > .btn-group:not(:first-child):not(:last-child) > .btn { border-radius: 0; } .btn-group > .btn-group:first-child:not(:last-child) > .btn:last-child, .btn-group > .btn-group:first-child:not(:last-child) > .dropdown-toggle { border-bottom-right-radius: 0; border-top-right-radius: 0; } .btn-group > .btn-group:last-child:not(:first-child) > .btn:first-child { border-bottom-left-radius: 0; border-top-left-radius: 0; } .btn-group .dropdown-toggle:active, .btn-group.open .dropdown-toggle { outline: 0; } .btn-group > .btn + .dropdown-toggle { padding-left: 8px; padding-right: 8px; } .btn-group > .btn-lg + .dropdown-toggle { padding-left: 12px; padding-right: 12px; } .btn-group.open .dropdown-toggle { -webkit-box-shadow: inset 0 3px 5px rgba(0, 0, 0, 0.125); box-shadow: inset 0 3px 5px rgba(0, 0, 0, 0.125); } .btn-group.open .dropdown-toggle.btn-link { -webkit-box-shadow: none; box-shadow: none; } .btn .caret { margin-left: 0; } .btn-lg .caret { border-width: 5px 5px 0; border-bottom-width: 0; } .dropup .btn-lg .caret { border-width: 0 5px 5px; } .btn-group-vertical > .btn, .btn-group-vertical > .btn-group, .btn-group-vertical > .btn-group > .btn { display: block; float: none; width: 100%; max-width: 100%; } .btn-group-vertical > .btn-group > .btn { float: none; } .btn-group-vertical > .btn + .btn, .btn-group-vertical > .btn + .btn-group, .btn-group-vertical > .btn-group + .btn, .btn-group-vertical > .btn-group + .btn-group { margin-top: -1px; margin-left: 0; } .btn-group-vertical > .btn:not(:first-child):not(:last-child) { border-radius: 0; } .btn-group-vertical > .btn:first-child:not(:last-child) { border-top-right-radius: 0; border-bottom-right-radius: 0; border-bottom-left-radius: 0; } .btn-group-vertical > .btn:last-child:not(:first-child) { border-bottom-left-radius: 0; border-top-right-radius: 0; border-top-left-radius: 0; } .btn-group-vertical > .btn-group:not(:first-child):not(:last-child) > .btn { border-radius: 0; } .btn-group-vertical > .btn-group:first-child:not(:last-child) > .btn:last-child, .btn-group-vertical > .btn-group:first-child:not(:last-child) > .dropdown-toggle { border-bottom-right-radius: 0; border-bottom-left-radius: 0; } .btn-group-vertical > .btn-group:last-child:not(:first-child) > .btn:first-child { border-top-right-radius: 0; border-top-left-radius: 0; } .btn-group-justified { display: table; width: 100%; table-layout: fixed; border-collapse: separate; } .btn-group-justified > .btn, .btn-group-justified > .btn-group { float: none; display: table-cell; width: 1%; } .btn-group-justified > .btn-group .btn { width: 100%; } .btn-group-justified > .btn-group .dropdown-menu { left: auto; } [data-toggle="buttons"] > .btn input[type="radio"], [data-toggle="buttons"] > .btn-group > .btn input[type="radio"], [data-toggle="buttons"] > .btn input[type="checkbox"], [data-toggle="buttons"] > .btn-group > .btn input[type="checkbox"] { position: absolute; clip: rect(0, 0, 0, 0); pointer-events: none; } .input-group { position: relative; display: table; border-collapse: separate; } .input-group[class*="col-"] { float: none; padding-left: 0; padding-right: 0; } .input-group .form-control { position: relative; z-index: 2; float: left; width: 100%; margin-bottom: 0; } .input-group-lg > .form-control, .input-group-lg > .input-group-addon, .input-group-lg > .input-group-btn > .btn { height: 52px; padding: 12px 24px; font-size: 19px; line-height: 1.3333333; border-radius: 0; } select.input-group-lg > .form-control, select.input-group-lg > .input-group-addon, select.input-group-lg > .input-group-btn > .btn { height: 52px; line-height: 52px; } textarea.input-group-lg > .form-control, textarea.input-group-lg > .input-group-addon, textarea.input-group-lg > .input-group-btn > .btn, select[multiple].input-group-lg > .form-control, select[multiple].input-group-lg > .input-group-addon, select[multiple].input-group-lg > .input-group-btn > .btn { height: auto; } .input-group-sm > .form-control, .input-group-sm > .input-group-addon, .input-group-sm > .input-group-btn > .btn { height: 31px; padding: 5px 10px; font-size: 13px; line-height: 1.5; border-radius: 0; } select.input-group-sm > .form-control, select.input-group-sm > .input-group-addon, select.input-group-sm > .input-group-btn > .btn { height: 31px; line-height: 31px; } textarea.input-group-sm > .form-control, textarea.input-group-sm > .input-group-addon, textarea.input-group-sm > .input-group-btn > .btn, select[multiple].input-group-sm > .form-control, select[multiple].input-group-sm > .input-group-addon, select[multiple].input-group-sm > .input-group-btn > .btn { height: auto; } .input-group-addon, .input-group-btn, .input-group .form-control { display: table-cell; } .input-group-addon:not(:first-child):not(:last-child), .input-group-btn:not(:first-child):not(:last-child), .input-group .form-control:not(:first-child):not(:last-child) { border-radius: 0; } .input-group-addon, .input-group-btn { width: 1%; white-space: nowrap; vertical-align: middle; } .input-group-addon { padding: 8px 16px; font-size: 15px; font-weight: normal; line-height: 1; color: #2b3e50; text-align: center; background-color: #4e5d6c; border: 1px solid transparent; border-radius: 0; } .input-group-addon.input-sm { padding: 5px 10px; font-size: 13px; border-radius: 0; } .input-group-addon.input-lg { padding: 12px 24px; font-size: 19px; border-radius: 0; } .input-group-addon input[type="radio"], .input-group-addon input[type="checkbox"] { margin-top: 0; } .input-group .form-control:first-child, .input-group-addon:first-child, .input-group-btn:first-child > .btn, .input-group-btn:first-child > .btn-group > .btn, .input-group-btn:first-child > .dropdown-toggle, .input-group-btn:last-child > .btn:not(:last-child):not(.dropdown-toggle), .input-group-btn:last-child > .btn-group:not(:last-child) > .btn { border-bottom-right-radius: 0; border-top-right-radius: 0; } .input-group-addon:first-child { border-right: 0; } .input-group .form-control:last-child, .input-group-addon:last-child, .input-group-btn:last-child > .btn, .input-group-btn:last-child > .btn-group > .btn, .input-group-btn:last-child > .dropdown-toggle, .input-group-btn:first-child > .btn:not(:first-child), .input-group-btn:first-child > .btn-group:not(:first-child) > .btn { border-bottom-left-radius: 0; border-top-left-radius: 0; } .input-group-addon:last-child { border-left: 0; } .input-group-btn { position: relative; font-size: 0; white-space: nowrap; } .input-group-btn > .btn { position: relative; } .input-group-btn > .btn + .btn { margin-left: -1px; } .input-group-btn > .btn:hover, .input-group-btn > .btn:focus, .input-group-btn > .btn:active { z-index: 2; } .input-group-btn:first-child > .btn, .input-group-btn:first-child > .btn-group { margin-right: -1px; } .input-group-btn:last-child > .btn, .input-group-btn:last-child > .btn-group { margin-left: -1px; } .nav { margin-bottom: 0; padding-left: 0; list-style: none; } .nav > li { position: relative; display: block; } .nav > li > a { position: relative; display: block; padding: 10px 15px; } .nav > li > a:hover, .nav > li > a:focus { text-decoration: none; background-color: #4e5d6c; } .nav > li.disabled > a { color: #4e5d6c; } .nav > li.disabled > a:hover, .nav > li.disabled > a:focus { color: #4e5d6c; text-decoration: none; background-color: transparent; cursor: not-allowed; } .nav .open > a, .nav .open > a:hover, .nav .open > a:focus { background-color: #4e5d6c; border-color: #df691a; } .nav .nav-divider { height: 1px; margin: 9.5px 0; overflow: hidden; background-color: #e5e5e5; } .nav > li > a > img { max-width: none; } .nav-tabs { border-bottom: 1px solid transparent; } .nav-tabs > li { float: left; margin-bottom: -1px; } .nav-tabs > li > a { margin-right: 2px; line-height: 1.42857143; border: 1px solid transparent; border-radius: 0 0 0 0; } .nav-tabs > li > a:hover { border-color: #4e5d6c #4e5d6c transparent; } .nav-tabs > li.active > a, .nav-tabs > li.active > a:hover, .nav-tabs > li.active > a:focus { color: #ebebeb; background-color: #2b3e50; border: 1px solid #4e5d6c; border-bottom-color: transparent; cursor: default; } .nav-tabs.nav-justified { width: 100%; border-bottom: 0; } .nav-tabs.nav-justified > li { float: none; } .nav-tabs.nav-justified > li > a { text-align: center; margin-bottom: 5px; } .nav-tabs.nav-justified > .dropdown .dropdown-menu { top: auto; left: auto; } @media (min-width: 768px) { .nav-tabs.nav-justified > li { display: table-cell; width: 1%; } .nav-tabs.nav-justified > li > a { margin-bottom: 0; } } .nav-tabs.nav-justified > li > a { margin-right: 0; border-radius: 0; } .nav-tabs.nav-justified > .active > a, .nav-tabs.nav-justified > .active > a:hover, .nav-tabs.nav-justified > .active > a:focus { border: 1px solid #4e5d6c; } @media (min-width: 768px) { .nav-tabs.nav-justified > li > a { border-bottom: 1px solid #4e5d6c; border-radius: 0 0 0 0; } .nav-tabs.nav-justified > .active > a, .nav-tabs.nav-justified > .active > a:hover, .nav-tabs.nav-justified > .active > a:focus { border-bottom-color: #4e5d6c; } } .nav-pills > li { float: left; } .nav-pills > li > a { border-radius: 0; } .nav-pills > li + li { margin-left: 2px; } .nav-pills > li.active > a, .nav-pills > li.active > a:hover, .nav-pills > li.active > a:focus { color: #ffffff; background-color: #df691a; } .nav-stacked > li { float: none; } .nav-stacked > li + li { margin-top: 2px; margin-left: 0; } .nav-justified { width: 100%; } .nav-justified > li { float: none; } .nav-justified > li > a { text-align: center; margin-bottom: 5px; } .nav-justified > .dropdown .dropdown-menu { top: auto; left: auto; } @media (min-width: 768px) { .nav-justified > li { display: table-cell; width: 1%; } .nav-justified > li > a { margin-bottom: 0; } } .nav-tabs-justified { border-bottom: 0; } .nav-tabs-justified > li > a { margin-right: 0; border-radius: 0; } .nav-tabs-justified > .active > a, .nav-tabs-justified > .active > a:hover, .nav-tabs-justified > .active > a:focus { border: 1px solid #4e5d6c; } @media (min-width: 768px) { .nav-tabs-justified > li > a { border-bottom: 1px solid #4e5d6c; border-radius: 0 0 0 0; } .nav-tabs-justified > .active > a, .nav-tabs-justified > .active > a:hover, .nav-tabs-justified > .active > a:focus { border-bottom-color: #4e5d6c; } } .tab-content > .tab-pane { display: none; } .tab-content > .active { display: block; } .nav-tabs .dropdown-menu { margin-top: -1px; border-top-right-radius: 0; border-top-left-radius: 0; } .navbar { position: relative; min-height: 40px; margin-bottom: 21px; border: 1px solid transparent; } @media (min-width: 768px) { .navbar { border-radius: 0; } } @media (min-width: 768px) { .navbar-header { float: left; } } .navbar-collapse { overflow-x: visible; padding-right: 15px; padding-left: 15px; border-top: 1px solid transparent; -webkit-box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.1); box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.1); -webkit-overflow-scrolling: touch; } .navbar-collapse.in { overflow-y: auto; } @media (min-width: 768px) { .navbar-collapse { width: auto; border-top: 0; -webkit-box-shadow: none; box-shadow: none; } .navbar-collapse.collapse { display: block !important; height: auto !important; padding-bottom: 0; overflow: visible !important; } .navbar-collapse.in { overflow-y: visible; } .navbar-fixed-top .navbar-collapse, .navbar-static-top .navbar-collapse, .navbar-fixed-bottom .navbar-collapse { padding-left: 0; padding-right: 0; } } .navbar-fixed-top .navbar-collapse, .navbar-fixed-bottom .navbar-collapse { max-height: 340px; } @media (max-device-width: 480px) and (orientation: landscape) { .navbar-fixed-top .navbar-collapse, .navbar-fixed-bottom .navbar-collapse { max-height: 200px; } } .container > .navbar-header, .container-fluid > .navbar-header, .container > .navbar-collapse, .container-fluid > .navbar-collapse { margin-right: -15px; margin-left: -15px; } @media (min-width: 768px) { .container > .navbar-header, .container-fluid > .navbar-header, .container > .navbar-collapse, .container-fluid > .navbar-collapse { margin-right: 0; margin-left: 0; } } .navbar-static-top { z-index: 1000; border-width: 0 0 1px; } @media (min-width: 768px) { .navbar-static-top { border-radius: 0; } } .navbar-fixed-top, .navbar-fixed-bottom { position: fixed; right: 0; left: 0; z-index: 1030; } @media (min-width: 768px) { .navbar-fixed-top, .navbar-fixed-bottom { border-radius: 0; } } .navbar-fixed-top { top: 0; border-width: 0 0 1px; } .navbar-fixed-bottom { bottom: 0; margin-bottom: 0; border-width: 1px 0 0; } .navbar-brand { float: left; padding: 9.5px 15px; font-size: 19px; line-height: 21px; height: 40px; } .navbar-brand:hover, .navbar-brand:focus { text-decoration: none; } .navbar-brand > img { display: block; } @media (min-width: 768px) { .navbar > .container .navbar-brand, .navbar > .container-fluid .navbar-brand { margin-left: -15px; } } .navbar-toggle { position: relative; float: right; margin-right: 15px; padding: 9px 10px; margin-top: 3px; margin-bottom: 3px; background-color: transparent; background-image: none; border: 1px solid transparent; border-radius: 0; } .navbar-toggle:focus { outline: 0; } .navbar-toggle .icon-bar { display: block; width: 22px; height: 2px; border-radius: 1px; } .navbar-toggle .icon-bar + .icon-bar { margin-top: 4px; } @media (min-width: 768px) { .navbar-toggle { display: none; } } .navbar-nav { margin: 4.75px -15px; } .navbar-nav > li > a { padding-top: 10px; padding-bottom: 10px; line-height: 21px; } @media (max-width: 767px) { .navbar-nav .open .dropdown-menu { position: static; float: none; width: auto; margin-top: 0; background-color: transparent; border: 0; -webkit-box-shadow: none; box-shadow: none; } .navbar-nav .open .dropdown-menu > li > a, .navbar-nav .open .dropdown-menu .dropdown-header { padding: 5px 15px 5px 25px; } .navbar-nav .open .dropdown-menu > li > a { line-height: 21px; } .navbar-nav .open .dropdown-menu > li > a:hover, .navbar-nav .open .dropdown-menu > li > a:focus { background-image: none; } } @media (min-width: 768px) { .navbar-nav { float: left; margin: 0; } .navbar-nav > li { float: left; } .navbar-nav > li > a { padding-top: 9.5px; padding-bottom: 9.5px; } } .navbar-form { margin-left: -15px; margin-right: -15px; padding: 10px 15px; border-top: 1px solid transparent; border-bottom: 1px solid transparent; -webkit-box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.1), 0 1px 0 rgba(255, 255, 255, 0.1); box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.1), 0 1px 0 rgba(255, 255, 255, 0.1); margin-top: 0.5px; margin-bottom: 0.5px; } @media (min-width: 768px) { .navbar-form .form-group { display: inline-block; margin-bottom: 0; vertical-align: middle; } .navbar-form .form-control { display: inline-block; width: auto; vertical-align: middle; } .navbar-form .form-control-static { display: inline-block; } .navbar-form .input-group { display: inline-table; vertical-align: middle; } .navbar-form .input-group .input-group-addon, .navbar-form .input-group .input-group-btn, .navbar-form .input-group .form-control { width: auto; } .navbar-form .input-group > .form-control { width: 100%; } .navbar-form .control-label { margin-bottom: 0; vertical-align: middle; } .navbar-form .radio, .navbar-form .checkbox { display: inline-block; margin-top: 0; margin-bottom: 0; vertical-align: middle; } .navbar-form .radio label, .navbar-form .checkbox label { padding-left: 0; } .navbar-form .radio input[type="radio"], .navbar-form .checkbox input[type="checkbox"] { position: relative; margin-left: 0; } .navbar-form .has-feedback .form-control-feedback { top: 0; } } @media (max-width: 767px) { .navbar-form .form-group { margin-bottom: 5px; } .navbar-form .form-group:last-child { margin-bottom: 0; } } @media (min-width: 768px) { .navbar-form { width: auto; border: 0; margin-left: 0; margin-right: 0; padding-top: 0; padding-bottom: 0; -webkit-box-shadow: none; box-shadow: none; } } .navbar-nav > li > .dropdown-menu { margin-top: 0; border-top-right-radius: 0; border-top-left-radius: 0; } .navbar-fixed-bottom .navbar-nav > li > .dropdown-menu { margin-bottom: 0; border-top-right-radius: 0; border-top-left-radius: 0; border-bottom-right-radius: 0; border-bottom-left-radius: 0; } .navbar-btn { margin-top: 0.5px; margin-bottom: 0.5px; } .navbar-btn.btn-sm { margin-top: 4.5px; margin-bottom: 4.5px; } .navbar-btn.btn-xs { margin-top: 9px; margin-bottom: 9px; } .navbar-text { margin-top: 9.5px; margin-bottom: 9.5px; } @media (min-width: 768px) { .navbar-text { float: left; margin-left: 15px; margin-right: 15px; } } @media (min-width: 768px) { .navbar-left { float: left !important; } .navbar-right { float: right !important; margin-right: -15px; } .navbar-right ~ .navbar-right { margin-right: 0; } } .navbar-default { background-color: #4e5d6c; border-color: transparent; } .navbar-default .navbar-brand { color: #ebebeb; } .navbar-default .navbar-brand:hover, .navbar-default .navbar-brand:focus { color: #ebebeb; background-color: transparent; } .navbar-default .navbar-text { color: #ebebeb; } .navbar-default .navbar-nav > li > a { color: #ebebeb; } .navbar-default .navbar-nav > li > a:hover, .navbar-default .navbar-nav > li > a:focus { color: #ebebeb; background-color: #485563; } .navbar-default .navbar-nav > .active > a, .navbar-default .navbar-nav > .active > a:hover, .navbar-default .navbar-nav > .active > a:focus { color: #ebebeb; background-color: #485563; } .navbar-default .navbar-nav > .disabled > a, .navbar-default .navbar-nav > .disabled > a:hover, .navbar-default .navbar-nav > .disabled > a:focus { color: #cccccc; background-color: transparent; } .navbar-default .navbar-toggle { border-color: transparent; } .navbar-default .navbar-toggle:hover, .navbar-default .navbar-toggle:focus { background-color: #485563; } .navbar-default .navbar-toggle .icon-bar { background-color: #ebebeb; } .navbar-default .navbar-collapse, .navbar-default .navbar-form { border-color: transparent; } .navbar-default .navbar-nav > .open > a, .navbar-default .navbar-nav > .open > a:hover, .navbar-default .navbar-nav > .open > a:focus { background-color: #485563; color: #ebebeb; } @media (max-width: 767px) { .navbar-default .navbar-nav .open .dropdown-menu > li > a { color: #ebebeb; } .navbar-default .navbar-nav .open .dropdown-menu > li > a:hover, .navbar-default .navbar-nav .open .dropdown-menu > li > a:focus { color: #ebebeb; background-color: #485563; } .navbar-default .navbar-nav .open .dropdown-menu > .active > a, .navbar-default .navbar-nav .open .dropdown-menu > .active > a:hover, .navbar-default .navbar-nav .open .dropdown-menu > .active > a:focus { color: #ebebeb; background-color: #485563; } .navbar-default .navbar-nav .open .dropdown-menu > .disabled > a, .navbar-default .navbar-nav .open .dropdown-menu > .disabled > a:hover, .navbar-default .navbar-nav .open .dropdown-menu > .disabled > a:focus { color: #cccccc; background-color: transparent; } } .navbar-default .navbar-link { color: #ebebeb; } .navbar-default .navbar-link:hover { color: #ebebeb; } .navbar-default .btn-link { color: #ebebeb; } .navbar-default .btn-link:hover, .navbar-default .btn-link:focus { color: #ebebeb; } .navbar-default .btn-link[disabled]:hover, fieldset[disabled] .navbar-default .btn-link:hover, .navbar-default .btn-link[disabled]:focus, fieldset[disabled] .navbar-default .btn-link:focus { color: #cccccc; } .navbar-inverse { background-color: #df691a; border-color: transparent; } .navbar-inverse .navbar-brand { color: #ebebeb; } .navbar-inverse .navbar-brand:hover, .navbar-inverse .navbar-brand:focus { color: #ebebeb; background-color: transparent; } .navbar-inverse .navbar-text { color: #ebebeb; } .navbar-inverse .navbar-nav > li > a { color: #ebebeb; } .navbar-inverse .navbar-nav > li > a:hover, .navbar-inverse .navbar-nav > li > a:focus { color: #ebebeb; background-color: #c85e17; } .navbar-inverse .navbar-nav > .active > a, .navbar-inverse .navbar-nav > .active > a:hover, .navbar-inverse .navbar-nav > .active > a:focus { color: #ebebeb; background-color: #c85e17; } .navbar-inverse .navbar-nav > .disabled > a, .navbar-inverse .navbar-nav > .disabled > a:hover, .navbar-inverse .navbar-nav > .disabled > a:focus { color: #444444; background-color: transparent; } .navbar-inverse .navbar-toggle { border-color: transparent; } .navbar-inverse .navbar-toggle:hover, .navbar-inverse .navbar-toggle:focus { background-color: #c85e17; } .navbar-inverse .navbar-toggle .icon-bar { background-color: #ebebeb; } .navbar-inverse .navbar-collapse, .navbar-inverse .navbar-form { border-color: #bf5a16; } .navbar-inverse .navbar-nav > .open > a, .navbar-inverse .navbar-nav > .open > a:hover, .navbar-inverse .navbar-nav > .open > a:focus { background-color: #c85e17; color: #ebebeb; } @media (max-width: 767px) { .navbar-inverse .navbar-nav .open .dropdown-menu > .dropdown-header { border-color: transparent; } .navbar-inverse .navbar-nav .open .dropdown-menu .divider { background-color: transparent; } .navbar-inverse .navbar-nav .open .dropdown-menu > li > a { color: #ebebeb; } .navbar-inverse .navbar-nav .open .dropdown-menu > li > a:hover, .navbar-inverse .navbar-nav .open .dropdown-menu > li > a:focus { color: #ebebeb; background-color: #c85e17; } .navbar-inverse .navbar-nav .open .dropdown-menu > .active > a, .navbar-inverse .navbar-nav .open .dropdown-menu > .active > a:hover, .navbar-inverse .navbar-nav .open .dropdown-menu > .active > a:focus { color: #ebebeb; background-color: #c85e17; } .navbar-inverse .navbar-nav .open .dropdown-menu > .disabled > a, .navbar-inverse .navbar-nav .open .dropdown-menu > .disabled > a:hover, .navbar-inverse .navbar-nav .open .dropdown-menu > .disabled > a:focus { color: #444444; background-color: transparent; } } .navbar-inverse .navbar-link { color: #ebebeb; } .navbar-inverse .navbar-link:hover { color: #ebebeb; } .navbar-inverse .btn-link { color: #ebebeb; } .navbar-inverse .btn-link:hover, .navbar-inverse .btn-link:focus { color: #ebebeb; } .navbar-inverse .btn-link[disabled]:hover, fieldset[disabled] .navbar-inverse .btn-link:hover, .navbar-inverse .btn-link[disabled]:focus, fieldset[disabled] .navbar-inverse .btn-link:focus { color: #444444; } .breadcrumb { padding: 8px 15px; margin-bottom: 21px; list-style: none; background-color: #4e5d6c; border-radius: 0; } .breadcrumb > li { display: inline-block; } .breadcrumb > li + li:before { content: "/\00a0"; padding: 0 5px; color: #ebebeb; } .breadcrumb > .active { color: #ebebeb; } .pagination { display: inline-block; padding-left: 0; margin: 21px 0; border-radius: 0; } .pagination > li { display: inline; } .pagination > li > a, .pagination > li > span { position: relative; float: left; padding: 8px 16px; line-height: 1.42857143; text-decoration: none; color: #ebebeb; background-color: #4e5d6c; border: 1px solid transparent; margin-left: -1px; } .pagination > li:first-child > a, .pagination > li:first-child > span { margin-left: 0; border-bottom-left-radius: 0; border-top-left-radius: 0; } .pagination > li:last-child > a, .pagination > li:last-child > span { border-bottom-right-radius: 0; border-top-right-radius: 0; } .pagination > li > a:hover, .pagination > li > span:hover, .pagination > li > a:focus, .pagination > li > span:focus { color: #ebebeb; background-color: #485563; border-color: transparent; } .pagination > .active > a, .pagination > .active > span, .pagination > .active > a:hover, .pagination > .active > span:hover, .pagination > .active > a:focus, .pagination > .active > span:focus { z-index: 2; color: #ebebeb; background-color: #df691a; border-color: transparent; cursor: default; } .pagination > .disabled > span, .pagination > .disabled > span:hover, .pagination > .disabled > span:focus, .pagination > .disabled > a, .pagination > .disabled > a:hover, .pagination > .disabled > a:focus { color: #323c46; background-color: #4e5d6c; border-color: transparent; cursor: not-allowed; } .pagination-lg > li > a, .pagination-lg > li > span { padding: 12px 24px; font-size: 19px; } .pagination-lg > li:first-child > a, .pagination-lg > li:first-child > span { border-bottom-left-radius: 0; border-top-left-radius: 0; } .pagination-lg > li:last-child > a, .pagination-lg > li:last-child > span { border-bottom-right-radius: 0; border-top-right-radius: 0; } .pagination-sm > li > a, .pagination-sm > li > span { padding: 5px 10px; font-size: 13px; } .pagination-sm > li:first-child > a, .pagination-sm > li:first-child > span { border-bottom-left-radius: 0; border-top-left-radius: 0; } .pagination-sm > li:last-child > a, .pagination-sm > li:last-child > span { border-bottom-right-radius: 0; border-top-right-radius: 0; } .pager { padding-left: 0; margin: 21px 0; list-style: none; text-align: center; } .pager li { display: inline; } .pager li > a, .pager li > span { display: inline-block; padding: 5px 14px; background-color: #4e5d6c; border: 1px solid transparent; border-radius: 15px; } .pager li > a:hover, .pager li > a:focus { text-decoration: none; background-color: #485563; } .pager .next > a, .pager .next > span { float: right; } .pager .previous > a, .pager .previous > span { float: left; } .pager .disabled > a, .pager .disabled > a:hover, .pager .disabled > a:focus, .pager .disabled > span { color: #323c46; background-color: #4e5d6c; cursor: not-allowed; } .label { display: inline; padding: .2em .6em .3em; font-size: 75%; font-weight: bold; line-height: 1; color: #ffffff; text-align: center; white-space: nowrap; vertical-align: baseline; border-radius: .25em; } a.label:hover, a.label:focus { color: #ffffff; text-decoration: none; cursor: pointer; } .label:empty { display: none; } .btn .label { position: relative; top: -1px; } .label-default { background-color: #4e5d6c; } .label-default[href]:hover, .label-default[href]:focus { background-color: #39444e; } .label-primary { background-color: #df691a; } .label-primary[href]:hover, .label-primary[href]:focus { background-color: #b15315; } .label-success { background-color: #5cb85c; } .label-success[href]:hover, .label-success[href]:focus { background-color: #449d44; } .label-info { background-color: #5bc0de; } .label-info[href]:hover, .label-info[href]:focus { background-color: #31b0d5; } .label-warning { background-color: #f0ad4e; } .label-warning[href]:hover, .label-warning[href]:focus { background-color: #ec971f; } .label-danger { background-color: #d9534f; } .label-danger[href]:hover, .label-danger[href]:focus { background-color: #c9302c; } .badge { display: inline-block; min-width: 10px; padding: 3px 7px; font-size: 13px; font-weight: 300; color: #ebebeb; line-height: 1; vertical-align: baseline; white-space: nowrap; text-align: center; background-color: #4e5d6c; border-radius: 10px; } .badge:empty { display: none; } .btn .badge { position: relative; top: -1px; } .btn-xs .badge, .btn-group-xs > .btn .badge { top: 0; padding: 1px 5px; } a.badge:hover, a.badge:focus { color: #ffffff; text-decoration: none; cursor: pointer; } .list-group-item.active > .badge, .nav-pills > .active > a > .badge { color: #df691a; background-color: #ffffff; } .list-group-item > .badge { float: right; } .list-group-item > .badge + .badge { margin-right: 5px; } .nav-pills > li > a > .badge { margin-left: 3px; } .jumbotron { padding: 30px 15px; margin-bottom: 30px; color: inherit; background-color: #4e5d6c; } .jumbotron h1, .jumbotron .h1 { color: inherit; } .jumbotron p { margin-bottom: 15px; font-size: 23px; font-weight: 200; } .jumbotron > hr { border-top-color: #39444e; } .container .jumbotron, .container-fluid .jumbotron { border-radius: 0; } .jumbotron .container { max-width: 100%; } @media screen and (min-width: 768px) { .jumbotron { padding: 48px 0; } .container .jumbotron, .container-fluid .jumbotron { padding-left: 60px; padding-right: 60px; } .jumbotron h1, .jumbotron .h1 { font-size: 67.5px; } } .thumbnail { display: block; padding: 4px; margin-bottom: 21px; line-height: 1.42857143; background-color: #2b3e50; border: 1px solid #dddddd; border-radius: 0; -webkit-transition: border 0.2s ease-in-out; -o-transition: border 0.2s ease-in-out; transition: border 0.2s ease-in-out; } .thumbnail > img, .thumbnail a > img { margin-left: auto; margin-right: auto; } a.thumbnail:hover, a.thumbnail:focus, a.thumbnail.active { border-color: #df691a; } .thumbnail .caption { padding: 9px; color: #ebebeb; } .alert { padding: 15px; margin-bottom: 21px; border: 1px solid transparent; border-radius: 0; } .alert h4 { margin-top: 0; color: inherit; } .alert .alert-link { font-weight: bold; } .alert > p, .alert > ul { margin-bottom: 0; } .alert > p + p { margin-top: 5px; } .alert-dismissable, .alert-dismissible { padding-right: 35px; } .alert-dismissable .close, .alert-dismissible .close { position: relative; top: -2px; right: -21px; color: inherit; } .alert-success { background-color: #5cb85c; border-color: transparent; color: #ebebeb; } .alert-success hr { border-top-color: rgba(0, 0, 0, 0); } .alert-success .alert-link { color: #d2d2d2; } .alert-info { background-color: #5bc0de; border-color: transparent; color: #ebebeb; } .alert-info hr { border-top-color: rgba(0, 0, 0, 0); } .alert-info .alert-link { color: #d2d2d2; } .alert-warning { background-color: #f0ad4e; border-color: transparent; color: #ebebeb; } .alert-warning hr { border-top-color: rgba(0, 0, 0, 0); } .alert-warning .alert-link { color: #d2d2d2; } .alert-danger { background-color: #d9534f; border-color: transparent; color: #ebebeb; } .alert-danger hr { border-top-color: rgba(0, 0, 0, 0); } .alert-danger .alert-link { color: #d2d2d2; } @-webkit-keyframes progress-bar-stripes { from { background-position: 40px 0; } to { background-position: 0 0; } } @-o-keyframes progress-bar-stripes { from { background-position: 40px 0; } to { background-position: 0 0; } } @keyframes progress-bar-stripes { from { background-position: 40px 0; } to { background-position: 0 0; } } .progress { overflow: hidden; height: 21px; margin-bottom: 21px; background-color: #4e5d6c; border-radius: 0; -webkit-box-shadow: inset 0 1px 2px rgba(0, 0, 0, 0.1); box-shadow: inset 0 1px 2px rgba(0, 0, 0, 0.1); } .progress-bar { float: left; width: 0%; height: 100%; font-size: 13px; line-height: 21px; color: #ffffff; text-align: center; background-color: #df691a; -webkit-box-shadow: inset 0 -1px 0 rgba(0, 0, 0, 0.15); box-shadow: inset 0 -1px 0 rgba(0, 0, 0, 0.15); -webkit-transition: width 0.6s ease; -o-transition: width 0.6s ease; transition: width 0.6s ease; } .progress-striped .progress-bar, .progress-bar-striped { background-image: -webkit-linear-gradient(45deg, rgba(255, 255, 255, 0.15) 25%, transparent 25%, transparent 50%, rgba(255, 255, 255, 0.15) 50%, rgba(255, 255, 255, 0.15) 75%, transparent 75%, transparent); background-image: -o-linear-gradient(45deg, rgba(255, 255, 255, 0.15) 25%, transparent 25%, transparent 50%, rgba(255, 255, 255, 0.15) 50%, rgba(255, 255, 255, 0.15) 75%, transparent 75%, transparent); background-image: linear-gradient(45deg, rgba(255, 255, 255, 0.15) 25%, transparent 25%, transparent 50%, rgba(255, 255, 255, 0.15) 50%, rgba(255, 255, 255, 0.15) 75%, transparent 75%, transparent); -webkit-background-size: 40px 40px; background-size: 40px 40px; } .progress.active .progress-bar, .progress-bar.active { -webkit-animation: progress-bar-stripes 2s linear infinite; -o-animation: progress-bar-stripes 2s linear infinite; animation: progress-bar-stripes 2s linear infinite; } .progress-bar-success { background-color: #5cb85c; } .progress-striped .progress-bar-success { background-image: -webkit-linear-gradient(45deg, rgba(255, 255, 255, 0.15) 25%, transparent 25%, transparent 50%, rgba(255, 255, 255, 0.15) 50%, rgba(255, 255, 255, 0.15) 75%, transparent 75%, transparent); background-image: -o-linear-gradient(45deg, rgba(255, 255, 255, 0.15) 25%, transparent 25%, transparent 50%, rgba(255, 255, 255, 0.15) 50%, rgba(255, 255, 255, 0.15) 75%, transparent 75%, transparent); background-image: linear-gradient(45deg, rgba(255, 255, 255, 0.15) 25%, transparent 25%, transparent 50%, rgba(255, 255, 255, 0.15) 50%, rgba(255, 255, 255, 0.15) 75%, transparent 75%, transparent); } .progress-bar-info { background-color: #5bc0de; } .progress-striped .progress-bar-info { background-image: -webkit-linear-gradient(45deg, rgba(255, 255, 255, 0.15) 25%, transparent 25%, transparent 50%, rgba(255, 255, 255, 0.15) 50%, rgba(255, 255, 255, 0.15) 75%, transparent 75%, transparent); background-image: -o-linear-gradient(45deg, rgba(255, 255, 255, 0.15) 25%, transparent 25%, transparent 50%, rgba(255, 255, 255, 0.15) 50%, rgba(255, 255, 255, 0.15) 75%, transparent 75%, transparent); background-image: linear-gradient(45deg, rgba(255, 255, 255, 0.15) 25%, transparent 25%, transparent 50%, rgba(255, 255, 255, 0.15) 50%, rgba(255, 255, 255, 0.15) 75%, transparent 75%, transparent); } .progress-bar-warning { background-color: #f0ad4e; } .progress-striped .progress-bar-warning { background-image: -webkit-linear-gradient(45deg, rgba(255, 255, 255, 0.15) 25%, transparent 25%, transparent 50%, rgba(255, 255, 255, 0.15) 50%, rgba(255, 255, 255, 0.15) 75%, transparent 75%, transparent); background-image: -o-linear-gradient(45deg, rgba(255, 255, 255, 0.15) 25%, transparent 25%, transparent 50%, rgba(255, 255, 255, 0.15) 50%, rgba(255, 255, 255, 0.15) 75%, transparent 75%, transparent); background-image: linear-gradient(45deg, rgba(255, 255, 255, 0.15) 25%, transparent 25%, transparent 50%, rgba(255, 255, 255, 0.15) 50%, rgba(255, 255, 255, 0.15) 75%, transparent 75%, transparent); } .progress-bar-danger { background-color: #d9534f; } .progress-striped .progress-bar-danger { background-image: -webkit-linear-gradient(45deg, rgba(255, 255, 255, 0.15) 25%, transparent 25%, transparent 50%, rgba(255, 255, 255, 0.15) 50%, rgba(255, 255, 255, 0.15) 75%, transparent 75%, transparent); background-image: -o-linear-gradient(45deg, rgba(255, 255, 255, 0.15) 25%, transparent 25%, transparent 50%, rgba(255, 255, 255, 0.15) 50%, rgba(255, 255, 255, 0.15) 75%, transparent 75%, transparent); background-image: linear-gradient(45deg, rgba(255, 255, 255, 0.15) 25%, transparent 25%, transparent 50%, rgba(255, 255, 255, 0.15) 50%, rgba(255, 255, 255, 0.15) 75%, transparent 75%, transparent); } .media { margin-top: 15px; } .media:first-child { margin-top: 0; } .media, .media-body { zoom: 1; overflow: hidden; } .media-body { width: 10000px; } .media-object { display: block; } .media-right, .media > .pull-right { padding-left: 10px; } .media-left, .media > .pull-left { padding-right: 10px; } .media-left, .media-right, .media-body { display: table-cell; vertical-align: top; } .media-middle { vertical-align: middle; } .media-bottom { vertical-align: bottom; } .media-heading { margin-top: 0; margin-bottom: 5px; } .media-list { padding-left: 0; list-style: none; } .list-group { margin-bottom: 20px; padding-left: 0; } .list-group-item { position: relative; display: block; padding: 10px 15px; margin-bottom: -1px; background-color: #4e5d6c; border: 1px solid transparent; } .list-group-item:first-child { border-top-right-radius: 0; border-top-left-radius: 0; } .list-group-item:last-child { margin-bottom: 0; border-bottom-right-radius: 0; border-bottom-left-radius: 0; } a.list-group-item { color: #ebebeb; } a.list-group-item .list-group-item-heading { color: #ebebeb; } a.list-group-item:hover, a.list-group-item:focus { text-decoration: none; color: #ebebeb; background-color: #485563; } .list-group-item.disabled, .list-group-item.disabled:hover, .list-group-item.disabled:focus { background-color: #ebebeb; color: #4e5d6c; cursor: not-allowed; } .list-group-item.disabled .list-group-item-heading, .list-group-item.disabled:hover .list-group-item-heading, .list-group-item.disabled:focus .list-group-item-heading { color: inherit; } .list-group-item.disabled .list-group-item-text, .list-group-item.disabled:hover .list-group-item-text, .list-group-item.disabled:focus .list-group-item-text { color: #4e5d6c; } .list-group-item.active, .list-group-item.active:hover, .list-group-item.active:focus { z-index: 2; color: #ffffff; background-color: #df691a; border-color: #df691a; } .list-group-item.active .list-group-item-heading, .list-group-item.active:hover .list-group-item-heading, .list-group-item.active:focus .list-group-item-heading, .list-group-item.active .list-group-item-heading > small, .list-group-item.active:hover .list-group-item-heading > small, .list-group-item.active:focus .list-group-item-heading > small, .list-group-item.active .list-group-item-heading > .small, .list-group-item.active:hover .list-group-item-heading > .small, .list-group-item.active:focus .list-group-item-heading > .small { color: inherit; } .list-group-item.active .list-group-item-text, .list-group-item.active:hover .list-group-item-text, .list-group-item.active:focus .list-group-item-text { color: #f9decc; } .list-group-item-success { color: #ebebeb; background-color: #5cb85c; } a.list-group-item-success { color: #ebebeb; } a.list-group-item-success .list-group-item-heading { color: inherit; } a.list-group-item-success:hover, a.list-group-item-success:focus { color: #ebebeb; background-color: #4cae4c; } a.list-group-item-success.active, a.list-group-item-success.active:hover, a.list-group-item-success.active:focus { color: #fff; background-color: #ebebeb; border-color: #ebebeb; } .list-group-item-info { color: #ebebeb; background-color: #5bc0de; } a.list-group-item-info { color: #ebebeb; } a.list-group-item-info .list-group-item-heading { color: inherit; } a.list-group-item-info:hover, a.list-group-item-info:focus { color: #ebebeb; background-color: #46b8da; } a.list-group-item-info.active, a.list-group-item-info.active:hover, a.list-group-item-info.active:focus { color: #fff; background-color: #ebebeb; border-color: #ebebeb; } .list-group-item-warning { color: #ebebeb; background-color: #f0ad4e; } a.list-group-item-warning { color: #ebebeb; } a.list-group-item-warning .list-group-item-heading { color: inherit; } a.list-group-item-warning:hover, a.list-group-item-warning:focus { color: #ebebeb; background-color: #eea236; } a.list-group-item-warning.active, a.list-group-item-warning.active:hover, a.list-group-item-warning.active:focus { color: #fff; background-color: #ebebeb; border-color: #ebebeb; } .list-group-item-danger { color: #ebebeb; background-color: #d9534f; } a.list-group-item-danger { color: #ebebeb; } a.list-group-item-danger .list-group-item-heading { color: inherit; } a.list-group-item-danger:hover, a.list-group-item-danger:focus { color: #ebebeb; background-color: #d43f3a; } a.list-group-item-danger.active, a.list-group-item-danger.active:hover, a.list-group-item-danger.active:focus { color: #fff; background-color: #ebebeb; border-color: #ebebeb; } .list-group-item-heading { margin-top: 0; margin-bottom: 5px; } .list-group-item-text { margin-bottom: 0; line-height: 1.3; } .panel { margin-bottom: 21px; background-color: #4e5d6c; border: 1px solid transparent; border-radius: 0; -webkit-box-shadow: 0 1px 1px rgba(0, 0, 0, 0.05); box-shadow: 0 1px 1px rgba(0, 0, 0, 0.05); } .panel-body { padding: 15px; } .panel-heading { padding: 10px 15px; border-bottom: 1px solid transparent; border-top-right-radius: -1; border-top-left-radius: -1; } .panel-heading > .dropdown .dropdown-toggle { color: inherit; } .panel-title { margin-top: 0; margin-bottom: 0; font-size: 17px; color: inherit; } .panel-title > a, .panel-title > small, .panel-title > .small, .panel-title > small > a, .panel-title > .small > a { color: inherit; } .panel-footer { padding: 10px 15px; background-color: #485563; border-top: 1px solid transparent; border-bottom-right-radius: -1; border-bottom-left-radius: -1; } .panel > .list-group, .panel > .panel-collapse > .list-group { margin-bottom: 0; } .panel > .list-group .list-group-item, .panel > .panel-collapse > .list-group .list-group-item { border-width: 1px 0; border-radius: 0; } .panel > .list-group:first-child .list-group-item:first-child, .panel > .panel-collapse > .list-group:first-child .list-group-item:first-child { border-top: 0; border-top-right-radius: -1; border-top-left-radius: -1; } .panel > .list-group:last-child .list-group-item:last-child, .panel > .panel-collapse > .list-group:last-child .list-group-item:last-child { border-bottom: 0; border-bottom-right-radius: -1; border-bottom-left-radius: -1; } .panel-heading + .list-group .list-group-item:first-child { border-top-width: 0; } .list-group + .panel-footer { border-top-width: 0; } .panel > .table, .panel > .table-responsive > .table, .panel > .panel-collapse > .table { margin-bottom: 0; } .panel > .table caption, .panel > .table-responsive > .table caption, .panel > .panel-collapse > .table caption { padding-left: 15px; padding-right: 15px; } .panel > .table:first-child, .panel > .table-responsive:first-child > .table:first-child { border-top-right-radius: -1; border-top-left-radius: -1; } .panel > .table:first-child > thead:first-child > tr:first-child, .panel > .table-responsive:first-child > .table:first-child > thead:first-child > tr:first-child, .panel > .table:first-child > tbody:first-child > tr:first-child, .panel > .table-responsive:first-child > .table:first-child > tbody:first-child > tr:first-child { border-top-left-radius: -1; border-top-right-radius: -1; } .panel > .table:first-child > thead:first-child > tr:first-child td:first-child, .panel > .table-responsive:first-child > .table:first-child > thead:first-child > tr:first-child td:first-child, .panel > .table:first-child > tbody:first-child > tr:first-child td:first-child, .panel > .table-responsive:first-child > .table:first-child > tbody:first-child > tr:first-child td:first-child, .panel > .table:first-child > thead:first-child > tr:first-child th:first-child, .panel > .table-responsive:first-child > .table:first-child > thead:first-child > tr:first-child th:first-child, .panel > .table:first-child > tbody:first-child > tr:first-child th:first-child, .panel > .table-responsive:first-child > .table:first-child > tbody:first-child > tr:first-child th:first-child { border-top-left-radius: -1; } .panel > .table:first-child > thead:first-child > tr:first-child td:last-child, .panel > .table-responsive:first-child > .table:first-child > thead:first-child > tr:first-child td:last-child, .panel > .table:first-child > tbody:first-child > tr:first-child td:last-child, .panel > .table-responsive:first-child > .table:first-child > tbody:first-child > tr:first-child td:last-child, .panel > .table:first-child > thead:first-child > tr:first-child th:last-child, .panel > .table-responsive:first-child > .table:first-child > thead:first-child > tr:first-child th:last-child, .panel > .table:first-child > tbody:first-child > tr:first-child th:last-child, .panel > .table-responsive:first-child > .table:first-child > tbody:first-child > tr:first-child th:last-child { border-top-right-radius: -1; } .panel > .table:last-child, .panel > .table-responsive:last-child > .table:last-child { border-bottom-right-radius: -1; border-bottom-left-radius: -1; } .panel > .table:last-child > tbody:last-child > tr:last-child, .panel > .table-responsive:last-child > .table:last-child > tbody:last-child > tr:last-child, .panel > .table:last-child > tfoot:last-child > tr:last-child, .panel > .table-responsive:last-child > .table:last-child > tfoot:last-child > tr:last-child { border-bottom-left-radius: -1; border-bottom-right-radius: -1; } .panel > .table:last-child > tbody:last-child > tr:last-child td:first-child, .panel > .table-responsive:last-child > .table:last-child > tbody:last-child > tr:last-child td:first-child, .panel > .table:last-child > tfoot:last-child > tr:last-child td:first-child, .panel > .table-responsive:last-child > .table:last-child > tfoot:last-child > tr:last-child td:first-child, .panel > .table:last-child > tbody:last-child > tr:last-child th:first-child, .panel > .table-responsive:last-child > .table:last-child > tbody:last-child > tr:last-child th:first-child, .panel > .table:last-child > tfoot:last-child > tr:last-child th:first-child, .panel > .table-responsive:last-child > .table:last-child > tfoot:last-child > tr:last-child th:first-child { border-bottom-left-radius: -1; } .panel > .table:last-child > tbody:last-child > tr:last-child td:last-child, .panel > .table-responsive:last-child > .table:last-child > tbody:last-child > tr:last-child td:last-child, .panel > .table:last-child > tfoot:last-child > tr:last-child td:last-child, .panel > .table-responsive:last-child > .table:last-child > tfoot:last-child > tr:last-child td:last-child, .panel > .table:last-child > tbody:last-child > tr:last-child th:last-child, .panel > .table-responsive:last-child > .table:last-child > tbody:last-child > tr:last-child th:last-child, .panel > .table:last-child > tfoot:last-child > tr:last-child th:last-child, .panel > .table-responsive:last-child > .table:last-child > tfoot:last-child > tr:last-child th:last-child { border-bottom-right-radius: -1; } .panel > .panel-body + .table, .panel > .panel-body + .table-responsive, .panel > .table + .panel-body, .panel > .table-responsive + .panel-body { border-top: 1px solid #4e5d6c; } .panel > .table > tbody:first-child > tr:first-child th, .panel > .table > tbody:first-child > tr:first-child td { border-top: 0; } .panel > .table-bordered, .panel > .table-responsive > .table-bordered { border: 0; } .panel > .table-bordered > thead > tr > th:first-child, .panel > .table-responsive > .table-bordered > thead > tr > th:first-child, .panel > .table-bordered > tbody > tr > th:first-child, .panel > .table-responsive > .table-bordered > tbody > tr > th:first-child, .panel > .table-bordered > tfoot > tr > th:first-child, .panel > .table-responsive > .table-bordered > tfoot > tr > th:first-child, .panel > .table-bordered > thead > tr > td:first-child, .panel > .table-responsive > .table-bordered > thead > tr > td:first-child, .panel > .table-bordered > tbody > tr > td:first-child, .panel > .table-responsive > .table-bordered > tbody > tr > td:first-child, .panel > .table-bordered > tfoot > tr > td:first-child, .panel > .table-responsive > .table-bordered > tfoot > tr > td:first-child { border-left: 0; } .panel > .table-bordered > thead > tr > th:last-child, .panel > .table-responsive > .table-bordered > thead > tr > th:last-child, .panel > .table-bordered > tbody > tr > th:last-child, .panel > .table-responsive > .table-bordered > tbody > tr > th:last-child, .panel > .table-bordered > tfoot > tr > th:last-child, .panel > .table-responsive > .table-bordered > tfoot > tr > th:last-child, .panel > .table-bordered > thead > tr > td:last-child, .panel > .table-responsive > .table-bordered > thead > tr > td:last-child, .panel > .table-bordered > tbody > tr > td:last-child, .panel > .table-responsive > .table-bordered > tbody > tr > td:last-child, .panel > .table-bordered > tfoot > tr > td:last-child, .panel > .table-responsive > .table-bordered > tfoot > tr > td:last-child { border-right: 0; } .panel > .table-bordered > thead > tr:first-child > td, .panel > .table-responsive > .table-bordered > thead > tr:first-child > td, .panel > .table-bordered > tbody > tr:first-child > td, .panel > .table-responsive > .table-bordered > tbody > tr:first-child > td, .panel > .table-bordered > thead > tr:first-child > th, .panel > .table-responsive > .table-bordered > thead > tr:first-child > th, .panel > .table-bordered > tbody > tr:first-child > th, .panel > .table-responsive > .table-bordered > tbody > tr:first-child > th { border-bottom: 0; } .panel > .table-bordered > tbody > tr:last-child > td, .panel > .table-responsive > .table-bordered > tbody > tr:last-child > td, .panel > .table-bordered > tfoot > tr:last-child > td, .panel > .table-responsive > .table-bordered > tfoot > tr:last-child > td, .panel > .table-bordered > tbody > tr:last-child > th, .panel > .table-responsive > .table-bordered > tbody > tr:last-child > th, .panel > .table-bordered > tfoot > tr:last-child > th, .panel > .table-responsive > .table-bordered > tfoot > tr:last-child > th { border-bottom: 0; } .panel > .table-responsive { border: 0; margin-bottom: 0; } .panel-group { margin-bottom: 21px; } .panel-group .panel { margin-bottom: 0; border-radius: 0; } .panel-group .panel + .panel { margin-top: 5px; } .panel-group .panel-heading { border-bottom: 0; } .panel-group .panel-heading + .panel-collapse > .panel-body, .panel-group .panel-heading + .panel-collapse > .list-group { border-top: 1px solid transparent; } .panel-group .panel-footer { border-top: 0; } .panel-group .panel-footer + .panel-collapse .panel-body { border-bottom: 1px solid transparent; } .panel-default { border-color: transparent; } .panel-default > .panel-heading { color: #333333; background-color: #f5f5f5; border-color: transparent; } .panel-default > .panel-heading + .panel-collapse > .panel-body { border-top-color: transparent; } .panel-default > .panel-heading .badge { color: #f5f5f5; background-color: #333333; } .panel-default > .panel-footer + .panel-collapse > .panel-body { border-bottom-color: transparent; } .panel-primary { border-color: transparent; } .panel-primary > .panel-heading { color: #ffffff; background-color: #df691a; border-color: transparent; } .panel-primary > .panel-heading + .panel-collapse > .panel-body { border-top-color: transparent; } .panel-primary > .panel-heading .badge { color: #df691a; background-color: #ffffff; } .panel-primary > .panel-footer + .panel-collapse > .panel-body { border-bottom-color: transparent; } .panel-success { border-color: transparent; } .panel-success > .panel-heading { color: #ebebeb; background-color: #5cb85c; border-color: transparent; } .panel-success > .panel-heading + .panel-collapse > .panel-body { border-top-color: transparent; } .panel-success > .panel-heading .badge { color: #5cb85c; background-color: #ebebeb; } .panel-success > .panel-footer + .panel-collapse > .panel-body { border-bottom-color: transparent; } .panel-info { border-color: transparent; } .panel-info > .panel-heading { color: #ebebeb; background-color: #5bc0de; border-color: transparent; } .panel-info > .panel-heading + .panel-collapse > .panel-body { border-top-color: transparent; } .panel-info > .panel-heading .badge { color: #5bc0de; background-color: #ebebeb; } .panel-info > .panel-footer + .panel-collapse > .panel-body { border-bottom-color: transparent; } .panel-warning { border-color: transparent; } .panel-warning > .panel-heading { color: #ebebeb; background-color: #f0ad4e; border-color: transparent; } .panel-warning > .panel-heading + .panel-collapse > .panel-body { border-top-color: transparent; } .panel-warning > .panel-heading .badge { color: #f0ad4e; background-color: #ebebeb; } .panel-warning > .panel-footer + .panel-collapse > .panel-body { border-bottom-color: transparent; } .panel-danger { border-color: transparent; } .panel-danger > .panel-heading { color: #ebebeb; background-color: #d9534f; border-color: transparent; } .panel-danger > .panel-heading + .panel-collapse > .panel-body { border-top-color: transparent; } .panel-danger > .panel-heading .badge { color: #d9534f; background-color: #ebebeb; } .panel-danger > .panel-footer + .panel-collapse > .panel-body { border-bottom-color: transparent; } .embed-responsive { position: relative; display: block; height: 0; padding: 0; overflow: hidden; } .embed-responsive .embed-responsive-item, .embed-responsive iframe, .embed-responsive embed, .embed-responsive object, .embed-responsive video { position: absolute; top: 0; left: 0; bottom: 0; height: 100%; width: 100%; border: 0; } .embed-responsive-16by9 { padding-bottom: 56.25%; } .embed-responsive-4by3 { padding-bottom: 75%; } .well { min-height: 20px; padding: 19px; margin-bottom: 20px; background-color: #4e5d6c; border: 1px solid transparent; border-radius: 0; -webkit-box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.05); box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.05); } .well blockquote { border-color: #ddd; border-color: rgba(0, 0, 0, 0.15); } .well-lg { padding: 24px; border-radius: 0; } .well-sm { padding: 9px; border-radius: 0; } .close { float: right; font-size: 22.5px; font-weight: bold; line-height: 1; color: #ebebeb; text-shadow: none; opacity: 0.2; filter: alpha(opacity=20); } .close:hover, .close:focus { color: #ebebeb; text-decoration: none; cursor: pointer; opacity: 0.5; filter: alpha(opacity=50); } button.close { padding: 0; cursor: pointer; background: transparent; border: 0; -webkit-appearance: none; } .modal-open { overflow: hidden; } .modal { display: none; overflow: hidden; position: fixed; top: 0; right: 0; bottom: 0; left: 0; z-index: 1050; -webkit-overflow-scrolling: touch; outline: 0; } .modal.fade .modal-dialog { -webkit-transform: translate(0, -25%); -ms-transform: translate(0, -25%); -o-transform: translate(0, -25%); transform: translate(0, -25%); -webkit-transition: -webkit-transform 0.3s ease-out; -o-transition: -o-transform 0.3s ease-out; transition: transform 0.3s ease-out; } .modal.in .modal-dialog { -webkit-transform: translate(0, 0); -ms-transform: translate(0, 0); -o-transform: translate(0, 0); transform: translate(0, 0); } .modal-open .modal { overflow-x: hidden; overflow-y: auto; } .modal-dialog { position: relative; width: auto; margin: 10px; } .modal-content { position: relative; background-color: #4e5d6c; border: 1px solid transparent; border-radius: 0; -webkit-box-shadow: 0 3px 9px rgba(0, 0, 0, 0.5); box-shadow: 0 3px 9px rgba(0, 0, 0, 0.5); -webkit-background-clip: padding-box; background-clip: padding-box; outline: 0; } .modal-backdrop { position: fixed; top: 0; right: 0; bottom: 0; left: 0; z-index: 1040; background-color: #000000; } .modal-backdrop.fade { opacity: 0; filter: alpha(opacity=0); } .modal-backdrop.in { opacity: 0.5; filter: alpha(opacity=50); } .modal-header { padding: 15px; border-bottom: 1px solid #2b3e50; min-height: 16.42857143px; } .modal-header .close { margin-top: -2px; } .modal-title { margin: 0; line-height: 1.42857143; } .modal-body { position: relative; padding: 20px; } .modal-footer { padding: 20px; text-align: right; border-top: 1px solid #2b3e50; } .modal-footer .btn + .btn { margin-left: 5px; margin-bottom: 0; } .modal-footer .btn-group .btn + .btn { margin-left: -1px; } .modal-footer .btn-block + .btn-block { margin-left: 0; } .modal-scrollbar-measure { position: absolute; top: -9999px; width: 50px; height: 50px; overflow: scroll; } @media (min-width: 768px) { .modal-dialog { width: 600px; margin: 30px auto; } .modal-content { -webkit-box-shadow: 0 5px 15px rgba(0, 0, 0, 0.5); box-shadow: 0 5px 15px rgba(0, 0, 0, 0.5); } .modal-sm { width: 300px; } } @media (min-width: 992px) { .modal-lg { width: 900px; } } .tooltip { position: absolute; z-index: 1070; display: block; font-family: "Lato", "Helvetica Neue", Helvetica, Arial, sans-serif; font-size: 13px; font-weight: normal; line-height: 1.4; opacity: 0; filter: alpha(opacity=0); } .tooltip.in { opacity: 0.9; filter: alpha(opacity=90); } .tooltip.top { margin-top: -3px; padding: 5px 0; } .tooltip.right { margin-left: 3px; padding: 0 5px; } .tooltip.bottom { margin-top: 3px; padding: 5px 0; } .tooltip.left { margin-left: -3px; padding: 0 5px; } .tooltip-inner { max-width: 200px; padding: 3px 8px; color: #ffffff; text-align: center; text-decoration: none; background-color: #000000; border-radius: 0; } .tooltip-arrow { position: absolute; width: 0; height: 0; border-color: transparent; border-style: solid; } .tooltip.top .tooltip-arrow { bottom: 0; left: 50%; margin-left: -5px; border-width: 5px 5px 0; border-top-color: #000000; } .tooltip.top-left .tooltip-arrow { bottom: 0; right: 5px; margin-bottom: -5px; border-width: 5px 5px 0; border-top-color: #000000; } .tooltip.top-right .tooltip-arrow { bottom: 0; left: 5px; margin-bottom: -5px; border-width: 5px 5px 0; border-top-color: #000000; } .tooltip.right .tooltip-arrow { top: 50%; left: 0; margin-top: -5px; border-width: 5px 5px 5px 0; border-right-color: #000000; } .tooltip.left .tooltip-arrow { top: 50%; right: 0; margin-top: -5px; border-width: 5px 0 5px 5px; border-left-color: #000000; } .tooltip.bottom .tooltip-arrow { top: 0; left: 50%; margin-left: -5px; border-width: 0 5px 5px; border-bottom-color: #000000; } .tooltip.bottom-left .tooltip-arrow { top: 0; right: 5px; margin-top: -5px; border-width: 0 5px 5px; border-bottom-color: #000000; } .tooltip.bottom-right .tooltip-arrow { top: 0; left: 5px; margin-top: -5px; border-width: 0 5px 5px; border-bottom-color: #000000; } .popover { position: absolute; top: 0; left: 0; z-index: 1060; display: none; max-width: 276px; padding: 1px; font-family: "Lato", "Helvetica Neue", Helvetica, Arial, sans-serif; font-size: 15px; font-weight: normal; line-height: 1.42857143; text-align: left; background-color: #4e5d6c; -webkit-background-clip: padding-box; background-clip: padding-box; border: 1px solid transparent; border-radius: 0; -webkit-box-shadow: 0 5px 10px rgba(0, 0, 0, 0.2); box-shadow: 0 5px 10px rgba(0, 0, 0, 0.2); white-space: normal; } .popover.top { margin-top: -10px; } .popover.right { margin-left: 10px; } .popover.bottom { margin-top: 10px; } .popover.left { margin-left: -10px; } .popover-title { margin: 0; padding: 8px 14px; font-size: 15px; background-color: #485563; border-bottom: 1px solid #3d4954; border-radius: -1 -1 0 0; } .popover-content { padding: 9px 14px; } .popover > .arrow, .popover > .arrow:after { position: absolute; display: block; width: 0; height: 0; border-color: transparent; border-style: solid; } .popover > .arrow { border-width: 11px; } .popover > .arrow:after { border-width: 10px; content: ""; } .popover.top > .arrow { left: 50%; margin-left: -11px; border-bottom-width: 0; border-top-color: transparent; bottom: -11px; } .popover.top > .arrow:after { content: " "; bottom: 1px; margin-left: -10px; border-bottom-width: 0; border-top-color: #4e5d6c; } .popover.right > .arrow { top: 50%; left: -11px; margin-top: -11px; border-left-width: 0; border-right-color: transparent; } .popover.right > .arrow:after { content: " "; left: 1px; bottom: -10px; border-left-width: 0; border-right-color: #4e5d6c; } .popover.bottom > .arrow { left: 50%; margin-left: -11px; border-top-width: 0; border-bottom-color: transparent; top: -11px; } .popover.bottom > .arrow:after { content: " "; top: 1px; margin-left: -10px; border-top-width: 0; border-bottom-color: #4e5d6c; } .popover.left > .arrow { top: 50%; right: -11px; margin-top: -11px; border-right-width: 0; border-left-color: transparent; } .popover.left > .arrow:after { content: " "; right: 1px; border-right-width: 0; border-left-color: #4e5d6c; bottom: -10px; } .clearfix:before, .clearfix:after, .dl-horizontal dd:before, .dl-horizontal dd:after, .container:before, .container:after, .container-fluid:before, .container-fluid:after, .row:before, .row:after, .form-horizontal .form-group:before, .form-horizontal .form-group:after, .btn-toolbar:before, .btn-toolbar:after, .btn-group-vertical > .btn-group:before, .btn-group-vertical > .btn-group:after, .nav:before, .nav:after, .navbar:before, .navbar:after, .navbar-header:before, .navbar-header:after, .navbar-collapse:before, .navbar-collapse:after, .pager:before, .pager:after, .panel-body:before, .panel-body:after, .modal-footer:before, .modal-footer:after { content: " "; display: table; } .clearfix:after, .dl-horizontal dd:after, .container:after, .container-fluid:after, .row:after, .form-horizontal .form-group:after, .btn-toolbar:after, .btn-group-vertical > .btn-group:after, .nav:after, .navbar:after, .navbar-header:after, .navbar-collapse:after, .pager:after, .panel-body:after, .modal-footer:after { clear: both; } .center-block { display: block; margin-left: auto; margin-right: auto; } .pull-right { float: right !important; } .pull-left { float: left !important; } .hide { display: none !important; } .show { display: block !important; } .invisible { visibility: hidden; } .text-hide { font: 0/0 a; color: transparent; text-shadow: none; background-color: transparent; border: 0; } .hidden { display: none !important; } .affix { position: fixed; } @-ms-viewport { width: device-width; } .visible-xs, .visible-sm, .visible-md, .visible-lg { display: none !important; } .visible-xs-block, .visible-xs-inline, .visible-xs-inline-block, .visible-sm-block, .visible-sm-inline, .visible-sm-inline-block, .visible-md-block, .visible-md-inline, .visible-md-inline-block, .visible-lg-block, .visible-lg-inline, .visible-lg-inline-block { display: none !important; } @media (max-width: 767px) { .visible-xs { display: block !important; } table.visible-xs { display: table; } tr.visible-xs { display: table-row !important; } th.visible-xs, td.visible-xs { display: table-cell !important; } } @media (max-width: 767px) { .visible-xs-block { display: block !important; } } @media (max-width: 767px) { .visible-xs-inline { display: inline !important; } } @media (max-width: 767px) { .visible-xs-inline-block { display: inline-block !important; } } @media (min-width: 768px) and (max-width: 991px) { .visible-sm { display: block !important; } table.visible-sm { display: table; } tr.visible-sm { display: table-row !important; } th.visible-sm, td.visible-sm { display: table-cell !important; } } @media (min-width: 768px) and (max-width: 991px) { .visible-sm-block { display: block !important; } } @media (min-width: 768px) and (max-width: 991px) { .visible-sm-inline { display: inline !important; } } @media (min-width: 768px) and (max-width: 991px) { .visible-sm-inline-block { display: inline-block !important; } } @media (min-width: 992px) and (max-width: 1199px) { .visible-md { display: block !important; } table.visible-md { display: table; } tr.visible-md { display: table-row !important; } th.visible-md, td.visible-md { display: table-cell !important; } } @media (min-width: 992px) and (max-width: 1199px) { .visible-md-block { display: block !important; } } @media (min-width: 992px) and (max-width: 1199px) { .visible-md-inline { display: inline !important; } } @media (min-width: 992px) and (max-width: 1199px) { .visible-md-inline-block { display: inline-block !important; } } @media (min-width: 1200px) { .visible-lg { display: block !important; } table.visible-lg { display: table; } tr.visible-lg { display: table-row !important; } th.visible-lg, td.visible-lg { display: table-cell !important; } } @media (min-width: 1200px) { .visible-lg-block { display: block !important; } } @media (min-width: 1200px) { .visible-lg-inline { display: inline !important; } } @media (min-width: 1200px) { .visible-lg-inline-block { display: inline-block !important; } } @media (max-width: 767px) { .hidden-xs { display: none !important; } } @media (min-width: 768px) and (max-width: 991px) { .hidden-sm { display: none !important; } } @media (min-width: 992px) and (max-width: 1199px) { .hidden-md { display: none !important; } } @media (min-width: 1200px) { .hidden-lg { display: none !important; } } .visible-print { display: none !important; } @media print { .visible-print { display: block !important; } table.visible-print { display: table; } tr.visible-print { display: table-row !important; } th.visible-print, td.visible-print { display: table-cell !important; } } .visible-print-block { display: none !important; } @media print { .visible-print-block { display: block !important; } } .visible-print-inline { display: none !important; } @media print { .visible-print-inline { display: inline !important; } } .visible-print-inline-block { display: none !important; } @media print { .visible-print-inline-block { display: inline-block !important; } } @media print { .hidden-print { display: none !important; } } .navbar { -webkit-box-shadow: none; box-shadow: none; border: none; font-size: 12px; } .navbar-default .badge { background-color: #fff; color: #4e5d6c; } .navbar-inverse .badge { background-color: #fff; color: #df691a; } .btn { font-weight: 300; } .btn-default:hover { background-color: #485563; } .btn-sm, .btn-xs { font-size: 12px; } body { font-weight: 300; } .text-primary, .text-primary:hover { color: #df691a; } .text-success, .text-success:hover { color: #5cb85c; } .text-danger, .text-danger:hover { color: #d9534f; } .text-warning, .text-warning:hover { color: #f0ad4e; } .text-info, .text-info:hover { color: #5bc0de; } .page-header { border-bottom-color: #4e5d6c; } .dropdown-menu { border: none; margin: 0; -webkit-box-shadow: none; box-shadow: none; } .dropdown-menu > li > a { font-size: 12px; font-weight: 300; } .btn-group.open .dropdown-toggle { -webkit-box-shadow: none; box-shadow: none; } .dropdown-header { font-size: 12px; } table, .table { font-size: 15px; } table a:not(.btn), .table a:not(.btn) { color: #fff; text-decoration: underline; } table .dropdown-menu a, .table .dropdown-menu a { text-decoration: none; } table .text-muted, .table .text-muted { color: #4e5d6c; } table > thead > tr > th, .table > thead > tr > th, table > tbody > tr > th, .table > tbody > tr > th, table > tfoot > tr > th, .table > tfoot > tr > th, table > thead > tr > td, .table > thead > tr > td, table > tbody > tr > td, .table > tbody > tr > td, table > tfoot > tr > td, .table > tfoot > tr > td { border-color: transparent; } input, textarea { color: #2b3e50; } label, .radio label, .checkbox label, .help-block { font-size: 12px; font-weight: 300; } .input-addon, .input-group-addon { color: #ebebeb; } .has-warning .help-block, .has-warning .control-label, .has-warning .form-control-feedback { color: #f0ad4e; } .has-warning .input-group-addon { border: none; } .has-error .help-block, .has-error .control-label, .has-error .form-control-feedback { color: #d9534f; } .has-error .input-group-addon { border: none; } .has-success .help-block, .has-success .control-label, .has-success .form-control-feedback { color: #5cb85c; } .has-success .input-group-addon { border: none; } .form-control:focus { -webkit-box-shadow: none; box-shadow: none; } .has-warning .form-control:focus, .has-error .form-control:focus, .has-success .form-control:focus { -webkit-box-shadow: none; box-shadow: none; } .nav .open > a, .nav .open > a:hover, .nav .open > a:focus { border-color: transparent; } .nav-tabs > li > a { color: #ebebeb; } .nav-pills > li > a { color: #ebebeb; } .pager a { color: #ebebeb; } .label { font-weight: 300; } .alert { color: #fff; } .alert a, .alert .alert-link { color: #fff; } .close { opacity: 0.4; } .close:hover, .close:focus { opacity: 1; } .well { -webkit-box-shadow: none; box-shadow: none; } a.list-group-item.active, a.list-group-item.active:hover, a.list-group-item.active:focus { border: none; } a.list-group-item-success.active { background-color: #5cb85c; } a.list-group-item-success.active:hover, a.list-group-item-success.active:focus { background-color: #4cae4c; } a.list-group-item-warning.active { background-color: #f0ad4e; } a.list-group-item-warning.active:hover, a.list-group-item-warning.active:focus { background-color: #eea236; } a.list-group-item-danger.active { background-color: #d9534f; } a.list-group-item-danger.active:hover, a.list-group-item-danger.active:focus { background-color: #d43f3a; } .panel { border: none; } .panel-default > .panel-heading { background-color: #485563; color: #ebebeb; } .thumbnail { background-color: #4e5d6c; border: none; } .modal { padding: 0; background-color:rgba(0,0,0,0.6) ; } .modal-header, .modal-footer { background-color: #485563; border: none; border-radius: 0; } .popover-title { border: none; } ================================================ FILE: app/http/html/bootstrap.css ================================================ html{font-family:sans-serif;-ms-text-size-adjust:100%;-webkit-text-size-adjust:100%}body{margin:0}article,aside,details,figcaption,figure,footer,header,hgroup,main,menu,nav,section,summary{display:block}audio,canvas,progress,video{display:inline-block;vertical-align:baseline}audio:not([controls]){display:none;height:0}[hidden],template{display:none}a{background-color:transparent}a:active,a:hover{outline:0}b,strong{font-weight:700}dfn{font-style:italic}h1{margin:.67em 0}mark{background:#ff0;color:#000}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sup{top:-.5em}sub{bottom:-.25em}img{border:0}svg:not(:root){overflow:hidden}hr{-moz-box-sizing:content-box;-webkit-box-sizing:content-box;box-sizing:content-box;height:0}pre{overflow:auto}code,kbd,pre,samp{font-size:1em}button,input,optgroup,select,textarea{color:inherit;font:inherit;margin:0}button{overflow:visible}button,select{text-transform:none}button,html input[type=button],input[type=reset],input[type=submit]{-webkit-appearance:button;cursor:pointer}button[disabled],html input[disabled]{cursor:default}button::-moz-focus-inner,input::-moz-focus-inner{border:0;padding:0}input[type=checkbox],input[type=radio]{-webkit-box-sizing:border-box;-moz-box-sizing:border-box;box-sizing:border-box;padding:0}input[type=number]::-webkit-inner-spin-button,input[type=number]::-webkit-outer-spin-button{height:auto}input[type=search]::-webkit-search-cancel-button,input[type=search]::-webkit-search-decoration{-webkit-appearance:none}textarea{overflow:auto}optgroup{font-weight:700}table{border-collapse:collapse;border-spacing:0}td,th{padding:0}/*! Source: https://github.com/h5bp/html5-boilerplate/blob/master/src/css/main.css */@media print{*,:after,:before{background:0 0!important;color:#000!important;-webkit-box-shadow:none!important;box-shadow:none!important;text-shadow:none!important}a,a:visited{text-decoration:underline}a[href]:after{content:" (" attr(href) ")"}abbr[title]:after{content:" (" attr(title) ")"}a[href^="javascript:"]:after,a[href^="#"]:after{content:""}blockquote,pre{border:1px solid #999;page-break-inside:avoid}thead{display:table-header-group}img,tr{page-break-inside:avoid}img{max-width:100%!important}h2,h3,p{orphans:3;widows:3}h2,h3{page-break-after:avoid}select{background:#fff!important}.navbar{display:none}.btn>.caret,.dropup>.btn>.caret{border-top-color:#000!important}.label{border:1px solid #000}.table{border-collapse:collapse!important}.table td,.table th{background-color:#fff!important}.table-bordered td,.table-bordered th{border:1px solid #ddd!important}}*,:after,:before{-webkit-box-sizing:border-box;-moz-box-sizing:border-box;box-sizing:border-box}html{font-size:10px;-webkit-tap-highlight-color:transparent}body{font-family:Lato,"Helvetica Neue",Helvetica,Arial,sans-serif;font-size:15px;line-height:1.42857143;color:#ebebeb;background-color:#2b3e50}button,input,select,textarea{font-family:inherit;font-size:inherit;line-height:inherit}a{color:#df691a;text-decoration:none}a:focus,a:hover{color:#df691a;text-decoration:underline}a:focus{outline:dotted thin;outline:-webkit-focus-ring-color auto 5px;outline-offset:-2px}figure{margin:0}img{vertical-align:middle}.carousel-inner>.item>a>img,.carousel-inner>.item>img,.img-responsive,.thumbnail a>img,.thumbnail>img{display:block;max-width:100%;height:auto}.img-rounded{border-radius:0}.img-thumbnail{padding:4px;line-height:1.42857143;background-color:#2b3e50;border:1px solid #ddd;border-radius:0;-webkit-transition:all .2s ease-in-out;-o-transition:all .2s ease-in-out;transition:all .2s ease-in-out;display:inline-block;max-width:100%;height:auto}.img-circle{border-radius:50%}hr{margin-top:21px;margin-bottom:21px;border:0;border-top:1px solid #596a7b}.sr-only{position:absolute;width:1px;height:1px;margin:-1px;padding:0;overflow:hidden;clip:rect(0,0,0,0);border:0}.sr-only-focusable:active,.sr-only-focusable:focus{position:static;width:auto;height:auto;margin:0;overflow:visible;clip:auto}[role=button]{cursor:pointer}.h1,.h2,.h3,.h4,.h5,.h6,h1,h2,h3,h4,h5,h6{font-family:inherit;font-weight:300;line-height:1.1;color:inherit}.h1 .small,.h1 small,.h2 .small,.h2 small,.h3 .small,.h3 small,.h4 .small,.h4 small,.h5 .small,.h5 small,.h6 .small,.h6 small,h1 .small,h1 small,h2 .small,h2 small,h3 .small,h3 small,h4 .small,h4 small,h5 .small,h5 small,h6 .small,h6 small{font-weight:400;line-height:1;color:#ebebeb}.h1,.h2,.h3,h1,h2,h3{margin-top:21px;margin-bottom:10.5px}.h1 .small,.h1 small,.h2 .small,.h2 small,.h3 .small,.h3 small,h1 .small,h1 small,h2 .small,h2 small,h3 .small,h3 small{font-size:65%}.h4,.h5,.h6,h4,h5,h6{margin-top:10.5px;margin-bottom:10.5px}.h4 .small,.h4 small,.h5 .small,.h5 small,.h6 .small,.h6 small,h4 .small,h4 small,h5 .small,h5 small,h6 .small,h6 small{font-size:75%}.h1,h1{font-size:39px}.h2,h2{font-size:32px}.h3,h3{font-size:26px}.h4,h4{font-size:19px}.h5,h5{font-size:15px}.h6,h6{font-size:13px}p{margin:0 0 10.5px}.lead{margin-bottom:21px;font-size:17px;font-weight:300;line-height:1.4}@media (min-width:768px){.lead{font-size:22.5px}}.small,small{font-size:86%}.mark,mark{background-color:#f0ad4e;padding:.2em}.text-left{text-align:left}.text-right{text-align:right}.text-center{text-align:center}.text-justify{text-align:justify}.text-nowrap{white-space:nowrap}.text-lowercase{text-transform:lowercase}.text-uppercase{text-transform:uppercase}.text-capitalize{text-transform:capitalize}.text-muted{color:#4e5d6c}a.text-primary:hover{color:#b15315}a.text-success:hover{color:#d2d2d2}a.text-info:hover{color:#d2d2d2}a.text-warning:hover{color:#d2d2d2}a.text-danger:hover{color:#d2d2d2}.bg-primary{color:#fff;background-color:#df691a}a.bg-primary:hover{background-color:#b15315}.bg-success{background-color:#5cb85c}a.bg-success:hover{background-color:#449d44}.bg-info{background-color:#5bc0de}a.bg-info:hover{background-color:#31b0d5}.bg-warning{background-color:#f0ad4e}a.bg-warning:hover{background-color:#ec971f}.bg-danger{background-color:#d9534f}a.bg-danger:hover{background-color:#c9302c}.page-header{padding-bottom:9.5px;margin:42px 0 21px;border-bottom:1px solid #ebebeb}ol,ul{margin-top:0;margin-bottom:10.5px}ol ol,ol ul,ul ol,ul ul{margin-bottom:0}.list-unstyled{padding-left:0;list-style:none}.list-inline{padding-left:0;list-style:none;margin-left:-5px}.list-inline>li{display:inline-block;padding-left:5px;padding-right:5px}dl{margin-top:0;margin-bottom:21px}dd,dt{line-height:1.42857143}dt{font-weight:700}dd{margin-left:0}@media (min-width:768px){.dl-horizontal dt{float:left;width:160px;clear:left;text-align:right;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.dl-horizontal dd{margin-left:180px}}abbr[data-original-title],abbr[title]{cursor:help;border-bottom:1px dotted #4e5d6c}.initialism{font-size:90%;text-transform:uppercase}blockquote{padding:10.5px 21px;margin:0 0 21px;font-size:18.75px;border-left:5px solid #4e5d6c}blockquote ol:last-child,blockquote p:last-child,blockquote ul:last-child{margin-bottom:0}blockquote .small,blockquote footer,blockquote small{display:block;font-size:80%;line-height:1.42857143;color:#ebebeb}blockquote .small:before,blockquote footer:before,blockquote small:before{content:'\2014 \00A0'}.blockquote-reverse,blockquote.pull-right{padding-right:15px;padding-left:0;border-right:5px solid #4e5d6c;border-left:0;text-align:right}.blockquote-reverse .small:before,.blockquote-reverse footer:before,.blockquote-reverse small:before,blockquote.pull-right .small:before,blockquote.pull-right footer:before,blockquote.pull-right small:before{content:''}.blockquote-reverse .small:after,.blockquote-reverse footer:after,.blockquote-reverse small:after,blockquote.pull-right .small:after,blockquote.pull-right footer:after,blockquote.pull-right small:after{content:'\00A0 \2014'}address{margin-bottom:21px;font-style:normal;line-height:1.42857143}code,kbd,pre,samp{font-family:Menlo,Monaco,Consolas,"Courier New",monospace}code{padding:2px 4px;font-size:90%;color:#c7254e;background-color:#f9f2f4;border-radius:0}kbd{padding:2px 4px;font-size:90%;color:#fff;background-color:#333;border-radius:0;-webkit-box-shadow:inset 0 -1px 0 rgba(0,0,0,.25);box-shadow:inset 0 -1px 0 rgba(0,0,0,.25)}kbd kbd{padding:0;font-size:100%;font-weight:700;-webkit-box-shadow:none;box-shadow:none}pre{display:block;padding:10px;margin:0 0 10.5px;font-size:14px;line-height:1.42857143;word-break:break-all;word-wrap:break-word;color:#333;background-color:#f5f5f5;border:1px solid #ccc;border-radius:0}pre code{padding:0;font-size:inherit;color:inherit;white-space:pre-wrap;background-color:transparent;border-radius:0}.pre-scrollable{max-height:340px;overflow-y:scroll}.container,.container-fluid{margin-right:auto;margin-left:auto;padding-left:15px;padding-right:15px}@media (min-width:768px){.container{width:750px}}@media (min-width:992px){.container{width:970px}}@media (min-width:1200px){.container{width:1170px}}.row{margin-left:-15px;margin-right:-15px}.col-lg-1,.col-lg-10,.col-lg-11,.col-lg-12,.col-lg-2,.col-lg-3,.col-lg-4,.col-lg-5,.col-lg-6,.col-lg-7,.col-lg-8,.col-lg-9,.col-md-1,.col-md-10,.col-md-11,.col-md-12,.col-md-2,.col-md-3,.col-md-4,.col-md-5,.col-md-6,.col-md-7,.col-md-8,.col-md-9,.col-sm-1,.col-sm-10,.col-sm-11,.col-sm-12,.col-sm-2,.col-sm-3,.col-sm-4,.col-sm-5,.col-sm-6,.col-sm-7,.col-sm-8,.col-sm-9,.col-xs-1,.col-xs-10,.col-xs-11,.col-xs-12,.col-xs-2,.col-xs-3,.col-xs-4,.col-xs-5,.col-xs-6,.col-xs-7,.col-xs-8,.col-xs-9{position:relative;min-height:1px;padding-left:15px;padding-right:15px}.col-xs-1,.col-xs-10,.col-xs-11,.col-xs-12,.col-xs-2,.col-xs-3,.col-xs-4,.col-xs-5,.col-xs-6,.col-xs-7,.col-xs-8,.col-xs-9{float:left}.col-xs-12{width:100%}.col-xs-11{width:91.66666667%}.col-xs-10{width:83.33333333%}.col-xs-9{width:75%}.col-xs-8{width:66.66666667%}.col-xs-7{width:58.33333333%}.col-xs-6{width:50%}.col-xs-5{width:41.66666667%}.col-xs-4{width:33.33333333%}.col-xs-3{width:25%}.col-xs-2{width:16.66666667%}.col-xs-1{width:8.33333333%}.col-xs-pull-12{right:100%}.col-xs-pull-11{right:91.66666667%}.col-xs-pull-10{right:83.33333333%}.col-xs-pull-9{right:75%}.col-xs-pull-8{right:66.66666667%}.col-xs-pull-7{right:58.33333333%}.col-xs-pull-6{right:50%}.col-xs-pull-5{right:41.66666667%}.col-xs-pull-4{right:33.33333333%}.col-xs-pull-3{right:25%}.col-xs-pull-2{right:16.66666667%}.col-xs-pull-1{right:8.33333333%}.col-xs-pull-0{right:auto}.col-xs-push-12{left:100%}.col-xs-push-11{left:91.66666667%}.col-xs-push-10{left:83.33333333%}.col-xs-push-9{left:75%}.col-xs-push-8{left:66.66666667%}.col-xs-push-7{left:58.33333333%}.col-xs-push-6{left:50%}.col-xs-push-5{left:41.66666667%}.col-xs-push-4{left:33.33333333%}.col-xs-push-3{left:25%}.col-xs-push-2{left:16.66666667%}.col-xs-push-1{left:8.33333333%}.col-xs-push-0{left:auto}.col-xs-offset-12{margin-left:100%}.col-xs-offset-11{margin-left:91.66666667%}.col-xs-offset-10{margin-left:83.33333333%}.col-xs-offset-9{margin-left:75%}.col-xs-offset-8{margin-left:66.66666667%}.col-xs-offset-7{margin-left:58.33333333%}.col-xs-offset-6{margin-left:50%}.col-xs-offset-5{margin-left:41.66666667%}.col-xs-offset-4{margin-left:33.33333333%}.col-xs-offset-3{margin-left:25%}.col-xs-offset-2{margin-left:16.66666667%}.col-xs-offset-1{margin-left:8.33333333%}.col-xs-offset-0{margin-left:0}@media (min-width:768px){.col-sm-1,.col-sm-10,.col-sm-11,.col-sm-12,.col-sm-2,.col-sm-3,.col-sm-4,.col-sm-5,.col-sm-6,.col-sm-7,.col-sm-8,.col-sm-9{float:left}.col-sm-12{width:100%}.col-sm-11{width:91.66666667%}.col-sm-10{width:83.33333333%}.col-sm-9{width:75%}.col-sm-8{width:66.66666667%}.col-sm-7{width:58.33333333%}.col-sm-6{width:50%}.col-sm-5{width:41.66666667%}.col-sm-4{width:33.33333333%}.col-sm-3{width:25%}.col-sm-2{width:16.66666667%}.col-sm-1{width:8.33333333%}.col-sm-pull-12{right:100%}.col-sm-pull-11{right:91.66666667%}.col-sm-pull-10{right:83.33333333%}.col-sm-pull-9{right:75%}.col-sm-pull-8{right:66.66666667%}.col-sm-pull-7{right:58.33333333%}.col-sm-pull-6{right:50%}.col-sm-pull-5{right:41.66666667%}.col-sm-pull-4{right:33.33333333%}.col-sm-pull-3{right:25%}.col-sm-pull-2{right:16.66666667%}.col-sm-pull-1{right:8.33333333%}.col-sm-pull-0{right:auto}.col-sm-push-12{left:100%}.col-sm-push-11{left:91.66666667%}.col-sm-push-10{left:83.33333333%}.col-sm-push-9{left:75%}.col-sm-push-8{left:66.66666667%}.col-sm-push-7{left:58.33333333%}.col-sm-push-6{left:50%}.col-sm-push-5{left:41.66666667%}.col-sm-push-4{left:33.33333333%}.col-sm-push-3{left:25%}.col-sm-push-2{left:16.66666667%}.col-sm-push-1{left:8.33333333%}.col-sm-push-0{left:auto}.col-sm-offset-12{margin-left:100%}.col-sm-offset-11{margin-left:91.66666667%}.col-sm-offset-10{margin-left:83.33333333%}.col-sm-offset-9{margin-left:75%}.col-sm-offset-8{margin-left:66.66666667%}.col-sm-offset-7{margin-left:58.33333333%}.col-sm-offset-6{margin-left:50%}.col-sm-offset-5{margin-left:41.66666667%}.col-sm-offset-4{margin-left:33.33333333%}.col-sm-offset-3{margin-left:25%}.col-sm-offset-2{margin-left:16.66666667%}.col-sm-offset-1{margin-left:8.33333333%}.col-sm-offset-0{margin-left:0}}@media (min-width:992px){.col-md-1,.col-md-10,.col-md-11,.col-md-12,.col-md-2,.col-md-3,.col-md-4,.col-md-5,.col-md-6,.col-md-7,.col-md-8,.col-md-9{float:left}.col-md-12{width:100%}.col-md-11{width:91.66666667%}.col-md-10{width:83.33333333%}.col-md-9{width:75%}.col-md-8{width:66.66666667%}.col-md-7{width:58.33333333%}.col-md-6{width:50%}.col-md-5{width:41.66666667%}.col-md-4{width:33.33333333%}.col-md-3{width:25%}.col-md-2{width:16.66666667%}.col-md-1{width:8.33333333%}.col-md-pull-12{right:100%}.col-md-pull-11{right:91.66666667%}.col-md-pull-10{right:83.33333333%}.col-md-pull-9{right:75%}.col-md-pull-8{right:66.66666667%}.col-md-pull-7{right:58.33333333%}.col-md-pull-6{right:50%}.col-md-pull-5{right:41.66666667%}.col-md-pull-4{right:33.33333333%}.col-md-pull-3{right:25%}.col-md-pull-2{right:16.66666667%}.col-md-pull-1{right:8.33333333%}.col-md-pull-0{right:auto}.col-md-push-12{left:100%}.col-md-push-11{left:91.66666667%}.col-md-push-10{left:83.33333333%}.col-md-push-9{left:75%}.col-md-push-8{left:66.66666667%}.col-md-push-7{left:58.33333333%}.col-md-push-6{left:50%}.col-md-push-5{left:41.66666667%}.col-md-push-4{left:33.33333333%}.col-md-push-3{left:25%}.col-md-push-2{left:16.66666667%}.col-md-push-1{left:8.33333333%}.col-md-push-0{left:auto}.col-md-offset-12{margin-left:100%}.col-md-offset-11{margin-left:91.66666667%}.col-md-offset-10{margin-left:83.33333333%}.col-md-offset-9{margin-left:75%}.col-md-offset-8{margin-left:66.66666667%}.col-md-offset-7{margin-left:58.33333333%}.col-md-offset-6{margin-left:50%}.col-md-offset-5{margin-left:41.66666667%}.col-md-offset-4{margin-left:33.33333333%}.col-md-offset-3{margin-left:25%}.col-md-offset-2{margin-left:16.66666667%}.col-md-offset-1{margin-left:8.33333333%}.col-md-offset-0{margin-left:0}}@media (min-width:1200px){.col-lg-1,.col-lg-10,.col-lg-11,.col-lg-12,.col-lg-2,.col-lg-3,.col-lg-4,.col-lg-5,.col-lg-6,.col-lg-7,.col-lg-8,.col-lg-9{float:left}.col-lg-12{width:100%}.col-lg-11{width:91.66666667%}.col-lg-10{width:83.33333333%}.col-lg-9{width:75%}.col-lg-8{width:66.66666667%}.col-lg-7{width:58.33333333%}.col-lg-6{width:50%}.col-lg-5{width:41.66666667%}.col-lg-4{width:33.33333333%}.col-lg-3{width:25%}.col-lg-2{width:16.66666667%}.col-lg-1{width:8.33333333%}.col-lg-pull-12{right:100%}.col-lg-pull-11{right:91.66666667%}.col-lg-pull-10{right:83.33333333%}.col-lg-pull-9{right:75%}.col-lg-pull-8{right:66.66666667%}.col-lg-pull-7{right:58.33333333%}.col-lg-pull-6{right:50%}.col-lg-pull-5{right:41.66666667%}.col-lg-pull-4{right:33.33333333%}.col-lg-pull-3{right:25%}.col-lg-pull-2{right:16.66666667%}.col-lg-pull-1{right:8.33333333%}.col-lg-pull-0{right:auto}.col-lg-push-12{left:100%}.col-lg-push-11{left:91.66666667%}.col-lg-push-10{left:83.33333333%}.col-lg-push-9{left:75%}.col-lg-push-8{left:66.66666667%}.col-lg-push-7{left:58.33333333%}.col-lg-push-6{left:50%}.col-lg-push-5{left:41.66666667%}.col-lg-push-4{left:33.33333333%}.col-lg-push-3{left:25%}.col-lg-push-2{left:16.66666667%}.col-lg-push-1{left:8.33333333%}.col-lg-push-0{left:auto}.col-lg-offset-12{margin-left:100%}.col-lg-offset-11{margin-left:91.66666667%}.col-lg-offset-10{margin-left:83.33333333%}.col-lg-offset-9{margin-left:75%}.col-lg-offset-8{margin-left:66.66666667%}.col-lg-offset-7{margin-left:58.33333333%}.col-lg-offset-6{margin-left:50%}.col-lg-offset-5{margin-left:41.66666667%}.col-lg-offset-4{margin-left:33.33333333%}.col-lg-offset-3{margin-left:25%}.col-lg-offset-2{margin-left:16.66666667%}.col-lg-offset-1{margin-left:8.33333333%}.col-lg-offset-0{margin-left:0}}table{background-color:transparent}caption{padding-top:6px;padding-bottom:6px;color:#4e5d6c;text-align:left}th{text-align:left}.table{width:100%;max-width:100%;margin-bottom:21px}.table>tbody>tr>td,.table>tbody>tr>th,.table>tfoot>tr>td,.table>tfoot>tr>th,.table>thead>tr>td,.table>thead>tr>th{padding:10px;line-height:1.42857143;vertical-align:top;border-top:1px solid #4e5d6c}.table>thead>tr>th{vertical-align:bottom;border-bottom:2px solid #4e5d6c}.table>caption+thead>tr:first-child>td,.table>caption+thead>tr:first-child>th,.table>colgroup+thead>tr:first-child>td,.table>colgroup+thead>tr:first-child>th,.table>thead:first-child>tr:first-child>td,.table>thead:first-child>tr:first-child>th{border-top:0}.table>tbody+tbody{border-top:2px solid #4e5d6c}.table .table{background-color:#2b3e50}.table-condensed>tbody>tr>td,.table-condensed>tbody>tr>th,.table-condensed>tfoot>tr>td,.table-condensed>tfoot>tr>th,.table-condensed>thead>tr>td,.table-condensed>thead>tr>th{padding:3px}.table-bordered,.table-bordered>tbody>tr>td,.table-bordered>tbody>tr>th,.table-bordered>tfoot>tr>td,.table-bordered>tfoot>tr>th,.table-bordered>thead>tr>td,.table-bordered>thead>tr>th{border:1px solid #4e5d6c}.table-bordered>thead>tr>td,.table-bordered>thead>tr>th{border-bottom-width:2px}.table-striped>tbody>tr:nth-of-type(odd){background-color:#4e5d6c}.table-hover>tbody>tr:hover{background-color:#485563}table col[class*=col-]{position:static;float:none;display:table-column}table td[class*=col-],table th[class*=col-]{position:static;float:none;display:table-cell}.table>tbody>tr.active>td,.table>tbody>tr.active>th,.table>tbody>tr>td.active,.table>tbody>tr>th.active,.table>tfoot>tr.active>td,.table>tfoot>tr.active>th,.table>tfoot>tr>td.active,.table>tfoot>tr>th.active,.table>thead>tr.active>td,.table>thead>tr.active>th,.table>thead>tr>td.active,.table>thead>tr>th.active{background-color:#485563}.table-hover>tbody>tr.active:hover>td,.table-hover>tbody>tr.active:hover>th,.table-hover>tbody>tr:hover>.active,.table-hover>tbody>tr>td.active:hover,.table-hover>tbody>tr>th.active:hover{background-color:#3d4954}.table>tbody>tr.success>td,.table>tbody>tr.success>th,.table>tbody>tr>td.success,.table>tbody>tr>th.success,.table>tfoot>tr.success>td,.table>tfoot>tr.success>th,.table>tfoot>tr>td.success,.table>tfoot>tr>th.success,.table>thead>tr.success>td,.table>thead>tr.success>th,.table>thead>tr>td.success,.table>thead>tr>th.success{background-color:#5cb85c}.table-hover>tbody>tr.success:hover>td,.table-hover>tbody>tr.success:hover>th,.table-hover>tbody>tr:hover>.success,.table-hover>tbody>tr>td.success:hover,.table-hover>tbody>tr>th.success:hover{background-color:#4cae4c}.table>tbody>tr.info>td,.table>tbody>tr.info>th,.table>tbody>tr>td.info,.table>tbody>tr>th.info,.table>tfoot>tr.info>td,.table>tfoot>tr.info>th,.table>tfoot>tr>td.info,.table>tfoot>tr>th.info,.table>thead>tr.info>td,.table>thead>tr.info>th,.table>thead>tr>td.info,.table>thead>tr>th.info{background-color:#5bc0de}.table-hover>tbody>tr.info:hover>td,.table-hover>tbody>tr.info:hover>th,.table-hover>tbody>tr:hover>.info,.table-hover>tbody>tr>td.info:hover,.table-hover>tbody>tr>th.info:hover{background-color:#46b8da}.table>tbody>tr.warning>td,.table>tbody>tr.warning>th,.table>tbody>tr>td.warning,.table>tbody>tr>th.warning,.table>tfoot>tr.warning>td,.table>tfoot>tr.warning>th,.table>tfoot>tr>td.warning,.table>tfoot>tr>th.warning,.table>thead>tr.warning>td,.table>thead>tr.warning>th,.table>thead>tr>td.warning,.table>thead>tr>th.warning{background-color:#f0ad4e}.table-hover>tbody>tr.warning:hover>td,.table-hover>tbody>tr.warning:hover>th,.table-hover>tbody>tr:hover>.warning,.table-hover>tbody>tr>td.warning:hover,.table-hover>tbody>tr>th.warning:hover{background-color:#eea236}.table>tbody>tr.danger>td,.table>tbody>tr.danger>th,.table>tbody>tr>td.danger,.table>tbody>tr>th.danger,.table>tfoot>tr.danger>td,.table>tfoot>tr.danger>th,.table>tfoot>tr>td.danger,.table>tfoot>tr>th.danger,.table>thead>tr.danger>td,.table>thead>tr.danger>th,.table>thead>tr>td.danger,.table>thead>tr>th.danger{background-color:#d9534f}.table-hover>tbody>tr.danger:hover>td,.table-hover>tbody>tr.danger:hover>th,.table-hover>tbody>tr:hover>.danger,.table-hover>tbody>tr>td.danger:hover,.table-hover>tbody>tr>th.danger:hover{background-color:#d43f3a}.table-responsive{overflow-x:auto;min-height:.01%}@media screen and (max-width:767px){.table-responsive{width:100%;margin-bottom:15.75px;overflow-y:hidden;-ms-overflow-style:-ms-autohiding-scrollbar;border:1px solid #4e5d6c}.table-responsive>.table{margin-bottom:0}.table-responsive>.table>tbody>tr>td,.table-responsive>.table>tbody>tr>th,.table-responsive>.table>tfoot>tr>td,.table-responsive>.table>tfoot>tr>th,.table-responsive>.table>thead>tr>td,.table-responsive>.table>thead>tr>th{white-space:nowrap}.table-responsive>.table-bordered{border:0}.table-responsive>.table-bordered>tbody>tr>td:first-child,.table-responsive>.table-bordered>tbody>tr>th:first-child,.table-responsive>.table-bordered>tfoot>tr>td:first-child,.table-responsive>.table-bordered>tfoot>tr>th:first-child,.table-responsive>.table-bordered>thead>tr>td:first-child,.table-responsive>.table-bordered>thead>tr>th:first-child{border-left:0}.table-responsive>.table-bordered>tbody>tr>td:last-child,.table-responsive>.table-bordered>tbody>tr>th:last-child,.table-responsive>.table-bordered>tfoot>tr>td:last-child,.table-responsive>.table-bordered>tfoot>tr>th:last-child,.table-responsive>.table-bordered>thead>tr>td:last-child,.table-responsive>.table-bordered>thead>tr>th:last-child{border-right:0}.table-responsive>.table-bordered>tbody>tr:last-child>td,.table-responsive>.table-bordered>tbody>tr:last-child>th,.table-responsive>.table-bordered>tfoot>tr:last-child>td,.table-responsive>.table-bordered>tfoot>tr:last-child>th{border-bottom:0}}fieldset{padding:0;margin:0;border:0;min-width:0}legend{display:block;width:100%;padding:0;margin-bottom:21px;font-size:22.5px;line-height:inherit;color:#ebebeb;border:0;border-bottom:1px solid #4e5d6c}label{display:inline-block;max-width:100%;margin-bottom:5px}input[type=search]{-webkit-box-sizing:border-box;-moz-box-sizing:border-box;box-sizing:border-box}input[type=checkbox],input[type=radio]{margin:4px 0 0;line-height:normal}input[type=file]{display:block}input[type=range]{display:block;width:100%}select[multiple],select[size]{height:auto}input[type=file]:focus,input[type=checkbox]:focus,input[type=radio]:focus{outline:dotted thin;outline:-webkit-focus-ring-color auto 5px;outline-offset:-2px}output{display:block;padding-top:9px;font-size:15px;line-height:1.42857143;color:#2b3e50}.form-control{display:block;width:100%;height:39px;padding:8px 16px;font-size:15px;line-height:1.42857143;color:#2b3e50;background-color:#fff;background-image:none;border:1px solid transparent;border-radius:0;-webkit-box-shadow:inset 0 1px 1px rgba(0,0,0,.075);box-shadow:inset 0 1px 1px rgba(0,0,0,.075);-webkit-transition:border-color ease-in-out .15s,-webkit-box-shadow ease-in-out .15s;-o-transition:border-color ease-in-out .15s,box-shadow ease-in-out .15s;transition:border-color ease-in-out .15s,box-shadow ease-in-out .15s}.form-control:focus{border-color:transparent;outline:0}.form-control::-moz-placeholder{color:#ccc;opacity:1}.form-control:-ms-input-placeholder{color:#ccc}.form-control::-webkit-input-placeholder{color:#ccc}.form-control[disabled],.form-control[readonly],fieldset[disabled] .form-control{background-color:#ebebeb;opacity:1}.form-control[disabled],fieldset[disabled] .form-control{cursor:not-allowed}textarea.form-control{height:auto}input[type=search]{-webkit-appearance:none}@media screen and (-webkit-min-device-pixel-ratio:0){input[type=date],input[type=time],input[type=datetime-local],input[type=month]{line-height:39px}.input-group-sm input[type=date],.input-group-sm input[type=time],.input-group-sm input[type=datetime-local],.input-group-sm input[type=month],input[type=date].input-sm,input[type=time].input-sm,input[type=datetime-local].input-sm,input[type=month].input-sm{line-height:31px}.input-group-lg input[type=date],.input-group-lg input[type=time],.input-group-lg input[type=datetime-local],.input-group-lg input[type=month],input[type=date].input-lg,input[type=time].input-lg,input[type=datetime-local].input-lg,input[type=month].input-lg{line-height:52px}}.form-group{margin-bottom:15px}.checkbox,.radio{position:relative;display:block;margin-top:10px;margin-bottom:10px}.checkbox label,.radio label{min-height:21px;padding-left:20px;margin-bottom:0;cursor:pointer}.checkbox input[type=checkbox],.checkbox-inline input[type=checkbox],.radio input[type=radio],.radio-inline input[type=radio]{position:absolute;margin-left:-20px}.checkbox+.checkbox,.radio+.radio{margin-top:-5px}.checkbox-inline,.radio-inline{position:relative;display:inline-block;padding-left:20px;margin-bottom:0;vertical-align:middle;font-weight:400;cursor:pointer}.checkbox-inline+.checkbox-inline,.radio-inline+.radio-inline{margin-top:0;margin-left:10px}.checkbox-inline.disabled,.checkbox.disabled label,.radio-inline.disabled,.radio.disabled label,fieldset[disabled] .checkbox label,fieldset[disabled] .checkbox-inline,fieldset[disabled] .radio label,fieldset[disabled] .radio-inline,fieldset[disabled] input[type=checkbox],fieldset[disabled] input[type=radio],input[type=checkbox].disabled,input[type=checkbox][disabled],input[type=radio].disabled,input[type=radio][disabled]{cursor:not-allowed}.form-control-static{padding-top:9px;padding-bottom:9px;margin-bottom:0;min-height:36px}.form-control-static.input-lg,.form-control-static.input-sm{padding-left:0;padding-right:0}.input-sm{height:31px;padding:5px 10px;font-size:13px;line-height:1.5;border-radius:0}select.input-sm{height:31px;line-height:31px}select[multiple].input-sm,textarea.input-sm{height:auto}.form-group-sm .form-control{height:31px;padding:5px 10px;font-size:13px;line-height:1.5;border-radius:0}select.form-group-sm .form-control{height:31px;line-height:31px}select[multiple].form-group-sm .form-control,textarea.form-group-sm .form-control{height:auto}.form-group-sm .form-control-static{height:31px;padding:5px 10px;font-size:13px;line-height:1.5;min-height:34px}.input-lg{height:52px;padding:12px 24px;font-size:19px;line-height:1.3333333;border-radius:0}select.input-lg{height:52px;line-height:52px}select[multiple].input-lg,textarea.input-lg{height:auto}.form-group-lg .form-control{height:52px;padding:12px 24px;font-size:19px;line-height:1.3333333;border-radius:0}select.form-group-lg .form-control{height:52px;line-height:52px}select[multiple].form-group-lg .form-control,textarea.form-group-lg .form-control{height:auto}.form-group-lg .form-control-static{height:52px;padding:12px 24px;font-size:19px;line-height:1.3333333;min-height:40px}.has-feedback{position:relative}.has-feedback .form-control{padding-right:48.75px}.form-control-feedback{position:absolute;top:0;right:0;z-index:2;display:block;width:39px;height:39px;line-height:39px;text-align:center;pointer-events:none}.input-lg+.form-control-feedback{width:52px;height:52px;line-height:52px}.input-sm+.form-control-feedback{width:31px;height:31px;line-height:31px}.has-success .checkbox,.has-success .checkbox-inline,.has-success .control-label,.has-success .help-block,.has-success .radio,.has-success .radio-inline,.has-success.checkbox label,.has-success.checkbox-inline label,.has-success.radio label,.has-success.radio-inline label{color:#ebebeb}.has-success .form-control{border-color:#ebebeb;-webkit-box-shadow:inset 0 1px 1px rgba(0,0,0,.075);box-shadow:inset 0 1px 1px rgba(0,0,0,.075)}.has-success .form-control:focus{border-color:#d2d2d2}.has-success .input-group-addon{color:#ebebeb;background-color:#5cb85c}.has-success .form-control-feedback,.has-warning .checkbox,.has-warning .checkbox-inline,.has-warning .control-label,.has-warning .help-block,.has-warning .radio,.has-warning .radio-inline,.has-warning.checkbox label,.has-warning.checkbox-inline label,.has-warning.radio label,.has-warning.radio-inline label{color:#ebebeb}.has-warning .form-control{border-color:#ebebeb;-webkit-box-shadow:inset 0 1px 1px rgba(0,0,0,.075);box-shadow:inset 0 1px 1px rgba(0,0,0,.075)}.has-warning .form-control:focus{border-color:#d2d2d2}.has-warning .input-group-addon{color:#ebebeb;background-color:#f0ad4e}.has-error .checkbox,.has-error .checkbox-inline,.has-error .control-label,.has-error .help-block,.has-error .radio,.has-error .radio-inline,.has-error.checkbox label,.has-error.checkbox-inline label,.has-error.radio label,.has-error.radio-inline label,.has-warning .form-control-feedback{color:#ebebeb}.has-error .form-control{border-color:#ebebeb;-webkit-box-shadow:inset 0 1px 1px rgba(0,0,0,.075);box-shadow:inset 0 1px 1px rgba(0,0,0,.075)}.has-error .form-control:focus{border-color:#d2d2d2}.has-error .input-group-addon{color:#ebebeb;background-color:#d9534f}.has-feedback label~.form-control-feedback{top:26px}.has-feedback label.sr-only~.form-control-feedback{top:0}.help-block{display:block;margin-top:5px;margin-bottom:10px;color:#fff}@media (min-width:768px){.form-inline .form-group{display:inline-block;margin-bottom:0;vertical-align:middle}.form-inline .form-control{display:inline-block;width:auto;vertical-align:middle}.form-inline .form-control-static{display:inline-block}.form-inline .input-group{display:inline-table;vertical-align:middle}.form-inline .input-group .form-control,.form-inline .input-group .input-group-addon,.form-inline .input-group .input-group-btn{width:auto}.form-inline .input-group>.form-control{width:100%}.form-inline .control-label{margin-bottom:0;vertical-align:middle}.form-inline .checkbox,.form-inline .radio{display:inline-block;margin-top:0;margin-bottom:0;vertical-align:middle}.form-inline .checkbox label,.form-inline .radio label{padding-left:0}.form-inline .checkbox input[type=checkbox],.form-inline .radio input[type=radio]{position:relative;margin-left:0}.form-inline .has-feedback .form-control-feedback{top:0}}.form-horizontal .checkbox,.form-horizontal .checkbox-inline,.form-horizontal .radio,.form-horizontal .radio-inline{margin-top:0;margin-bottom:0;padding-top:9px}.form-horizontal .checkbox,.form-horizontal .radio{min-height:30px}.form-horizontal .form-group{margin-left:-15px;margin-right:-15px}@media (min-width:768px){.form-horizontal .control-label{text-align:right;margin-bottom:0;padding-top:9px}}.form-horizontal .has-feedback .form-control-feedback{right:15px}@media (min-width:768px){.form-horizontal .form-group-lg .control-label{padding-top:17px}}@media (min-width:768px){.form-horizontal .form-group-sm .control-label{padding-top:6px}}.btn{display:inline-block;margin-bottom:0;text-align:center;vertical-align:middle;-ms-touch-action:manipulation;touch-action:manipulation;cursor:pointer;background-image:none;border:1px solid transparent;white-space:nowrap;padding:8px 16px;font-size:15px;line-height:1.42857143;border-radius:0;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none}.btn.active.focus,.btn.active:focus,.btn.focus,.btn:active.focus,.btn:active:focus,.btn:focus{outline:dotted thin;outline:-webkit-focus-ring-color auto 5px;outline-offset:-2px}.btn.focus,.btn:focus,.btn:hover{color:#fff;text-decoration:none}.btn.active,.btn:active{outline:0;background-image:none;-webkit-box-shadow:inset 0 3px 5px rgba(0,0,0,.125);box-shadow:inset 0 3px 5px rgba(0,0,0,.125)}.btn.disabled,.btn[disabled],fieldset[disabled] .btn{cursor:not-allowed;pointer-events:none;opacity:.65;filter:alpha(opacity=65);-webkit-box-shadow:none;box-shadow:none}.btn-default{color:#fff;background-color:#4e5d6c;border-color:transparent}.btn-default.active,.btn-default.focus,.btn-default:active,.btn-default:focus,.btn-default:hover,.open>.dropdown-toggle.btn-default{color:#fff;background-color:#39444e;border-color:transparent}.btn-default.active,.btn-default:active,.open>.dropdown-toggle.btn-default{background-image:none}.btn-default.disabled,.btn-default.disabled.active,.btn-default.disabled.focus,.btn-default.disabled:active,.btn-default.disabled:focus,.btn-default.disabled:hover,.btn-default[disabled],.btn-default[disabled].active,.btn-default[disabled].focus,.btn-default[disabled]:active,.btn-default[disabled]:focus,.btn-default[disabled]:hover,fieldset[disabled] .btn-default,fieldset[disabled] .btn-default.active,fieldset[disabled] .btn-default.focus,fieldset[disabled] .btn-default:active,fieldset[disabled] .btn-default:focus,fieldset[disabled] .btn-default:hover{background-color:#4e5d6c;border-color:transparent}.btn-default .badge{color:#4e5d6c;background-color:#fff}.btn-primary{color:#fff;background-color:#df691a;border-color:transparent}.btn-primary.active,.btn-primary.focus,.btn-primary:active,.btn-primary:focus,.btn-primary:hover,.open>.dropdown-toggle.btn-primary{color:#fff;background-color:#b15315;border-color:transparent}.btn-primary.active,.btn-primary:active,.open>.dropdown-toggle.btn-primary{background-image:none}.btn-primary.disabled,.btn-primary.disabled.active,.btn-primary.disabled.focus,.btn-primary.disabled:active,.btn-primary.disabled:focus,.btn-primary.disabled:hover,.btn-primary[disabled],.btn-primary[disabled].active,.btn-primary[disabled].focus,.btn-primary[disabled]:active,.btn-primary[disabled]:focus,.btn-primary[disabled]:hover,fieldset[disabled] .btn-primary,fieldset[disabled] .btn-primary.active,fieldset[disabled] .btn-primary.focus,fieldset[disabled] .btn-primary:active,fieldset[disabled] .btn-primary:focus,fieldset[disabled] .btn-primary:hover{background-color:#df691a;border-color:transparent}.btn-primary .badge{color:#df691a;background-color:#fff}.btn-success{color:#fff;background-color:#5cb85c;border-color:transparent}.btn-success.active,.btn-success.focus,.btn-success:active,.btn-success:focus,.btn-success:hover,.open>.dropdown-toggle.btn-success{color:#fff;background-color:#449d44;border-color:transparent}.btn-success.active,.btn-success:active,.open>.dropdown-toggle.btn-success{background-image:none}.btn-success.disabled,.btn-success.disabled.active,.btn-success.disabled.focus,.btn-success.disabled:active,.btn-success.disabled:focus,.btn-success.disabled:hover,.btn-success[disabled],.btn-success[disabled].active,.btn-success[disabled].focus,.btn-success[disabled]:active,.btn-success[disabled]:focus,.btn-success[disabled]:hover,fieldset[disabled] .btn-success,fieldset[disabled] .btn-success.active,fieldset[disabled] .btn-success.focus,fieldset[disabled] .btn-success:active,fieldset[disabled] .btn-success:focus,fieldset[disabled] .btn-success:hover{background-color:#5cb85c;border-color:transparent}.btn-success .badge{color:#5cb85c;background-color:#fff}.btn-info{color:#fff;background-color:#5bc0de;border-color:transparent}.btn-info.active,.btn-info.focus,.btn-info:active,.btn-info:focus,.btn-info:hover,.open>.dropdown-toggle.btn-info{color:#fff;background-color:#31b0d5;border-color:transparent}.btn-info.active,.btn-info:active,.open>.dropdown-toggle.btn-info{background-image:none}.btn-info.disabled,.btn-info.disabled.active,.btn-info.disabled.focus,.btn-info.disabled:active,.btn-info.disabled:focus,.btn-info.disabled:hover,.btn-info[disabled],.btn-info[disabled].active,.btn-info[disabled].focus,.btn-info[disabled]:active,.btn-info[disabled]:focus,.btn-info[disabled]:hover,fieldset[disabled] .btn-info,fieldset[disabled] .btn-info.active,fieldset[disabled] .btn-info.focus,fieldset[disabled] .btn-info:active,fieldset[disabled] .btn-info:focus,fieldset[disabled] .btn-info:hover{background-color:#5bc0de;border-color:transparent}.btn-info .badge{color:#5bc0de;background-color:#fff}.btn-warning{color:#fff;background-color:#f0ad4e;border-color:transparent}.btn-warning.active,.btn-warning.focus,.btn-warning:active,.btn-warning:focus,.btn-warning:hover,.open>.dropdown-toggle.btn-warning{color:#fff;background-color:#ec971f;border-color:transparent}.btn-warning.active,.btn-warning:active,.open>.dropdown-toggle.btn-warning{background-image:none}.btn-warning.disabled,.btn-warning.disabled.active,.btn-warning.disabled.focus,.btn-warning.disabled:active,.btn-warning.disabled:focus,.btn-warning.disabled:hover,.btn-warning[disabled],.btn-warning[disabled].active,.btn-warning[disabled].focus,.btn-warning[disabled]:active,.btn-warning[disabled]:focus,.btn-warning[disabled]:hover,fieldset[disabled] .btn-warning,fieldset[disabled] .btn-warning.active,fieldset[disabled] .btn-warning.focus,fieldset[disabled] .btn-warning:active,fieldset[disabled] .btn-warning:focus,fieldset[disabled] .btn-warning:hover{background-color:#f0ad4e;border-color:transparent}.btn-warning .badge{color:#f0ad4e;background-color:#fff}.btn-danger{color:#fff;background-color:#d9534f;border-color:transparent}.btn-danger.active,.btn-danger.focus,.btn-danger:active,.btn-danger:focus,.btn-danger:hover,.open>.dropdown-toggle.btn-danger{color:#fff;background-color:#c9302c;border-color:transparent}.btn-danger.active,.btn-danger:active,.open>.dropdown-toggle.btn-danger{background-image:none}.btn-danger.disabled,.btn-danger.disabled.active,.btn-danger.disabled.focus,.btn-danger.disabled:active,.btn-danger.disabled:focus,.btn-danger.disabled:hover,.btn-danger[disabled],.btn-danger[disabled].active,.btn-danger[disabled].focus,.btn-danger[disabled]:active,.btn-danger[disabled]:focus,.btn-danger[disabled]:hover,fieldset[disabled] .btn-danger,fieldset[disabled] .btn-danger.active,fieldset[disabled] .btn-danger.focus,fieldset[disabled] .btn-danger:active,fieldset[disabled] .btn-danger:focus,fieldset[disabled] .btn-danger:hover{background-color:#d9534f;border-color:transparent}.btn-danger .badge{color:#d9534f;background-color:#fff}.btn-link{color:#df691a;font-weight:400;border-radius:0}.btn-link,.btn-link.active,.btn-link:active,.btn-link[disabled],fieldset[disabled] .btn-link{background-color:transparent;-webkit-box-shadow:none;box-shadow:none}.btn-link,.btn-link:active,.btn-link:focus,.btn-link:hover{border-color:transparent}.btn-link:focus,.btn-link:hover{color:#df691a;text-decoration:underline;background-color:transparent}.btn-link[disabled]:focus,.btn-link[disabled]:hover,fieldset[disabled] .btn-link:focus,fieldset[disabled] .btn-link:hover{color:#4e5d6c;text-decoration:none}.btn-group-lg>.btn,.btn-lg{padding:12px 24px;font-size:19px;line-height:1.3333333;border-radius:0}.btn-group-sm>.btn,.btn-sm{padding:5px 10px;font-size:13px;line-height:1.5;border-radius:0}.btn-group-xs>.btn,.btn-xs{padding:1px 5px;font-size:13px;line-height:1.5;border-radius:0}.btn-block{display:block;width:100%}.btn-block+.btn-block{margin-top:5px}input[type=button].btn-block,input[type=reset].btn-block,input[type=submit].btn-block{width:100%}.fade{opacity:0;-webkit-transition:opacity .15s linear;-o-transition:opacity .15s linear;transition:opacity .15s linear}.fade.in{opacity:1}.collapse{display:none}.collapse.in{display:block}tr.collapse.in{display:table-row}tbody.collapse.in{display:table-row-group}.collapsing{position:relative;height:0;overflow:hidden;-webkit-transition-property:height,visibility;-o-transition-property:height,visibility;transition-property:height,visibility;-webkit-transition-duration:.35s;-o-transition-duration:.35s;transition-duration:.35s;-webkit-transition-timing-function:ease;-o-transition-timing-function:ease;transition-timing-function:ease}.caret{display:inline-block;width:0;height:0;margin-left:2px;vertical-align:middle;border-top:4px dashed;border-right:4px solid transparent;border-left:4px solid transparent}.dropdown,.dropup{position:relative}.dropdown-toggle:focus{outline:0}.dropdown-menu{position:absolute;top:100%;left:0;z-index:1000;display:none;float:left;min-width:160px;padding:5px 0;list-style:none;font-size:15px;text-align:left;background-color:#4e5d6c;border-radius:0;-webkit-background-clip:padding-box;background-clip:padding-box}.dropdown-menu.pull-right{right:0;left:auto}.dropdown-menu .divider{height:1px;margin:9.5px 0;overflow:hidden;background-color:#2b3e50}.dropdown-menu>li>a{display:block;padding:3px 20px;clear:both;line-height:1.42857143;color:#ebebeb;white-space:nowrap}.dropdown-menu>li>a:focus,.dropdown-menu>li>a:hover{text-decoration:none;color:#ebebeb;background-color:#485563}.dropdown-menu>.active>a,.dropdown-menu>.active>a:focus,.dropdown-menu>.active>a:hover{color:#fff;text-decoration:none;outline:0;background-color:#df691a}.dropdown-menu>.disabled>a,.dropdown-menu>.disabled>a:focus,.dropdown-menu>.disabled>a:hover{color:#2b3e50}.dropdown-menu>.disabled>a:focus,.dropdown-menu>.disabled>a:hover{text-decoration:none;background-color:transparent;background-image:none;filter:progid:DXImageTransform.Microsoft.gradient(enabled=false);cursor:not-allowed}.open>.dropdown-menu{display:block}.open>a{outline:0}.dropdown-menu-right{left:auto;right:0}.dropdown-menu-left{left:0;right:auto}.dropdown-header{display:block;padding:3px 20px;line-height:1.42857143;color:#2b3e50;white-space:nowrap}.dropdown-backdrop{position:fixed;left:0;right:0;bottom:0;top:0;z-index:990}.pull-right>.dropdown-menu{right:0;left:auto}.dropup .caret,.navbar-fixed-bottom .dropdown .caret{border-top:0;border-bottom:4px solid;content:""}.dropup .dropdown-menu,.navbar-fixed-bottom .dropdown .dropdown-menu{top:auto;bottom:100%;margin-bottom:2px}@media (min-width:768px){.navbar-right .dropdown-menu{left:auto;right:0}.navbar-right .dropdown-menu-left{left:0;right:auto}}.btn-group,.btn-group-vertical{position:relative;display:inline-block;vertical-align:middle}.btn-group-vertical>.btn,.btn-group>.btn{position:relative;float:left}.btn-group-vertical>.btn.active,.btn-group-vertical>.btn:active,.btn-group-vertical>.btn:focus,.btn-group-vertical>.btn:hover,.btn-group>.btn.active,.btn-group>.btn:active,.btn-group>.btn:focus,.btn-group>.btn:hover{z-index:2}.btn-group .btn+.btn,.btn-group .btn+.btn-group,.btn-group .btn-group+.btn,.btn-group .btn-group+.btn-group{margin-left:-1px}.btn-toolbar{margin-left:-5px}.btn-toolbar .btn-group,.btn-toolbar .input-group{float:left}.btn-toolbar>.btn,.btn-toolbar>.btn-group,.btn-toolbar>.input-group{margin-left:5px}.btn-group>.btn:not(:first-child):not(:last-child):not(.dropdown-toggle){border-radius:0}.btn-group>.btn:first-child{margin-left:0}.btn-group>.btn:first-child:not(:last-child):not(.dropdown-toggle){border-bottom-right-radius:0;border-top-right-radius:0}.btn-group>.btn:last-child:not(:first-child),.btn-group>.dropdown-toggle:not(:first-child){border-bottom-left-radius:0;border-top-left-radius:0}.btn-group>.btn-group{float:left}.btn-group>.btn-group:not(:first-child):not(:last-child)>.btn{border-radius:0}.btn-group>.btn-group:first-child:not(:last-child)>.btn:last-child,.btn-group>.btn-group:first-child:not(:last-child)>.dropdown-toggle{border-bottom-right-radius:0;border-top-right-radius:0}.btn-group>.btn-group:last-child:not(:first-child)>.btn:first-child{border-bottom-left-radius:0;border-top-left-radius:0}.btn-group .dropdown-toggle:active,.btn-group.open .dropdown-toggle{outline:0}.btn-group>.btn+.dropdown-toggle{padding-left:8px;padding-right:8px}.btn-group>.btn-lg+.dropdown-toggle{padding-left:12px;padding-right:12px}.btn-group.open .dropdown-toggle.btn-link{-webkit-box-shadow:none;box-shadow:none}.btn .caret{margin-left:0}.btn-lg .caret{border-width:5px 5px 0}.dropup .btn-lg .caret{border-width:0 5px 5px}.btn-group-vertical>.btn,.btn-group-vertical>.btn-group,.btn-group-vertical>.btn-group>.btn{display:block;float:none;width:100%;max-width:100%}.btn-group-vertical>.btn-group>.btn{float:none}.btn-group-vertical>.btn+.btn,.btn-group-vertical>.btn+.btn-group,.btn-group-vertical>.btn-group+.btn,.btn-group-vertical>.btn-group+.btn-group{margin-top:-1px;margin-left:0}.btn-group-vertical>.btn:not(:first-child):not(:last-child){border-radius:0}.btn-group-vertical>.btn:first-child:not(:last-child){border-top-right-radius:0;border-bottom-right-radius:0;border-bottom-left-radius:0}.btn-group-vertical>.btn:last-child:not(:first-child){border-bottom-left-radius:0;border-top-right-radius:0;border-top-left-radius:0}.btn-group-vertical>.btn-group:not(:first-child):not(:last-child)>.btn{border-radius:0}.btn-group-vertical>.btn-group:first-child:not(:last-child)>.btn:last-child,.btn-group-vertical>.btn-group:first-child:not(:last-child)>.dropdown-toggle{border-bottom-right-radius:0;border-bottom-left-radius:0}.btn-group-vertical>.btn-group:last-child:not(:first-child)>.btn:first-child{border-top-right-radius:0;border-top-left-radius:0}.btn-group-justified{display:table;width:100%;table-layout:fixed;border-collapse:separate}.btn-group-justified>.btn,.btn-group-justified>.btn-group{float:none;display:table-cell;width:1%}.btn-group-justified>.btn-group .btn{width:100%}.btn-group-justified>.btn-group .dropdown-menu{left:auto}[data-toggle=buttons]>.btn input[type=checkbox],[data-toggle=buttons]>.btn input[type=radio],[data-toggle=buttons]>.btn-group>.btn input[type=checkbox],[data-toggle=buttons]>.btn-group>.btn input[type=radio]{position:absolute;clip:rect(0,0,0,0);pointer-events:none}.input-group{position:relative;display:table;border-collapse:separate}.input-group[class*=col-]{float:none;padding-left:0;padding-right:0}.input-group .form-control{position:relative;z-index:2;float:left;width:100%;margin-bottom:0}.input-group-lg>.form-control,.input-group-lg>.input-group-addon,.input-group-lg>.input-group-btn>.btn{height:52px;padding:12px 24px;font-size:19px;line-height:1.3333333;border-radius:0}select.input-group-lg>.form-control,select.input-group-lg>.input-group-addon,select.input-group-lg>.input-group-btn>.btn{height:52px;line-height:52px}select[multiple].input-group-lg>.form-control,select[multiple].input-group-lg>.input-group-addon,select[multiple].input-group-lg>.input-group-btn>.btn,textarea.input-group-lg>.form-control,textarea.input-group-lg>.input-group-addon,textarea.input-group-lg>.input-group-btn>.btn{height:auto}.input-group-sm>.form-control,.input-group-sm>.input-group-addon,.input-group-sm>.input-group-btn>.btn{height:31px;padding:5px 10px;font-size:13px;line-height:1.5;border-radius:0}select.input-group-sm>.form-control,select.input-group-sm>.input-group-addon,select.input-group-sm>.input-group-btn>.btn{height:31px;line-height:31px}select[multiple].input-group-sm>.form-control,select[multiple].input-group-sm>.input-group-addon,select[multiple].input-group-sm>.input-group-btn>.btn,textarea.input-group-sm>.form-control,textarea.input-group-sm>.input-group-addon,textarea.input-group-sm>.input-group-btn>.btn{height:auto}.input-group .form-control,.input-group-addon,.input-group-btn{display:table-cell}.input-group .form-control:not(:first-child):not(:last-child),.input-group-addon:not(:first-child):not(:last-child),.input-group-btn:not(:first-child):not(:last-child){border-radius:0}.input-group-addon,.input-group-btn{width:1%;white-space:nowrap;vertical-align:middle}.input-group-addon{padding:8px 16px;font-size:15px;font-weight:400;line-height:1;text-align:center;background-color:#4e5d6c;border:1px solid transparent;border-radius:0}.input-group-addon.input-sm{padding:5px 10px;font-size:13px;border-radius:0}.input-group-addon.input-lg{padding:12px 24px;font-size:19px;border-radius:0}.input-group-addon input[type=checkbox],.input-group-addon input[type=radio]{margin-top:0}.input-group .form-control:first-child,.input-group-addon:first-child,.input-group-btn:first-child>.btn,.input-group-btn:first-child>.btn-group>.btn,.input-group-btn:first-child>.dropdown-toggle,.input-group-btn:last-child>.btn-group:not(:last-child)>.btn,.input-group-btn:last-child>.btn:not(:last-child):not(.dropdown-toggle){border-bottom-right-radius:0;border-top-right-radius:0}.input-group-addon:first-child{border-right:0}.input-group .form-control:last-child,.input-group-addon:last-child,.input-group-btn:first-child>.btn-group:not(:first-child)>.btn,.input-group-btn:first-child>.btn:not(:first-child),.input-group-btn:last-child>.btn,.input-group-btn:last-child>.btn-group>.btn,.input-group-btn:last-child>.dropdown-toggle{border-bottom-left-radius:0;border-top-left-radius:0}.input-group-addon:last-child{border-left:0}.input-group-btn{position:relative;font-size:0;white-space:nowrap}.input-group-btn>.btn{position:relative}.input-group-btn>.btn+.btn{margin-left:-1px}.input-group-btn>.btn:active,.input-group-btn>.btn:focus,.input-group-btn>.btn:hover{z-index:2}.input-group-btn:first-child>.btn,.input-group-btn:first-child>.btn-group{margin-right:-1px}.input-group-btn:last-child>.btn,.input-group-btn:last-child>.btn-group{margin-left:-1px}.nav{margin-bottom:0;padding-left:0;list-style:none}.nav>li{position:relative;display:block}.nav>li>a{position:relative;display:block;padding:10px 15px}.nav>li>a:focus,.nav>li>a:hover{text-decoration:none;background-color:#4e5d6c}.nav>li.disabled>a{color:#4e5d6c}.nav>li.disabled>a:focus,.nav>li.disabled>a:hover{color:#4e5d6c;text-decoration:none;background-color:transparent;cursor:not-allowed}.nav .open>a,.nav .open>a:focus,.nav .open>a:hover{background-color:#4e5d6c}.nav .nav-divider{height:1px;margin:9.5px 0;overflow:hidden;background-color:#e5e5e5}.nav>li>a>img{max-width:none}.nav-tabs{border-bottom:1px solid transparent}.nav-tabs>li{float:left;margin-bottom:-1px}.nav-tabs>li>a{margin-right:2px;line-height:1.42857143;border:1px solid transparent;border-radius:0}.nav-tabs>li>a:hover{border-color:#4e5d6c #4e5d6c transparent}.nav-tabs>li.active>a,.nav-tabs>li.active>a:focus,.nav-tabs>li.active>a:hover{color:#ebebeb;background-color:#2b3e50;border:1px solid #4e5d6c;border-bottom-color:transparent;cursor:default}.nav-tabs.nav-justified{width:100%;border-bottom:0}.nav-tabs.nav-justified>li{float:none}.nav-tabs.nav-justified>li>a{text-align:center;margin-bottom:5px}.nav-tabs.nav-justified>.dropdown .dropdown-menu{top:auto;left:auto}@media (min-width:768px){.nav-tabs.nav-justified>li{display:table-cell;width:1%}.nav-tabs.nav-justified>li>a{margin-bottom:0}}.nav-tabs.nav-justified>li>a{margin-right:0;border-radius:0}.nav-tabs.nav-justified>.active>a,.nav-tabs.nav-justified>.active>a:focus,.nav-tabs.nav-justified>.active>a:hover{border:1px solid #4e5d6c}@media (min-width:768px){.nav-tabs.nav-justified>li>a{border-bottom:1px solid #4e5d6c;border-radius:0}.nav-tabs.nav-justified>.active>a,.nav-tabs.nav-justified>.active>a:focus,.nav-tabs.nav-justified>.active>a:hover{border-bottom-color:#4e5d6c}}.nav-pills>li{float:left}.nav-pills>li>a{border-radius:0}.nav-pills>li+li{margin-left:2px}.nav-pills>li.active>a,.nav-pills>li.active>a:focus,.nav-pills>li.active>a:hover{color:#fff;background-color:#df691a}.nav-stacked>li{float:none}.nav-stacked>li+li{margin-top:2px;margin-left:0}.nav-justified{width:100%}.nav-justified>li{float:none}.nav-justified>li>a{text-align:center;margin-bottom:5px}.nav-justified>.dropdown .dropdown-menu{top:auto;left:auto}@media (min-width:768px){.nav-justified>li{display:table-cell;width:1%}.nav-justified>li>a{margin-bottom:0}}.nav-tabs-justified{border-bottom:0}.nav-tabs-justified>li>a{margin-right:0;border-radius:0}.nav-tabs-justified>.active>a,.nav-tabs-justified>.active>a:focus,.nav-tabs-justified>.active>a:hover{border:1px solid #4e5d6c}@media (min-width:768px){.nav-tabs-justified>li>a{border-bottom:1px solid #4e5d6c;border-radius:0}.nav-tabs-justified>.active>a,.nav-tabs-justified>.active>a:focus,.nav-tabs-justified>.active>a:hover{border-bottom-color:#4e5d6c}}.tab-content>.tab-pane{display:none}.tab-content>.active{display:block}.nav-tabs .dropdown-menu{margin-top:-1px;border-top-right-radius:0;border-top-left-radius:0}.navbar{position:relative;min-height:40px;margin-bottom:21px}@media (min-width:768px){.navbar{border-radius:0}}@media (min-width:768px){.navbar-header{float:left}}.navbar-collapse{overflow-x:visible;padding-right:15px;padding-left:15px;border-top:1px solid transparent;-webkit-box-shadow:inset 0 1px 0 rgba(255,255,255,.1);box-shadow:inset 0 1px 0 rgba(255,255,255,.1);-webkit-overflow-scrolling:touch}.navbar-collapse.in{overflow-y:auto}@media (min-width:768px){.navbar-collapse{width:auto;border-top:0;-webkit-box-shadow:none;box-shadow:none}.navbar-collapse.collapse{display:block!important;height:auto!important;padding-bottom:0;overflow:visible!important}.navbar-collapse.in{overflow-y:visible}.navbar-fixed-bottom .navbar-collapse,.navbar-fixed-top .navbar-collapse,.navbar-static-top .navbar-collapse{padding-left:0;padding-right:0}}.navbar-fixed-bottom .navbar-collapse,.navbar-fixed-top .navbar-collapse{max-height:340px}@media (max-device-width:480px) and (orientation:landscape){.navbar-fixed-bottom .navbar-collapse,.navbar-fixed-top .navbar-collapse{max-height:200px}}.container-fluid>.navbar-collapse,.container-fluid>.navbar-header,.container>.navbar-collapse,.container>.navbar-header{margin-right:-15px;margin-left:-15px}@media (min-width:768px){.container-fluid>.navbar-collapse,.container-fluid>.navbar-header,.container>.navbar-collapse,.container>.navbar-header{margin-right:0;margin-left:0}}.navbar-static-top{z-index:1000;border-width:0 0 1px}@media (min-width:768px){.navbar-static-top{border-radius:0}}.navbar-fixed-bottom,.navbar-fixed-top{position:fixed;right:0;left:0;z-index:1030}@media (min-width:768px){.navbar-fixed-bottom,.navbar-fixed-top{border-radius:0}}.navbar-fixed-top{top:0;border-width:0 0 1px}.navbar-fixed-bottom{bottom:0;margin-bottom:0;border-width:1px 0 0}.navbar-brand{float:left;padding:9.5px 15px;font-size:19px;line-height:21px;height:40px}.navbar-brand:focus,.navbar-brand:hover{text-decoration:none}.navbar-brand>img{display:block}@media (min-width:768px){.navbar>.container .navbar-brand,.navbar>.container-fluid .navbar-brand{margin-left:-15px}}.navbar-toggle{position:relative;float:right;margin-right:15px;padding:9px 10px;margin-top:3px;margin-bottom:3px;background-color:transparent;background-image:none;border:1px solid transparent;border-radius:0}.navbar-toggle:focus{outline:0}.navbar-toggle .icon-bar{display:block;width:22px;height:2px;border-radius:1px}.navbar-toggle .icon-bar+.icon-bar{margin-top:4px}@media (min-width:768px){.navbar-toggle{display:none}}.navbar-nav{margin:4.75px -15px}.navbar-nav>li>a{padding-top:10px;padding-bottom:10px;line-height:21px}@media (max-width:767px){.navbar-nav .open .dropdown-menu{position:static;float:none;width:auto;margin-top:0;background-color:transparent;border:0;-webkit-box-shadow:none;box-shadow:none}.navbar-nav .open .dropdown-menu .dropdown-header,.navbar-nav .open .dropdown-menu>li>a{padding:5px 15px 5px 25px}.navbar-nav .open .dropdown-menu>li>a{line-height:21px}.navbar-nav .open .dropdown-menu>li>a:focus,.navbar-nav .open .dropdown-menu>li>a:hover{background-image:none}}@media (min-width:768px){.navbar-nav{float:left;margin:0}.navbar-nav>li{float:left}.navbar-nav>li>a{padding-top:9.5px;padding-bottom:9.5px}}.navbar-form{margin:.5px -15px;padding:10px 15px;border-top:1px solid transparent;border-bottom:1px solid transparent;-webkit-box-shadow:inset 0 1px 0 rgba(255,255,255,.1),0 1px 0 rgba(255,255,255,.1);box-shadow:inset 0 1px 0 rgba(255,255,255,.1),0 1px 0 rgba(255,255,255,.1)}@media (min-width:768px){.navbar-form .form-group{display:inline-block;margin-bottom:0;vertical-align:middle}.navbar-form .form-control{display:inline-block;width:auto;vertical-align:middle}.navbar-form .form-control-static{display:inline-block}.navbar-form .input-group{display:inline-table;vertical-align:middle}.navbar-form .input-group .form-control,.navbar-form .input-group .input-group-addon,.navbar-form .input-group .input-group-btn{width:auto}.navbar-form .input-group>.form-control{width:100%}.navbar-form .control-label{margin-bottom:0;vertical-align:middle}.navbar-form .checkbox,.navbar-form .radio{display:inline-block;margin-top:0;margin-bottom:0;vertical-align:middle}.navbar-form .checkbox label,.navbar-form .radio label{padding-left:0}.navbar-form .checkbox input[type=checkbox],.navbar-form .radio input[type=radio]{position:relative;margin-left:0}.navbar-form .has-feedback .form-control-feedback{top:0}}@media (max-width:767px){.navbar-form .form-group{margin-bottom:5px}.navbar-form .form-group:last-child{margin-bottom:0}}@media (min-width:768px){.navbar-form{width:auto;border:0;margin-left:0;margin-right:0;padding-top:0;padding-bottom:0;-webkit-box-shadow:none;box-shadow:none}}.navbar-nav>li>.dropdown-menu{margin-top:0;border-top-right-radius:0;border-top-left-radius:0}.navbar-fixed-bottom .navbar-nav>li>.dropdown-menu{margin-bottom:0;border-radius:0}.navbar-btn{margin-top:.5px;margin-bottom:.5px}.navbar-btn.btn-sm{margin-top:4.5px;margin-bottom:4.5px}.navbar-btn.btn-xs{margin-top:9px;margin-bottom:9px}.navbar-text{margin-top:9.5px;margin-bottom:9.5px}@media (min-width:768px){.navbar-text{float:left;margin-left:15px;margin-right:15px}}@media (min-width:768px){.navbar-left{float:left!important}.navbar-right{float:right!important;margin-right:-15px}.navbar-right~.navbar-right{margin-right:0}}.navbar-default{background-color:#4e5d6c;border-color:transparent}.navbar-default .navbar-brand{color:#ebebeb}.navbar-default .navbar-brand:focus,.navbar-default .navbar-brand:hover{color:#ebebeb;background-color:transparent}.navbar-default .navbar-nav>li>a,.navbar-default .navbar-text{color:#ebebeb}.navbar-default .navbar-nav>.active>a,.navbar-default .navbar-nav>.active>a:focus,.navbar-default .navbar-nav>.active>a:hover,.navbar-default .navbar-nav>li>a:focus,.navbar-default .navbar-nav>li>a:hover{color:#ebebeb;background-color:#485563}.navbar-default .navbar-nav>.disabled>a,.navbar-default .navbar-nav>.disabled>a:focus,.navbar-default .navbar-nav>.disabled>a:hover{color:#ccc;background-color:transparent}.navbar-default .navbar-toggle{border-color:transparent}.navbar-default .navbar-toggle:focus,.navbar-default .navbar-toggle:hover{background-color:#485563}.navbar-default .navbar-toggle .icon-bar{background-color:#ebebeb}.navbar-default .navbar-collapse,.navbar-default .navbar-form{border-color:transparent}.navbar-default .navbar-nav>.open>a,.navbar-default .navbar-nav>.open>a:focus,.navbar-default .navbar-nav>.open>a:hover{background-color:#485563;color:#ebebeb}@media (max-width:767px){.navbar-default .navbar-nav .open .dropdown-menu>li>a{color:#ebebeb}.navbar-default .navbar-nav .open .dropdown-menu>.active>a,.navbar-default .navbar-nav .open .dropdown-menu>.active>a:focus,.navbar-default .navbar-nav .open .dropdown-menu>.active>a:hover,.navbar-default .navbar-nav .open .dropdown-menu>li>a:focus,.navbar-default .navbar-nav .open .dropdown-menu>li>a:hover{color:#ebebeb;background-color:#485563}.navbar-default .navbar-nav .open .dropdown-menu>.disabled>a,.navbar-default .navbar-nav .open .dropdown-menu>.disabled>a:focus,.navbar-default .navbar-nav .open .dropdown-menu>.disabled>a:hover{color:#ccc;background-color:transparent}}.navbar-default .btn-link,.navbar-default .btn-link:focus,.navbar-default .btn-link:hover,.navbar-default .navbar-link,.navbar-default .navbar-link:hover{color:#ebebeb}.navbar-default .btn-link[disabled]:focus,.navbar-default .btn-link[disabled]:hover,fieldset[disabled] .navbar-default .btn-link:focus,fieldset[disabled] .navbar-default .btn-link:hover{color:#ccc}.navbar-inverse{background-color:#df691a;border-color:transparent}.navbar-inverse .navbar-brand{color:#ebebeb}.navbar-inverse .navbar-brand:focus,.navbar-inverse .navbar-brand:hover{color:#ebebeb;background-color:transparent}.navbar-inverse .navbar-nav>li>a,.navbar-inverse .navbar-text{color:#ebebeb}.navbar-inverse .navbar-nav>.active>a,.navbar-inverse .navbar-nav>.active>a:focus,.navbar-inverse .navbar-nav>.active>a:hover,.navbar-inverse .navbar-nav>li>a:focus,.navbar-inverse .navbar-nav>li>a:hover{color:#ebebeb;background-color:#c85e17}.navbar-inverse .navbar-nav>.disabled>a,.navbar-inverse .navbar-nav>.disabled>a:focus,.navbar-inverse .navbar-nav>.disabled>a:hover{color:#444;background-color:transparent}.navbar-inverse .navbar-toggle{border-color:transparent}.navbar-inverse .navbar-toggle:focus,.navbar-inverse .navbar-toggle:hover{background-color:#c85e17}.navbar-inverse .navbar-toggle .icon-bar{background-color:#ebebeb}.navbar-inverse .navbar-collapse,.navbar-inverse .navbar-form{border-color:#bf5a16}.navbar-inverse .navbar-nav>.open>a,.navbar-inverse .navbar-nav>.open>a:focus,.navbar-inverse .navbar-nav>.open>a:hover{background-color:#c85e17;color:#ebebeb}@media (max-width:767px){.navbar-inverse .navbar-nav .open .dropdown-menu>.dropdown-header{border-color:transparent}.navbar-inverse .navbar-nav .open .dropdown-menu .divider{background-color:transparent}.navbar-inverse .navbar-nav .open .dropdown-menu>li>a{color:#ebebeb}.navbar-inverse .navbar-nav .open .dropdown-menu>.active>a,.navbar-inverse .navbar-nav .open .dropdown-menu>.active>a:focus,.navbar-inverse .navbar-nav .open .dropdown-menu>.active>a:hover,.navbar-inverse .navbar-nav .open .dropdown-menu>li>a:focus,.navbar-inverse .navbar-nav .open .dropdown-menu>li>a:hover{color:#ebebeb;background-color:#c85e17}.navbar-inverse .navbar-nav .open .dropdown-menu>.disabled>a,.navbar-inverse .navbar-nav .open .dropdown-menu>.disabled>a:focus,.navbar-inverse .navbar-nav .open .dropdown-menu>.disabled>a:hover{color:#444;background-color:transparent}}.navbar-inverse .btn-link,.navbar-inverse .btn-link:focus,.navbar-inverse .btn-link:hover,.navbar-inverse .navbar-link,.navbar-inverse .navbar-link:hover{color:#ebebeb}.navbar-inverse .btn-link[disabled]:focus,.navbar-inverse .btn-link[disabled]:hover,fieldset[disabled] .navbar-inverse .btn-link:focus,fieldset[disabled] .navbar-inverse .btn-link:hover{color:#444}.breadcrumb{padding:8px 15px;margin-bottom:21px;list-style:none;background-color:#4e5d6c;border-radius:0}.breadcrumb>li{display:inline-block}.breadcrumb>li+li:before{content:"/\00a0";padding:0 5px;color:#ebebeb}.breadcrumb>.active{color:#ebebeb}.pagination{display:inline-block;padding-left:0;margin:21px 0;border-radius:0}.pagination>li{display:inline}.pagination>li>a,.pagination>li>span{position:relative;float:left;padding:8px 16px;line-height:1.42857143;text-decoration:none;color:#ebebeb;background-color:#4e5d6c;border:1px solid transparent;margin-left:-1px}.pagination>li:first-child>a,.pagination>li:first-child>span{margin-left:0;border-bottom-left-radius:0;border-top-left-radius:0}.pagination>li:last-child>a,.pagination>li:last-child>span{border-bottom-right-radius:0;border-top-right-radius:0}.pagination>li>a:focus,.pagination>li>a:hover,.pagination>li>span:focus,.pagination>li>span:hover{color:#ebebeb;background-color:#485563;border-color:transparent}.pagination>.active>a,.pagination>.active>a:focus,.pagination>.active>a:hover,.pagination>.active>span,.pagination>.active>span:focus,.pagination>.active>span:hover{z-index:2;color:#ebebeb;background-color:#df691a;border-color:transparent;cursor:default}.pagination>.disabled>a,.pagination>.disabled>a:focus,.pagination>.disabled>a:hover,.pagination>.disabled>span,.pagination>.disabled>span:focus,.pagination>.disabled>span:hover{color:#323c46;background-color:#4e5d6c;border-color:transparent;cursor:not-allowed}.pagination-lg>li>a,.pagination-lg>li>span{padding:12px 24px;font-size:19px}.pagination-lg>li:first-child>a,.pagination-lg>li:first-child>span{border-bottom-left-radius:0;border-top-left-radius:0}.pagination-lg>li:last-child>a,.pagination-lg>li:last-child>span{border-bottom-right-radius:0;border-top-right-radius:0}.pagination-sm>li>a,.pagination-sm>li>span{padding:5px 10px;font-size:13px}.pagination-sm>li:first-child>a,.pagination-sm>li:first-child>span{border-bottom-left-radius:0;border-top-left-radius:0}.pagination-sm>li:last-child>a,.pagination-sm>li:last-child>span{border-bottom-right-radius:0;border-top-right-radius:0}.pager{padding-left:0;margin:21px 0;list-style:none;text-align:center}.pager li{display:inline}.pager li>a,.pager li>span{display:inline-block;padding:5px 14px;background-color:#4e5d6c;border:1px solid transparent;border-radius:15px}.pager li>a:focus,.pager li>a:hover{text-decoration:none;background-color:#485563}.pager .next>a,.pager .next>span{float:right}.pager .previous>a,.pager .previous>span{float:left}.pager .disabled>a,.pager .disabled>a:focus,.pager .disabled>a:hover,.pager .disabled>span{color:#323c46;background-color:#4e5d6c;cursor:not-allowed}.label{display:inline;padding:.2em .6em .3em;font-size:75%;line-height:1;color:#fff;text-align:center;white-space:nowrap;vertical-align:baseline;border-radius:.25em}a.label:focus,a.label:hover{color:#fff;text-decoration:none;cursor:pointer}.label:empty{display:none}.btn .label{position:relative;top:-1px}.label-default{background-color:#4e5d6c}.label-default[href]:focus,.label-default[href]:hover{background-color:#39444e}.label-primary{background-color:#df691a}.label-primary[href]:focus,.label-primary[href]:hover{background-color:#b15315}.label-success{background-color:#5cb85c}.label-success[href]:focus,.label-success[href]:hover{background-color:#449d44}.label-info{background-color:#5bc0de}.label-info[href]:focus,.label-info[href]:hover{background-color:#31b0d5}.label-warning{background-color:#f0ad4e}.label-warning[href]:focus,.label-warning[href]:hover{background-color:#ec971f}.label-danger{background-color:#d9534f}.label-danger[href]:focus,.label-danger[href]:hover{background-color:#c9302c}.badge{display:inline-block;min-width:10px;padding:3px 7px;font-size:13px;font-weight:300;color:#ebebeb;line-height:1;vertical-align:baseline;white-space:nowrap;text-align:center;background-color:#4e5d6c;border-radius:10px}.badge:empty{display:none}.btn .badge{position:relative;top:-1px}.btn-group-xs>.btn .badge,.btn-xs .badge{top:0;padding:1px 5px}a.badge:focus,a.badge:hover{color:#fff;text-decoration:none;cursor:pointer}.list-group-item.active>.badge,.nav-pills>.active>a>.badge{color:#df691a;background-color:#fff}.list-group-item>.badge{float:right}.list-group-item>.badge+.badge{margin-right:5px}.nav-pills>li>a>.badge{margin-left:3px}.jumbotron{padding:30px 15px;margin-bottom:30px;color:inherit;background-color:#4e5d6c}.jumbotron .h1,.jumbotron h1{color:inherit}.jumbotron p{margin-bottom:15px;font-size:23px;font-weight:200}.jumbotron>hr{border-top-color:#39444e}.container .jumbotron,.container-fluid .jumbotron{border-radius:0}.jumbotron .container{max-width:100%}@media screen and (min-width:768px){.jumbotron{padding:48px 0}.container .jumbotron,.container-fluid .jumbotron{padding-left:60px;padding-right:60px}.jumbotron .h1,.jumbotron h1{font-size:67.5px}}.thumbnail{display:block;padding:4px;margin-bottom:21px;line-height:1.42857143;border-radius:0;-webkit-transition:border .2s ease-in-out;-o-transition:border .2s ease-in-out;transition:border .2s ease-in-out}.thumbnail a>img,.thumbnail>img{margin-left:auto;margin-right:auto}a.thumbnail.active,a.thumbnail:focus,a.thumbnail:hover{border-color:#df691a}.thumbnail .caption{padding:9px;color:#ebebeb}.alert{padding:15px;margin-bottom:21px;border:1px solid transparent;border-radius:0}.alert h4{margin-top:0;color:inherit}.alert .alert-link{font-weight:700}.alert>p,.alert>ul{margin-bottom:0}.alert>p+p{margin-top:5px}.alert-dismissable,.alert-dismissible{padding-right:35px}.alert-dismissable .close,.alert-dismissible .close{position:relative;top:-2px;right:-21px;color:inherit}.alert-success{background-color:#5cb85c;border-color:transparent;color:#ebebeb}.alert-success hr{border-top-color:transparent}.alert-success .alert-link{color:#d2d2d2}.alert-info{background-color:#5bc0de;border-color:transparent;color:#ebebeb}.alert-info hr{border-top-color:transparent}.alert-info .alert-link{color:#d2d2d2}.alert-warning{background-color:#f0ad4e;border-color:transparent;color:#ebebeb}.alert-warning hr{border-top-color:transparent}.alert-warning .alert-link{color:#d2d2d2}.alert-danger{background-color:#d9534f;border-color:transparent;color:#ebebeb}.alert-danger hr{border-top-color:transparent}.alert-danger .alert-link{color:#d2d2d2}@-webkit-keyframes progress-bar-stripes{from{background-position:40px 0}to{background-position:0 0}}@-o-keyframes progress-bar-stripes{from{background-position:40px 0}to{background-position:0 0}}@keyframes progress-bar-stripes{from{background-position:40px 0}to{background-position:0 0}}.progress{overflow:hidden;height:21px;margin-bottom:21px;background-color:#4e5d6c;border-radius:0;-webkit-box-shadow:inset 0 1px 2px rgba(0,0,0,.1);box-shadow:inset 0 1px 2px rgba(0,0,0,.1)}.progress-bar{float:left;width:0;height:100%;font-size:13px;line-height:21px;color:#fff;text-align:center;background-color:#df691a;-webkit-box-shadow:inset 0 -1px 0 rgba(0,0,0,.15);box-shadow:inset 0 -1px 0 rgba(0,0,0,.15);-webkit-transition:width .6s ease;-o-transition:width .6s ease;transition:width .6s ease}.progress-bar-striped,.progress-striped .progress-bar{background-image:-webkit-linear-gradient(45deg,rgba(255,255,255,.15) 25%,transparent 25%,transparent 50%,rgba(255,255,255,.15) 50%,rgba(255,255,255,.15) 75%,transparent 75%,transparent);background-image:-o-linear-gradient(45deg,rgba(255,255,255,.15) 25%,transparent 25%,transparent 50%,rgba(255,255,255,.15) 50%,rgba(255,255,255,.15) 75%,transparent 75%,transparent);background-image:linear-gradient(45deg,rgba(255,255,255,.15) 25%,transparent 25%,transparent 50%,rgba(255,255,255,.15) 50%,rgba(255,255,255,.15) 75%,transparent 75%,transparent);-webkit-background-size:40px 40px;background-size:40px 40px}.progress-bar.active,.progress.active .progress-bar{-webkit-animation:progress-bar-stripes 2s linear infinite;-o-animation:progress-bar-stripes 2s linear infinite;animation:progress-bar-stripes 2s linear infinite}.progress-bar-success{background-color:#5cb85c}.progress-striped .progress-bar-success{background-image:-webkit-linear-gradient(45deg,rgba(255,255,255,.15) 25%,transparent 25%,transparent 50%,rgba(255,255,255,.15) 50%,rgba(255,255,255,.15) 75%,transparent 75%,transparent);background-image:-o-linear-gradient(45deg,rgba(255,255,255,.15) 25%,transparent 25%,transparent 50%,rgba(255,255,255,.15) 50%,rgba(255,255,255,.15) 75%,transparent 75%,transparent);background-image:linear-gradient(45deg,rgba(255,255,255,.15) 25%,transparent 25%,transparent 50%,rgba(255,255,255,.15) 50%,rgba(255,255,255,.15) 75%,transparent 75%,transparent)}.progress-bar-info{background-color:#5bc0de}.progress-striped .progress-bar-info{background-image:-webkit-linear-gradient(45deg,rgba(255,255,255,.15) 25%,transparent 25%,transparent 50%,rgba(255,255,255,.15) 50%,rgba(255,255,255,.15) 75%,transparent 75%,transparent);background-image:-o-linear-gradient(45deg,rgba(255,255,255,.15) 25%,transparent 25%,transparent 50%,rgba(255,255,255,.15) 50%,rgba(255,255,255,.15) 75%,transparent 75%,transparent);background-image:linear-gradient(45deg,rgba(255,255,255,.15) 25%,transparent 25%,transparent 50%,rgba(255,255,255,.15) 50%,rgba(255,255,255,.15) 75%,transparent 75%,transparent)}.progress-bar-warning{background-color:#f0ad4e}.progress-striped .progress-bar-warning{background-image:-webkit-linear-gradient(45deg,rgba(255,255,255,.15) 25%,transparent 25%,transparent 50%,rgba(255,255,255,.15) 50%,rgba(255,255,255,.15) 75%,transparent 75%,transparent);background-image:-o-linear-gradient(45deg,rgba(255,255,255,.15) 25%,transparent 25%,transparent 50%,rgba(255,255,255,.15) 50%,rgba(255,255,255,.15) 75%,transparent 75%,transparent);background-image:linear-gradient(45deg,rgba(255,255,255,.15) 25%,transparent 25%,transparent 50%,rgba(255,255,255,.15) 50%,rgba(255,255,255,.15) 75%,transparent 75%,transparent)}.progress-bar-danger{background-color:#d9534f}.progress-striped .progress-bar-danger{background-image:-webkit-linear-gradient(45deg,rgba(255,255,255,.15) 25%,transparent 25%,transparent 50%,rgba(255,255,255,.15) 50%,rgba(255,255,255,.15) 75%,transparent 75%,transparent);background-image:-o-linear-gradient(45deg,rgba(255,255,255,.15) 25%,transparent 25%,transparent 50%,rgba(255,255,255,.15) 50%,rgba(255,255,255,.15) 75%,transparent 75%,transparent);background-image:linear-gradient(45deg,rgba(255,255,255,.15) 25%,transparent 25%,transparent 50%,rgba(255,255,255,.15) 50%,rgba(255,255,255,.15) 75%,transparent 75%,transparent)}.media{margin-top:15px}.media:first-child{margin-top:0}.media,.media-body{zoom:1;overflow:hidden}.media-body{width:10000px}.media-object{display:block}.media-right,.media>.pull-right{padding-left:10px}.media-left,.media>.pull-left{padding-right:10px}.media-body,.media-left,.media-right{display:table-cell;vertical-align:top}.media-middle{vertical-align:middle}.media-bottom{vertical-align:bottom}.media-heading{margin-top:0;margin-bottom:5px}.media-list{padding-left:0;list-style:none}.list-group{margin-bottom:20px;padding-left:0}.list-group-item{position:relative;display:block;padding:10px 15px;margin-bottom:-1px;background-color:#4e5d6c;border:1px solid transparent}.list-group-item:first-child{border-top-right-radius:0;border-top-left-radius:0}.list-group-item:last-child{margin-bottom:0;border-bottom-right-radius:0;border-bottom-left-radius:0}a.list-group-item,a.list-group-item .list-group-item-heading{color:#ebebeb}a.list-group-item:focus,a.list-group-item:hover{text-decoration:none;color:#ebebeb;background-color:#485563}.list-group-item.disabled,.list-group-item.disabled:focus,.list-group-item.disabled:hover{background-color:#ebebeb;color:#4e5d6c;cursor:not-allowed}.list-group-item.disabled .list-group-item-heading,.list-group-item.disabled:focus .list-group-item-heading,.list-group-item.disabled:hover .list-group-item-heading{color:inherit}.list-group-item.disabled .list-group-item-text,.list-group-item.disabled:focus .list-group-item-text,.list-group-item.disabled:hover .list-group-item-text{color:#4e5d6c}.list-group-item.active,.list-group-item.active:focus,.list-group-item.active:hover{z-index:2;color:#fff;background-color:#df691a;border-color:#df691a}.list-group-item.active .list-group-item-heading,.list-group-item.active .list-group-item-heading>.small,.list-group-item.active .list-group-item-heading>small,.list-group-item.active:focus .list-group-item-heading,.list-group-item.active:focus .list-group-item-heading>.small,.list-group-item.active:focus .list-group-item-heading>small,.list-group-item.active:hover .list-group-item-heading,.list-group-item.active:hover .list-group-item-heading>.small,.list-group-item.active:hover .list-group-item-heading>small{color:inherit}.list-group-item.active .list-group-item-text,.list-group-item.active:focus .list-group-item-text,.list-group-item.active:hover .list-group-item-text{color:#f9decc}.list-group-item-success{color:#ebebeb;background-color:#5cb85c}a.list-group-item-success{color:#ebebeb}a.list-group-item-success .list-group-item-heading{color:inherit}a.list-group-item-success:focus,a.list-group-item-success:hover{color:#ebebeb;background-color:#4cae4c}a.list-group-item-success.active,a.list-group-item-success.active:focus,a.list-group-item-success.active:hover{color:#fff;border-color:#ebebeb}.list-group-item-info{color:#ebebeb;background-color:#5bc0de}a.list-group-item-info{color:#ebebeb}a.list-group-item-info .list-group-item-heading{color:inherit}a.list-group-item-info:focus,a.list-group-item-info:hover{color:#ebebeb;background-color:#46b8da}a.list-group-item-info.active,a.list-group-item-info.active:focus,a.list-group-item-info.active:hover{color:#fff;background-color:#ebebeb;border-color:#ebebeb}.list-group-item-warning{color:#ebebeb;background-color:#f0ad4e}a.list-group-item-warning{color:#ebebeb}a.list-group-item-warning .list-group-item-heading{color:inherit}a.list-group-item-warning:focus,a.list-group-item-warning:hover{color:#ebebeb;background-color:#eea236}a.list-group-item-warning.active,a.list-group-item-warning.active:focus,a.list-group-item-warning.active:hover{color:#fff;border-color:#ebebeb}.list-group-item-danger{color:#ebebeb;background-color:#d9534f}a.list-group-item-danger{color:#ebebeb}a.list-group-item-danger .list-group-item-heading{color:inherit}a.list-group-item-danger:focus,a.list-group-item-danger:hover{color:#ebebeb;background-color:#d43f3a}a.list-group-item-danger.active,a.list-group-item-danger.active:focus,a.list-group-item-danger.active:hover{color:#fff;border-color:#ebebeb}.list-group-item-heading{margin-top:0;margin-bottom:5px}.list-group-item-text{margin-bottom:0;line-height:1.3}.panel{margin-bottom:21px;background-color:#4e5d6c;border-radius:0;-webkit-box-shadow:0 1px 1px rgba(0,0,0,.05);box-shadow:0 1px 1px rgba(0,0,0,.05)}.panel-body{padding:15px}.panel-heading{padding:10px 15px;border-bottom:1px solid transparent;border-top-right-radius:-1;border-top-left-radius:-1}.panel-heading>.dropdown .dropdown-toggle{color:inherit}.panel-title{margin-top:0;margin-bottom:0;font-size:17px;color:inherit}.panel-title>.small,.panel-title>.small>a,.panel-title>a,.panel-title>small,.panel-title>small>a{color:inherit}.panel-footer{padding:10px 15px;background-color:#485563;border-top:1px solid transparent;border-bottom-right-radius:-1;border-bottom-left-radius:-1}.panel>.list-group,.panel>.panel-collapse>.list-group{margin-bottom:0}.panel>.list-group .list-group-item,.panel>.panel-collapse>.list-group .list-group-item{border-width:1px 0;border-radius:0}.panel>.list-group:first-child .list-group-item:first-child,.panel>.panel-collapse>.list-group:first-child .list-group-item:first-child{border-top:0;border-top-right-radius:-1;border-top-left-radius:-1}.panel>.list-group:last-child .list-group-item:last-child,.panel>.panel-collapse>.list-group:last-child .list-group-item:last-child{border-bottom:0;border-bottom-right-radius:-1;border-bottom-left-radius:-1}.list-group+.panel-footer,.panel-heading+.list-group .list-group-item:first-child{border-top-width:0}.panel>.panel-collapse>.table,.panel>.table,.panel>.table-responsive>.table{margin-bottom:0}.panel>.panel-collapse>.table caption,.panel>.table caption,.panel>.table-responsive>.table caption{padding-left:15px;padding-right:15px}.panel>.table-responsive:first-child>.table:first-child,.panel>.table:first-child{border-top-right-radius:-1;border-top-left-radius:-1}.panel>.table-responsive:first-child>.table:first-child>tbody:first-child>tr:first-child,.panel>.table-responsive:first-child>.table:first-child>thead:first-child>tr:first-child,.panel>.table:first-child>tbody:first-child>tr:first-child,.panel>.table:first-child>thead:first-child>tr:first-child{border-top-left-radius:-1;border-top-right-radius:-1}.panel>.table-responsive:first-child>.table:first-child>tbody:first-child>tr:first-child td:first-child,.panel>.table-responsive:first-child>.table:first-child>tbody:first-child>tr:first-child th:first-child,.panel>.table-responsive:first-child>.table:first-child>thead:first-child>tr:first-child td:first-child,.panel>.table-responsive:first-child>.table:first-child>thead:first-child>tr:first-child th:first-child,.panel>.table:first-child>tbody:first-child>tr:first-child td:first-child,.panel>.table:first-child>tbody:first-child>tr:first-child th:first-child,.panel>.table:first-child>thead:first-child>tr:first-child td:first-child,.panel>.table:first-child>thead:first-child>tr:first-child th:first-child{border-top-left-radius:-1}.panel>.table-responsive:first-child>.table:first-child>tbody:first-child>tr:first-child td:last-child,.panel>.table-responsive:first-child>.table:first-child>tbody:first-child>tr:first-child th:last-child,.panel>.table-responsive:first-child>.table:first-child>thead:first-child>tr:first-child td:last-child,.panel>.table-responsive:first-child>.table:first-child>thead:first-child>tr:first-child th:last-child,.panel>.table:first-child>tbody:first-child>tr:first-child td:last-child,.panel>.table:first-child>tbody:first-child>tr:first-child th:last-child,.panel>.table:first-child>thead:first-child>tr:first-child td:last-child,.panel>.table:first-child>thead:first-child>tr:first-child th:last-child{border-top-right-radius:-1}.panel>.table-responsive:last-child>.table:last-child,.panel>.table:last-child{border-bottom-right-radius:-1;border-bottom-left-radius:-1}.panel>.table-responsive:last-child>.table:last-child>tbody:last-child>tr:last-child,.panel>.table-responsive:last-child>.table:last-child>tfoot:last-child>tr:last-child,.panel>.table:last-child>tbody:last-child>tr:last-child,.panel>.table:last-child>tfoot:last-child>tr:last-child{border-bottom-left-radius:-1;border-bottom-right-radius:-1}.panel>.table-responsive:last-child>.table:last-child>tbody:last-child>tr:last-child td:first-child,.panel>.table-responsive:last-child>.table:last-child>tbody:last-child>tr:last-child th:first-child,.panel>.table-responsive:last-child>.table:last-child>tfoot:last-child>tr:last-child td:first-child,.panel>.table-responsive:last-child>.table:last-child>tfoot:last-child>tr:last-child th:first-child,.panel>.table:last-child>tbody:last-child>tr:last-child td:first-child,.panel>.table:last-child>tbody:last-child>tr:last-child th:first-child,.panel>.table:last-child>tfoot:last-child>tr:last-child td:first-child,.panel>.table:last-child>tfoot:last-child>tr:last-child th:first-child{border-bottom-left-radius:-1}.panel>.table-responsive:last-child>.table:last-child>tbody:last-child>tr:last-child td:last-child,.panel>.table-responsive:last-child>.table:last-child>tbody:last-child>tr:last-child th:last-child,.panel>.table-responsive:last-child>.table:last-child>tfoot:last-child>tr:last-child td:last-child,.panel>.table-responsive:last-child>.table:last-child>tfoot:last-child>tr:last-child th:last-child,.panel>.table:last-child>tbody:last-child>tr:last-child td:last-child,.panel>.table:last-child>tbody:last-child>tr:last-child th:last-child,.panel>.table:last-child>tfoot:last-child>tr:last-child td:last-child,.panel>.table:last-child>tfoot:last-child>tr:last-child th:last-child{border-bottom-right-radius:-1}.panel>.panel-body+.table,.panel>.panel-body+.table-responsive,.panel>.table+.panel-body,.panel>.table-responsive+.panel-body{border-top:1px solid #4e5d6c}.panel>.table>tbody:first-child>tr:first-child td,.panel>.table>tbody:first-child>tr:first-child th{border-top:0}.panel>.table-bordered,.panel>.table-responsive>.table-bordered{border:0}.panel>.table-bordered>tbody>tr>td:first-child,.panel>.table-bordered>tbody>tr>th:first-child,.panel>.table-bordered>tfoot>tr>td:first-child,.panel>.table-bordered>tfoot>tr>th:first-child,.panel>.table-bordered>thead>tr>td:first-child,.panel>.table-bordered>thead>tr>th:first-child,.panel>.table-responsive>.table-bordered>tbody>tr>td:first-child,.panel>.table-responsive>.table-bordered>tbody>tr>th:first-child,.panel>.table-responsive>.table-bordered>tfoot>tr>td:first-child,.panel>.table-responsive>.table-bordered>tfoot>tr>th:first-child,.panel>.table-responsive>.table-bordered>thead>tr>td:first-child,.panel>.table-responsive>.table-bordered>thead>tr>th:first-child{border-left:0}.panel>.table-bordered>tbody>tr>td:last-child,.panel>.table-bordered>tbody>tr>th:last-child,.panel>.table-bordered>tfoot>tr>td:last-child,.panel>.table-bordered>tfoot>tr>th:last-child,.panel>.table-bordered>thead>tr>td:last-child,.panel>.table-bordered>thead>tr>th:last-child,.panel>.table-responsive>.table-bordered>tbody>tr>td:last-child,.panel>.table-responsive>.table-bordered>tbody>tr>th:last-child,.panel>.table-responsive>.table-bordered>tfoot>tr>td:last-child,.panel>.table-responsive>.table-bordered>tfoot>tr>th:last-child,.panel>.table-responsive>.table-bordered>thead>tr>td:last-child,.panel>.table-responsive>.table-bordered>thead>tr>th:last-child{border-right:0}.panel>.table-bordered>tbody>tr:first-child>td,.panel>.table-bordered>tbody>tr:first-child>th,.panel>.table-bordered>tbody>tr:last-child>td,.panel>.table-bordered>tbody>tr:last-child>th,.panel>.table-bordered>tfoot>tr:last-child>td,.panel>.table-bordered>tfoot>tr:last-child>th,.panel>.table-bordered>thead>tr:first-child>td,.panel>.table-bordered>thead>tr:first-child>th,.panel>.table-responsive>.table-bordered>tbody>tr:first-child>td,.panel>.table-responsive>.table-bordered>tbody>tr:first-child>th,.panel>.table-responsive>.table-bordered>tbody>tr:last-child>td,.panel>.table-responsive>.table-bordered>tbody>tr:last-child>th,.panel>.table-responsive>.table-bordered>tfoot>tr:last-child>td,.panel>.table-responsive>.table-bordered>tfoot>tr:last-child>th,.panel>.table-responsive>.table-bordered>thead>tr:first-child>td,.panel>.table-responsive>.table-bordered>thead>tr:first-child>th{border-bottom:0}.panel>.table-responsive{border:0;margin-bottom:0}.panel-group{margin-bottom:21px}.panel-group .panel{margin-bottom:0;border-radius:0}.panel-group .panel+.panel{margin-top:5px}.panel-group .panel-heading{border-bottom:0}.panel-group .panel-heading+.panel-collapse>.list-group,.panel-group .panel-heading+.panel-collapse>.panel-body{border-top:1px solid transparent}.panel-group .panel-footer{border-top:0}.panel-group .panel-footer+.panel-collapse .panel-body{border-bottom:1px solid transparent}.panel-default,.panel-default>.panel-heading{border-color:transparent}.panel-default>.panel-heading+.panel-collapse>.panel-body{border-top-color:transparent}.panel-default>.panel-heading .badge{color:#f5f5f5;background-color:#333}.panel-default>.panel-footer+.panel-collapse>.panel-body{border-bottom-color:transparent}.panel-primary{border-color:transparent}.panel-primary>.panel-heading{color:#fff;background-color:#df691a;border-color:transparent}.panel-primary>.panel-heading+.panel-collapse>.panel-body{border-top-color:transparent}.panel-primary>.panel-heading .badge{color:#df691a;background-color:#fff}.panel-primary>.panel-footer+.panel-collapse>.panel-body{border-bottom-color:transparent}.panel-success{border-color:transparent}.panel-success>.panel-heading{color:#ebebeb;background-color:#5cb85c;border-color:transparent}.panel-success>.panel-heading+.panel-collapse>.panel-body{border-top-color:transparent}.panel-success>.panel-heading .badge{color:#5cb85c;background-color:#ebebeb}.panel-success>.panel-footer+.panel-collapse>.panel-body{border-bottom-color:transparent}.panel-info{border-color:transparent}.panel-info>.panel-heading{color:#ebebeb;background-color:#5bc0de;border-color:transparent}.panel-info>.panel-heading+.panel-collapse>.panel-body{border-top-color:transparent}.panel-info>.panel-heading .badge{color:#5bc0de;background-color:#ebebeb}.panel-info>.panel-footer+.panel-collapse>.panel-body{border-bottom-color:transparent}.panel-warning{border-color:transparent}.panel-warning>.panel-heading{color:#ebebeb;background-color:#f0ad4e;border-color:transparent}.panel-warning>.panel-heading+.panel-collapse>.panel-body{border-top-color:transparent}.panel-warning>.panel-heading .badge{color:#f0ad4e;background-color:#ebebeb}.panel-warning>.panel-footer+.panel-collapse>.panel-body{border-bottom-color:transparent}.panel-danger{border-color:transparent}.panel-danger>.panel-heading{color:#ebebeb;background-color:#d9534f;border-color:transparent}.panel-danger>.panel-heading+.panel-collapse>.panel-body{border-top-color:transparent}.panel-danger>.panel-heading .badge{color:#d9534f;background-color:#ebebeb}.panel-danger>.panel-footer+.panel-collapse>.panel-body{border-bottom-color:transparent}.embed-responsive{position:relative;display:block;height:0;padding:0;overflow:hidden}.embed-responsive .embed-responsive-item,.embed-responsive embed,.embed-responsive iframe,.embed-responsive object,.embed-responsive video{position:absolute;top:0;left:0;bottom:0;height:100%;width:100%;border:0}.embed-responsive-16by9{padding-bottom:56.25%}.embed-responsive-4by3{padding-bottom:75%}.well{min-height:20px;padding:19px;margin-bottom:20px;background-color:#4e5d6c;border:1px solid transparent;border-radius:0}.well blockquote{border-color:#ddd;border-color:rgba(0,0,0,.15)}.well-lg{padding:24px;border-radius:0}.well-sm{padding:9px;border-radius:0}.close{float:right;font-size:22.5px;font-weight:700;line-height:1;color:#ebebeb;text-shadow:none;filter:alpha(opacity=20)}.close:focus,.close:hover{color:#ebebeb;text-decoration:none;cursor:pointer;filter:alpha(opacity=50)}button.close{padding:0;cursor:pointer;background:0 0;border:0;-webkit-appearance:none}.modal-open{overflow:hidden}.modal{display:none;overflow:hidden;position:fixed;top:0;right:0;bottom:0;left:0;z-index:1050;-webkit-overflow-scrolling:touch;outline:0}.modal.fade .modal-dialog{-webkit-transform:translate(0,-25%);-ms-transform:translate(0,-25%);-o-transform:translate(0,-25%);transform:translate(0,-25%);-webkit-transition:-webkit-transform .3s ease-out;-o-transition:-o-transform .3s ease-out;transition:transform .3s ease-out}.modal.in .modal-dialog{-webkit-transform:translate(0,0);-ms-transform:translate(0,0);-o-transform:translate(0,0);transform:translate(0,0)}.modal-open .modal{overflow-x:hidden;overflow-y:auto}.modal-dialog{position:relative;width:auto;margin:10px}.modal-content{position:relative;background-color:#4e5d6c;border:1px solid transparent;border-radius:0;-webkit-box-shadow:0 3px 9px rgba(0,0,0,.5);box-shadow:0 3px 9px rgba(0,0,0,.5);-webkit-background-clip:padding-box;background-clip:padding-box;outline:0}.modal-backdrop{position:fixed;top:0;right:0;bottom:0;left:0;z-index:1040;background-color:#000}.modal-backdrop.fade{opacity:0;filter:alpha(opacity=0)}.modal-backdrop.in{opacity:.5;filter:alpha(opacity=50)}.modal-header{padding:15px;min-height:16.43px}.modal-header .close{margin-top:-2px}.modal-title{margin:0;line-height:1.42857143}.modal-body{position:relative;padding:20px}.modal-footer{padding:20px;text-align:right}.modal-footer .btn+.btn{margin-left:5px;margin-bottom:0}.modal-footer .btn-group .btn+.btn{margin-left:-1px}.modal-footer .btn-block+.btn-block{margin-left:0}.modal-scrollbar-measure{position:absolute;top:-9999px;width:50px;height:50px;overflow:scroll}@media (min-width:768px){.modal-dialog{width:600px;margin:30px auto}.modal-content{-webkit-box-shadow:0 5px 15px rgba(0,0,0,.5);box-shadow:0 5px 15px rgba(0,0,0,.5)}.modal-sm{width:300px}}@media (min-width:992px){.modal-lg{width:900px}}.tooltip{position:absolute;z-index:1070;display:block;font-family:Lato,"Helvetica Neue",Helvetica,Arial,sans-serif;font-size:13px;font-weight:400;line-height:1.4;opacity:0;filter:alpha(opacity=0)}.tooltip.in{opacity:.9;filter:alpha(opacity=90)}.tooltip.top{margin-top:-3px;padding:5px 0}.tooltip.right{margin-left:3px;padding:0 5px}.tooltip.bottom{margin-top:3px;padding:5px 0}.tooltip.left{margin-left:-3px;padding:0 5px}.tooltip-inner{max-width:200px;padding:3px 8px;color:#fff;text-align:center;text-decoration:none;background-color:#000;border-radius:0}.tooltip-arrow{position:absolute;width:0;height:0;border-color:transparent;border-style:solid}.tooltip.top .tooltip-arrow{bottom:0;left:50%;margin-left:-5px;border-width:5px 5px 0;border-top-color:#000}.tooltip.top-left .tooltip-arrow{bottom:0;right:5px;margin-bottom:-5px;border-width:5px 5px 0;border-top-color:#000}.tooltip.top-right .tooltip-arrow{bottom:0;left:5px;margin-bottom:-5px;border-width:5px 5px 0;border-top-color:#000}.tooltip.right .tooltip-arrow{top:50%;left:0;margin-top:-5px;border-width:5px 5px 5px 0;border-right-color:#000}.tooltip.left .tooltip-arrow{top:50%;right:0;margin-top:-5px;border-width:5px 0 5px 5px;border-left-color:#000}.tooltip.bottom .tooltip-arrow{top:0;left:50%;margin-left:-5px;border-width:0 5px 5px;border-bottom-color:#000}.tooltip.bottom-left .tooltip-arrow{top:0;right:5px;margin-top:-5px;border-width:0 5px 5px;border-bottom-color:#000}.tooltip.bottom-right .tooltip-arrow{top:0;left:5px;margin-top:-5px;border-width:0 5px 5px;border-bottom-color:#000}.popover{position:absolute;top:0;left:0;z-index:1060;display:none;max-width:276px;padding:1px;font-family:Lato,"Helvetica Neue",Helvetica,Arial,sans-serif;font-size:15px;font-weight:400;line-height:1.42857143;text-align:left;background-color:#4e5d6c;-webkit-background-clip:padding-box;background-clip:padding-box;border:1px solid transparent;border-radius:0;-webkit-box-shadow:0 5px 10px rgba(0,0,0,.2);box-shadow:0 5px 10px rgba(0,0,0,.2);white-space:normal}.popover.top{margin-top:-10px}.popover.right{margin-left:10px}.popover.bottom{margin-top:10px}.popover.left{margin-left:-10px}.popover-title{margin:0;padding:8px 14px;font-size:15px;background-color:#485563;border-radius:-1 -1 0 0}.popover-content{padding:9px 14px}.popover>.arrow,.popover>.arrow:after{position:absolute;display:block;width:0;height:0;border-color:transparent;border-style:solid}.popover>.arrow{border-width:11px}.popover>.arrow:after{border-width:10px;content:""}.popover.top>.arrow{left:50%;margin-left:-11px;border-bottom-width:0;border-top-color:transparent;bottom:-11px}.popover.top>.arrow:after{content:" ";bottom:1px;margin-left:-10px;border-bottom-width:0;border-top-color:#4e5d6c}.popover.right>.arrow{top:50%;left:-11px;margin-top:-11px;border-left-width:0;border-right-color:transparent}.popover.right>.arrow:after{content:" ";left:1px;bottom:-10px;border-left-width:0;border-right-color:#4e5d6c}.popover.bottom>.arrow{left:50%;margin-left:-11px;border-top-width:0;border-bottom-color:transparent;top:-11px}.popover.bottom>.arrow:after{content:" ";top:1px;margin-left:-10px;border-top-width:0;border-bottom-color:#4e5d6c}.popover.left>.arrow{top:50%;right:-11px;margin-top:-11px;border-right-width:0;border-left-color:transparent}.popover.left>.arrow:after{content:" ";right:1px;border-right-width:0;border-left-color:#4e5d6c;bottom:-10px}.btn-group-vertical>.btn-group:after,.btn-group-vertical>.btn-group:before,.btn-toolbar:after,.btn-toolbar:before,.clearfix:after,.clearfix:before,.container-fluid:after,.container-fluid:before,.container:after,.container:before,.dl-horizontal dd:after,.dl-horizontal dd:before,.form-horizontal .form-group:after,.form-horizontal .form-group:before,.modal-footer:after,.modal-footer:before,.nav:after,.nav:before,.navbar-collapse:after,.navbar-collapse:before,.navbar-header:after,.navbar-header:before,.navbar:after,.navbar:before,.pager:after,.pager:before,.panel-body:after,.panel-body:before,.row:after,.row:before{content:" ";display:table}.btn-group-vertical>.btn-group:after,.btn-toolbar:after,.clearfix:after,.container-fluid:after,.container:after,.dl-horizontal dd:after,.form-horizontal .form-group:after,.modal-footer:after,.nav:after,.navbar-collapse:after,.navbar-header:after,.navbar:after,.pager:after,.panel-body:after,.row:after{clear:both}.center-block{display:block;margin-left:auto;margin-right:auto}.pull-right{float:right!important}.pull-left{float:left!important}.hide{display:none!important}.show{display:block!important}.invisible{visibility:hidden}.text-hide{font:0/0 a;color:transparent;text-shadow:none;background-color:transparent;border:0}.hidden{display:none!important}.affix{position:fixed}@-ms-viewport{width:device-width}.visible-lg,.visible-lg-block,.visible-lg-inline,.visible-lg-inline-block,.visible-md,.visible-md-block,.visible-md-inline,.visible-md-inline-block,.visible-print,.visible-print-block,.visible-print-inline,.visible-print-inline-block,.visible-sm,.visible-sm-block,.visible-sm-inline,.visible-sm-inline-block,.visible-xs,.visible-xs-block,.visible-xs-inline,.visible-xs-inline-block{display:none!important}@media (max-width:767px){.visible-xs{display:block!important}table.visible-xs{display:table}tr.visible-xs{display:table-row!important}td.visible-xs,th.visible-xs{display:table-cell!important}}@media (max-width:767px){.visible-xs-block{display:block!important}}@media (max-width:767px){.visible-xs-inline{display:inline!important}}@media (max-width:767px){.visible-xs-inline-block{display:inline-block!important}}@media (min-width:768px) and (max-width:991px){.visible-sm{display:block!important}table.visible-sm{display:table}tr.visible-sm{display:table-row!important}td.visible-sm,th.visible-sm{display:table-cell!important}}@media (min-width:768px) and (max-width:991px){.visible-sm-block{display:block!important}}@media (min-width:768px) and (max-width:991px){.visible-sm-inline{display:inline!important}}@media (min-width:768px) and (max-width:991px){.visible-sm-inline-block{display:inline-block!important}}@media (min-width:992px) and (max-width:1199px){.visible-md{display:block!important}table.visible-md{display:table}tr.visible-md{display:table-row!important}td.visible-md,th.visible-md{display:table-cell!important}}@media (min-width:992px) and (max-width:1199px){.visible-md-block{display:block!important}}@media (min-width:992px) and (max-width:1199px){.visible-md-inline{display:inline!important}}@media (min-width:992px) and (max-width:1199px){.visible-md-inline-block{display:inline-block!important}}@media (min-width:1200px){.visible-lg{display:block!important}table.visible-lg{display:table}tr.visible-lg{display:table-row!important}td.visible-lg,th.visible-lg{display:table-cell!important}}@media (min-width:1200px){.visible-lg-block{display:block!important}}@media (min-width:1200px){.visible-lg-inline{display:inline!important}}@media (min-width:1200px){.visible-lg-inline-block{display:inline-block!important}}@media (max-width:767px){.hidden-xs{display:none!important}}@media (min-width:768px) and (max-width:991px){.hidden-sm{display:none!important}}@media (min-width:992px) and (max-width:1199px){.hidden-md{display:none!important}}@media (min-width:1200px){.hidden-lg{display:none!important}}@media print{.visible-print{display:block!important}table.visible-print{display:table}tr.visible-print{display:table-row!important}td.visible-print,th.visible-print{display:table-cell!important}}@media print{.visible-print-block{display:block!important}}@media print{.visible-print-inline{display:inline!important}}@media print{.visible-print-inline-block{display:inline-block!important}}@media print{.hidden-print{display:none!important}}.navbar{-webkit-box-shadow:none;box-shadow:none;border:none;font-size:12px}.navbar-default .badge{background-color:#fff;color:#4e5d6c}.navbar-inverse .badge{background-color:#fff;color:#df691a}.btn{font-weight:300}.btn-default:hover{background-color:#485563}.btn-sm,.btn-xs{font-size:12px}body{font-weight:300}.text-primary,.text-primary:hover{color:#df691a}.text-success,.text-success:hover{color:#5cb85c}.text-danger,.text-danger:hover{color:#d9534f}.text-warning,.text-warning:hover{color:#f0ad4e}.text-info,.text-info:hover{color:#5bc0de}.page-header{border-bottom-color:#4e5d6c}.dropdown-menu{border:none;margin:0;-webkit-box-shadow:none;box-shadow:none}.dropdown-menu>li>a{font-size:12px;font-weight:300}.btn-group.open .dropdown-toggle{-webkit-box-shadow:none;box-shadow:none}.dropdown-header{font-size:12px}.table,table{font-size:15px}.table a:not(.btn),table a:not(.btn){color:#fff;text-decoration:underline}.table .dropdown-menu a,table .dropdown-menu a{text-decoration:none}.table .text-muted,table .text-muted{color:#4e5d6c}.table>tbody>tr>td,.table>tbody>tr>th,.table>tfoot>tr>td,.table>tfoot>tr>th,.table>thead>tr>td,.table>thead>tr>th,table>tbody>tr>td,table>tbody>tr>th,table>tfoot>tr>td,table>tfoot>tr>th,table>thead>tr>td,table>thead>tr>th{border-color:transparent}input,textarea{color:#2b3e50}.checkbox label,.help-block,.radio label,label{font-size:12px;font-weight:300}.input-addon,.input-group-addon{color:#ebebeb}.has-warning .control-label,.has-warning .form-control-feedback,.has-warning .help-block{color:#f0ad4e}.has-warning .input-group-addon{border:none}.has-error .control-label,.has-error .form-control-feedback,.has-error .help-block{color:#d9534f}.has-error .input-group-addon{border:none}.has-success .control-label,.has-success .form-control-feedback,.has-success .help-block{color:#5cb85c}.has-success .input-group-addon{border:none}.form-control:focus,.has-error .form-control:focus,.has-success .form-control:focus,.has-warning .form-control:focus{-webkit-box-shadow:none;box-shadow:none}.nav .open>a,.nav .open>a:focus,.nav .open>a:hover{border-color:transparent}.nav-pills>li>a,.nav-tabs>li>a,.pager a{color:#ebebeb}.label{font-weight:300}.alert,.alert .alert-link,.alert a{color:#fff}.close{opacity:.4}.close:focus,.close:hover{opacity:1}.well{-webkit-box-shadow:none;box-shadow:none}a.list-group-item.active,a.list-group-item.active:focus,a.list-group-item.active:hover{border:none}a.list-group-item-success.active{background-color:#5cb85c}a.list-group-item-success.active:focus,a.list-group-item-success.active:hover{background-color:#4cae4c}a.list-group-item-warning.active{background-color:#f0ad4e}a.list-group-item-warning.active:focus,a.list-group-item-warning.active:hover{background-color:#eea236}a.list-group-item-danger.active{background-color:#d9534f}a.list-group-item-danger.active:focus,a.list-group-item-danger.active:hover{background-color:#d43f3a}.panel{border:none}.panel-default>.panel-heading{background-color:#485563;color:#ebebeb}.thumbnail{background-color:#4e5d6c;border:none}.modal{padding:0;background-color:rgba(0,0,0,.6)}.modal-footer,.modal-header{background-color:#485563;border:none;border-radius:0}.popover-title{border:none} ================================================ FILE: app/http/html/cats.html ================================================ Smart Relay

Smart Relay

Required pictures of cats

================================================ FILE: app/http/html/index.html ================================================ Smart Relay

Smart Relay

Status

  • Status
  • SSID
  • IP
  • Internet?

Available networks

Wait while we scan for wifi networks...

Your sensor

Temperature: 0 C
Humidity: 0 %

Test your relay

Relay #0 OFF Relay #1 OFF
================================================ FILE: app/http/html/index.js ================================================ $(function(){ var scanning = 0; var scanResult=null; function wifiConnectModal(id){ if(scanResult==null) return; var modal = $('#connect-modal'); var ap = scanResult.ap[id]; modal.find('#modal-connect-title').text('Connect to '+ap.ssid); if(ap.enc==0){ modal.find('#modal-connect-password').hide(); modal.find('#modal-connect-no-password').show(); } else{ modal.find('#modal-connect-password').show(); modal.find('#modal-connect-no-password').hide(); modal.find('#modal-connect-password-input').val(''); } modal.data('ap',ap); $('#connect-modal .modal-content.connect').show(); $('#connect-modal .modal-content.success').hide(); $('#connect-modal .modal-content.connecting').hide(); modal.modal({show:true,backdrop:false}); $('#modal-connect-password-input').focus(); } function wifiScan(){ scanning=1; //hide result, show progress $('#scan-result').hide(); $('#scan-progress').show(); $.ajax( { type:'POST', url:'/api/wifi/scan', data:null, success: function(data){ scanning=0; scanResult = data; //hide progress, show result $('#scan-result').show(); $('#scan-progress').hide(); if(data.ap_count==0){ $('#scan-result-empty').show(); $('#scan-result-table').hide(); } else{ $('#scan-result-empty').hide(); $('#scan-result-table').show(); $('#scan-result tbody tr').remove(); //empty table //sort data.ap = data.ap.sort(function(a,b){return b.rssi - a.rssi }); for(i=0;i'); tr.data('ap-id',i); var td_name = $(''); td_name.text(ap.ssid); td_name.appendTo(tr); var td_channel = $(''); td_channel.text(ap.channel); //td_channel.appendTo(tr); var td_enc = $('') tr.data('enc',ap.enc); switch(ap.enc){ case 0: td_enc.text("OPEN"); break; case 1: td_enc.text("CLOSED"); break; case 2: td_enc.text("CLOSED"); break; case 3: td_enc.text("CLOSED"); break; case 4: td_enc.text("CLOSED"); break; default: td_enc.text("CLOSED"); break; } td_enc.appendTo(tr); var td_signal = $(''); var signal_pct = 100*ap.rssi/256.0; var signal_span = $(''); signal_span.text(signal_pct.toFixed('f2')+'%'); if(signal_pct > 70) signal_span.addClass('label-success'); else if(signal_pct > 40) signal_span.addClass('label-warning'); else signal_pct.addClass('label-danger'); signal_span.appendTo(td_signal); td_signal.appendTo(tr); tr.appendTo($('#scan-result tbody').first()); } } }, fail:function(){ scanning=0; //hide progress, show result $('#scan-result').show(); $('#scan-progress').hide(); $('#scan-result-empty').show(); $('#scan-result-table').hide(); } }); } function wifiConnect(ssid,pwd){ var postData = {"ssid":ssid,"pwd":pwd}; $('#connect-modal .modal-content.connect').hide(); $('#connect-modal .modal-content.success').hide(); $('#connect-modal .modal-content.connecting').show(); $.ajax( { type:'POST', url:'/api/wifi/connect', data:JSON.stringify(postData), contentType: 'application/json', success:function(data){ $('#connect-modal .modal-content.connect').hide(); $('#connect-modal .modal-content.success').show(); $('#connect-modal .modal-content.connecting').hide(); $('#connect-modal .modal-content.success h3') .text('Relay now connected to '+ssid+' with ip: '+data.ip); wifiStatus(); }, fail:function(){ $('#connect-modal .modal-content.connect').show(); $('#connect-modal .modal-content.success').hide(); $('#connect-modal .modal-content.connecting').hide(); wifiStatus(); } }); } function checkInternet(){ var status_internet=$('#status-internet'); status_internet.text("Checking..."); $.ajax( { type:'POST', url:'/api/wifi/checkInternet', data:'', contentType: 'application/json', success:function(data){ if(data.status==1){ status_internet.text("YES!"); } else{ status_internet.text("NO :("); } } }); } function wifiStatus(){ $.ajax( { type:'POST', url:'/api/wifi/status', data:'', contentType: 'application/json', success:function(data){ var status_status=$('#status-status'); var status_ip = $('#status-ip'); var status_ssid = $('#status-ssid'); switch(data.station_status){ case 5: status_status.text('Connected'); break; case 4: status_status.text('Fail'); break; case 3: status_status.text('Ap Not Found'); break; case 2: status_status.text('Wrong Password'); break; case 1: status_status.text('Connecting'); break; case 0: status_status.text('Not Configured'); break; } status_ssid.text(data.ssid); status_ip.text(data.ip); if(data.station_status==5){ $('#btn-disconnect').show(); $('#network-scan').hide(); checkInternet(); } else{ wifiScan(); $('#network-scan').show(); $('#btn-disconnect').hide(); } } }); } function wifiDisconnect(){ $.ajax( { type:'POST', url:'/api/wifi/disconnect', data:'', contentType: 'application/json', success:function(data){ wifiStatus(); } }); var status_internet=$('#status-internet'); status_internet.text(""); } function relayQueryStatus(){ $.ajax( { type:'POST', url:'/api/relay/state', data:'', contentType: 'application/json', success:function(data){ $.each(data.relays,function(index,item){ var btn = $('#relay-button-'+item.relay); relayStatus(item.relay,item.state); }); } }); } function relayStatus(id,status){ var btn = $('#relay-button-'+id); if(status==0){ btn.text('Relay #'+id+' OFF'); btn.removeClass('btn-success'); btn.addClass('btn-default'); } else{ btn.text('Relay #'+id+' ON'); btn.removeClass('btn-default'); btn.addClass('btn-success'); } } function relayToggle(id){ var data = {'relay':id} $.ajax( { type:'POST', url:'/api/relay/toggle', data:JSON.stringify(data), contentType: 'application/json', success:function(data){ relayStatus(id,data.state); } }); } //sensor var canvas = $('#sensor-chart'); canvas.attr('width',canvas.parent().width()); var ctx = document.getElementById("sensor-chart").getContext("2d"); var options = {animation :false} ; var chartData = { labels: [], datasets: [ { label: "Temperature", fillColor: "rgba(220,220,220,0.2)", strokeColor: "rgba(220,220,220,1)", pointColor: "rgba(220,220,220,1)", pointStrokeColor: "#fff", pointHighlightFill: "#fff", pointHighlightStroke: "rgba(220,220,220,1)", data: [] }, { label: "Humidity", fillColor: "rgba(151,187,205,0.2)", strokeColor: "rgba(151,187,205,1)", pointColor: "rgba(151,187,205,1)", pointStrokeColor: "#fff", pointHighlightFill: "#fff", pointHighlightStroke: "rgba(151,187,205,1)", data: [] } ] }; //init data var lineChart = new Chart(ctx).Line(chartData, options); function sensorRead(){ $.ajax( { type:'POST', url:'/api/dht/read', data:'', contentType: 'application/json', success:function(data){ $('#temp-data').text(data.temp.toFixed(2)+' C'); $('#hum-data').text(data.hum.toFixed(2)+' %'); //chart push new lineChart.addData([data.temp,data.hum],''); } }); } setInterval(sensorRead,5000); //read every 5s $('#btn-scan').on('click',function(e){ e.preventDefault(); e.stopPropagation(); if(!scanning) wifiScan(); }); $('#btn-disconnect').on('click',function(e){ e.preventDefault(); e.stopPropagation(); wifiDisconnect(); }); $(document).on('click','#scan-result tbody tr',function(e){ e.preventDefault(); e.stopPropagation(); var id = $(e.currentTarget).data('ap-id'); wifiConnectModal(id); }); $('a.relay-button').on('click',function(e){ e.preventDefault(); e.stopPropagation(); var id = $(this).data('relay'); relayToggle(id); }); $(document).on('click','#modal-connect-button-connect',function(e){ e.preventDefault(); e.stopPropagation(); var modal = $('#connect-modal'); var ap = modal.data('ap'); var pwd = modal.find('#modal-connect-password-input').val(); wifiConnect(ap.ssid,pwd); }); wifiStatus(); relayQueryStatus(); }); ================================================ FILE: app/http/html/lib.js ================================================ //ZEPTO var Zepto=function(){function F(a){return null==a?String(a):x[y.call(a)]||"object"}function G(a){return"function"==F(a)}function H(a){return null!=a&&a==a.window}function I(a){return null!=a&&a.nodeType==a.DOCUMENT_NODE}function J(a){return"object"==F(a)}function K(a){return J(a)&&!H(a)&&Object.getPrototypeOf(a)==Object.prototype}function L(a){return"number"==typeof a.length}function M(a){return g.call(a,function(a){return null!=a})}function N(a){return a.length>0?c.fn.concat.apply([],a):a}function O(a){return a.replace(/::/g,"/").replace(/([A-Z]+)([A-Z][a-z])/g,"$1_$2").replace(/([a-z\d])([A-Z])/g,"$1_$2").replace(/_/g,"-").toLowerCase()}function P(a){return a in j?j[a]:j[a]=new RegExp("(^|\\s)"+a+"(\\s|$)")}function Q(a,b){return"number"!=typeof b||k[O(a)]?b:b+"px"}function R(a){var b,c;return i[a]||(b=h.createElement(a),h.body.appendChild(b),c=getComputedStyle(b,"").getPropertyValue("display"),b.parentNode.removeChild(b),"none"==c&&(c="block"),i[a]=c),i[a]}function S(a){return"children"in a?f.call(a.children):c.map(a.childNodes,function(a){return 1==a.nodeType?a:void 0})}function T(c,d,e){for(b in d)e&&(K(d[b])||E(d[b]))?(K(d[b])&&!K(c[b])&&(c[b]={}),E(d[b])&&!E(c[b])&&(c[b]=[]),T(c[b],d[b],e)):d[b]!==a&&(c[b]=d[b])}function U(a,b){return null==b?c(a):c(a).filter(b)}function V(a,b,c,d){return G(b)?b.call(a,c,d):b}function W(a,b,c){null==c?a.removeAttribute(b):a.setAttribute(b,c)}function X(b,c){var d=b.className||"",e=d&&d.baseVal!==a;return c===a?e?d.baseVal:d:(e?d.baseVal=c:b.className=c,void 0)}function Y(a){try{return a?"true"==a||("false"==a?!1:"null"==a?null:+a+""==a?+a:/^[\[\{]/.test(a)?c.parseJSON(a):a):a}catch(b){return a}}function Z(a,b){b(a);for(var c=0,d=a.childNodes.length;d>c;c++)Z(a.childNodes[c],b)}var a,b,c,d,A,B,e=[],f=e.slice,g=e.filter,h=window.document,i={},j={},k={"column-count":1,columns:1,"font-weight":1,"line-height":1,opacity:1,"z-index":1,zoom:1},l=/^\s*<(\w+|!)[^>]*>/,m=/^<(\w+)\s*\/?>(?:<\/\1>|)$/,n=/<(?!area|br|col|embed|hr|img|input|link|meta|param)(([\w:]+)[^>]*)\/>/gi,o=/^(?:body|html)$/i,p=/([A-Z])/g,q=["val","css","html","text","data","width","height","offset"],r=["after","prepend","before","append"],s=h.createElement("table"),t=h.createElement("tr"),u={tr:h.createElement("tbody"),tbody:s,thead:s,tfoot:s,td:t,th:t,"*":h.createElement("div")},v=/complete|loaded|interactive/,w=/^[\w-]*$/,x={},y=x.toString,z={},C=h.createElement("div"),D={tabindex:"tabIndex",readonly:"readOnly","for":"htmlFor","class":"className",maxlength:"maxLength",cellspacing:"cellSpacing",cellpadding:"cellPadding",rowspan:"rowSpan",colspan:"colSpan",usemap:"useMap",frameborder:"frameBorder",contenteditable:"contentEditable"},E=Array.isArray||function(a){return a instanceof Array};return z.matches=function(a,b){if(!b||!a||1!==a.nodeType)return!1;var c=a.webkitMatchesSelector||a.mozMatchesSelector||a.oMatchesSelector||a.matchesSelector;if(c)return c.call(a,b);var d,e=a.parentNode,f=!e;return f&&(e=C).appendChild(a),d=~z.qsa(e,b).indexOf(a),f&&C.removeChild(a),d},A=function(a){return a.replace(/-+(.)?/g,function(a,b){return b?b.toUpperCase():""})},B=function(a){return g.call(a,function(b,c){return a.indexOf(b)==c})},z.fragment=function(b,d,e){var g,i,j;return m.test(b)&&(g=c(h.createElement(RegExp.$1))),g||(b.replace&&(b=b.replace(n,"<$1>")),d===a&&(d=l.test(b)&&RegExp.$1),d in u||(d="*"),j=u[d],j.innerHTML=""+b,g=c.each(f.call(j.childNodes),function(){j.removeChild(this)})),K(e)&&(i=c(g),c.each(e,function(a,b){q.indexOf(a)>-1?i[a](b):i.attr(a,b)})),g},z.Z=function(a,b){return a=a||[],a.__proto__=c.fn,a.selector=b||"",a},z.isZ=function(a){return a instanceof z.Z},z.init=function(b,d){var e;if(!b)return z.Z();if("string"==typeof b)if(b=b.trim(),"<"==b[0]&&l.test(b))e=z.fragment(b,RegExp.$1,d),b=null;else{if(d!==a)return c(d).find(b);e=z.qsa(h,b)}else{if(G(b))return c(h).ready(b);if(z.isZ(b))return b;if(E(b))e=M(b);else if(J(b))e=[b],b=null;else if(l.test(b))e=z.fragment(b.trim(),RegExp.$1,d),b=null;else{if(d!==a)return c(d).find(b);e=z.qsa(h,b)}}return z.Z(e,b)},c=function(a,b){return z.init(a,b)},c.extend=function(a){var b,c=f.call(arguments,1);return"boolean"==typeof a&&(b=a,a=c.shift()),c.forEach(function(c){T(a,c,b)}),a},z.qsa=function(a,b){var c,d="#"==b[0],e=!d&&"."==b[0],g=d||e?b.slice(1):b,h=w.test(g);return I(a)&&h&&d?(c=a.getElementById(g))?[c]:[]:1!==a.nodeType&&9!==a.nodeType?[]:f.call(h&&!d?e?a.getElementsByClassName(g):a.getElementsByTagName(b):a.querySelectorAll(b))},c.contains=h.documentElement.contains?function(a,b){return a!==b&&a.contains(b)}:function(a,b){for(;b&&(b=b.parentNode);)if(b===a)return!0;return!1},c.type=F,c.isFunction=G,c.isWindow=H,c.isArray=E,c.isPlainObject=K,c.isEmptyObject=function(a){var b;for(b in a)return!1;return!0},c.inArray=function(a,b,c){return e.indexOf.call(b,a,c)},c.camelCase=A,c.trim=function(a){return null==a?"":String.prototype.trim.call(a)},c.uuid=0,c.support={},c.expr={},c.map=function(a,b){var c,e,f,d=[];if(L(a))for(e=0;e=0?b:b+this.length]},toArray:function(){return this.get()},size:function(){return this.length},remove:function(){return this.each(function(){null!=this.parentNode&&this.parentNode.removeChild(this)})},each:function(a){return e.every.call(this,function(b,c){return a.call(b,c,b)!==!1}),this},filter:function(a){return G(a)?this.not(this.not(a)):c(g.call(this,function(b){return z.matches(b,a)}))},add:function(a,b){return c(B(this.concat(c(a,b))))},is:function(a){return this.length>0&&z.matches(this[0],a)},not:function(b){var d=[];if(G(b)&&b.call!==a)this.each(function(a){b.call(this,a)||d.push(this)});else{var e="string"==typeof b?this.filter(b):L(b)&&G(b.item)?f.call(b):c(b);this.forEach(function(a){e.indexOf(a)<0&&d.push(a)})}return c(d)},has:function(a){return this.filter(function(){return J(a)?c.contains(this,a):c(this).find(a).size()})},eq:function(a){return-1===a?this.slice(a):this.slice(a,+a+1)},first:function(){var a=this[0];return a&&!J(a)?a:c(a)},last:function(){var a=this[this.length-1];return a&&!J(a)?a:c(a)},find:function(a){var b,d=this;return b=a?"object"==typeof a?c(a).filter(function(){var a=this;return e.some.call(d,function(b){return c.contains(b,a)})}):1==this.length?c(z.qsa(this[0],a)):this.map(function(){return z.qsa(this,a)}):c()},closest:function(a,b){var d=this[0],e=!1;for("object"==typeof a&&(e=c(a));d&&!(e?e.indexOf(d)>=0:z.matches(d,a));)d=d!==b&&!I(d)&&d.parentNode;return c(d)},parents:function(a){for(var b=[],d=this;d.length>0;)d=c.map(d,function(a){return(a=a.parentNode)&&!I(a)&&b.indexOf(a)<0?(b.push(a),a):void 0});return U(b,a)},parent:function(a){return U(B(this.pluck("parentNode")),a)},children:function(a){return U(this.map(function(){return S(this)}),a)},contents:function(){return this.map(function(){return f.call(this.childNodes)})},siblings:function(a){return U(this.map(function(a,b){return g.call(S(b.parentNode),function(a){return a!==b})}),a)},empty:function(){return this.each(function(){this.innerHTML=""})},pluck:function(a){return c.map(this,function(b){return b[a]})},show:function(){return this.each(function(){"none"==this.style.display&&(this.style.display=""),"none"==getComputedStyle(this,"").getPropertyValue("display")&&(this.style.display=R(this.nodeName))})},replaceWith:function(a){return this.before(a).remove()},wrap:function(a){var b=G(a);if(this[0]&&!b)var d=c(a).get(0),e=d.parentNode||this.length>1;return this.each(function(f){c(this).wrapAll(b?a.call(this,f):e?d.cloneNode(!0):d)})},wrapAll:function(a){if(this[0]){c(this[0]).before(a=c(a));for(var b;(b=a.children()).length;)a=b.first();c(a).append(this)}return this},wrapInner:function(a){var b=G(a);return this.each(function(d){var e=c(this),f=e.contents(),g=b?a.call(this,d):a;f.length?f.wrapAll(g):e.append(g)})},unwrap:function(){return this.parent().each(function(){c(this).replaceWith(c(this).children())}),this},clone:function(){return this.map(function(){return this.cloneNode(!0)})},hide:function(){return this.css("display","none")},toggle:function(b){return this.each(function(){var d=c(this);(b===a?"none"==d.css("display"):b)?d.show():d.hide()})},prev:function(a){return c(this.pluck("previousElementSibling")).filter(a||"*")},next:function(a){return c(this.pluck("nextElementSibling")).filter(a||"*")},html:function(a){return 0 in arguments?this.each(function(b){var d=this.innerHTML;c(this).empty().append(V(this,a,b,d))}):0 in this?this[0].innerHTML:null},text:function(a){return 0 in arguments?this.each(function(b){var c=V(this,a,b,this.textContent);this.textContent=null==c?"":""+c}):0 in this?this[0].textContent:null},attr:function(c,d){var e;return"string"!=typeof c||1 in arguments?this.each(function(a){if(1===this.nodeType)if(J(c))for(b in c)W(this,b,c[b]);else W(this,c,V(this,d,a,this.getAttribute(c)))}):this.length&&1===this[0].nodeType?!(e=this[0].getAttribute(c))&&c in this[0]?this[0][c]:e:a},removeAttr:function(a){return this.each(function(){1===this.nodeType&&a.split(" ").forEach(function(a){W(this,a)},this)})},prop:function(a,b){return a=D[a]||a,1 in arguments?this.each(function(c){this[a]=V(this,b,c,this[a])}):this[0]&&this[0][a]},data:function(b,c){var d="data-"+b.replace(p,"-$1").toLowerCase(),e=1 in arguments?this.attr(d,c):this.attr(d);return null!==e?Y(e):a},val:function(a){return 0 in arguments?this.each(function(b){this.value=V(this,a,b,this.value)}):this[0]&&(this[0].multiple?c(this[0]).find("option").filter(function(){return this.selected}).pluck("value"):this[0].value)},offset:function(a){if(a)return this.each(function(b){var d=c(this),e=V(this,a,b,d.offset()),f=d.offsetParent().offset(),g={top:e.top-f.top,left:e.left-f.left};"static"==d.css("position")&&(g.position="relative"),d.css(g)});if(!this.length)return null;var b=this[0].getBoundingClientRect();return{left:b.left+window.pageXOffset,top:b.top+window.pageYOffset,width:Math.round(b.width),height:Math.round(b.height)}},css:function(a,d){if(arguments.length<2){var e,f=this[0];if(!f)return;if(e=getComputedStyle(f,""),"string"==typeof a)return f.style[A(a)]||e.getPropertyValue(a);if(E(a)){var g={};return c.each(a,function(a,b){g[b]=f.style[A(b)]||e.getPropertyValue(b)}),g}}var h="";if("string"==F(a))d||0===d?h=O(a)+":"+Q(a,d):this.each(function(){this.style.removeProperty(O(a))});else for(b in a)a[b]||0===a[b]?h+=O(b)+":"+Q(b,a[b])+";":this.each(function(){this.style.removeProperty(O(b))});return this.each(function(){this.style.cssText+=";"+h})},index:function(a){return a?this.indexOf(c(a)[0]):this.parent().children().indexOf(this[0])},hasClass:function(a){return a?e.some.call(this,function(a){return this.test(X(a))},P(a)):!1},addClass:function(a){return a?this.each(function(b){if("className"in this){d=[];var e=X(this),f=V(this,a,b,e);f.split(/\s+/g).forEach(function(a){c(this).hasClass(a)||d.push(a)},this),d.length&&X(this,e+(e?" ":"")+d.join(" "))}}):this},removeClass:function(b){return this.each(function(c){if("className"in this){if(b===a)return X(this,"");d=X(this),V(this,b,c,d).split(/\s+/g).forEach(function(a){d=d.replace(P(a)," ")}),X(this,d.trim())}})},toggleClass:function(b,d){return b?this.each(function(e){var f=c(this),g=V(this,b,e,X(this));g.split(/\s+/g).forEach(function(b){(d===a?!f.hasClass(b):d)?f.addClass(b):f.removeClass(b)})}):this},scrollTop:function(b){if(this.length){var c="scrollTop"in this[0];return b===a?c?this[0].scrollTop:this[0].pageYOffset:this.each(c?function(){this.scrollTop=b}:function(){this.scrollTo(this.scrollX,b)})}},scrollLeft:function(b){if(this.length){var c="scrollLeft"in this[0];return b===a?c?this[0].scrollLeft:this[0].pageXOffset:this.each(c?function(){this.scrollLeft=b}:function(){this.scrollTo(b,this.scrollY)})}},position:function(){if(this.length){var a=this[0],b=this.offsetParent(),d=this.offset(),e=o.test(b[0].nodeName)?{top:0,left:0}:b.offset();return d.top-=parseFloat(c(a).css("margin-top"))||0,d.left-=parseFloat(c(a).css("margin-left"))||0,e.top+=parseFloat(c(b[0]).css("border-top-width"))||0,e.left+=parseFloat(c(b[0]).css("border-left-width"))||0,{top:d.top-e.top,left:d.left-e.left}}},offsetParent:function(){return this.map(function(){for(var a=this.offsetParent||h.body;a&&!o.test(a.nodeName)&&"static"==c(a).css("position");)a=a.offsetParent;return a})}},c.fn.detach=c.fn.remove,["width","height"].forEach(function(b){var d=b.replace(/./,function(a){return a[0].toUpperCase()});c.fn[b]=function(e){var f,g=this[0];return e===a?H(g)?g["inner"+d]:I(g)?g.documentElement["scroll"+d]:(f=this.offset())&&f[b]:this.each(function(a){g=c(this),g.css(b,V(this,e,a,g[b]()))})}}),r.forEach(function(a,b){var d=b%2;c.fn[a]=function(){var a,f,e=c.map(arguments,function(b){return a=F(b),"object"==a||"array"==a||null==b?b:z.fragment(b)}),g=this.length>1;return e.length<1?this:this.each(function(a,i){f=d?i:i.parentNode,i=0==b?i.nextSibling:1==b?i.firstChild:2==b?i:null;var j=c.contains(h.documentElement,f);e.forEach(function(a){if(g)a=a.cloneNode(!0);else if(!f)return c(a).remove();f.insertBefore(a,i),j&&Z(a,function(a){null==a.nodeName||"SCRIPT"!==a.nodeName.toUpperCase()||a.type&&"text/javascript"!==a.type||a.src||window.eval.call(window,a.innerHTML)})})})},c.fn[d?a+"To":"insert"+(b?"Before":"After")]=function(b){return c(b)[a](this),this}}),z.Z.prototype=c.fn,z.uniq=B,z.deserializeValue=Y,c.zepto=z,c}();window.Zepto=Zepto,void 0===window.$&&(window.$=Zepto),function(a){function l(a){return a._zid||(a._zid=b++)}function m(a,b,c,d){if(b=n(b),b.ns)var e=o(b.ns);return(g[l(a)]||[]).filter(function(a){return!(!a||b.e&&a.e!=b.e||b.ns&&!e.test(a.ns)||c&&l(a.fn)!==l(c)||d&&a.sel!=d)})}function n(a){var b=(""+a).split(".");return{e:b[0],ns:b.slice(1).sort().join(" ")}}function o(a){return new RegExp("(?:^| )"+a.replace(" "," .* ?")+"(?: |$)")}function p(a,b){return a.del&&!i&&a.e in j||!!b}function q(a){return k[a]||i&&j[a]||a}function r(b,d,e,f,h,i,j){var m=l(b),o=g[m]||(g[m]=[]);d.split(/\s/).forEach(function(d){if("ready"==d)return a(document).ready(e);var g=n(d);g.fn=e,g.sel=h,g.e in k&&(e=function(b){var c=b.relatedTarget;return!c||c!==this&&!a.contains(this,c)?g.fn.apply(this,arguments):void 0}),g.del=i;var l=i||e;g.proxy=function(a){if(a=x(a),!a.isImmediatePropagationStopped()){a.data=f;var d=l.apply(b,a._args==c?[a]:[a].concat(a._args));return d===!1&&(a.preventDefault(),a.stopPropagation()),d}},g.i=o.length,o.push(g),"addEventListener"in b&&b.addEventListener(q(g.e),g.proxy,p(g,j))})}function s(a,b,c,d,e){var f=l(a);(b||"").split(/\s/).forEach(function(b){m(a,b,c,d).forEach(function(b){delete g[f][b.i],"removeEventListener"in a&&a.removeEventListener(q(b.e),b.proxy,p(b,e))})})}function x(b,d){return(d||!b.isDefaultPrevented)&&(d||(d=b),a.each(w,function(a,c){var e=d[a];b[a]=function(){return this[c]=t,e&&e.apply(d,arguments)},b[c]=u}),(d.defaultPrevented!==c?d.defaultPrevented:"returnValue"in d?d.returnValue===!1:d.getPreventDefault&&d.getPreventDefault())&&(b.isDefaultPrevented=t)),b}function y(a){var b,d={originalEvent:a};for(b in a)v.test(b)||a[b]===c||(d[b]=a[b]);return x(d,a)}var c,b=1,d=Array.prototype.slice,e=a.isFunction,f=function(a){return"string"==typeof a},g={},h={},i="onfocusin"in window,j={focus:"focusin",blur:"focusout"},k={mouseenter:"mouseover",mouseleave:"mouseout"};h.click=h.mousedown=h.mouseup=h.mousemove="MouseEvents",a.event={add:r,remove:s},a.proxy=function(b,c){var g=2 in arguments&&d.call(arguments,2);if(e(b)){var h=function(){return b.apply(c,g?g.concat(d.call(arguments)):arguments)};return h._zid=l(b),h}if(f(c))return g?(g.unshift(b[c],b),a.proxy.apply(null,g)):a.proxy(b[c],b);throw new TypeError("expected function")},a.fn.bind=function(a,b,c){return this.on(a,b,c)},a.fn.unbind=function(a,b){return this.off(a,b)},a.fn.one=function(a,b,c,d){return this.on(a,b,c,d,1)};var t=function(){return!0},u=function(){return!1},v=/^([A-Z]|returnValue$|layer[XY]$)/,w={preventDefault:"isDefaultPrevented",stopImmediatePropagation:"isImmediatePropagationStopped",stopPropagation:"isPropagationStopped"};a.fn.delegate=function(a,b,c){return this.on(b,a,c)},a.fn.undelegate=function(a,b,c){return this.off(b,a,c)},a.fn.live=function(b,c){return a(document.body).delegate(this.selector,b,c),this},a.fn.die=function(b,c){return a(document.body).undelegate(this.selector,b,c),this},a.fn.on=function(b,g,h,i,j){var k,l,m=this;return b&&!f(b)?(a.each(b,function(a,b){m.on(a,g,h,b,j)}),m):(f(g)||e(i)||i===!1||(i=h,h=g,g=c),(e(h)||h===!1)&&(i=h,h=c),i===!1&&(i=u),m.each(function(c,e){j&&(k=function(a){return s(e,a.type,i),i.apply(this,arguments)}),g&&(l=function(b){var c,f=a(b.target).closest(g,e).get(0);return f&&f!==e?(c=a.extend(y(b),{currentTarget:f,liveFired:e}),(k||i).apply(f,[c].concat(d.call(arguments,1)))):void 0}),r(e,b,i,h,g,l||k)}))},a.fn.off=function(b,d,g){var h=this;return b&&!f(b)?(a.each(b,function(a,b){h.off(a,d,b)}),h):(f(d)||e(g)||g===!1||(g=d,d=c),g===!1&&(g=u),h.each(function(){s(this,b,g,d)}))},a.fn.trigger=function(b,c){return b=f(b)||a.isPlainObject(b)?a.Event(b):x(b),b._args=c,this.each(function(){b.type in j&&"function"==typeof this[b.type]?this[b.type]():"dispatchEvent"in this?this.dispatchEvent(b):a(this).triggerHandler(b,c)})},a.fn.triggerHandler=function(b,c){var d,e;return this.each(function(g,h){d=y(f(b)?a.Event(b):b),d._args=c,d.target=h,a.each(m(h,b.type||b),function(a,b){return e=b.proxy(d),d.isImmediatePropagationStopped()?!1:void 0})}),e},"focusin focusout focus blur load resize scroll unload click dblclick mousedown mouseup mousemove mouseover mouseout mouseenter mouseleave change select keydown keypress keyup error".split(" ").forEach(function(b){a.fn[b]=function(a){return 0 in arguments?this.bind(b,a):this.trigger(b)}}),a.Event=function(a,b){f(a)||(b=a,a=b.type);var c=document.createEvent(h[a]||"Events"),d=!0;if(b)for(var e in b)"bubbles"==e?d=!!b[e]:c[e]=b[e];return c.initEvent(a,d,!0),x(c)}}(Zepto),function(a){function m(b,c,d){var e=a.Event(c);return a(b).trigger(e,d),!e.isDefaultPrevented()}function n(a,b,d,e){return a.global?m(b||c,d,e):void 0}function o(b){b.global&&0===a.active++&&n(b,null,"ajaxStart")}function p(b){b.global&&!--a.active&&n(b,null,"ajaxStop")}function q(a,b){var c=b.context;return b.beforeSend.call(c,a,b)===!1||n(b,c,"ajaxBeforeSend",[a,b])===!1?!1:(n(b,c,"ajaxSend",[a,b]),void 0)}function r(a,b,c,d){var e=c.context,f="success";c.success.call(e,a,f,b),d&&d.resolveWith(e,[a,f,b]),n(c,e,"ajaxSuccess",[b,c,a]),t(f,b,c)}function s(a,b,c,d,e){var f=d.context;d.error.call(f,c,b,a),e&&e.rejectWith(f,[c,b,a]),n(d,f,"ajaxError",[c,d,a||b]),t(b,c,d)}function t(a,b,c){var d=c.context;c.complete.call(d,b,a),n(c,d,"ajaxComplete",[b,c]),p(c)}function u(){}function v(a){return a&&(a=a.split(";",2)[0]),a&&(a==j?"html":a==i?"json":g.test(a)?"script":h.test(a)&&"xml")||"text"}function w(a,b){return""==b?a:(a+"&"+b).replace(/[&?]{1,2}/,"?")}function x(b){b.processData&&b.data&&"string"!=a.type(b.data)&&(b.data=a.param(b.data,b.traditional)),!b.data||b.type&&"GET"!=b.type.toUpperCase()||(b.url=w(b.url,b.data),b.data=void 0)}function y(b,c,d,e){return a.isFunction(c)&&(e=d,d=c,c=void 0),a.isFunction(d)||(e=d,d=void 0),{url:b,data:c,success:d,dataType:e}}function A(b,c,d,e){var f,g=a.isArray(c),h=a.isPlainObject(c);a.each(c,function(c,i){f=a.type(i),e&&(c=d?e:e+"["+(h||"object"==f||"array"==f?c:"")+"]"),!e&&g?b.add(i.name,i.value):"array"==f||!d&&"object"==f?A(b,i,d,c):b.add(c,i)})}var d,e,b=0,c=window.document,f=/)<[^<]*)*<\/script>/gi,g=/^(?:text|application)\/javascript/i,h=/^(?:text|application)\/xml/i,i="application/json",j="text/html",k=/^\s*$/,l=c.createElement("a");l.href=window.location.href,a.active=0,a.ajaxJSONP=function(d,e){if(!("type"in d))return a.ajax(d);var j,m,f=d.jsonpCallback,g=(a.isFunction(f)?f():f)||"jsonp"+ ++b,h=c.createElement("script"),i=window[g],k=function(b){a(h).triggerHandler("error",b||"abort")},l={abort:k};return e&&e.promise(l),a(h).on("load error",function(b,c){clearTimeout(m),a(h).off().remove(),"error"!=b.type&&j?r(j[0],l,d,e):s(null,c||"error",l,d,e),window[g]=i,j&&a.isFunction(i)&&i(j[0]),i=j=void 0}),q(l,d)===!1?(k("abort"),l):(window[g]=function(){j=arguments},h.src=d.url.replace(/\?(.+)=\?/,"?$1="+g),c.head.appendChild(h),d.timeout>0&&(m=setTimeout(function(){k("timeout")},d.timeout)),l)},a.ajaxSettings={type:"GET",beforeSend:u,success:u,error:u,complete:u,context:null,global:!0,xhr:function(){return new window.XMLHttpRequest},accepts:{script:"text/javascript, application/javascript, application/x-javascript",json:i,xml:"application/xml, text/xml",html:j,text:"text/plain"},crossDomain:!1,timeout:0,processData:!0,cache:!0},a.ajax=function(b){var h,f=a.extend({},b||{}),g=a.Deferred&&a.Deferred();for(d in a.ajaxSettings)void 0===f[d]&&(f[d]=a.ajaxSettings[d]);o(f),f.crossDomain||(h=c.createElement("a"),h.href=f.url,h.href=h.href,f.crossDomain=l.protocol+"//"+l.host!=h.protocol+"//"+h.host),f.url||(f.url=window.location.toString()),x(f);var i=f.dataType,j=/\?.+=\?/.test(f.url);if(j&&(i="jsonp"),f.cache!==!1&&(b&&b.cache===!0||"script"!=i&&"jsonp"!=i)||(f.url=w(f.url,"_="+Date.now())),"jsonp"==i)return j||(f.url=w(f.url,f.jsonp?f.jsonp+"=?":f.jsonp===!1?"":"callback=?")),a.ajaxJSONP(f,g);var A,m=f.accepts[i],n={},p=function(a,b){n[a.toLowerCase()]=[a,b]},t=/^([\w-]+:)\/\//.test(f.url)?RegExp.$1:window.location.protocol,y=f.xhr(),z=y.setRequestHeader;if(g&&g.promise(y),f.crossDomain||p("X-Requested-With","XMLHttpRequest"),p("Accept",m||"*/*"),(m=f.mimeType||m)&&(m.indexOf(",")>-1&&(m=m.split(",",2)[0]),y.overrideMimeType&&y.overrideMimeType(m)),(f.contentType||f.contentType!==!1&&f.data&&"GET"!=f.type.toUpperCase())&&p("Content-Type",f.contentType||"application/x-www-form-urlencoded"),f.headers)for(e in f.headers)p(e,f.headers[e]);if(y.setRequestHeader=p,y.onreadystatechange=function(){if(4==y.readyState){y.onreadystatechange=u,clearTimeout(A);var b,c=!1;if(y.status>=200&&y.status<300||304==y.status||0==y.status&&"file:"==t){i=i||v(f.mimeType||y.getResponseHeader("content-type")),b=y.responseText;try{"script"==i?(1,eval)(b):"xml"==i?b=y.responseXML:"json"==i&&(b=k.test(b)?null:a.parseJSON(b))}catch(d){c=d}c?s(c,"parsererror",y,f,g):r(b,y,f,g)}else s(y.statusText||null,y.status?"error":"abort",y,f,g)}},q(y,f)===!1)return y.abort(),s(null,"abort",y,f,g),y;if(f.xhrFields)for(e in f.xhrFields)y[e]=f.xhrFields[e];var B="async"in f?f.async:!0;y.open(f.type,f.url,B,f.username,f.password);for(e in n)z.apply(y,n[e]);return f.timeout>0&&(A=setTimeout(function(){y.onreadystatechange=u,y.abort(),s(null,"timeout",y,f,g)},f.timeout)),y.send(f.data?f.data:null),y},a.get=function(){return a.ajax(y.apply(null,arguments))},a.post=function(){var b=y.apply(null,arguments);return b.type="POST",a.ajax(b)},a.getJSON=function(){var b=y.apply(null,arguments);return b.dataType="json",a.ajax(b)},a.fn.load=function(b,c,d){if(!this.length)return this;var h,e=this,g=b.split(/\s/),i=y(b,c,d),j=i.success;return g.length>1&&(i.url=g[0],h=g[1]),i.success=function(b){e.html(h?a("
").html(b.replace(f,"")).find(h):b),j&&j.apply(e,arguments)},a.ajax(i),this};var z=encodeURIComponent;a.param=function(b,c){var d=[];return d.add=function(b,c){a.isFunction(c)&&(c=c()),null==c&&(c=""),this.push(z(b)+"="+z(c))},A(d,b,c),d.join("&").replace(/%20/g,"+")}}(Zepto),function(a){a.fn.serializeArray=function(){var b,c,d=[],e=function(a){return a.forEach?a.forEach(e):(d.push({name:b,value:a}),void 0)};return this[0]&&a.each(this[0].elements,function(d,f){c=f.type,b=f.name,b&&"fieldset"!=f.nodeName.toLowerCase()&&!f.disabled&&"submit"!=c&&"reset"!=c&&"button"!=c&&"file"!=c&&("radio"!=c&&"checkbox"!=c||f.checked)&&e(a(f).val())}),d},a.fn.serialize=function(){var a=[];return this.serializeArray().forEach(function(b){a.push(encodeURIComponent(b.name)+"="+encodeURIComponent(b.value))}),a.join("&")},a.fn.submit=function(b){if(0 in arguments)this.bind("submit",b);else if(this.length){var c=a.Event("submit");this.eq(0).trigger(c),c.isDefaultPrevented()||this.get(0).submit()}return this}}(Zepto),function(a){"__proto__"in{}||a.extend(a.zepto,{Z:function(b,c){return b=b||[],a.extend(b,a.fn),b.selector=c||"",b.__Z=!0,b},isZ:function(b){return"array"===a.type(b)&&"__Z"in b}});try{getComputedStyle(void 0)}catch(b){var c=getComputedStyle;window.getComputedStyle=function(a){try{return c(a)}catch(b){return null}}}}(Zepto),function(a){function g(f,g){var i=f[e],j=i&&b[i];if(void 0===g)return j||h(f);if(j){if(g in j)return j[g];var k=d(g);if(k in j)return j[k]}return c.call(a(f),g)}function h(c,f,g){var h=c[e]||(c[e]=++a.uuid),j=b[h]||(b[h]=i(c));return void 0!==f&&(j[d(f)]=g),j}function i(b){var c={};return a.each(b.attributes||f,function(b,e){0==e.name.indexOf("data-")&&(c[d(e.name.replace("data-",""))]=a.zepto.deserializeValue(e.value))}),c}var b={},c=a.fn.data,d=a.camelCase,e=a.expando="Zepto"+ +new Date,f=[];a.fn.data=function(b,c){return void 0===c?a.isPlainObject(b)?this.each(function(c,d){a.each(b,function(a,b){h(d,a,b)})}):0 in this?g(this[0],b):void 0:this.each(function(){h(this,b,c)})},a.fn.removeData=function(c){return"string"==typeof c&&(c=c.split(/\s+/)),this.each(function(){var f=this[e],g=f&&b[f];g&&a.each(c||g,function(a){delete g[c?d(this):a]})})},["remove","empty"].forEach(function(b){var c=a.fn[b];a.fn[b]=function(){var a=this.find("*");return"remove"===b&&(a=a.add(this)),a.removeData(),c.call(this)}})}(Zepto); //ChartJS (function(){"use strict";var t=this,i=t.Chart,e=function(t){this.canvas=t.canvas,this.ctx=t;var i=function(t,i){return t["offset"+i]?t["offset"+i]:document.defaultView.getComputedStyle(t).getPropertyValue(i)},e=this.width=i(t.canvas,"Width"),n=this.height=i(t.canvas,"Height");t.canvas.width=e,t.canvas.height=n;var e=this.width=t.canvas.width,n=this.height=t.canvas.height;return this.aspectRatio=this.width/this.height,s.retinaScale(this),this};e.defaults={global:{animation:!0,animationSteps:60,animationEasing:"easeOutQuart",showScale:!0,scaleOverride:!1,scaleSteps:null,scaleStepWidth:null,scaleStartValue:null,scaleLineColor:"rgba(0,0,0,.1)",scaleLineWidth:1,scaleShowLabels:!0,scaleLabel:"<%=value%>",scaleIntegersOnly:!0,scaleBeginAtZero:!1,scaleFontFamily:"'Helvetica Neue', 'Helvetica', 'Arial', sans-serif",scaleFontSize:12,scaleFontStyle:"normal",scaleFontColor:"#666",responsive:!1,maintainAspectRatio:!0,showTooltips:!0,customTooltips:!1,tooltipEvents:["mousemove","touchstart","touchmove","mouseout"],tooltipFillColor:"rgba(0,0,0,0.8)",tooltipFontFamily:"'Helvetica Neue', 'Helvetica', 'Arial', sans-serif",tooltipFontSize:14,tooltipFontStyle:"normal",tooltipFontColor:"#fff",tooltipTitleFontFamily:"'Helvetica Neue', 'Helvetica', 'Arial', sans-serif",tooltipTitleFontSize:14,tooltipTitleFontStyle:"bold",tooltipTitleFontColor:"#fff",tooltipYPadding:6,tooltipXPadding:6,tooltipCaretSize:8,tooltipCornerRadius:6,tooltipXOffset:10,tooltipTemplate:"<%if (label){%><%=label%>: <%}%><%= value %>",multiTooltipTemplate:"<%= value %>",multiTooltipKeyBackground:"#fff",onAnimationProgress:function(){},onAnimationComplete:function(){}}},e.types={};var s=e.helpers={},n=s.each=function(t,i,e){var s=Array.prototype.slice.call(arguments,3);if(t)if(t.length===+t.length){var n;for(n=0;n=0;s--){var n=t[s];if(i(n))return n}},s.inherits=function(t){var i=this,e=t&&t.hasOwnProperty("constructor")?t.constructor:function(){return i.apply(this,arguments)},s=function(){this.constructor=e};return s.prototype=i.prototype,e.prototype=new s,e.extend=r,t&&a(e.prototype,t),e.__super__=i.prototype,e}),c=s.noop=function(){},u=s.uid=function(){var t=0;return function(){return"chart-"+t++}}(),d=s.warn=function(t){window.console&&"function"==typeof window.console.warn&&console.warn(t)},p=s.amd="function"==typeof define&&define.amd,f=s.isNumber=function(t){return!isNaN(parseFloat(t))&&isFinite(t)},g=s.max=function(t){return Math.max.apply(Math,t)},m=s.min=function(t){return Math.min.apply(Math,t)},v=(s.cap=function(t,i,e){if(f(i)){if(t>i)return i}else if(f(e)&&e>t)return e;return t},s.getDecimalPlaces=function(t){return t%1!==0&&f(t)?t.toString().split(".")[1].length:0}),S=s.radians=function(t){return t*(Math.PI/180)},x=(s.getAngleFromPoint=function(t,i){var e=i.x-t.x,s=i.y-t.y,n=Math.sqrt(e*e+s*s),o=2*Math.PI+Math.atan2(s,e);return 0>e&&0>s&&(o+=2*Math.PI),{angle:o,distance:n}},s.aliasPixel=function(t){return t%2===0?0:.5}),y=(s.splineCurve=function(t,i,e,s){var n=Math.sqrt(Math.pow(i.x-t.x,2)+Math.pow(i.y-t.y,2)),o=Math.sqrt(Math.pow(e.x-i.x,2)+Math.pow(e.y-i.y,2)),a=s*n/(n+o),h=s*o/(n+o);return{inner:{x:i.x-a*(e.x-t.x),y:i.y-a*(e.y-t.y)},outer:{x:i.x+h*(e.x-t.x),y:i.y+h*(e.y-t.y)}}},s.calculateOrderOfMagnitude=function(t){return Math.floor(Math.log(t)/Math.LN10)}),C=(s.calculateScaleRange=function(t,i,e,s,n){var o=2,a=Math.floor(i/(1.5*e)),h=o>=a,l=g(t),r=m(t);l===r&&(l+=.5,r>=.5&&!s?r-=.5:l+=.5);for(var c=Math.abs(l-r),u=y(c),d=Math.ceil(l/(1*Math.pow(10,u)))*Math.pow(10,u),p=s?0:Math.floor(r/(1*Math.pow(10,u)))*Math.pow(10,u),f=d-p,v=Math.pow(10,u),S=Math.round(f/v);(S>a||a>2*S)&&!h;)if(S>a)v*=2,S=Math.round(f/v),S%1!==0&&(h=!0);else if(n&&u>=0){if(v/2%1!==0)break;v/=2,S=Math.round(f/v)}else v/=2,S=Math.round(f/v);return h&&(S=o,v=f/S),{steps:S,stepValue:v,min:p,max:p+S*v}},s.template=function(t,i){function e(t,i){var e=/\W/.test(t)?new Function("obj","var p=[],print=function(){p.push.apply(p,arguments);};with(obj){p.push('"+t.replace(/[\r\t\n]/g," ").split("<%").join(" ").replace(/((^|%>)[^\t]*)'/g,"$1\r").replace(/\t=(.*?)%>/g,"',$1,'").split(" ").join("');").split("%>").join("p.push('").split("\r").join("\\'")+"');}return p.join('');"):s[t]=s[t];return i?e(i):e}if(t instanceof Function)return t(i);var s={};return e(t,i)}),w=(s.generateLabels=function(t,i,e,s){var o=new Array(i);return labelTemplateString&&n(o,function(i,n){o[n]=C(t,{value:e+s*(n+1)})}),o},s.easingEffects={linear:function(t){return t},easeInQuad:function(t){return t*t},easeOutQuad:function(t){return-1*t*(t-2)},easeInOutQuad:function(t){return(t/=.5)<1?.5*t*t:-0.5*(--t*(t-2)-1)},easeInCubic:function(t){return t*t*t},easeOutCubic:function(t){return 1*((t=t/1-1)*t*t+1)},easeInOutCubic:function(t){return(t/=.5)<1?.5*t*t*t:.5*((t-=2)*t*t+2)},easeInQuart:function(t){return t*t*t*t},easeOutQuart:function(t){return-1*((t=t/1-1)*t*t*t-1)},easeInOutQuart:function(t){return(t/=.5)<1?.5*t*t*t*t:-0.5*((t-=2)*t*t*t-2)},easeInQuint:function(t){return 1*(t/=1)*t*t*t*t},easeOutQuint:function(t){return 1*((t=t/1-1)*t*t*t*t+1)},easeInOutQuint:function(t){return(t/=.5)<1?.5*t*t*t*t*t:.5*((t-=2)*t*t*t*t+2)},easeInSine:function(t){return-1*Math.cos(t/1*(Math.PI/2))+1},easeOutSine:function(t){return 1*Math.sin(t/1*(Math.PI/2))},easeInOutSine:function(t){return-0.5*(Math.cos(Math.PI*t/1)-1)},easeInExpo:function(t){return 0===t?1:1*Math.pow(2,10*(t/1-1))},easeOutExpo:function(t){return 1===t?1:1*(-Math.pow(2,-10*t/1)+1)},easeInOutExpo:function(t){return 0===t?0:1===t?1:(t/=.5)<1?.5*Math.pow(2,10*(t-1)):.5*(-Math.pow(2,-10*--t)+2)},easeInCirc:function(t){return t>=1?t:-1*(Math.sqrt(1-(t/=1)*t)-1)},easeOutCirc:function(t){return 1*Math.sqrt(1-(t=t/1-1)*t)},easeInOutCirc:function(t){return(t/=.5)<1?-0.5*(Math.sqrt(1-t*t)-1):.5*(Math.sqrt(1-(t-=2)*t)+1)},easeInElastic:function(t){var i=1.70158,e=0,s=1;return 0===t?0:1==(t/=1)?1:(e||(e=.3),st?-.5*s*Math.pow(2,10*(t-=1))*Math.sin(2*(1*t-i)*Math.PI/e):s*Math.pow(2,-10*(t-=1))*Math.sin(2*(1*t-i)*Math.PI/e)*.5+1)},easeInBack:function(t){var i=1.70158;return 1*(t/=1)*t*((i+1)*t-i)},easeOutBack:function(t){var i=1.70158;return 1*((t=t/1-1)*t*((i+1)*t+i)+1)},easeInOutBack:function(t){var i=1.70158;return(t/=.5)<1?.5*t*t*(((i*=1.525)+1)*t-i):.5*((t-=2)*t*(((i*=1.525)+1)*t+i)+2)},easeInBounce:function(t){return 1-w.easeOutBounce(1-t)},easeOutBounce:function(t){return(t/=1)<1/2.75?7.5625*t*t:2/2.75>t?1*(7.5625*(t-=1.5/2.75)*t+.75):2.5/2.75>t?1*(7.5625*(t-=2.25/2.75)*t+.9375):1*(7.5625*(t-=2.625/2.75)*t+.984375)},easeInOutBounce:function(t){return.5>t?.5*w.easeInBounce(2*t):.5*w.easeOutBounce(2*t-1)+.5}}),b=s.requestAnimFrame=function(){return window.requestAnimationFrame||window.webkitRequestAnimationFrame||window.mozRequestAnimationFrame||window.oRequestAnimationFrame||window.msRequestAnimationFrame||function(t){return window.setTimeout(t,1e3/60)}}(),P=s.cancelAnimFrame=function(){return window.cancelAnimationFrame||window.webkitCancelAnimationFrame||window.mozCancelAnimationFrame||window.oCancelAnimationFrame||window.msCancelAnimationFrame||function(t){return window.clearTimeout(t,1e3/60)}}(),L=(s.animationLoop=function(t,i,e,s,n,o){var a=0,h=w[e]||w.linear,l=function(){a++;var e=a/i,r=h(e);t.call(o,r,e,a),s.call(o,r,e),i>a?o.animationFrame=b(l):n.apply(o)};b(l)},s.getRelativePosition=function(t){var i,e,s=t.originalEvent||t,n=t.currentTarget||t.srcElement,o=n.getBoundingClientRect();return s.touches?(i=s.touches[0].clientX-o.left,e=s.touches[0].clientY-o.top):(i=s.clientX-o.left,e=s.clientY-o.top),{x:i,y:e}},s.addEvent=function(t,i,e){t.addEventListener?t.addEventListener(i,e):t.attachEvent?t.attachEvent("on"+i,e):t["on"+i]=e}),k=s.removeEvent=function(t,i,e){t.removeEventListener?t.removeEventListener(i,e,!1):t.detachEvent?t.detachEvent("on"+i,e):t["on"+i]=c},F=(s.bindEvents=function(t,i,e){t.events||(t.events={}),n(i,function(i){t.events[i]=function(){e.apply(t,arguments)},L(t.chart.canvas,i,t.events[i])})},s.unbindEvents=function(t,i){n(i,function(i,e){k(t.chart.canvas,e,i)})}),R=s.getMaximumWidth=function(t){var i=t.parentNode;return i.clientWidth},T=s.getMaximumHeight=function(t){var i=t.parentNode;return i.clientHeight},A=(s.getMaximumSize=s.getMaximumWidth,s.retinaScale=function(t){var i=t.ctx,e=t.canvas.width,s=t.canvas.height;window.devicePixelRatio&&(i.canvas.style.width=e+"px",i.canvas.style.height=s+"px",i.canvas.height=s*window.devicePixelRatio,i.canvas.width=e*window.devicePixelRatio,i.scale(window.devicePixelRatio,window.devicePixelRatio))}),M=s.clear=function(t){t.ctx.clearRect(0,0,t.width,t.height)},W=s.fontString=function(t,i,e){return i+" "+t+"px "+e},z=s.longestText=function(t,i,e){t.font=i;var s=0;return n(e,function(i){var e=t.measureText(i).width;s=e>s?e:s}),s},B=s.drawRoundedRectangle=function(t,i,e,s,n,o){t.beginPath(),t.moveTo(i+o,e),t.lineTo(i+s-o,e),t.quadraticCurveTo(i+s,e,i+s,e+o),t.lineTo(i+s,e+n-o),t.quadraticCurveTo(i+s,e+n,i+s-o,e+n),t.lineTo(i+o,e+n),t.quadraticCurveTo(i,e+n,i,e+n-o),t.lineTo(i,e+o),t.quadraticCurveTo(i,e,i+o,e),t.closePath()};e.instances={},e.Type=function(t,i,s){this.options=i,this.chart=s,this.id=u(),e.instances[this.id]=this,i.responsive&&this.resize(),this.initialize.call(this,t)},a(e.Type.prototype,{initialize:function(){return this},clear:function(){return M(this.chart),this},stop:function(){return P(this.animationFrame),this},resize:function(t){this.stop();var i=this.chart.canvas,e=R(this.chart.canvas),s=this.options.maintainAspectRatio?e/this.chart.aspectRatio:T(this.chart.canvas);return i.width=this.chart.width=e,i.height=this.chart.height=s,A(this.chart),"function"==typeof t&&t.apply(this,Array.prototype.slice.call(arguments,1)),this},reflow:c,render:function(t){return t&&this.reflow(),this.options.animation&&!t?s.animationLoop(this.draw,this.options.animationSteps,this.options.animationEasing,this.options.onAnimationProgress,this.options.onAnimationComplete,this):(this.draw(),this.options.onAnimationComplete.call(this)),this},generateLegend:function(){return C(this.options.legendTemplate,this)},destroy:function(){this.clear(),F(this,this.events);var t=this.chart.canvas;t.width=this.chart.width,t.height=this.chart.height,t.style.removeProperty?(t.style.removeProperty("width"),t.style.removeProperty("height")):(t.style.removeAttribute("width"),t.style.removeAttribute("height")),delete e.instances[this.id]},showTooltip:function(t,i){"undefined"==typeof this.activeElements&&(this.activeElements=[]);var o=function(t){var i=!1;return t.length!==this.activeElements.length?i=!0:(n(t,function(t,e){t!==this.activeElements[e]&&(i=!0)},this),i)}.call(this,t);if(o||i){if(this.activeElements=t,this.draw(),this.options.customTooltips&&this.options.customTooltips(!1),t.length>0)if(this.datasets&&this.datasets.length>1){for(var a,h,r=this.datasets.length-1;r>=0&&(a=this.datasets[r].points||this.datasets[r].bars||this.datasets[r].segments,h=l(a,t[0]),-1===h);r--);var c=[],u=[],d=function(){var t,i,e,n,o,a=[],l=[],r=[];return s.each(this.datasets,function(i){t=i.points||i.bars||i.segments,t[h]&&t[h].hasValue()&&a.push(t[h])}),s.each(a,function(t){l.push(t.x),r.push(t.y),c.push(s.template(this.options.multiTooltipTemplate,t)),u.push({fill:t._saved.fillColor||t.fillColor,stroke:t._saved.strokeColor||t.strokeColor})},this),o=m(r),e=g(r),n=m(l),i=g(l),{x:n>this.chart.width/2?n:i,y:(o+e)/2}}.call(this,h);new e.MultiTooltip({x:d.x,y:d.y,xPadding:this.options.tooltipXPadding,yPadding:this.options.tooltipYPadding,xOffset:this.options.tooltipXOffset,fillColor:this.options.tooltipFillColor,textColor:this.options.tooltipFontColor,fontFamily:this.options.tooltipFontFamily,fontStyle:this.options.tooltipFontStyle,fontSize:this.options.tooltipFontSize,titleTextColor:this.options.tooltipTitleFontColor,titleFontFamily:this.options.tooltipTitleFontFamily,titleFontStyle:this.options.tooltipTitleFontStyle,titleFontSize:this.options.tooltipTitleFontSize,cornerRadius:this.options.tooltipCornerRadius,labels:c,legendColors:u,legendColorBackground:this.options.multiTooltipKeyBackground,title:t[0].label,chart:this.chart,ctx:this.chart.ctx,custom:this.options.customTooltips}).draw()}else n(t,function(t){var i=t.tooltipPosition();new e.Tooltip({x:Math.round(i.x),y:Math.round(i.y),xPadding:this.options.tooltipXPadding,yPadding:this.options.tooltipYPadding,fillColor:this.options.tooltipFillColor,textColor:this.options.tooltipFontColor,fontFamily:this.options.tooltipFontFamily,fontStyle:this.options.tooltipFontStyle,fontSize:this.options.tooltipFontSize,caretHeight:this.options.tooltipCaretSize,cornerRadius:this.options.tooltipCornerRadius,text:C(this.options.tooltipTemplate,t),chart:this.chart,custom:this.options.customTooltips}).draw()},this);return this}},toBase64Image:function(){return this.chart.canvas.toDataURL.apply(this.chart.canvas,arguments)}}),e.Type.extend=function(t){var i=this,s=function(){return i.apply(this,arguments)};if(s.prototype=o(i.prototype),a(s.prototype,t),s.extend=e.Type.extend,t.name||i.prototype.name){var n=t.name||i.prototype.name,l=e.defaults[i.prototype.name]?o(e.defaults[i.prototype.name]):{};e.defaults[n]=a(l,t.defaults),e.types[n]=s,e.prototype[n]=function(t,i){var o=h(e.defaults.global,e.defaults[n],i||{});return new s(t,o,this)}}else d("Name not provided for this chart, so it hasn't been registered");return i},e.Element=function(t){a(this,t),this.initialize.apply(this,arguments),this.save()},a(e.Element.prototype,{initialize:function(){},restore:function(t){return t?n(t,function(t){this[t]=this._saved[t]},this):a(this,this._saved),this},save:function(){return this._saved=o(this),delete this._saved._saved,this},update:function(t){return n(t,function(t,i){this._saved[i]=this[i],this[i]=t},this),this},transition:function(t,i){return n(t,function(t,e){this[e]=(t-this._saved[e])*i+this._saved[e]},this),this},tooltipPosition:function(){return{x:this.x,y:this.y}},hasValue:function(){return f(this.value)}}),e.Element.extend=r,e.Point=e.Element.extend({display:!0,inRange:function(t,i){var e=this.hitDetectionRadius+this.radius;return Math.pow(t-this.x,2)+Math.pow(i-this.y,2)=this.startAngle&&e.angle<=this.endAngle,o=e.distance>=this.innerRadius&&e.distance<=this.outerRadius;return n&&o},tooltipPosition:function(){var t=this.startAngle+(this.endAngle-this.startAngle)/2,i=(this.outerRadius-this.innerRadius)/2+this.innerRadius;return{x:this.x+Math.cos(t)*i,y:this.y+Math.sin(t)*i}},draw:function(t){var i=this.ctx;i.beginPath(),i.arc(this.x,this.y,this.outerRadius,this.startAngle,this.endAngle),i.arc(this.x,this.y,this.innerRadius,this.endAngle,this.startAngle,!0),i.closePath(),i.strokeStyle=this.strokeColor,i.lineWidth=this.strokeWidth,i.fillStyle=this.fillColor,i.fill(),i.lineJoin="bevel",this.showStroke&&i.stroke()}}),e.Rectangle=e.Element.extend({draw:function(){var t=this.ctx,i=this.width/2,e=this.x-i,s=this.x+i,n=this.base-(this.base-this.y),o=this.strokeWidth/2;this.showStroke&&(e+=o,s-=o,n+=o),t.beginPath(),t.fillStyle=this.fillColor,t.strokeStyle=this.strokeColor,t.lineWidth=this.strokeWidth,t.moveTo(e,this.base),t.lineTo(e,n),t.lineTo(s,n),t.lineTo(s,this.base),t.fill(),this.showStroke&&t.stroke()},height:function(){return this.base-this.y},inRange:function(t,i){return t>=this.x-this.width/2&&t<=this.x+this.width/2&&i>=this.y&&i<=this.base}}),e.Tooltip=e.Element.extend({draw:function(){var t=this.chart.ctx;t.font=W(this.fontSize,this.fontStyle,this.fontFamily),this.xAlign="center",this.yAlign="above";var i=this.caretPadding=2,e=t.measureText(this.text).width+2*this.xPadding,s=this.fontSize+2*this.yPadding,n=s+this.caretHeight+i;this.x+e/2>this.chart.width?this.xAlign="left":this.x-e/2<0&&(this.xAlign="right"),this.y-n<0&&(this.yAlign="below");var o=this.x-e/2,a=this.y-n;if(t.fillStyle=this.fillColor,this.custom)this.custom(this);else{switch(this.yAlign){case"above":t.beginPath(),t.moveTo(this.x,this.y-i),t.lineTo(this.x+this.caretHeight,this.y-(i+this.caretHeight)),t.lineTo(this.x-this.caretHeight,this.y-(i+this.caretHeight)),t.closePath(),t.fill();break;case"below":a=this.y+i+this.caretHeight,t.beginPath(),t.moveTo(this.x,this.y+i),t.lineTo(this.x+this.caretHeight,this.y+i+this.caretHeight),t.lineTo(this.x-this.caretHeight,this.y+i+this.caretHeight),t.closePath(),t.fill()}switch(this.xAlign){case"left":o=this.x-e+(this.cornerRadius+this.caretHeight);break;case"right":o=this.x-(this.cornerRadius+this.caretHeight)}B(t,o,a,e,s,this.cornerRadius),t.fill(),t.fillStyle=this.textColor,t.textAlign="center",t.textBaseline="middle",t.fillText(this.text,o+e/2,a+s/2)}}}),e.MultiTooltip=e.Element.extend({initialize:function(){this.font=W(this.fontSize,this.fontStyle,this.fontFamily),this.titleFont=W(this.titleFontSize,this.titleFontStyle,this.titleFontFamily),this.height=this.labels.length*this.fontSize+(this.labels.length-1)*(this.fontSize/2)+2*this.yPadding+1.5*this.titleFontSize,this.ctx.font=this.titleFont;var t=this.ctx.measureText(this.title).width,i=z(this.ctx,this.font,this.labels)+this.fontSize+3,e=g([i,t]);this.width=e+2*this.xPadding;var s=this.height/2;this.y-s<0?this.y=s:this.y+s>this.chart.height&&(this.y=this.chart.height-s),this.x>this.chart.width/2?this.x-=this.xOffset+this.width:this.x+=this.xOffset},getLineHeight:function(t){var i=this.y-this.height/2+this.yPadding,e=t-1;return 0===t?i+this.titleFontSize/2:i+(1.5*this.fontSize*e+this.fontSize/2)+1.5*this.titleFontSize},draw:function(){if(this.custom)this.custom(this);else{B(this.ctx,this.x,this.y-this.height/2,this.width,this.height,this.cornerRadius);var t=this.ctx;t.fillStyle=this.fillColor,t.fill(),t.closePath(),t.textAlign="left",t.textBaseline="middle",t.fillStyle=this.titleTextColor,t.font=this.titleFont,t.fillText(this.title,this.x+this.xPadding,this.getLineHeight(0)),t.font=this.font,s.each(this.labels,function(i,e){t.fillStyle=this.textColor,t.fillText(i,this.x+this.xPadding+this.fontSize+3,this.getLineHeight(e+1)),t.fillStyle=this.legendColorBackground,t.fillRect(this.x+this.xPadding,this.getLineHeight(e+1)-this.fontSize/2,this.fontSize,this.fontSize),t.fillStyle=this.legendColors[e].fill,t.fillRect(this.x+this.xPadding,this.getLineHeight(e+1)-this.fontSize/2,this.fontSize,this.fontSize)},this)}}}),e.Scale=e.Element.extend({initialize:function(){this.fit()},buildYLabels:function(){this.yLabels=[];for(var t=v(this.stepValue),i=0;i<=this.steps;i++)this.yLabels.push(C(this.templateString,{value:(this.min+i*this.stepValue).toFixed(t)}));this.yLabelWidth=this.display&&this.showLabels?z(this.ctx,this.font,this.yLabels):0},addXLabel:function(t){this.xLabels.push(t),this.valuesCount++,this.fit()},removeXLabel:function(){this.xLabels.shift(),this.valuesCount--,this.fit()},fit:function(){this.startPoint=this.display?this.fontSize:0,this.endPoint=this.display?this.height-1.5*this.fontSize-5:this.height,this.startPoint+=this.padding,this.endPoint-=this.padding;var t,i=this.endPoint-this.startPoint;for(this.calculateYRange(i),this.buildYLabels(),this.calculateXLabelRotation();i>this.endPoint-this.startPoint;)i=this.endPoint-this.startPoint,t=this.yLabelWidth,this.calculateYRange(i),this.buildYLabels(),tthis.yLabelWidth+10?e/2:this.yLabelWidth+10,this.xLabelRotation=0,this.display){var n,o=z(this.ctx,this.font,this.xLabels);this.xLabelWidth=o;for(var a=Math.floor(this.calculateX(1)-this.calculateX(0))-6;this.xLabelWidth>a&&0===this.xLabelRotation||this.xLabelWidth>a&&this.xLabelRotation<=90&&this.xLabelRotation>0;)n=Math.cos(S(this.xLabelRotation)),t=n*e,i=n*s,t+this.fontSize/2>this.yLabelWidth+8&&(this.xScalePaddingLeft=t+this.fontSize/2),this.xScalePaddingRight=this.fontSize/2,this.xLabelRotation++,this.xLabelWidth=n*o;this.xLabelRotation>0&&(this.endPoint-=Math.sin(S(this.xLabelRotation))*o+3)}else this.xLabelWidth=0,this.xScalePaddingRight=this.padding,this.xScalePaddingLeft=this.padding},calculateYRange:c,drawingArea:function(){return this.startPoint-this.endPoint},calculateY:function(t){var i=this.drawingArea()/(this.min-this.max);return this.endPoint-i*(t-this.min)},calculateX:function(t){var i=(this.xLabelRotation>0,this.width-(this.xScalePaddingLeft+this.xScalePaddingRight)),e=i/Math.max(this.valuesCount-(this.offsetGridLines?0:1),1),s=e*t+this.xScalePaddingLeft;return this.offsetGridLines&&(s+=e/2),Math.round(s)},update:function(t){s.extend(this,t),this.fit()},draw:function(){var t=this.ctx,i=(this.endPoint-this.startPoint)/this.steps,e=Math.round(this.xScalePaddingLeft);this.display&&(t.fillStyle=this.textColor,t.font=this.font,n(this.yLabels,function(n,o){var a=this.endPoint-i*o,h=Math.round(a),l=this.showHorizontalLines;t.textAlign="right",t.textBaseline="middle",this.showLabels&&t.fillText(n,e-10,a),0!==o||l||(l=!0),l&&t.beginPath(),o>0?(t.lineWidth=this.gridLineWidth,t.strokeStyle=this.gridLineColor):(t.lineWidth=this.lineWidth,t.strokeStyle=this.lineColor),h+=s.aliasPixel(t.lineWidth),l&&(t.moveTo(e,h),t.lineTo(this.width,h),t.stroke(),t.closePath()),t.lineWidth=this.lineWidth,t.strokeStyle=this.lineColor,t.beginPath(),t.moveTo(e-5,h),t.lineTo(e,h),t.stroke(),t.closePath()},this),n(this.xLabels,function(i,e){var s=this.calculateX(e)+x(this.lineWidth),n=this.calculateX(e-(this.offsetGridLines?.5:0))+x(this.lineWidth),o=this.xLabelRotation>0,a=this.showVerticalLines;0!==e||a||(a=!0),a&&t.beginPath(),e>0?(t.lineWidth=this.gridLineWidth,t.strokeStyle=this.gridLineColor):(t.lineWidth=this.lineWidth,t.strokeStyle=this.lineColor),a&&(t.moveTo(n,this.endPoint),t.lineTo(n,this.startPoint-3),t.stroke(),t.closePath()),t.lineWidth=this.lineWidth,t.strokeStyle=this.lineColor,t.beginPath(),t.moveTo(n,this.endPoint),t.lineTo(n,this.endPoint+5),t.stroke(),t.closePath(),t.save(),t.translate(s,o?this.endPoint+12:this.endPoint+8),t.rotate(-1*S(this.xLabelRotation)),t.font=this.font,t.textAlign=o?"right":"center",t.textBaseline=o?"middle":"top",t.fillText(i,0,0),t.restore()},this))}}),e.RadialScale=e.Element.extend({initialize:function(){this.size=m([this.height,this.width]),this.drawingArea=this.display?this.size/2-(this.fontSize/2+this.backdropPaddingY):this.size/2},calculateCenterOffset:function(t){var i=this.drawingArea/(this.max-this.min);return(t-this.min)*i},update:function(){this.lineArc?this.drawingArea=this.display?this.size/2-(this.fontSize/2+this.backdropPaddingY):this.size/2:this.setScaleSize(),this.buildYLabels()},buildYLabels:function(){this.yLabels=[];for(var t=v(this.stepValue),i=0;i<=this.steps;i++)this.yLabels.push(C(this.templateString,{value:(this.min+i*this.stepValue).toFixed(t)}))},getCircumference:function(){return 2*Math.PI/this.valuesCount},setScaleSize:function(){var t,i,e,s,n,o,a,h,l,r,c,u,d=m([this.height/2-this.pointLabelFontSize-5,this.width/2]),p=this.width,g=0;for(this.ctx.font=W(this.pointLabelFontSize,this.pointLabelFontStyle,this.pointLabelFontFamily),i=0;ip&&(p=t.x+s,n=i),t.x-sp&&(p=t.x+e,n=i):i>this.valuesCount/2&&t.x-e0){var s,n=e*(this.drawingArea/this.steps),o=this.yCenter-n;if(this.lineWidth>0)if(t.strokeStyle=this.lineColor,t.lineWidth=this.lineWidth,this.lineArc)t.beginPath(),t.arc(this.xCenter,this.yCenter,n,0,2*Math.PI),t.closePath(),t.stroke();else{t.beginPath();for(var a=0;a=0;i--){if(this.angleLineWidth>0){var e=this.getPointPosition(i,this.calculateCenterOffset(this.max));t.beginPath(),t.moveTo(this.xCenter,this.yCenter),t.lineTo(e.x,e.y),t.stroke(),t.closePath()}var s=this.getPointPosition(i,this.calculateCenterOffset(this.max)+5);t.font=W(this.pointLabelFontSize,this.pointLabelFontStyle,this.pointLabelFontFamily),t.fillStyle=this.pointLabelFontColor;var o=this.labels.length,a=this.labels.length/2,h=a/2,l=h>i||i>o-h,r=i===h||i===o-h;t.textAlign=0===i?"center":i===a?"center":a>i?"left":"right",t.textBaseline=r?"middle":l?"bottom":"top",t.fillText(this.labels[i],s.x,s.y)}}}}}),s.addEvent(window,"resize",function(){var t;return function(){clearTimeout(t),t=setTimeout(function(){n(e.instances,function(t){t.options.responsive&&t.resize(t.render,!0)})},50)}}()),p?define(function(){return e}):"object"==typeof module&&module.exports&&(module.exports=e),t.Chart=e,e.noConflict=function(){return t.Chart=i,e}}).call(this),function(){"use strict";var t=this,i=t.Chart,e=i.helpers,s={scaleBeginAtZero:!0,scaleShowGridLines:!0,scaleGridLineColor:"rgba(0,0,0,.05)",scaleGridLineWidth:1,scaleShowHorizontalLines:!0,scaleShowVerticalLines:!0,barShowStroke:!0,barStrokeWidth:2,barValueSpacing:5,barDatasetSpacing:1,legendTemplate:'
    <% for (var i=0; i
  • <%if(datasets[i].label){%><%=datasets[i].label%><%}%>
    • <%}%>
'};i.Type.extend({name:"Bar",defaults:s,initialize:function(t){var s=this.options;this.ScaleClass=i.Scale.extend({offsetGridLines:!0,calculateBarX:function(t,i,e){var n=this.calculateBaseWidth(),o=this.calculateX(e)-n/2,a=this.calculateBarWidth(t);return o+a*i+i*s.barDatasetSpacing+a/2},calculateBaseWidth:function(){return this.calculateX(1)-this.calculateX(0)-2*s.barValueSpacing},calculateBarWidth:function(t){var i=this.calculateBaseWidth()-(t-1)*s.barDatasetSpacing;return i/t}}),this.datasets=[],this.options.showTooltips&&e.bindEvents(this,this.options.tooltipEvents,function(t){var i="mouseout"!==t.type?this.getBarsAtEvent(t):[];this.eachBars(function(t){t.restore(["fillColor","strokeColor"])}),e.each(i,function(t){t.fillColor=t.highlightFill,t.strokeColor=t.highlightStroke}),this.showTooltip(i)}),this.BarClass=i.Rectangle.extend({strokeWidth:this.options.barStrokeWidth,showStroke:this.options.barShowStroke,ctx:this.chart.ctx}),e.each(t.datasets,function(i){var s={label:i.label||null,fillColor:i.fillColor,strokeColor:i.strokeColor,bars:[]};this.datasets.push(s),e.each(i.data,function(e,n){s.bars.push(new this.BarClass({value:e,label:t.labels[n],datasetLabel:i.label,strokeColor:i.strokeColor,fillColor:i.fillColor,highlightFill:i.highlightFill||i.fillColor,highlightStroke:i.highlightStroke||i.strokeColor}))},this)},this),this.buildScale(t.labels),this.BarClass.prototype.base=this.scale.endPoint,this.eachBars(function(t,i,s){e.extend(t,{width:this.scale.calculateBarWidth(this.datasets.length),x:this.scale.calculateBarX(this.datasets.length,s,i),y:this.scale.endPoint}),t.save()},this),this.render()},update:function(){this.scale.update(),e.each(this.activeElements,function(t){t.restore(["fillColor","strokeColor"])}),this.eachBars(function(t){t.save()}),this.render()},eachBars:function(t){e.each(this.datasets,function(i,s){e.each(i.bars,t,this,s)},this)},getBarsAtEvent:function(t){for(var i,s=[],n=e.getRelativePosition(t),o=function(t){s.push(t.bars[i])},a=0;a<% for (var i=0; i
  • <%if(segments[i].label){%><%=segments[i].label%><%}%>
    • <%}%>'};i.Type.extend({name:"Doughnut",defaults:s,initialize:function(t){this.segments=[],this.outerRadius=(e.min([this.chart.width,this.chart.height])-this.options.segmentStrokeWidth/2)/2,this.SegmentArc=i.Arc.extend({ctx:this.chart.ctx,x:this.chart.width/2,y:this.chart.height/2}),this.options.showTooltips&&e.bindEvents(this,this.options.tooltipEvents,function(t){var i="mouseout"!==t.type?this.getSegmentsAtEvent(t):[];e.each(this.segments,function(t){t.restore(["fillColor"])}),e.each(i,function(t){t.fillColor=t.highlightColor}),this.showTooltip(i)}),this.calculateTotal(t),e.each(t,function(t,i){this.addData(t,i,!0)},this),this.render()},getSegmentsAtEvent:function(t){var i=[],s=e.getRelativePosition(t);return e.each(this.segments,function(t){t.inRange(s.x,s.y)&&i.push(t)},this),i},addData:function(t,i,e){var s=i||this.segments.length;this.segments.splice(s,0,new this.SegmentArc({value:t.value,outerRadius:this.options.animateScale?0:this.outerRadius,innerRadius:this.options.animateScale?0:this.outerRadius/100*this.options.percentageInnerCutout,fillColor:t.color,highlightColor:t.highlight||t.color,showStroke:this.options.segmentShowStroke,strokeWidth:this.options.segmentStrokeWidth,strokeColor:this.options.segmentStrokeColor,startAngle:1.5*Math.PI,circumference:this.options.animateRotate?0:this.calculateCircumference(t.value),label:t.label})),e||(this.reflow(),this.update())},calculateCircumference:function(t){return 2*Math.PI*(Math.abs(t)/this.total)},calculateTotal:function(t){this.total=0,e.each(t,function(t){this.total+=Math.abs(t.value)},this)},update:function(){this.calculateTotal(this.segments),e.each(this.activeElements,function(t){t.restore(["fillColor"])}),e.each(this.segments,function(t){t.save()}),this.render()},removeData:function(t){var i=e.isNumber(t)?t:this.segments.length-1;this.segments.splice(i,1),this.reflow(),this.update()},reflow:function(){e.extend(this.SegmentArc.prototype,{x:this.chart.width/2,y:this.chart.height/2}),this.outerRadius=(e.min([this.chart.width,this.chart.height])-this.options.segmentStrokeWidth/2)/2,e.each(this.segments,function(t){t.update({outerRadius:this.outerRadius,innerRadius:this.outerRadius/100*this.options.percentageInnerCutout})},this)},draw:function(t){var i=t?t:1;this.clear(),e.each(this.segments,function(t,e){t.transition({circumference:this.calculateCircumference(t.value),outerRadius:this.outerRadius,innerRadius:this.outerRadius/100*this.options.percentageInnerCutout},i),t.endAngle=t.startAngle+t.circumference,t.draw(),0===e&&(t.startAngle=1.5*Math.PI),e<% for (var i=0; i
  • <%if(datasets[i].label){%><%=datasets[i].label%><%}%>
    • <%}%>'};i.Type.extend({name:"Line",defaults:s,initialize:function(t){this.PointClass=i.Point.extend({strokeWidth:this.options.pointDotStrokeWidth,radius:this.options.pointDotRadius,display:this.options.pointDot,hitDetectionRadius:this.options.pointHitDetectionRadius,ctx:this.chart.ctx,inRange:function(t){return Math.pow(t-this.x,2)0&&ithis.scale.endPoint?t.controlPoints.outer.y=this.scale.endPoint:t.controlPoints.outer.ythis.scale.endPoint?t.controlPoints.inner.y=this.scale.endPoint:t.controlPoints.inner.y0&&(s.lineTo(h[h.length-1].x,this.scale.endPoint),s.lineTo(h[0].x,this.scale.endPoint),s.fillStyle=t.fillColor,s.closePath(),s.fill()),e.each(h,function(t){t.draw()})},this)}})}.call(this),function(){"use strict";var t=this,i=t.Chart,e=i.helpers,s={scaleShowLabelBackdrop:!0,scaleBackdropColor:"rgba(255,255,255,0.75)",scaleBeginAtZero:!0,scaleBackdropPaddingY:2,scaleBackdropPaddingX:2,scaleShowLine:!0,segmentShowStroke:!0,segmentStrokeColor:"#fff",segmentStrokeWidth:2,animationSteps:100,animationEasing:"easeOutBounce",animateRotate:!0,animateScale:!1,legendTemplate:'
      <% for (var i=0; i
    • <%if(segments[i].label){%><%=segments[i].label%><%}%>
      • <%}%>
    '};i.Type.extend({name:"PolarArea",defaults:s,initialize:function(t){this.segments=[],this.SegmentArc=i.Arc.extend({showStroke:this.options.segmentShowStroke,strokeWidth:this.options.segmentStrokeWidth,strokeColor:this.options.segmentStrokeColor,ctx:this.chart.ctx,innerRadius:0,x:this.chart.width/2,y:this.chart.height/2}),this.scale=new i.RadialScale({display:this.options.showScale,fontStyle:this.options.scaleFontStyle,fontSize:this.options.scaleFontSize,fontFamily:this.options.scaleFontFamily,fontColor:this.options.scaleFontColor,showLabels:this.options.scaleShowLabels,showLabelBackdrop:this.options.scaleShowLabelBackdrop,backdropColor:this.options.scaleBackdropColor,backdropPaddingY:this.options.scaleBackdropPaddingY,backdropPaddingX:this.options.scaleBackdropPaddingX,lineWidth:this.options.scaleShowLine?this.options.scaleLineWidth:0,lineColor:this.options.scaleLineColor,lineArc:!0,width:this.chart.width,height:this.chart.height,xCenter:this.chart.width/2,yCenter:this.chart.height/2,ctx:this.chart.ctx,templateString:this.options.scaleLabel,valuesCount:t.length}),this.updateScaleRange(t),this.scale.update(),e.each(t,function(t,i){this.addData(t,i,!0)},this),this.options.showTooltips&&e.bindEvents(this,this.options.tooltipEvents,function(t){var i="mouseout"!==t.type?this.getSegmentsAtEvent(t):[];e.each(this.segments,function(t){t.restore(["fillColor"])}),e.each(i,function(t){t.fillColor=t.highlightColor}),this.showTooltip(i)}),this.render()},getSegmentsAtEvent:function(t){var i=[],s=e.getRelativePosition(t);return e.each(this.segments,function(t){t.inRange(s.x,s.y)&&i.push(t)},this),i},addData:function(t,i,e){var s=i||this.segments.length;this.segments.splice(s,0,new this.SegmentArc({fillColor:t.color,highlightColor:t.highlight||t.color,label:t.label,value:t.value,outerRadius:this.options.animateScale?0:this.scale.calculateCenterOffset(t.value),circumference:this.options.animateRotate?0:this.scale.getCircumference(),startAngle:1.5*Math.PI})),e||(this.reflow(),this.update())},removeData:function(t){var i=e.isNumber(t)?t:this.segments.length-1;this.segments.splice(i,1),this.reflow(),this.update()},calculateTotal:function(t){this.total=0,e.each(t,function(t){this.total+=t.value},this),this.scale.valuesCount=this.segments.length},updateScaleRange:function(t){var i=[];e.each(t,function(t){i.push(t.value)});var s=this.options.scaleOverride?{steps:this.options.scaleSteps,stepValue:this.options.scaleStepWidth,min:this.options.scaleStartValue,max:this.options.scaleStartValue+this.options.scaleSteps*this.options.scaleStepWidth}:e.calculateScaleRange(i,e.min([this.chart.width,this.chart.height])/2,this.options.scaleFontSize,this.options.scaleBeginAtZero,this.options.scaleIntegersOnly);e.extend(this.scale,s,{size:e.min([this.chart.width,this.chart.height]),xCenter:this.chart.width/2,yCenter:this.chart.height/2})},update:function(){this.calculateTotal(this.segments),e.each(this.segments,function(t){t.save()}),this.reflow(),this.render()},reflow:function(){e.extend(this.SegmentArc.prototype,{x:this.chart.width/2,y:this.chart.height/2}),this.updateScaleRange(this.segments),this.scale.update(),e.extend(this.scale,{xCenter:this.chart.width/2,yCenter:this.chart.height/2}),e.each(this.segments,function(t){t.update({outerRadius:this.scale.calculateCenterOffset(t.value)})},this)},draw:function(t){var i=t||1;this.clear(),e.each(this.segments,function(t,e){t.transition({circumference:this.scale.getCircumference(),outerRadius:this.scale.calculateCenterOffset(t.value)},i),t.endAngle=t.startAngle+t.circumference,0===e&&(t.startAngle=1.5*Math.PI),e<% for (var i=0; i
  • <%if(datasets[i].label){%><%=datasets[i].label%><%}%>
    • <%}%>'},initialize:function(t){this.PointClass=i.Point.extend({strokeWidth:this.options.pointDotStrokeWidth,radius:this.options.pointDotRadius,display:this.options.pointDot,hitDetectionRadius:this.options.pointHitDetectionRadius,ctx:this.chart.ctx}),this.datasets=[],this.buildScale(t),this.options.showTooltips&&e.bindEvents(this,this.options.tooltipEvents,function(t){var i="mouseout"!==t.type?this.getPointsAtEvent(t):[];this.eachPoints(function(t){t.restore(["fillColor","strokeColor"])}),e.each(i,function(t){t.fillColor=t.highlightFill,t.strokeColor=t.highlightStroke}),this.showTooltip(i)}),e.each(t.datasets,function(i){var s={label:i.label||null,fillColor:i.fillColor,strokeColor:i.strokeColor,pointColor:i.pointColor,pointStrokeColor:i.pointStrokeColor,points:[]};this.datasets.push(s),e.each(i.data,function(e,n){var o;this.scale.animation||(o=this.scale.getPointPosition(n,this.scale.calculateCenterOffset(e))),s.points.push(new this.PointClass({value:e,label:t.labels[n],datasetLabel:i.label,x:this.options.animation?this.scale.xCenter:o.x,y:this.options.animation?this.scale.yCenter:o.y,strokeColor:i.pointStrokeColor,fillColor:i.pointColor,highlightFill:i.pointHighlightFill||i.pointColor,highlightStroke:i.pointHighlightStroke||i.pointStrokeColor}))},this)},this),this.render()},eachPoints:function(t){e.each(this.datasets,function(i){e.each(i.points,t,this)},this)},getPointsAtEvent:function(t){var i=e.getRelativePosition(t),s=e.getAngleFromPoint({x:this.scale.xCenter,y:this.scale.yCenter},i),n=2*Math.PI/this.scale.valuesCount,o=Math.round((s.angle-1.5*Math.PI)/n),a=[];return(o>=this.scale.valuesCount||0>o)&&(o=0),s.distance<=this.scale.drawingArea&&e.each(this.datasets,function(t){a.push(t.points[o])}),a},buildScale:function(t){this.scale=new i.RadialScale({display:this.options.showScale,fontStyle:this.options.scaleFontStyle,fontSize:this.options.scaleFontSize,fontFamily:this.options.scaleFontFamily,fontColor:this.options.scaleFontColor,showLabels:this.options.scaleShowLabels,showLabelBackdrop:this.options.scaleShowLabelBackdrop,backdropColor:this.options.scaleBackdropColor,backdropPaddingY:this.options.scaleBackdropPaddingY,backdropPaddingX:this.options.scaleBackdropPaddingX,lineWidth:this.options.scaleShowLine?this.options.scaleLineWidth:0,lineColor:this.options.scaleLineColor,angleLineColor:this.options.angleLineColor,angleLineWidth:this.options.angleShowLineOut?this.options.angleLineWidth:0,pointLabelFontColor:this.options.pointLabelFontColor,pointLabelFontSize:this.options.pointLabelFontSize,pointLabelFontFamily:this.options.pointLabelFontFamily,pointLabelFontStyle:this.options.pointLabelFontStyle,height:this.chart.height,width:this.chart.width,xCenter:this.chart.width/2,yCenter:this.chart.height/2,ctx:this.chart.ctx,templateString:this.options.scaleLabel,labels:t.labels,valuesCount:t.datasets[0].data.length}),this.scale.setScaleSize(),this.updateScaleRange(t.datasets),this.scale.buildYLabels()},updateScaleRange:function(t){var i=function(){var i=[];return e.each(t,function(t){t.data?i=i.concat(t.data):e.each(t.points,function(t){i.push(t.value)})}),i}(),s=this.options.scaleOverride?{steps:this.options.scaleSteps,stepValue:this.options.scaleStepWidth,min:this.options.scaleStartValue,max:this.options.scaleStartValue+this.options.scaleSteps*this.options.scaleStepWidth}:e.calculateScaleRange(i,e.min([this.chart.width,this.chart.height])/2,this.options.scaleFontSize,this.options.scaleBeginAtZero,this.options.scaleIntegersOnly);e.extend(this.scale,s)},addData:function(t,i){this.scale.valuesCount++,e.each(t,function(t,e){var s=this.scale.getPointPosition(this.scale.valuesCount,this.scale.calculateCenterOffset(t));this.datasets[e].points.push(new this.PointClass({value:t,label:i,x:s.x,y:s.y,strokeColor:this.datasets[e].pointStrokeColor,fillColor:this.datasets[e].pointColor}))},this),this.scale.labels.push(i),this.reflow(),this.update()},removeData:function(){this.scale.valuesCount--,this.scale.labels.shift(),e.each(this.datasets,function(t){t.points.shift()},this),this.reflow(),this.update()},update:function(){this.eachPoints(function(t){t.save()}),this.reflow(),this.render()},reflow:function(){e.extend(this.scale,{width:this.chart.width,height:this.chart.height,size:e.min([this.chart.width,this.chart.height]),xCenter:this.chart.width/2,yCenter:this.chart.height/2}),this.updateScaleRange(this.datasets),this.scale.setScaleSize(),this.scale.buildYLabels()},draw:function(t){var i=t||1,s=this.chart.ctx;this.clear(),this.scale.draw(),e.each(this.datasets,function(t){e.each(t.points,function(t,e){t.hasValue()&&t.transition(this.scale.getPointPosition(e,this.scale.calculateCenterOffset(t.value)),i)},this),s.lineWidth=this.options.datasetStrokeWidth,s.strokeStyle=t.strokeColor,s.beginPath(),e.each(t.points,function(t,i){0===i?s.moveTo(t.x,t.y):s.lineTo(t.x,t.y)},this),s.closePath(),s.stroke(),s.fillStyle=t.fillColor,s.fill(),e.each(t.points,function(t){t.hasValue()&&t.draw()})},this)}})}.call(this); //Bootstrap.js +function(a){"use strict";function c(c,d){return this.each(function(){var e=a(this),f=e.data("bs.modal"),g=a.extend({},b.DEFAULTS,e.data(),"object"==typeof c&&c);f||e.data("bs.modal",f=new b(this,g)),"string"==typeof c?f[c](d):g.show&&f.show(d)})}var b=function(b,c){this.options=c,this.$body=a(document.body),this.$element=a(b),this.$dialog=this.$element.find(".modal-dialog"),this.$backdrop=null,this.isShown=null,this.originalBodyPad=null,this.scrollbarWidth=0,this.ignoreBackdropClick=!1,this.options.remote&&this.$element.find(".modal-content").load(this.options.remote,a.proxy(function(){this.$element.trigger("loaded.bs.modal")},this))};b.VERSION="3.3.4",b.TRANSITION_DURATION=300,b.BACKDROP_TRANSITION_DURATION=150,b.DEFAULTS={backdrop:!0,keyboard:!0,show:!0},b.prototype.toggle=function(a){return this.isShown?this.hide():this.show(a)},b.prototype.show=function(c){var d=this,e=a.Event("show.bs.modal",{relatedTarget:c});this.$element.trigger(e),this.isShown||e.isDefaultPrevented()||(this.isShown=!0,this.checkScrollbar(),this.setScrollbar(),this.$body.addClass("modal-open"),this.escape(),this.resize(),this.$element.on("click.dismiss.bs.modal",'[data-dismiss="modal"]',a.proxy(this.hide,this)),this.$dialog.on("mousedown.dismiss.bs.modal",function(){d.$element.one("mouseup.dismiss.bs.modal",function(b){a(b.target).is(d.$element)&&(d.ignoreBackdropClick=!0)})}),this.backdrop(function(){var e=a.support.transition&&d.$element.hasClass("fade");d.$element.parent().length||d.$element.appendTo(d.$body),d.$element.show().scrollTop(0),d.adjustDialog(),e&&d.$element[0].offsetWidth,d.$element.addClass("in").attr("aria-hidden",!1),d.enforceFocus();var f=a.Event("shown.bs.modal",{relatedTarget:c});e?d.$dialog.one("bsTransitionEnd",function(){d.$element.trigger("focus").trigger(f)}).emulateTransitionEnd(b.TRANSITION_DURATION):d.$element.trigger("focus").trigger(f)}))},b.prototype.hide=function(c){c&&c.preventDefault(),c=a.Event("hide.bs.modal"),this.$element.trigger(c),this.isShown&&!c.isDefaultPrevented()&&(this.isShown=!1,this.escape(),this.resize(),a(document).off("focusin.bs.modal"),this.$element.removeClass("in").attr("aria-hidden",!0).off("click.dismiss.bs.modal").off("mouseup.dismiss.bs.modal"),this.$dialog.off("mousedown.dismiss.bs.modal"),a.support.transition&&this.$element.hasClass("fade")?this.$element.one("bsTransitionEnd",a.proxy(this.hideModal,this)).emulateTransitionEnd(b.TRANSITION_DURATION):this.hideModal())},b.prototype.enforceFocus=function(){a(document).off("focusin.bs.modal").on("focusin.bs.modal",a.proxy(function(a){this.$element[0]===a.target||this.$element.has(a.target).length||this.$element.trigger("focus")},this))},b.prototype.escape=function(){this.isShown&&this.options.keyboard?this.$element.on("keydown.dismiss.bs.modal",a.proxy(function(a){27==a.which&&this.hide()},this)):this.isShown||this.$element.off("keydown.dismiss.bs.modal")},b.prototype.resize=function(){this.isShown?a(window).on("resize.bs.modal",a.proxy(this.handleUpdate,this)):a(window).off("resize.bs.modal")},b.prototype.hideModal=function(){var a=this;this.$element.hide(),this.backdrop(function(){a.$body.removeClass("modal-open"),a.resetAdjustments(),a.resetScrollbar(),a.$element.trigger("hidden.bs.modal")})},b.prototype.removeBackdrop=function(){this.$backdrop&&this.$backdrop.remove(),this.$backdrop=null},b.prototype.backdrop=function(c){var d=this,e=this.$element.hasClass("fade")?"fade":"";if(this.isShown&&this.options.backdrop){var f=a.support.transition&&e;if(this.$backdrop=a('
    ').appendTo(this.$body),this.$element.on("click.dismiss.bs.modal",a.proxy(function(a){return this.ignoreBackdropClick?(this.ignoreBackdropClick=!1,void 0):(a.target===a.currentTarget&&("static"==this.options.backdrop?this.$element[0].focus():this.hide()),void 0)},this)),f&&this.$backdrop[0].offsetWidth,this.$backdrop.addClass("in"),!c)return;f?this.$backdrop.one("bsTransitionEnd",c).emulateTransitionEnd(b.BACKDROP_TRANSITION_DURATION):c()}else if(!this.isShown&&this.$backdrop){this.$backdrop.removeClass("in");var g=function(){d.removeBackdrop(),c&&c()};a.support.transition&&this.$element.hasClass("fade")?this.$backdrop.one("bsTransitionEnd",g).emulateTransitionEnd(b.BACKDROP_TRANSITION_DURATION):g()}else c&&c()},b.prototype.handleUpdate=function(){this.adjustDialog()},b.prototype.adjustDialog=function(){var a=this.$element[0].scrollHeight>document.documentElement.clientHeight;this.$element.css({paddingLeft:!this.bodyIsOverflowing&&a?this.scrollbarWidth:"",paddingRight:this.bodyIsOverflowing&&!a?this.scrollbarWidth:""})},b.prototype.resetAdjustments=function(){this.$element.css({paddingLeft:"",paddingRight:""})},b.prototype.checkScrollbar=function(){var a=window.innerWidth;if(!a){var b=document.documentElement.getBoundingClientRect();a=b.right-Math.abs(b.left)}this.bodyIsOverflowing=document.body.clientWidth Smart Relay

    Smart Relay

    Speed Test

    Connecting...

    START
    ================================================ FILE: app/http/http.h ================================================ /* * ---------------------------------------------------------------------------- * "THE BEER-WARE LICENSE" (Revision 42): * Israel Lot and Jeroen Domburg * wrote this file. As long as you retain this notice you can do whatever you * want with this stuff. If we meet some day, and you think this stuff is * worth it, you can buy us a beer in return. * ---------------------------------------------------------------------------- */ #ifndef __HTTP_H #define __HTTP_H #define HTTP_BUFFER_SIZE 1460 // Let's keep it close the TCP MTU (maximum transmit unit) ( 1460 on this lwip ) //so we will send a whole packet per time #define MAX_HEADERS 10 #define URL_MAX_SIZE 256 #include "http_parser.h" #include "espconn.h" #include "lwip/ip_addr.h" typedef struct http_connection http_connection; typedef int (*http_callback)(http_connection *c); //callback function typedef int (*cgi_execute_function)(http_connection *c); //cgi execute function typedef struct { const char * key; char * value; uint8_t save; } header; typedef struct { uint8_t *buffer; uint8_t *bufferPos; header headers[MAX_HEADERS]; } http_buffer; typedef struct { cgi_execute_function execute; http_callback function; void *data; const void *argument; uint8_t done; uint32_t flags; } cgi_struct; struct http_connection{ uint8_t type; struct espconn *espConnection; struct espconn client_connection; esp_tcp client_tcp; ip_addr_t host_ip; os_timer_t timeout_timer; enum http_method method; char * request_body; struct http_parser parser; struct http_parser_settings parser_settings; uint8_t state; char url[URL_MAX_SIZE]; struct http_parser_url url_parsed; //headers header headers[MAX_HEADERS]; //body struct { uint8_t save; char *data; size_t len; } body; cgi_struct cgi; http_buffer output; //websocket related uint8_t handshake_ok; void *reverse; }; #endif ================================================ FILE: app/http/http_client.c ================================================ /* * ---------------------------------------------------------------------------- * "THE BEER-WARE LICENSE" (Revision 42): * Israel Lot and Jeroen Domburg * wrote this file. As long as you retain this notice you can do whatever you * want with this stuff. If we meet some day, and you think this stuff is * worth it, you can buy us a beer in return. * ---------------------------------------------------------------------------- */ #include "osapi.h" #include "c_string.h" #include "user_interface.h" #include "mem.h" #include "espconn.h" #include "platform.h" #include "user_config.h" #include "lwip/dns.h" #include "http.h" #include "http_client.h" #include "http_parser.h" #include "http_helper.h" #include "http_process.h" void ICACHE_FLASH_ATTR http_client_request_execute(http_connection *c) { NODE_DBG("http_client_request_execute "); if(c->state==HTTP_CLIENT_CONNECT_OK){ //we should send request headers char * path = http_url_get_path(c); char * query = http_url_get_query(c); char * requestPath; if(query!=NULL){ requestPath = (char *)os_zalloc(strlen(path)+strlen(query)+2); os_strcpy(requestPath,path); os_strcat(requestPath,"?"); os_strcat(requestPath,query); } else{ requestPath = (char *)os_zalloc(strlen(path)+1); os_strcpy(requestPath,path); } if(path==NULL) path = "/"; http_SET_HEADER(c,HTTP_HOST,http_url_get_host(c)); http_SET_HEADER(c,HTTP_USER_AGENT,HTTP_DEFAULT_SERVER); if(c->method==HTTP_GET){ http_request_GET(c,requestPath); os_free(requestPath); } else if(c->method==HTTP_POST){ http_request_POST(c,requestPath); os_free(requestPath); } else return; c->state=HTTP_CLIENT_REQUEST_HEADERS_SENT; http_transmit(c); // send request } else if(c->state==HTTP_CLIENT_REQUEST_HEADERS_SENT){ //we can now send the body if(c->request_body!=NULL){ //body is already here, send int bodyLen = os_strlen(c->request_body); if(bodyLen>=HTTP_BUFFER_SIZE){ http_nwrite(c,c->request_body,HTTP_BUFFER_SIZE); c->request_body+=HTTP_BUFFER_SIZE; } else http_write(c,c->request_body); http_transmit(c); } else{ //callback so body can be sent elsewhere http_execute_cgi(c); } c->state=HTTP_CLIENT_REQUEST_BODY_SENT; } } void ICACHE_FLASH_ATTR http_client_dns_found_cb(const char *name, ip_addr_t *ipaddr, void *arg){ NODE_DBG("http_client_dns_callback conn=%p",arg); http_connection *c = (http_connection*)arg; if(c==NULL) return; os_timer_disarm(&c->timeout_timer); c->host_ip.addr=ipaddr->addr; if(name!=NULL && ipaddr!=NULL){ #ifdef DEVELOP_VERSION NODE_DBG("http_client_dns_callback: %s %d.%d.%d.%d", name, ip4_addr1(&ipaddr->addr), ip4_addr2(&ipaddr->addr), ip4_addr3(&ipaddr->addr), ip4_addr4(&ipaddr->addr)); #endif //set ip on tcp c->espConnection->proto.tcp->remote_ip[0]=ip4_addr1(&ipaddr->addr); c->espConnection->proto.tcp->remote_ip[1]=ip4_addr2(&ipaddr->addr); c->espConnection->proto.tcp->remote_ip[2]=ip4_addr3(&ipaddr->addr); c->espConnection->proto.tcp->remote_ip[3]=ip4_addr4(&ipaddr->addr); //DNS found c->state = HTTP_CLIENT_DNS_FOUND; } else{ //DNS found c->state = HTTP_CLIENT_DNS_NOT_FOUND; } http_execute_cgi(c); } void ICACHE_FLASH_ATTR http_client_dns_timeout(void *arg){ NODE_DBG("http_client_dns_timeout"); http_connection *c = (http_connection*)arg; // put null so if dns query response arrives, it wont trigger // execute again c->espConnection->reverse=NULL; c->state = HTTP_CLIENT_DNS_NOT_FOUND; http_execute_cgi(c); } void ICACHE_FLASH_ATTR http_client_dns(http_connection *c){ char * host = http_url_get_host(c); NODE_DBG("http_client_dns: %s",host); os_memset(&c->host_ip,0,sizeof(ip_addr_t)); dns_gethostbyname(host, &c->host_ip, &http_client_dns_found_cb,(void*)c); os_timer_disarm(&c->timeout_timer); os_timer_setfn(&c->timeout_timer, (os_timer_func_t *)http_client_dns_timeout, c); os_timer_arm(&c->timeout_timer, 1000, 0); } void ICACHE_FLASH_ATTR http_client_connect_callback(void *arg) { struct espconn *conn=arg; NODE_DBG("http_client_connect_callback: %d",conn->state==ESPCONN_CONNECT?1:0); http_connection *c = (http_connection *)conn->reverse; if(conn->state==ESPCONN_CONNECT) c->state=HTTP_CLIENT_CONNECT_OK; else c->state=HTTP_CLIENT_CONNECT_FAIL; http_execute_cgi(c); } int ICACHE_FLASH_ATTR http_client_cgi_execute(http_connection *c){ if(c->cgi.function==NULL) return 0; int ret = c->cgi.function(c); if(c->state==HTTP_CLIENT_DNS_NOT_FOUND || (ret== HTTP_CLIENT_CGI_DONE && c->state==HTTP_CLIENT_DNS_FOUND)){ //this was a dns request only NODE_DBG("Client conn %p done after DNS",c); http_process_free_connection(c); return 0; } else if(ret== HTTP_CLIENT_CGI_DONE){ //abort espconn_disconnect(c->espConnection); http_process_free_connection(c); return 0; } if(c->state==HTTP_CLIENT_DNS_FOUND){ //connect espconn_connect(c->espConnection); } if(c->state==HTTP_CLIENT_CONNECT_OK){ //we are ready to make the request http_client_request_execute(c); } if(c->state==HTTP_CLIENT_CONNECT_FAIL){ //free espconn_disconnect(c->espConnection); http_process_free_connection(c); } } http_connection * ICACHE_FLASH_ATTR http_client_new(http_callback callback){ http_connection * client = http_new_connection(0,NULL); if(client==NULL) return NULL; client->cgi.execute=http_client_cgi_execute; client->cgi.function = callback; espconn_regist_connectcb(client->espConnection, http_client_connect_callback); return client; } int ICACHE_FLASH_ATTR http_client_open_url(http_connection *c,char *url){ NODE_DBG("http_client_open_url: %s",url); os_strcpy(c->url,url); http_parse_url(c); //set port if(c->url_parsed.port>0) c->client_connection.proto.tcp->remote_port=c->url_parsed.port; else c->client_connection.proto.tcp->remote_port=80; http_client_dns(c); return 1; } int ICACHE_FLASH_ATTR http_client_GET(http_connection *c,char *url){ c->method=HTTP_GET; return http_client_open_url(c,url); } ================================================ FILE: app/http/http_client.h ================================================ /* * ---------------------------------------------------------------------------- * "THE BEER-WARE LICENSE" (Revision 42): * Israel Lot and Jeroen Domburg * wrote this file. As long as you retain this notice you can do whatever you * want with this stuff. If we meet some day, and you think this stuff is * worth it, you can buy us a beer in return. * ---------------------------------------------------------------------------- */ #ifndef __HTTP_CLIENT_H #define __HTTP_CLIENT_H http_connection * ICACHE_FLASH_ATTR http_client_new(http_callback callback); int ICACHE_FLASH_ATTR http_client_open_url(http_connection *c,char *url); #endif ================================================ FILE: app/http/http_helper.c ================================================ /* * ---------------------------------------------------------------------------- * "THE BEER-WARE LICENSE" (Revision 42): * Israel Lot and Jeroen Domburg * wrote this file. As long as you retain this notice you can do whatever you * want with this stuff. If we meet some day, and you think this stuff is * worth it, you can buy us a beer in return. * ---------------------------------------------------------------------------- */ #include "c_types.h" #include "user_interface.h" #include "espconn.h" #include "mem.h" #include "osapi.h" #include "c_stdio.h" #include "user_config.h" #include "espconn.h" #include "http.h" #include "http_parser.h" #include "http_server.h" #include "http_process.h" #include "http_helper.h" #include "json/cJson.h" //Struct to keep extension->mime data in typedef struct { const char *ext; const char *mimetype; } MimeMap;////The mappings from file extensions to mime types. If you need an extra mime type, //add it here. static const MimeMap mimeTypes[]={ {"htm", "text/htm"}, {"html", "text/html"}, {"css", "text/css"}, {"js", "text/javascript"}, {"txt", "text/plain"}, {"jpg", "image/jpeg"}, {"jpeg", "image/jpeg"}, {"png", "image/png"}, {"json","application/json"}, {"svg","image/svg+xml"}, {NULL, "text/html"}, //default value }; int ICACHE_FLASH_ATTR http_reset_buffer(http_connection *c){ //reset buffer os_memset(c->output.buffer,0,HTTP_BUFFER_SIZE); c->output.bufferPos = c->output.buffer; return 1; } int ICACHE_FLASH_ATTR http_write_json(http_connection *c,cJSON *root){ char * json_string; json_string = cJSON_Print(root); int ret = http_write(c,json_string); os_free(json_string); return ret; } int ICACHE_FLASH_ATTR http_end_line(http_connection *c){ return http_write(c,"\r\n"); } int ICACHE_FLASH_ATTR http_SET_HEADER(http_connection *c,const char * header,const char * value){ NODE_DBG("Setting header: %s : %s",header,value); int j=0; while(c->output.headers[j].key!=NULL && j< MAX_HEADERS){ if(os_strcmp(c->output.headers[j].key,header)==0){ //header already on the list, overwrite if(c->output.headers[j].value!=NULL){ os_free(c->output.headers[j].value); } break; } j++; } if(j==MAX_HEADERS) return 0; c->output.headers[j].key=header; c->output.headers[j].value=(char *) os_malloc(strlen(value)+1); if(c->output.headers[j].value==NULL){ NODE_DBG("Failed to alloc header memory"); return 0; } os_strcpy(c->output.headers[j].value,value); return 1; } int ICACHE_FLASH_ATTR http_SET_CONTENT_LENGTH(http_connection *c,int len){ char buff[10]; os_sprintf(buff,"%d",len); return http_SET_HEADER(c,HTTP_CONTENT_LENGTH,buff); } int ICACHE_FLASH_ATTR http_HEADER(http_connection *c,const char *header,const char *value){ NODE_DBG("Writing header: %s : %s",header,value); return http_write(c,header) && http_write(c,": ") && http_write(c,value) && http_end_line(c); } int ICACHE_FLASH_ATTR http_end_headers(http_connection *c){ //write cached headers int j=0; while(j< MAX_HEADERS){ if(c->output.headers[j].key!=NULL){ //write header http_HEADER(c,c->output.headers[j].key,c->output.headers[j].value); //free header os_free(c->output.headers[j].value); c->output.headers[j].value=NULL; c->output.headers[j].key=NULL; } j++; } //write final empty line return http_end_line(c); } //REQUEST int ICACHE_FLASH_ATTR http_request_start(http_connection *c,const char *method,const char *path){ http_reset_buffer(c); int ret = http_write(c,method) && http_write(c," ") && http_write(c,path) && http_write(c," HTTP/1.0") && http_end_line(c) && http_HEADER(c,HTTP_CONNECTION,"Close"); NODE_DBG("Request: %s",c->output.buffer); } int ICACHE_FLASH_ATTR http_request_GET(http_connection *c,const char *path){ return http_request_start(c,"GET",path) && http_end_headers(c); } int ICACHE_FLASH_ATTR http_request_POST(http_connection *c,const char *path){ return http_request_start(c,"POST",path) && http_end_headers(c); } //RESPONSE int ICACHE_FLASH_ATTR http_response_start(http_connection *c){ return http_write(c,"HTTP/") && http_write(c,HTTP_VERSION) && http_write(c," "); } int ICACHE_FLASH_ATTR http_response_STATUS(http_connection *c,const char * status){ return http_response_start(c) && http_write(c,status) && http_end_line(c) && //default headers http_HEADER(c,HTTP_SERVER,HTTP_DEFAULT_SERVER) && http_HEADER(c,HTTP_CONNECTION,"Close"); } int ICACHE_FLASH_ATTR http_response_OK(http_connection *c){ return http_response_STATUS(c,HTTP_OK) && http_end_headers(c); } int ICACHE_FLASH_ATTR http_response_BAD_REQUEST(http_connection *c){ return http_response_STATUS(c,HTTP_BAD_REQUEST) && http_end_headers(c); } int ICACHE_FLASH_ATTR http_response_NOT_FOUND(http_connection *c){ return http_response_STATUS(c,HTTP_NOT_FOUND)&& http_end_headers(c); } int ICACHE_FLASH_ATTR http_response_REDIRECT(http_connection *c,const char* destination){ return http_response_STATUS(c,HTTP_REDIRECT) && http_HEADER(c,HTTP_LOCATION,destination) && http_end_headers(c); } //ws int ICACHE_FLASH_ATTR http_websocket_HANDSHAKE(http_connection *c){ http_reset_buffer(c); int ret = http_write(c,"HTTP/1.1 101 Switching Protocols") && http_end_line(c) && http_end_headers(c); return ret; } //Returns a static char* to a mime type for a given url to a file. const char ICACHE_FLASH_ATTR *http_get_mime(char *url) { int i=0; //Go find the extension char *ext=url+(strlen(url)-1); while (ext!=url && *ext!='.') ext--; if (*ext=='.') ext++; //ToDo: os_strcmp is case sensitive; we may want to do case-intensive matching here... while (mimeTypes[i].ext!=NULL && os_strcmp(ext, mimeTypes[i].ext)!=0) i++; return mimeTypes[i].mimetype; } ================================================ FILE: app/http/http_helper.h ================================================ /* * ---------------------------------------------------------------------------- * "THE BEER-WARE LICENSE" (Revision 42): * Israel Lot and Jeroen Domburg * wrote this file. As long as you retain this notice you can do whatever you * want with this stuff. If we meet some day, and you think this stuff is * worth it, you can buy us a beer in return. * ---------------------------------------------------------------------------- */ #ifndef http_response_h #define http_response_h #include "http_process.h" #define HTTP_DEFAULT_SERVER "Smart Relay 1.0" #define HTTP_VERSION "1.1" #define HTTP_OK "200 OK" #define HTTP_MOVED "301 Moved Permanently " #define HTTP_REDIRECT "302 Found" #define HTTP_NOT_MODIFIED "304 Not Modified" #define HTTP_BAD_REQUEST "400 Bad Request" #define HTTP_NOT_FOUND "404 Not Found" #define HTTP_INTERNAL_ERROR "500 Internal Server Error" //headers #define HTTP_CONTENT_TYPE "Content-Type" #define HTTP_CONTENT_LENGTH "Content-Length" #define HTTP_CONNECTION "Connection" #define HTTP_CACHE_CONTROL "Cache-Control" #define HTTP_CONTENT_ENCODING "Content-Encoding" #define HTTP_LOCATION "Location" #define HTTP_HOST "Host" #define HTTP_ORIGIN "Origin" #define HTTP_SERVER "Server" #define HTTP_ACCESS_CONTROL_ALLOW_ORIGIN "Access-Control-Allow-Origin" #define HTTP_ACCESS_CONTROL_ALLOW_METHODS "Access-Control-Allow-Methods" #define HTTP_ACCESS_CONTROL_ALLOW_HEADERS "Access-Control-Allow-Headers" #define HTTP_ACCESS_CONTROL_REQUEST_HEADERS "Access-Control-Request-Headers" #define HTTP_ACCESS_CONTROL_REQUEST_METHOD "Access-Control-Request-Method" #define HTTP_USER_AGENT "User-Agent" //websocket headers #define HTTP_UPGRADE "Upgrade" #define HTTP_SEC_WEBSOCKET_KEY "Sec-WebSocket-Key" #define HTTP_SEC_WEBSOCKET_PROTOCOL "Sec-WebSocket-Protocol" #define HTTP_SEC_WEBSOCKET_VERSION "Sec-WebSocket-Version" #define HTTP_WEBSOCKET_ACCEPT "Sec-WebSocket-Accept" #define HTTP_CONNECTION_CLOSE "Close" #define JSON_CONTENT_TYPE "application/json" #define HTTP_DEFAULT_CACHE "public, max-age=3600" //request int ICACHE_FLASH_ATTR http_request_GET(http_connection *c,const char *path); int ICACHE_FLASH_ATTR http_request_POST(http_connection *c,const char *path); //response int ICACHE_FLASH_ATTR http_response_OK(http_connection *c); int ICACHE_FLASH_ATTR http_response_NOT_FOUND(http_connection *c); int ICACHE_FLASH_ATTR http_response_BAD_REQUEST(http_connection *c); int ICACHE_FLASH_ATTR http_response_REDIRECT(http_connection *c,const char* destination); //ws int ICACHE_FLASH_ATTR http_websocket_HANDSHAKE(http_connection *c); //common const char ICACHE_FLASH_ATTR *http_get_mime(char *url); int ICACHE_FLASH_ATTR http_SET_HEADER(http_connection *c,const char *header,const char *value); int ICACHE_FLASH_ATTR http_end_headers(http_connection *c); int ICACHE_FLASH_ATTR http_reset_buffer(http_connection *c); #endif ================================================ FILE: app/http/http_parser.c ================================================ /* Based on src/http/ngx_http_parse.c from NGINX copyright Igor Sysoev * * Additional changes are licensed under the same terms as NGINX and * copyright Joyent, Inc. and other Node contributors. 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. */ #include "http_parser.h" #include "c_stddef.h" #include "c_stdlib.h" #include "c_string.h" #include "c_limits.h" #include "mem.h" #include "osapi.h" #include "user_interface.h" #define assert(X) //NOP #ifndef ULLONG_MAX # define ULLONG_MAX ((uint64_t) -1) /* 2^64-1 */ #endif #ifndef MIN # define MIN(a,b) ((a) < (b) ? (a) : (b)) #endif #ifndef ARRAY_SIZE # define ARRAY_SIZE(a) (sizeof(a) / sizeof((a)[0])) #endif #ifndef BIT_AT # define BIT_AT(a, i) \ (!!((unsigned int) (a)[(unsigned int) (i) >> 3] & \ (1 << ((unsigned int) (i) & 7)))) #endif #ifndef ELEM_AT # define ELEM_AT(a, i, v) ((unsigned int) (i) < ARRAY_SIZE(a) ? (a)[(i)] : (v)) #endif #define SET_ERRNO(e) \ do { \ parser->http_errno = (e); \ } while(0) #define CURRENT_STATE() p_state #define UPDATE_STATE(V) p_state = (enum state) (V); #define RETURN(V) \ do { \ parser->state = CURRENT_STATE(); \ return (V); \ } while (0); #define REEXECUTE() \ goto reexecute; \ #define LIKELY(X) (X) #define UNLIKELY(X) (X) /* Run the notify callback FOR, returning ER if it fails */ #define CALLBACK_NOTIFY_(FOR, ER) \ do { \ assert(HTTP_PARSER_ERRNO(parser) == HPE_OK); \ \ if (LIKELY(settings->on_##FOR)) { \ parser->state = CURRENT_STATE(); \ if (UNLIKELY(0 != settings->on_##FOR(parser))) { \ SET_ERRNO(HPE_CB_##FOR); \ } \ UPDATE_STATE(parser->state); \ \ /* We either errored above or got paused; get out */ \ if (UNLIKELY(HTTP_PARSER_ERRNO(parser) != HPE_OK)) { \ return (ER); \ } \ } \ } while (0) /* Run the notify callback FOR and consume the current byte */ #define CALLBACK_NOTIFY(FOR) CALLBACK_NOTIFY_(FOR, p - data + 1) /* Run the notify callback FOR and don't consume the current byte */ #define CALLBACK_NOTIFY_NOADVANCE(FOR) CALLBACK_NOTIFY_(FOR, p - data) /* Run data callback FOR with LEN bytes, returning ER if it fails */ #define CALLBACK_DATA_(FOR, LEN, ER) \ do { \ assert(HTTP_PARSER_ERRNO(parser) == HPE_OK); \ \ if (FOR##_mark) { \ if (LIKELY(settings->on_##FOR)) { \ parser->state = CURRENT_STATE(); \ if (UNLIKELY(0 != \ settings->on_##FOR(parser, FOR##_mark, (LEN)))) { \ SET_ERRNO(HPE_CB_##FOR); \ } \ UPDATE_STATE(parser->state); \ \ /* We either errored above or got paused; get out */ \ if (UNLIKELY(HTTP_PARSER_ERRNO(parser) != HPE_OK)) { \ return (ER); \ } \ } \ FOR##_mark = NULL; \ } \ } while (0) /* Run the data callback FOR and consume the current byte */ #define CALLBACK_DATA(FOR) \ CALLBACK_DATA_(FOR, p - FOR##_mark, p - data + 1) /* Run the data callback FOR and don't consume the current byte */ #define CALLBACK_DATA_NOADVANCE(FOR) \ CALLBACK_DATA_(FOR, p - FOR##_mark, p - data) /* Set the mark FOR; non-destructive if mark is already set */ #define MARK(FOR) \ do { \ if (!FOR##_mark) { \ FOR##_mark = p; \ } \ } while (0) /* Don't allow the total size of the HTTP headers (including the status * line) to exceed HTTP_MAX_HEADER_SIZE. This check is here to protect * embedders against denial-of-service attacks where the attacker feeds * us a never-ending header that the embedder keeps buffering. * * This check is arguably the responsibility of embedders but we're doing * it on the embedder's behalf because most won't bother and this way we * make the web a little safer. HTTP_MAX_HEADER_SIZE is still far bigger * than any reasonable request or response so this should never affect * day-to-day operation. */ #define COUNT_HEADER_SIZE(V) \ do { \ parser->nread += (V); \ if (UNLIKELY(parser->nread > (HTTP_MAX_HEADER_SIZE))) { \ SET_ERRNO(HPE_HEADER_OVERFLOW); \ goto error; \ } \ } while (0) #define PROXY_CONNECTION "proxy-connection" #define CONNECTION "connection" #define CONTENT_LENGTH "content-length" #define TRANSFER_ENCODING "transfer-encoding" #define UPGRADE "upgrade" #define CHUNKED "chunked" #define KEEP_ALIVE "keep-alive" #define CLOSE "close" static const char *method_strings[] = { #define XX(num, name, string) #string, HTTP_METHOD_MAP(XX) #undef XX }; /* Tokens as defined by rfc 2616. Also lowercases them. * token = 1* * separators = "(" | ")" | "<" | ">" | "@" * | "," | ";" | ":" | "\" | <"> * | "/" | "[" | "]" | "?" | "=" * | "{" | "}" | SP | HT */ static const char tokens[256] = { /* 0 nul 1 soh 2 stx 3 etx 4 eot 5 enq 6 ack 7 bel */ 0, 0, 0, 0, 0, 0, 0, 0, /* 8 bs 9 ht 10 nl 11 vt 12 np 13 cr 14 so 15 si */ 0, 0, 0, 0, 0, 0, 0, 0, /* 16 dle 17 dc1 18 dc2 19 dc3 20 dc4 21 nak 22 syn 23 etb */ 0, 0, 0, 0, 0, 0, 0, 0, /* 24 can 25 em 26 sub 27 esc 28 fs 29 gs 30 rs 31 us */ 0, 0, 0, 0, 0, 0, 0, 0, /* 32 sp 33 ! 34 " 35 # 36 $ 37 % 38 & 39 ' */ 0, '!', 0, '#', '$', '%', '&', '\'', /* 40 ( 41 ) 42 * 43 + 44 , 45 - 46 . 47 / */ 0, 0, '*', '+', 0, '-', '.', 0, /* 48 0 49 1 50 2 51 3 52 4 53 5 54 6 55 7 */ '0', '1', '2', '3', '4', '5', '6', '7', /* 56 8 57 9 58 : 59 ; 60 < 61 = 62 > 63 ? */ '8', '9', 0, 0, 0, 0, 0, 0, /* 64 @ 65 A 66 B 67 C 68 D 69 E 70 F 71 G */ 0, 'a', 'b', 'c', 'd', 'e', 'f', 'g', /* 72 H 73 I 74 J 75 K 76 L 77 M 78 N 79 O */ 'h', 'i', 'j', 'k', 'l', 'm', 'n', 'o', /* 80 P 81 Q 82 R 83 S 84 T 85 U 86 V 87 W */ 'p', 'q', 'r', 's', 't', 'u', 'v', 'w', /* 88 X 89 Y 90 Z 91 [ 92 \ 93 ] 94 ^ 95 _ */ 'x', 'y', 'z', 0, 0, 0, '^', '_', /* 96 ` 97 a 98 b 99 c 100 d 101 e 102 f 103 g */ '`', 'a', 'b', 'c', 'd', 'e', 'f', 'g', /* 104 h 105 i 106 j 107 k 108 l 109 m 110 n 111 o */ 'h', 'i', 'j', 'k', 'l', 'm', 'n', 'o', /* 112 p 113 q 114 r 115 s 116 t 117 u 118 v 119 w */ 'p', 'q', 'r', 's', 't', 'u', 'v', 'w', /* 120 x 121 y 122 z 123 { 124 | 125 } 126 ~ 127 del */ 'x', 'y', 'z', 0, '|', 0, '~', 0 }; static const int8_t unhex[256] = {-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1 ,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1 ,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1 , 0, 1, 2, 3, 4, 5, 6, 7, 8, 9,-1,-1,-1,-1,-1,-1 ,-1,10,11,12,13,14,15,-1,-1,-1,-1,-1,-1,-1,-1,-1 ,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1 ,-1,10,11,12,13,14,15,-1,-1,-1,-1,-1,-1,-1,-1,-1 ,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1 }; #if HTTP_PARSER_STRICT # define T(v) 0 #else # define T(v) v #endif static const uint8_t normal_url_char[32] = { /* 0 nul 1 soh 2 stx 3 etx 4 eot 5 enq 6 ack 7 bel */ 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0, /* 8 bs 9 ht 10 nl 11 vt 12 np 13 cr 14 so 15 si */ 0 | T(2) | 0 | 0 | T(16) | 0 | 0 | 0, /* 16 dle 17 dc1 18 dc2 19 dc3 20 dc4 21 nak 22 syn 23 etb */ 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0, /* 24 can 25 em 26 sub 27 esc 28 fs 29 gs 30 rs 31 us */ 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0, /* 32 sp 33 ! 34 " 35 # 36 $ 37 % 38 & 39 ' */ 0 | 2 | 4 | 0 | 16 | 32 | 64 | 128, /* 40 ( 41 ) 42 * 43 + 44 , 45 - 46 . 47 / */ 1 | 2 | 4 | 8 | 16 | 32 | 64 | 128, /* 48 0 49 1 50 2 51 3 52 4 53 5 54 6 55 7 */ 1 | 2 | 4 | 8 | 16 | 32 | 64 | 128, /* 56 8 57 9 58 : 59 ; 60 < 61 = 62 > 63 ? */ 1 | 2 | 4 | 8 | 16 | 32 | 64 | 0, /* 64 @ 65 A 66 B 67 C 68 D 69 E 70 F 71 G */ 1 | 2 | 4 | 8 | 16 | 32 | 64 | 128, /* 72 H 73 I 74 J 75 K 76 L 77 M 78 N 79 O */ 1 | 2 | 4 | 8 | 16 | 32 | 64 | 128, /* 80 P 81 Q 82 R 83 S 84 T 85 U 86 V 87 W */ 1 | 2 | 4 | 8 | 16 | 32 | 64 | 128, /* 88 X 89 Y 90 Z 91 [ 92 \ 93 ] 94 ^ 95 _ */ 1 | 2 | 4 | 8 | 16 | 32 | 64 | 128, /* 96 ` 97 a 98 b 99 c 100 d 101 e 102 f 103 g */ 1 | 2 | 4 | 8 | 16 | 32 | 64 | 128, /* 104 h 105 i 106 j 107 k 108 l 109 m 110 n 111 o */ 1 | 2 | 4 | 8 | 16 | 32 | 64 | 128, /* 112 p 113 q 114 r 115 s 116 t 117 u 118 v 119 w */ 1 | 2 | 4 | 8 | 16 | 32 | 64 | 128, /* 120 x 121 y 122 z 123 { 124 | 125 } 126 ~ 127 del */ 1 | 2 | 4 | 8 | 16 | 32 | 64 | 0, }; #undef T enum state { s_dead = 1 /* important that this is > 0 */ , s_start_req_or_res , s_res_or_resp_H , s_start_res , s_res_H , s_res_HT , s_res_HTT , s_res_HTTP , s_res_first_http_major , s_res_http_major , s_res_first_http_minor , s_res_http_minor , s_res_first_status_code , s_res_status_code , s_res_status_start , s_res_status , s_res_line_almost_done , s_start_req , s_req_method , s_req_spaces_before_url , s_req_schema , s_req_schema_slash , s_req_schema_slash_slash , s_req_server_start , s_req_server , s_req_server_with_at , s_req_path , s_req_query_string_start , s_req_query_string , s_req_fragment_start , s_req_fragment , s_req_http_start , s_req_http_H , s_req_http_HT , s_req_http_HTT , s_req_http_HTTP , s_req_first_http_major , s_req_http_major , s_req_first_http_minor , s_req_http_minor , s_req_line_almost_done , s_header_field_start , s_header_field , s_header_value_discard_ws , s_header_value_discard_ws_almost_done , s_header_value_discard_lws , s_header_value_start , s_header_value , s_header_value_lws , s_header_almost_done , s_chunk_size_start , s_chunk_size , s_chunk_parameters , s_chunk_size_almost_done , s_headers_almost_done , s_headers_done /* Important: 's_headers_done' must be the last 'header' state. All * states beyond this must be 'body' states. It is used for overflow * checking. See the PARSING_HEADER() macro. */ , s_chunk_data , s_chunk_data_almost_done , s_chunk_data_done , s_body_identity , s_body_identity_eof , s_message_done }; #define PARSING_HEADER(state) (state <= s_headers_done) enum header_states { h_general = 0 , h_C , h_CO , h_CON , h_matching_connection , h_matching_proxy_connection , h_matching_content_length , h_matching_transfer_encoding , h_matching_upgrade , h_connection , h_content_length , h_transfer_encoding , h_upgrade , h_matching_transfer_encoding_chunked , h_matching_connection_token_start , h_matching_connection_keep_alive , h_matching_connection_close , h_matching_connection_upgrade , h_matching_connection_token , h_transfer_encoding_chunked , h_connection_keep_alive , h_connection_close , h_connection_upgrade }; enum http_host_state { s_http_host_dead = 1 , s_http_userinfo_start , s_http_userinfo , s_http_host_start , s_http_host_v6_start , s_http_host , s_http_host_v6 , s_http_host_v6_end , s_http_host_port_start , s_http_host_port }; /* Macros for character classes; depends on strict-mode */ #define CR '\r' #define LF '\n' #define LOWER(c) (unsigned char)(c | 0x20) #define IS_ALPHA(c) (LOWER(c) >= 'a' && LOWER(c) <= 'z') #define IS_NUM(c) ((c) >= '0' && (c) <= '9') #define IS_ALPHANUM(c) (IS_ALPHA(c) || IS_NUM(c)) #define IS_HEX(c) (IS_NUM(c) || (LOWER(c) >= 'a' && LOWER(c) <= 'f')) #define IS_MARK(c) ((c) == '-' || (c) == '_' || (c) == '.' || \ (c) == '!' || (c) == '~' || (c) == '*' || (c) == '\'' || (c) == '(' || \ (c) == ')') #define IS_USERINFO_CHAR(c) (IS_ALPHANUM(c) || IS_MARK(c) || (c) == '%' || \ (c) == ';' || (c) == ':' || (c) == '&' || (c) == '=' || (c) == '+' || \ (c) == '$' || (c) == ',') #define STRICT_TOKEN(c) (tokens[(unsigned char)c]) #if HTTP_PARSER_STRICT #define TOKEN(c) (tokens[(unsigned char)c]) #define IS_URL_CHAR(c) (BIT_AT(normal_url_char, (unsigned char)c)) #define IS_HOST_CHAR(c) (IS_ALPHANUM(c) || (c) == '.' || (c) == '-') #else #define TOKEN(c) ((c == ' ') ? ' ' : tokens[(unsigned char)c]) #define IS_URL_CHAR(c) \ (BIT_AT(normal_url_char, (unsigned char)c) || ((c) & 0x80)) #define IS_HOST_CHAR(c) \ (IS_ALPHANUM(c) || (c) == '.' || (c) == '-' || (c) == '_') #endif #define start_state (parser->type == HTTP_REQUEST ? s_start_req : s_start_res) #if HTTP_PARSER_STRICT # define STRICT_CHECK(cond) \ do { \ if (cond) { \ SET_ERRNO(HPE_STRICT); \ goto error; \ } \ } while (0) # define NEW_MESSAGE() (http_should_keep_alive(parser) ? start_state : s_dead) #else # define STRICT_CHECK(cond) # define NEW_MESSAGE() start_state #endif /* Map errno values to strings for human-readable output */ #define HTTP_STRERROR_GEN(n, s) { "HPE_" #n, s }, static struct { const char *name; const char *description; } http_strerror_tab[] = { HTTP_ERRNO_MAP(HTTP_STRERROR_GEN) }; #undef HTTP_STRERROR_GEN int http_message_needs_eof(const http_parser *parser); /* Our URL parser. * * This is designed to be shared by http_parser_execute() for URL validation, * hence it has a state transition + byte-for-byte interface. In addition, it * is meant to be embedded in http_parser_parse_url(), which does the dirty * work of turning state transitions URL components for its API. * * This function should only be invoked with non-space characters. It is * assumed that the caller cares about (and can detect) the transition between * URL and non-URL states by looking for these. */ static enum state ICACHE_FLASH_ATTR parse_url_char(enum state s, const char ch) { if (ch == ' ' || ch == '\r' || ch == '\n') { return s_dead; } #if HTTP_PARSER_STRICT if (ch == '\t' || ch == '\f') { return s_dead; } #endif switch (s) { case s_req_spaces_before_url: /* Proxied requests are followed by scheme of an absolute URI (alpha). * All methods except CONNECT are followed by '/' or '*'. */ if (ch == '/' || ch == '*') { return s_req_path; } if (IS_ALPHA(ch)) { return s_req_schema; } break; case s_req_schema: if (IS_ALPHA(ch)) { return s; } if (ch == ':') { return s_req_schema_slash; } break; case s_req_schema_slash: if (ch == '/') { return s_req_schema_slash_slash; } break; case s_req_schema_slash_slash: if (ch == '/') { return s_req_server_start; } break; case s_req_server_with_at: if (ch == '@') { return s_dead; } /* FALLTHROUGH */ case s_req_server_start: case s_req_server: if (ch == '/') { return s_req_path; } if (ch == '?') { return s_req_query_string_start; } if (ch == '@') { return s_req_server_with_at; } if (IS_USERINFO_CHAR(ch) || ch == '[' || ch == ']') { return s_req_server; } break; case s_req_path: if (IS_URL_CHAR(ch)) { return s; } switch (ch) { case '?': return s_req_query_string_start; case '#': return s_req_fragment_start; } break; case s_req_query_string_start: case s_req_query_string: if (IS_URL_CHAR(ch)) { return s_req_query_string; } switch (ch) { case '?': /* allow extra '?' in query string */ return s_req_query_string; case '#': return s_req_fragment_start; } break; case s_req_fragment_start: if (IS_URL_CHAR(ch)) { return s_req_fragment; } switch (ch) { case '?': return s_req_fragment; case '#': return s; } break; case s_req_fragment: if (IS_URL_CHAR(ch)) { return s; } switch (ch) { case '?': case '#': return s; } break; default: break; } /* We should never fall out of the switch above unless there's an error */ return s_dead; } size_t ICACHE_FLASH_ATTR http_parser_execute (http_parser *parser, const http_parser_settings *settings, const char *data, size_t len) { char c, ch; int8_t unhex_val; const char *p = data; const char *header_field_mark = 0; const char *header_value_mark = 0; const char *url_mark = 0; const char *body_mark = 0; const char *status_mark = 0; enum state p_state = (enum state) parser->state; /* We're in an error state. Don't bother doing anything. */ if (HTTP_PARSER_ERRNO(parser) != HPE_OK) { return 0; } if (len == 0) { switch (CURRENT_STATE()) { case s_body_identity_eof: /* Use of CALLBACK_NOTIFY() here would erroneously return 1 byte read if * we got paused. */ CALLBACK_NOTIFY_NOADVANCE(message_complete); return 0; case s_dead: case s_start_req_or_res: case s_start_res: case s_start_req: return 0; default: SET_ERRNO(HPE_INVALID_EOF_STATE); return 1; } } if (CURRENT_STATE() == s_header_field) header_field_mark = data; if (CURRENT_STATE() == s_header_value) header_value_mark = data; switch (CURRENT_STATE()) { case s_req_path: case s_req_schema: case s_req_schema_slash: case s_req_schema_slash_slash: case s_req_server_start: case s_req_server: case s_req_server_with_at: case s_req_query_string_start: case s_req_query_string: case s_req_fragment_start: case s_req_fragment: url_mark = data; break; case s_res_status: status_mark = data; break; default: break; } for (p=data; p != data + len; p++) { ch = *p; if (PARSING_HEADER(CURRENT_STATE())) COUNT_HEADER_SIZE(1); reexecute: switch (CURRENT_STATE()) { case s_dead: /* this state is used after a 'Connection: close' message * the parser will error out if it reads another message */ if (LIKELY(ch == CR || ch == LF)) break; SET_ERRNO(HPE_CLOSED_CONNECTION); goto error; case s_start_req_or_res: { if (ch == CR || ch == LF) break; parser->flags = 0; parser->content_length = ULLONG_MAX; if (ch == 'H') { UPDATE_STATE(s_res_or_resp_H); CALLBACK_NOTIFY(message_begin); } else { parser->type = HTTP_REQUEST; UPDATE_STATE(s_start_req); REEXECUTE(); } break; } case s_res_or_resp_H: if (ch == 'T') { parser->type = HTTP_RESPONSE; UPDATE_STATE(s_res_HT); } else { if (UNLIKELY(ch != 'E')) { SET_ERRNO(HPE_INVALID_CONSTANT); goto error; } parser->type = HTTP_REQUEST; parser->method = HTTP_HEAD; parser->index = 2; UPDATE_STATE(s_req_method); } break; case s_start_res: { parser->flags = 0; parser->content_length = ULLONG_MAX; switch (ch) { case 'H': UPDATE_STATE(s_res_H); break; case CR: case LF: break; default: SET_ERRNO(HPE_INVALID_CONSTANT); goto error; } CALLBACK_NOTIFY(message_begin); break; } case s_res_H: STRICT_CHECK(ch != 'T'); UPDATE_STATE(s_res_HT); break; case s_res_HT: STRICT_CHECK(ch != 'T'); UPDATE_STATE(s_res_HTT); break; case s_res_HTT: STRICT_CHECK(ch != 'P'); UPDATE_STATE(s_res_HTTP); break; case s_res_HTTP: STRICT_CHECK(ch != '/'); UPDATE_STATE(s_res_first_http_major); break; case s_res_first_http_major: if (UNLIKELY(ch < '0' || ch > '9')) { SET_ERRNO(HPE_INVALID_VERSION); goto error; } parser->http_major = ch - '0'; UPDATE_STATE(s_res_http_major); break; /* major HTTP version or dot */ case s_res_http_major: { if (ch == '.') { UPDATE_STATE(s_res_first_http_minor); break; } if (!IS_NUM(ch)) { SET_ERRNO(HPE_INVALID_VERSION); goto error; } parser->http_major *= 10; parser->http_major += ch - '0'; if (UNLIKELY(parser->http_major > 999)) { SET_ERRNO(HPE_INVALID_VERSION); goto error; } break; } /* first digit of minor HTTP version */ case s_res_first_http_minor: if (UNLIKELY(!IS_NUM(ch))) { SET_ERRNO(HPE_INVALID_VERSION); goto error; } parser->http_minor = ch - '0'; UPDATE_STATE(s_res_http_minor); break; /* minor HTTP version or end of request line */ case s_res_http_minor: { if (ch == ' ') { UPDATE_STATE(s_res_first_status_code); break; } if (UNLIKELY(!IS_NUM(ch))) { SET_ERRNO(HPE_INVALID_VERSION); goto error; } parser->http_minor *= 10; parser->http_minor += ch - '0'; if (UNLIKELY(parser->http_minor > 999)) { SET_ERRNO(HPE_INVALID_VERSION); goto error; } break; } case s_res_first_status_code: { if (!IS_NUM(ch)) { if (ch == ' ') { break; } SET_ERRNO(HPE_INVALID_STATUS); goto error; } parser->status_code = ch - '0'; UPDATE_STATE(s_res_status_code); break; } case s_res_status_code: { if (!IS_NUM(ch)) { switch (ch) { case ' ': UPDATE_STATE(s_res_status_start); break; case CR: UPDATE_STATE(s_res_line_almost_done); break; case LF: UPDATE_STATE(s_header_field_start); break; default: SET_ERRNO(HPE_INVALID_STATUS); goto error; } break; } parser->status_code *= 10; parser->status_code += ch - '0'; if (UNLIKELY(parser->status_code > 999)) { SET_ERRNO(HPE_INVALID_STATUS); goto error; } break; } case s_res_status_start: { if (ch == CR) { UPDATE_STATE(s_res_line_almost_done); break; } if (ch == LF) { UPDATE_STATE(s_header_field_start); break; } MARK(status); UPDATE_STATE(s_res_status); parser->index = 0; break; } case s_res_status: if (ch == CR) { UPDATE_STATE(s_res_line_almost_done); CALLBACK_DATA(status); break; } if (ch == LF) { UPDATE_STATE(s_header_field_start); CALLBACK_DATA(status); break; } break; case s_res_line_almost_done: STRICT_CHECK(ch != LF); UPDATE_STATE(s_header_field_start); break; case s_start_req: { if (ch == CR || ch == LF) break; parser->flags = 0; parser->content_length = ULLONG_MAX; if (UNLIKELY(!IS_ALPHA(ch))) { SET_ERRNO(HPE_INVALID_METHOD); goto error; } parser->method = (enum http_method) 0; parser->index = 1; switch (ch) { case 'C': parser->method = HTTP_CONNECT; /* or COPY, CHECKOUT */ break; case 'D': parser->method = HTTP_DELETE; break; case 'G': parser->method = HTTP_GET; break; case 'H': parser->method = HTTP_HEAD; break; case 'L': parser->method = HTTP_LOCK; break; case 'M': parser->method = HTTP_MKCOL; /* or MOVE, MKACTIVITY, MERGE, M-SEARCH, MKCALENDAR */ break; case 'N': parser->method = HTTP_NOTIFY; break; case 'O': parser->method = HTTP_OPTIONS; break; case 'P': parser->method = HTTP_POST; /* or PROPFIND|PROPPATCH|PUT|PATCH|PURGE */ break; case 'R': parser->method = HTTP_REPORT; break; case 'S': parser->method = HTTP_SUBSCRIBE; /* or SEARCH */ break; case 'T': parser->method = HTTP_TRACE; break; case 'U': parser->method = HTTP_UNLOCK; /* or UNSUBSCRIBE */ break; default: SET_ERRNO(HPE_INVALID_METHOD); goto error; } UPDATE_STATE(s_req_method); CALLBACK_NOTIFY(message_begin); break; } case s_req_method: { const char *matcher; if (UNLIKELY(ch == '\0')) { SET_ERRNO(HPE_INVALID_METHOD); goto error; } matcher = method_strings[parser->method]; if (ch == ' ' && matcher[parser->index] == '\0') { UPDATE_STATE(s_req_spaces_before_url); } else if (ch == matcher[parser->index]) { ; /* nada */ } else if (parser->method == HTTP_CONNECT) { if (parser->index == 1 && ch == 'H') { parser->method = HTTP_CHECKOUT; } else if (parser->index == 2 && ch == 'P') { parser->method = HTTP_COPY; } else { SET_ERRNO(HPE_INVALID_METHOD); goto error; } } else if (parser->method == HTTP_MKCOL) { if (parser->index == 1 && ch == 'O') { parser->method = HTTP_MOVE; } else if (parser->index == 1 && ch == 'E') { parser->method = HTTP_MERGE; } else if (parser->index == 1 && ch == '-') { parser->method = HTTP_MSEARCH; } else if (parser->index == 2 && ch == 'A') { parser->method = HTTP_MKACTIVITY; } else if (parser->index == 3 && ch == 'A') { parser->method = HTTP_MKCALENDAR; } else { SET_ERRNO(HPE_INVALID_METHOD); goto error; } } else if (parser->method == HTTP_SUBSCRIBE) { if (parser->index == 1 && ch == 'E') { parser->method = HTTP_SEARCH; } else { SET_ERRNO(HPE_INVALID_METHOD); goto error; } } else if (parser->index == 1 && parser->method == HTTP_POST) { if (ch == 'R') { parser->method = HTTP_PROPFIND; /* or HTTP_PROPPATCH */ } else if (ch == 'U') { parser->method = HTTP_PUT; /* or HTTP_PURGE */ } else if (ch == 'A') { parser->method = HTTP_PATCH; } else { SET_ERRNO(HPE_INVALID_METHOD); goto error; } } else if (parser->index == 2) { if (parser->method == HTTP_PUT) { if (ch == 'R') { parser->method = HTTP_PURGE; } else { SET_ERRNO(HPE_INVALID_METHOD); goto error; } } else if (parser->method == HTTP_UNLOCK) { if (ch == 'S') { parser->method = HTTP_UNSUBSCRIBE; } else { SET_ERRNO(HPE_INVALID_METHOD); goto error; } } else { SET_ERRNO(HPE_INVALID_METHOD); goto error; } } else if (parser->index == 4 && parser->method == HTTP_PROPFIND && ch == 'P') { parser->method = HTTP_PROPPATCH; } else { SET_ERRNO(HPE_INVALID_METHOD); goto error; } ++parser->index; break; } case s_req_spaces_before_url: { if (ch == ' ') break; MARK(url); if (parser->method == HTTP_CONNECT) { UPDATE_STATE(s_req_server_start); } UPDATE_STATE(parse_url_char(CURRENT_STATE(), ch)); if (UNLIKELY(CURRENT_STATE() == s_dead)) { SET_ERRNO(HPE_INVALID_URL); goto error; } break; } case s_req_schema: case s_req_schema_slash: case s_req_schema_slash_slash: case s_req_server_start: { switch (ch) { /* No whitespace allowed here */ case ' ': case CR: case LF: SET_ERRNO(HPE_INVALID_URL); goto error; default: UPDATE_STATE(parse_url_char(CURRENT_STATE(), ch)); if (UNLIKELY(CURRENT_STATE() == s_dead)) { SET_ERRNO(HPE_INVALID_URL); goto error; } } break; } case s_req_server: case s_req_server_with_at: case s_req_path: case s_req_query_string_start: case s_req_query_string: case s_req_fragment_start: case s_req_fragment: { switch (ch) { case ' ': UPDATE_STATE(s_req_http_start); CALLBACK_DATA(url); break; case CR: case LF: parser->http_major = 0; parser->http_minor = 9; UPDATE_STATE((ch == CR) ? s_req_line_almost_done : s_header_field_start); CALLBACK_DATA(url); break; default: UPDATE_STATE(parse_url_char(CURRENT_STATE(), ch)); if (UNLIKELY(CURRENT_STATE() == s_dead)) { SET_ERRNO(HPE_INVALID_URL); goto error; } } break; } case s_req_http_start: switch (ch) { case 'H': UPDATE_STATE(s_req_http_H); break; case ' ': break; default: SET_ERRNO(HPE_INVALID_CONSTANT); goto error; } break; case s_req_http_H: STRICT_CHECK(ch != 'T'); UPDATE_STATE(s_req_http_HT); break; case s_req_http_HT: STRICT_CHECK(ch != 'T'); UPDATE_STATE(s_req_http_HTT); break; case s_req_http_HTT: STRICT_CHECK(ch != 'P'); UPDATE_STATE(s_req_http_HTTP); break; case s_req_http_HTTP: STRICT_CHECK(ch != '/'); UPDATE_STATE(s_req_first_http_major); break; /* first digit of major HTTP version */ case s_req_first_http_major: if (UNLIKELY(ch < '1' || ch > '9')) { SET_ERRNO(HPE_INVALID_VERSION); goto error; } parser->http_major = ch - '0'; UPDATE_STATE(s_req_http_major); break; /* major HTTP version or dot */ case s_req_http_major: { if (ch == '.') { UPDATE_STATE(s_req_first_http_minor); break; } if (UNLIKELY(!IS_NUM(ch))) { SET_ERRNO(HPE_INVALID_VERSION); goto error; } parser->http_major *= 10; parser->http_major += ch - '0'; if (UNLIKELY(parser->http_major > 999)) { SET_ERRNO(HPE_INVALID_VERSION); goto error; } break; } /* first digit of minor HTTP version */ case s_req_first_http_minor: if (UNLIKELY(!IS_NUM(ch))) { SET_ERRNO(HPE_INVALID_VERSION); goto error; } parser->http_minor = ch - '0'; UPDATE_STATE(s_req_http_minor); break; /* minor HTTP version or end of request line */ case s_req_http_minor: { if (ch == CR) { UPDATE_STATE(s_req_line_almost_done); break; } if (ch == LF) { UPDATE_STATE(s_header_field_start); break; } /* XXX allow spaces after digit? */ if (UNLIKELY(!IS_NUM(ch))) { SET_ERRNO(HPE_INVALID_VERSION); goto error; } parser->http_minor *= 10; parser->http_minor += ch - '0'; if (UNLIKELY(parser->http_minor > 999)) { SET_ERRNO(HPE_INVALID_VERSION); goto error; } break; } /* end of request line */ case s_req_line_almost_done: { if (UNLIKELY(ch != LF)) { SET_ERRNO(HPE_LF_EXPECTED); goto error; } UPDATE_STATE(s_header_field_start); break; } case s_header_field_start: { if (ch == CR) { UPDATE_STATE(s_headers_almost_done); break; } if (ch == LF) { /* they might be just sending \n instead of \r\n so this would be * the second \n to denote the end of headers*/ UPDATE_STATE(s_headers_almost_done); REEXECUTE(); } c = TOKEN(ch); if (UNLIKELY(!c)) { SET_ERRNO(HPE_INVALID_HEADER_TOKEN); goto error; } MARK(header_field); parser->index = 0; UPDATE_STATE(s_header_field); switch (c) { case 'c': parser->header_state = h_C; break; case 'p': parser->header_state = h_matching_proxy_connection; break; case 't': parser->header_state = h_matching_transfer_encoding; break; case 'u': parser->header_state = h_matching_upgrade; break; default: parser->header_state = h_general; break; } break; } case s_header_field: { const char* start = p; for (; p != data + len; p++) { ch = *p; c = TOKEN(ch); if (!c) break; switch (parser->header_state) { case h_general: break; case h_C: parser->index++; parser->header_state = (c == 'o' ? h_CO : h_general); break; case h_CO: parser->index++; parser->header_state = (c == 'n' ? h_CON : h_general); break; case h_CON: parser->index++; switch (c) { case 'n': parser->header_state = h_matching_connection; break; case 't': parser->header_state = h_matching_content_length; break; default: parser->header_state = h_general; break; } break; /* connection */ case h_matching_connection: parser->index++; if (parser->index > sizeof(CONNECTION)-1 || c != CONNECTION[parser->index]) { parser->header_state = h_general; } else if (parser->index == sizeof(CONNECTION)-2) { parser->header_state = h_connection; } break; /* proxy-connection */ case h_matching_proxy_connection: parser->index++; if (parser->index > sizeof(PROXY_CONNECTION)-1 || c != PROXY_CONNECTION[parser->index]) { parser->header_state = h_general; } else if (parser->index == sizeof(PROXY_CONNECTION)-2) { parser->header_state = h_connection; } break; /* content-length */ case h_matching_content_length: parser->index++; if (parser->index > sizeof(CONTENT_LENGTH)-1 || c != CONTENT_LENGTH[parser->index]) { parser->header_state = h_general; } else if (parser->index == sizeof(CONTENT_LENGTH)-2) { parser->header_state = h_content_length; } break; /* transfer-encoding */ case h_matching_transfer_encoding: parser->index++; if (parser->index > sizeof(TRANSFER_ENCODING)-1 || c != TRANSFER_ENCODING[parser->index]) { parser->header_state = h_general; } else if (parser->index == sizeof(TRANSFER_ENCODING)-2) { parser->header_state = h_transfer_encoding; } break; /* upgrade */ case h_matching_upgrade: parser->index++; if (parser->index > sizeof(UPGRADE)-1 || c != UPGRADE[parser->index]) { parser->header_state = h_general; } else if (parser->index == sizeof(UPGRADE)-2) { parser->header_state = h_upgrade; } break; case h_connection: case h_content_length: case h_transfer_encoding: case h_upgrade: if (ch != ' ') parser->header_state = h_general; break; default: assert(0 && "Unknown header_state"); break; } } COUNT_HEADER_SIZE(p - start); if (p == data + len) { --p; break; } if (ch == ':') { UPDATE_STATE(s_header_value_discard_ws); CALLBACK_DATA(header_field); break; } SET_ERRNO(HPE_INVALID_HEADER_TOKEN); goto error; } case s_header_value_discard_ws: if (ch == ' ' || ch == '\t') break; if (ch == CR) { UPDATE_STATE(s_header_value_discard_ws_almost_done); break; } if (ch == LF) { UPDATE_STATE(s_header_value_discard_lws); break; } /* FALLTHROUGH */ case s_header_value_start: { MARK(header_value); UPDATE_STATE(s_header_value); parser->index = 0; c = LOWER(ch); switch (parser->header_state) { case h_upgrade: parser->flags |= F_UPGRADE; parser->header_state = h_general; break; case h_transfer_encoding: /* looking for 'Transfer-Encoding: chunked' */ if ('c' == c) { parser->header_state = h_matching_transfer_encoding_chunked; } else { parser->header_state = h_general; } break; case h_content_length: if (UNLIKELY(!IS_NUM(ch))) { SET_ERRNO(HPE_INVALID_CONTENT_LENGTH); goto error; } parser->content_length = ch - '0'; break; case h_connection: /* looking for 'Connection: keep-alive' */ if (c == 'k') { parser->header_state = h_matching_connection_keep_alive; /* looking for 'Connection: close' */ } else if (c == 'c') { parser->header_state = h_matching_connection_close; } else if (c == 'u') { parser->header_state = h_matching_connection_upgrade; } else { parser->header_state = h_matching_connection_token; } break; /* Multi-value `Connection` header */ case h_matching_connection_token_start: break; default: parser->header_state = h_general; break; } break; } case s_header_value: { const char* start = p; enum header_states h_state = (enum header_states) parser->header_state; for (; p != data + len; p++) { ch = *p; if (ch == CR) { UPDATE_STATE(s_header_almost_done); parser->header_state = h_state; CALLBACK_DATA(header_value); break; } if (ch == LF) { UPDATE_STATE(s_header_almost_done); COUNT_HEADER_SIZE(p - start); parser->header_state = h_state; CALLBACK_DATA_NOADVANCE(header_value); REEXECUTE(); } c = LOWER(ch); switch (h_state) { case h_general: { const char* p_cr; const char* p_lf; size_t limit = data + len - p; limit = MIN(limit, HTTP_MAX_HEADER_SIZE); p_cr = (const char*) memchr(p, CR, limit); p_lf = (const char*) memchr(p, LF, limit); if (p_cr != NULL) { if (p_lf != NULL && p_cr >= p_lf) p = p_lf; else p = p_cr; } else if (UNLIKELY(p_lf != NULL)) { p = p_lf; } else { p = data + len; } --p; break; } case h_connection: case h_transfer_encoding: assert(0 && "Shouldn't get here."); break; case h_content_length: { uint64_t t; if (ch == ' ') break; if (UNLIKELY(!IS_NUM(ch))) { SET_ERRNO(HPE_INVALID_CONTENT_LENGTH); parser->header_state = h_state; goto error; } t = parser->content_length; t *= 10; t += ch - '0'; /* Overflow? Test against a conservative limit for simplicity. */ if (UNLIKELY((ULLONG_MAX - 10) / 10 < parser->content_length)) { SET_ERRNO(HPE_INVALID_CONTENT_LENGTH); parser->header_state = h_state; goto error; } parser->content_length = t; break; } /* Transfer-Encoding: chunked */ case h_matching_transfer_encoding_chunked: parser->index++; if (parser->index > sizeof(CHUNKED)-1 || c != CHUNKED[parser->index]) { h_state = h_general; } else if (parser->index == sizeof(CHUNKED)-2) { h_state = h_transfer_encoding_chunked; } break; case h_matching_connection_token_start: /* looking for 'Connection: keep-alive' */ if (c == 'k') { h_state = h_matching_connection_keep_alive; /* looking for 'Connection: close' */ } else if (c == 'c') { h_state = h_matching_connection_close; } else if (c == 'u') { h_state = h_matching_connection_upgrade; } else if (STRICT_TOKEN(c)) { h_state = h_matching_connection_token; } else if (c == ' ' || c == '\t') { /* Skip lws */ } else { h_state = h_general; } break; /* looking for 'Connection: keep-alive' */ case h_matching_connection_keep_alive: parser->index++; if (parser->index > sizeof(KEEP_ALIVE)-1 || c != KEEP_ALIVE[parser->index]) { h_state = h_matching_connection_token; } else if (parser->index == sizeof(KEEP_ALIVE)-2) { h_state = h_connection_keep_alive; } break; /* looking for 'Connection: close' */ case h_matching_connection_close: parser->index++; if (parser->index > sizeof(CLOSE)-1 || c != CLOSE[parser->index]) { h_state = h_matching_connection_token; } else if (parser->index == sizeof(CLOSE)-2) { h_state = h_connection_close; } break; /* looking for 'Connection: upgrade' */ case h_matching_connection_upgrade: parser->index++; if (parser->index > sizeof(UPGRADE) - 1 || c != UPGRADE[parser->index]) { h_state = h_matching_connection_token; } else if (parser->index == sizeof(UPGRADE)-2) { h_state = h_connection_upgrade; } break; case h_matching_connection_token: if (ch == ',') { h_state = h_matching_connection_token_start; parser->index = 0; } break; case h_transfer_encoding_chunked: if (ch != ' ') h_state = h_general; break; case h_connection_keep_alive: case h_connection_close: case h_connection_upgrade: if (ch == ',') { if (h_state == h_connection_keep_alive) { parser->flags |= F_CONNECTION_KEEP_ALIVE; } else if (h_state == h_connection_close) { parser->flags |= F_CONNECTION_CLOSE; } else if (h_state == h_connection_upgrade) { parser->flags |= F_CONNECTION_UPGRADE; } h_state = h_matching_connection_token_start; parser->index = 0; } else if (ch != ' ') { h_state = h_matching_connection_token; } break; default: UPDATE_STATE(s_header_value); h_state = h_general; break; } } parser->header_state = h_state; COUNT_HEADER_SIZE(p - start); if (p == data + len) --p; break; } case s_header_almost_done: { STRICT_CHECK(ch != LF); UPDATE_STATE(s_header_value_lws); break; } case s_header_value_lws: { if (ch == ' ' || ch == '\t') { UPDATE_STATE(s_header_value_start); REEXECUTE(); } /* finished the header */ switch (parser->header_state) { case h_connection_keep_alive: parser->flags |= F_CONNECTION_KEEP_ALIVE; break; case h_connection_close: parser->flags |= F_CONNECTION_CLOSE; break; case h_transfer_encoding_chunked: parser->flags |= F_CHUNKED; break; case h_connection_upgrade: parser->flags |= F_CONNECTION_UPGRADE; break; default: break; } UPDATE_STATE(s_header_field_start); REEXECUTE(); } case s_header_value_discard_ws_almost_done: { STRICT_CHECK(ch != LF); UPDATE_STATE(s_header_value_discard_lws); break; } case s_header_value_discard_lws: { if (ch == ' ' || ch == '\t') { UPDATE_STATE(s_header_value_discard_ws); break; } else { switch (parser->header_state) { case h_connection_keep_alive: parser->flags |= F_CONNECTION_KEEP_ALIVE; break; case h_connection_close: parser->flags |= F_CONNECTION_CLOSE; break; case h_connection_upgrade: parser->flags |= F_CONNECTION_UPGRADE; break; case h_transfer_encoding_chunked: parser->flags |= F_CHUNKED; break; default: break; } /* header value was empty */ MARK(header_value); UPDATE_STATE(s_header_field_start); CALLBACK_DATA_NOADVANCE(header_value); REEXECUTE(); } } case s_headers_almost_done: { STRICT_CHECK(ch != LF); if (parser->flags & F_TRAILING) { /* End of a chunked request */ UPDATE_STATE(NEW_MESSAGE()); CALLBACK_NOTIFY(message_complete); break; } UPDATE_STATE(s_headers_done); /* Set this here so that on_headers_complete() callbacks can see it */ parser->upgrade = ((parser->flags & (F_UPGRADE | F_CONNECTION_UPGRADE)) == (F_UPGRADE | F_CONNECTION_UPGRADE) || parser->method == HTTP_CONNECT); /* Here we call the headers_complete callback. This is somewhat * different than other callbacks because if the user returns 1, we * will interpret that as saying that this message has no body. This * is needed for the annoying case of recieving a response to a HEAD * request. * * We'd like to use CALLBACK_NOTIFY_NOADVANCE() here but we cannot, so * we have to simulate it by handling a change in errno below. */ if (settings->on_headers_complete) { switch (settings->on_headers_complete(parser)) { case 0: break; case 1: parser->flags |= F_SKIPBODY; break; default: SET_ERRNO(HPE_CB_headers_complete); RETURN(p - data); /* Error */ } } if (HTTP_PARSER_ERRNO(parser) != HPE_OK) { RETURN(p - data); } REEXECUTE(); } case s_headers_done: { STRICT_CHECK(ch != LF); parser->nread = 0; /* Exit, the rest of the connect is in a different protocol. */ if (parser->upgrade) { UPDATE_STATE(NEW_MESSAGE()); CALLBACK_NOTIFY(message_complete); RETURN((p - data) + 1); } if (parser->flags & F_SKIPBODY) { UPDATE_STATE(NEW_MESSAGE()); CALLBACK_NOTIFY(message_complete); } else if (parser->flags & F_CHUNKED) { /* chunked encoding - ignore Content-Length header */ UPDATE_STATE(s_chunk_size_start); } else { if (parser->content_length == 0) { /* Content-Length header given but zero: Content-Length: 0\r\n */ UPDATE_STATE(NEW_MESSAGE()); CALLBACK_NOTIFY(message_complete); } else if (parser->content_length != ULLONG_MAX) { /* Content-Length header given and non-zero */ UPDATE_STATE(s_body_identity); } else { if (parser->type == HTTP_REQUEST || !http_message_needs_eof(parser)) { /* Assume content-length 0 - read the next */ UPDATE_STATE(NEW_MESSAGE()); CALLBACK_NOTIFY(message_complete); } else { /* Read body until EOF */ UPDATE_STATE(s_body_identity_eof); } } } break; } case s_body_identity: { uint64_t to_read = MIN(parser->content_length, (uint64_t) ((data + len) - p)); assert(parser->content_length != 0 && parser->content_length != ULLONG_MAX); /* The difference between advancing content_length and p is because * the latter will automaticaly advance on the next loop iteration. * Further, if content_length ends up at 0, we want to see the last * byte again for our message complete callback. */ MARK(body); parser->content_length -= to_read; p += to_read - 1; if (parser->content_length == 0) { UPDATE_STATE(s_message_done); /* Mimic CALLBACK_DATA_NOADVANCE() but with one extra byte. * * The alternative to doing this is to wait for the next byte to * trigger the data callback, just as in every other case. The * problem with this is that this makes it difficult for the test * harness to distinguish between complete-on-EOF and * complete-on-length. It's not clear that this distinction is * important for applications, but let's keep it for now. */ CALLBACK_DATA_(body, p - body_mark + 1, p - data); REEXECUTE(); } break; } /* read until EOF */ case s_body_identity_eof: MARK(body); p = data + len - 1; break; case s_message_done: UPDATE_STATE(NEW_MESSAGE()); CALLBACK_NOTIFY(message_complete); break; case s_chunk_size_start: { assert(parser->nread == 1); assert(parser->flags & F_CHUNKED); unhex_val = unhex[(unsigned char)ch]; if (UNLIKELY(unhex_val == -1)) { SET_ERRNO(HPE_INVALID_CHUNK_SIZE); goto error; } parser->content_length = unhex_val; UPDATE_STATE(s_chunk_size); break; } case s_chunk_size: { uint64_t t; assert(parser->flags & F_CHUNKED); if (ch == CR) { UPDATE_STATE(s_chunk_size_almost_done); break; } unhex_val = unhex[(unsigned char)ch]; if (unhex_val == -1) { if (ch == ';' || ch == ' ') { UPDATE_STATE(s_chunk_parameters); break; } SET_ERRNO(HPE_INVALID_CHUNK_SIZE); goto error; } t = parser->content_length; t *= 16; t += unhex_val; /* Overflow? Test against a conservative limit for simplicity. */ if (UNLIKELY((ULLONG_MAX - 16) / 16 < parser->content_length)) { SET_ERRNO(HPE_INVALID_CONTENT_LENGTH); goto error; } parser->content_length = t; break; } case s_chunk_parameters: { assert(parser->flags & F_CHUNKED); /* just ignore this shit. TODO check for overflow */ if (ch == CR) { UPDATE_STATE(s_chunk_size_almost_done); break; } break; } case s_chunk_size_almost_done: { assert(parser->flags & F_CHUNKED); STRICT_CHECK(ch != LF); parser->nread = 0; if (parser->content_length == 0) { parser->flags |= F_TRAILING; UPDATE_STATE(s_header_field_start); } else { UPDATE_STATE(s_chunk_data); } break; } case s_chunk_data: { uint64_t to_read = MIN(parser->content_length, (uint64_t) ((data + len) - p)); assert(parser->flags & F_CHUNKED); assert(parser->content_length != 0 && parser->content_length != ULLONG_MAX); /* See the explanation in s_body_identity for why the content * length and data pointers are managed this way. */ MARK(body); parser->content_length -= to_read; p += to_read - 1; if (parser->content_length == 0) { UPDATE_STATE(s_chunk_data_almost_done); } break; } case s_chunk_data_almost_done: assert(parser->flags & F_CHUNKED); assert(parser->content_length == 0); STRICT_CHECK(ch != CR); UPDATE_STATE(s_chunk_data_done); CALLBACK_DATA(body); break; case s_chunk_data_done: assert(parser->flags & F_CHUNKED); STRICT_CHECK(ch != LF); parser->nread = 0; UPDATE_STATE(s_chunk_size_start); break; default: assert(0 && "unhandled state"); SET_ERRNO(HPE_INVALID_INTERNAL_STATE); goto error; } } /* Run callbacks for any marks that we have leftover after we ran our of * bytes. There should be at most one of these set, so it's OK to invoke * them in series (unset marks will not result in callbacks). * * We use the NOADVANCE() variety of callbacks here because 'p' has already * overflowed 'data' and this allows us to correct for the off-by-one that * we'd otherwise have (since CALLBACK_DATA() is meant to be run with a 'p' * value that's in-bounds). */ assert(((header_field_mark ? 1 : 0) + (header_value_mark ? 1 : 0) + (url_mark ? 1 : 0) + (body_mark ? 1 : 0) + (status_mark ? 1 : 0)) <= 1); CALLBACK_DATA_NOADVANCE(header_field); CALLBACK_DATA_NOADVANCE(header_value); CALLBACK_DATA_NOADVANCE(url); CALLBACK_DATA_NOADVANCE(body); CALLBACK_DATA_NOADVANCE(status); RETURN(len); error: if (HTTP_PARSER_ERRNO(parser) == HPE_OK) { SET_ERRNO(HPE_UNKNOWN); } RETURN(p - data); } /* Does the parser need to see an EOF to find the end of the message? */ int ICACHE_FLASH_ATTR http_message_needs_eof (const http_parser *parser) { if (parser->type == HTTP_REQUEST) { return 0; } /* See RFC 2616 section 4.4 */ if (parser->status_code / 100 == 1 || /* 1xx e.g. Continue */ parser->status_code == 204 || /* No Content */ parser->status_code == 304 || /* Not Modified */ parser->flags & F_SKIPBODY) { /* response to a HEAD request */ return 0; } if ((parser->flags & F_CHUNKED) || parser->content_length != ULLONG_MAX) { return 0; } return 1; } int ICACHE_FLASH_ATTR http_should_keep_alive (const http_parser *parser) { if (parser->http_major > 0 && parser->http_minor > 0) { /* HTTP/1.1 */ if (parser->flags & F_CONNECTION_CLOSE) { return 0; } } else { /* HTTP/1.0 or earlier */ if (!(parser->flags & F_CONNECTION_KEEP_ALIVE)) { return 0; } } return !http_message_needs_eof(parser); } const char * ICACHE_FLASH_ATTR http_method_str (enum http_method m) { return ELEM_AT(method_strings, m, ""); } void ICACHE_FLASH_ATTR http_parser_init (http_parser *parser, enum http_parser_type t) { void *data = parser->data; /* preserve application data */ memset(parser, 0, sizeof(*parser)); parser->data = data; parser->type = t; parser->state = (t == HTTP_REQUEST ? s_start_req : (t == HTTP_RESPONSE ? s_start_res : s_start_req_or_res)); parser->http_errno = HPE_OK; } void ICACHE_FLASH_ATTR http_parser_settings_init(http_parser_settings *settings) { memset(settings, 0, sizeof(*settings)); } const char * ICACHE_FLASH_ATTR http_errno_name(enum http_errno err) { assert(err < (sizeof(http_strerror_tab)/sizeof(http_strerror_tab[0]))); return http_strerror_tab[err].name; } const char * ICACHE_FLASH_ATTR http_errno_description(enum http_errno err) { assert(err < (sizeof(http_strerror_tab)/sizeof(http_strerror_tab[0]))); return http_strerror_tab[err].description; } static enum http_host_state ICACHE_FLASH_ATTR http_parse_host_char(enum http_host_state s, const char ch) { switch(s) { case s_http_userinfo: case s_http_userinfo_start: if (ch == '@') { return s_http_host_start; } if (IS_USERINFO_CHAR(ch)) { return s_http_userinfo; } break; case s_http_host_start: if (ch == '[') { return s_http_host_v6_start; } if (IS_HOST_CHAR(ch)) { return s_http_host; } break; case s_http_host: if (IS_HOST_CHAR(ch)) { return s_http_host; } /* FALLTHROUGH */ case s_http_host_v6_end: if (ch == ':') { return s_http_host_port_start; } break; case s_http_host_v6: if (ch == ']') { return s_http_host_v6_end; } /* FALLTHROUGH */ case s_http_host_v6_start: if (IS_HEX(ch) || ch == ':' || ch == '.') { return s_http_host_v6; } break; case s_http_host_port: case s_http_host_port_start: if (IS_NUM(ch)) { return s_http_host_port; } break; default: break; } return s_http_host_dead; } static int ICACHE_FLASH_ATTR http_parse_host(const char * buf, struct http_parser_url *u, int found_at) { enum http_host_state s; const char *p; size_t buflen = u->field_data[UF_HOST].off + u->field_data[UF_HOST].len; u->field_data[UF_HOST].len = 0; s = found_at ? s_http_userinfo_start : s_http_host_start; for (p = buf + u->field_data[UF_HOST].off; p < buf + buflen; p++) { enum http_host_state new_s = http_parse_host_char(s, *p); if (new_s == s_http_host_dead) { return 1; } switch(new_s) { case s_http_host: if (s != s_http_host) { u->field_data[UF_HOST].off = p - buf; } u->field_data[UF_HOST].len++; break; case s_http_host_v6: if (s != s_http_host_v6) { u->field_data[UF_HOST].off = p - buf; } u->field_data[UF_HOST].len++; break; case s_http_host_port: if (s != s_http_host_port) { u->field_data[UF_PORT].off = p - buf; u->field_data[UF_PORT].len = 0; u->field_set |= (1 << UF_PORT); } u->field_data[UF_PORT].len++; break; case s_http_userinfo: if (s != s_http_userinfo) { u->field_data[UF_USERINFO].off = p - buf ; u->field_data[UF_USERINFO].len = 0; u->field_set |= (1 << UF_USERINFO); } u->field_data[UF_USERINFO].len++; break; default: break; } s = new_s; } /* Make sure we don't end somewhere unexpected */ switch (s) { case s_http_host_start: case s_http_host_v6_start: case s_http_host_v6: case s_http_host_port_start: case s_http_userinfo: case s_http_userinfo_start: return 1; default: break; } return 0; } int ICACHE_FLASH_ATTR http_parser_parse_url(const char *buf, size_t buflen, int is_connect, struct http_parser_url *u) { enum state s; const char *p; enum http_parser_url_fields uf, old_uf; int found_at = 0; u->port = u->field_set = 0; s = is_connect ? s_req_server_start : s_req_spaces_before_url; old_uf = UF_MAX; for (p = buf; p < buf + buflen; p++) { s = parse_url_char(s, *p); /* Figure out the next field that we're operating on */ switch (s) { case s_dead: return 1; /* Skip delimeters */ case s_req_schema_slash: case s_req_schema_slash_slash: case s_req_server_start: case s_req_query_string_start: case s_req_fragment_start: continue; case s_req_schema: uf = UF_SCHEMA; break; case s_req_server_with_at: found_at = 1; /* FALLTROUGH */ case s_req_server: uf = UF_HOST; break; case s_req_path: uf = UF_PATH; break; case s_req_query_string: uf = UF_QUERY; break; case s_req_fragment: uf = UF_FRAGMENT; break; default: assert(!"Unexpected state"); return 1; } /* Nothing's changed; soldier on */ if (uf == old_uf) { u->field_data[uf].len++; continue; } u->field_data[uf].off = p - buf; u->field_data[uf].len = 1; u->field_set |= (1 << uf); old_uf = uf; } /* host must be present if there is a schema */ /* parsing http:///toto will fail */ if ((u->field_set & ((1 << UF_SCHEMA) | (1 << UF_HOST))) != 0) { if (http_parse_host(buf, u, found_at) != 0) { return 1; } } /* CONNECT requests can only contain "hostname:port" */ if (is_connect && u->field_set != ((1 << UF_HOST)|(1 << UF_PORT))) { return 1; } if (u->field_set & (1 << UF_PORT)) { /* Don't bother with endp; we've already validated the string */ unsigned long v = strtoul(buf + u->field_data[UF_PORT].off, NULL, 10); /* Ports have a max value of 2^16 */ if (v > 0xffff) { return 1; } u->port = (uint16_t) v; } return 0; } void ICACHE_FLASH_ATTR http_parser_pause(http_parser *parser, int paused) { /* Users should only be pausing/unpausing a parser that is not in an error * state. In non-debug builds, there's not much that we can do about this * other than ignore it. */ if (HTTP_PARSER_ERRNO(parser) == HPE_OK || HTTP_PARSER_ERRNO(parser) == HPE_PAUSED) { SET_ERRNO((paused) ? HPE_PAUSED : HPE_OK); } else { assert(0 && "Attempting to pause parser in error state"); } } int ICACHE_FLASH_ATTR http_body_is_final(const struct http_parser *parser) { return parser->state == s_message_done; } unsigned long ICACHE_FLASH_ATTR http_parser_version(void) { return HTTP_PARSER_VERSION_MAJOR * 0x10000 | HTTP_PARSER_VERSION_MINOR * 0x00100 | HTTP_PARSER_VERSION_PATCH * 0x00001; } ================================================ FILE: app/http/http_parser.h ================================================ /* Copyright Joyent, Inc. and other Node contributors. 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 http_parser_h #define http_parser_h #ifdef __cplusplus extern "C" { #endif /* Also update SONAME in the Makefile whenever you change these. */ #define HTTP_PARSER_VERSION_MAJOR 2 #define HTTP_PARSER_VERSION_MINOR 4 #define HTTP_PARSER_VERSION_PATCH 2 #include #include "c_stdint.h" #include "mem.h" #include "osapi.h" #include "user_interface.h" /* Compile with -DHTTP_PARSER_STRICT=0 to make less checks, but run * faster */ #ifndef HTTP_PARSER_STRICT # define HTTP_PARSER_STRICT 0 #endif /* Maximium header size allowed. If the macro is not defined * before including this header then the default is used. To * change the maximum header size, define the macro in the build * environment (e.g. -DHTTP_MAX_HEADER_SIZE=). To remove * the effective limit on the size of the header, define the macro * to a very large number (e.g. -DHTTP_MAX_HEADER_SIZE=0x7fffffff) */ #ifndef HTTP_MAX_HEADER_SIZE # define HTTP_MAX_HEADER_SIZE (80*1024) #endif typedef struct http_parser http_parser; typedef struct http_parser_settings http_parser_settings; /* Callbacks should return non-zero to indicate an error. The parser will * then halt execution. * * The one exception is on_headers_complete. In a HTTP_RESPONSE parser * returning '1' from on_headers_complete will tell the parser that it * should not expect a body. This is used when receiving a response to a * HEAD request which may contain 'Content-Length' or 'Transfer-Encoding: * chunked' headers that indicate the presence of a body. * * http_data_cb does not return data chunks. It will be called arbitrarily * many times for each string. E.G. you might get 10 callbacks for "on_url" * each providing just a few characters more data. */ typedef int (*http_data_cb) (http_parser*, const char *at, size_t length); typedef int (*http_cb) (http_parser*); /* Request Methods */ #define HTTP_METHOD_MAP(XX) \ XX(0, DELETE, DELETE) \ XX(1, GET, GET) \ XX(2, HEAD, HEAD) \ XX(3, POST, POST) \ XX(4, PUT, PUT) \ /* pathological */ \ XX(5, CONNECT, CONNECT) \ XX(6, OPTIONS, OPTIONS) \ XX(7, TRACE, TRACE) \ /* webdav */ \ XX(8, COPY, COPY) \ XX(9, LOCK, LOCK) \ XX(10, MKCOL, MKCOL) \ XX(11, MOVE, MOVE) \ XX(12, PROPFIND, PROPFIND) \ XX(13, PROPPATCH, PROPPATCH) \ XX(14, SEARCH, SEARCH) \ XX(15, UNLOCK, UNLOCK) \ /* subversion */ \ XX(16, REPORT, REPORT) \ XX(17, MKACTIVITY, MKACTIVITY) \ XX(18, CHECKOUT, CHECKOUT) \ XX(19, MERGE, MERGE) \ /* upnp */ \ XX(20, MSEARCH, M-SEARCH) \ XX(21, NOTIFY, NOTIFY) \ XX(22, SUBSCRIBE, SUBSCRIBE) \ XX(23, UNSUBSCRIBE, UNSUBSCRIBE) \ /* RFC-5789 */ \ XX(24, PATCH, PATCH) \ XX(25, PURGE, PURGE) \ /* CalDAV */ \ XX(26, MKCALENDAR, MKCALENDAR) \ enum http_method { #define XX(num, name, string) HTTP_##name = num, HTTP_METHOD_MAP(XX) #undef XX }; enum http_parser_type { HTTP_REQUEST, HTTP_RESPONSE, HTTP_BOTH }; /* Flag values for http_parser.flags field */ enum flags { F_CHUNKED = 1 << 0 , F_CONNECTION_KEEP_ALIVE = 1 << 1 , F_CONNECTION_CLOSE = 1 << 2 , F_CONNECTION_UPGRADE = 1 << 3 , F_TRAILING = 1 << 4 , F_UPGRADE = 1 << 5 , F_SKIPBODY = 1 << 6 }; /* Map for errno-related constants * * The provided argument should be a macro that takes 2 arguments. */ #define HTTP_ERRNO_MAP(XX) \ /* No error */ \ XX(OK, "success") \ \ /* Callback-related errors */ \ XX(CB_message_begin, "the on_message_begin callback failed") \ XX(CB_url, "the on_url callback failed") \ XX(CB_header_field, "the on_header_field callback failed") \ XX(CB_header_value, "the on_header_value callback failed") \ XX(CB_headers_complete, "the on_headers_complete callback failed") \ XX(CB_body, "the on_body callback failed") \ XX(CB_message_complete, "the on_message_complete callback failed") \ XX(CB_status, "the on_status callback failed") \ \ /* Parsing-related errors */ \ XX(INVALID_EOF_STATE, "stream ended at an unexpected time") \ XX(HEADER_OVERFLOW, \ "too many header bytes seen; overflow detected") \ XX(CLOSED_CONNECTION, \ "data received after completed connection: close message") \ XX(INVALID_VERSION, "invalid HTTP version") \ XX(INVALID_STATUS, "invalid HTTP status code") \ XX(INVALID_METHOD, "invalid HTTP method") \ XX(INVALID_URL, "invalid URL") \ XX(INVALID_HOST, "invalid host") \ XX(INVALID_PORT, "invalid port") \ XX(INVALID_PATH, "invalid path") \ XX(INVALID_QUERY_STRING, "invalid query string") \ XX(INVALID_FRAGMENT, "invalid fragment") \ XX(LF_EXPECTED, "LF character expected") \ XX(INVALID_HEADER_TOKEN, "invalid character in header") \ XX(INVALID_CONTENT_LENGTH, \ "invalid character in content-length header") \ XX(INVALID_CHUNK_SIZE, \ "invalid character in chunk size header") \ XX(INVALID_CONSTANT, "invalid constant string") \ XX(INVALID_INTERNAL_STATE, "encountered unexpected internal state")\ XX(STRICT, "strict mode assertion failed") \ XX(PAUSED, "parser is paused") \ XX(UNKNOWN, "an unknown error occurred") /* Define HPE_* values for each errno value above */ #define HTTP_ERRNO_GEN(n, s) HPE_##n, enum http_errno { HTTP_ERRNO_MAP(HTTP_ERRNO_GEN) }; #undef HTTP_ERRNO_GEN /* Get an http_errno value from an http_parser */ #define HTTP_PARSER_ERRNO(p) ((enum http_errno) (p)->http_errno) struct http_parser { /** PRIVATE **/ unsigned int type : 2; /* enum http_parser_type */ unsigned int flags : 7; /* F_* values from 'flags' enum; semi-public */ unsigned int state : 7; /* enum state from http_parser.c */ unsigned int header_state : 8; /* enum header_state from http_parser.c */ unsigned int index : 8; /* index into current matcher */ uint32_t nread; /* # bytes read in various scenarios */ uint64_t content_length; /* # bytes in body (0 if no Content-Length header) */ /** READ-ONLY **/ unsigned short http_major; unsigned short http_minor; unsigned int status_code : 16; /* responses only */ unsigned int method : 8; /* requests only */ unsigned int http_errno : 7; /* 1 = Upgrade header was present and the parser has exited because of that. * 0 = No upgrade header present. * Should be checked when http_parser_execute() returns in addition to * error checking. */ unsigned int upgrade : 1; /** PUBLIC **/ void *data; /* A pointer to get hook to the "connection" or "socket" object */ }; struct http_parser_settings { http_cb on_message_begin; http_data_cb on_url; http_data_cb on_status; http_data_cb on_header_field; http_data_cb on_header_value; http_cb on_headers_complete; http_data_cb on_body; http_cb on_message_complete; }; enum http_parser_url_fields { UF_SCHEMA = 0 , UF_HOST = 1 , UF_PORT = 2 , UF_PATH = 3 , UF_QUERY = 4 , UF_FRAGMENT = 5 , UF_USERINFO = 6 , UF_MAX = 7 }; /* Result structure for http_parser_parse_url(). * * Callers should index into field_data[] with UF_* values iff field_set * has the relevant (1 << UF_*) bit set. As a courtesy to clients (and * because we probably have padding left over), we convert any port to * a uint16_t. */ struct http_parser_url { uint16_t field_set; /* Bitmask of (1 << UF_*) values */ uint16_t port; /* Converted UF_PORT string */ struct { uint16_t off; /* Offset into buffer in which field starts */ uint16_t len; /* Length of run in buffer */ } field_data[UF_MAX]; }; /* Returns the library version. Bits 16-23 contain the major version number, * bits 8-15 the minor version number and bits 0-7 the patch level. * Usage example: * * unsigned long version = http_parser_version(); * unsigned major = (version >> 16) & 255; * unsigned minor = (version >> 8) & 255; * unsigned patch = version & 255; * printf("http_parser v%u.%u.%u\n", major, minor, patch); */ unsigned long ICACHE_FLASH_ATTR http_parser_version(void); void ICACHE_FLASH_ATTR http_parser_init(http_parser *parser, enum http_parser_type type); /* Initialize http_parser_settings members to 0 */ void ICACHE_FLASH_ATTR http_parser_settings_init(http_parser_settings *settings); /* Executes the parser. Returns number of parsed bytes. Sets * `parser->http_errno` on error. */ size_t ICACHE_FLASH_ATTR http_parser_execute(http_parser *parser, const http_parser_settings *settings, const char *data, size_t len); /* If http_should_keep_alive() in the on_headers_complete or * on_message_complete callback returns 0, then this should be * the last message on the connection. * If you are the server, respond with the "Connection: close" header. * If you are the client, close the connection. */ int ICACHE_FLASH_ATTR http_should_keep_alive(const http_parser *parser); /* Returns a string version of the HTTP method. */ const char *ICACHE_FLASH_ATTR http_method_str(enum http_method m); /* Return a string name of the given error */ const char * ICACHE_FLASH_ATTR http_errno_name(enum http_errno err); /* Return a string description of the given error */ const char * ICACHE_FLASH_ATTR http_errno_description(enum http_errno err); /* Parse a URL; return nonzero on failure */ int ICACHE_FLASH_ATTR http_parser_parse_url(const char *buf, size_t buflen, int is_connect, struct http_parser_url *u); /* Pause or un-pause the parser; a nonzero value pauses */ void ICACHE_FLASH_ATTR http_parser_pause(http_parser *parser, int paused); /* Checks if this is the final chunk of the body. */ int ICACHE_FLASH_ATTR http_body_is_final(const http_parser *parser); #ifdef __cplusplus } #endif #endif ================================================ FILE: app/http/http_process.c ================================================ /* * ---------------------------------------------------------------------------- * "THE BEER-WARE LICENSE" (Revision 42): * Israel Lot and Jeroen Domburg * wrote this file. As long as you retain this notice you can do whatever you * want with this stuff. If we meet some day, and you think this stuff is * worth it, you can buy us a beer in return. * ---------------------------------------------------------------------------- */ #include "c_types.h" #include "user_interface.h" #include "espconn.h" #include "mem.h" #include "osapi.h" #include "c_stdio.h" #include "espconn.h" #include "http_parser.h" #include "http_process.h" #include "http_server.h" #include "http_helper.h" #include "user_config.h" #include "cgi.h" static http_connection connection_poll[MAX_CONNECTIONS]; void http_execute_cgi(http_connection *conn){ if (conn->espConnection==NULL) return; if(conn->cgi.execute==NULL) return; conn->cgi.execute(conn); } int ICACHE_FLASH_ATTR http_transmit(http_connection *c){ NODE_DBG("Transmit Buffer"); int len = (c->output.bufferPos - c->output.buffer); if(len>0 && len <= HTTP_BUFFER_SIZE){ espconn_send(c->espConnection, (uint8_t*)(c->output.buffer),len); } else{ NODE_DBG("Wrong transmit size %d",len); } //free buffer http_reset_buffer(c); return len; } int ICACHE_FLASH_ATTR http_nwrite(http_connection *c,const char * message,size_t size){ int rem; rem = c->output.buffer + HTTP_BUFFER_SIZE - c->output.bufferPos; //NODE_DBG("Response write %d, Buffer rem %d , buffer add : %p",size,rem,c->response.buffer); if(rem < size && c->cgi.function!=cgi_transmit){ NODE_DBG("Buffer Overflow"); //copy what's possible os_memcpy(c->output.bufferPos,message,rem); message+=rem; //advance message size-=rem; //adjust size c->output.bufferPos+=rem; //mark buffer pos struct cgi_transmit_arg *transmit_cgi = (struct cgi_transmit_arg*)os_malloc(sizeof(struct cgi_transmit_arg)); os_memcpy(&transmit_cgi->previous_cgi,&c->cgi,sizeof(cgi_struct)); c->cgi.function=cgi_transmit; transmit_cgi->data = (uint8_t*)os_malloc(size); os_memcpy(transmit_cgi->data,message,size); transmit_cgi->len=size; transmit_cgi->dataPos=transmit_cgi->data; c->cgi.data = transmit_cgi; c->cgi.done=0; //http_transmit(c); //goto process; //restart; }else{ os_memcpy(c->output.bufferPos,message,size); c->output.bufferPos+=size; } return 1; } int ICACHE_FLASH_ATTR http_write(http_connection *c,const char * message){ size_t len = strlen(message); return http_nwrite(c,message,len); } // HEADER RELATED FUNCTIONS ------------------------------------------------------- // // header * ICACHE_FLASH_ATTR http_get_header(http_connection *conn,const char* header){ int i=0; while(conn->headers[i].key!=NULL){ if(os_strcmp(conn->headers[i].key,header)==0) { if(conn->headers[i].value!=NULL) return &(conn->headers[i]); else return NULL; } i++; } return NULL; } void ICACHE_FLASH_ATTR http_set_save_header(http_connection *conn,const char* header){ NODE_DBG("http_parser will save header :%s",header); int j=0; while(conn->headers[j].key!=NULL && j< MAX_HEADERS) j++; if(j==MAX_HEADERS) return; conn->headers[j].key=(char*)header; conn->headers[j].save=0; } void ICACHE_FLASH_ATTR http_set_save_body(http_connection *conn){ NODE_DBG("http_parser will save body"); conn->body.save=1; //make sure body is free if(conn->body.data!=NULL){ os_free(conn->body.data); conn->body.data=NULL; } } char * ICACHE_FLASH_ATTR http_url_get_field(http_connection *c,enum http_parser_url_fields field){ if(c->url_parsed.field_set & (1<url + c->url_parsed.field_data[field].off; char * end = start + c->url_parsed.field_data[field].len -1; end++; *end=0; if(*start==0){ if(field==UF_PATH) *start='/'; } return start; } else return NULL; } char * ICACHE_FLASH_ATTR http_url_get_query_param(http_connection *c,char* param){ NODE_DBG("http_url_get_query_param"); if(!(c->url_parsed.field_set & (1<url + c->url_parsed.field_data[UF_QUERY].off; char * end = start + c->url_parsed.field_data[UF_QUERY].len -1; char *param_search = (char*)os_malloc(strlen(param)+2); os_strcpy(param_search,param); os_strcat(param_search,"="); NODE_DBG("search for : %s",param_search); char *ret=NULL; start--; //to start at ? while(start<=end){ NODE_DBG("char : %c",*start); if(*start == '?' || *start == '&' || *start=='\0'){ NODE_DBG("Is match?"); start++; //check param name, case insensitive if(os_strcasecmp(param_search,start)==0){ NODE_DBG("yes"); //match start +=strlen(param_search); ret = start; //0 end string while(*start!='\0' && *start!='&') start++; *start='\0'; break; } } start++; } os_free(param_search); return ret; } char * ICACHE_FLASH_ATTR http_url_get_host(http_connection *c){ return http_url_get_field(c,UF_HOST); } char * ICACHE_FLASH_ATTR http_url_get_path(http_connection *c){ return http_url_get_field(c,UF_PATH); } char * ICACHE_FLASH_ATTR http_url_get_query(http_connection *c){ return http_url_get_field(c,UF_QUERY); } void ICACHE_FLASH_ATTR http_parse_url(http_connection *c){ memset(&c->url_parsed,0,sizeof(struct http_parser_url)); http_parser_parse_url( (const char *)c->url, strlen(c->url), 0, &c->url_parsed ); #ifdef DEVELOP_VERSION NODE_DBG("Parse URL : %s",c->url); NODE_DBG("\tPORT: %d",c->url_parsed.port); if(c->url_parsed.field_set & (1<url + c->url_parsed.field_data[UF_SCHEMA].off,c->url_parsed.field_data[UF_SCHEMA].len); } if(c->url_parsed.field_set & (1<url + c->url_parsed.field_data[UF_HOST].off,c->url_parsed.field_data[UF_HOST].len); } if(c->url_parsed.field_set & (1<url + c->url_parsed.field_data[UF_PORT].off,c->url_parsed.field_data[UF_PORT].len); } if(c->url_parsed.field_set & (1<url + c->url_parsed.field_data[UF_PATH].off,c->url_parsed.field_data[UF_PATH].len); } if(c->url_parsed.field_set & (1<url + c->url_parsed.field_data[UF_QUERY].off,c->url_parsed.field_data[UF_QUERY].len); } if(c->url_parsed.field_set & (1<url + c->url_parsed.field_data[UF_FRAGMENT].off,c->url_parsed.field_data[UF_FRAGMENT].len); } if(c->url_parsed.field_set & (1<url + c->url_parsed.field_data[UF_USERINFO].off,c->url_parsed.field_data[UF_USERINFO].len); } #endif } //Parser callbacks static int ICACHE_FLASH_ATTR on_message_begin(http_parser *parser){ NODE_DBG("http_parser message begin"); //nothing to do here return 0; } static int ICACHE_FLASH_ATTR on_url(http_parser *parser, const char *url, size_t length) { NODE_DBG("\nhttp_parser url: "); nprintf(url,length); NODE_DBG("http_parser method: %d",parser->method); //grab the connection http_connection * conn = (http_connection *)parser->data; conn->state=HTTPD_STATE_ON_URL; //set state os_memcpy(conn->url,url,length); //copy url to connection info conn->url[length]=0; //null terminate string http_parse_url(conn); //execute cgi http_execute_cgi(conn); return 0; } static int ICACHE_FLASH_ATTR on_status(http_parser *parser, const char *url, size_t length) { NODE_DBG("http_parser status: "); nprintf(url,length); //grab the connection http_connection * conn = (http_connection *)parser->data; conn->state=HTTPD_STATE_ON_STATUS; //set state //execute cgi again http_execute_cgi(conn); return 0; } static int ICACHE_FLASH_ATTR on_header_field(http_parser *parser, const char *at, size_t length) { NODE_DBG("http_parser header: "); nprintf(at,length); //grab the connection http_connection * conn = (http_connection *)parser->data; int i=0; while(conn->headers[i].key!=NULL){ if(os_strncmp(conn->headers[i].key,at,length)==0){ NODE_DBG("marking header to save"); //match header //turn on save header conn->headers[i].save=1; break; } i++; } return 0; } static int ICACHE_FLASH_ATTR on_header_value(http_parser *parser, const char *at, size_t length) { NODE_DBG("http_parser header value: "); nprintf(at,length); //grab the connection http_connection * conn = (http_connection *)parser->data; int i=0; while(conn->headers[i].key!=NULL){ if(conn->headers[i].save==1){ NODE_DBG("saving header"); conn->headers[i].value=(char *) os_malloc(length+1); os_memcpy(conn->headers[i].value,at,length); conn->headers[i].value[length]=0; //terminate string; conn->headers[i].save=0; break; } i++; } return 0; } static int ICACHE_FLASH_ATTR on_headers_complete(http_parser *parser){ NODE_DBG("\nhttp_parser headers complete"); //grab the connection http_connection * conn = (http_connection *)parser->data; conn->state = HTTPD_STATE_HEADERS_END; //set state //execute cgi again http_execute_cgi(conn); } static int ICACHE_FLASH_ATTR on_body(http_parser *parser, const char *at, size_t length) { NODE_DBG("\nhttp_parser body: "); nprintf(at,length); //grab the connection http_connection * conn = (http_connection *)parser->data; conn->state = HTTPD_STATE_ON_BODY; //set state if(conn->body.save){ if(conn->body.data==NULL){ NODE_DBG("saving body len %d",length); conn->body.data = (char *) os_malloc(length+1); os_memcpy(conn->body.data,at,length); conn->body.len = length; conn->body.data[length]=0; } else{ //assuming body can come in different tcp packets, this callback will be called //more than once NODE_DBG("appending body len %d",length); size_t newLenght = conn->body.len+length; char * newBuffer = (char *) os_malloc(newLenght+1); os_memcpy(newBuffer,conn->body.data,conn->body.len); //copy previous data os_memcpy(newBuffer+conn->body.len,at,length); //copy new data os_free(conn->body.data); //free previous conn->body.data=newBuffer; conn->body.len=newLenght; conn->body.data[newLenght]=0; } } //execute cgi again http_execute_cgi(conn); return 0; } //special callback like function to pass ws data to cgi static int ICACHE_FLASH_ATTR on_websocket_data(http_parser *parser, char *data, size_t length) { NODE_DBG("\non_websocket_data : "); int i; for(i=0;idata; conn->state = HTTPD_STATE_WS_DATA; //set state conn->body.data = (char *)data; conn->body.len = length; //execute cgi again http_execute_cgi(conn); conn->body.data=NULL; conn->body.len=0; return 0; } static int ICACHE_FLASH_ATTR on_message_complete(http_parser *parser){ NODE_DBG("\nhttp_parser message complete"); //grab the connection http_connection * conn = (http_connection *)parser->data; conn->state = HTTPD_STATE_BODY_END; //set state //execute cgi again http_execute_cgi(conn); //free body if(conn->body.save==1 && conn->body.data!=NULL){ NODE_DBG("freeing body memory"); os_free(conn->body.data); conn->body.len=0; } return 0; } //Looks up the connection for a specific esp connection static http_connection ICACHE_FLASH_ATTR *http_process_find_connection(void *arg) { int i; if(arg==0){ NODE_DBG("http_process_find_connection: Couldn't find connection for %p", arg); return NULL; } for(i=0;iespConnection=NULL; conn->cgi.function=NULL; conn->cgi.data=NULL; conn->cgi.argument=NULL; //free headers int j=0; while(jheaders[j].value!=NULL && (conn->headers[j].value!=conn->headers[j].key)) { os_free(conn->headers[j].value); conn->headers[j].value=NULL; } conn->headers[j].key=NULL; j++; } //free buffer os_free(conn->output.buffer); } //esp conn callbacks static void ICACHE_FLASH_ATTR http_process_sent_cb(void *arg) { NODE_DBG("\nhttp_process_sent_cb, conn %p",arg); http_connection *conn = http_process_find_connection(arg); if(conn==NULL) return; if (conn->cgi.done==1) { //Marked for destruction? NODE_DBG("Conn %p is done. Closing.", conn->espConnection); espconn_disconnect(conn->espConnection); http_process_free_connection(conn); return; //No need to execute cgi again }// if(conn->parser.upgrade){ conn->state = HTTPD_STATE_WS_DATA_SENT; //set state } http_execute_cgi(conn); } //Callback called when there's data available on a socket. static void ICACHE_FLASH_ATTR http_process_received_cb(void *arg, char *data, unsigned short len) { NODE_DBG("\nhttp_process_received_cb, len: %d",len); http_connection *conn = http_process_find_connection(arg); if(conn==NULL){ espconn_disconnect(arg); return; } //pass data to http_parser size_t nparsed = http_parser_execute( &(conn->parser), &(conn->parser_settings), data, len); if (conn->parser.upgrade) { /* handle new protocol */ on_websocket_data(&conn->parser,data,len); } else if (nparsed != len) { /* Handle error. Usually just close the connection. */ espconn_disconnect(conn->espConnection); http_process_free_connection(conn); } } static void ICACHE_FLASH_ATTR http_process_disconnect_cb(void *arg) { NODE_DBG("Disconnect conn=%p",arg); http_connection *conn = http_process_find_connection(arg); if(conn!=NULL){ //is it a client connection? if(conn->espConnection== &conn->client_connection){ //tell parser about EOF http_parser_execute( &(conn->parser), &(conn->parser_settings), NULL, 0); } if (conn->parser.upgrade) { conn->state=HTTPD_STATE_WS_CLIENT_DISCONNECT; http_execute_cgi(conn); } http_process_free_connection(conn); } else{ //find connections that should be closed int i; for(i=0;istate==ESPCONN_NONE || conn->state >=ESPCONN_CLOSE){ //should close //is it a client connection? If yes, don't free if(&connection_poll[i].client_connection != connection_poll[i].espConnection) { http_process_free_connection(&connection_poll[i]); } } } } } } static void ICACHE_FLASH_ATTR http_process_reconnect_cb(void *arg, sint8 err) { //some error NODE_DBG("Reconnect conn=%p err %d",arg,err); struct espconn * conn = (struct espconn *)arg; conn->state=ESPCONN_CLOSE; // make sure of that http_process_disconnect_cb(arg); } http_connection ICACHE_FLASH_ATTR * http_new_connection(uint8_t in,struct espconn *conn){ int i; //Find empty connection in pool for (i=0; i=MAX_CONNECTIONS) { NODE_DBG("Connection pool overflow!"); if(conn!=NULL){ espconn_disconnect(conn); } return; } NODE_DBG("\nNew connection, conn=%p, pool slot %d", conn, i); if(conn!=NULL){ connection_poll[i].espConnection=conn; connection_poll[i].espConnection->reverse=&connection_poll[i]; } //allocate buffer connection_poll[i].output.buffer = (uint8_t *)os_zalloc(HTTP_BUFFER_SIZE); //zero headers again- for sanity int j=0; while(jreverse=&connection_poll[i]; //set reverse object connection_poll[i].espConnection->type=ESPCONN_TCP; connection_poll[i].espConnection->state=ESPCONN_NONE; connection_poll[i].espConnection->proto.tcp = &connection_poll[i].client_tcp; //register espconn callbacks espconn_regist_recvcb(connection_poll[i].espConnection, http_process_received_cb); espconn_regist_reconcb(connection_poll[i].espConnection, http_process_reconnect_cb); espconn_regist_disconcb(connection_poll[i].espConnection, http_process_disconnect_cb); espconn_regist_sentcb(connection_poll[i].espConnection, http_process_sent_cb); } espconn_regist_time(conn,30,0); return &connection_poll[i]; } static void ICACHE_FLASH_ATTR http_process_init(){ int i; //init connection pool for (i=0; i and Jeroen Domburg * wrote this file. As long as you retain this notice you can do whatever you * want with this stuff. If we meet some day, and you think this stuff is * worth it, you can buy us a beer in return. * ---------------------------------------------------------------------------- */ #ifndef http_server_h #define http_server_h #include "http_parser.h" #define HTTPD_CGI_MORE 0 //when we want to lock cgi on that function #define HTTPD_CGI_DONE 1 #define HTTPD_CGI_NOTFOUND 2 //not found on that cgi #define HTTPD_CGI_AUTHENTICATED 2 //for now #define HTTPD_CGI_NEXT_RULE 3 //allow other cgi to execute #define HTTPD_STATE_ON_URL 0 #define HTTPD_STATE_ON_STATUS 1 #define HTTPD_STATE_HEADERS_END 2 #define HTTPD_STATE_ON_BODY 3 #define HTTPD_STATE_BODY_END 4 #define HTTPD_STATE_WS_DATA 5 #define HTTPD_STATE_WS_DATA_SENT 6 #define HTTPD_STATE_WS_CLIENT_DISCONNECT 7 //client #define HTTP_CLIENT_CGI_MORE 0 #define HTTP_CLIENT_CGI_DONE 1 #define HTTP_CLIENT_DNS_FOUND 100 #define HTTP_CLIENT_DNS_NOT_FOUND 101 #define HTTP_CLIENT_CONNECT_OK 200 #define HTTP_CLIENT_CONNECT_FAIL 201 #define HTTP_CLIENT_REQUEST_HEADERS_SENT 202 #define HTTP_CLIENT_REQUEST_BODY_SENT 203 //ws #define HTTP_WS_CGI_MORE 0 #define HTTP_WS_CGI_DONE 1 #define MAX_CONNECTIONS 8 #include "http.h" int ICACHE_FLASH_ATTR http_transmit(http_connection *c); int ICACHE_FLASH_ATTR http_write(http_connection *c,const char * message); int ICACHE_FLASH_ATTR http_nwrite(http_connection *c,const char * message,size_t size); void ICACHE_FLASH_ATTR http_process_free_connection(http_connection *conn); char * ICACHE_FLASH_ATTR http_url_get_path(http_connection *c); char * ICACHE_FLASH_ATTR http_url_get_host(http_connection *c); char * ICACHE_FLASH_ATTR http_url_get_query(http_connection *c); char * ICACHE_FLASH_ATTR http_url_get_query_param(http_connection *c,char* param); void ICACHE_FLASH_ATTR http_parse_url(http_connection *c); http_connection ICACHE_FLASH_ATTR * http_new_connection(uint8_t in,struct espconn *conn); void http_execute_cgi(http_connection *conn); void ICACHE_FLASH_ATTR http_set_save_header(http_connection *conn,const char* header); void ICACHE_FLASH_ATTR http_set_save_body(http_connection *conn); header * ICACHE_FLASH_ATTR http_get_header(http_connection *conn,const char* header); #endif ================================================ FILE: app/http/http_server.c ================================================ /* * ---------------------------------------------------------------------------- * "THE BEER-WARE LICENSE" (Revision 42): * Israel Lot and Jeroen Domburg * wrote this file. As long as you retain this notice you can do whatever you * want with this stuff. If we meet some day, and you think this stuff is * worth it, you can buy us a beer in return. * ---------------------------------------------------------------------------- */ #include "c_types.h" #include "user_interface.h" #include "espconn.h" #include "mem.h" #include "osapi.h" #include "c_stdio.h" #include "espconn.h" #include "http_parser.h" #include "http_server.h" #include "http_helper.h" #include "http_process.h" #include "user_config.h" #include "cgi.h" static http_server_config server_config; // Called after cgi execution to flush any data void ICACHE_FLASH_ATTR http_send_response(http_connection * conn){ NODE_DBG("http_send_response"); int sent = http_transmit(conn); //any data sent? if(sent == 0){ //if there was no data sent and cgi is done, we should destroy the connection if (conn->cgi.done==1) { NODE_DBG("Conn %p is done. Closing.", conn->espConnection); espconn_disconnect(conn->espConnection); http_process_free_connection(conn); return; } } } int ICACHE_FLASH_ATTR http_server_flag_check(http_connection *c,http_server_url *url){ NODE_DBG("http_server_flag_check"); int r=HTTPD_CGI_NEXT_RULE; if(url->method!=HTTP_ANY_METHOD){ c->cgi.argument=&url->method; r = cgi_enforce_method(c); if(r==HTTPD_CGI_DONE) return r; //return now as request already failed } if(url->flags & NEED_BODY){ r = cgi_enforce_body(c); if(r==HTTPD_CGI_DONE) return r; //return now as request already failed } return r; } // CGI dispatcher for the http server // int ICACHE_FLASH_ATTR http_server_cgi_execute(http_connection * conn){ NODE_DBG("http_execute_cgi"); //request is finished and we should start sending response //if not final, cgi should not expect data to be sent uint8_t final = conn->state==HTTPD_STATE_BODY_END; if(conn->cgi.done) return 0; //Any CGI function already attached? if(conn->cgi.function!=NULL){ NODE_DBG("Executing previous cgi "); int r; r=conn->cgi.function(conn); NODE_DBG("Cgi return is %d", r); if(r==HTTPD_CGI_DONE){ conn->cgi.function=NULL; //mark for destruction conn->cgi.done=1; } if(final) http_send_response(conn); if(r==HTTPD_CGI_MORE ||r==HTTPD_CGI_DONE){ return 0; } } else{ //find which cgi to execute base on the url NODE_DBG("Finding cgi to execute "); int i=0; while (server_config.urls[i]->url!=NULL && conn->url!=NULL) { const char * url = server_config.urls[i]->url; //NODE_DBG("Checking url %s against %s",server_config.urls[i]->url,conn->url); int match=0; char *url_path = http_url_get_path(conn); NODE_DBG("Url path: %s",url_path); if (os_strcmp(url, url_path)==0) match=1; if (url[os_strlen(url)-1]=='*' && os_strncmp(url, url_path, os_strlen(url)-1)==0) match=1; if (match) { NODE_DBG("Url match index %d", i); //general rules go here int r = http_server_flag_check(conn,server_config.urls[i]); if(r!=HTTPD_CGI_DONE){ //if passed general rules //execute cgi conn->cgi.function=server_config.urls[i]->cgiFunction; conn->cgi.argument=server_config.urls[i]->cgiArgument; r=conn->cgi.function(conn); } NODE_DBG("Cgi return is %d", r); if(r==HTTPD_CGI_DONE){ // cgi is done, nothing more to do conn->cgi.function=NULL; //mark for destruction conn->cgi.done=1; http_send_response(conn); //force sending the response regardless of the state we are return 0; //exit loop and return } if(final) // if we are in final state, try to send the response for any return case http_send_response(conn); if(r==HTTPD_CGI_NEXT_RULE){ //cgi signal that we should allow other cgi to execute on the same url conn->cgi.function=NULL; //clear cgi function } if(r==HTTPD_CGI_NOTFOUND){ //the cgi doesn't recognize the request conn->cgi.function=NULL; //clear cgi function } if(r==HTTPD_CGI_MORE){ //cgi signaled ok, but there's more to do on a next round return 0; // return so cgi function remains attached } } i++; } } if(final){ //if we got here, it's a 404 http_response_NOT_FOUND(conn); conn->cgi.function=NULL; //clear cgi conn->cgi.done=1; //mark cgi end http_send_response(conn); } return 0; } // called when a client connects to our server void ICACHE_FLASH_ATTR http_server_connect_callback(void *arg) { struct espconn *conn=arg; http_connection *c = http_new_connection(1,conn); // get a connection from the pool, signal it's an incomming connection c->cgi.execute = http_server_cgi_execute; // attach our cgi dispatcher //let's disable NAGLE alg so TCP outputs faster ( in theory ) espconn_set_opt(conn, ESPCONN_NODELAY | ESPCONN_REUSEADDR ); } //SERVER CONFIG FUNCTIONS --------------------------------------------------- void ICACHE_FLASH_ATTR http_server_init() { espconn_delete(&server_config.server_conn); //just to be sure we are on square 1 server_config.server_conn.type = ESPCONN_TCP; server_config.server_conn.state = ESPCONN_NONE; server_config.server_conn.proto.tcp = &server_config.server_tcp; server_config.server_conn.proto.tcp->local_port = 80; NODE_DBG("Http server init, conn=%p", &server_config.server_conn); } void ICACHE_FLASH_ATTR http_server_bind_port(int port){ if(server_config.server_conn.state != ESPCONN_NONE){ NODE_DBG("Can't change port after server started"); return; } server_config.server_conn.proto.tcp->local_port = port; } //create the url map http_server_url checkHost_url = {"*", cgi_check_host, &server_config,HTTP_ANY_METHOD,NO_FLAG}; http_server_url cors_url = {"*", cgi_cors, &server_config,HTTP_ANY_METHOD,NO_FLAG}; http_server_url fileSystem_url = {"*", cgi_file_system, NULL,HTTP_ANY_METHOD,NO_FLAG}; http_server_url null_url = {NULL,NULL,NULL,HTTP_ANY_METHOD,NO_FLAG}; void ICACHE_FLASH_ATTR http_server_bind_urls(http_server_url *urls){ int i; int count=0; //count urls while(urls[count].url!=NULL) count++; if(server_config.urls){ //free alloced rewrite urls for(i=0;iurl=server_config.rewrites[i].match_url; rewrite_url->cgiFunction=cgi_url_rewrite; rewrite_url->cgiArgument=server_config.rewrites[i].rewrite_url; rewrite_url->method=HTTP_ANY_METHOD; rewrite_url->flags=NO_FLAG; server_config.urls[2+i]=rewrite_url; } for(i=0;iurl); } #endif } //Should be called before http_server_bind_urls void ICACHE_FLASH_ATTR http_server_rewrite(url_rewrite *rewrites){ int count=0; //count urls while(rewrites[count].match_url!=NULL) count++; server_config.rewrites=rewrites; server_config.rewrite_count=count; } void ICACHE_FLASH_ATTR http_server_bind_domain(const char * domain){ server_config.host_domain = domain; } void ICACHE_FLASH_ATTR http_server_enable_captive_portal(){ server_config.enable_captive=1; } void ICACHE_FLASH_ATTR http_server_enable_cors(){ server_config.enable_cors=1; } void ICACHE_FLASH_ATTR http_server_start(){ if(!server_config.urls) http_server_bind_urls(NULL); NODE_DBG("Http server start, conn=%p", &server_config.server_conn); espconn_regist_connectcb(&server_config.server_conn, http_server_connect_callback); espconn_accept(&server_config.server_conn); espconn_tcp_set_max_con_allow(&server_config.server_conn,10); NODE_DBG("Http server max conn = %d", espconn_tcp_get_max_con_allow(&server_config.server_conn)); } ================================================ FILE: app/http/http_server.h ================================================ /* * ---------------------------------------------------------------------------- * "THE BEER-WARE LICENSE" (Revision 42): * Israel Lot and Jeroen Domburg * wrote this file. As long as you retain this notice you can do whatever you * want with this stuff. If we meet some day, and you think this stuff is * worth it, you can buy us a beer in return. * ---------------------------------------------------------------------------- */ #ifndef __HTTP_SERVER_H #define __HTTP_SERVER_H #include "http.h" #define ANY_HOST NULL #define HTTP_ANY_METHOD -1 #define NO_FLAG 0 #define NEED_POST 1<<0 #define NEED_GET 1<<1 #define NEED_BODY 1<<2 //A struct describing an url and how it should be processed typedef struct { const char *url; http_callback cgiFunction; const void *cgiArgument; enum http_method method; uint32_t flags; } http_server_url; typedef struct{ char * match_url; char * rewrite_url; }url_rewrite; typedef struct { //Listening connection data struct espconn server_conn; esp_tcp server_tcp; http_server_url **urls; const char * host_domain; int port; uint8_t enable_captive; uint8_t enable_cors; url_rewrite * rewrites; int rewrite_count; } http_server_config; void ICACHE_FLASH_ATTR http_server_init(); void ICACHE_FLASH_ATTR http_server_bind_port(int port); void ICACHE_FLASH_ATTR http_server_bind_domain(const char * domain); void ICACHE_FLASH_ATTR http_server_bind_urls(http_server_url *urls); void ICACHE_FLASH_ATTR http_server_enable_captive_portal(); void ICACHE_FLASH_ATTR http_server_enable_cors(); void ICACHE_FLASH_ATTR http_server_start(); #endif ================================================ FILE: app/http/http_websocket_server.c ================================================ /* * ---------------------------------------------------------------------------- * "THE BEER-WARE LICENSE" (Revision 42): * Israel Lot and Jeroen Domburg * wrote this file. As long as you retain this notice you can do whatever you * want with this stuff. If we meet some day, and you think this stuff is * worth it, you can buy us a beer in return. * ---------------------------------------------------------------------------- */ #include "c_types.h" #include "user_interface.h" #include "espconn.h" #include "mem.h" #include "osapi.h" #include "c_stdio.h" #include "espconn.h" #include "http_parser.h" #include "http_helper.h" #include "http_process.h" #include "http_websocket_server.h" #include "user_config.h" #include "ssl/ssl_crypto.h" #include "util/base64.h" #include "websocket.h" #define WS_PORT 8088 static http_ws_config ws_config; static void ICACHE_FLASH_ATTR ws_output_write_function(const char * data,size_t len,void *arg){ http_connection *c = (http_connection *)arg; http_nwrite(c,data,len); } static http_callback app_callback; static http_callback data_sent_callback; static http_callback client_disconnected_callback; static http_callback client_connected_callback; static void http_ws_handle_message(http_connection *c,ws_frame *msg){ if(c->cgi.function!=NULL){ //put frame on argument c->cgi.argument=(void *)msg; //call cgi int r = c->cgi.function(c); int sent = http_transmit(c); if(r==HTTP_WS_CGI_DONE){ //we should close the socket c->cgi.done=1; if(sent==0){ //we should active close it now as no data was sent, so there will be no further callback //TODO send close frame instead of hard closing espconn_disconnect(c->espConnection); http_process_free_connection(c); } } } } static const char *ws_uuid ="258EAFA5-E914-47DA-95CA-C5AB0DC85B11"; int ICACHE_FLASH_ATTR http_ws_handle_connect(http_connection *c) { NODE_DBG("http_ws_handle_connect c =%p",c); if(c->state == HTTPD_STATE_ON_URL){ http_set_save_header(c,HTTP_ORIGIN); http_set_save_header(c,HTTP_CONNECTION); http_set_save_header(c,HTTP_UPGRADE); http_set_save_header(c,HTTP_SEC_WEBSOCKET_KEY); http_set_save_header(c,HTTP_SEC_WEBSOCKET_PROTOCOL); http_set_save_header(c,HTTP_SEC_WEBSOCKET_VERSION); return HTTP_WS_CGI_MORE; } //wait handshake request complete if(c->state != HTTPD_STATE_BODY_END) return HTTP_WS_CGI_MORE; header * upgrade_header = http_get_header(c,HTTP_UPGRADE); header * connection_header = http_get_header(c,HTTP_CONNECTION); header * origin_header = http_get_header(c,HTTP_ORIGIN); header * key_header = http_get_header(c,HTTP_SEC_WEBSOCKET_KEY); if(upgrade_header==NULL) goto badrequest; if(connection_header==NULL) goto badrequest; if(origin_header==NULL) goto badrequest; if(key_header==NULL) goto badrequest; NODE_DBG("headers ok"); if(os_strcasecmp(upgrade_header->value,"websocket")!=0) goto badrequest; // Following (https://tools.ietf.org/html/draft-ietf-hybi-thewebsocketprotocol-17) //calculate sha1 of concatenetion key+uuid uint8_t digest[20]; //sha1 is always 20 byte long SHA1_CTX ctx; SHA1_Init(&ctx); SHA1_Update(&ctx,key_header->value,os_strlen(key_header->value)); SHA1_Update(&ctx,ws_uuid,os_strlen(ws_uuid)); SHA1_Final(digest,&ctx); char base64Digest[31]; // Base64encode(base64Digest,(const char*)digest,20); //accept the handshake http_SET_HEADER(c,HTTP_UPGRADE,"WebSocket"); http_SET_HEADER(c,HTTP_CONNECTION,"Upgrade"); http_SET_HEADER(c,HTTP_WEBSOCKET_ACCEPT,base64Digest); http_websocket_HANDSHAKE(c); c->handshake_ok=1; if(client_connected_callback!=NULL) client_connected_callback(c); return HTTP_WS_CGI_MORE; badrequest: http_response_BAD_REQUEST(c); return HTTP_WS_CGI_DONE; } static int ICACHE_FLASH_ATTR http_ws_cgi_execute(http_connection * c){ NODE_DBG("http_ws_cgi_execute c =%p",c); if(!c->handshake_ok) { int r = http_ws_handle_connect(c); if(r==HTTP_WS_CGI_DONE) c->cgi.done=1; //mark for destruction http_transmit(c); } else{ if(c->body.data==NULL){ if(c->state==HTTPD_STATE_WS_DATA_SENT){ if(data_sent_callback!=NULL) data_sent_callback(c); } } else if(c->state==HTTPD_STATE_WS_DATA){ NODE_DBG("websocket frame size %d",c->body.len); ws_frame frame; ws_parse_frame(&frame,c->body.data,c->body.len); switch(frame.TYPE){ case WS_INVALID: NODE_DBG("\treceived invalid frame"); break; case WS_PING: //send ping ws_output_frame(&frame,WS_PING,"PING",strlen("PING")); ws_write_frame(&frame,ws_output_write_function,c); http_transmit(c); case WS_CLOSE: //send close back ws_output_frame(&frame,WS_PING,"\0\0",2); ws_write_frame(&frame,ws_output_write_function,c); http_transmit(c); //mark as done c->cgi.done=1; break; case WS_TEXT: case WS_BINARY: http_ws_handle_message(c,&frame); break; case WS_CONTINUATION: break; // TODO: Implement continuation logic } } else if(c->state == HTTPD_STATE_WS_CLIENT_DISCONNECT){ if(client_disconnected_callback!=NULL) client_disconnected_callback(c); } return 1; } } // called when a client connects to our server static void ICACHE_FLASH_ATTR http_ws_connect_callback(void *arg) { struct espconn *conn=arg; http_connection *c = http_new_connection(1,conn); // get a connection from the pool, signal it's an incomming connection c->cgi.execute = http_ws_cgi_execute; // attach our cgi dispatcher //attach app callback to cgi function c->cgi.function=app_callback; c->handshake_ok=0; //let's disable NAGLE alg so TCP outputs faster ( in theory ) espconn_set_opt(conn, ESPCONN_NODELAY | ESPCONN_REUSEADDR ); //override timeout to 240s espconn_regist_time(conn,240,0); } //PUBLIC function void ICACHE_FLASH_ATTR http_ws_push_text(http_connection *c,char *msg,size_t msgLen){ ws_frame frame; ws_output_frame(&frame,WS_TEXT,msg,msgLen); ws_write_frame(&frame,ws_output_write_function,c); http_transmit(c); } void ICACHE_FLASH_ATTR http_ws_push_bin(http_connection *c,char *msg,size_t msgLen){ ws_frame frame; ws_output_frame(&frame,WS_BINARY,msg,msgLen); ws_write_frame(&frame,ws_output_write_function,c); http_transmit(c); } void ICACHE_FLASH_ATTR http_ws_server_init(http_callback connect,http_callback disconnect,http_callback received,http_callback data_sent) { app_callback = received; data_sent_callback=data_sent; client_disconnected_callback = disconnect; client_connected_callback = connect; espconn_delete(&ws_config.server_conn); //just to be sure we are on square 1 ws_config.server_conn.type = ESPCONN_TCP; ws_config.server_conn.state = ESPCONN_NONE; ws_config.server_conn.proto.tcp = &ws_config.server_tcp; ws_config.server_conn.proto.tcp->local_port = WS_PORT; NODE_DBG("Websocket server init, conn=%p", &ws_config.server_conn); } void ICACHE_FLASH_ATTR http_ws_server_start(){ NODE_DBG("Websocket server start, conn=%p", &ws_config.server_conn); espconn_regist_connectcb(&ws_config.server_conn, http_ws_connect_callback); espconn_accept(&ws_config.server_conn); } ================================================ FILE: app/http/http_websocket_server.h ================================================ /* * ---------------------------------------------------------------------------- * "THE BEER-WARE LICENSE" (Revision 42): * Israel Lot and Jeroen Domburg * wrote this file. As long as you retain this notice you can do whatever you * want with this stuff. If we meet some day, and you think this stuff is * worth it, you can buy us a beer in return. * ---------------------------------------------------------------------------- */ #ifndef __HTTP_WS_SERVER_H #define __HTTP_WS_SERVER_H typedef struct { //Listening connection data struct espconn server_conn; esp_tcp server_tcp; const char * host_domain; int port; } http_ws_config; void ICACHE_FLASH_ATTR http_ws_push_bin(http_connection *c,char *msg,size_t msgLen); void ICACHE_FLASH_ATTR http_ws_push_text(http_connection *c,char *msg,size_t msgLen); void ICACHE_FLASH_ATTR http_ws_server_init(); void ICACHE_FLASH_ATTR http_ws_server_start(); #endif ================================================ FILE: app/http/rofs.c ================================================ /* * ---------------------------------------------------------------------------- * "THE BEER-WARE LICENSE" (Revision 42): * Israel Lot and Jeroen Domburg * wrote this file. As long as you retain this notice you can do whatever you * want with this stuff. If we meet some day, and you think this stuff is * worth it, you can buy us a beer in return. * ---------------------------------------------------------------------------- */ #include "osapi.h" #include "c_types.h" #include "c_stdio.h" #include "rofs.h" #include "rofs_data.c" #include "platform/common.h" //Accessing the flash through the mem emulation at 0x40200000 is a bit hairy: All accesses //*must* be aligned 32-bit accesses. Reading a short, byte or unaligned word will result in //a memory exception, crashing the program. // //This function assumes both src and dst are 4byte aligned //Reading 4bytes at a time speeds up reading from flash void ICACHE_FLASH_ATTR memcpyAligned(char *dst,const uint8 *src, int len) { uint32_t *dst32 = (uint32_t*)dst; uint32_t *src32 = (uint32_t*)src; while(len>0){ if(len>3){ *dst32=*src32; dst32++; src32++; len-=4; } else{ dst = (uint8_t*)dst32; uint32_t s = *src32; uint8_t *s8 = (uint8_t*)&s; int i; for(i=0;len>0;i++,len--,dst++) *dst=s8[i]; len=0; } } } RO_FILE* f_open(const char *fileName){ const char *fName = fileName; if(*fName=='/') //skip leading / fName++; NODE_DBG("Trying to open file %s ",fName); NODE_DBG("FS Location %p ",ro_file_system); NODE_DBG("FS data Location %p ",rofs_data); int i=0; while(iname); if(os_strcmp(fName,entry->name)==0){ RO_FILE *f = (RO_FILE*)os_malloc(sizeof(RO_FILE)); f->file = entry; f->readPos=0; return f; } i++; } return NULL; } int f_read(RO_FILE *f,char * buff,int len){ if(f==NULL) return 0; int bytesToRead = len; int remLen = f->file->size - f->readPos; if(remLen < len) bytesToRead=remLen; NODE_DBG("Reading %d bytes from %s",bytesToRead,f->file->name); memcpyAligned(buff,rofs_data+f->file->offset+f->readPos,bytesToRead); //platform_flash_read(buff,(uint32_t)(rofs_data+f->file->offset+f->readPos),bytesToRead); f->readPos+=bytesToRead; f->eof= (f->readPos == f->file->size); return bytesToRead; } void f_close(RO_FILE *file){ if(file!=NULL) os_free(file); } ================================================ FILE: app/http/rofs.h ================================================ /* * ---------------------------------------------------------------------------- * "THE BEER-WARE LICENSE" (Revision 42): * Israel Lot and Jeroen Domburg * wrote this file. As long as you retain this notice you can do whatever you * want with this stuff. If we meet some day, and you think this stuff is * worth it, you can buy us a beer in return. * ---------------------------------------------------------------------------- */ #ifndef __ROFS_H #define __ROFS_H #include "c_stdlib.h" #include "c_stdint.h" #include "c_stddef.h" #include "user_interface.h" #include "user_config.h" typedef struct { size_t size; uint8_t gzip; const char *name; uint32_t offset; } RO_FILE_ENTRY; typedef struct { size_t count; RO_FILE_ENTRY files[]; } RO_FS; typedef struct { const RO_FILE_ENTRY *file; uint32_t readPos; uint8_t eof; } RO_FILE; RO_FILE* ICACHE_FLASH_ATTR f_open(const char *fileName); int ICACHE_FLASH_ATTR f_read(RO_FILE *file,char * buff,int len); void ICACHE_FLASH_ATTR f_close(RO_FILE *file); #endif ================================================ FILE: app/http/rofs_data.c ================================================ //Generated by MKFS tool // #include "rofs.h" #include "c_types.h" #define ROFS_FILE_COUNT 7 const RO_FS ro_file_system = { .count=7, .files={ { .size=1566, .name = "index.html", .gzip=1, .offset=0 }, { .size=1755, .name = "speed_test.html", .gzip=1, .offset=1568 }, { .size=19715, .name = "cat.jpg", .gzip=1, .offset=3324 }, { .size=15791, .name = "bootstrap.css", .gzip=1, .offset=23040 }, { .size=2323, .name = "index.js", .gzip=1, .offset=38832 }, { .size=22718, .name = "lib.js", .gzip=1, .offset=41156 }, { .size=528, .name = "cats.html", .gzip=1, .offset=63876 } } }; const ICACHE_STORE_ATTR ICACHE_RODATA_ATTR uint8_t rofs_data[]={0x1f, 0x8b, 0x8, 0x0, 0x0, 0x0, 0x0, 0x0, 0x2, 0x3, 0xbd, 0x58, 0x5b, 0x6f, 0xdb, 0x36, 0x14, 0x7e, 0x76, 0x81, 0xfc, 0x7, 0x96, 0x45, 0x81, 0x3d, 0x8c, 0x91, 0x93, 0xb4, 0xc0, 0xe0, 0xca, 0x1a, 0x86, 0x74, 0xc5, 0xfa, 0xd2, 0x15, 0x73, 0x80, 0x62, 0x8f, 0xb4, 0x44, 0x5b, 0x6c, 0x25, 0x51, 0xa3, 0x28, 0x27, 0xc6, 0xb0, 0xff, 0xbe, 0xc3, 0x8b, 0x68, 0xea, 0xe2, 0xd4, 0x49, 0x83, 0x4, 0x6d, 0xc2, 0xcb, 0x39, 0xe7, 0x3b, 0x3c, 0x3c, 0x37, 0xea, 0xec, 0x45, 0x9c, 0xab, 0xb2, 0x48, 0xce, 0x5e, 0x9c, 0xc1, 0x88, 0xd1, 0xc, 0x46, 0x8, 0xc5, 0x8a, 0xab, 0x82, 0x25, 0xab, 0x92, 0x4a, 0x85, 0xfe, 0x62, 0x5, 0xdd, 0xc7, 0x91, 0x5d, 0x32, 0xbb, 0x25, 0x53, 0x14, 0xe5, 0x4a, 0xd5, 0x84, 0xfd, 0xd3, 0xf2, 0xdd, 0x12, 0x5f, 0x8b, 0x4a, 0xb1, 0x4a, 0x91, 0x9b, 0x7d, 0xcd, 0x30, 0x4a, 0xed, 0x6c, 0x89, 0x15, 0xbb, 0x53, 0x91, 0x16, 0xff, 0xe, 0xa5, 0x39, 0x95, 0xd, 0x53, 0xcb, 0x56, 0x6d, 0xc8, 0x2f, 0x38, 0x41, 0x7, 0x39, 0x15, 0x2d, 0xd9, 0x12, 0xef, 0x38, 0xbb, 0xad, 0x85, 0x54, 0x1, 0xf7, 0x2d, 0xcf, 0x54, 0xbe, 0xcc, 0xd8, 0x8e, 0xa7, 0x8c, 0x98, 0xc9, 0xcf, 0x88, 0x57, 0x5c, 0x71, 0x5a, 0x90, 0x26, 0xa5, 0x5, 0x5b, 0x5e, 0x60, 0xab, 0x4f, 0xc1, 0xab, 0x6f, 0x48, 0xb2, 0x62, 0x89, 0x1b, 0xb5, 0x2f, 0x58, 0x93, 0x33, 0x6, 0x82, 0x72, 0xc9, 0x36, 0x4b, 0xbc, 0x16, 0x42, 0x35, 0x4a, 0xd2, 0xfa, 0x3c, 0x6d, 0x1a, 0x47, 0x6f, 0xa8, 0x90, 0x2, 0x65, 0x9d, 0x8e, 0x7e, 0x6b, 0xa6, 0xe4, 0x22, 0x17, 0x3b, 0x26, 0xff, 0x35, 0xb3, 0x59, 0xda, 0xca, 0x46, 0xc8, 0x45, 0x2d, 0x38, 0x28, 0x25, 0xdf, 0x99, 0xc5, 0xff, 0x8c, 0x8c, 0xc8, 0x8, 0xb1, 0xf2, 0xa2, 0x83, 0xe1, 0xd6, 0x22, 0xdb, 0x5b, 0x49, 0x71, 0x45, 0x77, 0x28, 0x2d, 0x68, 0xd3, 0x2c, 0x31, 0xc, 0xd7, 0x54, 0x12, 0x5e, 0x81, 0xe4, 0x86, 0x21, 0x37, 0xcd, 0xd8, 0x86, 0xb6, 0x85, 0xd2, 0xc8, 0x33, 0x60, 0xcd, 0xb8, 0xa7, 0xd7, 0x36, 0xa0, 0xbc, 0x62, 0x92, 0x6c, 0x8a, 0x96, 0x67, 0x8e, 0xa2, 0x4f, 0xe3, 0x84, 0x68, 0x68, 0x26, 0x71, 0x62, 0xf6, 0x91, 0xa3, 0x3, 0x4a, 0x3a, 0xa0, 0x5b, 0x4b, 0x5a, 0x65, 0x9d, 0x51, 0x5e, 0xe1, 0x24, 0x8e, 0xa8, 0x97, 0x1a, 0x81, 0xd8, 0x29, 0x88, 0x54, 0x14, 0x5, 0xad, 0xf, 0xa, 0x77, 0x73, 0x8c, 0x78, 0x6, 0x96, 0x6d, 0x8, 0xbb, 0xa3, 0x65, 0x5d, 0x30, 0x32, 0xd8, 0x27, 0xee, 0x62, 0xc6, 0x3f, 0x71, 0x5b, 0x4, 0x7a, 0x75, 0x72, 0xe1, 0xcf, 0x31, 0x6, 0x7d, 0xb9, 0x1d, 0x7, 0x4d, 0x15, 0xdf, 0x31, 0x50, 0x9d, 0xba, 0x63, 0x44, 0x38, 0x1, 0xcf, 0xdb, 0xf0, 0xad, 0x3e, 0x4c, 0x1c, 0x15, 0xfc, 0x1e, 0x21, 0x1, 0x57, 0x53, 0x33, 0x96, 0x11, 0xc5, 0x1a, 0x30, 0xfd, 0x4a, 0x8f, 0xd1, 0xd, 0x8c, 0x4f, 0x90, 0x81, 0x2, 0x21, 0x29, 0x55, 0xe0, 0x33, 0xd7, 0xf0, 0xdb, 0x33, 0xa2, 0xa3, 0x3f, 0x47, 0x8c, 0x11, 0xb5, 0x45, 0x72, 0x22, 0xf1, 0x61, 0x31, 0xb8, 0x2d, 0x3f, 0x8c, 0x23, 0x30, 0xa1, 0x1e, 0xe8, 0xf1, 0x94, 0x1f, 0x19, 0xf, 0xd2, 0xbb, 0xb3, 0x38, 0xbf, 0xe8, 0xc7, 0x35, 0xcc, 0xc7, 0x88, 0x86, 0x52, 0xb, 0xd2, 0x17, 0x5d, 0x31, 0x75, 0x2b, 0xe4, 0x37, 0xd2, 0x28, 0xaa, 0xda, 0xc6, 0x3b, 0xe3, 0xd0, 0x5b, 0x6a, 0xba, 0x65, 0xde, 0x1d, 0xb5, 0x0, 0xd, 0x76, 0x95, 0xac, 0xc, 0x17, 0xe0, 0x5c, 0xd9, 0xc5, 0x4e, 0x69, 0x27, 0x61, 0x36, 0xb, 0x9d, 0xa2, 0xe0, 0x8d, 0x22, 0x5b, 0x29, 0xda, 0xda, 0xfa, 0x98, 0x85, 0x24, 0x7a, 0xb9, 0x93, 0xd9, 0x73, 0x89, 0x3, 0x3d, 0xe1, 0x8a, 0x95, 0x7, 0x1a, 0x1d, 0xe5, 0x35, 0xad, 0x3a, 0xba, 0x35, 0xcd, 0xb6, 0xac, 0x27, 0xb2, 0x3b, 0xc, 0x4, 0x32, 0xd0, 0x5, 0x7c, 0x56, 0x5f, 0x8f, 0x65, 0x3d, 0xe2, 0x29, 0x81, 0x1b, 0x1d, 0xd0, 0x63, 0xd8, 0xd5, 0xc7, 0xf7, 0x4f, 0xc, 0x1a, 0xa2, 0xf2, 0x7a, 0x2, 0xf3, 0xe3, 0xe7, 0x49, 0xc4, 0xa7, 0x82, 0xd4, 0x29, 0x13, 0x7c, 0x67, 0xa, 0xd8, 0x6d, 0xfd, 0x3a, 0xc6, 0x37, 0x41, 0x61, 0x47, 0xb5, 0x17, 0xde, 0x40, 0x6a, 0x29, 0x6b, 0x51, 0x41, 0x5d, 0xc0, 0xa3, 0x88, 0x99, 0x8d, 0xdd, 0x77, 0xe6, 0xe3, 0xf4, 0x15, 0xf6, 0x42, 0x54, 0x85, 0xe0, 0x3f, 0xa8, 0xb5, 0x11, 0x2e, 0x81, 0xc1, 0x2c, 0xe3, 0xd, 0x4, 0x49, 0xc5, 0x52, 0x28, 0x18, 0x26, 0xa3, 0x2f, 0x31, 0x2c, 0xd5, 0x10, 0x19, 0x8b, 0xa, 0xf0, 0x70, 0xf2, 0xde, 0x13, 0xd8, 0x8c, 0xe9, 0x21, 0x40, 0xd3, 0x3a, 0x19, 0x86, 0x65, 0x17, 0x3d, 0xc1, 0xfa, 0x28, 0x8a, 0x52, 0x5a, 0x85, 0xd9, 0x6e, 0x76, 0x42, 0xc, 0xfd, 0xb6, 0xa3, 0xbc, 0xa0, 0x6b, 0x28, 0x5a, 0x4e, 0xca, 0x44, 0x3c, 0xd, 0x25, 0x9a, 0x9b, 0x0, 0x2c, 0x52, 0x4b, 0xb1, 0x95, 0xac, 0xab, 0x70, 0xa1, 0x91, 0x40, 0xc4, 0x17, 0xca, 0x15, 0xba, 0xcd, 0x39, 0x88, 0xbe, 0x65, 0x48, 0xd3, 0xa3, 0x8d, 0x90, 0xe8, 0x96, 0x6f, 0xb8, 0xc7, 0x3a, 0x3f, 0x3f, 0x77, 0x70, 0xa3, 0xc, 0x16, 0xaa, 0xee, 0x60, 0x50, 0x37, 0x80, 0x10, 0x93, 0xbc, 0x86, 0xec, 0xea, 0xf2, 0x36, 0x42, 0xb6, 0xa2, 0xe3, 0xb7, 0xf3, 0xd7, 0x7, 0x3f, 0x9a, 0x4d, 0xc9, 0x20, 0x50, 0x15, 0xfc, 0x7d, 0x18, 0xae, 0x5, 0xba, 0x98, 0x6b, 0x36, 0x9f, 0xf2, 0xfc, 0xc9, 0x7b, 0xc9, 0x71, 0x98, 0x5d, 0xee, 0x49, 0xac, 0x7d, 0x23, 0x1, 0xaa, 0x2e, 0xc5, 0xd3, 0x3e, 0xf0, 0x1d, 0x8f, 0x9b, 0x4d, 0x89, 0x22, 0xac, 0xac, 0xd5, 0x7e, 0x64, 0x73, 0x63, 0xf4, 0x4f, 0xa2, 0xb3, 0x2d, 0x18, 0xbb, 0xad, 0x32, 0xb4, 0xf8, 0x69, 0xc2, 0xc0, 0x13, 0x37, 0x6b, 0x97, 0x95, 0xf1, 0x4, 0x67, 0x32, 0x3b, 0x31, 0xbf, 0xbd, 0xc1, 0xed, 0xcc, 0xf4, 0x31, 0x78, 0xa4, 0x97, 0xd9, 0xc, 0x92, 0xa9, 0x72, 0xcd, 0x8b, 0xf, 0x6b, 0x25, 0x3b, 0xd9, 0x4d, 0x9b, 0xa6, 0xce, 0x71, 0xba, 0x5d, 0xc3, 0x90, 0x7c, 0xb2, 0xda, 0x43, 0x53, 0x98, 0xf7, 0xf7, 0x5e, 0x12, 0x2, 0xfb, 0x5e, 0x37, 0xe8, 0xad, 0x48, 0xca, 0x74, 0xb0, 0x43, 0xa9, 0xcc, 0x29, 0x84, 0x51, 0x61, 0x78, 0x8, 0x19, 0x8a, 0x9c, 0x64, 0xf9, 0xbd, 0x4a, 0xe5, 0xbe, 0x56, 0x5c, 0x54, 0x63, 0xa4, 0x23, 0x2c, 0x2b, 0xbe, 0xad, 0xa8, 0x5, 0x99, 0x1d, 0xa8, 0x83, 0xd3, 0x45, 0x4a, 0x1e, 0xce, 0x1e, 0xf5, 0xf, 0x1f, 0x2b, 0xd3, 0xbe, 0x75, 0x8c, 0x1, 0x99, 0x6b, 0xeb, 0xac, 0xd7, 0x19, 0xb, 0x26, 0x6e, 0xfb, 0x59, 0xb2, 0x94, 0xcd, 0x19, 0x2b, 0x1d, 0x9d, 0x74, 0xb, 0x5, 0xfd, 0xfe, 0x54, 0x14, 0x76, 0x9, 0xc3, 0x79, 0x40, 0x65, 0xbc, 0xd6, 0xf9, 0x3b, 0x34, 0x4, 0x5b, 0x5e, 0x91, 0xb5, 0x50, 0x4a, 0x94, 0x8b, 0xab, 0x79, 0x7d, 0xe7, 0x2e, 0xfd, 0x3b, 0xc9, 0x9, 0xdc, 0xf9, 0x32, 0xf9, 0x5b, 0xb4, 0x12, 0x35, 0xac, 0x82, 0x4e, 0x19, 0xdc, 0xf8, 0xb2, 0x9f, 0x96, 0x3a, 0x19, 0x76, 0x88, 0xa0, 0xda, 0xc3, 0x29, 0x76, 0xb4, 0xb1, 0x7e, 0x69, 0x98, 0x88, 0x7e, 0x1c, 0xe8, 0x86, 0x9d, 0xf1, 0x6d, 0xe, 0x8d, 0xff, 0xe5, 0xdb, 0xb9, 0xe, 0x74, 0x4b, 0x37, 0x29, 0xad, 0xbb, 0xa, 0x53, 0x56, 0x6e, 0x20, 0xd2, 0x98, 0x84, 0x92, 0x23, 0xd9, 0x2, 0xb9, 0x52, 0x63, 0x6b, 0x93, 0x86, 0x80, 0xa2, 0x55, 0x93, 0x8c, 0x2a, 0x8a, 0x93, 0x39, 0xba, 0x76, 0xdb, 0x33, 0xc7, 0xbf, 0x96, 0x91, 0x1f, 0x9b, 0x8d, 0x3f, 0xda, 0x92, 0x67, 0x5c, 0xed, 0x27, 0x4, 0xe5, 0x6d, 0xe9, 0xe5, 0xbc, 0xe, 0x2b, 0x5a, 0x98, 0x92, 0xb4, 0x81, 0xa7, 0x52, 0xb2, 0xcf, 0x10, 0x52, 0x37, 0x5d, 0xb6, 0xf7, 0x7c, 0x12, 0xdb, 0xeb, 0xce, 0x15, 0xed, 0xf5, 0x5, 0x48, 0xd7, 0xce, 0x5d, 0xe, 0xcb, 0x82, 0x9e, 0x1c, 0x77, 0x34, 0xf7, 0x8, 0xb1, 0xec, 0x64, 0xdd, 0x82, 0x12, 0x15, 0x46, 0xfa, 0xa0, 0xc4, 0x2c, 0x2d, 0xf1, 0x1c, 0x7, 0x9a, 0x5b, 0x2, 0x2, 0x17, 0x64, 0xda, 0x47, 0xf4, 0x6a, 0x8e, 0xfe, 0xfc, 0xf0, 0xc1, 0x3d, 0x26, 0x7e, 0x10, 0xe8, 0x62, 0x2, 0xe8, 0xc2, 0x3, 0x5d, 0x74, 0x40, 0x43, 0x2b, 0x7, 0x3d, 0x6b, 0x70, 0x68, 0xf3, 0x6f, 0xd0, 0xe, 0x97, 0x22, 0xa3, 0x85, 0x5, 0x71, 0x35, 0x9d, 0xb8, 0xa5, 0xf1, 0x13, 0xcc, 0x6c, 0x40, 0x7b, 0x40, 0xb, 0xb1, 0xc5, 0x56, 0xe4, 0xb0, 0xe2, 0x59, 0x12, 0xf7, 0x5e, 0x45, 0x5d, 0x1b, 0x71, 0x68, 0x8f, 0xc7, 0xb4, 0xc1, 0x5, 0x6, 0x5a, 0x7b, 0x27, 0xc9, 0xdf, 0xf4, 0xc9, 0xcd, 0x93, 0xdb, 0xea, 0xeb, 0xb1, 0x8c, 0xd6, 0x76, 0x3, 0x62, 0x24, 0x7f, 0x13, 0xc0, 0x85, 0xcf, 0xb8, 0x29, 0x74, 0x9d, 0xc4, 0x8e, 0x76, 0xef, 0x50, 0xf5, 0xcb, 0xb0, 0xf3, 0xee, 0x3, 0xd6, 0x40, 0x3, 0x19, 0x3f, 0x73, 0xbe, 0xa7, 0x5b, 0x44, 0xba, 0x66, 0x45, 0xf8, 0xce, 0x90, 0xa2, 0x20, 0x66, 0x11, 0xeb, 0xe, 0xe2, 0x98, 0x0, 0x48, 0x6c, 0x75, 0xb, 0x46, 0xfa, 0xec, 0xe6, 0xd0, 0xf8, 0x69, 0x1e, 0x2f, 0xd6, 0x6c, 0xf7, 0x74, 0x72, 0xb2, 0xef, 0xd3, 0xca, 0x9, 0xd, 0x5e, 0xf4, 0x18, 0xed, 0x68, 0xd1, 0xc2, 0x4, 0x23, 0xa8, 0xe3, 0x29, 0xcb, 0x45, 0x1, 0x86, 0x5f, 0xe2, 0x2f, 0x12, 0xba, 0x58, 0x1b, 0x2f, 0xa6, 0xc5, 0x19, 0x9c, 0x6b, 0x98, 0xb4, 0xc6, 0x90, 0x95, 0x18, 0xda, 0x2, 0x2a, 0x40, 0x72, 0x93, 0x73, 0x48, 0x68, 0xd, 0x82, 0x54, 0x21, 0x6a, 0x56, 0x75, 0xd5, 0xdd, 0xa6, 0xe5, 0x43, 0xa7, 0x72, 0xfa, 0x55, 0x6d, 0x84, 0x50, 0x3, 0x47, 0x89, 0x6d, 0x44, 0xb8, 0x43, 0x76, 0xf1, 0x33, 0x1d, 0x64, 0x2e, 0xae, 0xa0, 0x8b, 0x29, 0xf9, 0xc0, 0xf1, 0xfb, 0xc7, 0x71, 0x51, 0x96, 0x16, 0x2, 0x5e, 0xf5, 0xc9, 0xb5, 0xfe, 0x13, 0x47, 0x76, 0xf1, 0xc1, 0xd8, 0xb5, 0xe4, 0x90, 0xca, 0xf6, 0xf7, 0xc1, 0x74, 0x21, 0x72, 0xdd, 0x75, 0xd4, 0x43, 0xa8, 0xfe, 0xa7, 0x88, 0x43, 0x34, 0x9f, 0x14, 0x7a, 0xbc, 0xda, 0x1e, 0x6d, 0xe0, 0x4e, 0x8, 0xca, 0x7, 0x84, 0x64, 0x77, 0x0, 0x40, 0xb4, 0xcd, 0xf1, 0x93, 0x85, 0xe1, 0x63, 0xba, 0xe8, 0x1f, 0x69, 0xa2, 0xed, 0xd0, 0x54, 0xae, 0x87, 0xfa, 0xe6, 0xd8, 0x5e, 0x8f, 0xbb, 0xbd, 0xae, 0xcb, 0x7c, 0xa6, 0xab, 0x5b, 0x59, 0xb8, 0x97, 0x8f, 0xbc, 0xb5, 0x43, 0x17, 0x8f, 0xba, 0x37, 0xd8, 0xa3, 0x63, 0xfa, 0xd9, 0x43, 0xfa, 0x21, 0x57, 0x16, 0x7c, 0x5c, 0xf2, 0xab, 0x71, 0x93, 0x82, 0x33, 0xc2, 0x95, 0xc9, 0x54, 0x7f, 0x1a, 0x58, 0x9f, 0x7f, 0x6d, 0xc2, 0xac, 0x1b, 0x7d, 0xa5, 0xd0, 0xb1, 0x19, 0x12, 0xf3, 0xe8, 0x37, 0xa3, 0x64, 0xc8, 0xc7, 0xab, 0x8c, 0xdd, 0x9d, 0xc8, 0x69, 0x3f, 0xaf, 0x76, 0x1f, 0x55, 0x63, 0xf3, 0x31, 0x39, 0xf9, 0x1f, 0x62, 0xa4, 0x88, 0x41, 0xb4, 0x16, 0x0, 0x0, 0x0, 0x0, 0x1f, 0x8b, 0x8, 0x0, 0x0, 0x0, 0x0, 0x0, 0x2, 0x3, 0xb5, 0x58, 0xeb, 0x6f, 0xdb, 0x36, 0x10, 0xff, 0x6c, 0xff, 0x15, 0xac, 0x52, 0xc0, 0x12, 0x62, 0xc9, 0x8f, 0xb4, 0x41, 0x90, 0x58, 0x6, 0xd6, 0x74, 0x8f, 0x2, 0x3, 0x56, 0x34, 0x1, 0xfa, 0x21, 0x8, 0x6, 0x5a, 0xa2, 0x6d, 0xb6, 0xb4, 0xa4, 0x89, 0x94, 0x1d, 0x2f, 0xc8, 0xff, 0xbe, 0x3b, 0x3e, 0x64, 0xc9, 0x71, 0xb2, 0x6c, 0xd9, 0xc, 0xc4, 0xa6, 0x8e, 0x77, 0xbf, 0x3b, 0xde, 0x93, 0xca, 0x64, 0xa9, 0x56, 0x62, 0xda, 0xed, 0x4e, 0x96, 0x8c, 0xa6, 0xd3, 0x2e, 0x21, 0x13, 0xc5, 0x95, 0x60, 0xd3, 0xab, 0x15, 0x2d, 0x15, 0xf9, 0xc2, 0x4, 0xdd, 0x4e, 0x6, 0x86, 0x84, 0x9b, 0x2b, 0xa6, 0x28, 0x59, 0x2a, 0x55, 0x84, 0xec, 0x8f, 0x8a, 0xaf, 0x63, 0xef, 0x32, 0xcf, 0x14, 0xcb, 0x54, 0x78, 0xbd, 0x2d, 0x98, 0x47, 0x12, 0xf3, 0x14, 0x7b, 0x8a, 0xdd, 0xa9, 0x1, 0x42, 0x5f, 0x90, 0x64, 0x49, 0x4b, 0xc9, 0x54, 0x5c, 0xa9, 0x79, 0x78, 0xe6, 0x4d, 0x49, 0xd, 0x93, 0xd1, 0x15, 0x8b, 0xbd, 0x35, 0x67, 0x9b, 0x22, 0x2f, 0x55, 0x43, 0x78, 0xc3, 0x53, 0xb5, 0x8c, 0x53, 0xb6, 0xe6, 0x9, 0xb, 0xf5, 0x43, 0x9f, 0xf0, 0x8c, 0x2b, 0x4e, 0x45, 0x28, 0x13, 0x2a, 0x58, 0x3c, 0xf2, 0xb4, 0x35, 0x82, 0x67, 0xdf, 0x49, 0xc9, 0x44, 0xec, 0x49, 0xb5, 0x15, 0x4c, 0x2e, 0x19, 0x3, 0x9c, 0x65, 0xc9, 0xe6, 0xb1, 0x37, 0xcb, 0x73, 0x25, 0x55, 0x49, 0x8b, 0x28, 0x91, 0xd2, 0xaa, 0x1d, 0xd4, 0x87, 0x9c, 0xe5, 0xe9, 0x16, 0x17, 0x9d, 0x49, 0x46, 0xd7, 0x24, 0x11, 0x54, 0xca, 0xd8, 0x83, 0xe5, 0x8c, 0x96, 0x21, 0xcf, 0xd6, 0xc, 0x2c, 0x26, 0xf6, 0x31, 0x65, 0x73, 0x5a, 0x9, 0x5, 0x1a, 0x3b, 0x20, 0x98, 0xf2, 0x9a, 0x1d, 0xed, 0xa5, 0x3c, 0x63, 0x65, 0x38, 0x17, 0x15, 0x4f, 0xd, 0x43, 0x9b, 0xc5, 0x42, 0xa0, 0x5a, 0x56, 0x7a, 0x53, 0xbd, 0x4f, 0xc, 0x1b, 0x30, 0xd2, 0x3d, 0xb6, 0x59, 0x49, 0xb3, 0xd4, 0xd9, 0x7f, 0xe4, 0x4d, 0x27, 0x3, 0xea, 0x30, 0x7, 0x0, 0x7a, 0x0, 0x3f, 0xc9, 0x85, 0xa0, 0xc5, 0xce, 0x56, 0xf7, 0xec, 0x11, 0x9e, 0x82, 0xb, 0x64, 0xc8, 0xee, 0xe8, 0xaa, 0x10, 0x2c, 0xdc, 0xdb, 0xf, 0x8d, 0x3, 0x1f, 0x7f, 0x26, 0x95, 0x68, 0x18, 0xe5, 0x60, 0xe1, 0xe7, 0x9, 0x7e, 0x8c, 0x1, 0x99, 0xc2, 0x49, 0x8c, 0xd1, 0x3, 0x6f, 0xa, 0x9, 0x31, 0xe7, 0xb, 0x34, 0x7d, 0x32, 0x10, 0xfc, 0x19, 0x29, 0xab, 0x86, 0x26, 0x8a, 0xaf, 0x99, 0xd7, 0xc0, 0x90, 0x5, 0x63, 0x69, 0xa8, 0x98, 0x4, 0x9f, 0x5f, 0xe1, 0x9a, 0x5c, 0xc3, 0xfa, 0x5, 0x88, 0xd, 0x8c, 0x84, 0x2a, 0x8, 0xfa, 0x25, 0x7c, 0xd7, 0x72, 0x7, 0xc5, 0xe, 0x3b, 0x61, 0x50, 0x89, 0xe9, 0xcb, 0x78, 0xbb, 0x3b, 0x19, 0x17, 0x21, 0xb7, 0x9a, 0xc, 0xc0, 0x6d, 0xf0, 0xb, 0xab, 0x43, 0x49, 0x83, 0xe9, 0x2, 0x7b, 0x9d, 0xc9, 0x72, 0xd4, 0x2e, 0x36, 0x78, 0x46, 0x72, 0x43, 0xa6, 0xa0, 0xb, 0x56, 0xe7, 0x10, 0xec, 0xa1, 0xd0, 0x49, 0xcb, 0x35, 0xf0, 0x88, 0x32, 0x56, 0x33, 0x6c, 0x8f, 0x31, 0x1, 0x7a, 0x52, 0x51, 0x55, 0xc9, 0x1e, 0xc6, 0x24, 0x63, 0xe0, 0xe7, 0x6c, 0x11, 0x45, 0x11, 0x70, 0x8f, 0x77, 0x4e, 0x6c, 0xea, 0x29, 0xf3, 0x8d, 0x4b, 0xe2, 0x3, 0x89, 0x16, 0x8a, 0x85, 0x4e, 0x9b, 0x7a, 0xbf, 0x65, 0xe3, 0x3c, 0x2f, 0x57, 0xe1, 0xa2, 0xcc, 0xab, 0xa2, 0xc9, 0xd2, 0x8c, 0xf, 0x9d, 0x31, 0xd1, 0xf4, 0x42, 0x89, 0x90, 0x48, 0xf4, 0xa6, 0x1f, 0xb6, 0x10, 0x6d, 0x32, 0x20, 0x5, 0x4d, 0xbe, 0x33, 0x38, 0x8e, 0x26, 0x1f, 0x86, 0x69, 0xa8, 0xe4, 0x59, 0x51, 0x29, 0xab, 0xd3, 0xe4, 0x3b, 0xc0, 0x40, 0x8a, 0x57, 0x19, 0x24, 0xce, 0x81, 0x58, 0x81, 0xdf, 0xb0, 0xf8, 0xf4, 0x47, 0x57, 0x9f, 0x2b, 0x34, 0x7, 0x28, 0xb8, 0xb4, 0x78, 0x21, 0x57, 0x6c, 0x45, 0x6c, 0x6a, 0x92, 0x94, 0x2a, 0x1a, 0x96, 0x54, 0x41, 0xb7, 0x3a, 0x19, 0x7b, 0xd3, 0x93, 0xb1, 0x29, 0xcc, 0x17, 0x3, 0x79, 0xa4, 0x9, 0x71, 0xfa, 0xce, 0x9b, 0x9e, 0xbe, 0x7b, 0x15, 0xc4, 0x68, 0xc, 0x8d, 0x14, 0xbe, 0x5e, 0x5, 0x32, 0x7e, 0x7f, 0xea, 0x4d, 0xe1, 0xeb, 0x55, 0x20, 0xef, 0x47, 0xe0, 0x10, 0xf8, 0x7a, 0xdd, 0x71, 0x86, 0x63, 0xf0, 0x9, 0x7e, 0xef, 0x60, 0xda, 0x3d, 0xef, 0x71, 0x95, 0xed, 0x95, 0x61, 0x67, 0x9f, 0x3, 0x10, 0xe, 0xe5, 0xef, 0xd0, 0x23, 0x66, 0x13, 0xb6, 0x13, 0x9a, 0xad, 0xa9, 0xd4, 0x99, 0x63, 0x5a, 0xe, 0x4e, 0x2a, 0x9c, 0x1f, 0x8c, 0x2f, 0x96, 0x30, 0x86, 0x4e, 0x86, 0x43, 0xec, 0xc1, 0x86, 0xcd, 0x42, 0x3a, 0x74, 0xbb, 0xd2, 0x15, 0xfc, 0xa8, 0x86, 0x88, 0x9e, 0x46, 0xb1, 0x7, 0x55, 0xbd, 0xe0, 0x59, 0x38, 0xcb, 0x95, 0xca, 0x57, 0xe7, 0x27, 0xc3, 0xe2, 0x4e, 0x97, 0x2f, 0x14, 0xce, 0x63, 0x7, 0xcd, 0x54, 0x46, 0xe0, 0x2f, 0x94, 0x55, 0x92, 0x30, 0x18, 0x58, 0xc4, 0xd8, 0xa5, 0xc0, 0xa2, 0x50, 0xaa, 0xbc, 0x8, 0x67, 0x15, 0xa0, 0x64, 0xd0, 0x11, 0xaf, 0x7f, 0xf8, 0x72, 0x6d, 0xfd, 0xd4, 0xb0, 0xa7, 0xdb, 0x75, 0xe5, 0xf, 0xb, 0x99, 0x94, 0xbc, 0x50, 0x44, 0x96, 0x9, 0x7a, 0x7e, 0x16, 0x7d, 0x3, 0x3c, 0x5, 0x3, 0xda, 0xce, 0xe5, 0x6f, 0x14, 0xe, 0xa4, 0x59, 0xf0, 0x7c, 0x66, 0x35, 0xed, 0x34, 0x4, 0x9f, 0xe0, 0x35, 0xd, 0xeb, 0xad, 0x3f, 0xaf, 0x32, 0xa8, 0x8c, 0x3c, 0xf3, 0x83, 0xfb, 0x2e, 0xba, 0x65, 0x4d, 0x4b, 0xb2, 0x91, 0xbf, 0x27, 0xa6, 0xcb, 0xb0, 0x34, 0x1e, 0x5e, 0x38, 0x72, 0x59, 0x65, 0x19, 0xb4, 0x1d, 0x82, 0x24, 0xa4, 0xd, 0x6, 0xe4, 0x67, 0x6, 0xa, 0x96, 0xcc, 0x8c, 0xfb, 0x3b, 0x45, 0xf2, 0xb9, 0x79, 0x34, 0xd1, 0x60, 0x82, 0xad, 0xe0, 0x12, 0x40, 0x36, 0x8c, 0x6c, 0x28, 0xfc, 0xaa, 0x9c, 0x48, 0xa0, 0x25, 0xca, 0x21, 0x5a, 0xbe, 0x98, 0xbc, 0xf5, 0x7b, 0x47, 0x8d, 0xb8, 0xf5, 0x2, 0xad, 0xd4, 0x6c, 0x47, 0x54, 0xa9, 0xd2, 0xef, 0xe9, 0xbb, 0x43, 0xaf, 0x6f, 0x69, 0x5, 0x2d, 0x1, 0xd9, 0xf, 0x22, 0x4d, 0xf6, 0x83, 0xe0, 0xa2, 0xb6, 0x3e, 0x51, 0x77, 0x80, 0x98, 0xe6, 0x49, 0x85, 0xca, 0xa3, 0x5, 0x53, 0x3f, 0x1a, 0x3b, 0x3e, 0x6c, 0x3f, 0xa5, 0x7e, 0x2b, 0x3d, 0x2, 0xdc, 0xbd, 0x34, 0xb6, 0xfb, 0xde, 0x38, 0xf5, 0x8c, 0x5e, 0x87, 0x94, 0x17, 0xe8, 0x19, 0xb4, 0xef, 0x9e, 0x66, 0x7c, 0x45, 0xf1, 0x89, 0x9c, 0xcf, 0xa9, 0x90, 0xec, 0x81, 0x34, 0x14, 0x22, 0xd6, 0x47, 0x28, 0x1, 0x64, 0xc4, 0xf8, 0xc1, 0x47, 0x77, 0x3d, 0x79, 0x4e, 0x6e, 0x6e, 0xfb, 0x96, 0x82, 0x35, 0x2, 0x57, 0x27, 0xa4, 0x75, 0x4d, 0x51, 0x98, 0xcf, 0x7d, 0xeb, 0xa9, 0x96, 0x3d, 0x27, 0x9e, 0x1e, 0xa, 0x5e, 0xff, 0xd1, 0xfe, 0x9c, 0xb, 0x71, 0x99, 0x8b, 0xbc, 0x4, 0x9e, 0x72, 0x31, 0xa3, 0xfe, 0x78, 0x3c, 0xec, 0xbb, 0xbf, 0x61, 0x34, 0xe, 0xe, 0xc8, 0xc0, 0xed, 0x29, 0xff, 0xce, 0x9e, 0x94, 0x1a, 0x1d, 0x92, 0x29, 0x72, 0x9e, 0xa9, 0x7f, 0x21, 0x72, 0xd5, 0xd2, 0x75, 0x34, 0x9f, 0xcf, 0x9f, 0xe2, 0xfc, 0x5, 0x8a, 0x53, 0x60, 0x81, 0xfe, 0x4, 0x47, 0x7a, 0x29, 0xaf, 0x81, 0x7f, 0xb1, 0x49, 0xe8, 0x77, 0x8c, 0x43, 0x6b, 0xe3, 0xc1, 0x6, 0xa5, 0xd3, 0xd1, 0xf4, 0x7, 0x97, 0xd0, 0x78, 0x33, 0xd5, 0x12, 0x98, 0x5, 0x2e, 0xbe, 0x70, 0x33, 0x65, 0x97, 0x18, 0x63, 0x88, 0x6f, 0xc6, 0x36, 0x44, 0xaf, 0x7d, 0x48, 0xb3, 0x20, 0xfa, 0x15, 0xb6, 0xfc, 0x3a, 0xfe, 0x7d, 0x97, 0x31, 0x8d, 0x6c, 0x4, 0x30, 0x66, 0xe5, 0x80, 0x85, 0xf9, 0x41, 0x5d, 0x4e, 0x8a, 0xaf, 0x70, 0x7, 0x19, 0x30, 0xd, 0xaf, 0xe1, 0xd1, 0x6f, 0x8, 0x96, 0x2c, 0x61, 0x30, 0xb1, 0x52, 0x60, 0xd9, 0x95, 0xa0, 0x1e, 0x88, 0x9a, 0xe2, 0xc, 0x74, 0xf5, 0x4b, 0xaa, 0x2, 0x91, 0xd0, 0xc, 0x2c, 0x65, 0x3c, 0x2c, 0x9f, 0xfb, 0xb6, 0x64, 0x2d, 0x1, 0xe, 0x28, 0x97, 0x7c, 0x6e, 0x4e, 0xa8, 0xa5, 0x9d, 0x3f, 0x6, 0x83, 0xa2, 0x92, 0x4b, 0xb4, 0xb2, 0x49, 0xad, 0xf, 0x1e, 0xd1, 0x34, 0xd5, 0xc8, 0x37, 0xce, 0xaa, 0xe3, 0xe1, 0x6d, 0x5f, 0x1b, 0x13, 0xa9, 0x1c, 0x2, 0x2, 0x3a, 0xea, 0x1a, 0x74, 0xd2, 0xa0, 0xde, 0x98, 0x3b, 0x8d, 0xc9, 0xe9, 0x30, 0x68, 0x6e, 0x75, 0x76, 0xc8, 0x25, 0x5b, 0xe5, 0x6b, 0x6b, 0xf6, 0xc5, 0x9e, 0x4d, 0x50, 0xe2, 0x70, 0x4d, 0xb2, 0x27, 0x6b, 0xec, 0x34, 0xb9, 0x9c, 0x41, 0xb6, 0x4f, 0x39, 0xb2, 0xd6, 0x7c, 0x7c, 0xac, 0x69, 0x9d, 0x7, 0xfd, 0xad, 0x3, 0xad, 0x35, 0x40, 0x19, 0x7e, 0x82, 0x9a, 0x2f, 0xd7, 0x54, 0xf8, 0x3b, 0xb7, 0xf5, 0x47, 0xc3, 0xe1, 0x30, 0xb8, 0x0, 0xbd, 0x86, 0x46, 0x18, 0xbc, 0x3a, 0x6c, 0xa1, 0x63, 0x25, 0x8d, 0xc6, 0x18, 0x67, 0x95, 0x10, 0x17, 0x2d, 0xc7, 0xdb, 0x56, 0xe9, 0x1a, 0xa8, 0x66, 0x4, 0x47, 0x7e, 0x95, 0x36, 0xec, 0x5f, 0xd9, 0xec, 0x2a, 0xc7, 0xbb, 0x90, 0xef, 0x6d, 0xe4, 0x39, 0x84, 0x60, 0x65, 0xce, 0xd, 0x17, 0xc4, 0x28, 0x81, 0x59, 0x72, 0x36, 0x3c, 0x3b, 0xb3, 0x8d, 0x7, 0x42, 0x46, 0x7c, 0x2d, 0xb, 0xfb, 0x34, 0xdd, 0x5e, 0x29, 0x9d, 0x3d, 0x71, 0x4c, 0x46, 0x81, 0x6d, 0x14, 0x1d, 0xdd, 0x2a, 0xcd, 0x5d, 0x30, 0x88, 0x74, 0xe3, 0xea, 0x81, 0x6, 0xa9, 0x35, 0x90, 0xba, 0x6d, 0xbf, 0xb1, 0x2d, 0xd4, 0xf9, 0xa3, 0xd5, 0xd2, 0x47, 0x17, 0xcf, 0x78, 0xd0, 0x7a, 0xcb, 0x58, 0x91, 0x67, 0x79, 0xc1, 0x32, 0x38, 0xc8, 0x6e, 0x4c, 0xd4, 0xa2, 0xf7, 0x4d, 0x90, 0xff, 0xdb, 0x2a, 0x53, 0xb5, 0xbb, 0xa5, 0x33, 0x6f, 0x5, 0xf3, 0x15, 0x6e, 0xd4, 0xd, 0xb, 0x89, 0xcf, 0xd6, 0x2a, 0xd8, 0xe5, 0xc8, 0x3d, 0x69, 0x27, 0x95, 0xd, 0xae, 0x2d, 0xf2, 0xce, 0x33, 0x29, 0x75, 0x1c, 0x3, 0x52, 0x84, 0x8c, 0x91, 0xe4, 0x7f, 0xb2, 0x67, 0xed, 0x48, 0x44, 0x2e, 0xd9, 0x13, 0x7e, 0xda, 0x81, 0x77, 0xe, 0x4c, 0x56, 0xf2, 0x22, 0x17, 0x2, 0x7c, 0xed, 0x47, 0x80, 0xef, 0x13, 0x55, 0x6e, 0x71, 0x16, 0xd3, 0x5, 0xbc, 0x80, 0xec, 0x79, 0xd5, 0xd, 0x6a, 0x17, 0x50, 0x97, 0x32, 0xed, 0xdb, 0x47, 0xad, 0x44, 0x5f, 0x42, 0xf6, 0x21, 0xa4, 0x69, 0x48, 0x79, 0xa5, 0x9a, 0x37, 0x84, 0x3a, 0xd5, 0x2f, 0x1e, 0x6c, 0xb5, 0x34, 0x7d, 0x52, 0xaf, 0xb1, 0x4c, 0xd0, 0x2f, 0x86, 0xf4, 0xa0, 0x2b, 0x6f, 0x27, 0xea, 0x26, 0xec, 0x5b, 0xdf, 0xcd, 0xe8, 0x0, 0x1c, 0xe8, 0xf7, 0x12, 0xc1, 0x93, 0xef, 0xbd, 0x7e, 0xef, 0x68, 0x77, 0xf5, 0x27, 0xb4, 0xd7, 0xdf, 0xb9, 0x94, 0xd9, 0x36, 0xc6, 0xa2, 0xa2, 0x84, 0xda, 0xcc, 0xd4, 0x47, 0xf3, 0x36, 0x6f, 0x31, 0x81, 0x8e, 0xc7, 0xfb, 0x5c, 0xe6, 0xf0, 0x8e, 0x45, 0x8d, 0xc5, 0xc6, 0x2, 0xe8, 0x7b, 0x89, 0x60, 0x50, 0x96, 0xe6, 0x25, 0xa0, 0xeb, 0x7c, 0xd2, 0x52, 0x14, 0xd8, 0x56, 0x74, 0x89, 0x77, 0x38, 0xbf, 0x67, 0x58, 0xad, 0x5b, 0x80, 0x5b, 0x2d, 0xb9, 0xc, 0xb0, 0xf, 0x3e, 0xda, 0x7f, 0xa2, 0xd7, 0xea, 0x1e, 0x6e, 0x9a, 0xbf, 0x93, 0xc6, 0x54, 0xf2, 0x7b, 0x48, 0x74, 0xb8, 0x90, 0x10, 0x91, 0x84, 0x2e, 0xe7, 0xc3, 0xeb, 0x1d, 0x54, 0xfc, 0x8a, 0xe8, 0x30, 0x91, 0xde, 0x31, 0x32, 0x5, 0x8d, 0x7a, 0x7c, 0xb0, 0x8a, 0x9e, 0x74, 0xda, 0xe3, 0xf8, 0xfe, 0x27, 0x9e, 0x83, 0x73, 0xbd, 0x79, 0xee, 0x60, 0x6d, 0x27, 0x46, 0xce, 0x2b, 0x7b, 0x47, 0x75, 0xd3, 0xa7, 0x1e, 0xaf, 0x86, 0x50, 0xf, 0xce, 0xc8, 0x5d, 0x8e, 0x6e, 0x86, 0xb7, 0x7a, 0x1d, 0xdf, 0xdc, 0x5a, 0x7, 0x69, 0x64, 0x77, 0xe3, 0x7c, 0x91, 0xbf, 0xfe, 0x36, 0xdd, 0x7f, 0xfb, 0x5c, 0xbb, 0xdf, 0x55, 0xca, 0xa8, 0xd9, 0xfa, 0xe0, 0xe2, 0xc6, 0xee, 0xdb, 0xea, 0xbc, 0x5a, 0x5d, 0x5e, 0x78, 0xfb, 0xc2, 0xff, 0xbc, 0xcc, 0xa0, 0x26, 0x70, 0x7c, 0x77, 0x1b, 0x91, 0xc5, 0x9f, 0x4e, 0x7d, 0x81, 0xef, 0xea, 0xff, 0x70, 0xd9, 0x7f, 0x6c, 0x4d, 0xf4, 0x3f, 0xdf, 0xa6, 0x7f, 0x1, 0xe3, 0x5, 0x57, 0x93, 0xde, 0x13, 0x0, 0x0, 0x0, 0x1f, 0x8b, 0x8, 0x0, 0x0, 0x0, 0x0, 0x0, 0x2, 0x3, 0x8c, 0xba, 0x65, 0x50, 0x1c, 0x40, 0xd7, 0x35, 0x38, 0xb8, 0xc3, 0xe0, 0xee, 0xee, 0x83, 0x7b, 0x82, 0x3b, 0x4, 0xf7, 0x21, 0xb8, 0xdb, 0xa0, 0x41, 0x82, 0xbb, 0xbb, 0x13, 0x9c, 0xe0, 0x3a, 0x38, 0x24, 0xb8, 0x3b, 0x83, 0xbb, 0xbb, 0x5b, 0x20, 0xb6, 0x79, 0x9e, 0xef, 0x7d, 0xb7, 0x76, 0xab, 0xf6, 0xc7, 0x9e, 0xae, 0xba, 0x2d, 0x55, 0x7d, 0xbb, 0xcf, 0xfd, 0x71, 0x6e, 0xf5, 0xad, 0xfe, 0xbb, 0xfa, 0x77, 0x17, 0x0, 0x54, 0x96, 0x57, 0x92, 0x7, 0xc0, 0xc1, 0x1, 0x0, 0x70, 0xff, 0x1a, 0xe0, 0xef, 0x6, 0x20, 0x1c, 0x80, 0x87, 0x8d, 0x8d, 0xd, 0xc4, 0x26, 0x4, 0x2, 0x9, 0xa9, 0xf0, 0x71, 0xf1, 0xa9, 0xe8, 0xc9, 0x8, 0x9, 0xc9, 0xe8, 0xe9, 0x88, 0xff, 0x3, 0x3a, 0x5c, 0xcc, 0xff, 0xe2, 0x7f, 0xba, 0xff, 0x6f, 0xc0, 0x11, 0xe0, 0xe3, 0x13, 0x91, 0x12, 0x91, 0x13, 0x13, 0x93, 0x13, 0xfc, 0x73, 0x45, 0xf0, 0x1f, 0x83, 0x4d, 0xf0, 0x7f, 0xb6, 0xe0, 0xfe, 0xff, 0x71, 0xf0, 0x77, 0x0, 0x80, 0x8b, 0xa, 0x78, 0x85, 0x4b, 0x46, 0x80, 0xa3, 0x3, 0xc0, 0xe3, 0xc2, 0x21, 0xe0, 0xc2, 0xfd, 0x1d, 0x2, 0x90, 0x3, 0x0, 0xf0, 0x8, 0x70, 0xff, 0xb9, 0xea, 0xff, 0x2, 0x1, 0x11, 0xe, 0x1e, 0x9, 0x80, 0x8c, 0xf2, 0x77, 0x1d, 0x80, 0xfa, 0x7f, 0xd6, 0x1f, 0xe, 0xeb, 0x58, 0xe7, 0x5, 0x0, 0x47, 0x9, 0xe3, 0x7, 0xbe, 0xbd, 0x3a, 0xb1, 0xd3, 0x8b, 0xb4, 0xb1, 0x84, 0xd5, 0x3, 0x8d, 0xca, 0x93, 0x4, 0xb1, 0x68, 0xb1, 0x4, 0x14, 0xe, 0x27, 0xd, 0x5f, 0x21, 0xf1, 0x1e, 0xf3, 0xe6, 0xd1, 0x5f, 0xda, 0x5, 0xb2, 0xd2, 0xe9, 0x1c, 0x51, 0xf5, 0x69, 0x31, 0xfd, 0x18, 0x88, 0x88, 0x9a, 0x68, 0x9c, 0xf4, 0xa0, 0xf8, 0x96, 0xbc, 0x8b, 0x5e, 0x88, 0x2d, 0x4f, 0x5f, 0xa8, 0xbd, 0x9c, 0x35, 0x5c, 0xde, 0x30, 0x51, 0x48, 0x34, 0xc0, 0x16, 0xf4, 0x3a, 0x9e, 0x60, 0x8b, 0xce, 0x33, 0x12, 0x6, 0x7e, 0xd4, 0x2d, 0xcd, 0xaf, 0x65, 0xec, 0x8b, 0xd5, 0x1d, 0xc4, 0x8f, 0x13, 0x35, 0xb0, 0xc4, 0x3a, 0xdf, 0x1d, 0xe5, 0x19, 0xe4, 0xb2, 0x5a, 0x56, 0x4b, 0x4a, 0x62, 0x9d, 0x82, 0x2c, 0x66, 0x56, 0x52, 0x72, 0x4c, 0x6c, 0xb1, 0x4e, 0xaf, 0x47, 0x44, 0x65, 0x3b, 0x5b, 0x44, 0xfb, 0x9f, 0x10, 0x9b, 0x62, 0x2d, 0x74, 0x36, 0xf0, 0xda, 0x43, 0xde, 0x5, 0xf8, 0x9a, 0x26, 0x34, 0x4e, 0x70, 0x64, 0xe7, 0x2b, 0x47, 0x3a, 0x56, 0x58, 0xdf, 0xd, 0xb1, 0xa1, 0x4f, 0xd, 0x2f, 0xed, 0x16, 0x8f, 0x9f, 0x43, 0x84, 0x94, 0x69, 0xc9, 0xfb, 0xaf, 0xad, 0xaf, 0x4e, 0x9c, 0xe6, 0xd5, 0xb, 0x58, 0xa5, 0xc6, 0xab, 0xaf, 0xb3, 0xe5, 0xea, 0xb8, 0x46, 0xa2, 0x96, 0x7e, 0x4, 0xe4, 0x19, 0xf3, 0xc8, 0x86, 0x1f, 0x72, 0x6d, 0x5f, 0xcb, 0x5b, 0x90, 0x5c, 0x65, 0x3d, 0xd7, 0xb8, 0x2, 0x2b, 0x2c, 0xa4, 0xfd, 0x46, 0x47, 0xe6, 0xe5, 0x42, 0xce, 0xdc, 0x6e, 0x6f, 0xdc, 0xbc, 0x43, 0xa4, 0xb1, 0x98, 0xf8, 0x2a, 0xd7, 0x67, 0xb9, 0x22, 0x26, 0x5a, 0x2, 0xbc, 0xbb, 0x51, 0xfd, 0xe2, 0x31, 0xdf, 0x64, 0x1f, 0x5c, 0xd, 0xd8, 0x5a, 0x5b, 0x4f, 0xf4, 0x96, 0x74, 0x18, 0xde, 0x61, 0x67, 0x1a, 0x5e, 0x8b, 0x9, 0x41, 0x74, 0x7f, 0xd6, 0x76, 0x4f, 0x52, 0xd8, 0x2b, 0x81, 0xb5, 0xf2, 0x6d, 0xe7, 0xf8, 0x14, 0xb, 0x15, 0xf8, 0x92, 0xb8, 0x2a, 0xb1, 0xcc, 0xb0, 0x28, 0x4d, 0x78, 0x6d, 0xc8, 0x4d, 0x3b, 0xac, 0xf2, 0xf8, 0xf0, 0x97, 0xed, 0x4d, 0xc9, 0xab, 0x1e, 0x48, 0x23, 0xa, 0x54, 0xb5, 0xf5, 0xf8, 0xb9, 0xda, 0x5, 0x99, 0xae, 0x18, 0x3e, 0xa, 0xbf, 0xb, 0x5d, 0xbb, 0x6c, 0x60, 0xad, 0x35, 0xc7, 0x8d, 0x40, 0xb4, 0xcc, 0x70, 0x41, 0x11, 0x72, 0xac, 0x5e, 0x8f, 0xb5, 0xc7, 0xe2, 0x62, 0x9b, 0x89, 0x56, 0x13, 0xd2, 0x62, 0xc5, 0xb2, 0xaf, 0x9e, 0x78, 0x15, 0x3d, 0xb3, 0xb9, 0xa9, 0x6f, 0xdd, 0x78, 0xe8, 0x66, 0xe7, 0x6d, 0x56, 0x15, 0xd5, 0x88, 0xdc, 0x83, 0x53, 0x37, 0x27, 0x60, 0x69, 0x67, 0x31, 0xfd, 0x2a, 0xc0, 0x26, 0x9d, 0xca, 0xff, 0x20, 0x24, 0xc6, 0xeb, 0xa5, 0xdd, 0xda, 0xbc, 0x36, 0x4b, 0x5e, 0x45, 0x2d, 0x31, 0x66, 0x18, 0xc6, 0xf, 0xda, 0x69, 0x89, 0x3c, 0xc, 0x1e, 0xa9, 0x4e, 0xe7, 0x6d, 0xe1, 0x54, 0xbb, 0xf2, 0xcb, 0xa6, 0x6b, 0xf5, 0x1a, 0x20, 0xce, 0x45, 0xd6, 0x32, 0xcd, 0x8f, 0xa9, 0x7e, 0xc9, 0x73, 0x8a, 0x56, 0x36, 0xae, 0x75, 0x43, 0xd2, 0x4d, 0xd4, 0xf8, 0x58, 0xc3, 0xfa, 0x80, 0x11, 0x3f, 0xb, 0xb8, 0x7, 0x3d, 0xc4, 0xf5, 0x82, 0x65, 0xe5, 0xea, 0xbe, 0x24, 0x3c, 0xfe, 0x3a, 0xa9, 0x9f, 0x9e, 0xb5, 0xc2, 0x8b, 0x33, 0x4, 0x7f, 0x2d, 0xe3, 0xa7, 0xf9, 0x35, 0x96, 0x80, 0x5e, 0x6f, 0xce, 0xb1, 0x1e, 0x5e, 0x1a, 0x6a, 0x19, 0xda, 0x6a, 0xb2, 0x80, 0x99, 0x9a, 0x40, 0xc0, 0xf5, 0xea, 0x3c, 0xdf, 0x98, 0xcc, 0x69, 0xd0, 0xce, 0x9e, 0xfb, 0x41, 0x16, 0x7d, 0x1c, 0x6b, 0xcb, 0x1c, 0xbe, 0x78, 0xf6, 0x4, 0xc9, 0xba, 0xe3, 0x24, 0xf9, 0x58, 0xe0, 0x7b, 0x4e, 0x6d, 0x1d, 0xa3, 0x44, 0xf3, 0x2c, 0x93, 0x4, 0x47, 0x3f, 0x5e, 0x6b, 0x63, 0xb3, 0x79, 0x56, 0xe1, 0x59, 0xbb, 0x9c, 0xdf, 0xa4, 0x32, 0x5d, 0x95, 0x71, 0x9, 0x6, 0xbf, 0xa6, 0x2d, 0xdb, 0xf5, 0xb3, 0x65, 0xc2, 0xd3, 0x57, 0x39, 0x5, 0x87, 0x62, 0xf8, 0xc6, 0xe3, 0x8, 0xb2, 0x2c, 0xa5, 0xcd, 0x59, 0x85, 0x62, 0xe5, 0x61, 0xcb, 0xc8, 0x1e, 0x4d, 0xda, 0x16, 0x3f, 0x5b, 0xd1, 0xef, 0xe8, 0x24, 0xf6, 0x53, 0x60, 0x1f, 0xd9, 0xb7, 0xf5, 0x89, 0x39, 0x1f, 0x73, 0x93, 0x76, 0xe2, 0xae, 0x30, 0xef, 0x1c, 0x9, 0xf, 0x1, 0x28, 0x8f, 0x7e, 0x9d, 0xdc, 0xc4, 0x37, 0x27, 0x6c, 0xf6, 0x12, 0xe4, 0x1c, 0x91, 0x6, 0x86, 0x1, 0x4b, 0xee, 0x5, 0x15, 0x5f, 0xd1, 0x36, 0x30, 0x32, 0xca, 0x91, 0xca, 0x76, 0x1d, 0x80, 0xa8, 0x11, 0x6a, 0x76, 0x43, 0x6c, 0xed, 0xfb, 0x5d, 0xb2, 0x2e, 0x1b, 0xf0, 0x20, 0x54, 0xe7, 0x73, 0xdc, 0x4b, 0x7f, 0xb1, 0x4b, 0x2d, 0x63, 0xd7, 0xe9, 0x2c, 0xad, 0x63, 0xac, 0xfb, 0x17, 0x40, 0x7a, 0xda, 0x44, 0x9b, 0xbb, 0x15, 0x70, 0xc, 0xf3, 0xd2, 0xf3, 0x7e, 0x13, 0xb1, 0xe6, 0xf3, 0x70, 0x2d, 0x52, 0xc8, 0x6a, 0x15, 0x22, 0xe1, 0x87, 0xe5, 0x73, 0xb, 0xb0, 0x39, 0x5c, 0x8a, 0x76, 0xcc, 0x24, 0xd2, 0xf8, 0x34, 0x7a, 0xf1, 0xb5, 0x12, 0xd2, 0x81, 0xb8, 0xf8, 0x7d, 0x5f, 0x5a, 0xdb, 0xde, 0xb6, 0x5d, 0x51, 0x2a, 0x38, 0x54, 0x9c, 0x8c, 0xfe, 0x24, 0x2f, 0x17, 0x71, 0x81, 0xbe, 0x9e, 0x9c, 0x68, 0x7f, 0x60, 0x5e, 0xec, 0x6f, 0xf9, 0x80, 0x19, 0xed, 0x7b, 0x1a, 0x5e, 0x77, 0x3c, 0x8a, 0xb6, 0x2e, 0x96, 0x8c, 0xf3, 0x69, 0x74, 0x12, 0x69, 0x11, 0xb4, 0xd0, 0x45, 0xd6, 0x37, 0x1f, 0x6b, 0x5c, 0x9e, 0xe9, 0xca, 0x62, 0xe6, 0xf4, 0xb5, 0xf4, 0x54, 0x4, 0x89, 0x5b, 0xc3, 0x66, 0x85, 0xf, 0x66, 0x3e, 0x18, 0x2b, 0xeb, 0xb4, 0xeb, 0xba, 0xcb, 0xd9, 0x76, 0x93, 0x78, 0x4d, 0x73, 0x65, 0x4a, 0xcf, 0xed, 0xd7, 0x4e, 0xd6, 0x93, 0xfe, 0x12, 0xbf, 0x93, 0x9e, 0xb5, 0xf4, 0x9a, 0x50, 0xde, 0x26, 0x37, 0xf4, 0xcd, 0xb1, 0x15, 0x9d, 0x23, 0x8e, 0x35, 0x97, 0xd2, 0x53, 0x2, 0x59, 0x7d, 0x9a, 0x8, 0x68, 0x6, 0x93, 0xf4, 0x40, 0xd9, 0x79, 0xa3, 0x96, 0x94, 0xcc, 0x7d, 0x64, 0xf0, 0x55, 0x49, 0x13, 0xf2, 0x99, 0x16, 0xf1, 0x5a, 0x6b, 0xa8, 0x52, 0x99, 0x7d, 0xb, 0xe8, 0x39, 0xe1, 0x85, 0xfa, 0xee, 0xf0, 0x2e, 0x52, 0x25, 0xa1, 0x51, 0xab, 0x7, 0xdb, 0x3c, 0x7f, 0x0, 0x51, 0x96, 0x7d, 0xd4, 0x88, 0xb6, 0x40, 0xbd, 0x40, 0x81, 0x4, 0x9, 0xe4, 0xb4, 0x1c, 0xc7, 0x35, 0x68, 0x9d, 0xe8, 0x1b, 0xbb, 0x62, 0x5, 0x7c, 0xd0, 0xce, 0x2c, 0x59, 0x7f, 0xd7, 0x4d, 0xfc, 0x9e, 0xd8, 0x98, 0x7a, 0xc9, 0xfa, 0x4d, 0xb5, 0xc9, 0xc1, 0x76, 0x37, 0xec, 0xab, 0x6c, 0x97, 0x53, 0x9b, 0xc5, 0xfc, 0x35, 0xc1, 0x68, 0x61, 0x6c, 0x11, 0x56, 0xbe, 0x14, 0xed, 0xf6, 0xcb, 0xec, 0xa9, 0x4d, 0xa, 0x25, 0xc5, 0xb1, 0xd1, 0x93, 0xf4, 0xc8, 0x43, 0xed, 0xb1, 0xf3, 0xd7, 0xee, 0x42, 0x67, 0x8a, 0xcd, 0xf5, 0x92, 0xc9, 0x69, 0x3b, 0xbc, 0xa6, 0xe5, 0xb3, 0x2a, 0xb4, 0xfc, 0xd6, 0x2, 0x29, 0x62, 0xcd, 0x69, 0xe6, 0xde, 0x7e, 0x7b, 0xcb, 0x18, 0xaa, 0x9a, 0x9f, 0x68, 0x73, 0x18, 0x56, 0xa0, 0xed, 0x36, 0x15, 0x83, 0x84, 0x4, 0x3a, 0x89, 0x1a, 0x8e, 0xe9, 0x9a, 0x2d, 0x82, 0xec, 0xce, 0x9c, 0xa1, 0x9, 0x5f, 0x9b, 0x9f, 0xb3, 0xd4, 0x6b, 0x7, 0xa7, 0x36, 0x28, 0x86, 0x2, 0x40, 0x7a, 0xef, 0x62, 0xb6, 0x9e, 0xcd, 0x38, 0x2e, 0x51, 0x70, 0xc5, 0x13, 0x83, 0xd3, 0x76, 0x6b, 0x62, 0x39, 0xbb, 0xb1, 0x6a, 0x7d, 0x65, 0xe, 0xfc, 0xa3, 0xf1, 0xd6, 0x6b, 0x6a, 0x66, 0x2a, 0x66, 0x6a, 0x9b, 0xd6, 0xb6, 0xdf, 0x96, 0x7d, 0x6c, 0xac, 0xb3, 0x42, 0x34, 0x89, 0x1d, 0x4, 0x77, 0x71, 0xe0, 0xb4, 0xe2, 0x8b, 0xf8, 0xf4, 0x12, 0x5e, 0xbc, 0xb, 0x57, 0x3c, 0xde, 0x4b, 0xc6, 0xb8, 0x6f, 0x9e, 0x1e, 0xe7, 0x52, 0xab, 0xdd, 0xf6, 0xbb, 0xa6, 0x10, 0xb7, 0xbc, 0x3a, 0x95, 0xa4, 0x30, 0x63, 0x2, 0x6e, 0x98, 0x8a, 0x7b, 0x73, 0xd8, 0xba, 0x19, 0x59, 0x2e, 0x5a, 0x41, 0xcf, 0xcf, 0xd4, 0x54, 0x45, 0x6, 0xfd, 0xba, 0x7e, 0x67, 0xb0, 0xf0, 0xc, 0xef, 0xf7, 0x7f, 0xc2, 0x45, 0x2, 0x7, 0x40, 0xf8, 0x7f, 0xca, 0xd6, 0x3f, 0xad, 0x85, 0x47, 0x0, 0x20, 0xfe, 0x57, 0xb5, 0xe0, 0x81, 0xff, 0xa6, 0x87, 0x9c, 0x39, 0x27, 0x7c, 0xaa, 0x39, 0xe, 0x84, 0x8a, 0x16, 0x48, 0x87, 0x68, 0x74, 0x10, 0xf, 0xa7, 0xe6, 0x36, 0x5d, 0x91, 0xdb, 0xa5, 0x34, 0x61, 0xa5, 0xfa, 0xa9, 0x3d, 0x2f, 0x5e, 0x84, 0x18, 0x56, 0xd9, 0xd2, 0x51, 0x25, 0x1c, 0xe9, 0x8e, 0x4, 0x3, 0x1a, 0xcd, 0xea, 0x31, 0xa2, 0x2b, 0xe, 0xcb, 0x82, 0x87, 0x53, 0x1d, 0x60, 0xda, 0x32, 0xd, 0x8a, 0x2f, 0x74, 0x6f, 0xde, 0xbe, 0xa9, 0xdf, 0xe6, 0x90, 0x6d, 0x2e, 0x21, 0xbf, 0x32, 0xbb, 0xd5, 0xf7, 0xc8, 0x2f, 0x22, 0x82, 0x77, 0xdf, 0x1b, 0x73, 0xc4, 0xc, 0x3, 0x5b, 0xeb, 0x5, 0x76, 0x8c, 0x8e, 0xc4, 0x1a, 0x86, 0xc2, 0x16, 0xa1, 0x14, 0x52, 0xce, 0xc7, 0x2d, 0x8a, 0xaf, 0x5, 0x49, 0x8d, 0xec, 0x6, 0x90, 0xc2, 0x42, 0xf5, 0x73, 0xb0, 0x36, 0x55, 0x87, 0xf6, 0xe6, 0x6, 0xe9, 0x41, 0xd6, 0xee, 0xf, 0x87, 0xed, 0x4a, 0xe3, 0x68, 0x20, 0x73, 0x6b, 0xdf, 0x8a, 0xe, 0x2, 0x2, 0xbe, 0x51, 0x9e, 0x50, 0xb4, 0xfa, 0x53, 0xdb, 0x2f, 0x4, 0xd2, 0xb7, 0xdd, 0xce, 0xd1, 0xa0, 0x50, 0xfc, 0x2a, 0xb5, 0x5a, 0xe6, 0xd8, 0x69, 0x3f, 0x16, 0x6c, 0xf0, 0x4c, 0xf6, 0xbe, 0x69, 0x48, 0xba, 0xe0, 0x2, 0x69, 0xf6, 0xd1, 0x17, 0xc4, 0xaa, 0x25, 0x37, 0x1d, 0x90, 0x9c, 0x5, 0x68, 0xd5, 0xf5, 0xbf, 0x34, 0xff, 0x8b, 0xff, 0x17, 0xcd, 0x7f, 0x12, 0xfd, 0x5f, 0x9a, 0x8, 0xff, 0xa1, 0xf9, 0x88, 0xcc, 0xb4, 0x85, 0x45, 0x38, 0x6d, 0x92, 0x96, 0xdd, 0xdb, 0xc6, 0x5e, 0x76, 0xed, 0xd7, 0x5, 0x59, 0xca, 0xc4, 0x1c, 0x35, 0x28, 0xd0, 0x55, 0x4f, 0xd3, 0x44, 0x51, 0x6b, 0x62, 0x74, 0x10, 0xf1, 0x5c, 0xf2, 0xcf, 0x24, 0x8f, 0xb1, 0xf7, 0x98, 0x71, 0x81, 0x4e, 0xe7, 0x3e, 0xce, 0x60, 0x27, 0x5f, 0x6e, 0x8c, 0x39, 0xe2, 0x5b, 0x7f, 0x7c, 0xa7, 0x47, 0xea, 0xa2, 0xa0, 0x83, 0x11, 0x9a, 0xbb, 0xf9, 0xfa, 0x54, 0xef, 0xf1, 0xc1, 0xd4, 0xaf, 0x89, 0xa9, 0x8e, 0x71, 0x79, 0x73, 0xbb, 0x59, 0xd2, 0xdb, 0x68, 0x7e, 0x4a, 0x39, 0xb4, 0x56, 0xcd, 0x5d, 0x51, 0x62, 0xab, 0x73, 0x2c, 0xcb, 0x20, 0xc6, 0x9b, 0x74, 0x3, 0xc7, 0x6f, 0xb3, 0xd8, 0x47, 0xdb, 0xc5, 0x6c, 0xce, 0x5e, 0x9a, 0xbb, 0x7, 0xb2, 0x76, 0x36, 0xd7, 0x67, 0xb1, 0x85, 0x9c, 0xc9, 0x34, 0x5f, 0xb0, 0x90, 0xeb, 0x23, 0xc2, 0x3a, 0x2f, 0xb5, 0x98, 0xef, 0xdc, 0xec, 0x75, 0x7e, 0x6a, 0xa1, 0x45, 0x36, 0xe8, 0xca, 0xca, 0x67, 0x5c, 0x6e, 0x3e, 0xca, 0x87, 0x8e, 0xd5, 0x25, 0x65, 0xbf, 0x5a, 0x74, 0xc2, 0xd5, 0x2b, 0x9a, 0xe6, 0x5c, 0xe3, 0xfc, 0x8f, 0xd, 0x27, 0x10, 0x0, 0xf, 0xf, 0xf, 0x87, 0xf0, 0x2f, 0xc7, 0x20, 0x22, 0xc0, 0xfd, 0xdf, 0x6c, 0x70, 0xf1, 0xf0, 0x69, 0x79, 0x80, 0x4, 0x74, 0x48, 0xf4, 0xbc, 0x52, 0x9a, 0x84, 0x34, 0xc, 0x7c, 0xfc, 0xd2, 0x32, 0xe6, 0xff, 0x93, 0x7f, 0xe0, 0xfe, 0x19, 0x2f, 0xe1, 0xda, 0x85, 0x1, 0x22, 0x3b, 0x35, 0x8e, 0xb9, 0x5c, 0xc3, 0xf5, 0x77, 0x45, 0x8f, 0x25, 0x89, 0x55, 0xc, 0xad, 0xac, 0xb7, 0x27, 0x4f, 0xfc, 0x72, 0xca, 0x3f, 0x2c, 0x7b, 0xf9, 0x77, 0xf3, 0x38, 0x6, 0xa1, 0x46, 0xf1, 0xcb, 0x1b, 0x8e, 0x60, 0x1f, 0xc6, 0x99, 0xc3, 0xd8, 0x60, 0x83, 0x58, 0xf6, 0xfa, 0xf1, 0x2e, 0x4d, 0x4, 0xf4, 0xdc, 0x3c, 0x7a, 0xbd, 0xe4, 0xea, 0x6b, 0x24, 0x3, 0x42, 0x66, 0xc4, 0xf8, 0x38, 0xf4, 0x5a, 0xf4, 0x96, 0xd8, 0x51, 0xc, 0x42, 0x3d, 0x88, 0xe1, 0x90, 0x1a, 0xd7, 0x2e, 0x5a, 0xa5, 0xae, 0x2d, 0x61, 0x84, 0x1e, 0xa0, 0x3b, 0x42, 0x8f, 0x8d, 0x35, 0x82, 0x40, 0x9d, 0x5d, 0xb8, 0xd6, 0x1a, 0x8c, 0x66, 0xae, 0x66, 0x7, 0x9, 0xbb, 0xf, 0x7e, 0xce, 0xaf, 0xd8, 0xcb, 0xfb, 0x87, 0x47, 0x90, 0x77, 0x6c, 0x4f, 0x62, 0xb9, 0xb8, 0x80, 0x29, 0xff, 0x5b, 0xdc, 0xd, 0xeb, 0x70, 0xd5, 0x62, 0xcb, 0xd9, 0xc5, 0x75, 0x6d, 0xd, 0xe1, 0xdd, 0xf2, 0x72, 0xc3, 0xbb, 0xd0, 0x2d, 0xf4, 0x3f, 0x2, 0x26, 0x31, 0xba, 0x9d, 0x17, 0x4b, 0x67, 0xf9, 0x35, 0xf3, 0xa8, 0x55, 0x9a, 0x84, 0x26, 0x9c, 0x99, 0x5a, 0xb0, 0xb6, 0x92, 0xed, 0xc1, 0x16, 0x77, 0x3d, 0x89, 0x70, 0xa0, 0x3c, 0x6e, 0x11, 0xdf, 0xe7, 0x52, 0xdf, 0xb8, 0xd3, 0xcf, 0x88, 0xa0, 0xe9, 0x3e, 0xff, 0xc1, 0x7d, 0x84, 0xca, 0x6d, 0x9, 0x83, 0x73, 0x9e, 0x4d, 0x26, 0xd7, 0x9e, 0xcd, 0x9d, 0xfa, 0xef, 0xd0, 0xc1, 0x63, 0x6d, 0x83, 0x7a, 0xa8, 0x3b, 0x6c, 0xe3, 0x46, 0xf4, 0xf9, 0x3d, 0xac, 0x2b, 0x4c, 0xed, 0x9, 0x79, 0xa1, 0x4c, 0x80, 0xfc, 0x5b, 0x81, 0x11, 0xa3, 0x30, 0x7c, 0x1a, 0xcc, 0xaf, 0x85, 0xa3, 0x85, 0xa6, 0x32, 0xc0, 0xa8, 0xce, 0x9d, 0xf1, 0x71, 0x2e, 0xba, 0xd7, 0x93, 0xe4, 0x95, 0x0, 0x5b, 0x50, 0xff, 0xe1, 0x9c, 0x9e, 0x99, 0xcd, 0x57, 0xf9, 0x15, 0x39, 0xa3, 0x23, 0x88, 0x2c, 0x58, 0x5a, 0x4c, 0xa1, 0xb0, 0xb3, 0xc3, 0x2c, 0x37, 0x6a, 0x8e, 0xe4, 0x33, 0x99, 0x6b, 0xcf, 0xef, 0xf, 0xdb, 0xbd, 0x9e, 0x1, 0xb3, 0xa0, 0x37, 0x6a, 0xbe, 0xe2, 0x75, 0x1, 0xbe, 0x10, 0xaa, 0xbc, 0xa7, 0x77, 0x1d, 0xd0, 0xa8, 0x96, 0x23, 0x6f, 0xd1, 0xd, 0x5, 0xb6, 0x44, 0x30, 0xdb, 0x1, 0x69, 0x21, 0x2e, 0xdb, 0x8c, 0x9a, 0xd5, 0xed, 0x54, 0x19, 0xa7, 0x21, 0x51, 0x3d, 0x17, 0xb, 0x7a, 0xe4, 0xe4, 0xdd, 0x78, 0xfb, 0xda, 0x63, 0x35, 0x1b, 0xbb, 0xe9, 0x47, 0xdf, 0xbf, 0x80, 0xf5, 0xc8, 0x6e, 0x3f, 0x9, 0xc, 0xd4, 0x2, 0xa1, 0xba, 0x27, 0xdc, 0xe0, 0xca, 0x50, 0xea, 0x32, 0x99, 0xe1, 0x79, 0xf, 0xb, 0xad, 0x2d, 0xf5, 0xc9, 0x89, 0xba, 0x73, 0xde, 0x2a, 0xad, 0xb1, 0xdb, 0xd7, 0xc7, 0xdf, 0xc3, 0xf, 0x2, 0x64, 0x70, 0x2, 0xa7, 0xb2, 0xf6, 0xf5, 0x77, 0x1f, 0xec, 0x7f, 0x46, 0x2d, 0x66, 0x91, 0x59, 0x64, 0x1f, 0x1c, 0xe1, 0xd8, 0xcd, 0xa3, 0xd2, 0xc8, 0x4b, 0x51, 0x9a, 0x3, 0x19, 0xd8, 0x98, 0x49, 0xf4, 0x1c, 0x0, 0x8c, 0x24, 0x43, 0xc1, 0x71, 0x2a, 0x6, 0x6d, 0x19, 0x39, 0x3a, 0xad, 0x7a, 0xb7, 0x22, 0x6d, 0x9e, 0x8d, 0xe7, 0xb5, 0x7, 0xc6, 0x57, 0x77, 0xbe, 0x82, 0xa, 0xdb, 0x9d, 0xbe, 0x96, 0xcb, 0xe7, 0x15, 0x17, 0x6c, 0x72, 0xb6, 0x96, 0xd6, 0xd3, 0xce, 0x32, 0x7b, 0x50, 0x6, 0x92, 0xed, 0xa5, 0xb9, 0x5c, 0x98, 0xa1, 0x31, 0xc4, 0x82, 0xd5, 0xfa, 0x7, 0x38, 0xd4, 0xb4, 0xe8, 0x42, 0x9a, 0xa7, 0x3d, 0xb6, 0x84, 0xa9, 0x83, 0x95, 0xb3, 0x8e, 0x53, 0xb0, 0x5d, 0x43, 0x25, 0xa, 0x83, 0xf4, 0x33, 0x26, 0xd0, 0x71, 0x3e, 0xca, 0x8e, 0x5c, 0xdb, 0x2d, 0x5a, 0x5c, 0xfe, 0x51, 0x73, 0x1d, 0xf1, 0xd0, 0x8b, 0x43, 0xeb, 0x8b, 0x63, 0x59, 0x61, 0x7a, 0x63, 0xc1, 0x39, 0x7, 0xdb, 0x87, 0x50, 0xff, 0xe7, 0x26, 0xd2, 0x80, 0xe2, 0x1f, 0xd1, 0xa6, 0x54, 0x77, 0x99, 0x2e, 0x2e, 0x2e, 0xf8, 0x6c, 0x75, 0x24, 0xd7, 0x30, 0x23, 0xa2, 0x92, 0x45, 0xb2, 0xdc, 0xcc, 0x45, 0xab, 0xb2, 0xd5, 0x9a, 0xee, 0x9c, 0x1a, 0xcb, 0x6d, 0x58, 0x5d, 0xed, 0xb9, 0xc1, 0xce, 0xa1, 0x2d, 0xa3, 0xfb, 0xb6, 0x2e, 0x95, 0x63, 0xe2, 0xb4, 0xab, 0xa6, 0xb3, 0x35, 0xe1, 0x45, 0x92, 0x42, 0xa5, 0x17, 0x38, 0xf3, 0x32, 0xc, 0xec, 0xf5, 0x24, 0x79, 0x4e, 0xff, 0xeb, 0x79, 0x45, 0xc2, 0x66, 0xe, 0x78, 0xb4, 0x89, 0x5a, 0x5f, 0x2e, 0xae, 0xa0, 0x66, 0x74, 0x4d, 0x1f, 0x6b, 0xe8, 0x48, 0x2d, 0xbc, 0x19, 0x93, 0xb9, 0x36, 0x31, 0x20, 0xf9, 0x2f, 0xde, 0x69, 0x9a, 0x2b, 0x3d, 0x6, 0x28, 0x76, 0xb2, 0x74, 0x4, 0xd1, 0x62, 0x72, 0x3f, 0x1a, 0x79, 0xb7, 0x78, 0x5d, 0xb8, 0xdf, 0xba, 0xb3, 0x43, 0x69, 0x2c, 0xc, 0x58, 0xc8, 0x5b, 0xa2, 0xa7, 0x1b, 0x42, 0xe0, 0x11, 0xee, 0xf0, 0x63, 0x36, 0x75, 0x12, 0x9b, 0xa2, 0x91, 0xc9, 0x19, 0xcd, 0x56, 0xfb, 0xa5, 0x86, 0x47, 0x46, 0xf7, 0x60, 0xca, 0x4d, 0x2f, 0xe6, 0xa5, 0x40, 0xc, 0x1e, 0xce, 0xe3, 0xd5, 0x27, 0xb, 0x3, 0xde, 0x63, 0x63, 0xe0, 0x50, 0xac, 0x8b, 0x96, 0xb7, 0xaf, 0x5e, 0x10, 0xfb, 0x1c, 0xd5, 0xfe, 0x54, 0x7e, 0xd2, 0xef, 0xae, 0x1c, 0x54, 0xa2, 0x62, 0xeb, 0xba, 0xfa, 0x82, 0xb1, 0x41, 0x32, 0x98, 0x31, 0xbb, 0xa0, 0x8e, 0x3b, 0xa0, 0x86, 0xf9, 0xd0, 0xd3, 0x61, 0x90, 0x54, 0x82, 0x5c, 0x78, 0x9f, 0xb3, 0x87, 0x4b, 0x82, 0xb0, 0xa7, 0xb, 0x19, 0xf0, 0x8b, 0x30, 0xed, 0x23, 0x57, 0x22, 0x5f, 0xf6, 0x47, 0xb2, 0xfa, 0x89, 0x4d, 0x9f, 0x3b, 0xaa, 0x4, 0x22, 0x86, 0xed, 0x52, 0x12, 0x9c, 0x4f, 0xc9, 0x95, 0x30, 0x73, 0x21, 0xb6, 0xeb, 0xa, 0xc3, 0x75, 0x9c, 0x27, 0x15, 0x31, 0x7d, 0x94, 0xe8, 0x52, 0xdb, 0x4e, 0x17, 0xcc, 0x4f, 0xb, 0xef, 0x6e, 0xb, 0x35, 0xef, 0x31, 0xb5, 0x11, 0xe4, 0x2, 0xef, 0x67, 0xf6, 0x8d, 0x52, 0xe3, 0x7d, 0xba, 0xfa, 0xe2, 0xac, 0x6d, 0xba, 0x9d, 0x9, 0xd1, 0x93, 0xf7, 0x31, 0xd4, 0x88, 0xb6, 0x62, 0xc2, 0x60, 0xa4, 0x8e, 0x9f, 0xb7, 0x97, 0x63, 0xb2, 0x62, 0xb3, 0xb4, 0xc1, 0x4, 0x5b, 0x1f, 0xc9, 0x3a, 0xc2, 0x12, 0x9c, 0x1b, 0x8a, 0xb2, 0x7, 0x13, 0x53, 0xaa, 0x65, 0x29, 0xab, 0xe1, 0xe0, 0x98, 0x29, 0x4d, 0xbf, 0xa, 0xd6, 0x37, 0x4b, 0x69, 0x6c, 0xf2, 0x4c, 0x8f, 0xfc, 0xe0, 0x3a, 0xb8, 0xe6, 0x45, 0x4a, 0x68, 0x3b, 0xec, 0xb8, 0xd0, 0x53, 0x93, 0x8f, 0x6a, 0x25, 0xac, 0x7d, 0xe1, 0x37, 0xc8, 0xd4, 0xf1, 0x5d, 0xd2, 0x53, 0x13, 0xf8, 0x4e, 0x1a, 0x44, 0x49, 0xac, 0xde, 0x79, 0xb4, 0x39, 0xf, 0x1e, 0x87, 0x55, 0x73, 0x17, 0x7, 0x4b, 0x61, 0x3a, 0xf, 0x3, 0xbd, 0xf1, 0x2b, 0xe9, 0x7d, 0x22, 0x35, 0xf7, 0x8d, 0x59, 0xc4, 0xc0, 0x2a, 0xdf, 0xa9, 0x25, 0xb7, 0x8e, 0xa6, 0xea, 0xea, 0xf9, 0x2d, 0x3d, 0x1a, 0x72, 0x8f, 0x9a, 0x58, 0x2b, 0x7e, 0xab, 0xcb, 0xb3, 0xab, 0x5d, 0x59, 0x46, 0xaf, 0x51, 0x22, 0xe8, 0xaa, 0xe4, 0xe9, 0xc9, 0xac, 0x22, 0x31, 0x78, 0x36, 0x54, 0x11, 0xb, 0xb1, 0x92, 0x48, 0xb0, 0x75, 0xa, 0x16, 0xf, 0xd5, 0x6b, 0x82, 0x7b, 0x39, 0x5a, 0xb4, 0x75, 0x33, 0x92, 0xe4, 0x2f, 0xea, 0xa, 0xaa, 0xf4, 0x1a, 0x5, 0x36, 0x36, 0x56, 0x3e, 0x72, 0x77, 0xac, 0x58, 0x57, 0xd7, 0x57, 0x8f, 0x6c, 0x18, 0xbe, 0x70, 0xd4, 0x45, 0xfb, 0x20, 0x35, 0x62, 0x3, 0x33, 0xe7, 0x13, 0x9f, 0x30, 0x6a, 0x24, 0x3a, 0x8e, 0x2a, 0xff, 0x2, 0xc8, 0xc9, 0xf3, 0x1d, 0x79, 0xa, 0x86, 0xaf, 0xd2, 0xf4, 0xd9, 0x34, 0x75, 0xb5, 0xaf, 0x30, 0xf4, 0x4a, 0xb4, 0x1f, 0xce, 0xe, 0x8c, 0xe0, 0xe0, 0x12, 0x74, 0xd, 0x98, 0xba, 0x5f, 0x1e, 0x31, 0x84, 0x7, 0x68, 0x22, 0xb9, 0x8a, 0x1, 0x31, 0x95, 0xe6, 0x19, 0x9, 0x68, 0xae, 0x39, 0xf1, 0xfe, 0xe7, 0x86, 0x5b, 0x8a, 0xb9, 0x3c, 0x8c, 0xd5, 0x42, 0xeb, 0xf1, 0x5f, 0xd8, 0x8, 0x3d, 0xb0, 0x22, 0xc6, 0x5d, 0x61, 0x20, 0xaa, 0x3b, 0x4c, 0xc8, 0x3a, 0xd2, 0x89, 0x1f, 0xbf, 0x6a, 0xfe, 0xa4, 0x5a, 0x89, 0x86, 0xe3, 0xf0, 0xf0, 0x47, 0x4f, 0xfb, 0x11, 0x5, 0x7f, 0xe7, 0xb7, 0x88, 0xf, 0xd5, 0xee, 0x55, 0xe3, 0x2f, 0x14, 0xa7, 0x5d, 0x71, 0xae, 0x15, 0xdd, 0x23, 0xc, 0x13, 0xab, 0x2b, 0x64, 0x77, 0x51, 0x8e, 0x1c, 0xed, 0xf4, 0x1, 0x29, 0xe, 0x55, 0x32, 0x3a, 0xd7, 0x90, 0x7c, 0x31, 0xd1, 0x63, 0x76, 0xe3, 0x24, 0x6b, 0xcb, 0xd2, 0xd8, 0x55, 0xb6, 0x87, 0x8, 0x91, 0x8e, 0xa7, 0xf0, 0x23, 0x15, 0x23, 0xae, 0x74, 0xe1, 0x8a, 0xee, 0x7b, 0xda, 0xe7, 0xab, 0x10, 0xcb, 0x72, 0xa1, 0x8c, 0x52, 0x29, 0xd3, 0xea, 0xa5, 0xbe, 0xe7, 0x4c, 0x61, 0x4c, 0x18, 0xa5, 0x90, 0xe3, 0x70, 0xd2, 0x47, 0x5a, 0x5b, 0x8f, 0xef, 0x92, 0x8d, 0xdc, 0xc5, 0x8f, 0xc, 0x7d, 0xf3, 0xc6, 0x50, 0xca, 0x27, 0x52, 0x7f, 0x69, 0xa6, 0x47, 0x7a, 0x9f, 0xe0, 0xe4, 0xad, 0x94, 0x57, 0x34, 0xef, 0x50, 0xc9, 0x21, 0xb5, 0x34, 0xdc, 0xd8, 0xc9, 0xbc, 0x74, 0x2a, 0x7a, 0x3f, 0xbd, 0xc5, 0xcf, 0xc5, 0x9d, 0x72, 0xb6, 0x24, 0xe6, 0x1f, 0xc1, 0xec, 0x6d, 0x63, 0x27, 0x81, 0xe0, 0x8c, 0x77, 0x72, 0x98, 0xe9, 0x8b, 0xe0, 0x4e, 0x41, 0xc3, 0x24, 0x79, 0x16, 0xfd, 0x89, 0x6f, 0xd5, 0x75, 0x8d, 0xfa, 0x81, 0x5c, 0x5a, 0x2, 0x9d, 0xe8, 0x4b, 0x1b, 0x6, 0x7b, 0xc9, 0x2a, 0x5c, 0x69, 0xf8, 0xd1, 0x3e, 0x47, 0xba, 0x6d, 0x1b, 0x32, 0xeb, 0xad, 0xe4, 0xba, 0x97, 0x6, 0xd3, 0x93, 0x38, 0x7, 0x8f, 0xf3, 0xfa, 0x2d, 0xd6, 0xad, 0x7f, 0xa, 0x5a, 0x3b, 0x17, 0xa6, 0xf4, 0xd6, 0xef, 0x3, 0x7c, 0x9a, 0xa6, 0x51, 0xb7, 0xe8, 0xc1, 0x1d, 0x31, 0xca, 0x46, 0x9a, 0x1d, 0xfa, 0xea, 0xa, 0x3c, 0x26, 0x63, 0xe5, 0x77, 0xf3, 0x0, 0x82, 0x60, 0xb9, 0xf3, 0xe5, 0x2e, 0x83, 0x9e, 0x94, 0x99, 0x35, 0xba, 0xe8, 0x12, 0x5c, 0xb4, 0xdc, 0x60, 0xf9, 0x2b, 0xc4, 0x4d, 0xd3, 0xb9, 0x9e, 0x7b, 0xcb, 0x4f, 0x89, 0xa8, 0x1a, 0x16, 0xc1, 0x6, 0xca, 0xd1, 0x6b, 0x78, 0xf, 0xab, 0x7e, 0x8, 0x67, 0x7e, 0xc1, 0xc1, 0xfd, 0xbb, 0x32, 0xc2, 0xc3, 0x60, 0x12, 0x1b, 0x8b, 0xe0, 0xf1, 0x74, 0x4e, 0xe5, 0x2b, 0x7e, 0xb2, 0xeb, 0xfe, 0x77, 0x17, 0x9b, 0xd, 0x38, 0x5e, 0xd1, 0xcb, 0x3c, 0x5f, 0x89, 0x26, 0xce, 0x4b, 0x8e, 0x67, 0x87, 0xb4, 0x1c, 0x42, 0x9a, 0xa8, 0xbf, 0x48, 0xf0, 0xaf, 0x66, 0x40, 0xb4, 0x6, 0x33, 0xce, 0xab, 0x7, 0xf2, 0xbd, 0x68, 0xe6, 0xa7, 0x6c, 0x3c, 0x1d, 0xa7, 0xdb, 0x89, 0xb2, 0xec, 0xda, 0xf6, 0xc, 0xfa, 0x56, 0x7f, 0xe4, 0xd, 0xef, 0xa9, 0xa9, 0x65, 0x29, 0x1b, 0xea, 0x5a, 0xf3, 0xc1, 0x47, 0x58, 0x8b, 0x40, 0x3, 0xe4, 0xe9, 0xf8, 0x44, 0x9a, 0xd, 0x73, 0x4f, 0xeb, 0x4c, 0x85, 0x3e, 0x72, 0x47, 0x19, 0x18, 0xad, 0x9, 0x69, 0xb5, 0xad, 0xf9, 0xad, 0xcd, 0x5b, 0xac, 0x61, 0x35, 0xf6, 0x6c, 0xd9, 0xeb, 0x1d, 0x57, 0x76, 0x93, 0xe7, 0xc2, 0xf8, 0xb4, 0xe3, 0x45, 0xf1, 0x6, 0x9, 0x5c, 0x20, 0x51, 0x8d, 0xb0, 0x4d, 0x19, 0xb4, 0x2b, 0x34, 0x7a, 0xa3, 0x1f, 0xa9, 0xaa, 0x80, 0x1a, 0x95, 0x5e, 0x59, 0xaf, 0x9f, 0xfe, 0x61, 0x43, 0xf0, 0x8e, 0xf3, 0x15, 0x2c, 0xc4, 0x4f, 0x3c, 0x26, 0x7b, 0xeb, 0xf1, 0xd0, 0xf8, 0xf8, 0xda, 0xb0, 0x74, 0x81, 0x42, 0xb0, 0x63, 0x62, 0x64, 0x4d, 0xdb, 0x78, 0x9c, 0xc5, 0xf7, 0xc7, 0x3, 0xdf, 0xb2, 0xa7, 0xaa, 0x1a, 0x1a, 0x18, 0xcf, 0x62, 0x8d, 0x5, 0x79, 0x60, 0x91, 0xe2, 0xf0, 0x7e, 0x18, 0x51, 0xa6, 0xb2, 0xe1, 0x59, 0x55, 0xfd, 0x85, 0x21, 0x8f, 0xbd, 0xd1, 0xbd, 0x8b, 0x8a, 0x5b, 0x57, 0x42, 0x7a, 0x1c, 0x88, 0x54, 0xae, 0x53, 0xf8, 0x7c, 0xb8, 0xda, 0x5b, 0xf9, 0xea, 0x68, 0x27, 0xe, 0x6c, 0x47, 0x79, 0x87, 0xee, 0x79, 0x69, 0x96, 0xa1, 0x99, 0xdc, 0x1d, 0xd9, 0xb5, 0x25, 0xcf, 0x49, 0x7c, 0xb2, 0x5c, 0x34, 0xaf, 0xeb, 0x4b, 0x44, 0x43, 0x28, 0x11, 0x96, 0x96, 0x4b, 0x74, 0xc8, 0x6a, 0xbf, 0x45, 0xb9, 0xb8, 0xa8, 0x19, 0x9d, 0xbf, 0x17, 0xe1, 0x83, 0x2b, 0x80, 0xb9, 0x7c, 0x82, 0x8a, 0xfc, 0x95, 0x45, 0xfd, 0x80, 0xfb, 0x32, 0xe8, 0x39, 0x50, 0x46, 0x2a, 0xb2, 0x17, 0x3e, 0x27, 0xc8, 0xc9, 0xbc, 0x18, 0xa5, 0x18, 0x4, 0x95, 0x96, 0x62, 0xb4, 0x6f, 0xde, 0xec, 0x7a, 0x22, 0x58, 0xb1, 0xe, 0xb9, 0x51, 0xce, 0xa2, 0xe4, 0x24, 0xfe, 0xa6, 0xac, 0xad, 0x26, 0x81, 0x19, 0x7b, 0x8a, 0xb5, 0x92, 0xd1, 0x20, 0x1, 0xce, 0x32, 0x36, 0x7a, 0x1d, 0x5f, 0x6e, 0xcb, 0x68, 0x7e, 0xc2, 0xbb, 0x8c, 0x73, 0x6e, 0xfb, 0x65, 0xc7, 0xd5, 0x4d, 0x4d, 0x16, 0x55, 0x55, 0xaf, 0xb2, 0xa5, 0x16, 0xf6, 0x96, 0x22, 0xb3, 0xd8, 0xd7, 0x54, 0x33, 0xae, 0x40, 0x4, 0xa, 0xbc, 0xcd, 0xd8, 0xe4, 0xec, 0xa8, 0xf7, 0xd3, 0x83, 0xb, 0x8b, 0x44, 0xa, 0x9d, 0xf4, 0xf8, 0x18, 0x84, 0x7e, 0xd1, 0x72, 0x1c, 0xfd, 0x2c, 0xa0, 0x36, 0x1e, 0x51, 0xb9, 0x39, 0xed, 0xf0, 0x4c, 0x4, 0x1b, 0xf5, 0xba, 0x2d, 0x93, 0x17, 0x4d, 0xd8, 0x66, 0x9b, 0x1, 0x71, 0x1c, 0xac, 0x43, 0xd6, 0xf2, 0x5, 0x4, 0xa8, 0x1b, 0x33, 0xea, 0xd7, 0xc1, 0x77, 0x57, 0x8, 0x28, 0xef, 0x69, 0x9b, 0xb6, 0x35, 0x90, 0x8b, 0x1e, 0x90, 0xfc, 0xc5, 0xe2, 0x37, 0xc4, 0xf5, 0x99, 0x66, 0xef, 0x6, 0x86, 0xef, 0x10, 0x41, 0x3, 0xb6, 0x5c, 0x77, 0x28, 0xad, 0xe3, 0x2a, 0xe9, 0x3b, 0x31, 0x69, 0x86, 0xcd, 0x33, 0x79, 0x7, 0x7, 0x5d, 0xbd, 0x6, 0x4a, 0x57, 0x5b, 0x4e, 0x4e, 0xc4, 0x16, 0x99, 0x6d, 0x6a, 0x19, 0x47, 0xfa, 0xfd, 0xe8, 0xe5, 0xe2, 0xee, 0xea, 0xc6, 0xdc, 0xc7, 0xf6, 0xca, 0x6c, 0x52, 0xce, 0xed, 0xc6, 0xc9, 0xec, 0x9e, 0xc5, 0xe3, 0xd0, 0x2f, 0x6d, 0x4c, 0xd2, 0x5a, 0xa2, 0xd2, 0x47, 0x3a, 0xe0, 0x88, 0x15, 0x39, 0x4b, 0xaa, 0x5b, 0xae, 0x9e, 0xe0, 0xd2, 0xce, 0x8a, 0x25, 0xd, 0x91, 0xac, 0x26, 0xf4, 0x35, 0x34, 0xa2, 0x44, 0xef, 0xf8, 0x29, 0x2b, 0x37, 0x7a, 0x5a, 0xc1, 0x55, 0xdd, 0xea, 0x86, 0xc4, 0x3e, 0x53, 0x41, 0x67, 0xb8, 0xf5, 0x91, 0x7c, 0xa6, 0x22, 0xfc, 0xa4, 0xa2, 0xf0, 0x7e, 0xce, 0xc, 0xec, 0x7, 0x6, 0x7c, 0x74, 0x20, 0xd, 0xb2, 0x96, 0x20, 0xfd, 0xb2, 0x46, 0x36, 0x0, 0x6d, 0xad, 0x9b, 0xff, 0x3d, 0xc8, 0xc, 0x44, 0x2d, 0x6f, 0xb7, 0xec, 0x13, 0x2d, 0x4, 0xa, 0x35, 0x20, 0x8b, 0x33, 0x6a, 0x8a, 0x2b, 0x1c, 0x0, 0x2e, 0xa5, 0x24, 0xbe, 0x38, 0x9f, 0x93, 0xd4, 0xc8, 0x4b, 0x5c, 0xe9, 0x93, 0xa3, 0x9b, 0x21, 0xa, 0xaa, 0x5c, 0x9f, 0x2f, 0xb3, 0x57, 0x74, 0x6d, 0xac, 0xb9, 0xb9, 0xfa, 0x7b, 0xb1, 0x7c, 0x39, 0x6b, 0x18, 0xbd, 0x30, 0x30, 0xd9, 0xb0, 0x28, 0xe5, 0xd3, 0xab, 0x6d, 0x23, 0x1a, 0xb5, 0xad, 0x4b, 0xea, 0x2b, 0x3c, 0x4a, 0xfa, 0x9c, 0xc5, 0xa3, 0xf8, 0xbb, 0x9a, 0x28, 0x6e, 0xb1, 0xa9, 0x1d, 0x19, 0x44, 0xd9, 0xd0, 0xe9, 0x80, 0xb9, 0x87, 0xe5, 0xe3, 0x85, 0x80, 0xb2, 0x43, 0xb4, 0x9f, 0x11, 0x55, 0xc9, 0x5f, 0xbd, 0x80, 0x9c, 0x74, 0x28, 0x28, 0x20, 0x3c, 0x8d, 0x73, 0x1d, 0x78, 0x4b, 0x45, 0xc7, 0x73, 0x68, 0x89, 0xd, 0x2a, 0xa4, 0x48, 0xbe, 0x65, 0x90, 0x9b, 0xcf, 0xbc, 0x3, 0x3b, 0x8c, 0x52, 0xf8, 0x57, 0x5d, 0xce, 0xdb, 0x1c, 0x8, 0xe3, 0x5e, 0xee, 0x94, 0xab, 0xdb, 0x90, 0xff, 0xde, 0xe3, 0x68, 0xdc, 0xb2, 0x64, 0xec, 0x55, 0x39, 0x67, 0x6b, 0xd7, 0x8d, 0x0, 0xc7, 0x6e, 0x29, 0x93, 0x84, 0x5b, 0x95, 0x7c, 0x1d, 0x21, 0x6c, 0x2d, 0x36, 0xbd, 0x80, 0xe4, 0x4f, 0x19, 0x5f, 0x8, 0xb0, 0x4d, 0x3e, 0x50, 0x95, 0x38, 0x36, 0xd7, 0x80, 0x12, 0x85, 0x5c, 0x1d, 0x43, 0x5e, 0x47, 0x26, 0x1a, 0x68, 0xd, 0xcd, 0xe6, 0xaa, 0x6a, 0x9b, 0x9c, 0xcf, 0x3, 0xb9, 0xea, 0xbe, 0x69, 0x44, 0xf2, 0x95, 0xf5, 0x29, 0x83, 0x87, 0x77, 0x55, 0x8b, 0xc7, 0x8, 0x70, 0x14, 0xc6, 0x4d, 0x8f, 0xab, 0xc, 0x42, 0x39, 0xbc, 0x1b, 0x9b, 0xf5, 0x7c, 0xf, 0x78, 0x63, 0x52, 0x6c, 0x21, 0x45, 0x7f, 0x1, 0xfe, 0x10, 0x1f, 0x4d, 0x64, 0x6f, 0x7a, 0xcb, 0x9f, 0x71, 0xf2, 0x7c, 0xc6, 0xc0, 0x6, 0xaa, 0xfb, 0x91, 0xa3, 0xd3, 0x10, 0x38, 0xc4, 0x9f, 0x5f, 0x28, 0x32, 0xe4, 0xe2, 0x5c, 0x47, 0x80, 0x53, 0x6f, 0x89, 0xb9, 0x32, 0x8, 0xd3, 0x4d, 0x5, 0x82, 0x7c, 0x1b, 0x50, 0x92, 0x9d, 0xb1, 0xd1, 0xc, 0xd8, 0x5e, 0x8, 0xe9, 0xe7, 0x6b, 0x9b, 0xec, 0xd2, 0x86, 0xf, 0xe4, 0xe0, 0xf9, 0x51, 0x35, 0xd6, 0xaa, 0xda, 0x46, 0x63, 0x5e, 0x77, 0xa3, 0x2c, 0x22, 0x76, 0x81, 0x4b, 0xbf, 0x8e, 0xa5, 0x66, 0x1, 0xb9, 0xd4, 0xd4, 0x1c, 0xf3, 0x8c, 0x61, 0x5d, 0xcb, 0xb5, 0x5, 0x57, 0x4b, 0xd, 0xb, 0x6a, 0xba, 0xfd, 0x8c, 0xe4, 0xf2, 0x88, 0x9a, 0xc5, 0xc, 0x4e, 0x42, 0x83, 0xa7, 0xc1, 0xfc, 0xc8, 0x69, 0xa9, 0x94, 0xa4, 0x51, 0xc8, 0xb7, 0x72, 0xc5, 0x4b, 0x16, 0x9, 0x4b, 0xcb, 0xe5, 0x1b, 0xe9, 0xdf, 0xa3, 0x2c, 0xd3, 0x46, 0xb4, 0xac, 0xbd, 0x2c, 0x4d, 0x5, 0xa8, 0x84, 0x46, 0x2e, 0x4d, 0xa3, 0x1a, 0xeb, 0xce, 0x47, 0x3c, 0xe7, 0x94, 0xb5, 0xae, 0x1e, 0xe3, 0x5d, 0xee, 0x79, 0x6f, 0xae, 0xfd, 0x3f, 0xa9, 0xf6, 0xf1, 0x85, 0xce, 0x7, 0x20, 0x5, 0xe1, 0xed, 0x77, 0x37, 0x42, 0xbf, 0xda, 0xc7, 0x66, 0xf8, 0xe4, 0xb9, 0xc7, 0x7d, 0x47, 0xad, 0xf7, 0x2d, 0xe, 0x9e, 0xc3, 0xa8, 0xd0, 0x11, 0x9, 0x6a, 0x77, 0x4b, 0x0, 0x34, 0xb0, 0x19, 0x53, 0x62, 0xc6, 0x41, 0x76, 0x51, 0xa8, 0x14, 0xd8, 0x20, 0xcf, 0x86, 0x47, 0xc3, 0xfd, 0x5c, 0xa1, 0x1e, 0xba, 0x81, 0x48, 0xa8, 0x9b, 0xe8, 0x67, 0x60, 0x48, 0xed, 0x95, 0x51, 0x59, 0xe6, 0xf5, 0x79, 0xe0, 0x70, 0xae, 0x93, 0x88, 0x1e, 0xf9, 0xbb, 0xfe, 0x5d, 0x68, 0x4f, 0xbf, 0xbd, 0xf0, 0x85, 0xa9, 0x45, 0xf8, 0xd6, 0x63, 0x7c, 0x1f, 0xaa, 0xdf, 0x65, 0xdd, 0x93, 0xf, 0x12, 0xe, 0xcb, 0x48, 0x40, 0xd6, 0x8f, 0x6f, 0xa2, 0x6c, 0x9c, 0xce, 0xd7, 0x7f, 0xa, 0xb4, 0x3f, 0x97, 0x26, 0xaf, 0x80, 0x1f, 0x1c, 0x81, 0xed, 0x6e, 0xf1, 0x4, 0x39, 0x96, 0x3f, 0xfd, 0xf8, 0x9f, 0x5a, 0x8d, 0xf5, 0x72, 0x38, 0x17, 0x11, 0x1, 0x9e, 0x3e, 0xb8, 0xfa, 0xac, 0x62, 0xb, 0x2e, 0x95, 0x77, 0xae, 0xef, 0x48, 0x2d, 0x92, 0xc0, 0x6a, 0x4e, 0x67, 0x86, 0xba, 0x96, 0x82, 0x27, 0xb8, 0x18, 0x81, 0x45, 0x37, 0xab, 0x9c, 0xe6, 0xf2, 0xab, 0xb7, 0xb8, 0x9c, 0x34, 0xcf, 0xe, 0xa3, 0x44, 0x76, 0x24, 0x76, 0xd2, 0x8b, 0xe9, 0x27, 0x22, 0xea, 0x1e, 0xf9, 0xb, 0x6b, 0xb7, 0x1, 0xbf, 0x4c, 0x33, 0xf2, 0xd3, 0xd0, 0x4b, 0x47, 0xf3, 0x3b, 0x2f, 0x7f, 0xa5, 0x8, 0x38, 0xfb, 0x59, 0xd7, 0xc4, 0xde, 0x71, 0x26, 0x58, 0xbc, 0xe7, 0x8, 0xac, 0x4b, 0xcc, 0x33, 0x72, 0x7c, 0xb0, 0xb4, 0xe, 0x82, 0xca, 0x4b, 0xc, 0x6a, 0x2f, 0xcf, 0xde, 0xb0, 0x7f, 0x17, 0xb2, 0xf4, 0xc9, 0x77, 0xd4, 0x59, 0x7e, 0xb1, 0x60, 0xb3, 0x61, 0xd4, 0x80, 0xd3, 0x20, 0xe4, 0xec, 0xa5, 0x93, 0x21, 0x8b, 0x48, 0x54, 0xac, 0xab, 0xa6, 0xeb, 0xe8, 0xa4, 0xf4, 0x3a, 0x9b, 0x75, 0x36, 0xd4, 0x42, 0x92, 0xca, 0x4b, 0x4e, 0x4c, 0x5f, 0x1f, 0x2d, 0xab, 0x1e, 0xff, 0xe0, 0x11, 0x4f, 0x7d, 0xab, 0x9c, 0xc0, 0xe2, 0xdd, 0xf9, 0xbd, 0xa2, 0x81, 0xa6, 0xf8, 0x1a, 0x15, 0xd2, 0xd4, 0x20, 0x83, 0xc6, 0x30, 0x32, 0x51, 0xe5, 0xaf, 0xe2, 0x7a, 0x5c, 0x6, 0x3f, 0x7d, 0xcc, 0x18, 0xa1, 0xbe, 0xff, 0xb8, 0xa5, 0x12, 0xeb, 0x5c, 0xf3, 0x25, 0x8e, 0xc6, 0x65, 0x77, 0x19, 0x25, 0x65, 0x74, 0xa8, 0xe5, 0xd6, 0x99, 0x91, 0x43, 0xf2, 0xcb, 0x66, 0x7f, 0x2, 0x36, 0x4b, 0x5c, 0x92, 0x44, 0xe5, 0x17, 0x98, 0x7a, 0x30, 0xfe, 0x39, 0x52, 0xcd, 0x98, 0x1e, 0xb1, 0x4d, 0xd5, 0x28, 0x5, 0x6b, 0x7b, 0x65, 0xaf, 0x18, 0xd2, 0x10, 0x84, 0x30, 0xbe, 0xe0, 0x19, 0x75, 0xe2, 0x67, 0x62, 0x9b, 0xeb, 0x81, 0x86, 0xc7, 0x18, 0x55, 0xea, 0x54, 0x6e, 0x4d, 0x63, 0xf4, 0xf, 0x5a, 0x29, 0x88, 0x54, 0x1d, 0xa5, 0xa3, 0xed, 0x98, 0x2c, 0x66, 0xeb, 0x63, 0xc3, 0x58, 0x60, 0xad, 0xf1, 0xf5, 0x22, 0x4a, 0x57, 0x8d, 0x4b, 0x7b, 0xfe, 0x3e, 0xfb, 0xa, 0xf1, 0xaa, 0xf8, 0xd2, 0x12, 0xd8, 0x57, 0xbd, 0x2a, 0x8, 0xfa, 0x8c, 0xaf, 0xd, 0xe7, 0x55, 0x8d, 0x7a, 0xe2, 0x6c, 0x6f, 0x49, 0xa9, 0x6a, 0xb6, 0xbf, 0xac, 0x9d, 0x7f, 0xb3, 0x8b, 0xfd, 0xbb, 0xa8, 0xe2, 0x96, 0x51, 0x7c, 0xe, 0x39, 0x76, 0xe2, 0x2f, 0x20, 0x6, 0xc5, 0x8f, 0x12, 0x19, 0x21, 0xed, 0xc8, 0x2a, 0xe5, 0x79, 0xe5, 0x27, 0x1c, 0x8c, 0xbd, 0xfc, 0x90, 0xe8, 0xc4, 0x80, 0x42, 0xf8, 0x8, 0xde, 0xe9, 0x5a, 0x58, 0x9c, 0x8c, 0xbe, 0x1, 0x57, 0x74, 0x52, 0xa2, 0x2f, 0x8a, 0xd1, 0xb6, 0xb, 0x26, 0x62, 0xe1, 0x5f, 0x8c, 0x2d, 0xc9, 0x47, 0xd7, 0x94, 0x66, 0x88, 0x97, 0xeb, 0x5b, 0x9e, 0x91, 0x6f, 0xc4, 0x29, 0x38, 0x63, 0xb0, 0xf7, 0xc3, 0xf0, 0x79, 0x22, 0x3b, 0xa7, 0x87, 0xd7, 0x13, 0x1, 0x5, 0xbe, 0x4f, 0x3f, 0x1b, 0xd3, 0xd8, 0x2f, 0x6b, 0x6d, 0xb1, 0x72, 0x22, 0xda, 0x2f, 0x95, 0xcc, 0x51, 0xe8, 0xde, 0xb1, 0x1a, 0xbb, 0x80, 0x9f, 0x86, 0x7b, 0x5f, 0x7, 0x85, 0x28, 0xee, 0x8a, 0x3c, 0xc4, 0x2f, 0x57, 0xdb, 0xc2, 0xa8, 0xc7, 0x49, 0xf8, 0xc7, 0x33, 0x37, 0xa3, 0xc7, 0x40, 0x2f, 0xb2, 0x78, 0xe6, 0x89, 0xa, 0xfe, 0xd5, 0x27, 0x7d, 0xca, 0x1d, 0xa0, 0xf1, 0x94, 0x7b, 0x7d, 0x94, 0x8, 0xba, 0x94, 0x9, 0x76, 0xde, 0x3d, 0xd7, 0x29, 0x91, 0x61, 0x8a, 0x71, 0x22, 0x6f, 0x8b, 0xb5, 0x1a, 0xb4, 0xbf, 0xb9, 0xbd, 0xe1, 0x9b, 0xa3, 0x5b, 0x65, 0xf2, 0xd5, 0xf8, 0xf8, 0x13, 0xf0, 0xf5, 0xf1, 0x68, 0xe4, 0x1b, 0x55, 0x76, 0xb9, 0x2f, 0xd0, 0x71, 0xc5, 0xcd, 0x74, 0x71, 0x38, 0x18, 0x67, 0x55, 0x2d, 0x67, 0x1b, 0x60, 0xae, 0x17, 0xda, 0x4d, 0x77, 0xb0, 0x6a, 0xdb, 0xd4, 0xf2, 0x98, 0x9d, 0x79, 0x9f, 0x39, 0x37, 0x76, 0xd8, 0xfb, 0x8a, 0x1, 0x16, 0xa3, 0x3a, 0x73, 0xa, 0xea, 0x42, 0xe6, 0xf4, 0x28, 0x4d, 0x68, 0x35, 0x5b, 0xb9, 0x93, 0x1c, 0xd7, 0xad, 0x3c, 0x45, 0xbf, 0x5d, 0xf1, 0x75, 0x55, 0x6a, 0xa3, 0x31, 0xd7, 0xd0, 0x92, 0x98, 0x10, 0x59, 0xb8, 0x3a, 0x17, 0xd3, 0x4e, 0xdd, 0xe9, 0xdd, 0x71, 0x3c, 0xcf, 0xbb, 0x6d, 0xce, 0x3b, 0x96, 0xde, 0xd1, 0x8d, 0xc5, 0x72, 0x7a, 0xd6, 0xd9, 0x2b, 0xb8, 0x17, 0x63, 0xa0, 0xc, 0xc, 0x30, 0xdd, 0x32, 0x90, 0xd3, 0xea, 0x65, 0xcb, 0x3d, 0x69, 0x3b, 0xb, 0x38, 0xc1, 0xf5, 0xbf, 0x74, 0x66, 0x57, 0xd7, 0xda, 0xac, 0xe1, 0xe0, 0xed, 0xc2, 0xad, 0xbe, 0x49, 0x93, 0xd6, 0xfd, 0xb1, 0x50, 0xd4, 0x91, 0x69, 0xf0, 0x64, 0x9f, 0xf9, 0x6b, 0x3e, 0x25, 0xae, 0xe1, 0x12, 0xe3, 0x8e, 0xf3, 0xac, 0xf4, 0x3c, 0x5e, 0xb7, 0x8d, 0xad, 0xb5, 0xcd, 0x7b, 0xf2, 0x96, 0x9, 0x93, 0x98, 0xd, 0x53, 0x15, 0xee, 0x2f, 0xc0, 0x3c, 0x4c, 0xf1, 0xcb, 0x4c, 0xd5, 0x15, 0x7b, 0x68, 0x6, 0x90, 0x85, 0x2a, 0x37, 0xa7, 0x2f, 0xdf, 0x76, 0xaf, 0x5, 0x2f, 0xca, 0x1b, 0x4e, 0x9e, 0xd3, 0xeb, 0xe0, 0x77, 0xdf, 0x66, 0x76, 0x37, 0x36, 0x57, 0xcf, 0x22, 0xc5, 0x21, 0x86, 0xd1, 0x48, 0xc0, 0xb4, 0xf6, 0xf0, 0x37, 0xb6, 0x90, 0x1c, 0xc5, 0xdd, 0x6e, 0x65, 0xfc, 0x64, 0x73, 0x47, 0x0, 0x4d, 0xe5, 0xda, 0x88, 0x95, 0xed, 0xa2, 0xf2, 0x6d, 0xd, 0x3e, 0xff, 0xa1, 0xbb, 0xfe, 0x64, 0xdb, 0x4, 0xb5, 0x79, 0x60, 0x91, 0xd1, 0x70, 0x14, 0xa7, 0x26, 0xa, 0xfb, 0xbd, 0x1c, 0x34, 0x91, 0xf0, 0x7b, 0xba, 0x7f, 0x58, 0xa3, 0xa0, 0x32, 0x65, 0x3e, 0x81, 0x37, 0x25, 0x77, 0xba, 0x63, 0xc2, 0x36, 0xf5, 0xd4, 0xe8, 0x71, 0xc7, 0x1d, 0xe4, 0xba, 0x79, 0x1a, 0x37, 0x46, 0xfe, 0xfd, 0xcc, 0x64, 0x60, 0xa9, 0xe1, 0x25, 0x74, 0xd5, 0xb0, 0x9d, 0x73, 0x58, 0x6c, 0xf5, 0xf9, 0xeb, 0xb8, 0x89, 0x3e, 0xf3, 0x77, 0xc9, 0x76, 0x8b, 0x31, 0xf6, 0xdb, 0xe1, 0x98, 0x57, 0x3f, 0x18, 0x5c, 0xa3, 0xcb, 0xb2, 0xa6, 0x26, 0x7c, 0xb3, 0xa8, 0xa3, 0x68, 0x1c, 0x56, 0x25, 0xed, 0x44, 0xa5, 0x4c, 0x9e, 0x49, 0xc0, 0xdd, 0xdb, 0x9f, 0x22, 0xdb, 0x27, 0x64, 0xe0, 0x67, 0x85, 0xd7, 0x97, 0xfc, 0xd2, 0xfd, 0x5f, 0xdb, 0x4d, 0x21, 0xba, 0x17, 0x9e, 0x53, 0xe3, 0x5d, 0xdd, 0x5, 0x8c, 0xfc, 0x14, 0x91, 0xe2, 0x9a, 0x7e, 0xe, 0x46, 0x86, 0x96, 0x2d, 0x94, 0x6b, 0xf7, 0x46, 0xed, 0x29, 0x8e, 0x84, 0xf0, 0xf4, 0x4d, 0x5a, 0x34, 0x93, 0x8d, 0x1, 0x3a, 0x1b, 0x8e, 0xaf, 0x83, 0x92, 0x90, 0x1f, 0xef, 0x61, 0x6e, 0x61, 0xbf, 0xd7, 0x59, 0xab, 0xdf, 0x36, 0xf2, 0x55, 0x63, 0xeb, 0x1a, 0x62, 0x1a, 0xd6, 0x31, 0x3e, 0xd5, 0xfb, 0xdd, 0x8d, 0x39, 0x63, 0x7a, 0xaa, 0x9a, 0xfb, 0xd6, 0xf2, 0x5c, 0x3a, 0x90, 0xd1, 0x48, 0x57, 0xa9, 0x3c, 0xae, 0xd0, 0x65, 0x9e, 0xc9, 0xad, 0xfa, 0x7a, 0xa9, 0x4d, 0xba, 0xf7, 0xd4, 0x23, 0xc4, 0x54, 0xc3, 0x56, 0x58, 0xf3, 0x2c, 0xd6, 0x3a, 0x13, 0x14, 0x74, 0x9f, 0xb8, 0xda, 0x7a, 0x8c, 0xa0, 0xad, 0x5e, 0xf7, 0xfe, 0xad, 0x23, 0x5d, 0x3b, 0x65, 0xed, 0xa5, 0x74, 0xc8, 0x2e, 0x4b, 0xcb, 0x75, 0x24, 0xbf, 0x27, 0x5e, 0x3c, 0x8a, 0x9b, 0x32, 0x45, 0x41, 0x4f, 0xa3, 0x73, 0x7a, 0x16, 0x6, 0x8d, 0x16, 0x9f, 0x6f, 0xcc, 0xe8, 0x37, 0xa7, 0x6c, 0xc5, 0x30, 0x5f, 0xd5, 0x39, 0x89, 0xbe, 0x32, 0x6b, 0x98, 0x9b, 0x98, 0xbd, 0xf9, 0xff, 0x59, 0x3c, 0xdb, 0x90, 0x18, 0x5d, 0x3c, 0xc7, 0xe7, 0xfd, 0xee, 0x9a, 0x4, 0x93, 0xca, 0x7d, 0xe6, 0xde, 0x68, 0xe1, 0x30, 0x2, 0xb4, 0x13, 0x6a, 0x17, 0x6d, 0x9, 0x3a, 0xea, 0x3e, 0xea, 0x18, 0x5d, 0x63, 0x18, 0x8d, 0x1b, 0xbd, 0x38, 0xe0, 0xcd, 0xa1, 0xd7, 0x11, 0xd2, 0xac, 0xe2, 0xe8, 0x6b, 0x37, 0x35, 0xba, 0x5f, 0x66, 0xae, 0xdb, 0x2b, 0x5f, 0x98, 0x6c, 0x5a, 0x3e, 0xaf, 0x9c, 0xf7, 0x7d, 0x41, 0xb4, 0x60, 0xc, 0xcd, 0xa, 0xe1, 0xb0, 0xf9, 0xf1, 0xf8, 0xf6, 0xf4, 0xfb, 0xb2, 0xe6, 0xa3, 0x8a, 0x6e, 0x88, 0xe3, 0xf2, 0x38, 0xf8, 0x45, 0xf9, 0xc5, 0xa1, 0x38, 0xb4, 0x79, 0x2, 0x6e, 0xb2, 0x8f, 0xfd, 0x5, 0xd7, 0xd8, 0x36, 0xc6, 0xbc, 0x82, 0x4e, 0xd3, 0xfc, 0x34, 0xe5, 0x2c, 0x98, 0x40, 0x7f, 0xc2, 0xba, 0xea, 0x70, 0x6a, 0x35, 0x51, 0xa2, 0x6b, 0x48, 0x8e, 0xb8, 0x25, 0x9d, 0x9e, 0x9e, 0x5d, 0xfd, 0xa7, 0xb1, 0x27, 0x6f, 0xbe, 0x50, 0x1c, 0x89, 0x50, 0x90, 0xa4, 0x6d, 0x1a, 0x81, 0xbd, 0x27, 0xce, 0xbe, 0xd9, 0x7, 0x20, 0xdd, 0x9f, 0x25, 0xb6, 0x60, 0x18, 0x4d, 0x57, 0xa, 0xb2, 0x9c, 0x79, 0x3b, 0xb2, 0x97, 0xd1, 0x97, 0xdf, 0xef, 0x4d, 0x7f, 0xcb, 0xbe, 0xd7, 0x40, 0x19, 0xed, 0x3e, 0x46, 0x17, 0x7a, 0x7c, 0xac, 0x9e, 0x31, 0xfb, 0x2d, 0x18, 0x49, 0x53, 0xe1, 0xa2, 0x2f, 0x15, 0xe1, 0xa5, 0x9d, 0xf9, 0xb5, 0x77, 0x94, 0x77, 0xe4, 0x33, 0x63, 0x74, 0x1b, 0x57, 0x61, 0x8c, 0x1c, 0xad, 0x14, 0x47, 0xdd, 0xc5, 0xe3, 0x2f, 0xb7, 0x55, 0x6, 0x91, 0x37, 0x53, 0xe9, 0xa6, 0xcc, 0x55, 0x98, 0x5, 0x44, 0xf8, 0x75, 0xf9, 0x9, 0xd0, 0x7c, 0xd9, 0xed, 0xd0, 0x1a, 0x3e, 0xd2, 0x53, 0xb7, 0x97, 0xe8, 0xb0, 0x64, 0xe9, 0xae, 0x2b, 0xf, 0x26, 0x6c, 0x92, 0x6e, 0x60, 0x7c, 0x73, 0xe3, 0x38, 0xca, 0xa9, 0xfd, 0x43, 0x3a, 0x4e, 0xb9, 0x43, 0x42, 0x74, 0xc8, 0xeb, 0x68, 0xfd, 0x79, 0x4a, 0xed, 0xce, 0x79, 0xb5, 0xc7, 0x24, 0x26, 0xf1, 0xad, 0x56, 0xb5, 0x74, 0x62, 0x8f, 0xb4, 0x43, 0xab, 0x9a, 0xbb, 0x9, 0x37, 0x98, 0x10, 0x4e, 0xfb, 0x1, 0x2b, 0xbd, 0xeb, 0xfa, 0x85, 0x86, 0x9c, 0x6d, 0xc2, 0xe0, 0x7a, 0xe8, 0x23, 0xac, 0xce, 0x7, 0x71, 0xaf, 0x7a, 0x35, 0xe5, 0xed, 0xf1, 0x40, 0x78, 0x6, 0xde, 0xd, 0xc8, 0x92, 0x8b, 0x1f, 0x7f, 0x25, 0x88, 0x38, 0x56, 0xe7, 0xb0, 0xf3, 0xfe, 0x6c, 0xa5, 0x21, 0x3e, 0x24, 0x52, 0x61, 0xa2, 0x38, 0xc6, 0x54, 0x70, 0xd8, 0x16, 0xbb, 0x5e, 0x3d, 0x8a, 0xe9, 0x22, 0x2f, 0x7e, 0xb4, 0xbe, 0x68, 0x58, 0xae, 0xc1, 0x5a, 0xd5, 0xf1, 0x51, 0xaa, 0x1d, 0x9e, 0xe9, 0x3d, 0x57, 0xa2, 0xc9, 0xe4, 0x5b, 0x46, 0x1d, 0x84, 0x30, 0x99, 0xd7, 0x9e, 0x52, 0x77, 0x64, 0x70, 0x77, 0xbd, 0x86, 0x9e, 0xe8, 0x4a, 0xe7, 0x1c, 0xc2, 0x3e, 0x2e, 0x30, 0xd0, 0xc6, 0x7e, 0xa, 0x41, 0xdd, 0x48, 0xb2, 0xea, 0x83, 0x72, 0x3d, 0x3b, 0x3, 0x37, 0xb6, 0xc9, 0x9f, 0xa8, 0xce, 0x37, 0x26, 0xd6, 0xbf, 0x9a, 0x19, 0xfc, 0x8a, 0x1f, 0x79, 0xcf, 0xc5, 0xfb, 0x34, 0xa7, 0xc5, 0x7a, 0x53, 0x6f, 0xb8, 0xeb, 0xbe, 0x59, 0xf6, 0x17, 0x90, 0xb0, 0xf5, 0x6c, 0xa4, 0x87, 0x20, 0x8d, 0xdf, 0x19, 0xfe, 0x12, 0x9b, 0x77, 0x1f, 0xf7, 0x46, 0xb0, 0xf8, 0x6b, 0x75, 0x7, 0x5, 0xa3, 0x81, 0xaa, 0xc2, 0xf7, 0x89, 0x61, 0x7a, 0x66, 0xd1, 0x82, 0x57, 0x3f, 0xed, 0xa3, 0x5a, 0x94, 0x62, 0xd, 0xc8, 0xc9, 0x49, 0x19, 0x5, 0x7c, 0x69, 0xee, 0x13, 0x7b, 0xbb, 0xd0, 0xb4, 0xd4, 0xf5, 0x2d, 0x8e, 0x87, 0xe0, 0x60, 0x61, 0xc9, 0x35, 0x63, 0x75, 0xff, 0xa1, 0xd5, 0x4c, 0x27, 0xd9, 0x9e, 0xbc, 0x51, 0xea, 0x53, 0x7d, 0x93, 0xc, 0x42, 0xd4, 0x6c, 0x65, 0xa6, 0xf6, 0xf5, 0xdd, 0x2b, 0xba, 0xdb, 0xbd, 0x83, 0x8b, 0xa3, 0xb, 0xe3, 0xb3, 0x1, 0xf8, 0x73, 0xab, 0x4, 0x57, 0xe, 0xa0, 0x6, 0x22, 0x64, 0xef, 0x3f, 0xda, 0x48, 0x8, 0x2b, 0x4b, 0x66, 0xa6, 0xc7, 0x7e, 0x2, 0x9c, 0x20, 0x59, 0x78, 0x2e, 0x93, 0x11, 0x71, 0x5a, 0xb4, 0x4c, 0xf0, 0xf1, 0x9d, 0x7b, 0x51, 0x5a, 0x5f, 0x4d, 0x61, 0x71, 0x66, 0xd1, 0xcc, 0xd9, 0x30, 0x8f, 0x71, 0x88, 0xbb, 0x79, 0x83, 0x74, 0x88, 0x27, 0xf4, 0x7f, 0x55, 0x57, 0x27, 0xa0, 0x1c, 0xaa, 0x97, 0x16, 0xe8, 0xbd, 0xed, 0x2b, 0x52, 0x85, 0xf, 0x7c, 0x16, 0x44, 0x3c, 0x12, 0xf9, 0x40, 0x15, 0x36, 0x84, 0x35, 0xf4, 0x3c, 0x61, 0xac, 0xc3, 0x5a, 0xc3, 0x52, 0x9e, 0x89, 0xe0, 0x28, 0xf8, 0x5e, 0x21, 0x52, 0x88, 0xa, 0xa0, 0x56, 0xed, 0xce, 0x21, 0x63, 0x82, 0x80, 0x11, 0x51, 0x1c, 0xe2, 0x94, 0x90, 0x89, 0xa9, 0xd9, 0xd1, 0xc8, 0xfb, 0x52, 0x3c, 0x67, 0x39, 0x3a, 0xc8, 0x7e, 0xdf, 0xf0, 0x45, 0xaa, 0x11, 0xbd, 0x79, 0x79, 0xe, 0xc5, 0xc4, 0x48, 0xeb, 0xb, 0xfb, 0x67, 0xc6, 0x6a, 0x7d, 0xf1, 0x82, 0x2c, 0xaf, 0x16, 0x3e, 0xaa, 0x8b, 0x8f, 0xf7, 0x62, 0x7e, 0xa8, 0x4c, 0xf1, 0x7b, 0xc2, 0x31, 0xfd, 0x1, 0x33, 0x8b, 0xd0, 0xd5, 0x82, 0xe2, 0x3a, 0xb, 0x8d, 0xb2, 0xd3, 0xe6, 0x6a, 0x1e, 0x8d, 0xd6, 0xcb, 0xcb, 0xbb, 0xb9, 0xfc, 0xee, 0x97, 0x9d, 0xcb, 0xc6, 0x9f, 0x2e, 0xb6, 0x12, 0x70, 0xa2, 0x51, 0x4f, 0x9b, 0x2f, 0x79, 0x5f, 0x6c, 0x93, 0xa4, 0xcd, 0x9d, 0x25, 0x65, 0xb7, 0xf7, 0xe2, 0x3e, 0x99, 0x58, 0x2b, 0x86, 0x55, 0x39, 0x56, 0xd5, 0x57, 0x27, 0x54, 0x4a, 0x55, 0x89, 0xb6, 0x2e, 0x2f, 0x7b, 0x5e, 0x98, 0xd7, 0x7f, 0x58, 0xde, 0xcd, 0xbc, 0x76, 0x12, 0xb2, 0x97, 0x63, 0x73, 0x56, 0x97, 0x23, 0xea, 0x76, 0x81, 0xa, 0x5f, 0x54, 0xc1, 0xb1, 0xac, 0x51, 0xbe, 0x63, 0x4c, 0x49, 0x99, 0x25, 0xc7, 0xf5, 0x1a, 0xcf, 0xac, 0x58, 0xf8, 0xa5, 0xc1, 0x60, 0x3e, 0x9b, 0x5, 0x42, 0x9c, 0x7b, 0xdc, 0x79, 0xc6, 0x2f, 0xfe, 0xae, 0x2d, 0x26, 0x73, 0x60, 0x1b, 0x34, 0x1c, 0x34, 0x8e, 0xd8, 0x9a, 0x1f, 0xa, 0x10, 0x7f, 0xe1, 0x44, 0x43, 0x1e, 0x9f, 0x74, 0x3f, 0x59, 0x27, 0xd4, 0x7e, 0x7b, 0xfc, 0x28, 0x97, 0x80, 0xe9, 0xa, 0xf2, 0xd, 0x9b, 0x2d, 0xfd, 0xf0, 0xb, 0x72, 0xcc, 0xbd, 0xe7, 0x59, 0x33, 0x30, 0xf9, 0xfd, 0x84, 0xe1, 0xfb, 0xbd, 0xc1, 0xf7, 0xfb, 0x5, 0x9c, 0x27, 0xf1, 0xf, 0x9b, 0xa5, 0x7d, 0x59, 0x41, 0x43, 0x6d, 0xd4, 0x8f, 0xfc, 0x1f, 0xb0, 0x70, 0x8e, 0xac, 0xfe, 0x2, 0x66, 0x70, 0x7e, 0x7e, 0x78, 0x83, 0x6, 0x51, 0x85, 0xa2, 0xce, 0xf9, 0x5, 0x1, 0x65, 0x8e, 0xa9, 0x3f, 0xc0, 0xde, 0xc7, 0xf3, 0xfd, 0x69, 0x9b, 0xa2, 0x1e, 0xb7, 0xc, 0x6a, 0xa3, 0x1e, 0xfa, 0x97, 0x98, 0x58, 0x2c, 0x7f, 0xf8, 0xfe, 0x1d, 0x2, 0xa8, 0x2, 0xff, 0x53, 0x28, 0x44, 0x44, 0x42, 0x41, 0x45, 0x41, 0x41, 0x80, 0x43, 0xfb, 0x4f, 0x9, 0xa, 0x0, 0x8f, 0x4b, 0xcb, 0x83, 0x80, 0x27, 0xa5, 0x49, 0xc7, 0x2b, 0xad, 0x65, 0xe, 0xc4, 0xb7, 0x80, 0xb8, 0x87, 0xa4, 0x20, 0xd2, 0xd0, 0x83, 0xf8, 0x8a, 0x9b, 0x6e, 0x43, 0x53, 0x4b, 0x9a, 0xfb, 0xe7, 0xf7, 0x24, 0x65, 0xb4, 0x2d, 0x7, 0x16, 0xee, 0x3c, 0xd2, 0xf6, 0xc3, 0x8, 0x18, 0x34, 0x74, 0x3c, 0x4b, 0x7, 0x87, 0x16, 0xff, 0xa7, 0x42, 0x85, 0xf6, 0xfe, 0x9f, 0x9, 0xbe, 0x95, 0xa4, 0x1, 0x4a, 0x1, 0xa2, 0xb2, 0x5d, 0xd6, 0xda, 0x5c, 0x7c, 0xf6, 0xd6, 0x35, 0x5a, 0x1a, 0xfb, 0x87, 0xa4, 0x66, 0x2e, 0x32, 0xe, 0x97, 0xe3, 0xc4, 0xfb, 0x70, 0x25, 0x76, 0xd5, 0xc, 0x43, 0x2d, 0x8b, 0x81, 0x68, 0x22, 0xf6, 0xc0, 0x5a, 0x3, 0xb2, 0x75, 0xf2, 0x92, 0xc0, 0xc3, 0x39, 0xe6, 0x92, 0x39, 0xc6, 0x1, 0x49, 0x26, 0x7e, 0x4, 0x2d, 0x32, 0xf6, 0x68, 0x6, 0xc4, 0x2d, 0x62, 0xb4, 0x5b, 0x36, 0x94, 0x2e, 0xd6, 0x22, 0xaa, 0xb2, 0xf9, 0xbd, 0x37, 0x1a, 0x7c, 0x85, 0x50, 0xbb, 0x5b, 0x35, 0x2a, 0xb4, 0xd2, 0x7e, 0x40, 0xb0, 0x1a, 0x15, 0x2a, 0x22, 0x10, 0x15, 0x11, 0xde, 0xee, 0x56, 0xf2, 0x13, 0xd, 0x10, 0x95, 0xe6, 0x3f, 0x63, 0x38, 0xb8, 0xdd, 0xe0, 0xdb, 0xa7, 0x61, 0x8c, 0xe2, 0x39, 0x8f, 0xc4, 0x4f, 0x4d, 0x5, 0xd6, 0x8, 0x90, 0x12, 0xcc, 0x9, 0x36, 0x35, 0xfb, 0xf9, 0xa9, 0xc3, 0xd2, 0xa9, 0x46, 0x45, 0xff, 0x56, 0x6d, 0x7e, 0xcc, 0x90, 0xdf, 0x84, 0xd9, 0xb, 0x2b, 0x3e, 0x87, 0x79, 0x44, 0x68, 0x62, 0x89, 0x68, 0xc9, 0x58, 0xa3, 0xf5, 0x9e, 0x43, 0x4c, 0xfd, 0x6d, 0x5d, 0x89, 0x2e, 0xd, 0x8, 0x9e, 0xd, 0xb8, 0x2, 0x7, 0x7f, 0x1, 0x61, 0xd1, 0x9d, 0x23, 0x58, 0xc8, 0xe1, 0x8f, 0x5d, 0x58, 0xa6, 0x33, 0xe3, 0xa9, 0x11, 0xf4, 0x58, 0x34, 0xc2, 0xec, 0x20, 0xdb, 0xeb, 0x1, 0x4a, 0x6, 0x7e, 0xae, 0x11, 0x4a, 0x7a, 0xa6, 0x1f, 0x1c, 0xe6, 0x6f, 0xd3, 0x24, 0x99, 0xb3, 0xa1, 0xb8, 0xb6, 0x33, 0xe9, 0x9a, 0xdd, 0xe, 0xb6, 0x7f, 0x74, 0x94, 0xf0, 0xa2, 0x47, 0x1, 0xf8, 0x71, 0x22, 0xd5, 0x6e, 0x5b, 0x49, 0x72, 0xc2, 0x24, 0x3f, 0xf0, 0x65, 0x18, 0x61, 0x3a, 0x7f, 0x1, 0x8e, 0x93, 0x4b, 0x1a, 0x6a, 0xe4, 0xb3, 0x4b, 0xa7, 0xf1, 0x60, 0x9f, 0x32, 0xfc, 0xd2, 0x62, 0x21, 0x48, 0xf9, 0xe, 0xd2, 0x65, 0x71, 0xc0, 0x13, 0x6a, 0xe7, 0xd8, 0xfe, 0xfb, 0x81, 0xca, 0x60, 0xd7, 0xfd, 0x78, 0x8c, 0xb3, 0xa5, 0x5c, 0x4f, 0xd4, 0x5, 0x6f, 0x2b, 0xa7, 0xb5, 0xf0, 0x45, 0xb, 0xc9, 0x2f, 0x3c, 0x84, 0x8e, 0xd9, 0x7c, 0xda, 0x63, 0xb, 0xc6, 0xef, 0xd8, 0xd7, 0x84, 0xa5, 0xb6, 0x7e, 0xbc, 0xb0, 0xb6, 0xa0, 0x60, 0xf2, 0xba, 0xfd, 0x29, 0xa3, 0xf7, 0x6b, 0x5c, 0x13, 0xe3, 0x46, 0x60, 0xae, 0x1a, 0xf6, 0x49, 0x8a, 0xcd, 0x99, 0xe4, 0xd8, 0x3c, 0x90, 0x6f, 0xc5, 0x3b, 0x98, 0xff, 0xea, 0x91, 0x1f, 0x3, 0xaa, 0x14, 0xb8, 0x82, 0x17, 0xc8, 0xfb, 0x49, 0x18, 0xb0, 0xf9, 0x9d, 0x5b, 0xe7, 0x76, 0xe5, 0x9b, 0x95, 0xa5, 0xf, 0x1e, 0xfe, 0xbf, 0xb8, 0x3f, 0x70, 0x44, 0xba, 0x8e, 0xcc, 0xf, 0xab, 0xcd, 0xc5, 0x8c, 0xd8, 0x32, 0x5e, 0x99, 0xae, 0x52, 0x5c, 0x5f, 0x61, 0x3f, 0xa, 0x4c, 0x45, 0x6, 0x68, 0xcc, 0x99, 0xc5, 0xe5, 0x15, 0x4a, 0xd5, 0x18, 0x60, 0x21, 0x7b, 0x7a, 0x9b, 0x48, 0x7b, 0x5d, 0x28, 0x7c, 0x8, 0x73, 0x2f, 0x40, 0x48, 0x71, 0x15, 0xdc, 0x7c, 0x8c, 0x99, 0xc2, 0xc3, 0x57, 0xa9, 0xc3, 0xdc, 0x24, 0x37, 0x70, 0x4b, 0xac, 0xd1, 0xc4, 0x86, 0x4e, 0x24, 0x5e, 0x5f, 0x56, 0x90, 0xf7, 0x40, 0xa6, 0x38, 0x31, 0xa4, 0x3e, 0x2c, 0xb, 0xc8, 0xa8, 0xd8, 0x5, 0xb2, 0x69, 0x2c, 0x8f, 0x41, 0xdc, 0x61, 0x64, 0x43, 0x8e, 0x46, 0x94, 0x27, 0xf9, 0x28, 0x72, 0x92, 0xd8, 0x37, 0xd0, 0xc3, 0x5d, 0x8f, 0x48, 0x83, 0x98, 0x6a, 0x4, 0xae, 0xea, 0xa4, 0x55, 0x96, 0xaa, 0xb, 0xb0, 0x57, 0x27, 0x5a, 0xc7, 0xad, 0x9d, 0x9e, 0x24, 0xba, 0xa0, 0xe8, 0xf5, 0xfe, 0xd5, 0x92, 0x1d, 0xb5, 0x9d, 0x7c, 0xf0, 0x98, 0xcf, 0x9d, 0xe9, 0xd2, 0x3c, 0x4, 0x39, 0xd3, 0x6c, 0xbc, 0xd6, 0x96, 0x58, 0xc8, 0x10, 0xd9, 0x27, 0xe6, 0x85, 0x84, 0x36, 0x50, 0xa3, 0xeb, 0xf3, 0x70, 0xb5, 0x2a, 0x89, 0x16, 0x49, 0xa7, 0x20, 0x24, 0xd8, 0xf5, 0x2f, 0x80, 0xaf, 0xf9, 0x43, 0xd7, 0xc9, 0x67, 0xb3, 0x9d, 0xb3, 0xd3, 0x1a, 0x5e, 0x3, 0x2f, 0xa7, 0x84, 0x8f, 0x5, 0xbd, 0xdd, 0xe1, 0x22, 0x79, 0x5c, 0xa1, 0x1d, 0xcb, 0xce, 0x58, 0xee, 0x42, 0xf5, 0x2d, 0x6b, 0xad, 0xf8, 0xa5, 0x25, 0x14, 0xfd, 0xf0, 0xb4, 0x34, 0x9c, 0xf1, 0xaf, 0x7d, 0x57, 0x19, 0xb6, 0xd3, 0x29, 0x7c, 0x76, 0x63, 0xa8, 0x85, 0x27, 0xa0, 0x4, 0x24, 0x72, 0x9b, 0x84, 0xd4, 0x3d, 0x12, 0x2d, 0x4e, 0x3a, 0xc8, 0x65, 0xcd, 0x15, 0x8d, 0xac, 0x85, 0x3c, 0x83, 0x44, 0xa4, 0x4f, 0xa8, 0x50, 0xfe, 0xd, 0xda, 0x81, 0x44, 0xf9, 0x8a, 0xdd, 0xd5, 0x41, 0xa1, 0x75, 0x37, 0x96, 0x1a, 0xe8, 0xc5, 0x6b, 0x2b, 0x1c, 0x1d, 0x1a, 0x3d, 0x1, 0xa4, 0xdf, 0x24, 0xa9, 0x78, 0x67, 0xc9, 0x58, 0x78, 0x89, 0x77, 0x54, 0x32, 0x6d, 0x7d, 0xb2, 0x1f, 0xe3, 0xbf, 0x43, 0x83, 0xf4, 0x7e, 0x50, 0xe7, 0x8a, 0x63, 0xdd, 0xec, 0xa0, 0x92, 0x32, 0x61, 0xb1, 0x7, 0x6a, 0xa6, 0x50, 0xe6, 0x2d, 0x36, 0x44, 0x70, 0x31, 0x5, 0xc2, 0x74, 0x75, 0xd0, 0xec, 0xa9, 0x60, 0x67, 0xad, 0xfe, 0xb5, 0x7f, 0x9f, 0x8f, 0xa2, 0x99, 0x14, 0x8d, 0x5e, 0xb7, 0xe4, 0xef, 0xf0, 0xce, 0x47, 0x67, 0x88, 0x76, 0x26, 0xa9, 0x85, 0x44, 0x9, 0xbf, 0x3c, 0xce, 0xe6, 0xe5, 0xee, 0x7b, 0xc7, 0x56, 0xfa, 0x28, 0xfc, 0x3c, 0xd1, 0xda, 0x4a, 0xc1, 0xc0, 0x3b, 0xd, 0xf9, 0x8c, 0x79, 0xd4, 0xaf, 0x59, 0x12, 0xf, 0x9f, 0xf3, 0x64, 0xf3, 0x2, 0x94, 0xc7, 0x12, 0x9f, 0x8b, 0xc8, 0x9e, 0xcf, 0x22, 0x7, 0xea, 0xca, 0x9c, 0x1e, 0xfe, 0xa4, 0xbb, 0x48, 0x5c, 0xe3, 0x8a, 0xf6, 0xf7, 0x9d, 0xf6, 0x66, 0x26, 0x6c, 0xe5, 0x5a, 0xf, 0xc8, 0x43, 0x3d, 0xe9, 0x64, 0xc9, 0x8e, 0xa9, 0x16, 0x70, 0xb8, 0xcc, 0x69, 0xf, 0xf5, 0x8c, 0xea, 0xbb, 0xb3, 0x94, 0x30, 0x9e, 0xf5, 0x12, 0xe6, 0xbd, 0x39, 0xc5, 0x2c, 0x43, 0x7f, 0xfd, 0x61, 0xe3, 0xb9, 0xbb, 0xd3, 0x73, 0xbd, 0xd2, 0xf8, 0x5c, 0xa6, 0x76, 0x10, 0x52, 0x68, 0x18, 0x27, 0xfd, 0x35, 0x69, 0xf4, 0x99, 0x8d, 0x15, 0xe1, 0x1c, 0xc5, 0x31, 0x78, 0x2a, 0xdd, 0xda, 0x66, 0x27, 0x51, 0x71, 0xf8, 0xca, 0x3e, 0x58, 0xe4, 0x4a, 0xc, 0xa, 0x1b, 0x5f, 0x17, 0xd5, 0x9c, 0xb4, 0x9e, 0x5b, 0x8f, 0x4d, 0x86, 0xe2, 0x7a, 0x32, 0x4a, 0x74, 0x40, 0x5d, 0xbe, 0xa2, 0x1a, 0x8a, 0xa9, 0x90, 0x60, 0x5a, 0xc4, 0x3, 0x88, 0x65, 0x79, 0x8, 0xc2, 0x8a, 0x9, 0xcc, 0x90, 0xc0, 0x1a, 0xdb, 0xb8, 0xdb, 0xf2, 0xc6, 0x6b, 0x7f, 0xb0, 0xe4, 0xa9, 0x45, 0x6e, 0xa5, 0x6f, 0x85, 0xc9, 0xbc, 0x80, 0xec, 0x84, 0xc4, 0x44, 0x8, 0xd3, 0x89, 0xcc, 0x3a, 0x70, 0x60, 0x82, 0xd3, 0xd7, 0x8f, 0xe9, 0x92, 0x28, 0x96, 0xb6, 0xb6, 0xfa, 0x1f, 0x6e, 0x58, 0x88, 0xd, 0x4f, 0xb3, 0xf6, 0xfc, 0xf1, 0xe, 0xd4, 0x21, 0x35, 0xca, 0x97, 0x64, 0xa3, 0xa2, 0x1e, 0x10, 0x18, 0x5, 0x4d, 0x1e, 0xbc, 0xd9, 0x4a, 0xb6, 0x96, 0xc9, 0x51, 0xf9, 0x76, 0xaa, 0xd0, 0x96, 0x75, 0xb5, 0x6a, 0x81, 0xcf, 0x27, 0xa, 0x7f, 0xf6, 0xf, 0x18, 0xf2, 0x16, 0x82, 0x96, 0x8, 0xb0, 0x70, 0xa7, 0x2, 0xbd, 0x2f, 0x2, 0xa9, 0x56, 0xae, 0xa4, 0xc7, 0xd8, 0x78, 0xd2, 0xe2, 0x88, 0x1d, 0xd9, 0x29, 0xfc, 0x60, 0xcc, 0x92, 0x0, 0x3a, 0xd, 0x4e, 0xb7, 0xe5, 0x9, 0xc2, 0x9e, 0xfd, 0x20, 0xcb, 0xaf, 0x4c, 0xcd, 0x69, 0x79, 0x27, 0x5a, 0xd, 0x11, 0x60, 0x32, 0x41, 0xd6, 0xc6, 0x13, 0xaf, 0xe, 0xe9, 0x4, 0x6f, 0xd, 0x75, 0x1c, 0xb3, 0x79, 0x11, 0xd3, 0x77, 0x73, 0x6a, 0xa8, 0x1e, 0x46, 0x9d, 0xa, 0xbe, 0x39, 0x60, 0x23, 0x93, 0x3, 0xcf, 0x97, 0xee, 0xd8, 0x78, 0xa5, 0xe0, 0xa9, 0x19, 0xee, 0x9f, 0xac, 0x77, 0x2d, 0xf8, 0x50, 0x3a, 0x1b, 0xb1, 0x64, 0x9e, 0x12, 0xe7, 0xd3, 0x29, 0x2c, 0xbd, 0xdf, 0xe0, 0xe2, 0x97, 0xfc, 0x4a, 0xd6, 0x60, 0xa, 0x90, 0xfc, 0x63, 0x55, 0x94, 0x7b, 0x14, 0x85, 0x5f, 0xba, 0xef, 0xca, 0x74, 0x3c, 0x39, 0x47, 0xc2, 0xe9, 0xba, 0x9b, 0xcf, 0xb2, 0x69, 0xc4, 0x4c, 0xda, 0x95, 0x52, 0x9e, 0x53, 0x84, 0x8b, 0x4b, 0x9e, 0xec, 0x67, 0x4, 0x30, 0x76, 0x5a, 0x3e, 0x7f, 0xbe, 0x79, 0xbb, 0xbf, 0xbd, 0x3, 0x16, 0xa8, 0x9f, 0xb, 0xb2, 0x33, 0xd5, 0xdb, 0x59, 0xf5, 0x94, 0xe6, 0x48, 0xe5, 0x3e, 0xcb, 0x12, 0xd7, 0xbe, 0x8a, 0x83, 0x44, 0x6e, 0x6b, 0x66, 0x5e, 0x6, 0xb7, 0x40, 0x1c, 0xbd, 0x1b, 0x56, 0xfb, 0x3a, 0xb6, 0x13, 0xbe, 0x81, 0xab, 0xd7, 0xe1, 0x99, 0x76, 0x40, 0xda, 0x26, 0xa6, 0xb6, 0xdc, 0xed, 0x17, 0xde, 0x64, 0x2f, 0xac, 0x2f, 0xac, 0xbd, 0xa9, 0x13, 0xd2, 0xbf, 0x90, 0xa4, 0xed, 0x15, 0xb, 0x2f, 0x6c, 0xbe, 0x4b, 0xd0, 0x78, 0x97, 0xfe, 0xde, 0xda, 0x49, 0x79, 0x74, 0x66, 0x15, 0x57, 0x4, 0x6f, 0xd, 0xca, 0x7a, 0x9a, 0x86, 0xdd, 0x53, 0x14, 0xbe, 0x79, 0xda, 0xda, 0x91, 0x98, 0xfb, 0x2e, 0x72, 0x63, 0x6d, 0xa0, 0x33, 0xc7, 0x4d, 0xfb, 0xb8, 0xef, 0xb6, 0x86, 0x92, 0x61, 0x10, 0x5, 0xb5, 0x8b, 0x20, 0x66, 0xf9, 0x1b, 0xbe, 0x8c, 0x13, 0x58, 0x4c, 0x66, 0x68, 0x9a, 0x92, 0x3a, 0x51, 0x2e, 0xe2, 0x9d, 0x8, 0xdc, 0x1d, 0x44, 0x80, 0xd, 0x44, 0x10, 0x85, 0x5d, 0x5d, 0x8a, 0x6b, 0x67, 0x33, 0xa1, 0x4d, 0xfc, 0x88, 0xdf, 0x77, 0x62, 0x2, 0x17, 0x78, 0xf5, 0x5, 0xb3, 0x45, 0x6c, 0x76, 0x49, 0x2f, 0xc1, 0x79, 0x45, 0x5d, 0xd8, 0x70, 0xbe, 0x64, 0xe5, 0xec, 0xbc, 0x44, 0x45, 0x3c, 0x3f, 0xaf, 0xcf, 0x39, 0x4b, 0x9a, 0xbe, 0xf4, 0xd3, 0x95, 0xcb, 0x57, 0xc, 0xa6, 0xb6, 0xba, 0x4, 0xb4, 0x8c, 0x5, 0xc2, 0xf2, 0x65, 0xe8, 0xe6, 0xa7, 0xdb, 0x16, 0xe7, 0x65, 0x97, 0x4e, 0x23, 0x8f, 0x78, 0x64, 0xe2, 0x4f, 0x31, 0x82, 0xdd, 0x83, 0x97, 0x45, 0xf2, 0xf9, 0xeb, 0xde, 0x26, 0x5e, 0x2e, 0xf9, 0xf5, 0x15, 0x51, 0xea, 0x1f, 0xf8, 0xcd, 0xfb, 0xdb, 0x12, 0x78, 0xb1, 0x22, 0x17, 0xb5, 0x15, 0x3d, 0x9e, 0xab, 0xfb, 0x7f, 0x4d, 0x92, 0x5c, 0x52, 0xfe, 0x4e, 0x3f, 0xcd, 0x3f, 0x20, 0xd5, 0x91, 0x23, 0x79, 0xa, 0x18, 0xc7, 0x22, 0xca, 0xee, 0xee, 0x2a, 0x6c, 0x2e, 0x7c, 0xf, 0xbe, 0xfb, 0x62, 0xfc, 0x8d, 0x7d, 0xdd, 0x88, 0xfc, 0x1b, 0x5e, 0x8c, 0xbc, 0xe5, 0xda, 0xd3, 0x2e, 0x8a, 0x91, 0x27, 0x26, 0xe5, 0xa6, 0x1b, 0xda, 0xa6, 0x2a, 0x8b, 0x9d, 0x46, 0xf, 0x1d, 0x57, 0x3c, 0x19, 0x6a, 0x5c, 0x7c, 0x9b, 0x36, 0x82, 0xe9, 0x1a, 0x7e, 0xf6, 0x6e, 0xab, 0xb1, 0x7a, 0x2d, 0x30, 0xb, 0x27, 0x4e, 0x2f, 0x8d, 0x8c, 0xee, 0x45, 0xbb, 0xbb, 0xad, 0x36, 0x44, 0xb4, 0xed, 0x53, 0x37, 0xfb, 0xd0, 0x84, 0x9a, 0x26, 0xb4, 0xad, 0xd9, 0xde, 0x3, 0x99, 0xb8, 0xf2, 0xa7, 0x3e, 0x9f, 0xfd, 0xfe, 0xbb, 0x84, 0x6e, 0x36, 0x9e, 0xef, 0x67, 0x1d, 0x69, 0x97, 0xf9, 0x8a, 0x6b, 0x57, 0xce, 0x95, 0x60, 0xdf, 0x7c, 0x8, 0x81, 0x95, 0xff, 0x62, 0xb8, 0xd2, 0x1c, 0x2, 0xaa, 0x53, 0x17, 0xb9, 0xdd, 0x96, 0x13, 0xca, 0xfb, 0xe5, 0xf5, 0x75, 0xcf, 0x2e, 0x15, 0x85, 0xf1, 0xad, 0xaf, 0x36, 0x72, 0x68, 0xe1, 0x21, 0xee, 0xcb, 0x5d, 0x14, 0xd8, 0xf, 0x79, 0x75, 0x8f, 0x1b, 0x88, 0x93, 0x3, 0x8b, 0xb2, 0xd6, 0xb8, 0x65, 0xe0, 0x47, 0xbd, 0xc2, 0x34, 0x38, 0x78, 0x37, 0x84, 0x97, 0x88, 0x94, 0x62, 0xfb, 0xa5, 0xae, 0x42, 0x3c, 0x34, 0x8e, 0x48, 0x4e, 0x79, 0xe2, 0x21, 0x17, 0xb2, 0x34, 0x3, 0xa1, 0xf2, 0x75, 0xad, 0x66, 0x5f, 0x9e, 0x31, 0xe8, 0x8d, 0xb7, 0x72, 0xfe, 0x3b, 0xaa, 0xae, 0xe8, 0xd7, 0xd5, 0x24, 0x31, 0x1d, 0x69, 0x9, 0x8b, 0x10, 0xc5, 0x75, 0xf2, 0xf9, 0xb1, 0x2b, 0x1e, 0xd, 0xd5, 0xf8, 0x31, 0x75, 0x2c, 0x37, 0xdf, 0x70, 0x7b, 0x4, 0x8c, 0x69, 0x75, 0xa4, 0x2b, 0x32, 0xbe, 0x70, 0xbf, 0xe, 0x42, 0xf9, 0xb1, 0xdf, 0x1b, 0x3d, 0xda, 0xfc, 0x5f, 0xe8, 0xe8, 0x15, 0x61, 0x32, 0xb1, 0x20, 0x1a, 0xc9, 0x16, 0xb8, 0x5f, 0xa, 0x24, 0xb4, 0x2c, 0xf6, 0x62, 0xb4, 0xf3, 0x7f, 0x8e, 0x10, 0xe, 0xaf, 0x7, 0xd, 0x67, 0x7d, 0xeb, 0x36, 0xba, 0x39, 0xe5, 0x31, 0x3b, 0x3, 0x49, 0xb1, 0xf4, 0xd6, 0xe2, 0xeb, 0x7f, 0x1f, 0xbe, 0xf0, 0xae, 0xdd, 0x72, 0x9, 0x7a, 0xf8, 0x86, 0xe7, 0xae, 0x8, 0xff, 0x14, 0xf8, 0x44, 0x86, 0x27, 0xcb, 0x1d, 0x5f, 0x17, 0x27, 0x37, 0x74, 0xa3, 0xa0, 0xb9, 0x42, 0x12, 0xdd, 0xdd, 0xdc, 0x9a, 0x4d, 0xb7, 0xa7, 0xfd, 0xf9, 0xf0, 0xf3, 0x72, 0x29, 0xae, 0x83, 0xc5, 0x35, 0xae, 0x90, 0xc9, 0xbb, 0x5c, 0xda, 0x65, 0xb, 0x1a, 0xcc, 0x62, 0x2a, 0xa7, 0x2a, 0xe2, 0x83, 0x64, 0x9e, 0x13, 0xda, 0x75, 0xd6, 0xe2, 0x5a, 0xab, 0xb8, 0x6f, 0x4f, 0x73, 0x75, 0x68, 0xb8, 0x21, 0x7f, 0x1, 0xa8, 0xc8, 0x3c, 0x65, 0x60, 0xfa, 0xf8, 0x6, 0x2a, 0xc, 0xc3, 0x32, 0xa2, 0xe, 0x67, 0xa1, 0x78, 0xc6, 0xd3, 0x25, 0xae, 0x28, 0x95, 0x4f, 0x17, 0xf4, 0x65, 0xe7, 0x49, 0xd1, 0x4f, 0x3b, 0x12, 0xe, 0x9d, 0xbe, 0x8b, 0x29, 0xf, 0x65, 0x94, 0x65, 0x8b, 0x29, 0x37, 0xa, 0xb, 0x58, 0x4c, 0x77, 0xdd, 0x59, 0xe4, 0xd5, 0xf2, 0x33, 0x1a, 0xb3, 0x7e, 0xf, 0x9a, 0x71, 0x18, 0x31, 0xe2, 0x68, 0x5, 0xab, 0x6c, 0xe7, 0xa3, 0x95, 0x63, 0x4c, 0xd2, 0xf3, 0x4b, 0xe2, 0x8e, 0x0, 0xe5, 0x96, 0xae, 0xe7, 0x4, 0x14, 0x9d, 0x63, 0x1, 0x8d, 0x85, 0x7c, 0xb7, 0x24, 0xc7, 0xb2, 0xea, 0x17, 0x64, 0x8a, 0x1f, 0xfc, 0xcc, 0xb2, 0xbe, 0xc2, 0xd7, 0xd1, 0x79, 0xd, 0x14, 0xd9, 0x75, 0x22, 0xed, 0x46, 0x85, 0xd2, 0xc7, 0xcb, 0x7, 0x10, 0x92, 0x7, 0x15, 0xf5, 0xa5, 0x30, 0x79, 0xe1, 0x82, 0x3d, 0x8a, 0x45, 0x35, 0xcf, 0x83, 0x2c, 0x95, 0x2a, 0x7, 0x9e, 0x3b, 0xbb, 0x5d, 0x4f, 0xd3, 0xed, 0xe9, 0x23, 0x5b, 0x62, 0x53, 0xbb, 0xde, 0x3c, 0x30, 0x31, 0xc9, 0x5f, 0x40, 0x49, 0x82, 0x2a, 0xb3, 0xa6, 0x4, 0xbb, 0xd4, 0x6f, 0x96, 0x30, 0x11, 0x2f, 0xcd, 0x4d, 0xba, 0xe3, 0x62, 0xaf, 0x12, 0xb7, 0x11, 0x60, 0x7c, 0x80, 0x6e, 0x51, 0x4b, 0xa0, 0x50, 0x39, 0xcc, 0x26, 0xe1, 0x38, 0x81, 0xdd, 0x11, 0x1c, 0x99, 0xb8, 0x33, 0x73, 0x6e, 0xe7, 0x4f, 0xeb, 0xfd, 0x4c, 0xaa, 0x14, 0xeb, 0xad, 0xce, 0x58, 0x66, 0x81, 0xc, 0xba, 0x33, 0xa, 0x45, 0xa4, 0x68, 0xc, 0x9d, 0x5d, 0xf9, 0x62, 0x44, 0xa5, 0x6c, 0x79, 0x72, 0x21, 0x2d, 0x27, 0x4a, 0xa5, 0x6d, 0x29, 0x48, 0xb9, 0x7, 0x5d, 0x28, 0x98, 0x36, 0x86, 0xf6, 0x2f, 0xa4, 0x45, 0xd0, 0x5d, 0xad, 0x78, 0x66, 0x16, 0xa6, 0x75, 0x39, 0xd3, 0x7d, 0xce, 0xc6, 0x55, 0x40, 0x2a, 0xb7, 0x1, 0x27, 0x52, 0xe2, 0xa7, 0xa5, 0x8b, 0xdc, 0xf3, 0xc3, 0xd, 0xed, 0x95, 0x44, 0x4c, 0xea, 0x51, 0xe2, 0xd7, 0x50, 0x84, 0x25, 0x77, 0x1b, 0x97, 0x69, 0xa1, 0x27, 0xd0, 0xfe, 0x62, 0x80, 0x92, 0xba, 0x6d, 0x22, 0xd8, 0xb5, 0xab, 0x3f, 0x5d, 0xe7, 0x2f, 0xd2, 0xb9, 0xe4, 0xcd, 0xf2, 0x1, 0xb9, 0x40, 0x4d, 0x8, 0x48, 0x7f, 0x1, 0x5e, 0xf7, 0x15, 0x9, 0xc4, 0x94, 0xa, 0x58, 0x99, 0xeb, 0xce, 0x3c, 0xbc, 0xe3, 0xdf, 0x67, 0x90, 0x25, 0x5c, 0xac, 0x66, 0xfb, 0x49, 0xb6, 0x19, 0xc4, 0xa2, 0x87, 0xbe, 0x3c, 0x9e, 0xf2, 0xff, 0x18, 0x52, 0x6b, 0xa4, 0x47, 0x80, 0xc6, 0x74, 0xdf, 0x43, 0xa, 0xed, 0x71, 0x26, 0x43, 0x33, 0xce, 0x53, 0x6e, 0x52, 0xbb, 0x2e, 0x84, 0x49, 0xc2, 0xae, 0xdd, 0x1c, 0x1e, 0x3, 0xd5, 0xd2, 0x10, 0xa5, 0xe8, 0xc9, 0x55, 0xbe, 0x7b, 0x9d, 0x4f, 0x1, 0xb1, 0xc3, 0xfa, 0xba, 0x29, 0xf2, 0x3d, 0x1c, 0xa, 0x5a, 0x20, 0x64, 0x4d, 0x90, 0xce, 0x9d, 0x75, 0x6d, 0x50, 0xce, 0xb9, 0x36, 0x66, 0xf0, 0xbe, 0x9b, 0xfb, 0xd2, 0xbb, 0xcb, 0x8d, 0x8b, 0xa2, 0x39, 0xc4, 0x48, 0xdb, 0xe4, 0x25, 0xb3, 0x84, 0xcf, 0x83, 0x78, 0xad, 0xa, 0xdf, 0x93, 0x2a, 0xdf, 0xc5, 0xce, 0xa9, 0xbc, 0x65, 0x5f, 0xa7, 0x29, 0xdb, 0x64, 0xe4, 0x17, 0xa0, 0x6f, 0xf1, 0x26, 0x1, 0x4b, 0x6e, 0x98, 0x3d, 0x6a, 0xe6, 0x3c, 0xc3, 0x36, 0x60, 0x5, 0xa7, 0xe3, 0xbd, 0xb6, 0x76, 0xac, 0x19, 0x67, 0xbf, 0xcb, 0x1d, 0xc9, 0x8b, 0x7c, 0x42, 0xa4, 0x17, 0x87, 0x45, 0x91, 0xbe, 0x2a, 0xbf, 0xf, 0x8d, 0xb, 0xe, 0xce, 0xa4, 0xb0, 0x29, 0xc0, 0x60, 0x97, 0xdf, 0x84, 0x6c, 0x25, 0xa6, 0x51, 0x73, 0xc2, 0x16, 0x67, 0xc, 0xc8, 0x43, 0x60, 0x8e, 0x61, 0xbd, 0x11, 0xa5, 0x7f, 0x1, 0x99, 0xc7, 0xdd, 0x4a, 0xe3, 0xc1, 0x99, 0x9, 0xd1, 0x7e, 0x7c, 0xcc, 0x1e, 0xf2, 0x93, 0xf6, 0x2b, 0x5e, 0x54, 0x5b, 0x9e, 0x5b, 0xb4, 0x70, 0x24, 0x52, 0x33, 0x5e, 0xa6, 0x17, 0xa, 0x97, 0xad, 0xa5, 0x86, 0xc2, 0x26, 0xde, 0x65, 0xcc, 0xf8, 0x3f, 0x7, 0x3d, 0xb1, 0xc0, 0x5b, 0x4f, 0xb6, 0xd3, 0x69, 0xc2, 0xce, 0xb6, 0x11, 0x62, 0xac, 0xed, 0x96, 0x5, 0x1f, 0xf0, 0xbb, 0x6a, 0x1e, 0x4c, 0x95, 0x3, 0xed, 0x4c, 0x1, 0x43, 0x98, 0xd6, 0x32, 0x16, 0x7b, 0xf7, 0x57, 0x3a, 0x7d, 0xae, 0x5, 0xe4, 0xe, 0xfc, 0x61, 0x7f, 0x1, 0xb9, 0x4d, 0xb8, 0xc4, 0x79, 0xad, 0xbe, 0xe0, 0x77, 0xea, 0x6c, 0x77, 0xa5, 0x8, 0xea, 0xe, 0x63, 0x8e, 0xa2, 0x2f, 0x5b, 0x7a, 0x6e, 0xae, 0x47, 0x97, 0x7f, 0x1, 0xbd, 0x82, 0xea, 0x4b, 0x34, 0x33, 0xe4, 0x2b, 0x26, 0x5, 0x8, 0x24, 0x52, 0xdb, 0xf, 0xc0, 0x8a, 0x6d, 0xfc, 0x8b, 0x27, 0xd8, 0x6b, 0x9, 0xc1, 0x61, 0x5, 0x75, 0x75, 0xbe, 0xe3, 0x2b, 0x2b, 0x7, 0x62, 0xc0, 0x9d, 0x6f, 0xd7, 0x74, 0x22, 0xa, 0x9, 0xe1, 0xe5, 0xce, 0xb, 0x38, 0x54, 0xa8, 0x27, 0xe7, 0x1e, 0xf7, 0xce, 0x25, 0x79, 0xc9, 0x43, 0xbb, 0x4a, 0x81, 0x14, 0x1, 0x2b, 0xaa, 0xc4, 0x70, 0xfa, 0x9c, 0x82, 0x16, 0xca, 0x58, 0x8b, 0xeb, 0x51, 0x62, 0xe6, 0xf6, 0x5, 0xb4, 0x5b, 0x3a, 0x1d, 0xff, 0x70, 0x45, 0xb, 0x5c, 0xff, 0xb0, 0x4f, 0x98, 0x2d, 0xf8, 0x21, 0x4e, 0x25, 0xf2, 0xe6, 0x1a, 0x6a, 0x33, 0xd9, 0xee, 0xad, 0xdd, 0x19, 0x95, 0x39, 0x30, 0xb3, 0xd4, 0xd5, 0x96, 0xe9, 0x2e, 0xe8, 0x1d, 0x86, 0xf2, 0x6e, 0xf6, 0xba, 0x88, 0xf3, 0x72, 0xf, 0xf0, 0x2c, 0x2d, 0x58, 0xbe, 0x20, 0x94, 0x27, 0x96, 0xe4, 0xa4, 0x9d, 0x3b, 0xb2, 0x6, 0x45, 0x11, 0xb8, 0x3f, 0xe, 0x59, 0x68, 0xf5, 0xd8, 0xb4, 0xba, 0xd0, 0xb5, 0x47, 0x1e, 0xc1, 0x8a, 0x57, 0xf2, 0x16, 0x4c, 0xea, 0xf1, 0x7a, 0x5d, 0xc9, 0xeb, 0x25, 0x72, 0x57, 0x52, 0x47, 0x2f, 0x14, 0x90, 0xc7, 0x5b, 0x10, 0x8e, 0xd6, 0x58, 0x1b, 0x48, 0xd4, 0x3b, 0x14, 0xef, 0x23, 0x95, 0x6a, 0x88, 0x6c, 0x10, 0x66, 0xfd, 0x3c, 0x3d, 0x7f, 0xc5, 0x2c, 0x15, 0xbc, 0x4d, 0xe4, 0x4f, 0xef, 0x53, 0xa6, 0x83, 0xb1, 0x55, 0xeb, 0xe3, 0xee, 0x68, 0xde, 0xd5, 0x9d, 0x84, 0x39, 0xdf, 0x33, 0x27, 0xb, 0xb9, 0xc9, 0x25, 0xa6, 0x8c, 0xa2, 0x62, 0x24, 0x4d, 0x2, 0x2b, 0x58, 0xa6, 0x4a, 0x80, 0x4d, 0x74, 0x4c, 0xca, 0x74, 0xf5, 0x4c, 0x3, 0x79, 0x8d, 0x76, 0x4f, 0xc5, 0xb8, 0xe2, 0x3a, 0x38, 0xf5, 0xcd, 0x4d, 0x89, 0x43, 0x34, 0xa7, 0xcb, 0xf4, 0x85, 0x99, 0xcf, 0x2f, 0xc5, 0xed, 0x21, 0x8, 0x2, 0xb6, 0x67, 0x72, 0x86, 0xa3, 0x8d, 0xba, 0xd9, 0x4e, 0xf6, 0x6c, 0xcf, 0x24, 0xef, 0xee, 0x73, 0x8a, 0x85, 0x11, 0xd2, 0xbd, 0x63, 0x89, 0x6b, 0x7f, 0x44, 0x87, 0xa, 0xe6, 0x6a, 0xd3, 0xdb, 0xda, 0x8a, 0xe5, 0xce, 0x38, 0x79, 0xc5, 0x21, 0x40, 0xe3, 0xc4, 0x50, 0x83, 0xd7, 0x84, 0x91, 0xf3, 0x4a, 0x3c, 0x5a, 0xe2, 0x2c, 0x1b, 0x38, 0xa9, 0xab, 0x7b, 0x72, 0x36, 0xd7, 0x56, 0xbc, 0xab, 0x98, 0x4c, 0xb6, 0xee, 0x85, 0x2f, 0xba, 0xbd, 0x80, 0x3f, 0x69, 0x15, 0x51, 0xe1, 0xbc, 0x13, 0x9a, 0x5d, 0x5a, 0xf2, 0x7e, 0x1d, 0xc5, 0xbf, 0x8d, 0x50, 0x14, 0xfc, 0x3e, 0xe5, 0x54, 0xb4, 0x77, 0x13, 0x96, 0x29, 0xcb, 0x5f, 0x0, 0x4b, 0x22, 0x62, 0x7a, 0x15, 0x9d, 0xb8, 0x3a, 0x33, 0xf, 0xff, 0x18, 0x44, 0x43, 0x6e, 0x2d, 0xfa, 0x52, 0x4e, 0xde, 0x51, 0x78, 0xa6, 0xc6, 0xa0, 0xfd, 0x0, 0xb6, 0xbd, 0x37, 0x84, 0xaf, 0xd4, 0x59, 0xbd, 0x31, 0x31, 0xc3, 0xe9, 0x54, 0xb5, 0x7d, 0x65, 0xc5, 0xad, 0x79, 0x25, 0xc, 0x9d, 0x9c, 0xc1, 0x40, 0xa2, 0xa7, 0xa4, 0x4d, 0x99, 0xf2, 0x4e, 0xb3, 0x20, 0xaf, 0xfe, 0xd5, 0xbd, 0x18, 0x67, 0xca, 0x84, 0x3a, 0x82, 0x8a, 0x6c, 0x4, 0x3d, 0x53, 0xa0, 0xca, 0x32, 0xb2, 0x34, 0x1d, 0x55, 0x4c, 0x31, 0x38, 0xe0, 0x9f, 0xbb, 0x10, 0xba, 0xc0, 0xc, 0x14, 0xe5, 0xbc, 0xfc, 0xcd, 0x0, 0x47, 0xf, 0xd7, 0x23, 0x18, 0xa0, 0x11, 0x2f, 0x90, 0x17, 0x2c, 0x52, 0x7c, 0xba, 0xc5, 0x24, 0x7c, 0x31, 0xbc, 0xbe, 0x2c, 0x68, 0x15, 0x78, 0x63, 0xbf, 0x51, 0x99, 0x66, 0x25, 0x4b, 0x1b, 0xbd, 0x61, 0x39, 0x38, 0x7a, 0xbb, 0xd5, 0x53, 0x38, 0xd3, 0x9a, 0x6c, 0x66, 0x33, 0xef, 0xbd, 0x22, 0x6e, 0xdc, 0x50, 0x94, 0x53, 0xea, 0xf9, 0xc1, 0x32, 0x8e, 0xdf, 0xde, 0xc3, 0x5e, 0x14, 0x7e, 0x4c, 0x36, 0x2c, 0x98, 0x8f, 0x69, 0x6c, 0xe9, 0x4a, 0x1a, 0x6b, 0xf0, 0x36, 0xd6, 0xed, 0x75, 0x37, 0x17, 0x7c, 0x9d, 0x9, 0xda, 0xf, 0x39, 0x3e, 0x24, 0xe1, 0x49, 0x30, 0x39, 0xe1, 0xfc, 0xcc, 0x2d, 0xcb, 0xe4, 0x7a, 0xfe, 0x90, 0xd9, 0x16, 0xa6, 0xdf, 0x5c, 0x80, 0x1a, 0x13, 0x57, 0xf, 0x3a, 0xcd, 0x92, 0x12, 0x9b, 0x6f, 0x6e, 0x16, 0xb8, 0xa, 0x3e, 0x84, 0x3b, 0xa7, 0x93, 0xb8, 0x2, 0xf9, 0xd9, 0xdb, 0x91, 0x26, 0x3e, 0x32, 0xa3, 0x62, 0x1f, 0xed, 0xb6, 0xba, 0xe9, 0xc, 0x2e, 0x2f, 0x66, 0x76, 0x7f, 0xdc, 0xac, 0x41, 0x14, 0x7f, 0x23, 0xa5, 0xba, 0xfc, 0x99, 0x8e, 0x29, 0x7b, 0x8f, 0x3a, 0x40, 0x60, 0xa4, 0x40, 0x25, 0xa1, 0x68, 0x67, 0xe4, 0xb8, 0x56, 0x38, 0x6b, 0x2e, 0x55, 0x1a, 0xdf, 0x27, 0xae, 0xec, 0x92, 0xb2, 0x14, 0x81, 0xcd, 0xb8, 0xd1, 0xa5, 0x22, 0xfd, 0xe8, 0xca, 0x7f, 0xd2, 0x3, 0xbb, 0xb1, 0xe, 0x4d, 0x26, 0x81, 0x91, 0x5c, 0x7e, 0x7, 0x84, 0x7d, 0x26, 0x8d, 0xf2, 0x80, 0xe6, 0x5e, 0xa8, 0x6c, 0x24, 0x88, 0x4a, 0x10, 0x9a, 0x21, 0xa7, 0x70, 0x1d, 0x3f, 0xaa, 0xb6, 0x9a, 0x9c, 0x65, 0x6e, 0x42, 0xb7, 0xd6, 0xa5, 0x96, 0x4d, 0xb5, 0xe6, 0x15, 0x50, 0xe5, 0xa0, 0x21, 0xde, 0xd, 0xd6, 0xfc, 0xbf, 0xae, 0x3b, 0xb5, 0x70, 0xa5, 0x31, 0x87, 0xd7, 0x82, 0xc6, 0x8d, 0xe2, 0xc8, 0x91, 0x51, 0x7, 0x92, 0x20, 0xd3, 0xa3, 0x86, 0x86, 0xc4, 0x5d, 0xbc, 0xe2, 0xaa, 0xe5, 0xfe, 0x2, 0x7e, 0x53, 0xfb, 0xf3, 0x3c, 0xc9, 0x96, 0x1a, 0x1e, 0xa8, 0xc5, 0x88, 0x6d, 0xbe, 0x5d, 0x13, 0x8b, 0x3f, 0x33, 0x3a, 0x2, 0xec, 0x38, 0x19, 0x6f, 0xa0, 0x3d, 0xb3, 0x6d, 0x79, 0xf0, 0x97, 0xc6, 0xa5, 0xdb, 0x2, 0x97, 0xb1, 0x6e, 0x8c, 0xab, 0xc2, 0x26, 0x3e, 0x3f, 0x6b, 0x1f, 0x5d, 0xde, 0x9c, 0xa5, 0x71, 0x5f, 0x53, 0xc8, 0x98, 0x53, 0x3f, 0xa0, 0x3b, 0x3f, 0xfc, 0xd2, 0x7c, 0x70, 0x1c, 0x63, 0x68, 0x96, 0x98, 0xa4, 0xbd, 0xa5, 0xa, 0xe8, 0x7f, 0x4d, 0x25, 0x43, 0xd9, 0x5a, 0x6e, 0x79, 0xb1, 0x80, 0x2, 0x92, 0x45, 0x8e, 0xcd, 0x22, 0x74, 0xd6, 0x93, 0xe6, 0xf9, 0xdf, 0x86, 0x51, 0x7b, 0x33, 0xcc, 0x46, 0xab, 0xe7, 0xd7, 0xd1, 0x16, 0x3e, 0x3b, 0xdd, 0x8b, 0x53, 0xd1, 0x50, 0x7a, 0xa1, 0xae, 0x46, 0x9b, 0xda, 0xa5, 0xb7, 0x4, 0xe7, 0x42, 0xff, 0x2, 0x5a, 0x40, 0xba, 0x1b, 0xa3, 0x5e, 0xd3, 0xbf, 0x8f, 0x76, 0x9a, 0xa0, 0x47, 0x47, 0x1c, 0x8, 0x31, 0x4e, 0x7e, 0x4, 0x64, 0x33, 0x7a, 0xcb, 0xd8, 0xf1, 0x88, 0xc2, 0x57, 0x86, 0x71, 0x1d, 0x5b, 0xb, 0x72, 0xf5, 0xf1, 0xc5, 0xa4, 0xdb, 0x64, 0xfa, 0x16, 0x5b, 0x5a, 0xf8, 0xbf, 0x29, 0xcb, 0x68, 0xe, 0x76, 0xd, 0xa9, 0x9b, 0x6b, 0xb7, 0xbc, 0x53, 0x9c, 0x82, 0xf1, 0x17, 0x7a, 0x6c, 0x3, 0xb8, 0x99, 0xfd, 0xbb, 0xd5, 0xd7, 0x9c, 0x24, 0xa7, 0x17, 0xb7, 0xd4, 0x9c, 0xf3, 0xa1, 0x45, 0x74, 0x2e, 0x30, 0x23, 0x78, 0xcb, 0xcf, 0x79, 0x33, 0x2d, 0xb, 0x2d, 0xd2, 0x77, 0x4, 0x91, 0x4d, 0x43, 0x7d, 0x58, 0xae, 0xa5, 0x2d, 0x67, 0x64, 0xd0, 0x2e, 0xee, 0xbf, 0x80, 0x8b, 0x57, 0xed, 0xd1, 0x3f, 0xb3, 0xe9, 0x41, 0x1d, 0x25, 0xb4, 0x42, 0x20, 0x9d, 0xa0, 0xaa, 0xc3, 0x6, 0x86, 0xbf, 0x80, 0xc6, 0x7f, 0x92, 0x5f, 0x10, 0x38, 0x66, 0xc6, 0x9f, 0xb3, 0xa, 0x6d, 0xf2, 0x29, 0x6b, 0xf6, 0x99, 0x7f, 0x53, 0xdc, 0xfc, 0x94, 0xdc, 0xe2, 0x5d, 0x75, 0xba, 0xba, 0x9e, 0x1b, 0xf4, 0xd5, 0xf1, 0x69, 0x7e, 0xf7, 0x98, 0x34, 0xb1, 0x64, 0x94, 0x13, 0x3f, 0xc3, 0xc8, 0x1f, 0x7b, 0xed, 0xf2, 0xfb, 0x5, 0x2b, 0x1, 0x3, 0x44, 0xdb, 0xfc, 0xc1, 0xae, 0xe6, 0x81, 0x2e, 0xfe, 0x8f, 0x5d, 0x6c, 0xbe, 0xae, 0x9c, 0xf1, 0x6f, 0x70, 0xc6, 0xd6, 0x2b, 0xfd, 0x64, 0xea, 0x98, 0x5f, 0x7c, 0x77, 0x92, 0xfb, 0x3c, 0x24, 0x85, 0xd4, 0x26, 0xde, 0xfc, 0xc3, 0x7d, 0x1, 0xc9, 0x4, 0xa5, 0x6e, 0xe8, 0x42, 0x64, 0xdb, 0xe9, 0xcc, 0x53, 0x71, 0xba, 0x3f, 0x5b, 0x90, 0xcf, 0x1f, 0xa5, 0x37, 0xb1, 0x3c, 0x9, 0x69, 0xb2, 0xca, 0xc9, 0x4, 0xf2, 0x35, 0x9f, 0x2d, 0xb, 0xdc, 0x44, 0xbf, 0x99, 0x21, 0xd3, 0xad, 0x96, 0xd3, 0x3a, 0x3f, 0x59, 0xeb, 0x30, 0xe3, 0x30, 0xa7, 0xf5, 0x70, 0x19, 0x1b, 0x5, 0xbd, 0x49, 0x7f, 0x57, 0xce, 0x9e, 0xda, 0xbc, 0x40, 0x3a, 0x2e, 0xcf, 0x20, 0x98, 0x77, 0x7d, 0x79, 0x50, 0xf9, 0x98, 0x69, 0x60, 0x4b, 0x7d, 0x5c, 0x69, 0xdb, 0x43, 0x1f, 0x2b, 0x56, 0xe2, 0xd9, 0x88, 0xc3, 0xcc, 0xab, 0x53, 0x3e, 0x62, 0x74, 0x22, 0xa8, 0x1c, 0xdf, 0xa5, 0x4d, 0x3f, 0xde, 0x96, 0x15, 0xe, 0x2b, 0x4b, 0x80, 0xbc, 0x4b, 0x1a, 0x7b, 0x13, 0xb2, 0xd0, 0xd4, 0xf6, 0x7e, 0xa2, 0xfd, 0xd9, 0x54, 0x63, 0x1a, 0xdc, 0xaa, 0x56, 0x23, 0x6a, 0xc2, 0xc7, 0x34, 0x71, 0xbb, 0xd4, 0xf1, 0xfb, 0x3d, 0x7d, 0x9b, 0x4b, 0x43, 0x8b, 0xb1, 0xbf, 0xbc, 0xd4, 0x89, 0xfb, 0x8e, 0xcd, 0xe4, 0x44, 0x50, 0xce, 0x65, 0x40, 0x29, 0x34, 0xc, 0xaa, 0xca, 0x8d, 0x66, 0xd4, 0xf8, 0xa8, 0xbe, 0x81, 0x72, 0x5b, 0xf0, 0x17, 0xa0, 0x36, 0x6d, 0x24, 0x7b, 0xfe, 0x2a, 0xc3, 0x70, 0xa, 0xe1, 0x6f, 0xfb, 0x63, 0x5d, 0xd0, 0x50, 0xee, 0x72, 0xff, 0x98, 0x69, 0x93, 0x79, 0x99, 0xd6, 0x2d, 0xf8, 0xec, 0xd9, 0xbb, 0xd1, 0x75, 0xb5, 0xa1, 0xc0, 0xfc, 0xb1, 0x45, 0xcc, 0x12, 0x1b, 0x7, 0x45, 0x79, 0x7a, 0xb, 0x6a, 0x57, 0x95, 0xc4, 0x88, 0x1b, 0x3c, 0xc4, 0x5a, 0x55, 0x98, 0xfb, 0x16, 0x1b, 0x30, 0x4f, 0xca, 0xe6, 0xff, 0x63, 0x34, 0x8d, 0xae, 0x99, 0x3a, 0xea, 0xb, 0x51, 0x47, 0x5e, 0x10, 0xd7, 0xa3, 0x4, 0x4b, 0xf6, 0x75, 0xa5, 0x34, 0x40, 0xa7, 0x70, 0xc9, 0x7c, 0x73, 0xc1, 0x4f, 0xc1, 0x74, 0xe5, 0xb2, 0x49, 0x94, 0xc1, 0x3c, 0x98, 0x92, 0x8, 0x8b, 0xb0, 0x4a, 0xe6, 0x8d, 0x1e, 0x59, 0xbf, 0x21, 0x14, 0xe8, 0x68, 0x37, 0x1f, 0x73, 0x66, 0xb3, 0xdf, 0xda, 0xb4, 0x37, 0x8f, 0x61, 0x8c, 0xc4, 0x7b, 0x9a, 0x6, 0x63, 0x7c, 0x49, 0x6e, 0xf8, 0xc6, 0x82, 0xd1, 0xfd, 0x39, 0x36, 0x33, 0xa, 0x6d, 0x47, 0x5a, 0xa3, 0x4b, 0x98, 0x55, 0x54, 0xf2, 0x8e, 0x9c, 0xc7, 0x21, 0xf9, 0x95, 0x27, 0xd6, 0x7, 0x4a, 0x1c, 0xc0, 0x5f, 0x6b, 0x2a, 0xc6, 0x65, 0xa4, 0xea, 0xe1, 0xb2, 0x2e, 0xd3, 0xa0, 0x4c, 0x19, 0xe5, 0x27, 0xef, 0x52, 0x4a, 0x44, 0x2a, 0x39, 0x3f, 0x50, 0xf7, 0xb6, 0x3e, 0xb5, 0x6e, 0xc1, 0x13, 0x9f, 0xe3, 0xe0, 0xf8, 0x17, 0xf0, 0xf5, 0xbe, 0x84, 0xf7, 0xf7, 0x56, 0xfd, 0x8d, 0x8c, 0x8e, 0xfc, 0xf4, 0xdb, 0x25, 0x2f, 0x1d, 0xb9, 0x93, 0x98, 0x60, 0xc2, 0x6a, 0x60, 0xcd, 0x33, 0x14, 0xbf, 0xd4, 0xea, 0x4a, 0xdf, 0x6c, 0xaf, 0xd5, 0xd6, 0x69, 0x90, 0xfd, 0x6a, 0xa3, 0xc5, 0xc7, 0x3e, 0x4e, 0x6e, 0xd0, 0x68, 0xa6, 0xb9, 0x4a, 0x50, 0xf3, 0x79, 0x39, 0x68, 0x22, 0xa8, 0xcc, 0x55, 0x49, 0x79, 0xd1, 0x3e, 0xe7, 0xb1, 0xf6, 0xfd, 0xaf, 0x6f, 0x25, 0xd5, 0xbc, 0x6, 0xdc, 0x4, 0xa7, 0x11, 0x75, 0xd1, 0xbf, 0x34, 0x92, 0x66, 0xa9, 0xdf, 0x7d, 0xdd, 0x5a, 0x1a, 0xa3, 0x53, 0x6f, 0xf8, 0x48, 0xb1, 0xdc, 0xe2, 0x40, 0x48, 0x13, 0xb0, 0x1b, 0xc5, 0x92, 0x52, 0x7a, 0xea, 0xcf, 0x25, 0xff, 0x8b, 0x21, 0xaf, 0xf4, 0x56, 0xbe, 0x4, 0x7c, 0x6a, 0xca, 0xd, 0xb3, 0x79, 0xf6, 0xce, 0x2c, 0x1c, 0xbc, 0x77, 0xfe, 0x2a, 0xe6, 0x72, 0xd1, 0xa6, 0xd9, 0xb3, 0xfa, 0x64, 0x2a, 0x5a, 0xb4, 0xb5, 0xea, 0x7a, 0x9b, 0xd3, 0x38, 0x64, 0x1b, 0x35, 0x98, 0x1f, 0xa9, 0x2e, 0x5a, 0x68, 0xa8, 0xa9, 0x9a, 0x83, 0x8d, 0xa4, 0xca, 0x4f, 0xf4, 0xa2, 0xfb, 0xdd, 0xb0, 0xff, 0xc2, 0x18, 0xfb, 0xe9, 0xfd, 0xa8, 0x40, 0xc2, 0x27, 0x4c, 0x89, 0x73, 0x17, 0x4, 0x25, 0x18, 0x3c, 0x3e, 0x3a, 0xe9, 0xe0, 0xa3, 0x64, 0x28, 0xe6, 0x37, 0x5e, 0x99, 0xe8, 0xc1, 0xd6, 0x67, 0xd, 0x9e, 0xd2, 0x48, 0x3c, 0x98, 0x47, 0x60, 0xac, 0x3d, 0x47, 0x38, 0x35, 0xa9, 0x8a, 0xd8, 0xaa, 0xc4, 0xf7, 0x6e, 0x77, 0x61, 0xe9, 0x81, 0x15, 0x3f, 0xbc, 0x77, 0x6a, 0x4e, 0x6e, 0xa7, 0x7f, 0x1, 0x58, 0x6f, 0xef, 0xa6, 0x27, 0x95, 0xea, 0x9f, 0xe3, 0x47, 0xb4, 0xb0, 0xad, 0xbc, 0x38, 0x6b, 0x9f, 0x3, 0x6b, 0xd2, 0x3a, 0xd6, 0x52, 0x58, 0xe2, 0xa9, 0xb0, 0x27, 0x73, 0xad, 0x8e, 0x2f, 0x25, 0x94, 0x61, 0x6a, 0x73, 0x19, 0xbb, 0xcc, 0xb3, 0x86, 0x21, 0x35, 0xf6, 0xbf, 0xf4, 0x82, 0x60, 0x16, 0x2b, 0x55, 0x67, 0x36, 0xb7, 0x42, 0xed, 0xed, 0x29, 0xc1, 0xda, 0x89, 0xac, 0xf3, 0xbb, 0xf1, 0xc0, 0xec, 0x61, 0x2c, 0xee, 0x7c, 0xf1, 0x9, 0x1c, 0xdf, 0xc9, 0xe9, 0xea, 0x9a, 0x4c, 0x39, 0xab, 0xf7, 0x38, 0xda, 0xf5, 0x88, 0xa, 0xfb, 0xe2, 0x84, 0xe8, 0xb8, 0x28, 0x4, 0xdc, 0xd2, 0x16, 0xe2, 0x7c, 0x62, 0x61, 0x57, 0xe, 0x35, 0x8a, 0xf8, 0xf4, 0xe1, 0xc6, 0xe9, 0x6d, 0x2e, 0xa7, 0x5b, 0xd2, 0x4f, 0x79, 0x82, 0x10, 0x8f, 0xa9, 0xda, 0xcb, 0x28, 0x5, 0x87, 0xf9, 0xd, 0xe, 0x2d, 0xe6, 0xae, 0x74, 0x80, 0xa7, 0x34, 0x1f, 0xcb, 0xec, 0xa1, 0x80, 0x96, 0x65, 0x3d, 0xf2, 0xfb, 0xd8, 0x14, 0x7c, 0xf0, 0xa4, 0x16, 0xf, 0x54, 0x4, 0x2e, 0x5c, 0xdb, 0xe2, 0x20, 0x12, 0x81, 0x7d, 0xd2, 0x50, 0x10, 0xb4, 0xde, 0x2f, 0x8, 0x9f, 0x78, 0x33, 0xa7, 0xed, 0xd, 0xd6, 0x92, 0x47, 0xcc, 0x49, 0xac, 0x9e, 0xf6, 0x17, 0x3a, 0xe8, 0xba, 0xca, 0xfb, 0x17, 0xb2, 0x97, 0xec, 0x72, 0x67, 0x5b, 0x76, 0x3, 0x67, 0xc1, 0xcc, 0x40, 0xad, 0xcd, 0x83, 0x92, 0x8d, 0xf, 0xc5, 0xf6, 0xd0, 0x23, 0x41, 0x7c, 0x92, 0xfd, 0x51, 0xd7, 0x90, 0xae, 0x9b, 0x6d, 0x3e, 0x7b, 0xa5, 0x1, 0xb3, 0x24, 0x8f, 0x75, 0x77, 0x23, 0xae, 0x5a, 0x50, 0xa2, 0xf3, 0x5, 0xf8, 0x80, 0x3e, 0x5a, 0x1e, 0x6a, 0xb0, 0x1f, 0x6f, 0x96, 0xc3, 0x30, 0xe8, 0x79, 0x58, 0xde, 0x4f, 0x1a, 0x30, 0xae, 0xd4, 0x59, 0xa, 0x60, 0x81, 0xb7, 0x87, 0xbc, 0xf6, 0xeb, 0x4f, 0x25, 0x4b, 0xe3, 0x12, 0xe, 0xfd, 0x51, 0xa1, 0xbd, 0x45, 0x2d, 0x49, 0x62, 0x39, 0x44, 0x55, 0xc2, 0x4e, 0xc3, 0xc1, 0x4c, 0x37, 0xda, 0xd4, 0xc1, 0x50, 0xe3, 0x45, 0xf0, 0x64, 0x11, 0x7a, 0x87, 0x60, 0x3f, 0xa1, 0x1, 0x6c, 0x71, 0xc5, 0x74, 0xd, 0x12, 0x9c, 0x3b, 0x7b, 0x7f, 0x5e, 0xe5, 0x36, 0xae, 0x2d, 0xd0, 0x1c, 0xbf, 0x51, 0xf6, 0x8e, 0x28, 0xec, 0x2d, 0xeb, 0x5c, 0x7f, 0x16, 0x49, 0xf9, 0x4b, 0x75, 0xbf, 0x50, 0xad, 0xed, 0x10, 0xb7, 0x1c, 0xd6, 0x57, 0x95, 0x2d, 0x68, 0xc2, 0xf, 0xa5, 0x9d, 0xb8, 0xbc, 0x79, 0x8d, 0x8b, 0x59, 0xa, 0x8d, 0x8c, 0x20, 0x42, 0xe3, 0xae, 0xce, 0x34, 0xf6, 0xb1, 0x3e, 0x66, 0x14, 0xa2, 0x31, 0xcf, 0x5c, 0xab, 0xbf, 0x0, 0xa6, 0x20, 0xfb, 0x6f, 0xb3, 0x65, 0xf1, 0x96, 0x20, 0xf, 0x64, 0xe7, 0x3f, 0x2b, 0x9e, 0x19, 0x84, 0x7a, 0x2, 0xd2, 0xf9, 0x91, 0x71, 0xba, 0x58, 0x1c, 0xc0, 0x60, 0x16, 0x53, 0x96, 0xad, 0xc4, 0x19, 0x36, 0xc6, 0x59, 0x9d, 0xd7, 0xea, 0x64, 0x6d, 0xd2, 0x44, 0x8d, 0x66, 0x43, 0x9c, 0xe0, 0x43, 0xf1, 0xd2, 0xe4, 0x12, 0xb3, 0x92, 0x3c, 0xbf, 0x23, 0x5, 0xcc, 0xb9, 0x45, 0x17, 0xe4, 0x2, 0x73, 0x10, 0x89, 0x5, 0x83, 0x46, 0x97, 0x9, 0xdd, 0x7e, 0xe0, 0x20, 0xfd, 0xf3, 0x3c, 0xf, 0xca, 0x61, 0x38, 0xb7, 0xe9, 0xec, 0x83, 0x4c, 0xf7, 0xbd, 0xfa, 0x3c, 0x9f, 0x7c, 0x6c, 0x7e, 0x86, 0x47, 0x91, 0x3f, 0x9d, 0xb5, 0xa8, 0xd9, 0xe0, 0x1f, 0x29, 0xf9, 0xd3, 0x57, 0x5c, 0xd5, 0x48, 0xf5, 0xd1, 0x41, 0xa2, 0x22, 0xcb, 0x7e, 0x1c, 0x65, 0xf1, 0x4f, 0xa6, 0x17, 0xd2, 0x97, 0xc8, 0xd4, 0xd6, 0xf6, 0x6c, 0x1, 0x44, 0xdd, 0x58, 0xdb, 0x8d, 0x9e, 0x1b, 0x54, 0xc9, 0x5e, 0x37, 0x42, 0xd8, 0xca, 0xa5, 0xb0, 0x66, 0x6d, 0x6d, 0xbb, 0x12, 0x3c, 0x2, 0x5d, 0xc, 0x63, 0xea, 0xd9, 0x29, 0xd1, 0xf7, 0x84, 0x29, 0xf, 0xe6, 0x93, 0x84, 0x4, 0xb, 0x79, 0xcc, 0x8a, 0x2f, 0xe3, 0x46, 0x7e, 0xe2, 0x52, 0x93, 0xde, 0xac, 0xeb, 0x3c, 0x17, 0xd1, 0x23, 0xa8, 0xe8, 0x81, 0x21, 0x20, 0xe1, 0xb6, 0x70, 0xf4, 0x51, 0x7e, 0x7e, 0x4b, 0xa6, 0xe2, 0x8f, 0x90, 0x1, 0xb4, 0xfb, 0xbd, 0x5b, 0x5a, 0x79, 0x4, 0x2a, 0x6d, 0xaf, 0xe5, 0xf9, 0x2e, 0xef, 0x62, 0xc5, 0x56, 0x5c, 0x38, 0x99, 0x5c, 0xa1, 0x6d, 0x55, 0xfa, 0x4c, 0x2d, 0x11, 0x66, 0xbb, 0x42, 0x6f, 0xb4, 0x12, 0x94, 0x9d, 0x5, 0x24, 0xcd, 0x5, 0x89, 0xd3, 0xa1, 0xd8, 0x17, 0x7a, 0xa0, 0x3, 0x41, 0x7e, 0xd4, 0x2b, 0x95, 0xd, 0x5b, 0x7e, 0x3a, 0xea, 0x58, 0xad, 0xbb, 0x74, 0xab, 0x34, 0x8f, 0xd6, 0xde, 0x5b, 0xf1, 0x56, 0xac, 0x1d, 0xba, 0xc1, 0xbd, 0x36, 0xf5, 0x64, 0x1a, 0xfd, 0x1f, 0xbd, 0x8f, 0x59, 0x35, 0xc, 0x6d, 0xdb, 0x5, 0xf8, 0x39, 0xe8, 0x73, 0xc8, 0x27, 0xd4, 0xfd, 0x46, 0xa6, 0xad, 0xf0, 0xb8, 0x4e, 0x43, 0x29, 0xd1, 0x2, 0x90, 0x86, 0x50, 0xaf, 0x93, 0x58, 0x85, 0x5b, 0x79, 0xe2, 0x94, 0x9e, 0x5f, 0x41, 0x24, 0x9c, 0xa6, 0xfa, 0xfd, 0x6d, 0xd2, 0xce, 0x3, 0x14, 0x4, 0xd9, 0x8b, 0x5c, 0xc2, 0xa6, 0x2c, 0x60, 0x26, 0xc8, 0x28, 0xf4, 0x7d, 0x2b, 0xbe, 0x9d, 0xb1, 0x81, 0x7e, 0x67, 0x55, 0x63, 0x4, 0x77, 0x0, 0xb7, 0x53, 0x5, 0x2e, 0x99, 0xf0, 0xae, 0x3f, 0x3b, 0x5e, 0xd3, 0xad, 0xc1, 0x3d, 0x81, 0x2f, 0x7c, 0x16, 0x23, 0x3a, 0xbe, 0x81, 0xbb, 0x3e, 0xce, 0x12, 0xd5, 0x11, 0xaf, 0xc4, 0x5a, 0x29, 0xb6, 0xe6, 0xb8, 0x8, 0xe9, 0x1f, 0x76, 0x6e, 0x7d, 0xbd, 0x29, 0xea, 0x78, 0x2, 0x15, 0x83, 0x55, 0xa2, 0x95, 0xa3, 0x9, 0x90, 0x68, 0x9b, 0xad, 0x78, 0x41, 0xae, 0x27, 0xad, 0xbc, 0x74, 0xbe, 0xb1, 0x17, 0xf9, 0x74, 0x64, 0x8d, 0xed, 0x53, 0x51, 0xb6, 0x5a, 0x71, 0x99, 0x6a, 0xf1, 0xf, 0x2, 0xfe, 0xa4, 0x69, 0x98, 0xe7, 0xb0, 0x7c, 0xd0, 0xbd, 0x2e, 0x45, 0xc2, 0x37, 0x76, 0x38, 0xa6, 0x3e, 0xd5, 0x6d, 0xc8, 0xf2, 0x99, 0x88, 0xe0, 0x43, 0xf8, 0xb5, 0xc2, 0xf5, 0x48, 0x55, 0x79, 0xc3, 0x1a, 0xca, 0x1e, 0x4c, 0x13, 0x7e, 0xce, 0x29, 0x5f, 0x6a, 0xea, 0x67, 0x46, 0xc1, 0xc6, 0xfa, 0xf4, 0x96, 0xf0, 0xa0, 0xe0, 0x57, 0x53, 0x6f, 0x5c, 0x90, 0x87, 0xfa, 0x85, 0xd2, 0xcf, 0xea, 0xc0, 0xb2, 0x92, 0x50, 0x8a, 0x74, 0x69, 0xdf, 0xfb, 0xa5, 0x4f, 0x81, 0xe, 0x56, 0xbf, 0x96, 0x94, 0x3a, 0x2d, 0x2, 0x4, 0x35, 0xa, 0x16, 0xf7, 0x60, 0xcd, 0x4f, 0x5e, 0xb2, 0x21, 0x8e, 0xf0, 0xe6, 0x83, 0x46, 0x12, 0xe7, 0xb4, 0x75, 0x0, 0xb8, 0x2f, 0xf, 0xdd, 0xea, 0x32, 0x6a, 0x23, 0x56, 0x17, 0x70, 0x5d, 0x2b, 0xec, 0x32, 0xe2, 0xc8, 0xcc, 0xd0, 0xf0, 0x37, 0xbc, 0xa, 0x71, 0x51, 0xa5, 0x32, 0x31, 0x84, 0x41, 0x21, 0x11, 0x47, 0xac, 0xe2, 0x44, 0x4d, 0xdd, 0xf7, 0x51, 0x54, 0x6a, 0x16, 0x6b, 0x21, 0x3f, 0xd2, 0x4f, 0x7, 0x3a, 0x64, 0xce, 0xd8, 0xcd, 0x45, 0x51, 0xf, 0x12, 0xa4, 0x5b, 0x93, 0x81, 0x61, 0xb6, 0xf8, 0xad, 0x18, 0x1d, 0xde, 0x69, 0x9b, 0xcb, 0xbb, 0x7, 0xa8, 0x4f, 0x82, 0x24, 0xcc, 0x1e, 0xb3, 0xfc, 0x5e, 0xa8, 0xe4, 0x5f, 0x63, 0x81, 0x9f, 0x6a, 0xd4, 0xfc, 0x55, 0x13, 0x9b, 0xb, 0x73, 0x25, 0x34, 0xbb, 0x6f, 0xe4, 0x19, 0x2, 0x6, 0x28, 0xd2, 0x5f, 0x1b, 0xe4, 0x54, 0xee, 0x76, 0xe7, 0x40, 0x5a, 0xb1, 0x5b, 0xec, 0xdc, 0x9a, 0xef, 0x79, 0x5d, 0x3c, 0xa2, 0xa9, 0x73, 0x71, 0x1d, 0x25, 0x4e, 0x62, 0xe7, 0xad, 0x2b, 0x42, 0x76, 0xd5, 0x50, 0xd5, 0xc3, 0xe9, 0xb1, 0x6f, 0x42, 0xf1, 0x92, 0x12, 0xed, 0x4e, 0xc5, 0x47, 0x7f, 0xf6, 0xa1, 0xa7, 0xc, 0x14, 0xd2, 0x2a, 0xc6, 0x1e, 0x7a, 0x80, 0xfa, 0x4a, 0x4b, 0x49, 0x9f, 0x68, 0x31, 0x84, 0x1, 0xd8, 0x7c, 0x2b, 0xec, 0xf2, 0x53, 0xa8, 0x89, 0xb5, 0xfb, 0xe, 0xfb, 0x5, 0x3e, 0x24, 0x7, 0x19, 0xee, 0xa, 0xfa, 0x8a, 0x62, 0x2c, 0x4a, 0xdb, 0xfb, 0x11, 0xcb, 0x86, 0x31, 0xc4, 0xfe, 0x53, 0xc8, 0x6d, 0xf6, 0xf3, 0x2e, 0x92, 0xe0, 0xcc, 0xc9, 0xeb, 0x58, 0x14, 0xda, 0x4f, 0x39, 0xa1, 0x97, 0x77, 0xd6, 0xbf, 0xf0, 0x65, 0x4c, 0x4, 0xd4, 0x70, 0x48, 0x6e, 0xbc, 0x7b, 0xcd, 0x75, 0xe, 0x4b, 0x6d, 0xf4, 0x20, 0xda, 0x9f, 0xcd, 0xb3, 0x88, 0xb9, 0xbf, 0xb0, 0xdc, 0xde, 0xd6, 0x12, 0xfb, 0x1c, 0x57, 0xe1, 0x18, 0xf7, 0xe8, 0x39, 0xfe, 0x8, 0x9, 0x58, 0xb2, 0x1d, 0xcf, 0xf9, 0x91, 0x91, 0xc5, 0x74, 0x6b, 0x1c, 0xb6, 0xdb, 0xae, 0xd0, 0x6f, 0x15, 0x54, 0x6e, 0xfd, 0xca, 0x11, 0xb5, 0xdb, 0xc1, 0xd1, 0x1b, 0x78, 0x3e, 0x6d, 0x3d, 0x3e, 0x9a, 0xc6, 0xf8, 0x77, 0x8, 0xc0, 0x4, 0x84, 0x3, 0x20, 0x0, 0xe0, 0xe1, 0xe1, 0x90, 0xfe, 0xf7, 0xfb, 0x27, 0x1c, 0x0, 0x97, 0x96, 0x47, 0x4a, 0xd3, 0x1c, 0x2, 0xc, 0x49, 0x29, 0x6e, 0xea, 0xdf, 0xbb, 0x9d, 0xbf, 0xfb, 0xdf, 0xaf, 0x83, 0xef, 0x81, 0xe5, 0x97, 0x58, 0x25, 0x64, 0x7f, 0x1, 0x74, 0x42, 0x41, 0x31, 0xef, 0xe7, 0x98, 0xff, 0x2, 0xf0, 0xdc, 0x35, 0x7e, 0x7d, 0x50, 0xb9, 0x7b, 0xff, 0x3, 0x77, 0x23, 0x29, 0x36, 0xac, 0xef, 0x1d, 0xaa, 0x4, 0x75, 0xf4, 0x4a, 0xe8, 0x7e, 0x2, 0xd1, 0xa, 0x1c, 0xfa, 0xc0, 0x34, 0xd0, 0x82, 0x3, 0xf5, 0x95, 0x57, 0x6b, 0x94, 0x17, 0x21, 0x8e, 0xe5, 0x1b, 0x38, 0xda, 0x82, 0x30, 0xac, 0x6f, 0x97, 0xb, 0x57, 0x84, 0x30, 0xd9, 0x2, 0x30, 0x1a, 0x99, 0x85, 0x2e, 0x8d, 0xed, 0x16, 0xc1, 0xbe, 0xa0, 0x11, 0xfc, 0xe7, 0x31, 0x9, 0x23, 0x0, 0xff, 0x37, 0x2e, 0x90, 0xd8, 0x75, 0xc0, 0xbb, 0x30, 0x1, 0x3e, 0x28, 0x82, 0x23, 0x28, 0x3a, 0xeb, 0xf3, 0x36, 0x5a, 0x42, 0x60, 0xfa, 0x52, 0xd6, 0xfa, 0x27, 0xe4, 0xdf, 0xb8, 0x7f, 0x1, 0xb2, 0xa, 0xbf, 0x79, 0xb0, 0x6d, 0xf7, 0xb, 0x5f, 0x63, 0xc1, 0xff, 0x8e, 0xf5, 0xfc, 0x53, 0xa2, 0x15, 0x94, 0x22, 0x32, 0xff, 0x11, 0xff, 0xb5, 0x96, 0xb9, 0xa8, 0x17, 0xe8, 0xf8, 0x5b, 0x56, 0x7f, 0xfa, 0x8e, 0xfa, 0x51, 0x96, 0x1c, 0xf6, 0x2d, 0x25, 0x43, 0x68, 0x8c, 0x8b, 0xc1, 0x1e, 0xdd, 0x1c, 0x51, 0x54, 0xfb, 0x57, 0x8e, 0xeb, 0x90, 0x9d, 0x55, 0xb, 0x51, 0xc0, 0x67, 0xba, 0xea, 0xd8, 0x6b, 0xa2, 0x38, 0x17, 0xdb, 0x65, 0x2f, 0xb8, 0x89, 0xb7, 0xa8, 0x77, 0x47, 0x9, 0x39, 0x69, 0x92, 0xf0, 0x1f, 0x11, 0x3b, 0xda, 0xed, 0xdc, 0xf0, 0x26, 0x8a, 0xcb, 0xb3, 0xfb, 0xaa, 0xe1, 0x3b, 0x87, 0x5a, 0xd5, 0x7a, 0x68, 0x5c, 0x7e, 0x19, 0x1e, 0x13, 0xcc, 0x48, 0xd7, 0x97, 0xff, 0x71, 0x97, 0xe3, 0x92, 0x79, 0xfa, 0x74, 0x3f, 0xea, 0x16, 0x4e, 0x84, 0xb1, 0x25, 0x63, 0x45, 0x21, 0xd9, 0x49, 0x54, 0x5c, 0x93, 0xe7, 0x5f, 0x98, 0x2a, 0xf6, 0x11, 0x3f, 0xfc, 0x6e, 0x93, 0x64, 0x72, 0xd5, 0xe3, 0xb4, 0x5d, 0x55, 0x57, 0xe7, 0x52, 0xca, 0x6d, 0x2a, 0xcb, 0xa2, 0xb9, 0x47, 0x26, 0x55, 0x4b, 0x4c, 0xbd, 0xb4, 0xa6, 0xce, 0xd2, 0xad, 0x53, 0x2b, 0x5f, 0x1c, 0x54, 0x49, 0x61, 0x55, 0x83, 0x72, 0x43, 0x7e, 0x47, 0xa4, 0x9c, 0xde, 0xc8, 0x9a, 0xf5, 0x68, 0x1c, 0x8e, 0xc9, 0x74, 0x3f, 0x1e, 0xa6, 0xc0, 0xef, 0xc3, 0xc0, 0xa5, 0xee, 0xfd, 0x8b, 0x54, 0xd0, 0x13, 0x35, 0x9f, 0x5e, 0xa3, 0x17, 0xbd, 0x30, 0x87, 0xb0, 0x2, 0xe4, 0xe6, 0x80, 0x4d, 0xdb, 0x25, 0x13, 0x1c, 0xca, 0x51, 0x1d, 0xbc, 0x2f, 0x83, 0x84, 0x5c, 0x20, 0x4d, 0xbe, 0xa9, 0x59, 0x71, 0x3d, 0x32, 0xfd, 0xa, 0x59, 0xce, 0x3f, 0x47, 0xdc, 0x93, 0xe9, 0x8e, 0xc3, 0xd5, 0x38, 0x37, 0x74, 0x93, 0x4f, 0x89, 0x54, 0x52, 0x22, 0x43, 0xe1, 0xbd, 0xb8, 0xce, 0xa7, 0xdb, 0x8a, 0xa4, 0xa0, 0x2d, 0x4e, 0x12, 0x54, 0x65, 0x3f, 0xb5, 0x45, 0x73, 0x91, 0x90, 0x7e, 0xf5, 0x8f, 0xfd, 0xde, 0x2c, 0x8, 0x7, 0x7f, 0x8d, 0xd2, 0x5f, 0xda, 0x81, 0xdd, 0x1d, 0xe5, 0xda, 0xb1, 0xd5, 0xe6, 0xc1, 0x8d, 0x8d, 0x6e, 0x41, 0x3d, 0x8e, 0x9e, 0x4c, 0x3f, 0x18, 0x23, 0xfb, 0x35, 0xc8, 0x4e, 0x68, 0xe8, 0x84, 0xe4, 0xfd, 0x26, 0x97, 0xb6, 0xa9, 0xf5, 0x90, 0xe1, 0xaa, 0x51, 0x64, 0x52, 0xce, 0xd7, 0x2e, 0xe, 0x62, 0x1a, 0xb4, 0x41, 0x43, 0xfb, 0x8c, 0xf4, 0xeb, 0xf4, 0x3e, 0x78, 0x3d, 0xba, 0x1f, 0xb9, 0x3a, 0xaa, 0x1f, 0x30, 0xb, 0xc2, 0xe7, 0x79, 0x65, 0xb8, 0xbd, 0xa2, 0xf0, 0x70, 0x1b, 0x8b, 0x1d, 0x3a, 0xa5, 0x55, 0x30, 0x3c, 0x8d, 0x4, 0xb0, 0x3a, 0x6b, 0xec, 0xb6, 0xd5, 0xcb, 0x88, 0x76, 0x48, 0xe5, 0x2c, 0xd5, 0x2a, 0x75, 0xe2, 0x3, 0xe3, 0x47, 0xe9, 0xa3, 0x7f, 0xb0, 0xce, 0x7, 0x13, 0x3e, 0x3f, 0x16, 0x23, 0x3, 0xd8, 0x2b, 0xe6, 0x98, 0x1f, 0xf1, 0x84, 0xd1, 0x70, 0x4b, 0x40, 0xa2, 0x99, 0x85, 0x72, 0x64, 0x32, 0xa4, 0xc2, 0x26, 0xc, 0x16, 0x23, 0xe3, 0x31, 0xb8, 0xdb, 0xe5, 0xd5, 0x5f, 0x3d, 0x7f, 0x50, 0xfd, 0x99, 0x2f, 0x5, 0xf, 0x7b, 0xaa, 0xba, 0x1d, 0xd3, 0x37, 0x94, 0x92, 0xba, 0xb0, 0xd7, 0xef, 0x42, 0x26, 0x39, 0x5d, 0x65, 0xc9, 0x2, 0xde, 0x27, 0x6f, 0x54, 0x68, 0x42, 0xf2, 0x69, 0xad, 0x1b, 0xe5, 0x55, 0x3e, 0x59, 0xdc, 0xf, 0x3e, 0xa6, 0xf3, 0x65, 0x9b, 0xe3, 0xd, 0x15, 0x5d, 0x21, 0x49, 0x47, 0xd0, 0x22, 0xa9, 0xc, 0x60, 0x92, 0x7, 0xc3, 0xf4, 0x23, 0xac, 0xdf, 0x59, 0x7e, 0xb0, 0x22, 0xcb, 0x83, 0x3b, 0x26, 0xd1, 0x21, 0x69, 0xec, 0x60, 0xb8, 0x88, 0xac, 0xcd, 0xc7, 0xbc, 0x1d, 0xd6, 0x81, 0xb3, 0x9e, 0x84, 0x96, 0x4f, 0xbe, 0x49, 0x73, 0x6a, 0x68, 0x76, 0x80, 0xca, 0x10, 0x3c, 0x97, 0x8f, 0x91, 0xce, 0xd5, 0x7a, 0xa5, 0xfb, 0x73, 0x6d, 0x95, 0xf9, 0xfc, 0x52, 0x9, 0x2b, 0x18, 0xae, 0xeb, 0x4, 0xe1, 0xfb, 0x44, 0x96, 0xde, 0x27, 0xf4, 0xc9, 0xf8, 0x2a, 0x0, 0x9a, 0x99, 0x7f, 0x26, 0xe3, 0xaa, 0x65, 0x33, 0xb3, 0x36, 0x21, 0xb9, 0x5d, 0xfb, 0x2, 0x41, 0x7f, 0xcc, 0xb4, 0xc, 0x47, 0x24, 0xcd, 0x8f, 0x3d, 0xc6, 0xe, 0x5e, 0xb2, 0xde, 0x87, 0x82, 0x12, 0xf7, 0x97, 0x2a, 0xf5, 0xbe, 0x9d, 0xf9, 0x2e, 0x71, 0x66, 0x8, 0x3e, 0x99, 0x4c, 0x76, 0x7e, 0x1d, 0x53, 0x4d, 0xf7, 0x43, 0x78, 0x15, 0x6a, 0xb6, 0x6, 0x72, 0x95, 0x33, 0xb2, 0xf1, 0x33, 0x6e, 0xfa, 0x50, 0x69, 0x76, 0x39, 0xab, 0x98, 0x8, 0xc3, 0xdd, 0xab, 0xec, 0x64, 0xac, 0xd2, 0x4d, 0x69, 0x5, 0x17, 0xd3, 0x71, 0x2a, 0xfa, 0x2, 0xf, 0x44, 0xd8, 0xd3, 0x82, 0x9b, 0xb5, 0xe8, 0x9d, 0xe, 0x65, 0xd0, 0xf8, 0x2c, 0x3d, 0x7, 0xc8, 0x40, 0xb8, 0x8b, 0x7a, 0x2c, 0xec, 0x8, 0xea, 0x5a, 0x73, 0x79, 0xda, 0xf0, 0x18, 0x16, 0x8a, 0x14, 0x6f, 0x60, 0xd2, 0x29, 0x6d, 0x12, 0x9d, 0xf5, 0x68, 0x46, 0x3, 0xb2, 0x8, 0x13, 0x35, 0x9b, 0x70, 0x14, 0x4, 0x3c, 0xc, 0x47, 0xe9, 0x33, 0x3c, 0xd4, 0x36, 0x5c, 0x75, 0x35, 0x3e, 0x82, 0xda, 0x87, 0xef, 0xac, 0xad, 0x0, 0xe7, 0x3, 0x56, 0x9a, 0x9e, 0x82, 0xb7, 0x64, 0xe4, 0x62, 0xdd, 0xf6, 0x14, 0x43, 0x61, 0x58, 0x57, 0x26, 0xce, 0xb9, 0xa1, 0x5c, 0xc2, 0x28, 0xac, 0x4, 0x8f, 0xf3, 0x8e, 0xf3, 0x3e, 0xf1, 0xf3, 0xbe, 0xe9, 0x90, 0xcf, 0x28, 0xc4, 0x75, 0xbf, 0xe4, 0xd4, 0x7c, 0x77, 0x69, 0x1f, 0xf9, 0xb9, 0x69, 0x8, 0xa1, 0x1d, 0xd3, 0xd9, 0xae, 0x0, 0x50, 0x17, 0x6d, 0xc0, 0xcd, 0x12, 0x27, 0x84, 0x1d, 0x32, 0x4d, 0x3d, 0xc6, 0x20, 0xa, 0x69, 0x9c, 0x1c, 0x8b, 0x36, 0xd3, 0xd5, 0x69, 0xce, 0xd0, 0x21, 0x6c, 0x82, 0x4e, 0x1f, 0xa6, 0xfa, 0x36, 0x7c, 0x52, 0xc, 0x2d, 0x43, 0x3e, 0x3e, 0x6f, 0x11, 0xbe, 0x72, 0x5d, 0xdf, 0xa7, 0x8f, 0x29, 0x89, 0xad, 0x48, 0x6, 0x70, 0x9b, 0x5c, 0x7f, 0xe6, 0xa4, 0x9a, 0x63, 0xb1, 0x3f, 0x1d, 0x8f, 0xa3, 0x1, 0x8, 0x90, 0xac, 0x21, 0x12, 0xc4, 0x56, 0x2b, 0x6a, 0x78, 0xf4, 0x3e, 0x79, 0x46, 0xf9, 0x6e, 0xe7, 0x5a, 0x25, 0x41, 0x4a, 0x26, 0x8b, 0x99, 0x12, 0x9a, 0x99, 0x3b, 0x68, 0xf3, 0x83, 0xee, 0x42, 0x83, 0xf, 0x39, 0x14, 0x79, 0x43, 0x98, 0x74, 0x95, 0x85, 0x99, 0x7b, 0x50, 0xf2, 0x1f, 0xe9, 0x89, 0x9e, 0x96, 0x88, 0xe3, 0x98, 0xbe, 0x5c, 0xad, 0x0, 0x18, 0xf1, 0xd0, 0x94, 0xab, 0x8e, 0xfd, 0x7f, 0x45, 0x62, 0x73, 0x67, 0xa7, 0x8a, 0xc7, 0x61, 0x24, 0x6e, 0x70, 0x70, 0x11, 0x88, 0xb1, 0x1d, 0xa4, 0xd3, 0x3e, 0xab, 0xe8, 0xf5, 0xf9, 0x2, 0x7b, 0x1a, 0x6d, 0xfa, 0xc4, 0xe5, 0xe7, 0xbd, 0x2, 0x66, 0xf7, 0xd8, 0xb9, 0xa5, 0x3d, 0x8b, 0x2a, 0xb1, 0xf2, 0xda, 0x11, 0xee, 0xde, 0xf, 0x15, 0xe1, 0x28, 0xdc, 0x93, 0x3c, 0x60, 0xc8, 0x68, 0x64, 0xe1, 0x2d, 0xef, 0x7f, 0x73, 0x5e, 0xd1, 0x9e, 0x4a, 0x3, 0x66, 0x8f, 0xaa, 0x30, 0x15, 0xe4, 0xc4, 0xc, 0x2d, 0xdb, 0x4c, 0xe2, 0xd2, 0x32, 0xa6, 0x5a, 0xa4, 0x46, 0xc8, 0xe3, 0xd6, 0x13, 0xac, 0x50, 0x29, 0x76, 0x59, 0x12, 0xc4, 0xb5, 0x68, 0xc5, 0xe5, 0x32, 0x3, 0x97, 0xad, 0xb6, 0x67, 0x19, 0x8e, 0xc, 0x2a, 0x55, 0x6c, 0x99, 0x4a, 0xfc, 0xc, 0x48, 0x3b, 0x7, 0x22, 0xab, 0x8, 0x48, 0xe9, 0x90, 0x13, 0x13, 0xea, 0x45, 0x9a, 0x52, 0x75, 0xdd, 0x6c, 0x14, 0x10, 0x91, 0xa4, 0x83, 0x6b, 0xb9, 0xd2, 0x51, 0x27, 0xba, 0x54, 0x5d, 0xe, 0x74, 0xec, 0x1a, 0xda, 0x35, 0x83, 0xe7, 0xd8, 0x26, 0xa5, 0xc, 0xe, 0xec, 0x6a, 0x63, 0x91, 0xc6, 0xfb, 0x2f, 0x64, 0x99, 0x76, 0xe7, 0xd7, 0x51, 0x69, 0x36, 0xb3, 0xe3, 0xd9, 0xaf, 0x45, 0xb4, 0x51, 0x86, 0x60, 0x3, 0x5d, 0x55, 0xfe, 0x65, 0x6e, 0xc0, 0x9a, 0xb5, 0x36, 0x15, 0x98, 0xf3, 0xef, 0x2d, 0x95, 0x75, 0x9, 0x5, 0x63, 0xb0, 0xca, 0x62, 0x3f, 0x72, 0x92, 0xb6, 0x40, 0x76, 0xe6, 0xa6, 0x3e, 0x6f, 0x1, 0xcb, 0xd9, 0xb5, 0x6e, 0x20, 0x2, 0x12, 0xd2, 0xa7, 0x77, 0x61, 0x86, 0x4e, 0xab, 0x9f, 0x8f, 0xe, 0x92, 0x1, 0x8c, 0x28, 0x3, 0x3, 0x1a, 0xfc, 0x18, 0xfb, 0xa1, 0xa6, 0x6b, 0xf1, 0x81, 0x26, 0x8d, 0x8f, 0xbb, 0xbb, 0xc5, 0xe8, 0x29, 0xe8, 0x8f, 0x69, 0xa2, 0xdb, 0x5a, 0xfb, 0x52, 0xda, 0x3f, 0xe9, 0x62, 0x28, 0x23, 0x66, 0x15, 0xad, 0x78, 0x59, 0x57, 0x3f, 0xa9, 0x7, 0x83, 0x88, 0x3e, 0x49, 0xf, 0x34, 0xcd, 0xf5, 0x2, 0x5f, 0x2a, 0xb3, 0x69, 0x65, 0x97, 0xda, 0xa2, 0xb9, 0xd, 0x6, 0x6, 0x12, 0xb, 0x32, 0xc3, 0xbe, 0x56, 0xc9, 0xa5, 0xc0, 0xd7, 0x5d, 0x11, 0x45, 0x1a, 0x96, 0x45, 0xe7, 0xd3, 0x20, 0xf0, 0x48, 0xa4, 0xe1, 0xd3, 0xd2, 0x89, 0xe1, 0x28, 0xcb, 0x9c, 0xad, 0x61, 0xb9, 0x96, 0x7c, 0x26, 0x9c, 0x4d, 0x73, 0x21, 0xc9, 0x16, 0x53, 0x2e, 0xcb, 0x2e, 0xca, 0x1f, 0x78, 0x87, 0xae, 0x48, 0xf0, 0x21, 0xe6, 0x70, 0xd5, 0xe4, 0x6e, 0x13, 0x81, 0xe9, 0xdb, 0xe8, 0x5c, 0x58, 0xf3, 0xc4, 0xa7, 0x73, 0xec, 0xe1, 0x60, 0xf6, 0xa3, 0xf4, 0xf, 0xb0, 0xba, 0x7, 0x91, 0x22, 0x8c, 0x9, 0x73, 0xc1, 0xec, 0xe0, 0x8f, 0xc0, 0x4c, 0xc3, 0x29, 0xee, 0x9b, 0x9c, 0x4b, 0x1f, 0x2c, 0xb6, 0xdb, 0x90, 0xa4, 0x50, 0xb, 0x7d, 0xe2, 0x64, 0x63, 0x20, 0x3e, 0x87, 0xca, 0x2e, 0xa1, 0xd6, 0x2d, 0x7e, 0x74, 0xf7, 0x1a, 0xac, 0x91, 0x46, 0x3c, 0xbc, 0xc6, 0xe4, 0x24, 0x73, 0x33, 0x44, 0xa6, 0xac, 0xee, 0x92, 0x36, 0x41, 0xad, 0x99, 0x2d, 0xde, 0x40, 0xc5, 0x52, 0x6a, 0x98, 0xa5, 0x12, 0x75, 0xe4, 0xb1, 0x36, 0xac, 0xae, 0xf7, 0xf7, 0xe, 0x89, 0xf4, 0x6, 0x37, 0x1b, 0x2c, 0xab, 0x4d, 0x59, 0x75, 0x17, 0x54, 0x44, 0xa6, 0xcb, 0xcc, 0xa3, 0x1d, 0x0, 0x53, 0xb6, 0xa8, 0xb5, 0xd8, 0xe7, 0x52, 0x69, 0xc5, 0xab, 0xed, 0xda, 0x27, 0xea, 0x22, 0x6b, 0x47, 0x1e, 0x9b, 0xa7, 0xc3, 0x6a, 0xe3, 0x33, 0x4a, 0xa0, 0xd2, 0x9c, 0x67, 0x2f, 0x6e, 0xdc, 0xa8, 0x45, 0xd3, 0xee, 0xfb, 0x54, 0x5, 0x6a, 0x9d, 0x8e, 0x60, 0x59, 0x43, 0x8b, 0x65, 0xb4, 0x27, 0x43, 0xeb, 0xc7, 0x7c, 0x61, 0x3b, 0xa9, 0x86, 0x63, 0x41, 0x7d, 0xfe, 0x35, 0x18, 0x89, 0x76, 0x4c, 0xcb, 0x2a, 0x44, 0xf2, 0x9d, 0x5, 0x35, 0xd0, 0x5a, 0x89, 0xf7, 0x6d, 0xdf, 0xc7, 0x37, 0x4b, 0x0, 0x8e, 0x11, 0xd9, 0x3, 0x6e, 0x76, 0xca, 0x53, 0x8c, 0x83, 0x2d, 0x8b, 0x65, 0xbd, 0x9a, 0x62, 0x50, 0x66, 0x37, 0xdb, 0xc5, 0x61, 0xa2, 0x59, 0x48, 0x16, 0x51, 0x24, 0x4b, 0xdc, 0xf2, 0xa3, 0xce, 0xe1, 0x2e, 0x12, 0x69, 0xeb, 0x33, 0xfc, 0x2d, 0xfe, 0x40, 0xbf, 0x0, 0xb7, 0xd5, 0x4e, 0x65, 0x98, 0x25, 0x89, 0xb6, 0x9f, 0x60, 0x30, 0x40, 0x63, 0x5b, 0x15, 0xe3, 0xc8, 0x1e, 0x21, 0xc0, 0x6c, 0x1, 0xfb, 0x86, 0x3d, 0xb8, 0x82, 0x85, 0x68, 0x2e, 0x75, 0x76, 0x8f, 0xc, 0x5e, 0xab, 0xea, 0xb9, 0xa2, 0x49, 0xf8, 0xdb, 0x4b, 0x97, 0x6b, 0x60, 0x3c, 0xd4, 0xb7, 0x74, 0xbe, 0x4c, 0x8, 0x11, 0xa9, 0x16, 0x1b, 0x9d, 0x17, 0x23, 0x23, 0x9c, 0xdf, 0x95, 0xa2, 0xa0, 0x42, 0x9c, 0x9c, 0x98, 0xb5, 0x9f, 0x31, 0xae, 0x6, 0x7, 0xb7, 0x8c, 0xe9, 0x1, 0x72, 0xde, 0x8f, 0xaf, 0x22, 0xa2, 0x4, 0x4d, 0x9a, 0x46, 0x4a, 0xc7, 0x3, 0x36, 0x4a, 0xf6, 0xdb, 0x59, 0x56, 0xe3, 0x78, 0x5a, 0xf0, 0xd5, 0x3, 0xd4, 0xa3, 0x6b, 0xb2, 0x95, 0xa3, 0x23, 0x4c, 0x8b, 0x3, 0x2a, 0x6f, 0xf3, 0xa5, 0x24, 0xb3, 0x41, 0x28, 0xc5, 0x80, 0xf4, 0x92, 0xcb, 0xe0, 0x4, 0x21, 0x99, 0x21, 0xa4, 0xf8, 0x73, 0x24, 0xd5, 0xf6, 0x18, 0xc9, 0x1b, 0x50, 0x4d, 0xf0, 0xe2, 0xb8, 0x66, 0x20, 0xc2, 0x2b, 0x56, 0x27, 0xaa, 0x22, 0x99, 0x43, 0x33, 0x4e, 0x1b, 0x8d, 0x0, 0x1b, 0x54, 0xb, 0xcc, 0x19, 0x99, 0xce, 0x7c, 0x92, 0x28, 0x24, 0xc2, 0xb4, 0x8f, 0x20, 0x1c, 0x3, 0x9a, 0xc9, 0xb3, 0xf3, 0xe6, 0x18, 0x33, 0x58, 0x5c, 0xe6, 0x66, 0x11, 0x96, 0xf8, 0x2, 0x1a, 0x1a, 0xf2, 0x4f, 0xb1, 0xcb, 0xc5, 0x6b, 0x90, 0xb6, 0xe4, 0x1c, 0x8f, 0x67, 0x93, 0xb4, 0x77, 0xcb, 0x8d, 0x86, 0x43, 0x6, 0xd1, 0x2, 0xe5, 0x4a, 0x32, 0xad, 0xf1, 0xdb, 0xd6, 0xa2, 0x50, 0xd5, 0xc8, 0x52, 0x70, 0xd5, 0x69, 0xd7, 0xc7, 0xd0, 0x42, 0xa8, 0xdc, 0x39, 0x76, 0xed, 0x6b, 0xba, 0xe8, 0x5c, 0xec, 0x62, 0x6a, 0xc6, 0x2b, 0x69, 0xf9, 0xc5, 0x65, 0x2, 0x80, 0xeb, 0xcd, 0x4e, 0xed, 0x67, 0x9f, 0x69, 0xe9, 0x9d, 0x21, 0x1d, 0x95, 0x2e, 0x5, 0xd5, 0xb3, 0xac, 0x34, 0x70, 0x9b, 0x0, 0xc6, 0x9c, 0x99, 0x6f, 0x89, 0x88, 0xad, 0x95, 0x13, 0x45, 0xa1, 0x35, 0x16, 0xcf, 0x74, 0xd, 0x74, 0x5c, 0xbf, 0x54, 0xaa, 0xae, 0x8b, 0x9f, 0x48, 0x17, 0x37, 0x35, 0x2, 0x8c, 0xfc, 0x41, 0xdc, 0x2a, 0xd7, 0x58, 0xe4, 0xcd, 0x5f, 0x35, 0x38, 0xab, 0x42, 0xb4, 0x85, 0xbf, 0x43, 0x16, 0x7a, 0x71, 0x48, 0x85, 0xdf, 0xe1, 0x1c, 0xb6, 0x9c, 0xb1, 0x24, 0x49, 0xc, 0xb6, 0x24, 0x4e, 0x80, 0x18, 0xc2, 0x74, 0x8c, 0x94, 0xcd, 0xd2, 0x17, 0xa4, 0x5, 0xb9, 0xa3, 0x5, 0x89, 0xcc, 0x3e, 0x95, 0x54, 0x4d, 0x7, 0x13, 0xc3, 0x6, 0xbb, 0x4c, 0x10, 0x9c, 0x0, 0xdc, 0x9c, 0xb2, 0x3a, 0x1d, 0xfc, 0x27, 0x56, 0xfc, 0x21, 0xc1, 0x13, 0x98, 0xaa, 0x84, 0xfd, 0x65, 0x19, 0xd6, 0x51, 0x29, 0x8a, 0xd1, 0xe0, 0xce, 0xd6, 0x36, 0xda, 0x10, 0xd6, 0xee, 0x2d, 0xd8, 0x39, 0xdb, 0x22, 0x14, 0x4f, 0x4a, 0xd5, 0x19, 0x94, 0x1, 0x6a, 0x32, 0xfb, 0x80, 0x88, 0xd7, 0x9e, 0x65, 0x9c, 0x8b, 0x3f, 0x22, 0x5e, 0x44, 0xc, 0x47, 0x50, 0x23, 0xe2, 0xd0, 0xea, 0xe4, 0x1d, 0xd7, 0xb, 0x94, 0xe4, 0x1, 0x11, 0x15, 0x85, 0xd9, 0xd0, 0x45, 0xe, 0x31, 0x64, 0xcf, 0xbf, 0x21, 0x8a, 0xa2, 0xf5, 0x9, 0xb1, 0x81, 0xc, 0x8d, 0x9b, 0xb, 0xfa, 0xde, 0xfd, 0xcc, 0xaf, 0xa9, 0x84, 0x75, 0x5a, 0xc6, 0x28, 0x9f, 0xb3, 0xed, 0x66, 0x6a, 0xd4, 0x4f, 0xa8, 0x70, 0x1e, 0x44, 0xea, 0x70, 0xa3, 0xaa, 0xa4, 0xf5, 0xbd, 0x45, 0x9c, 0x10, 0x47, 0xdd, 0x8, 0x3c, 0x9e, 0x1f, 0xf5, 0xf3, 0xf3, 0x54, 0xba, 0xeb, 0xf3, 0x38, 0x8b, 0x4c, 0x4b, 0x37, 0xee, 0xbf, 0x17, 0xa0, 0xa2, 0x46, 0xb9, 0x87, 0xc4, 0x97, 0x5a, 0x6f, 0x80, 0x8a, 0x69, 0x3a, 0x3b, 0x66, 0x36, 0xc4, 0xff, 0x29, 0xac, 0xd, 0x3d, 0x35, 0x7d, 0xd7, 0x77, 0x78, 0x6f, 0xe2, 0x1, 0x63, 0xe4, 0x75, 0x75, 0xdc, 0x88, 0x65, 0x15, 0xa9, 0xd9, 0x90, 0x1, 0x95, 0x9, 0x34, 0x5d, 0x67, 0xd4, 0x7e, 0x4e, 0x6e, 0x46, 0xe5, 0x5c, 0xe3, 0x45, 0x43, 0xae, 0xc6, 0xfc, 0xf0, 0x99, 0xc0, 0xa7, 0x52, 0xf7, 0x3, 0xeb, 0xb7, 0x5b, 0x48, 0x6c, 0x25, 0xf8, 0x27, 0xbc, 0x6b, 0xfe, 0x97, 0x69, 0x4e, 0xef, 0x5c, 0x15, 0xb4, 0xe8, 0xc8, 0xfe, 0xde, 0xa3, 0x1, 0x1e, 0xc9, 0x9a, 0x46, 0x7a, 0xf7, 0xc6, 0x40, 0xd9, 0xca, 0xd1, 0x94, 0xba, 0xb2, 0x64, 0x23, 0x56, 0xfb, 0xb6, 0x98, 0xdb, 0x1d, 0xf7, 0x3d, 0xe2, 0x5a, 0x2, 0x3b, 0xb6, 0x98, 0x28, 0x3f, 0x49, 0x5b, 0x7, 0xbe, 0x27, 0xd9, 0x16, 0xc9, 0xe0, 0xf9, 0xa6, 0x46, 0x5f, 0x2d, 0x99, 0x7d, 0x8d, 0xb1, 0x25, 0xb2, 0x67, 0x7, 0xca, 0x9, 0x2a, 0x55, 0x3d, 0xa, 0xc9, 0xb8, 0xca, 0xd8, 0x3f, 0x92, 0xc3, 0x8a, 0x2e, 0xf5, 0x82, 0x65, 0x70, 0xbf, 0xd5, 0xdd, 0x4, 0xb5, 0xf4, 0x10, 0x3e, 0x29, 0xc4, 0x86, 0xa8, 0xb3, 0x6c, 0x98, 0xc8, 0xb6, 0x1e, 0x8d, 0x89, 0x2b, 0x9b, 0xf9, 0xb2, 0x28, 0xe1, 0x1e, 0x3e, 0xac, 0xcb, 0xc8, 0x97, 0xeb, 0xf4, 0xfd, 0x60, 0x26, 0x49, 0x3c, 0x1e, 0x97, 0xd1, 0x28, 0x52, 0xfb, 0xea, 0x17, 0x2f, 0x5b, 0xf5, 0x1, 0x69, 0x48, 0xcb, 0x3a, 0xdd, 0x9d, 0xe1, 0x3e, 0x4, 0x3e, 0xf1, 0x4, 0xcf, 0xe3, 0x94, 0x37, 0x52, 0x8d, 0x1a, 0x33, 0x82, 0x18, 0x53, 0x1e, 0xf8, 0x55, 0xb3, 0x4, 0xa7, 0x18, 0x55, 0x13, 0x11, 0x88, 0x7e, 0x2b, 0xa7, 0xbe, 0xb5, 0x5b, 0x8a, 0xe7, 0x36, 0x6d, 0x35, 0x93, 0x98, 0x16, 0xac, 0xa2, 0xed, 0x31, 0x57, 0x4c, 0xd9, 0xa6, 0x79, 0x8, 0x44, 0x72, 0xc2, 0x37, 0xd0, 0x67, 0xd9, 0x7a, 0xa4, 0x12, 0xd6, 0xce, 0xca, 0xe2, 0xb8, 0xb2, 0x22, 0x4d, 0xf0, 0x3a, 0xb0, 0x40, 0x43, 0x23, 0x7f, 0x2, 0x9c, 0xb6, 0xbb, 0xcc, 0x64, 0x9c, 0xe1, 0xb2, 0x6a, 0xd5, 0x84, 0x8b, 0xa5, 0x91, 0x51, 0xc9, 0xc0, 0x72, 0xa0, 0xc5, 0x13, 0x66, 0xfc, 0x73, 0x8, 0x41, 0x43, 0x4a, 0x4a, 0x9c, 0xc3, 0x3f, 0xc8, 0x75, 0x62, 0xe3, 0xbc, 0x8b, 0x5c, 0x34, 0x23, 0xc, 0x9d, 0x25, 0xc9, 0x27, 0xf1, 0x34, 0x76, 0xb3, 0x75, 0xca, 0xfb, 0x74, 0xf1, 0x79, 0x21, 0x40, 0xaa, 0xf2, 0x30, 0x63, 0xb, 0x69, 0xa2, 0xaa, 0xf5, 0x7b, 0x3a, 0xd4, 0x5f, 0x40, 0x7b, 0xfc, 0xd4, 0x93, 0x6c, 0x5a, 0x47, 0x51, 0xa, 0x1, 0xa, 0xc4, 0xa2, 0x3d, 0x54, 0xdd, 0x63, 0x6a, 0xb, 0xb7, 0x0, 0x6a, 0x25, 0x45, 0x29, 0x4, 0x86, 0xf2, 0x29, 0x92, 0x7c, 0x66, 0x69, 0xc7, 0xa2, 0x73, 0x85, 0x48, 0xb2, 0x5f, 0x2f, 0x23, 0x1d, 0xf1, 0xf8, 0x76, 0x1b, 0xe5, 0xd3, 0x46, 0x35, 0xf2, 0xbb, 0x8b, 0x7e, 0x4e, 0x72, 0x61, 0xc, 0xb0, 0x33, 0x6, 0x2f, 0x52, 0x4e, 0x61, 0xa6, 0x84, 0x20, 0x54, 0x5a, 0xb8, 0xe4, 0x60, 0x16, 0x99, 0x7b, 0x72, 0x62, 0xec, 0x94, 0x81, 0xe, 0x8d, 0xf4, 0x72, 0x9f, 0x60, 0xb2, 0xae, 0x90, 0x48, 0x4d, 0x69, 0xad, 0xe3, 0x9e, 0xe9, 0x9e, 0xe9, 0xf7, 0x40, 0x9d, 0x75, 0x77, 0xc7, 0x4c, 0xbd, 0x62, 0xcf, 0xa2, 0x3b, 0xb7, 0x54, 0xc4, 0x55, 0x3c, 0xd4, 0xf9, 0x54, 0x73, 0xa8, 0xd, 0xda, 0x4e, 0x65, 0xd1, 0xfa, 0x2, 0xbe, 0x69, 0x8a, 0x3e, 0xc3, 0x77, 0x33, 0xf4, 0x5b, 0x46, 0xc, 0x4e, 0xc0, 0xa5, 0xe2, 0xd5, 0x4, 0x4b, 0xab, 0x1, 0xfa, 0x3d, 0x5c, 0x8, 0x94, 0x61, 0xa, 0xb1, 0xa8, 0xe4, 0x53, 0xd2, 0x62, 0x7, 0x8a, 0xc4, 0x0, 0x8b, 0x2b, 0xd1, 0xf7, 0x0, 0x55, 0xac, 0x25, 0x8, 0xdc, 0x86, 0xca, 0x7, 0x3a, 0x40, 0xa7, 0x17, 0x79, 0x65, 0x67, 0x79, 0x71, 0x60, 0xe9, 0x70, 0xdb, 0x3d, 0x3b, 0x9a, 0xb9, 0x76, 0x26, 0xce, 0x3a, 0x39, 0xc6, 0x1d, 0x8b, 0xf, 0xf2, 0x72, 0xe9, 0x21, 0xe4, 0xd, 0x7, 0x6f, 0x2f, 0xeb, 0x8, 0xf8, 0xd3, 0x2, 0x31, 0x16, 0xb7, 0xb6, 0x79, 0xe3, 0x80, 0x9, 0x46, 0x10, 0xa7, 0xba, 0x5c, 0xbd, 0x45, 0x22, 0x9c, 0xc1, 0xde, 0xaf, 0xa3, 0x77, 0x4f, 0xe6, 0x14, 0x1b, 0x87, 0x70, 0x3d, 0x47, 0x63, 0x24, 0xcb, 0x6f, 0xcc, 0x18, 0x9, 0x95, 0x9c, 0x3f, 0xba, 0x91, 0xed, 0xa8, 0x2e, 0x79, 0x35, 0xb7, 0x5f, 0xb3, 0x47, 0x2f, 0xa5, 0xac, 0x52, 0xc3, 0x42, 0x62, 0xe9, 0xf3, 0xac, 0xad, 0x26, 0x24, 0x13, 0x86, 0x54, 0xc5, 0x20, 0x4e, 0xc, 0xb4, 0x94, 0x33, 0xcb, 0x6f, 0xed, 0x84, 0x6b, 0xb4, 0x71, 0x9d, 0x65, 0x2d, 0x74, 0xf2, 0xeb, 0x68, 0xdc, 0x4a, 0xf, 0xa0, 0xae, 0x74, 0x3, 0xc6, 0x15, 0x6b, 0x2a, 0x82, 0x9d, 0x66, 0x2c, 0x82, 0xa7, 0x88, 0xe5, 0xa4, 0x5a, 0xc0, 0x7, 0x6, 0x93, 0xe8, 0x2c, 0x6c, 0x54, 0xc7, 0x8e, 0xec, 0x44, 0x1, 0x93, 0x96, 0x84, 0x49, 0xd1, 0xc4, 0x71, 0x24, 0x85, 0xaa, 0x7, 0x67, 0xb0, 0xda, 0xc, 0xf3, 0xcd, 0xe5, 0x84, 0xaa, 0x40, 0x45, 0x7f, 0xf7, 0xc9, 0x1c, 0xae, 0x89, 0x22, 0xc6, 0x34, 0xd3, 0x7a, 0x68, 0x2e, 0xdd, 0x54, 0x83, 0xd5, 0xa9, 0xaf, 0xb2, 0x7f, 0xea, 0x2d, 0x63, 0x55, 0x88, 0x4a, 0x79, 0x50, 0xf4, 0x93, 0x54, 0x2b, 0x3e, 0x44, 0xf3, 0x78, 0x13, 0xf7, 0xf6, 0x83, 0x6f, 0x38, 0x4, 0x39, 0x81, 0xc5, 0x6c, 0xb2, 0x8d, 0xd7, 0xc9, 0x99, 0x35, 0x3d, 0x7c, 0x84, 0x87, 0x2d, 0x25, 0x2a, 0xd, 0x9b, 0x21, 0xc0, 0x18, 0xad, 0x29, 0xf2, 0x98, 0x61, 0x5c, 0x3d, 0xb5, 0xcd, 0x10, 0x71, 0x90, 0x2d, 0x99, 0x19, 0x5e, 0xcd, 0x7c, 0x9, 0xdb, 0xd8, 0x8d, 0xb2, 0xa9, 0x23, 0xb4, 0x5c, 0x88, 0x41, 0xd1, 0xcc, 0xc, 0xaa, 0xa1, 0x15, 0xe9, 0x12, 0x6b, 0xd0, 0x12, 0xaa, 0xf, 0x95, 0x2f, 0xf0, 0x49, 0xe1, 0x84, 0x7e, 0xb1, 0x65, 0x10, 0x32, 0xc5, 0xd3, 0xca, 0x22, 0x14, 0x55, 0x22, 0x0, 0x78, 0xe0, 0xb, 0xea, 0xa2, 0x31, 0x11, 0x48, 0x22, 0xa8, 0x96, 0x43, 0x74, 0xd2, 0xbc, 0xba, 0x32, 0xd, 0xc9, 0x86, 0x9d, 0xe1, 0xa3, 0x49, 0xe9, 0x82, 0x11, 0x2a, 0xdb, 0x30, 0x30, 0x5a, 0x8f, 0x75, 0x5d, 0x7b, 0xc0, 0x26, 0x81, 0x9c, 0xee, 0x99, 0xf0, 0xa8, 0x2f, 0x24, 0x56, 0x9c, 0x43, 0x1b, 0xe1, 0x8d, 0xb3, 0x53, 0x8b, 0x92, 0x2d, 0xa3, 0x55, 0x62, 0xdd, 0xea, 0x2f, 0x8a, 0x18, 0xc3, 0xb8, 0x84, 0xc8, 0x8c, 0x98, 0x22, 0x9, 0x99, 0xd6, 0xce, 0xc3, 0xe9, 0x33, 0x68, 0xb5, 0xf5, 0x19, 0xd4, 0x76, 0xb0, 0xc7, 0xf7, 0x69, 0x5c, 0x68, 0x1b, 0x21, 0x2f, 0x6c, 0x10, 0x4, 0x98, 0x29, 0xee, 0x30, 0xa9, 0x71, 0xf9, 0x0, 0x62, 0x3, 0x11, 0x52, 0xc2, 0xf0, 0x4b, 0x22, 0xa3, 0x6c, 0xb, 0x1f, 0xdc, 0x7d, 0xac, 0xa5, 0x5f, 0x15, 0x4b, 0xd, 0x1a, 0x9c, 0xca, 0x29, 0x5, 0x2d, 0x36, 0x12, 0x22, 0xc6, 0x4, 0x41, 0xad, 0xd6, 0x8a, 0x8b, 0x6e, 0x13, 0x12, 0x43, 0xfc, 0x4d, 0xec, 0x56, 0xc9, 0x32, 0x89, 0x59, 0x4a, 0xc4, 0xf9, 0xa9, 0x22, 0xe7, 0x6c, 0x4a, 0xf0, 0xaa, 0xb5, 0x29, 0x6b, 0xc5, 0xf, 0x45, 0x81, 0xec, 0x2e, 0xe2, 0x7e, 0xb2, 0x55, 0x2c, 0x2f, 0x54, 0x2e, 0x65, 0xe9, 0x5a, 0x2b, 0xe, 0x21, 0xde, 0x8, 0x13, 0xc6, 0x27, 0x60, 0x41, 0x68, 0x89, 0x3e, 0x1f, 0xf2, 0xd8, 0x51, 0x14, 0x9, 0x6e, 0x15, 0xc, 0xf9, 0xdd, 0xb0, 0xe9, 0xc8, 0x2a, 0x59, 0x65, 0x62, 0x81, 0xc6, 0x9d, 0x29, 0x79, 0x8e, 0x24, 0x45, 0xae, 0x4a, 0xf5, 0xee, 0xa6, 0x47, 0xf6, 0xd2, 0x5b, 0x36, 0xb7, 0xfe, 0x90, 0xf5, 0xb5, 0x86, 0x3d, 0xfb, 0xe8, 0xb1, 0xc8, 0x5f, 0x40, 0x53, 0x93, 0xcf, 0x17, 0xbf, 0xcc, 0xdd, 0x28, 0xaa, 0x29, 0x1c, 0xaf, 0x7d, 0x4, 0xb9, 0xf1, 0xd0, 0x2d, 0x58, 0xef, 0xed, 0x35, 0x92, 0x76, 0xf3, 0xd1, 0xfa, 0x6e, 0x6, 0x37, 0x77, 0x89, 0x46, 0x0, 0xfa, 0x3, 0xf1, 0x47, 0x9d, 0x86, 0x70, 0x46, 0x20, 0x3c, 0x43, 0x70, 0x4c, 0x95, 0xa2, 0xb4, 0x9b, 0xb3, 0x6b, 0x76, 0x20, 0x1c, 0x89, 0x60, 0x15, 0xeb, 0x27, 0x77, 0xb3, 0x1a, 0x8c, 0x12, 0x2a, 0x4c, 0xbb, 0x12, 0xd6, 0xd2, 0x46, 0x7b, 0x1c, 0x24, 0x2f, 0x42, 0xbd, 0x6, 0xcf, 0xcc, 0xd8, 0xa, 0x88, 0x65, 0xe4, 0xb2, 0x27, 0xd3, 0xb0, 0xf9, 0xb1, 0xd6, 0x3d, 0x12, 0x8e, 0x2a, 0x5f, 0xb5, 0x1b, 0x8d, 0xef, 0x47, 0xcc, 0x13, 0xbc, 0xfd, 0xb3, 0xa1, 0x32, 0xf5, 0xb4, 0xb9, 0xc9, 0x99, 0x48, 0x80, 0x7b, 0xb3, 0x10, 0x16, 0x32, 0x6d, 0x1c, 0xa7, 0x73, 0x70, 0x98, 0x74, 0x75, 0x35, 0x47, 0x30, 0xd7, 0x27, 0x13, 0xe0, 0x60, 0xeb, 0x20, 0x87, 0x8b, 0xfa, 0x80, 0x71, 0x69, 0x68, 0x3e, 0xe1, 0x56, 0x9f, 0x82, 0xa0, 0x1d, 0x97, 0x26, 0x54, 0xb, 0x8b, 0x70, 0xf, 0x8f, 0x66, 0x73, 0x95, 0xb, 0x5, 0xd9, 0x2f, 0x97, 0xd2, 0x52, 0xc8, 0xe6, 0xcf, 0x25, 0x6, 0x9f, 0x81, 0x17, 0x45, 0xf0, 0x8e, 0x41, 0x19, 0xfb, 0x99, 0x81, 0xd7, 0x90, 0x25, 0xad, 0xc9, 0x4, 0x52, 0xcf, 0xa7, 0x6b, 0x27, 0xbe, 0xe2, 0xe1, 0x59, 0x72, 0x89, 0x9f, 0x51, 0x3f, 0xf6, 0xa4, 0x1f, 0xbf, 0x5, 0xd2, 0x2d, 0x25, 0xca, 0x62, 0x12, 0x8e, 0x75, 0x3, 0x20, 0x59, 0x29, 0xdd, 0x14, 0xd9, 0x5c, 0x9, 0xd7, 0x22, 0x35, 0xf2, 0xc0, 0x57, 0xb9, 0xb1, 0xea, 0x8f, 0xb1, 0xb1, 0xfa, 0x33, 0x70, 0xe7, 0x94, 0xb1, 0xbf, 0xcb, 0x7b, 0x92, 0x8e, 0x81, 0x2d, 0x34, 0xe2, 0x2b, 0xdb, 0x12, 0x5e, 0x84, 0x22, 0xbf, 0x75, 0xba, 0xbd, 0x27, 0xf5, 0xdb, 0x36, 0xa0, 0x72, 0x12, 0x3c, 0xf1, 0xac, 0x88, 0x4a, 0xca, 0x43, 0xab, 0x74, 0x8d, 0x15, 0xb5, 0x44, 0x94, 0x4b, 0x4d, 0x61, 0x9a, 0x8d, 0xe9, 0xca, 0xd6, 0xa4, 0xff, 0x1e, 0x80, 0xb9, 0x3, 0xf3, 0xb8, 0x53, 0x17, 0x40, 0xe2, 0x2d, 0x34, 0xc0, 0x69, 0xa3, 0x74, 0xd1, 0x27, 0xde, 0x3e, 0x95, 0x4c, 0xf0, 0x73, 0x81, 0x14, 0x95, 0x1d, 0xb1, 0x36, 0x5c, 0x5d, 0xff, 0x3a, 0xf9, 0x87, 0x32, 0x8e, 0x38, 0xa9, 0xe4, 0xea, 0xd4, 0x54, 0x92, 0xb4, 0xbe, 0x9d, 0x1, 0x22, 0xc6, 0x31, 0xe0, 0x27, 0x26, 0xd8, 0x41, 0x55, 0xba, 0x4a, 0x6, 0xc3, 0x27, 0x3, 0x9a, 0xb9, 0x6a, 0x36, 0x1b, 0x23, 0x42, 0x7e, 0x5d, 0x8e, 0x70, 0xca, 0x77, 0x95, 0x9c, 0x7c, 0xbc, 0x87, 0x63, 0x3, 0x46, 0x24, 0xf, 0xf6, 0x92, 0xa2, 0xc2, 0x9a, 0xc2, 0x1c, 0x8a, 0x6c, 0xf4, 0x0, 0x32, 0xc2, 0xdb, 0x10, 0xc9, 0xa3, 0xbe, 0x7c, 0xb1, 0x3d, 0x48, 0xe7, 0x3d, 0xaa, 0x5a, 0x8d, 0xb7, 0xac, 0x96, 0xbf, 0x4c, 0x65, 0xa3, 0x91, 0xb8, 0xca, 0x25, 0xce, 0xa1, 0xb1, 0xb3, 0xf3, 0x9b, 0xb1, 0xd2, 0xe2, 0xa3, 0x9c, 0xed, 0xe8, 0x3a, 0x8d, 0xb9, 0xd3, 0xa7, 0xd5, 0x9, 0xfc, 0xd5, 0x8c, 0xe5, 0xea, 0x65, 0xa, 0xfa, 0xf6, 0xe4, 0x95, 0x74, 0x42, 0xfd, 0x21, 0x81, 0x86, 0xbf, 0x0, 0x54, 0xa4, 0x7, 0xd6, 0xd3, 0x5f, 0x23, 0xa4, 0xb2, 0xf0, 0xb0, 0x18, 0x9e, 0x8e, 0x17, 0x4c, 0x6d, 0x9a, 0x58, 0xe4, 0x9b, 0xce, 0x5d, 0x3b, 0xad, 0x3, 0x92, 0x8a, 0x3f, 0xa8, 0xa8, 0xe4, 0xec, 0x42, 0xd6, 0x13, 0x2e, 0xe7, 0x61, 0x20, 0x8d, 0x68, 0x55, 0x35, 0x6b, 0x7f, 0x50, 0x5c, 0xe0, 0x70, 0x21, 0x6a, 0x9b, 0x50, 0xd, 0xdb, 0xd8, 0xd9, 0xc3, 0x32, 0x7d, 0xb9, 0x2c, 0xbb, 0xe0, 0xb7, 0x57, 0xd9, 0xaf, 0x9b, 0x15, 0x68, 0x2e, 0xba, 0x78, 0x7a, 0x57, 0x8a, 0xd4, 0xf2, 0xf4, 0xc2, 0xe9, 0x56, 0x9f, 0x64, 0x8b, 0x34, 0x2, 0xc6, 0x8c, 0x23, 0x84, 0x7c, 0x54, 0x29, 0x7e, 0x43, 0x25, 0x4, 0xc3, 0xca, 0x90, 0xbb, 0xcf, 0x34, 0x73, 0x92, 0xeb, 0xa0, 0xa9, 0x32, 0xda, 0xa1, 0x7, 0x72, 0xd2, 0x6f, 0x77, 0x84, 0x7e, 0xf9, 0x14, 0x25, 0xea, 0x88, 0x7a, 0x7c, 0x72, 0x8a, 0x1f, 0x91, 0x18, 0xc1, 0xa0, 0x27, 0xef, 0x28, 0xf5, 0xc7, 0x68, 0x0, 0x96, 0x5b, 0x8c, 0xba, 0x7c, 0xf8, 0x56, 0x91, 0x7b, 0x9c, 0x4b, 0x18, 0x32, 0xf2, 0x36, 0x65, 0x78, 0xb3, 0x8f, 0x48, 0xf0, 0xde, 0x8a, 0x6e, 0x16, 0x66, 0xa1, 0xe3, 0x53, 0xf9, 0xd, 0x5e, 0x66, 0xad, 0xe8, 0xbb, 0xe8, 0x2b, 0x87, 0x9d, 0xf, 0x45, 0x4a, 0x9, 0x36, 0xa7, 0x5f, 0xa, 0x98, 0xa8, 0xc6, 0x3f, 0x56, 0x21, 0x4, 0xe1, 0x47, 0xdf, 0x6, 0xd1, 0x5d, 0xdd, 0xca, 0x99, 0x5a, 0xfa, 0x65, 0x82, 0xa2, 0xf7, 0xd9, 0xa7, 0xf0, 0xb1, 0x24, 0xe1, 0x6, 0xc7, 0x1, 0xa9, 0x22, 0x52, 0xc5, 0xfe, 0x98, 0x22, 0x4e, 0xd5, 0xf0, 0x63, 0x68, 0x53, 0x1, 0xf5, 0xad, 0x7d, 0x98, 0x4f, 0x6c, 0x11, 0x6, 0xf3, 0x84, 0xb8, 0x8a, 0xbc, 0xcc, 0x8a, 0x7e, 0x6, 0x93, 0x6b, 0x94, 0x75, 0x2d, 0xba, 0x7f, 0x1, 0xbc, 0x15, 0xf2, 0xb, 0x82, 0x36, 0x28, 0x67, 0x4d, 0xc, 0xb0, 0xb9, 0x40, 0xd4, 0x92, 0x44, 0xe8, 0xbd, 0x55, 0xc2, 0xbb, 0xed, 0x72, 0x7e, 0xb1, 0x50, 0xfd, 0xd4, 0xdc, 0xf5, 0xda, 0xd6, 0xe, 0x43, 0xdc, 0x58, 0x5, 0x66, 0xde, 0x7a, 0x78, 0xc8, 0x2b, 0xaf, 0x58, 0x31, 0xef, 0xbd, 0xb6, 0xa4, 0x6e, 0x76, 0xb3, 0x6a, 0x35, 0x8e, 0xe9, 0x1b, 0x8b, 0xd0, 0x5a, 0x31, 0x57, 0xf9, 0xa4, 0x14, 0x9e, 0x51, 0x8b, 0x92, 0x3, 0x71, 0xc4, 0x8a, 0x5f, 0x1a, 0xee, 0x4, 0x4b, 0x6c, 0x71, 0x38, 0x33, 0x1e, 0x46, 0x2c, 0x56, 0xaf, 0x9c, 0x60, 0x2, 0xc5, 0x88, 0xc, 0x79, 0x3, 0xe, 0xf, 0xb3, 0x38, 0x6a, 0x19, 0x28, 0xcf, 0x35, 0xa9, 0xe2, 0x5b, 0x92, 0x2d, 0x5e, 0x92, 0xed, 0x5c, 0x88, 0xbd, 0xcc, 0xf0, 0x6f, 0x2e, 0xf4, 0x7d, 0x8, 0xbf, 0xa3, 0x8a, 0x7e, 0xa7, 0xc3, 0x97, 0x1b, 0x18, 0x4f, 0x39, 0xeb, 0x47, 0x6, 0x6, 0xd8, 0x29, 0x11, 0x2, 0x2c, 0x0, 0xd4, 0x85, 0x99, 0xcf, 0xc3, 0x4b, 0x9f, 0x4d, 0xad, 0x42, 0x94, 0x35, 0xc4, 0xba, 0x43, 0x7f, 0x46, 0xc, 0x7f, 0x6b, 0xaf, 0x15, 0x2e, 0xbf, 0x87, 0x6, 0x5d, 0xeb, 0x2d, 0xcb, 0xbf, 0x99, 0x5f, 0xe0, 0x5, 0xdc, 0xef, 0x8b, 0x2f, 0x46, 0x8c, 0x3c, 0xc1, 0x62, 0x93, 0x1c, 0x89, 0xbe, 0x68, 0xfa, 0xb4, 0x86, 0xce, 0x1b, 0xb1, 0xdc, 0x47, 0x3e, 0x73, 0x2c, 0xf4, 0x94, 0xd9, 0x1a, 0xeb, 0xf9, 0x73, 0xb4, 0xb1, 0x59, 0xff, 0x88, 0x16, 0x54, 0x46, 0x7, 0x31, 0xeb, 0xc, 0x64, 0xd9, 0x92, 0xc, 0xb6, 0x3e, 0xe9, 0x80, 0x8f, 0x89, 0xbc, 0x13, 0x93, 0x7, 0x25, 0x5b, 0xc4, 0xaf, 0xe1, 0xcf, 0xa0, 0x8e, 0x31, 0x64, 0xa4, 0xcd, 0x73, 0x46, 0x1a, 0x5, 0x15, 0x23, 0x94, 0x55, 0x6b, 0x56, 0x31, 0x45, 0x4a, 0xe9, 0x5e, 0xea, 0xdc, 0x70, 0x5c, 0x27, 0x5e, 0x3, 0xc, 0x64, 0xe8, 0x1d, 0x84, 0x95, 0xb5, 0x3b, 0x65, 0xe5, 0x63, 0x75, 0x5a, 0x15, 0x3f, 0xe5, 0xfa, 0x84, 0x30, 0x89, 0x40, 0xba, 0x94, 0x5c, 0xcc, 0x84, 0x4f, 0x6, 0x40, 0xf8, 0x42, 0x4c, 0xf1, 0xa6, 0x3e, 0xd, 0x2c, 0xb8, 0xa3, 0xa, 0xc7, 0xce, 0x3d, 0x4f, 0xba, 0xdf, 0xfd, 0x5f, 0x58, 0xd2, 0x87, 0x1a, 0x8a, 0xab, 0x17, 0x56, 0xf6, 0x1d, 0x85, 0xd7, 0x6f, 0x15, 0xb9, 0xad, 0xf4, 0x16, 0x70, 0x7a, 0xc8, 0xe6, 0x45, 0xc3, 0x99, 0xb1, 0x26, 0x92, 0xec, 0x3, 0xc, 0xf6, 0xf7, 0xef, 0x90, 0x8e, 0x16, 0x49, 0x2d, 0xe2, 0xba, 0x91, 0xd9, 0xbc, 0x68, 0xdc, 0x7f, 0xf1, 0x4, 0xc7, 0xda, 0x85, 0x40, 0x59, 0xec, 0x3e, 0x85, 0x99, 0x98, 0x63, 0xac, 0x86, 0x24, 0xa9, 0xe9, 0x7, 0x8c, 0x35, 0x73, 0x94, 0x14, 0xda, 0xa1, 0x11, 0xc, 0xff, 0xa8, 0xd4, 0x55, 0xf9, 0x9c, 0x9b, 0xec, 0x92, 0xd4, 0x9e, 0x6a, 0x6a, 0x14, 0xf5, 0x7f, 0x5, 0x6b, 0xc, 0x94, 0xf3, 0xc7, 0x52, 0xfb, 0x3b, 0x8b, 0xe9, 0xa, 0xdb, 0xcf, 0x54, 0xa3, 0x6d, 0x45, 0x4e, 0xa, 0x63, 0x42, 0xb4, 0xd3, 0x50, 0x1b, 0x8a, 0xcb, 0x45, 0x94, 0x11, 0x33, 0x50, 0xb1, 0xe1, 0xb9, 0x5, 0x91, 0xd0, 0x80, 0x3b, 0xa3, 0x9c, 0x8c, 0x21, 0x66, 0xa, 0xb4, 0x20, 0xc4, 0x44, 0x4, 0xa, 0xd4, 0x59, 0xea, 0xe0, 0x0, 0x60, 0x60, 0x80, 0x2f, 0xf4, 0x43, 0xb, 0xc6, 0x2e, 0x30, 0xaa, 0x1a, 0xb8, 0x92, 0x2d, 0xd0, 0xf7, 0x18, 0xd7, 0xe, 0x7d, 0xc1, 0x42, 0x6b, 0x42, 0x7, 0x5, 0xca, 0x7c, 0x11, 0x52, 0xc7, 0xbb, 0xee, 0x51, 0x9e, 0xa, 0x1a, 0xa3, 0x46, 0x29, 0xb3, 0xc1, 0x37, 0x3b, 0x34, 0x78, 0xb9, 0x52, 0x0, 0x3c, 0xf0, 0xc4, 0x16, 0xc2, 0xec, 0x2b, 0xea, 0x44, 0x89, 0xd2, 0xf5, 0x53, 0xca, 0x18, 0x3f, 0x10, 0xa1, 0x3a, 0x8, 0x5a, 0x5, 0x23, 0xd8, 0x44, 0x65, 0xb7, 0x4, 0xe0, 0x59, 0x42, 0x6a, 0x52, 0x54, 0x66, 0xd4, 0x7d, 0xa0, 0x43, 0x4, 0xe5, 0x3f, 0x32, 0xe1, 0xdd, 0xc3, 0x74, 0xa5, 0x12, 0x21, 0x2a, 0x9a, 0x22, 0xad, 0xc3, 0x43, 0x40, 0x56, 0x76, 0x81, 0x74, 0x4a, 0x64, 0x33, 0x9e, 0x7b, 0x83, 0x59, 0xb3, 0x91, 0xcc, 0x55, 0x6a, 0x6f, 0x69, 0x91, 0x4a, 0x80, 0xb4, 0xa0, 0xeb, 0xd0, 0xcc, 0xbc, 0xab, 0xfc, 0xcc, 0xbc, 0x6, 0x4c, 0x45, 0xbe, 0xf7, 0xd, 0xaa, 0x98, 0x88, 0xe6, 0x10, 0x18, 0x9, 0x12, 0xf9, 0x5, 0x83, 0xc2, 0xa8, 0x5d, 0x55, 0x78, 0x98, 0x8a, 0xbf, 0x3, 0x86, 0x4, 0xc3, 0xb5, 0x40, 0x6b, 0x84, 0xb4, 0x11, 0xd2, 0xe8, 0x40, 0x37, 0x80, 0xe4, 0x86, 0xab, 0x5f, 0xe, 0xe2, 0xc4, 0xed, 0x9e, 0xe6, 0x6a, 0x29, 0xf5, 0x12, 0x3, 0x4d, 0x62, 0xb9, 0xd3, 0x55, 0x51, 0xd8, 0xe4, 0x58, 0x9e, 0xf1, 0x41, 0x8b, 0x7a, 0xf2, 0xc0, 0x28, 0xae, 0x4, 0xd3, 0xe5, 0x68, 0x7a, 0x80, 0x6f, 0xba, 0x50, 0xbd, 0xdc, 0xdd, 0x23, 0xf1, 0x61, 0xb4, 0x9, 0xa7, 0x46, 0x54, 0x2, 0x8d, 0x69, 0x44, 0xa5, 0xad, 0x70, 0xf7, 0xa9, 0xbf, 0x11, 0xe, 0x25, 0x39, 0x72, 0xfe, 0x26, 0xc4, 0x5e, 0xbe, 0xd3, 0x8a, 0x19, 0xfe, 0x9, 0x6e, 0xbc, 0x1f, 0xc8, 0x68, 0xee, 0x17, 0x17, 0xa4, 0x3e, 0xec, 0xc3, 0x51, 0x29, 0xca, 0xaf, 0x88, 0x7a, 0x2e, 0xfc, 0x45, 0x4c, 0x2f, 0xb4, 0xee, 0x1f, 0xa4, 0x2a, 0xac, 0x7d, 0xa0, 0x1c, 0x52, 0x6c, 0x4e, 0x21, 0x7b, 0x48, 0x58, 0xca, 0xa7, 0x1d, 0x6e, 0x82, 0x96, 0x8, 0x8, 0x2, 0x1b, 0x3e, 0xa2, 0x3a, 0x20, 0x79, 0x4, 0xa4, 0xe0, 0x45, 0xe4, 0x2c, 0xc8, 0x84, 0x69, 0xe8, 0x9b, 0x76, 0x1, 0xde, 0x4c, 0x6, 0x4a, 0x8b, 0x84, 0xb8, 0x2d, 0xc2, 0x18, 0x31, 0x6, 0x18, 0x22, 0xd5, 0x6c, 0x27, 0x15, 0x81, 0x76, 0x86, 0x2b, 0x8d, 0x22, 0xd4, 0x3c, 0x9f, 0x4c, 0xaa, 0xb3, 0x27, 0xa, 0x94, 0x5d, 0xe4, 0x74, 0xe, 0x2b, 0xd4, 0x12, 0xf, 0x3c, 0x8b, 0x87, 0xd, 0xe, 0x26, 0xe, 0x0, 0x7e, 0xe4, 0x4b, 0xb1, 0x52, 0x9d, 0xc1, 0xea, 0x21, 0xc9, 0x8c, 0x59, 0x9d, 0xbd, 0xc1, 0x81, 0xae, 0x2e, 0x78, 0x98, 0x72, 0x28, 0x56, 0xb9, 0x99, 0x43, 0xd5, 0x55, 0x29, 0xbe, 0x52, 0x17, 0x8d, 0xf2, 0x4d, 0x2e, 0xf0, 0x27, 0x5, 0x17, 0xe5, 0x70, 0x80, 0xa, 0xb4, 0x18, 0x1e, 0x23, 0x96, 0x26, 0xca, 0xaa, 0xfc, 0x3e, 0x96, 0xe8, 0xe9, 0xaf, 0x33, 0xe9, 0x90, 0xee, 0x6c, 0x8f, 0x55, 0xa, 0xbe, 0xc7, 0xf2, 0x1d, 0x21, 0x7e, 0xd8, 0x81, 0xdf, 0xec, 0x12, 0x34, 0xc5, 0xf3, 0x1b, 0xa5, 0x2f, 0x88, 0x6, 0x85, 0x83, 0xa, 0x9b, 0xc, 0xf8, 0xb0, 0x97, 0xb0, 0x25, 0x97, 0x5, 0x48, 0xd5, 0xc4, 0x5a, 0x10, 0x2c, 0xb8, 0xc1, 0xa6, 0x70, 0x44, 0x2d, 0x51, 0x70, 0xd0, 0x80, 0xc, 0xa8, 0x4b, 0x5a, 0xc7, 0xd4, 0x4, 0xc8, 0xae, 0x32, 0xb1, 0x8f, 0x31, 0xca, 0x2e, 0xdd, 0x1f, 0x13, 0x85, 0x2b, 0xaa, 0xe0, 0x96, 0xc4, 0xe2, 0xa5, 0xae, 0x14, 0x13, 0x25, 0x2d, 0x51, 0x6d, 0x5a, 0xb5, 0x95, 0x3e, 0xf5, 0xf2, 0xea, 0xd8, 0x44, 0x5c, 0x6e, 0x19, 0x89, 0xe, 0xa8, 0xa4, 0xbb, 0xe1, 0xb6, 0x37, 0x5f, 0x90, 0x76, 0x84, 0xd8, 0x9c, 0x31, 0xea, 0x51, 0x71, 0x76, 0xc, 0x1d, 0xfe, 0x12, 0xcd, 0xe2, 0x0, 0xd6, 0xc8, 0x65, 0x3, 0x28, 0x15, 0xb, 0x67, 0x24, 0x68, 0xbb, 0x2f, 0x4b, 0x83, 0x88, 0x78, 0x11, 0xe5, 0x8b, 0x8c, 0x20, 0xb9, 0x5c, 0x5b, 0x6e, 0xab, 0xd4, 0x4d, 0x56, 0x87, 0xca, 0x68, 0x39, 0x3d, 0x41, 0x2, 0x1c, 0x35, 0xf0, 0x8c, 0x75, 0x83, 0x49, 0xc4, 0x65, 0x6d, 0x91, 0xf5, 0x82, 0x2f, 0x2b, 0x7c, 0x41, 0xbb, 0xf9, 0xd3, 0x3, 0x94, 0x7e, 0x25, 0x41, 0x42, 0xd5, 0xc3, 0xf9, 0x3b, 0x97, 0x51, 0xc0, 0xa5, 0x5d, 0x4a, 0xb2, 0xae, 0x71, 0xce, 0xcb, 0x19, 0x4, 0xf3, 0x84, 0x5b, 0xd8, 0xdc, 0x39, 0xa0, 0xf4, 0x46, 0xa1, 0xc9, 0x21, 0xcd, 0x20, 0xdd, 0x20, 0xed, 0x9a, 0x9a, 0xd7, 0x4, 0x1b, 0xa4, 0x95, 0x68, 0x6, 0x52, 0xa8, 0xd1, 0x43, 0x4b, 0x83, 0xb4, 0xe0, 0x19, 0x1b, 0x1c, 0x9b, 0x11, 0x16, 0x14, 0xd6, 0xc9, 0x3a, 0x40, 0xd7, 0x49, 0x48, 0xf9, 0x8c, 0x3, 0x96, 0x3, 0x2a, 0xf4, 0xd1, 0x1e, 0x64, 0xd1, 0xa9, 0x65, 0x52, 0xce, 0xcc, 0x34, 0xda, 0x2a, 0x92, 0x31, 0x1b, 0x64, 0xe0, 0x8b, 0xee, 0x0, 0xe5, 0x21, 0x76, 0xa, 0x5, 0x5c, 0xa3, 0x71, 0x6b, 0x58, 0x7b, 0x89, 0x1b, 0x5d, 0xba, 0x4a, 0x2f, 0x57, 0xf5, 0x31, 0xf9, 0x70, 0x4f, 0x31, 0x69, 0xcd, 0x40, 0x18, 0xb9, 0x4, 0x6c, 0x76, 0x7f, 0x91, 0x6e, 0x22, 0x52, 0x5b, 0x8, 0x32, 0x12, 0x1f, 0x68, 0x2f, 0xcb, 0xaf, 0x1, 0x19, 0x81, 0x53, 0x9c, 0x9b, 0x1c, 0x5e, 0x4b, 0x9a, 0x5a, 0x79, 0x8e, 0x42, 0x9f, 0x10, 0x19, 0xa5, 0x5e, 0xd9, 0x4d, 0x7b, 0xf4, 0x96, 0xb6, 0x20, 0xb, 0xb1, 0x29, 0xe2, 0x58, 0xdf, 0xb0, 0x30, 0x8b, 0xa1, 0x3, 0xd5, 0x20, 0x40, 0xf1, 0x4f, 0xe4, 0xc3, 0xd, 0x9a, 0x11, 0x20, 0xd9, 0x6c, 0x41, 0xb, 0xd9, 0x16, 0xd8, 0xf, 0xcc, 0xa4, 0x79, 0xb8, 0x85, 0xfb, 0x9e, 0x46, 0x51, 0xaa, 0x15, 0x10, 0xab, 0xa2, 0x63, 0xde, 0xf4, 0xa0, 0x2a, 0xa0, 0x13, 0x46, 0xec, 0xb3, 0x58, 0xfd, 0x4e, 0x6a, 0xb6, 0x29, 0x5a, 0xa0, 0xa5, 0xda, 0x1f, 0x25, 0xa2, 0x2c, 0x10, 0x0, 0xe0, 0x5f, 0x94, 0x56, 0xa4, 0x1a, 0x9a, 0x5c, 0x18, 0x5c, 0xa6, 0x59, 0xb, 0x3a, 0x1d, 0xd9, 0x9d, 0x4c, 0x3d, 0x2c, 0x75, 0x5e, 0xc0, 0x15, 0xa, 0xc0, 0xe3, 0x84, 0x8, 0x39, 0xb, 0x82, 0x70, 0xe5, 0x21, 0xa4, 0xdd, 0x21, 0x40, 0xca, 0xb4, 0x9e, 0x4d, 0xe9, 0x6, 0xce, 0xd5, 0xe2, 0x2d, 0x8f, 0xe3, 0x5, 0x0, 0x30, 0xea, 0x16, 0xca, 0xa5, 0x37, 0x0, 0x7f, 0xe2, 0x2d, 0xd5, 0x10, 0x4f, 0x73, 0x2f, 0x71, 0x66, 0xc5, 0xcc, 0xe1, 0x1c, 0x5a, 0xc, 0xc7, 0x0, 0x8d, 0xba, 0x88, 0x6d, 0x3e, 0xd3, 0x6, 0x3c, 0xa8, 0x5a, 0x67, 0x92, 0x5b, 0xc3, 0x6c, 0x8a, 0xd4, 0xb3, 0xa8, 0x56, 0x53, 0x5c, 0x9c, 0x2c, 0xac, 0xd8, 0x52, 0xb1, 0x72, 0x6a, 0x32, 0xeb, 0x5c, 0x3, 0xa2, 0x32, 0xaf, 0xe0, 0x71, 0x1a, 0x8f, 0x4f, 0xe4, 0x6c, 0xc5, 0x4b, 0xa, 0x3b, 0xe2, 0x2a, 0xb5, 0x8a, 0xa0, 0x25, 0xf6, 0xa9, 0x60, 0xd8, 0xc0, 0x4e, 0x42, 0x10, 0xf2, 0xbd, 0x22, 0x9c, 0x49, 0x85, 0x4c, 0xc6, 0xb1, 0xf0, 0x46, 0x88, 0x10, 0xa1, 0x5d, 0xa5, 0xc2, 0x6c, 0xa8, 0x57, 0xa2, 0x4c, 0xeb, 0xc1, 0xd1, 0x5c, 0x91, 0xa5, 0xb0, 0x12, 0x37, 0x62, 0x65, 0x21, 0x40, 0x4, 0xa8, 0xc3, 0x60, 0xda, 0x45, 0xab, 0x4c, 0xd0, 0x40, 0x82, 0xc4, 0x47, 0x94, 0x14, 0x29, 0xe2, 0x8c, 0x68, 0xc8, 0xa9, 0xe1, 0x1d, 0x8, 0xcc, 0x6f, 0x20, 0x7c, 0x16, 0x81, 0x4f, 0xcc, 0x8f, 0x67, 0xa9, 0x42, 0x9d, 0x63, 0x97, 0x3c, 0xae, 0x2f, 0x65, 0xb7, 0x2b, 0xe, 0x92, 0x23, 0x32, 0x1, 0xdb, 0xa6, 0x83, 0x3, 0x74, 0xca, 0xb, 0xa, 0x88, 0x1f, 0xf7, 0x0, 0x61, 0x5e, 0x8, 0x23, 0xc1, 0x2c, 0xf2, 0x5f, 0x72, 0xca, 0xe6, 0x35, 0xe6, 0x70, 0x85, 0xf4, 0x41, 0x53, 0x72, 0xfc, 0xcc, 0xe0, 0xfd, 0xcb, 0x9, 0x6c, 0x4a, 0x15, 0x67, 0xbc, 0xe2, 0x62, 0xc5, 0x42, 0xae, 0xb0, 0x38, 0xf9, 0x80, 0x1a, 0xe8, 0xb0, 0xe6, 0x88, 0xf3, 0x98, 0x56, 0x36, 0x3c, 0x57, 0x80, 0x33, 0x93, 0x2a, 0xa4, 0xb9, 0xaa, 0xbe, 0xa1, 0xc3, 0xb6, 0xa8, 0x78, 0x21, 0x4a, 0x28, 0x28, 0xa0, 0x24, 0xf2, 0xd8, 0x25, 0x7e, 0x9, 0xc7, 0xe0, 0x7f, 0x27, 0x53, 0x84, 0x7b, 0x9c, 0x7e, 0xd3, 0x99, 0xf3, 0x3a, 0x7d, 0x63, 0x9f, 0xe9, 0xc9, 0x9f, 0xf1, 0xfa, 0x9f, 0xb5, 0xfe, 0x4f, 0xfa, 0xbe, 0x67, 0xed, 0x7f, 0x98, 0xff, 0x0, 0x87, 0xd4, 0xfd, 0xaf, 0xa6, 0x4e, 0x1f, 0x24, 0xfd, 0xbf, 0xf3, 0x3f, 0xea, 0x78, 0xfa, 0xb1, 0x47, 0xfd, 0xaf, 0x12, 0x72, 0xf8, 0xff, 0x0, 0x63, 0x84, 0x87, 0xf6, 0x47, 0x34, 0x3c, 0xce, 0x1f, 0x47, 0x2f, 0xa1, 0xe2, 0x77, 0x1c, 0xbe, 0x8f, 0x28, 0xf2, 0x47, 0x87, 0xcc, 0xff, 0x0, 0x14, 0xe5, 0xf, 0xdc, 0xfa, 0x17, 0x37, 0xcf, 0xfb, 0x3f, 0x82, 0x7f, 0x7f, 0xa3, 0xfb, 0x5f, 0xe4, 0xff, 0xc4, 0x0, 0x34, 0x11, 0x0, 0x1, 0x3, 0x3, 0x2, 0x5, 0x2, 0x4, 0x4, 0x6, 0x3, 0x0, 0x0, 0x0, 0x0, 0x0, 0x1, 0x0, 0x2, 0x11, 0x12, 0x21, 0x31, 0x3, 0x41, 0x10, 0x22, 0x32, 0x42, 0x51, 0x52, 0x61, 0x13, 0x62, 0x71, 0x72, 0x23, 0x81, 0x82, 0x92, 0x20, 0x33, 0x91, 0xa2, 0xb2, 0xc2, 0x4, 0x43, 0xb1, 0xff, 0xda, 0x0, 0x8, 0x1, 0x2, 0x1, 0x1, 0x3f, 0x0, 0x25, 0xd3, 0x92, 0x84, 0xf9, 0x2a, 0xfe, 0x4a, 0xbf, 0x92, 0x81, 0x28, 0x9d, 0xd0, 0x71, 0x73, 0xa3, 0xa1, 0x57, 0x0, 0x34, 0xd4, 0x61, 0xe4, 0x54, 0xce, 0xe4, 0x1e, 0x5a, 0xe7, 0x4b, 0x7a, 0x85, 0x4c, 0xa8, 0xf6, 0xad, 0x32, 0xee, 0x50, 0x47, 0xcd, 0x57, 0xca, 0x9c, 0xdf, 0x72, 0xae, 0x37, 0x28, 0x93, 0x19, 0x41, 0xc7, 0xc9, 0x52, 0x63, 0x2a, 0x4f, 0x94, 0x49, 0xf2, 0x54, 0x9f, 0x25, 0x49, 0xf2, 0x55, 0x47, 0xc9, 0x40, 0x99, 0xca, 0x93, 0xe5, 0x49, 0xf2, 0x50, 0x26, 0x77, 0x4d, 0x95, 0x2, 0x78, 0x8e, 0xe, 0x75, 0xc0, 0x4d, 0x22, 0x4d, 0x63, 0xb7, 0xf0, 0xff, 0x0, 0x4a, 0xac, 0x90, 0xc6, 0xb7, 0xf9, 0xdf, 0x13, 0xa5, 0x7, 0x4d, 0x43, 0x54, 0xd5, 0xab, 0xd0, 0xdf, 0x4a, 0x2e, 0x70, 0x22, 0xe4, 0xb1, 0x89, 0x91, 0x26, 0x1d, 0xcb, 0xdb, 0x52, 0xf2, 0x32, 0x9f, 0x1, 0x7, 0x9, 0x43, 0x8, 0xa2, 0xa1, 0x14, 0x7, 0x3, 0xc5, 0x85, 0xc, 0xa8, 0x41, 0xaa, 0x84, 0xe3, 0x9, 0xce, 0xa4, 0x14, 0x7f, 0xe4, 0x34, 0x96, 0xc8, 0xfe, 0x5d, 0xfe, 0xe4, 0x60, 0x3c, 0x3a, 0x3f, 0x17, 0x54, 0x39, 0xff, 0x0, 0xb9, 0x6, 0x97, 0x17, 0x2, 0x69, 0x72, 0x6e, 0x98, 0x36, 0x9c, 0x75, 0x20, 0xc1, 0x4, 0xd, 0x90, 0x63, 0xc1, 0x4, 0x1f, 0xdc, 0xb5, 0x9, 0x73, 0xa0, 0x61, 0x1d, 0x3a, 0x42, 0x1b, 0x22, 0x8a, 0x95, 0x28, 0x94, 0x8, 0x53, 0xc0, 0x9b, 0xa0, 0xe8, 0x70, 0x1e, 0xa4, 0xe, 0x53, 0x54, 0xc0, 0x32, 0x9e, 0xe9, 0x8b, 0xf2, 0x9b, 0x59, 0x1, 0x90, 0x7a, 0x67, 0xab, 0xec, 0x5a, 0xb1, 0xca, 0x7a, 0xbd, 0x4b, 0x51, 0x8c, 0x80, 0xe9, 0xfc, 0x96, 0x9e, 0xa0, 0x2, 0xff, 0x0, 0x88, 0xd6, 0xf4, 0xcf, 0x52, 0x96, 0x92, 0x3a, 0x7f, 0xd9, 0x75, 0xcc, 0xf, 0x15, 0x27, 0x18, 0x13, 0x11, 0xea, 0xa5, 0x13, 0x3b, 0xf5, 0x36, 0x9e, 0x62, 0x8b, 0x4d, 0x40, 0x41, 0x13, 0xdc, 0xa8, 0xa6, 0x2a, 0x26, 0x38, 0x6e, 0x9d, 0x75, 0x16, 0x45, 0x15, 0xee, 0x87, 0xd, 0xd0, 0x33, 0xa8, 0x8, 0xdb, 0x95, 0x6e, 0x53, 0xa, 0x78, 0x1b, 0xa2, 0x8, 0x10, 0x61, 0xdf, 0x2b, 0x7b, 0x90, 0xa6, 0xcd, 0x1f, 0xd5, 0xde, 0xba, 0x51, 0x26, 0xc6, 0x3, 0xbb, 0xa9, 0xfb, 0x54, 0xb4, 0x83, 0xb7, 0x86, 0xa6, 0x68, 0x47, 0x33, 0xcf, 0xda, 0xc5, 0x62, 0xf0, 0xe1, 0x6f, 0x52, 0xc5, 0xc5, 0x7d, 0x46, 0xa4, 0x64, 0xe7, 0xfa, 0x7f, 0xa2, 0xa6, 0x60, 0x89, 0xe4, 0x75, 0x3c, 0xc8, 0xc5, 0xc3, 0x91, 0x1c, 0xc1, 0xa4, 0xdb, 0x8e, 0xdc, 0x8, 0x44, 0x70, 0x18, 0xe0, 0x72, 0xb4, 0xc0, 0xf, 0x9f, 0x2a, 0x32, 0x9b, 0x64, 0x60, 0x91, 0x3f, 0x97, 0xdc, 0xa5, 0xa0, 0xcf, 0x4b, 0xdc, 0x3f, 0xb9, 0x4e, 0x1, 0x13, 0x77, 0x54, 0xd5, 0xb4, 0x43, 0xad, 0xdf, 0xf2, 0x20, 0xd2, 0x1f, 0x23, 0x13, 0x69, 0x44, 0xd4, 0x49, 0x8f, 0x7f, 0xd8, 0x81, 0x8b, 0xd2, 0x81, 0x26, 0x5c, 0xd7, 0x53, 0xcd, 0xd2, 0xef, 0x4a, 0x93, 0xea, 0x65, 0x49, 0xa4, 0x82, 0x5a, 0xd1, 0x5f, 0xa9, 0xc5, 0x73, 0x48, 0x26, 0x9a, 0x7f, 0xd9, 0x1, 0x70, 0x4f, 0x37, 0x6a, 0x71, 0xbd, 0x94, 0xa1, 0xc0, 0xa2, 0x14, 0x26, 0xf0, 0x2a, 0x79, 0x87, 0x0, 0x11, 0x12, 0x20, 0x65, 0x9, 0x4, 0xd5, 0xe, 0x73, 0x47, 0xf9, 0x20, 0xe3, 0x60, 0x5, 0x70, 0x4f, 0x32, 0x91, 0x93, 0x56, 0x22, 0x9f, 0x9d, 0x4d, 0x2f, 0x69, 0x3e, 0x26, 0xc8, 0x35, 0xd9, 0x9c, 0xf4, 0xff, 0x0, 0x9a, 0x4, 0x91, 0x7d, 0xd6, 0xbc, 0x7, 0xb, 0x4c, 0xa6, 0x9f, 0x6e, 0x55, 0xa4, 0xf6, 0x89, 0x9b, 0x23, 0x4, 0x3, 0x13, 0x1d, 0xa8, 0x0, 0x4c, 0xf4, 0xad, 0x40, 0x69, 0x8, 0x20, 0xa5, 0x4a, 0xa9, 0x14, 0x7, 0x12, 0x39, 0x9b, 0xf5, 0x43, 0x2a, 0x51, 0x91, 0x94, 0x61, 0xc4, 0xe5, 0xba, 0x8d, 0x1b, 0x77, 0x35, 0xa8, 0x12, 0x70, 0x69, 0xa9, 0xd5, 0x39, 0xc8, 0xf5, 0x5c, 0x97, 0x39, 0x9c, 0xac, 0xa4, 0x20, 0xd8, 0x82, 0x7a, 0xe7, 0x75, 0x4e, 0xf9, 0x52, 0x4c, 0x8e, 0x9a, 0x7c, 0x74, 0xad, 0x4b, 0x67, 0xb9, 0x1, 0x64, 0xd2, 0x30, 0x51, 0x2d, 0x17, 0x32, 0x81, 0x7, 0x1c, 0xbf, 0x72, 0x27, 0x96, 0xe8, 0xd9, 0x54, 0xa6, 0x78, 0x5, 0xb2, 0x18, 0x47, 0x80, 0x18, 0x2a, 0x2e, 0x9b, 0x48, 0xb9, 0x29, 0xef, 0x69, 0x9, 0x90, 0x5c, 0x7d, 0x51, 0x95, 0x51, 0xaa, 0x91, 0xca, 0xe1, 0xd4, 0xe6, 0xa2, 0xdb, 0xdb, 0xb9, 0x11, 0xed, 0x8, 0x63, 0x75, 0x36, 0x81, 0x2e, 0x7a, 0x73, 0x6a, 0x9b, 0x3a, 0xb0, 0x7f, 0xb5, 0x50, 0xf1, 0x2, 0x15, 0xe, 0x0, 0x92, 0x36, 0x41, 0xae, 0x80, 0x26, 0x14, 0x1b, 0x6f, 0x4e, 0x11, 0x69, 0x30, 0x4f, 0xea, 0x5a, 0x8d, 0x9c, 0x76, 0x84, 0xe6, 0x91, 0xc4, 0x2b, 0x42, 0xb, 0x2a, 0x1a, 0xaa, 0x92, 0x4, 0x45, 0x28, 0xb8, 0xaa, 0x8a, 0x92, 0x98, 0xea, 0x4c, 0x94, 0x28, 0x6e, 0x98, 0x23, 0xbd, 0xb, 0x84, 0x40, 0xdc, 0x2f, 0xa2, 0x6a, 0xa6, 0xf2, 0x2c, 0x7e, 0x55, 0x9f, 0x65, 0x72, 0x7d, 0x82, 0x22, 0x11, 0xb6, 0xe9, 0xa3, 0x2d, 0x3f, 0x72, 0x61, 0x17, 0x9, 0xcd, 0x91, 0x0, 0x59, 0x39, 0xa5, 0xaa, 0x50, 0x4d, 0xd1, 0x76, 0xeb, 0xe1, 0x18, 0xca, 0x2c, 0x23, 0x65, 0xba, 0x19, 0x11, 0xe5, 0x58, 0x9c, 0xa8, 0x6a, 0xe5, 0x46, 0x36, 0x4d, 0xc, 0x2c, 0x69, 0x3f, 0xf5, 0xa2, 0xe1, 0x51, 0x3, 0xc4, 0xd9, 0x2, 0x4a, 0x2d, 0x4e, 0x3e, 0x10, 0x79, 0x88, 0x28, 0x3a, 0x91, 0x75, 0x56, 0xe1, 0x34, 0xce, 0x4d, 0xd1, 0x31, 0x31, 0xcc, 0xf5, 0x55, 0x81, 0xcb, 0xbb, 0x90, 0x69, 0x99, 0x88, 0x5b, 0x27, 0x2, 0x76, 0x5a, 0xba, 0x45, 0xa6, 0xc7, 0x2b, 0x43, 0x4f, 0x24, 0xdf, 0xf8, 0x1c, 0xc0, 0x42, 0x88, 0x70, 0xfa, 0xaa, 0x5d, 0x3d, 0x28, 0xe9, 0x6a, 0x6c, 0x2, 0xf8, 0x5a, 0x9b, 0xc0, 0x43, 0x40, 0xee, 0xe4, 0x74, 0x60, 0x11, 0x55, 0xd3, 0x74, 0x98, 0xd0, 0x64, 0xfe, 0xa5, 0xa5, 0x6, 0x4c, 0x94, 0x30, 0x53, 0xbe, 0x8a, 0x4a, 0x17, 0x30, 0x80, 0x2d, 0x12, 0x0, 0x46, 0xa7, 0x0, 0x40, 0x8, 0x39, 0xd3, 0xd3, 0x1d, 0xb5, 0x2a, 0x7c, 0x18, 0x55, 0x10, 0xe8, 0x9a, 0xa5, 0xc, 0x70, 0x73, 0x65, 0x36, 0x1b, 0x6c, 0x2a, 0x9b, 0xe5, 0x56, 0x38, 0xbc, 0xa, 0xc2, 0x76, 0xab, 0xa6, 0xc2, 0x11, 0xd4, 0x7f, 0x90, 0x13, 0x9c, 0xe3, 0x97, 0x2b, 0xfc, 0xca, 0x8d, 0x43, 0x71, 0x3f, 0xa9, 0x4e, 0xa1, 0x10, 0x40, 0xf0, 0x8f, 0x23, 0x31, 0x4b, 0x93, 0x44, 0x4b, 0x89, 0xe, 0x94, 0xc, 0xc1, 0x23, 0x95, 0x12, 0xf, 0x6c, 0xc2, 0x13, 0x22, 0xd0, 0x83, 0x8c, 0xd2, 0x77, 0x41, 0x80, 0x97, 0xa, 0xa2, 0x10, 0x71, 0x30, 0xd1, 0xdb, 0xd4, 0xaf, 0x39, 0xa5, 0x3c, 0x86, 0xbb, 0x32, 0xe4, 0xdd, 0x40, 0xe4, 0x6c, 0x89, 0x84, 0x61, 0x40, 0x50, 0x21, 0x1, 0x17, 0xe0, 0x4f, 0x37, 0xe6, 0x89, 0xca, 0x85, 0x5, 0x4b, 0xbc, 0xa9, 0x74, 0x45, 0x45, 0x69, 0x97, 0x19, 0x12, 0x54, 0x2, 0xe1, 0x24, 0xea, 0xb5, 0x4b, 0x79, 0x8d, 0x27, 0xe5, 0x40, 0x16, 0x36, 0xff, 0x0, 0xb5, 0x34, 0x5b, 0xee, 0x4e, 0xff, 0x0, 0xc4, 0xe9, 0x96, 0x97, 0x45, 0x28, 0xd3, 0x32, 0x1a, 0x7d, 0xd3, 0xb3, 0x23, 0x95, 0x13, 0x25, 0x3c, 0x73, 0x14, 0xc, 0x1b, 0x26, 0xbe, 0x44, 0x14, 0xf1, 0x64, 0x2e, 0x11, 0x8, 0x94, 0x4, 0x99, 0x4f, 0x7c, 0xb, 0x65, 0xe, 0xa1, 0xf5, 0x44, 0x5c, 0xa0, 0x14, 0x70, 0x84, 0xdb, 0x1b, 0x26, 0x82, 0xe, 0x7a, 0xf2, 0x1a, 0x8c, 0xe0, 0x18, 0x8, 0xdf, 0xed, 0x4d, 0xb4, 0x9, 0x95, 0xa9, 0x64, 0x44, 0xc1, 0x69, 0xc7, 0xa9, 0x49, 0xcf, 0xe5, 0x85, 0x1e, 0xf2, 0xa9, 0xd, 0xb9, 0x4e, 0x82, 0x65, 0x40, 0x57, 0x55, 0x3b, 0xca, 0xf, 0x21, 0x7c, 0x55, 0xf1, 0x47, 0x84, 0xe7, 0x93, 0xec, 0x8a, 0x19, 0x1f, 0x54, 0x72, 0x84, 0x7f, 0xb, 0x62, 0x3d, 0xf8, 0xd, 0xd3, 0x62, 0x2c, 0x8d, 0x53, 0x74, 0xd9, 0xdb, 0x8, 0xcd, 0xb8, 0x3d, 0x5, 0x65, 0x6e, 0x36, 0xe0, 0xec, 0xdb, 0x80, 0xc8, 0xfa, 0xaf, 0xff, 0xc4, 0x0, 0x2a, 0x11, 0x0, 0x2, 0x1, 0x3, 0x4, 0x0, 0x5, 0x4, 0x3, 0x1, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x1, 0x11, 0x2, 0x21, 0x31, 0x10, 0x12, 0x41, 0x51, 0x3, 0x20, 0x22, 0x32, 0x61, 0x42, 0x52, 0x62, 0x81, 0x13, 0x71, 0x72, 0xb1, 0xff, 0xda, 0x0, 0x8, 0x1, 0x3, 0x1, 0x1, 0x3f, 0x0, 0x85, 0x18, 0x1c, 0x74, 0x7e, 0x8f, 0xd0, 0xd5, 0xb4, 0x84, 0x97, 0x66, 0xdb, 0xb6, 0xbe, 0xd1, 0xd2, 0xaa, 0x4a, 0xfe, 0xdf, 0x71, 0x52, 0x57, 0x69, 0x89, 0xc1, 0x62, 0x17, 0x43, 0x56, 0x22, 0xe4, 0x21, 0x24, 0x42, 0xe8, 0x49, 0x74, 0x34, 0xba, 0x2c, 0x28, 0x3f, 0x5a, 0x38, 0x27, 0xca, 0x95, 0xa4, 0x73, 0x68, 0xef, 0xd4, 0x6d, 0xcb, 0x7e, 0xcd, 0xa3, 0x51, 0x1b, 0x6d, 0x49, 0x9, 0xcd, 0xbd, 0x4c, 0xab, 0xfa, 0xd2, 0x93, 0x81, 0x88, 0x5e, 0x46, 0x2d, 0x6a, 0x43, 0xc6, 0x92, 0x6e, 0x10, 0xae, 0x7f, 0x1b, 0xbf, 0xe4, 0x27, 0x29, 0xa7, 0xec, 0xa7, 0xd2, 0x37, 0x9, 0x31, 0xd5, 0xcc, 0xd, 0xf2, 0xc6, 0xe9, 0x68, 0xa5, 0x6d, 0x52, 0xcd, 0xd2, 0xc6, 0x21, 0xc, 0x82, 0x6, 0x88, 0x27, 0x46, 0xac, 0xde, 0x8d, 0x58, 0x86, 0x53, 0x4c, 0x27, 0x61, 0xb2, 0x8e, 0x44, 0xdc, 0xc1, 0x55, 0x33, 0x75, 0x62, 0xe6, 0x39, 0x17, 0xf6, 0x25, 0x17, 0xfb, 0x59, 0xb9, 0x43, 0x72, 0x4c, 0xe3, 0x44, 0x26, 0x4e, 0x88, 0x63, 0xd1, 0x60, 0x6a, 0x28, 0x69, 0xf2, 0x70, 0x31, 0x7c, 0x12, 0x9f, 0xc0, 0xe7, 0x3f, 0xf0, 0x85, 0x71, 0x26, 0x8a, 0xab, 0xe1, 0xe, 0xd4, 0xc1, 0x9e, 0xb0, 0x5a, 0x49, 0x4a, 0xcf, 0xea, 0x17, 0x10, 0x5a, 0x27, 0xca, 0x84, 0x31, 0xe7, 0x45, 0x82, 0xa6, 0xdd, 0x31, 0xa3, 0x11, 0x12, 0xbf, 0x12, 0x33, 0x1f, 0x8d, 0xce, 0x72, 0x37, 0x6b, 0x98, 0xe4, 0xcf, 0x23, 0x51, 0x12, 0xb8, 0x21, 0x74, 0xc6, 0x94, 0x4b, 0x14, 0x71, 0x23, 0xe9, 0x9, 0x76, 0x41, 0x1e, 0x57, 0xaf, 0xf, 0x54, 0xe1, 0x9c, 0x28, 0x36, 0xa9, 0x6d, 0xb8, 0xc1, 0x1c, 0x28, 0x1d, 0xd3, 0x81, 0xb4, 0x34, 0x78, 0x72, 0xd0, 0xca, 0xd3, 0x62, 0x95, 0x61, 0xdb, 0xe4, 0xa2, 0x24, 0x63, 0x64, 0x33, 0x69, 0xb4, 0xbc, 0x8f, 0x3a, 0xac, 0x3d, 0x64, 0x56, 0x4b, 0xec, 0xa8, 0x85, 0xca, 0xc1, 0xc7, 0xdb, 0xbb, 0xb2, 0x6f, 0x4, 0xdc, 0x84, 0x25, 0x61, 0xe9, 0x71, 0xb6, 0x2c, 0x89, 0xc9, 0xb5, 0x79, 0x39, 0x2a, 0xce, 0xb3, 0xa3, 0x9e, 0x5, 0x4b, 0x2a, 0x94, 0x90, 0xd5, 0xa5, 0xf2, 0x2a, 0xbb, 0x33, 0xa4, 0x5f, 0xf1, 0x26, 0x3f, 0xc8, 0xda, 0x25, 0x61, 0x31, 0xb4, 0x4a, 0xe4, 0x9e, 0x8a, 0x2a, 0x81, 0x34, 0xf5, 0x64, 0x36, 0xc6, 0xb5, 0x81, 0x24, 0x5b, 0x4a, 0x94, 0xa1, 0xee, 0xaa, 0xa8, 0x7f, 0x48, 0xd0, 0x89, 0x1e, 0x9, 0xb4, 0x31, 0x55, 0x13, 0x37, 0x17, 0x24, 0xe8, 0xfb, 0x1a, 0x29, 0xaa, 0xa, 0x6a, 0x95, 0xa3, 0xb1, 0x57, 0x88, 0xb8, 0x37, 0xf6, 0x6e, 0x5a, 0x33, 0x82, 0x75, 0x9a, 0x95, 0x4e, 0x3e, 0xa1, 0x27, 0x12, 0xc7, 0x62, 0x44, 0xbb, 0x36, 0xde, 0x47, 0x4c, 0x9b, 0x7b, 0x1a, 0xe8, 0x8e, 0xf0, 0x47, 0x3, 0x76, 0x81, 0x31, 0x55, 0x18, 0x29, 0xf1, 0x14, 0x4c, 0x60, 0xf1, 0x2b, 0x94, 0xb8, 0x9f, 0x22, 0x6d, 0x1c, 0x1b, 0x94, 0x65, 0x1b, 0xe8, 0xec, 0xfe, 0x4a, 0x7, 0xe2, 0xf4, 0x85, 0xe2, 0xdd, 0x58, 0xaa, 0xb6, 0xdd, 0x8a, 0xf4, 0x5a, 0x32, 0x53, 0xb0, 0xa1, 0x5a, 0x48, 0x5d, 0x93, 0xd9, 0x12, 0x88, 0x12, 0x62, 0xab, 0xa1, 0xdc, 0xda, 0xcd, 0xaf, 0x5a, 0x70, 0x2f, 0xd, 0x72, 0xc5, 0x45, 0x3f, 0x22, 0xa6, 0x9e, 0x8f, 0x4f, 0xc1, 0xba, 0x85, 0xd1, 0xe8, 0xca, 0x66, 0x58, 0xef, 0x64, 0x88, 0xe0, 0xc7, 0x23, 0x23, 0x91, 0xbc, 0x38, 0x23, 0x2c, 0xfd, 0x14, 0xa9, 0x45, 0x54, 0xc1, 0x4, 0x68, 0x9b, 0x25, 0x8d, 0xe8, 0x95, 0x8e, 0x9, 0x44, 0xa2, 0x29, 0xe8, 0x8a, 0x7a, 0x2a, 0x85, 0x78, 0x1b, 0xb5, 0x96, 0xd9, 0x2f, 0x6b, 0x93, 0x38, 0x19, 0x48, 0xa2, 0xf0, 0x5e, 0x2e, 0xc5, 0x8c, 0x98, 0x29, 0xc0, 0xe1, 0x8e, 0x98, 0x10, 0xf4, 0x48, 0x78, 0x82, 0x9a, 0x4e, 0x9, 0xb1, 0x24, 0xea, 0xd4, 0x8f, 0x2, 0x81, 0xc, 0xa5, 0x49, 0xf0, 0xd1, 0x8, 0x92, 0xec, 0x56, 0x27, 0x48, 0x46, 0xd4, 0x6c, 0x46, 0xc1, 0x53, 0x1a, 0x70, 0xcb, 0x40, 0xc5, 0xab, 0x1c, 0xe8, 0xf4, 0xb7, 0x3, 0x14, 0xc, 0xa0, 0x65, 0xfc, 0xa8, 0x43, 0x1c, 0xc1, 0xff, 0xd9, 0x12, 0x3d, 0x31, 0x2c, 0x41, 0x4d, 0x0, 0x0, 0x0, 0x1f, 0x8b, 0x8, 0x0, 0x0, 0x0, 0x0, 0x0, 0x2, 0x3, 0xed, 0x7d, 0x6b, 0x8f, 0x23, 0xb9, 0x91, 0xe0, 0x5f, 0x91, 0x7b, 0x30, 0xf0, 0xb4, 0x4b, 0x52, 0xa7, 0x9e, 0xd5, 0x95, 0xc2, 0x14, 0xbc, 0xd8, 0xfb, 0xb0, 0x7, 0xac, 0xfd, 0xe5, 0xee, 0xc3, 0x1, 0xe3, 0x3e, 0x20, 0x25, 0xa5, 0x4a, 0xe9, 0x49, 0x3d, 0x56, 0x99, 0xea, 0xc7, 0x8, 0xda, 0xdf, 0x7e, 0x7c, 0x33, 0x48, 0x46, 0x90, 0x29, 0x55, 0xb5, 0xed, 0x3, 0xc6, 0xed, 0xe9, 0x4e, 0x31, 0x82, 0xc1, 0x60, 0x30, 0x18, 0xc1, 0x67, 0x70, 0xdb, 0xee, 0xea, 0xcb, 0xe6, 0xb0, 0x6f, 0x7, 0x9b, 0x62, 0x57, 0xd5, 0xdf, 0xf2, 0xa6, 0xd8, 0x37, 0x83, 0xa6, 0x3c, 0x55, 0x9b, 0xc5, 0x60, 0xd7, 0xc, 0xda, 0xf2, 0x6b, 0x3b, 0x68, 0xaa, 0xdf, 0xca, 0x41, 0xb1, 0xfe, 0xfb, 0xb9, 0x69, 0xf3, 0x51, 0x96, 0xfd, 0xb8, 0x18, 0x7c, 0x29, 0x97, 0xbf, 0x56, 0x2d, 0xe, 0xbd, 0x2e, 0xf, 0xeb, 0x6f, 0x97, 0x5d, 0x71, 0x7a, 0xa9, 0xf6, 0x79, 0x76, 0x2d, 0x4e, 0x6d, 0xb5, 0xaa, 0xcb, 0x7e, 0xd1, 0x54, 0xeb, 0xb2, 0xbf, 0x2e, 0xdb, 0xa2, 0xaa, 0x9b, 0xfe, 0xa6, 0x7a, 0x59, 0x15, 0xc7, 0xb6, 0x3a, 0xec, 0xf9, 0xe7, 0xf9, 0x54, 0xf6, 0x37, 0x87, 0x43, 0x5b, 0x9e, 0xfa, 0xdb, 0xb2, 0x58, 0xf3, 0x7f, 0x5e, 0x4e, 0x87, 0xf3, 0xb1, 0xbf, 0x2b, 0xaa, 0x7d, 0x7f, 0x57, 0xee, 0xcf, 0xfd, 0x7d, 0xf1, 0xb9, 0xdf, 0x94, 0x2b, 0x91, 0xa3, 0x39, 0xef, 0x18, 0xf9, 0x6f, 0x97, 0x75, 0xd5, 0x1c, 0xeb, 0xe2, 0x5b, 0xbe, 0xac, 0xf, 0xab, 0x5f, 0xaf, 0xc5, 0x79, 0x5d, 0x1d, 0xfa, 0xab, 0x62, 0xff, 0xb9, 0x68, 0xfa, 0xc7, 0xd3, 0xe1, 0xe5, 0x54, 0x36, 0x4d, 0xff, 0x33, 0x2b, 0xf5, 0x60, 0x30, 0xab, 0x7d, 0x5d, 0xed, 0xcb, 0x81, 0xc8, 0xb0, 0xf8, 0x5c, 0x72, 0xd6, 0x8a, 0x7a, 0x50, 0xd4, 0xd5, 0xcb, 0x3e, 0x5f, 0x16, 0x4d, 0xc9, 0xa1, 0x92, 0x50, 0xbe, 0x3f, 0xb4, 0x3f, 0xfd, 0xb2, 0x62, 0x92, 0x39, 0x1d, 0xea, 0xe6, 0xd3, 0x7b, 0x43, 0x62, 0x7f, 0xd8, 0x97, 0x8b, 0x6d, 0x59, 0xbd, 0x6c, 0x5b, 0x56, 0xbb, 0x5f, 0xb6, 0xd5, 0x7a, 0x5d, 0xee, 0x3f, 0xf5, 0xdb, 0x72, 0xc7, 0xc0, 0x6d, 0xe9, 0xe0, 0x5d, 0x8b, 0xcb, 0xb2, 0x58, 0xfd, 0xca, 0xeb, 0xb2, 0x5f, 0xf, 0x56, 0x87, 0xfa, 0x70, 0xca, 0xdb, 0x13, 0x93, 0xf0, 0xb1, 0x38, 0x95, 0xfb, 0xf6, 0x5a, 0xe4, 0x5, 0xab, 0xd1, 0x67, 0x26, 0x9c, 0x7c, 0x7b, 0x60, 0xec, 0x5c, 0xe, 0xe7, 0x96, 0xb3, 0xc0, 0x8, 0x2f, 0xfb, 0xd, 0x2b, 0x79, 0xff, 0x22, 0x1b, 0xe7, 0x8b, 0x2c, 0xef, 0x31, 0xcb, 0xae, 0xeb, 0xcd, 0x5e, 0xa6, 0x35, 0xed, 0xb7, 0xba, 0xcc, 0xab, 0x96, 0x71, 0xbf, 0xba, 0x6e, 0x47, 0x5a, 0xe2, 0xc3, 0xf9, 0x63, 0xb9, 0xeb, 0x65, 0x57, 0xf6, 0xf3, 0x57, 0x50, 0x7a, 0xfe, 0xc3, 0x66, 0x93, 0x2d, 0x24, 0xb, 0x3f, 0x64, 0x8c, 0x4e, 0x73, 0x66, 0x45, 0x9c, 0x8f, 0x8a, 0x16, 0x6b, 0xc3, 0xfc, 0x71, 0xf6, 0xe3, 0x42, 0x88, 0x47, 0xd7, 0x6e, 0x71, 0x3c, 0x34, 0x15, 0x97, 0x78, 0x7e, 0x2a, 0x59, 0xdd, 0x18, 0xa3, 0xa4, 0xcc, 0x38, 0xa5, 0xf6, 0x70, 0xcc, 0x7, 0xc3, 0x59, 0xb9, 0xe3, 0xb4, 0x2f, 0xcb, 0x43, 0xdb, 0x1e, 0x76, 0x2c, 0x61, 0xcc, 0x53, 0xaa, 0xdd, 0xb, 0x4b, 0x39, 0xb1, 0xa6, 0x65, 0x75, 0x6b, 0x3e, 0xbf, 0x8, 0xf1, 0xe6, 0x27, 0xd6, 0xe6, 0xef, 0x2f, 0xbc, 0xe6, 0x9b, 0xfa, 0xf0, 0x25, 0x97, 0xb2, 0xbc, 0x6e, 0x4f, 0x97, 0xc1, 0xee, 0xf0, 0xdb, 0x60, 0x79, 0xf8, 0xca, 0x19, 0xab, 0xf6, 0x2f, 0x39, 0x6f, 0x7, 0x26, 0x30, 0x9e, 0x64, 0x94, 0x8f, 0x0, 0x13, 0xc9, 0xa6, 0xc5, 0x8e, 0xa7, 0xd2, 0x96, 0x58, 0x9c, 0xdb, 0xc3, 0x75, 0x75, 0x60, 0x8a, 0xf9, 0xeb, 0x72, 0xcd, 0x94, 0xa6, 0xec, 0x37, 0xc5, 0xe, 0xca, 0x64, 0xc4, 0x78, 0x5f, 0x9e, 0x59, 0x4d, 0xf6, 0xfd, 0x6a, 0x7f, 0x3c, 0xb7, 0xfd, 0xc3, 0xb1, 0x95, 0xaa, 0xc9, 0x2a, 0xce, 0xd4, 0xb1, 0xcf, 0xbb, 0x0, 0x6b, 0xcc, 0xe2, 0x22, 0x45, 0x5b, 0xed, 0xb7, 0xac, 0xef, 0xb4, 0xb, 0x4e, 0xc1, 0xfc, 0x30, 0x7d, 0x41, 0x52, 0xb2, 0xc5, 0x7f, 0xae, 0x9a, 0x6a, 0x59, 0x97, 0xba, 0x4, 0x49, 0xf2, 0x22, 0x7a, 0x95, 0x50, 0x93, 0xcd, 0xe1, 0xb4, 0x93, 0x8a, 0xa4, 0x30, 0xb6, 0xac, 0xbb, 0xf6, 0x4, 0x23, 0xbf, 0xb4, 0xdf, 0x8e, 0xe5, 0xcf, 0x32, 0xf9, 0x53, 0x1f, 0x24, 0x31, 0xad, 0x2f, 0x5b, 0x27, 0x85, 0xb5, 0xc6, 0xae, 0x6a, 0x3f, 0x5d, 0xb4, 0xe0, 0x8a, 0xe3, 0xb1, 0x2c, 0x18, 0xf9, 0x55, 0x99, 0xcb, 0xfc, 0x8b, 0xd5, 0xf9, 0xd4, 0x30, 0xe6, 0x8f, 0x87, 0x8a, 0x9, 0xec, 0xa4, 0xa, 0xfb, 0x85, 0x69, 0x72, 0xc1, 0xb8, 0x5b, 0x7f, 0x82, 0xc5, 0x9a, 0xc4, 0x8b, 0xca, 0xb4, 0x2e, 0x37, 0xc5, 0xb9, 0x6e, 0x55, 0xa6, 0x3c, 0x17, 0x4d, 0xb7, 0x39, 0xac, 0xce, 0xcd, 0xa0, 0xda, 0xef, 0x59, 0x57, 0x16, 0xf9, 0xc2, 0x74, 0xa3, 0xe, 0x8b, 0x63, 0xb1, 0x5e, 0xf3, 0xe6, 0xca, 0xae, 0x80, 0xe9, 0xd5, 0xb6, 0x5c, 0xfd, 0xca, 0x1a, 0xce, 0xad, 0x5b, 0xc1, 0x7a, 0xa6, 0xad, 0x8, 0x68, 0x6a, 0x49, 0x4c, 0xea, 0x87, 0xa7, 0x3b, 0x0, 0x84, 0xa7, 0xa2, 0xe5, 0xef, 0xcf, 0xbb, 0x65, 0x79, 0xfa, 0xc4, 0xf8, 0x56, 0x85, 0x9, 0xa6, 0x7, 0xcd, 0xb1, 0xda, 0xf, 0xa0, 0x42, 0x10, 0xd8, 0xac, 0x23, 0xbb, 0xd8, 0x17, 0xa5, 0x80, 0x42, 0xe3, 0x60, 0xe3, 0xb0, 0xa6, 0x58, 0x6d, 0x41, 0x4e, 0x99, 0x30, 0x58, 0xf1, 0xf6, 0xa9, 0x91, 0xa2, 0xa8, 0xc, 0xeb, 0x72, 0x75, 0x38, 0x15, 0xbc, 0xb7, 0x62, 0xd, 0x2d, 0x94, 0xc8, 0xe8, 0xaa, 0xab, 0xff, 0x5a, 0xa5, 0x3, 0x53, 0xd3, 0xf2, 0x96, 0x56, 0xed, 0xc4, 0xad, 0x57, 0x5d, 0x1c, 0x9b, 0x32, 0xd7, 0x1f, 0xb, 0x5, 0x60, 0xc6, 0x6c, 0x25, 0xc5, 0xd7, 0xae, 0xfb, 0xed, 0xf6, 0x62, 0xc5, 0xf9, 0xe1, 0x4f, 0x7f, 0xe8, 0xfd, 0xaf, 0xc3, 0xf9, 0xc4, 0xca, 0xef, 0x6d, 0xdb, 0xf6, 0xd8, 0xe4, 0x1f, 0x3e, 0xbc, 0x54, 0xed, 0xf6, 0xbc, 0x1c, 0xae, 0xe, 0xbb, 0xf, 0xdb, 0xd9, 0xf2, 0xf8, 0x81, 0xab, 0xd6, 0x8c, 0x35, 0x43, 0x55, 0x97, 0x27, 0x61, 0x40, 0x3f, 0x30, 0xe3, 0xbc, 0xfc, 0xb0, 0x2b, 0x1a, 0x26, 0xc0, 0xf, 0xcd, 0x69, 0xf5, 0x61, 0xd5, 0x34, 0x1f, 0xb8, 0x1f, 0x18, 0xb2, 0x8f, 0xde, 0x9f, 0x3e, 0xfc, 0x79, 0x57, 0xae, 0xab, 0xa2, 0x77, 0x3c, 0x31, 0x5d, 0xbd, 0xfc, 0xa9, 0x9f, 0x17, 0x1b, 0xee, 0x36, 0xf2, 0x65, 0xc9, 0x3a, 0x4b, 0x9, 0xd, 0x5e, 0xd6, 0xcb, 0xfe, 0x50, 0xed, 0x8e, 0x87, 0x53, 0x5b, 0xec, 0x5b, 0x60, 0xf9, 0x40, 0xa2, 0xa3, 0x48, 0xdb, 0x62, 0xcd, 0x24, 0xc2, 0x5, 0x5, 0x30, 0x68, 0x88, 0xf4, 0x7d, 0x18, 0xe8, 0x5a, 0x30, 0x7b, 0xce, 0xbb, 0x76, 0x5b, 0xae, 0x65, 0x67, 0xb6, 0x6d, 0x93, 0x33, 0xce, 0xca, 0x93, 0x74, 0x33, 0xbf, 0x6c, 0x4f, 0xe5, 0xe6, 0x93, 0xac, 0xc0, 0x45, 0xd9, 0xaa, 0xfc, 0x5d, 0xef, 0xa7, 0x77, 0xbd, 0xa2, 0x6d, 0x4f, 0x3f, 0x71, 0xe8, 0xfb, 0xde, 0xbb, 0xf7, 0xef, 0xae, 0xc5, 0x72, 0x79, 0xfa, 0xa5, 0xad, 0xda, 0xba, 0xa4, 0xb1, 0x5, 0x58, 0xa1, 0xb, 0xc2, 0xff, 0xf7, 0xe7, 0x77, 0x7f, 0x2f, 0x98, 0x2b, 0x5c, 0x9d, 0xaa, 0x23, 0x43, 0x54, 0x39, 0xfb, 0x6, 0xf8, 0xc3, 0xbb, 0x80, 0xd8, 0xbb, 0xab, 0x70, 0x8c, 0xff, 0x75, 0x66, 0x9e, 0x98, 0x1b, 0x43, 0xdd, 0x45, 0x47, 0xc7, 0xaf, 0xbd, 0xe6, 0x50, 0x57, 0xeb, 0xde, 0xf, 0x4f, 0x4f, 0x4f, 0xac, 0xbf, 0xbc, 0x30, 0x17, 0xca, 0xf4, 0xe8, 0x57, 0xd6, 0x29, 0xb8, 0x57, 0xcf, 0x8b, 0xcf, 0x87, 0x6a, 0x7d, 0x6d, 0xb9, 0xef, 0x36, 0xfe, 0x4f, 0x28, 0xcf, 0x40, 0xba, 0xf3, 0x81, 0xd0, 0x2f, 0xee, 0x4, 0xfa, 0xed, 0xe9, 0x42, 0xe5, 0xe7, 0x3e, 0x62, 0x57, 0x7c, 0x1d, 0x7c, 0xa9, 0xd6, 0xed, 0x56, 0xc, 0x25, 0x80, 0x4c, 0xb7, 0xe3, 0xfe, 0x76, 0xd2, 0x3f, 0x5e, 0xe, 0xa7, 0xe3, 0x96, 0x59, 0xc6, 0x7c, 0xb2, 0x60, 0x68, 0x87, 0x2f, 0xec, 0x43, 0x82, 0x20, 0x55, 0x51, 0x2d, 0x45, 0x54, 0xd9, 0x54, 0xd7, 0x11, 0x6e, 0x0, 0xe1, 0x21, 0x1b, 0x59, 0x2c, 0x8b, 0x93, 0xeb, 0xb7, 0x87, 0xcb, 0x76, 0xff, 0x3c, 0x5c, 0xb1, 0xce, 0xd2, 0xf6, 0x87, 0xeb, 0xd3, 0xe1, 0x78, 0x3e, 0x3e, 0x83, 0x34, 0xdd, 0x27, 0x98, 0xc7, 0x1b, 0x60, 0x8a, 0x75, 0x1d, 0xd6, 0xc5, 0xb2, 0xac, 0x11, 0xf9, 0x71, 0xcf, 0x3b, 0x8c, 0xf7, 0x2b, 0x48, 0x46, 0x60, 0xf6, 0x58, 0xbf, 0xd2, 0x5f, 0xdb, 0x70, 0x40, 0xe1, 0xd7, 0x47, 0xa, 0x5e, 0x52, 0x2f, 0xd7, 0x36, 0x33, 0x48, 0xda, 0x22, 0x9c, 0xad, 0xd7, 0x6b, 0x40, 0xe5, 0x1a, 0xf4, 0xac, 0xb7, 0x35, 0xba, 0xd7, 0xad, 0x19, 0x78, 0x4a, 0x3f, 0x9b, 0x1d, 0xad, 0x67, 0x6f, 0x8b, 0xe3, 0x60, 0xcb, 0xac, 0x50, 0xcd, 0x2d, 0x11, 0x32, 0x6c, 0x12, 0x3, 0x4c, 0x38, 0x68, 0xfd, 0xcf, 0xa2, 0x3d, 0xf4, 0xdf, 0xfd, 0x47, 0x59, 0x7f, 0x2e, 0xf9, 0xe8, 0xa4, 0xf7, 0xd7, 0xf2, 0x5c, 0xbe, 0xeb, 0x9b, 0xdf, 0xfd, 0x7f, 0x3b, 0x55, 0x45, 0xdd, 0x7, 0x43, 0x5b, 0x50, 0xf0, 0x8c, 0x15, 0xc, 0x47, 0x3d, 0xa3, 0xe1, 0x74, 0xfc, 0x71, 0xf6, 0x38, 0x9a, 0x4e, 0xb4, 0xcd, 0x28, 0x97, 0xfc, 0xcf, 0x22, 0x14, 0xfc, 0x78, 0x39, 0x29, 0x67, 0x99, 0x3b, 0x3e, 0xf0, 0x87, 0x5, 0x90, 0x4d, 0x38, 0x38, 0x90, 0xa5, 0xeb, 0x14, 0xc8, 0x80, 0x4a, 0xbb, 0xea, 0x21, 0xc5, 0xf, 0xeb, 0xcd, 0xfc, 0x69, 0x54, 0x2c, 0x7c, 0x4b, 0x22, 0x7, 0x98, 0xb9, 0x70, 0xa9, 0x66, 0x0, 0x19, 0xcf, 0x2, 0x8c, 0x8f, 0xcc, 0x67, 0x6, 0x9c, 0x6b, 0x36, 0x5a, 0x13, 0x9a, 0x51, 0xed, 0x17, 0x3a, 0x4d, 0x37, 0x87, 0x74, 0xda, 0xcc, 0xde, 0xbe, 0xc8, 0x8a, 0xf7, 0xb8, 0xd7, 0xe8, 0x71, 0xb9, 0x29, 0xcc, 0xc1, 0x61, 0xb3, 0x61, 0x83, 0x8e, 0x7c, 0x30, 0x3e, 0x7e, 0xbd, 0xca, 0xe1, 0xbc, 0x1d, 0xff, 0xf3, 0x5e, 0xed, 0x8d, 0x1a, 0x77, 0x6c, 0x9c, 0xc7, 0x46, 0x3d, 0xbc, 0x2f, 0x1d, 0xce, 0x4c, 0x60, 0xd2, 0xb7, 0x3e, 0xf, 0x99, 0xc1, 0xdc, 0x3d, 0x17, 0xcf, 0xdc, 0x4c, 0xe0, 0x30, 0x1, 0x61, 0x7f, 0xd, 0xd8, 0x20, 0xe7, 0x78, 0x60, 0xb6, 0x83, 0xd, 0x9d, 0x87, 0xcc, 0x9f, 0xec, 0x96, 0x7b, 0x36, 0xab, 0xe8, 0xa9, 0xac, 0x26, 0x81, 0xff, 0x74, 0x27, 0x9, 0xb, 0xd7, 0xbe, 0x2c, 0xa0, 0x53, 0x96, 0x84, 0x79, 0xfb, 0x32, 0xb3, 0xad, 0x34, 0x95, 0xf, 0x38, 0xce, 0xd, 0xab, 0x85, 0x0, 0x1a, 0xc2, 0xc6, 0xc7, 0x4d, 0x69, 0xe5, 0xa1, 0xd4, 0x65, 0x81, 0x76, 0xbd, 0x85, 0x57, 0xa0, 0xed, 0xb, 0x5c, 0xef, 0xe5, 0x20, 0xbc, 0xa8, 0xeb, 0xde, 0x70, 0xdc, 0xf4, 0x4a, 0x36, 0xe8, 0x66, 0x62, 0xe1, 0x63, 0x8c, 0xc5, 0xe0, 0x90, 0xc2, 0x48, 0x80, 0xd1, 0x99, 0x51, 0x4a, 0x4a, 0xab, 0xea, 0xb4, 0xb2, 0x16, 0x4c, 0xf1, 0x3c, 0x63, 0x53, 0x3f, 0x36, 0x74, 0x97, 0xd, 0xcf, 0x4d, 0x63, 0x3e, 0x66, 0x75, 0x54, 0x83, 0xdf, 0x81, 0x9a, 0xe, 0x88, 0x24, 0x33, 0xf2, 0xb3, 0x66, 0x14, 0x8a, 0x63, 0xf6, 0x34, 0x2f, 0x1e, 0x97, 0xd7, 0x61, 0x73, 0x1a, 0x1c, 0xf6, 0xf5, 0xb7, 0x8b, 0x99, 0x85, 0x14, 0x4b, 0x86, 0xc1, 0x6, 0x56, 0xb, 0xc5, 0xdb, 0xd1, 0xc, 0xeb, 0x6d, 0x41, 0xf9, 0x80, 0x7f, 0x9b, 0x31, 0xc8, 0xc2, 0x9b, 0x5c, 0x2c, 0x56, 0x75, 0x75, 0x64, 0xd3, 0x99, 0x55, 0xfb, 0x53, 0xd6, 0x17, 0x7f, 0xde, 0x1b, 0x76, 0x4c, 0x89, 0x52, 0xe3, 0xb9, 0xcd, 0xd4, 0xf3, 0x33, 0x4, 0x22, 0xfb, 0x8f, 0xe1, 0xad, 0x69, 0x59, 0x17, 0x5b, 0x29, 0xce, 0xb8, 0xa4, 0xa0, 0xd4, 0xcc, 0xc, 0x60, 0xe1, 0xf, 0xfd, 0x25, 0x3f, 0x42, 0xb2, 0xbf, 0xb0, 0x89, 0xa6, 0x19, 0xd1, 0x5f, 0xbc, 0x21, 0xf9, 0x70, 0x3b, 0xea, 0xf, 0x99, 0xa3, 0x1b, 0x32, 0x27, 0x38, 0xdc, 0x4e, 0xd9, 0x7f, 0x33, 0xf6, 0xdf, 0xbc, 0xcf, 0x92, 0xa5, 0x67, 0x64, 0x69, 0x2c, 0x69, 0x3b, 0xa7, 0xd, 0x8e, 0x1a, 0xd8, 0x4d, 0xb2, 0xcc, 0x53, 0xd9, 0xd1, 0xc2, 0x99, 0xbb, 0xf0, 0xb2, 0x7a, 0xc3, 0x66, 0xc7, 0xb4, 0xa5, 0xcf, 0x3f, 0xf5, 0xd7, 0xd8, 0x26, 0x8e, 0x4d, 0xe2, 0xc4, 0x26, 0x4e, 0x4c, 0xe2, 0xd4, 0x26, 0x4e, 0x4d, 0xe2, 0xcc, 0x26, 0xce, 0x4c, 0xe2, 0xdc, 0x26, 0xce, 0x55, 0xa2, 0x2d, 0xdc, 0x94, 0x6d, 0x8b, 0x36, 0x25, 0xdb, 0x82, 0x4d, 0xb9, 0xb6, 0x58, 0x53, 0xaa, 0x2d, 0xd4, 0x94, 0x69, 0x8b, 0xd4, 0x25, 0x3a, 0xc3, 0xde, 0xa9, 0x2f, 0x1d, 0xd7, 0x9, 0x38, 0xed, 0xa0, 0x65, 0x9f, 0x50, 0xf9, 0x51, 0x36, 0x64, 0xb6, 0xf2, 0xb5, 0x52, 0xbd, 0x57, 0x2c, 0xc0, 0xc7, 0xce, 0x67, 0x3f, 0x5e, 0x1d, 0xdd, 0xd1, 0x2a, 0x3, 0xf8, 0x97, 0xcc, 0x52, 0x35, 0x78, 0x5d, 0xc3, 0xbe, 0xaa, 0x7d, 0xf4, 0xa, 0x85, 0x68, 0x81, 0xed, 0x8, 0x24, 0x4e, 0x9e, 0x4, 0x6f, 0xac, 0x25, 0xc6, 0x30, 0x75, 0x2c, 0x52, 0x27, 0xbc, 0x7d, 0x6c, 0xea, 0x78, 0x2e, 0xeb, 0xc1, 0x58, 0x80, 0x83, 0xf, 0x49, 0x81, 0xc9, 0x62, 0x76, 0x71, 0x47, 0x6, 0x57, 0x21, 0xa7, 0x39, 0x4c, 0x9d, 0xb0, 0xd4, 0xa3, 0x71, 0x6f, 0xbd, 0xac, 0xa7, 0xa5, 0x53, 0xf3, 0xd1, 0x2f, 0x62, 0xed, 0x40, 0xde, 0x47, 0xfd, 0x93, 0xec, 0x8b, 0xd3, 0xab, 0x9a, 0xdf, 0xfc, 0xb4, 0x63, 0x64, 0xa4, 0x35, 0x79, 0x9c, 0x7f, 0x3c, 0x7e, 0x7d, 0x7f, 0x91, 0x5, 0x80, 0xba, 0x8c, 0x45, 0xb9, 0x57, 0x25, 0x2e, 0x5f, 0x56, 0x1f, 0xe7, 0x4c, 0x56, 0x7c, 0x11, 0xa8, 0xef, 0xad, 0x4, 0x99, 0x61, 0x63, 0x56, 0xac, 0xa7, 0xa5, 0x31, 0x95, 0xc3, 0x71, 0xb9, 0x63, 0x83, 0x47, 0x3e, 0x62, 0xa8, 0xcb, 0x8d, 0x5a, 0x85, 0x90, 0xfe, 0x9a, 0xff, 0x56, 0xa0, 0x13, 0xe7, 0x13, 0xc2, 0x44, 0x82, 0x2, 0xae, 0x4a, 0x6e, 0xab, 0x20, 0x54, 0xa6, 0x28, 0x30, 0x5f, 0x21, 0xac, 0x36, 0xdf, 0x20, 0x5c, 0x25, 0x29, 0x84, 0xfd, 0xe1, 0xcb, 0xa9, 0x38, 0x5e, 0xbe, 0x6c, 0x99, 0xb3, 0x17, 0xd3, 0x4a, 0x3e, 0x6f, 0xe5, 0x49, 0x9a, 0xaf, 0xc3, 0x97, 0xf2, 0xb4, 0x62, 0xce, 0xcb, 0x5f, 0x22, 0x31, 0x0, 0x85, 0x78, 0x66, 0x13, 0x5f, 0x14, 0xd1, 0x0, 0x34, 0xc7, 0xc5, 0x51, 0x2c, 0xa0, 0xfd, 0x16, 0x60, 0x5a, 0x88, 0x42, 0xdd, 0x9d, 0xf9, 0x74, 0x4e, 0xc9, 0x6e, 0x5a, 0xce, 0xd6, 0xf3, 0xd5, 0xb5, 0x90, 0x20, 0x36, 0x17, 0xe5, 0xeb, 0x91, 0xee, 0x10, 0x6c, 0x39, 0x9a, 0x4d, 0x46, 0x33, 0x8d, 0xd2, 0x9c, 0x57, 0xab, 0xb2, 0x69, 0xbc, 0x51, 0xda, 0x98, 0xff, 0xd1, 0x28, 0xd5, 0x7e, 0x73, 0x88, 0xc1, 0xbf, 0x14, 0xa7, 0x3d, 0x6f, 0xa8, 0x8, 0xca, 0xba, 0xd8, 0xbf, 0x30, 0x4f, 0x86, 0x61, 0xc, 0x97, 0x2f, 0x9a, 0xcf, 0x8b, 0x9d, 0x37, 0x20, 0xa3, 0x14, 0x39, 0x74, 0x64, 0x14, 0x6d, 0x6, 0x45, 0x30, 0xc4, 0x55, 0x75, 0xe4, 0xa8, 0xaa, 0x82, 0x8, 0xd2, 0x6c, 0xb5, 0xfc, 0x38, 0x5b, 0x49, 0x82, 0xae, 0x18, 0x42, 0xdc, 0xe9, 0xf4, 0x69, 0x3d, 0x9d, 0xa, 0x82, 0x5c, 0x1c, 0x18, 0xb5, 0xe5, 0x2a, 0x5b, 0x97, 0x92, 0x1a, 0x90, 0x58, 0x88, 0x38, 0x19, 0x2d, 0xb3, 0xb5, 0xe4, 0x4d, 0x49, 0x8e, 0xec, 0x3, 0x92, 0x9a, 0x2b, 0xdf, 0x10, 0xb7, 0x5c, 0x3d, 0x3d, 0x8e, 0x36, 0x82, 0xa0, 0x94, 0x33, 0x82, 0xb3, 0x7e, 0x9a, 0x4d, 0xa6, 0x1b, 0x49, 0xcf, 0x69, 0x8c, 0x10, 0x75, 0xf5, 0x34, 0xc9, 0xc6, 0xab, 0xeb, 0x50, 0xcc, 0x5b, 0xe5, 0x34, 0x59, 0xf, 0x2b, 0xb5, 0xf9, 0x78, 0x2, 0xb6, 0x38, 0x9f, 0x32, 0x83, 0xc6, 0xac, 0xd, 0x18, 0x40, 0x19, 0xf3, 0x6c, 0x87, 0x4e, 0xca, 0x4b, 0x1d, 0xea, 0xfe, 0xb9, 0x86, 0x66, 0x3d, 0xc3, 0x2d, 0xfa, 0xa1, 0xee, 0x31, 0x54, 0xf6, 0xf7, 0x99, 0x67, 0xe8, 0x89, 0x6c, 0x3d, 0x9b, 0x53, 0x21, 0xb3, 0x81, 0x51, 0x5d, 0x35, 0xac, 0x57, 0xed, 0xc5, 0x92, 0xf3, 0xda, 0xb0, 0xc9, 0xed, 0x42, 0xce, 0x2d, 0x58, 0xa3, 0x57, 0xa3, 0xe5, 0xe4, 0x59, 0x24, 0xc8, 0x1, 0x65, 0x2, 0x57, 0xb3, 0x25, 0xa0, 0x3, 0x69, 0x46, 0x6d, 0xe6, 0xe7, 0xba, 0xc2, 0x57, 0xee, 0x1d, 0xa2, 0x33, 0x3b, 0xde, 0x93, 0xe6, 0x89, 0xa7, 0x5c, 0xd7, 0xd1, 0xfa, 0x73, 0x29, 0x5e, 0xd7, 0xeb, 0xfe, 0xba, 0xbd, 0xe0, 0xc3, 0xf7, 0x2b, 0x83, 0x4, 0x2b, 0xef, 0xc6, 0xbc, 0xcb, 0xca, 0x44, 0x4c, 0xf5, 0xba, 0x1e, 0x6c, 0xf, 0xa7, 0xea, 0x37, 0x46, 0xa1, 0xa8, 0x7b, 0x9c, 0x56, 0x7d, 0x28, 0x5a, 0x61, 0x48, 0xf5, 0xe0, 0x75, 0xce, 0x67, 0xbc, 0x6c, 0x14, 0x5d, 0x9c, 0x64, 0xb2, 0x6f, 0x53, 0x83, 0x91, 0xab, 0x40, 0x30, 0x89, 0x65, 0xcd, 0x6, 0x8e, 0x4d, 0xd5, 0x2c, 0x30, 0x6b, 0xe9, 0x15, 0xef, 0xf2, 0x3d, 0xfa, 0x98, 0x71, 0xb7, 0x21, 0x16, 0x95, 0xd6, 0x45, 0x5b, 0xc, 0x18, 0x26, 0x3, 0xb2, 0xd9, 0x99, 0x5c, 0x62, 0xea, 0x83, 0xe5, 0x26, 0x3d, 0xc, 0xdd, 0x96, 0xf5, 0x11, 0xd1, 0x3a, 0x35, 0x6b, 0xd4, 0xe6, 0x70, 0x58, 0xed, 0xd9, 0x60, 0x98, 0xd5, 0xa1, 0xd9, 0x1, 0x47, 0xf4, 0xc4, 0x66, 0x10, 0xa4, 0x19, 0xb6, 0xb, 0x4e, 0x66, 0x4e, 0x25, 0x75, 0xb3, 0x7, 0x46, 0x52, 0xc2, 0xcd, 0xfa, 0xbe, 0xf4, 0xe3, 0xf0, 0x71, 0x66, 0xbb, 0x82, 0xd6, 0x4, 0xdd, 0x11, 0x14, 0x47, 0x96, 0x3c, 0x53, 0xee, 0xbc, 0x2e, 0x98, 0x6a, 0xad, 0xb6, 0x55, 0xbd, 0xee, 0x3, 0xc0, 0x91, 0x48, 0x3f, 0xc3, 0xc, 0x41, 0x97, 0x0, 0x88, 0xca, 0x1, 0x83, 0x14, 0xb5, 0x97, 0x5, 0x52, 0xa4, 0x77, 0x76, 0xe7, 0xa2, 0xc0, 0x57, 0x67, 0x3f, 0x76, 0x5a, 0x83, 0x8, 0x4b, 0x55, 0xab, 0x33, 0x61, 0xe1, 0x8, 0x0, 0x66, 0x30, 0x8b, 0x7e, 0x7f, 0xfc, 0xdb, 0x38, 0x1b, 0x4d, 0x7b, 0x7f, 0xcb, 0xb2, 0x7f, 0xcb, 0xfe, 0xc8, 0x8c, 0x9b, 0x41, 0x67, 0x73, 0x6c, 0xa6, 0x6b, 0xd, 0xa4, 0x30, 0x3c, 0x9e, 0xeb, 0x5a, 0xd, 0x1, 0xdc, 0x1e, 0x37, 0x82, 0x9d, 0x50, 0x75, 0x75, 0x3d, 0x3b, 0xd4, 0x5d, 0xd2, 0x6d, 0x1a, 0xa7, 0xe1, 0xb2, 0x45, 0x38, 0xa2, 0x8, 0x39, 0xf1, 0xaa, 0x8c, 0x61, 0xb8, 0x75, 0xc7, 0x30, 0x8, 0xa9, 0x81, 0xaa, 0x91, 0x92, 0x85, 0x38, 0x94, 0x90, 0x21, 0xe, 0x2e, 0xef, 0x3f, 0xc6, 0xaa, 0x26, 0x97, 0xdc, 0x22, 0x35, 0xa3, 0x11, 0x20, 0x81, 0x68, 0xbd, 0x62, 0x28, 0x4e, 0x29, 0xb1, 0x5a, 0xb9, 0x2b, 0xc7, 0x7f, 0x14, 0xea, 0xd3, 0x13, 0xaa, 0xf4, 0xc7, 0x2b, 0x53, 0x3, 0xbe, 0xf5, 0x4a, 0x8f, 0x85, 0x95, 0xf9, 0x3f, 0x31, 0x4a, 0x84, 0xda, 0x53, 0x7b, 0x72, 0x6a, 0x5e, 0xfb, 0x97, 0x72, 0x5f, 0x1f, 0xfa, 0x7f, 0x39, 0xec, 0x8b, 0xd5, 0xa1, 0xff, 0xef, 0x87, 0x3d, 0xd3, 0xac, 0xa2, 0xe9, 0xbf, 0xfb, 0xf7, 0xc3, 0xf9, 0x54, 0x95, 0xa7, 0xde, 0x5f, 0xcb, 0x2f, 0xef, 0xfa, 0xbb, 0xc3, 0xfe, 0x20, 0xac, 0xa2, 0xa0, 0x65, 0xac, 0xb, 0xf7, 0xa2, 0x53, 0xc7, 0x92, 0x70, 0xfb, 0xa4, 0x7d, 0xf2, 0xe3, 0x78, 0xc6, 0x86, 0xc4, 0xc8, 0x38, 0xe1, 0x69, 0x33, 0xde, 0x4c, 0xfd, 0x45, 0x9a, 0x2b, 0x63, 0xb0, 0x1b, 0x61, 0x7c, 0xa8, 0x35, 0x99, 0x4c, 0xc8, 0x75, 0x1f, 0xb0, 0xf1, 0x50, 0xed, 0x9b, 0xb2, 0x65, 0x16, 0x90, 0xaf, 0x6c, 0xb0, 0x7f, 0x4e, 0x2f, 0xcb, 0x42, 0x2d, 0x5e, 0xc, 0xc7, 0xb3, 0xf7, 0x8b, 0xce, 0x98, 0x9c, 0xdd, 0x1e, 0x64, 0x39, 0x83, 0xf6, 0x94, 0x2f, 0xf4, 0x78, 0x1e, 0x8f, 0xda, 0x1f, 0xf1, 0x77, 0x45, 0xc4, 0x9e, 0xaa, 0x6b, 0xdb, 0xac, 0x31, 0x77, 0xad, 0xb8, 0x9a, 0x5f, 0x82, 0x72, 0x23, 0x4b, 0x68, 0x5f, 0x98, 0x6c, 0xe4, 0x92, 0x7e, 0xae, 0x16, 0xf6, 0xeb, 0x5a, 0x26, 0x72, 0x37, 0xa7, 0xd2, 0xf8, 0xef, 0x5, 0x14, 0x68, 0xd8, 0x78, 0x33, 0xfe, 0x7, 0x59, 0x77, 0x5b, 0xad, 0x56, 0x41, 0x93, 0xb2, 0xaa, 0xf4, 0x1c, 0x85, 0xc9, 0x90, 0xe5, 0x5a, 0x77, 0xaf, 0x17, 0x7a, 0x60, 0x96, 0x5d, 0x30, 0xb7, 0x88, 0xed, 0xfb, 0x7, 0x85, 0xe, 0x79, 0xb6, 0x66, 0x75, 0xe2, 0x3b, 0x0, 0x7c, 0x6b, 0x80, 0xaf, 0xbf, 0x29, 0x71, 0x4c, 0xa6, 0x5c, 0x82, 0xda, 0xed, 0xf, 0xbe, 0xe5, 0x12, 0xed, 0x3a, 0xe4, 0x7d, 0xaf, 0xa8, 0xf8, 0x6, 0xab, 0xfd, 0x1c, 0x6c, 0xea, 0x73, 0x65, 0x7c, 0xd5, 0xc9, 0x5f, 0x7f, 0x92, 0xc6, 0x56, 0x24, 0x38, 0xb6, 0x7a, 0x14, 0xe, 0xa1, 0xc4, 0xe4, 0x97, 0x1e, 0xdf, 0x98, 0x12, 0x2f, 0x2a, 0x7d, 0x26, 0xc6, 0x14, 0x61, 0x86, 0xa7, 0xa7, 0x31, 0x9a, 0xe1, 0xe9, 0x91, 0xc8, 0x30, 0x1a, 0x67, 0x19, 0x9a, 0x63, 0x34, 0x92, 0x59, 0x86, 0xa7, 0xc3, 0x17, 0x67, 0x3c, 0x33, 0x18, 0x81, 0x15, 0xb, 0xc9, 0xfd, 0x40, 0xce, 0xdd, 0x99, 0xe0, 0x7, 0xf5, 0xcb, 0x60, 0xd4, 0x37, 0x5f, 0x99, 0xfd, 0x4, 0xa9, 0x63, 0xf3, 0x69, 0xbf, 0x26, 0xe6, 0x6b, 0x6a, 0xbe, 0x66, 0xe6, 0x6b, 0x6e, 0xbe, 0x1e, 0xcd, 0xd7, 0x47, 0xf3, 0xf5, 0x24, 0xbf, 0x76, 0x6b, 0x5d, 0x34, 0xff, 0xca, 0xec, 0x27, 0x48, 0x1d, 0x9b, 0x4f, 0xfb, 0x35, 0x31, 0x5f, 0x53, 0xf3, 0x35, 0x33, 0x5f, 0x73, 0xf3, 0xf5, 0x68, 0xbe, 0x3e, 0x9a, 0x2f, 0x55, 0x74, 0xb3, 0xd3, 0x45, 0xf3, 0xaf, 0xcc, 0x7e, 0x82, 0xd4, 0xb1, 0xf9, 0xb4, 0x5f, 0x13, 0xf3, 0x35, 0x35, 0x5f, 0x33, 0xf3, 0x35, 0x37, 0x5f, 0x8f, 0xe6, 0xeb, 0xa3, 0xf9, 0x52, 0x45, 0x7f, 0x6d, 0x74, 0xd1, 0xfc, 0x2b, 0xb3, 0x9f, 0x20, 0x75, 0x6c, 0x3e, 0xed, 0xd7, 0xc4, 0x7c, 0x4d, 0xcd, 0xd7, 0xcc, 0x7c, 0xcd, 0xcd, 0xd7, 0xa3, 0xf9, 0xfa, 0x68, 0xbe, 0x9e, 0x2e, 0xe1, 0x49, 0x15, 0xae, 0x52, 0x60, 0x75, 0xb8, 0x93, 0xc2, 0xff, 0x13, 0x2b, 0x60, 0x27, 0x8, 0x96, 0x8b, 0xf1, 0xc5, 0x2e, 0xc2, 0xdb, 0xd4, 0x91, 0xee, 0x42, 0xa3, 0xe1, 0x5c, 0xfe, 0xef, 0x11, 0x40, 0x33, 0x5, 0xfd, 0x38, 0x19, 0x4e, 0xd4, 0xff, 0x2c, 0xf4, 0xc9, 0x74, 0x57, 0x9b, 0xf6, 0x51, 0xa5, 0xcd, 0xe7, 0x8, 0xb9, 0x47, 0x5, 0x9c, 0x7d, 0x44, 0xa8, 0xcd, 0x35, 0x10, 0x70, 0x37, 0x53, 0x69, 0x53, 0x8c, 0xb9, 0xa9, 0x2, 0x4e, 0x30, 0xde, 0x26, 0xa, 0x38, 0x6, 0xbc, 0x19, 0x1, 0x60, 0xbc, 0x69, 0x39, 0x60, 0xac, 0x89, 0xf1, 0xa, 0x93, 0x9f, 0x6a, 0x5b, 0x28, 0x3f, 0x9, 0x1a, 0x29, 0x10, 0x2a, 0x44, 0x89, 0x92, 0x29, 0x14, 0x54, 0x92, 0x2, 0xe5, 0x49, 0x61, 0x40, 0x71, 0xa, 0xc0, 0x47, 0x5, 0x40, 0x65, 0x2a, 0x30, 0x1e, 0x15, 0xc6, 0x8c, 0xe4, 0x7e, 0xae, 0x31, 0x7c, 0xde, 0x67, 0xa, 0x30, 0x25, 0x59, 0x9f, 0x2a, 0x8c, 0x9, 0xc9, 0xf9, 0x44, 0x61, 0x8c, 0x7d, 0xce, 0x8d, 0xc8, 0x48, 0xce, 0xb5, 0xe4, 0x48, 0xc6, 0xb5, 0xdc, 0xe4, 0x76, 0x91, 0x81, 0x34, 0x5b, 0xde, 0x20, 0xb2, 0xfb, 0xb9, 0xed, 0xc1, 0x21, 0x23, 0x9, 0x21, 0x9a, 0x83, 0x63, 0x64, 0x12, 0x83, 0x68, 0xd, 0x86, 0xf1, 0x24, 0x11, 0xdc, 0xc6, 0x60, 0xe9, 0x1f, 0x65, 0x3a, 0xd1, 0x16, 0xc, 0xe1, 0x51, 0x22, 0x10, 0x4d, 0xc1, 0x10, 0xe6, 0xa, 0xc1, 0xe7, 0x7a, 0x26, 0xd3, 0xa7, 0x24, 0xd3, 0x53, 0x89, 0x30, 0x21, 0x79, 0x9e, 0x48, 0x84, 0xb1, 0xcf, 0xb3, 0x16, 0x14, 0xc9, 0xb3, 0x92, 0x17, 0xc9, 0xb2, 0x92, 0x96, 0xd3, 0x6, 0x72, 0x97, 0x96, 0xb7, 0x82, 0xb3, 0x1c, 0x0, 0x1b, 0x43, 0xa3, 0x8c, 0x1c, 0x14, 0xb4, 0x55, 0x34, 0x6a, 0xe6, 0xa0, 0xa2, 0xcd, 0xa3, 0x50, 0x9f, 0x1c, 0x4c, 0xd8, 0x4e, 0xa, 0xe1, 0xa3, 0x83, 0x80, 0x36, 0x98, 0xc2, 0x7c, 0x74, 0x30, 0xd1, 0x96, 0x53, 0x98, 0x73, 0x17, 0x33, 0xac, 0xeb, 0xcc, 0x41, 0x98, 0x46, 0xaa, 0x3a, 0x75, 0x30, 0x27, 0x91, 0x9a, 0x4e, 0x1c, 0xcc, 0x71, 0x58, 0x53, 0xaf, 0x9, 0x22, 0x35, 0x75, 0x5b, 0x22, 0x52, 0xd1, 0xac, 0xf3, 0xe2, 0xd4, 0x3f, 0x6d, 0x80, 0x10, 0x38, 0x39, 0x51, 0x4a, 0xe0, 0xe4, 0x4, 0x1b, 0xa4, 0x93, 0x13, 0xfc, 0x92, 0x4e, 0x4e, 0x14, 0xe3, 0x39, 0x39, 0xce, 0x4, 0xe9, 0xe4, 0x38, 0xaf, 0xa4, 0x93, 0xe3, 0x55, 0xf2, 0x9d, 0x1c, 0xaf, 0x30, 0xe9, 0xe4, 0xb8, 0x5c, 0x48, 0x27, 0xc7, 0xc5, 0xe7, 0x3b, 0x39, 0x2e, 0x5c, 0xd2, 0xc9, 0xf1, 0xaa, 0x52, 0x4e, 0x8e, 0xc1, 0x28, 0x27, 0x67, 0x40, 0xb4, 0x93, 0x33, 0x28, 0xb4, 0x93, 0xd3, 0x28, 0x81, 0x93, 0xd3, 0x0, 0xda, 0xc9, 0x69, 0xc, 0xda, 0xc9, 0x69, 0x8c, 0xc0, 0xc9, 0x69, 0x0, 0xed, 0xe4, 0x34, 0x6, 0xed, 0xe4, 0x34, 0x46, 0xe0, 0xe4, 0x34, 0x80, 0x76, 0x72, 0x46, 0x2e, 0x94, 0x93, 0xd3, 0x8, 0xa1, 0x93, 0x13, 0x10, 0xd4, 0xc9, 0x19, 0x8, 0xe9, 0xe4, 0xc, 0x6, 0xe9, 0xe4, 0x34, 0x86, 0xef, 0xe4, 0x74, 0x3a, 0xe9, 0xe4, 0x34, 0x2, 0xe9, 0xe4, 0x34, 0x82, 0xef, 0xe4, 0x74, 0x3a, 0xe9, 0xe4, 0x34, 0x2, 0xe9, 0xe4, 0x34, 0x82, 0xef, 0xe4, 0x74, 0x3a, 0xe9, 0xe4, 0x8c, 0x38, 0x8, 0x27, 0xa7, 0xe1, 0x81, 0x93, 0x63, 0x80, 0x94, 0x93, 0x3, 0x28, 0x29, 0x27, 0x7, 0x50, 0x53, 0x4e, 0xce, 0xa2, 0x12, 0x4e, 0xce, 0x22, 0xa4, 0x9c, 0x9c, 0xc5, 0x4c, 0x39, 0x39, 0x8b, 0x49, 0x38, 0x39, 0x8b, 0x90, 0x72, 0x72, 0x16, 0x33, 0xe5, 0xe4, 0x2c, 0x26, 0xe1, 0xe4, 0x2c, 0x42, 0xca, 0xc9, 0x1, 0xf9, 0xc6, 0x9d, 0x9c, 0x45, 0xf4, 0x9d, 0x5c, 0x74, 0xc5, 0xe1, 0x9f, 0x34, 0x3, 0xf, 0xbc, 0x9c, 0x28, 0x25, 0xf0, 0x72, 0x82, 0xd, 0xd2, 0xcb, 0x9, 0x7e, 0x49, 0x2f, 0x27, 0x8a, 0xf1, 0xbc, 0x1c, 0x67, 0x82, 0xf4, 0x72, 0x9c, 0x57, 0xd2, 0xcb, 0xf1, 0x2a, 0xf9, 0x5e, 0x8e, 0x57, 0x98, 0xf4, 0x72, 0x5c, 0x2e, 0xa4, 0x97, 0xe3, 0xe2, 0xf3, 0xbd, 0x1c, 0x17, 0x2e, 0xe9, 0xe5, 0x78, 0x55, 0x29, 0x2f, 0xc7, 0x60, 0x94, 0x97, 0x33, 0x20, 0xda, 0xcb, 0x19, 0x14, 0xda, 0xcb, 0x69, 0x94, 0xc0, 0xcb, 0x69, 0x0, 0xed, 0xe5, 0x34, 0x6, 0xed, 0xe5, 0x34, 0x46, 0xe0, 0xe5, 0x34, 0x80, 0xf6, 0x72, 0x1a, 0x83, 0xf6, 0x72, 0x1a, 0x23, 0xf0, 0x72, 0x1a, 0x40, 0x7b, 0x39, 0x23, 0x17, 0xca, 0xcb, 0x69, 0x84, 0xd0, 0xcb, 0x9, 0x8, 0xea, 0xe5, 0xc, 0x84, 0xf4, 0x72, 0x6, 0x83, 0xf4, 0x72, 0x1a, 0xc3, 0xf7, 0x72, 0x3a, 0x9d, 0xf4, 0x72, 0x1a, 0x81, 0xf4, 0x72, 0x1a, 0xc1, 0xf7, 0x72, 0x3a, 0x9d, 0xf4, 0x72, 0x1a, 0x81, 0xf4, 0x72, 0x1a, 0xc1, 0xf7, 0x72, 0x3a, 0x9d, 0xf4, 0x72, 0x46, 0x1c, 0x84, 0x97, 0xd3, 0xf0, 0xc0, 0xcb, 0x31, 0x40, 0xca, 0xcb, 0x1, 0x94, 0x94, 0x97, 0x3, 0xa8, 0x29, 0x2f, 0x67, 0x51, 0x9, 0x2f, 0x67, 0x11, 0x52, 0x5e, 0xce, 0x62, 0xa6, 0xbc, 0x9c, 0xc5, 0x24, 0xbc, 0x9c, 0x45, 0x48, 0x79, 0x39, 0x8b, 0x99, 0xf2, 0x72, 0x16, 0x93, 0xf0, 0x72, 0x16, 0x21, 0xe5, 0xe5, 0x80, 0x7c, 0xe3, 0x5e, 0xce, 0x22, 0x76, 0xf0, 0x72, 0x60, 0x99, 0xfc, 0x9f, 0xb4, 0xc6, 0x1d, 0xb8, 0x39, 0x51, 0x4a, 0xe0, 0xe6, 0x4, 0x1b, 0xa4, 0x9b, 0x13, 0xfc, 0x92, 0x6e, 0x4e, 0x14, 0xe3, 0xb9, 0x39, 0xce, 0x4, 0xe9, 0xe6, 0x38, 0xaf, 0xa4, 0x9b, 0xe3, 0x55, 0xf2, 0xdd, 0x1c, 0xaf, 0x30, 0xe9, 0xe6, 0xb8, 0x5c, 0x48, 0x37, 0xc7, 0xc5, 0xe7, 0xbb, 0x39, 0x2e, 0x5c, 0xd2, 0xcd, 0xf1, 0xaa, 0x52, 0x6e, 0x8e, 0xc1, 0x28, 0x37, 0x67, 0x40, 0xb4, 0x9b, 0x33, 0x28, 0xb4, 0x9b, 0xd3, 0x28, 0x81, 0x9b, 0xd3, 0x0, 0xda, 0xcd, 0x69, 0xc, 0xda, 0xcd, 0x69, 0x8c, 0xc0, 0xcd, 0x69, 0x0, 0xed, 0xe6, 0x34, 0x6, 0xed, 0xe6, 0x34, 0x46, 0xe0, 0xe6, 0x34, 0x80, 0x76, 0x73, 0x46, 0x2e, 0x94, 0x9b, 0xd3, 0x8, 0xa1, 0x9b, 0x13, 0x10, 0xd4, 0xcd, 0x19, 0x8, 0xe9, 0xe6, 0xc, 0x6, 0xe9, 0xe6, 0x34, 0x86, 0xef, 0xe6, 0x74, 0x3a, 0xe9, 0xe6, 0x34, 0x2, 0xe9, 0xe6, 0x34, 0x82, 0xef, 0xe6, 0x74, 0x3a, 0xe9, 0xe6, 0x34, 0x2, 0xe9, 0xe6, 0x34, 0x82, 0xef, 0xe6, 0x74, 0x3a, 0xe9, 0xe6, 0x8c, 0x38, 0x8, 0x37, 0xa7, 0xe1, 0x81, 0x9b, 0x63, 0x80, 0x94, 0x9b, 0x3, 0x28, 0x29, 0x37, 0x7, 0x50, 0x53, 0x6e, 0xce, 0xa2, 0x12, 0x6e, 0xce, 0x22, 0xa4, 0xdc, 0x9c, 0xc5, 0x4c, 0xb9, 0x39, 0x8b, 0x49, 0xb8, 0x39, 0x8b, 0x90, 0x72, 0x73, 0x16, 0x33, 0xe5, 0xe6, 0x2c, 0x26, 0xe1, 0xe6, 0x2c, 0x42, 0xca, 0xcd, 0x1, 0xf9, 0xc6, 0xdd, 0x9c, 0x45, 0xc, 0xdc, 0x9c, 0xba, 0x17, 0x17, 0xbb, 0x31, 0xaf, 0x82, 0x6, 0x98, 0xe3, 0x47, 0xfc, 0x70, 0xdf, 0x1c, 0x6c, 0xe6, 0xa9, 0xc3, 0x26, 0x3c, 0xc9, 0x39, 0xaa, 0xbb, 0xf0, 0x8f, 0x33, 0xb7, 0x5b, 0xe4, 0x84, 0xb3, 0x28, 0x1f, 0x5c, 0x7c, 0xf1, 0xee, 0xc1, 0x20, 0x67, 0x8, 0x65, 0x9e, 0xe7, 0x96, 0x5f, 0x49, 0x7b, 0x6e, 0x4f, 0xcf, 0xe6, 0xb6, 0x1d, 0x48, 0xda, 0x9a, 0x24, 0x7e, 0xbc, 0xc6, 0xc3, 0x32, 0x49, 0x16, 0x8b, 0x1f, 0x6, 0xf5, 0xb0, 0x4c, 0xd2, 0xf6, 0xe2, 0x9c, 0xac, 0x20, 0xe, 0x4e, 0x78, 0xf7, 0xad, 0x98, 0x90, 0x88, 0xab, 0x36, 0xfa, 0xe0, 0x5e, 0x58, 0x8c, 0x7f, 0xd1, 0x5f, 0xd4, 0xd9, 0x3b, 0x2, 0x38, 0xa6, 0x8, 0xa9, 0x56, 0x7a, 0xd0, 0x4, 0xf3, 0x4d, 0x75, 0xd2, 0x27, 0xe9, 0x40, 0xb5, 0xe2, 0x68, 0x46, 0x20, 0xac, 0x21, 0xc5, 0xfd, 0xd1, 0x24, 0xb9, 0x38, 0x9e, 0x2b, 0x60, 0x17, 0x46, 0x91, 0x4c, 0xa3, 0x6e, 0xc1, 0x5d, 0xd0, 0x3c, 0x73, 0xf4, 0xe1, 0x41, 0xfc, 0xd, 0xe1, 0x94, 0xc0, 0x7a, 0x43, 0x42, 0xf5, 0xf5, 0x15, 0x43, 0x75, 0x83, 0x73, 0x75, 0xd8, 0xaf, 0xcb, 0x7d, 0x53, 0xae, 0x11, 0x85, 0x43, 0x81, 0x5b, 0x4, 0x18, 0x28, 0x21, 0xa, 0xc4, 0x72, 0x6, 0x8a, 0x89, 0x2, 0xad, 0x8a, 0x4e, 0x4c, 0x7, 0x31, 0x77, 0x4f, 0xfd, 0xbb, 0xa8, 0x58, 0x45, 0x10, 0xd8, 0x36, 0x84, 0x85, 0xd5, 0x40, 0x60, 0x48, 0xbe, 0xb0, 0x12, 0x8, 0xc, 0xbb, 0x20, 0xeb, 0xb4, 0xd8, 0xbd, 0x4, 0x55, 0xd7, 0x51, 0x56, 0x65, 0x6c, 0x5, 0xd4, 0xb4, 0xa7, 0xea, 0x8, 0xea, 0x9c, 0xef, 0xdb, 0x2d, 0x33, 0x94, 0x3, 0x7e, 0xe7, 0xff, 0xa7, 0xc3, 0x7a, 0xfd, 0x1e, 0x3b, 0x2d, 0xef, 0x70, 0x24, 0xe, 0x9a, 0xdb, 0xfc, 0xe4, 0x11, 0xfb, 0x8f, 0xb3, 0xd9, 0x7c, 0x22, 0x6d, 0x6d, 0x8f, 0xa5, 0xfd, 0xb2, 0xaa, 0x8b, 0xa6, 0xf9, 0xd3, 0xcf, 0xdc, 0x36, 0x7f, 0xa, 0xee, 0xb3, 0xc9, 0x41, 0xbe, 0x38, 0xf4, 0xe5, 0x5e, 0xec, 0x66, 0xe8, 0xe7, 0xdd, 0xfe, 0xaa, 0x2f, 0x28, 0x3b, 0x54, 0xfa, 0xfa, 0xb2, 0xf2, 0xbd, 0xb4, 0x4b, 0x7e, 0xc0, 0xc9, 0x35, 0xa3, 0x43, 0x79, 0x13, 0xf, 0x31, 0xb0, 0x6, 0xb2, 0xd, 0x4d, 0xef, 0x7a, 0xa8, 0x2f, 0xf0, 0x5, 0x46, 0xd9, 0x87, 0x28, 0x9d, 0x41, 0xca, 0xf1, 0x21, 0x98, 0x3d, 0x27, 0xa8, 0x21, 0xe5, 0x28, 0x95, 0x40, 0xca, 0xf1, 0x21, 0x98, 0x47, 0x20, 0xa8, 0xd9, 0x72, 0xe8, 0x16, 0x47, 0xd5, 0x44, 0xe5, 0xca, 0x55, 0xaa, 0x51, 0xe1, 0x28, 0xd6, 0xb6, 0x1f, 0x51, 0xb9, 0x67, 0x97, 0x45, 0xf, 0xc7, 0x56, 0x41, 0x62, 0x53, 0x58, 0x5b, 0x7, 0xb, 0xbb, 0xde, 0xb1, 0x9e, 0x3e, 0xcd, 0xa6, 0x81, 0x96, 0xa8, 0xb, 0x26, 0x98, 0x9a, 0x18, 0x10, 0xaa, 0x27, 0xa, 0x8a, 0x29, 0x8a, 0xf, 0xd2, 0xfa, 0x80, 0x94, 0x15, 0x80, 0x50, 0x5d, 0x21, 0x8, 0x62, 0x65, 0x69, 0x9d, 0x40, 0xca, 0xa, 0x40, 0xa8, 0xbe, 0x10, 0x4, 0x41, 0x59, 0xf4, 0x95, 0x1d, 0x5c, 0x17, 0x9c, 0x3b, 0x3c, 0xb4, 0xca, 0x78, 0x68, 0x9, 0x9d, 0x71, 0xd9, 0x44, 0x94, 0xc6, 0x21, 0x47, 0x6b, 0x4d, 0xf2, 0x82, 0xd1, 0xaa, 0x28, 0xa7, 0xab, 0x40, 0x6d, 0xf8, 0x4d, 0x22, 0x4c, 0x67, 0x64, 0x3a, 0xaa, 0x30, 0x1c, 0x84, 0x69, 0x8b, 0x93, 0xae, 0xf5, 0xc1, 0xa7, 0xef, 0xa6, 0xa3, 0x4a, 0x82, 0xd1, 0x9, 0xe8, 0x6b, 0x1d, 0xf0, 0xe9, 0xbb, 0xe9, 0xa8, 0x62, 0x60, 0x74, 0x34, 0x7d, 0xfa, 0xde, 0x15, 0xde, 0xd6, 0xf6, 0x22, 0x16, 0xad, 0xf, 0x10, 0x27, 0xa1, 0xc, 0x80, 0x35, 0x44, 0x13, 0x2c, 0x21, 0x5a, 0xd, 0xa2, 0x37, 0xc3, 0xa6, 0xf3, 0xe5, 0xc7, 0x75, 0x11, 0xe8, 0x80, 0xba, 0xff, 0x85, 0xa9, 0x81, 0x1, 0xa1, 0x9a, 0xa0, 0xa0, 0x98, 0x32, 0xf8, 0x20, 0xdd, 0xee, 0x48, 0x59, 0x1, 0x8, 0xd5, 0xa, 0x82, 0x20, 0x56, 0x96, 0xd6, 0x1, 0xa4, 0xac, 0x0, 0x84, 0x6a, 0x8, 0x41, 0x10, 0x94, 0x45, 0xdf, 0xa8, 0xc3, 0x75, 0xc0, 0xb9, 0x62, 0x47, 0xab, 0x8a, 0x87, 0x96, 0xd0, 0x16, 0x97, 0x4d, 0x44, 0x61, 0x1c, 0x72, 0xb4, 0xce, 0x24, 0xef, 0xff, 0x95, 0xc5, 0x78, 0x32, 0xf, 0xd4, 0x46, 0x5e, 0xf3, 0xc3, 0xb4, 0x46, 0x43, 0x50, 0xa5, 0x91, 0x40, 0x4c, 0x67, 0x3c, 0x88, 0xd6, 0x8b, 0xb0, 0x1c, 0x1f, 0x82, 0x2a, 0xc, 0x4e, 0xd, 0x29, 0x47, 0xeb, 0x44, 0x58, 0x8e, 0xf, 0x41, 0x95, 0x5, 0xa7, 0x66, 0xcb, 0xa1, 0x2f, 0x4b, 0xe2, 0x3a, 0x0, 0x6f, 0x4f, 0xd2, 0x9a, 0xe2, 0x62, 0x25, 0x14, 0xc5, 0x61, 0x11, 0xd1, 0x13, 0x48, 0x8c, 0x56, 0x93, 0xc4, 0xb5, 0xce, 0xf5, 0x74, 0xb2, 0x99, 0x68, 0xe3, 0x2, 0xe2, 0x94, 0x98, 0x98, 0x5b, 0x83, 0xaf, 0xea, 0x48, 0xbe, 0x3d, 0x9f, 0x3c, 0xcc, 0x46, 0x3f, 0xea, 0x35, 0xfe, 0x66, 0x75, 0x2a, 0xcb, 0x7d, 0xaf, 0xd8, 0xaf, 0x7b, 0x3f, 0xd9, 0xe5, 0x87, 0xc7, 0xf9, 0xa3, 0x58, 0xed, 0xf, 0xa8, 0x92, 0xab, 0x13, 0xa3, 0x99, 0xbc, 0x1f, 0x7, 0x6e, 0xe, 0xa8, 0x7b, 0x84, 0x3c, 0xac, 0xa3, 0x49, 0x95, 0x77, 0x71, 0x78, 0x12, 0x67, 0x8a, 0x61, 0xf0, 0x45, 0x14, 0x79, 0xc5, 0x60, 0x59, 0x9c, 0x16, 0xa9, 0x59, 0x90, 0xe5, 0xe4, 0x59, 0x4d, 0x61, 0x83, 0xab, 0xa3, 0x4, 0x22, 0x36, 0xf1, 0x8b, 0x21, 0x6d, 0x23, 0x48, 0xe1, 0x54, 0x30, 0x86, 0x14, 0xa3, 0x14, 0xce, 0xe5, 0x62, 0x48, 0x5b, 0xfc, 0xaa, 0x3a, 0x9e, 0xcf, 0xcc, 0xa, 0x6d, 0x1c, 0xc4, 0x24, 0x2a, 0x14, 0x12, 0x5c, 0x76, 0xe8, 0xdf, 0x92, 0x73, 0x7b, 0x6b, 0x4e, 0x2b, 0xce, 0xbb, 0x73, 0xde, 0x5c, 0xa6, 0x15, 0xfc, 0xdd, 0x39, 0x9d, 0x32, 0x2f, 0xce, 0xf5, 0xc2, 0x1b, 0x25, 0xd, 0xee, 0x83, 0xde, 0x26, 0xe8, 0xdb, 0x32, 0x2, 0x39, 0xdf, 0x99, 0xf1, 0xd6, 0x12, 0x81, 0x94, 0xef, 0xcc, 0x8, 0x4b, 0xbc, 0x38, 0x37, 0x3c, 0x6f, 0x11, 0x32, 0x20, 0x12, 0xeb, 0x6a, 0x89, 0x8c, 0xdb, 0x1b, 0x64, 0x75, 0x7b, 0x89, 0x58, 0x46, 0x6f, 0x15, 0x87, 0xaf, 0x59, 0x6f, 0xaa, 0xb2, 0x5e, 0x37, 0x65, 0xb, 0xee, 0x8b, 0x99, 0x60, 0x3f, 0x26, 0xce, 0x91, 0xdd, 0xb7, 0xcd, 0xae, 0x75, 0xf9, 0x52, 0xee, 0xd7, 0xde, 0x75, 0x39, 0x60, 0xc6, 0x7d, 0x3a, 0x44, 0x2c, 0x11, 0x19, 0xfd, 0x3, 0xb, 0x1c, 0xe6, 0x87, 0x2d, 0xf3, 0x82, 0x2d, 0x85, 0x41, 0x3, 0x94, 0x49, 0x97, 0x21, 0xeb, 0xba, 0xc4, 0x83, 0x72, 0x19, 0xe3, 0x17, 0x67, 0xc2, 0xf8, 0x94, 0x6f, 0x1d, 0x2f, 0xae, 0x63, 0x68, 0x50, 0x1d, 0x2c, 0x41, 0xdc, 0x7f, 0x74, 0x83, 0xab, 0xc8, 0xb, 0xa7, 0x90, 0xd0, 0xa6, 0xe2, 0x57, 0xdc, 0xdd, 0x28, 0xc2, 0xe, 0x49, 0xe6, 0xe9, 0x3f, 0x91, 0x2d, 0xa5, 0x42, 0xb, 0xfe, 0xb2, 0x3b, 0xd7, 0x6d, 0x75, 0xe4, 0x17, 0xe7, 0x55, 0x2, 0x6f, 0x9f, 0x4f, 0x54, 0xbc, 0x4f, 0x51, 0xa6, 0xa, 0xda, 0x86, 0xd5, 0x29, 0x4, 0xc9, 0x9a, 0x7d, 0xb7, 0x78, 0x6d, 0x2c, 0x8d, 0x15, 0x85, 0x5f, 0xdf, 0x14, 0x8b, 0xd6, 0x4f, 0xee, 0x7d, 0xcd, 0x74, 0xbc, 0x3c, 0xbd, 0x66, 0xcd, 0xaf, 0xfa, 0xf, 0x54, 0x4, 0x65, 0x5a, 0xdf, 0xf5, 0x3d, 0xc7, 0x27, 0x10, 0xb6, 0xeb, 0x23, 0x6b, 0xbe, 0xd1, 0xfc, 0xbe, 0x72, 0x17, 0x68, 0x80, 0x44, 0x98, 0x5a, 0xed, 0x8a, 0x97, 0x52, 0x5f, 0x64, 0xf5, 0xc6, 0x37, 0x91, 0x5b, 0x9a, 0xb1, 0xab, 0xb9, 0x9c, 0x0, 0xff, 0xf, 0xde, 0xb8, 0xcd, 0x1e, 0xf1, 0xcb, 0xb9, 0x24, 0x2e, 0x12, 0xf2, 0xcd, 0xc6, 0x88, 0x64, 0xcd, 0x8, 0xc2, 0xb6, 0xf5, 0x86, 0xa3, 0x59, 0xd3, 0xf, 0x19, 0xa, 0x70, 0xbc, 0x0, 0x71, 0x71, 0x7a, 0x31, 0x3a, 0x6f, 0x41, 0xc4, 0x55, 0x9, 0xa5, 0xd1, 0x90, 0x9a, 0x73, 0x49, 0xd6, 0xc6, 0xc2, 0x76, 0xb3, 0xc9, 0x48, 0xc2, 0x4c, 0x99, 0x56, 0xe5, 0xf6, 0x50, 0xaf, 0x6d, 0xa4, 0x1b, 0x7e, 0x9d, 0xf7, 0xc0, 0x83, 0xd1, 0xb6, 0xdf, 0xf2, 0x91, 0x97, 0x89, 0x8f, 0x70, 0x45, 0x9f, 0x22, 0x32, 0x6, 0x65, 0x98, 0xa8, 0xbf, 0x5d, 0xf3, 0x80, 0x70, 0xc9, 0x6e, 0xfa, 0x89, 0xf9, 0x4e, 0x1e, 0x3b, 0xee, 0x53, 0x5f, 0xfb, 0xa, 0x8b, 0xda, 0x73, 0x3b, 0x9, 0x32, 0xe9, 0x94, 0x46, 0x9c, 0xa8, 0x16, 0x28, 0x33, 0x49, 0x5b, 0x45, 0xf2, 0xd8, 0x1f, 0xf8, 0x9e, 0x27, 0xf, 0x98, 0xb4, 0x36, 0xf1, 0x80, 0x5d, 0xc4, 0x78, 0xa0, 0x62, 0x32, 0xb8, 0x30, 0x32, 0x7f, 0xd1, 0xa8, 0xdc, 0xfd, 0xad, 0xcb, 0xcf, 0xd5, 0xaa, 0x1c, 0x1c, 0xab, 0xaf, 0x65, 0x3d, 0x10, 0xe1, 0x28, 0xf3, 0xec, 0xfd, 0x5, 0xd0, 0x5f, 0x17, 0x6d, 0xe9, 0x58, 0xf4, 0xb6, 0xda, 0xb9, 0x9, 0x1c, 0x83, 0x27, 0xe, 0x98, 0x9, 0x29, 0x6a, 0x7, 0xb4, 0x63, 0xbc, 0x33, 0xde, 0xa0, 0x7d, 0x90, 0x61, 0xc1, 0x64, 0xfb, 0x89, 0x6d, 0xc1, 0x41, 0xb3, 0xeb, 0x5, 0xe5, 0x45, 0x10, 0x64, 0xf9, 0x9, 0xa, 0x90, 0x9f, 0x8, 0xaa, 0xe4, 0xcf, 0xaf, 0xcc, 0x27, 0x95, 0xa3, 0xd9, 0x5, 0xf5, 0x46, 0x21, 0x5e, 0x81, 0x28, 0x8e, 0x2c, 0xc9, 0x80, 0x5c, 0x91, 0x8c, 0x7c, 0x91, 0xd4, 0x2f, 0x9, 0x91, 0xb8, 0x8, 0x88, 0x48, 0x42, 0xa, 0xa4, 0x48, 0x5c, 0xd4, 0xb8, 0x48, 0xea, 0x17, 0x4a, 0x24, 0x2e, 0x4, 0x17, 0x89, 0x8b, 0xe3, 0x88, 0xa4, 0x7e, 0x71, 0x44, 0x32, 0x1b, 0x8b, 0x3b, 0xe5, 0xa2, 0x3, 0xc8, 0x20, 0xd8, 0xfe, 0x34, 0x5a, 0x5c, 0xb, 0x56, 0xde, 0xb9, 0x3f, 0x14, 0xce, 0x18, 0xb9, 0x6d, 0xec, 0x47, 0x19, 0x5, 0x1, 0xf5, 0x90, 0x70, 0x7a, 0x90, 0x66, 0x4f, 0x8c, 0xbb, 0x14, 0x65, 0xf9, 0xe3, 0x2, 0xd6, 0x6, 0xc6, 0xc1, 0xe5, 0xe5, 0x71, 0x48, 0x31, 0xf3, 0x23, 0xb8, 0x5b, 0xea, 0xe8, 0xb8, 0xc9, 0x80, 0x55, 0xa0, 0x25, 0x2, 0x4b, 0xb2, 0x14, 0xc, 0x45, 0x14, 0x0, 0xc9, 0xab, 0x6, 0x61, 0x61, 0xc0, 0x4e, 0xe7, 0xbe, 0xfe, 0xd8, 0xa9, 0xff, 0x83, 0x2f, 0xdd, 0x7, 0x25, 0x64, 0x20, 0xc4, 0x81, 0xd3, 0xa, 0xaa, 0x60, 0x97, 0x8d, 0x48, 0x9b, 0xd0, 0xa1, 0xa3, 0x50, 0x51, 0xa2, 0xc1, 0x6a, 0x17, 0x7e, 0x90, 0x48, 0x4a, 0xe0, 0x8a, 0x9d, 0x87, 0x38, 0xb7, 0xf, 0x2e, 0xef, 0x58, 0xa4, 0x2a, 0x75, 0xd4, 0x9, 0xa9, 0xf8, 0x50, 0x9b, 0x78, 0xdb, 0x8e, 0x26, 0xc9, 0xd1, 0xa6, 0x10, 0x5f, 0x24, 0xfb, 0xc8, 0x98, 0xeb, 0xf0, 0xb4, 0x33, 0x86, 0xa2, 0x2b, 0x88, 0xe1, 0x0, 0xa5, 0xa6, 0xe1, 0x11, 0x2, 0xa8, 0x5e, 0xc6, 0xf1, 0x94, 0x8e, 0x62, 0x39, 0xad, 0x20, 0x30, 0x28, 0x70, 0xa6, 0x1, 0x39, 0x34, 0xa7, 0x4, 0x85, 0x2f, 0x22, 0x40, 0x17, 0xeb, 0xb8, 0xd6, 0x81, 0xdc, 0xf8, 0xbe, 0xf8, 0xa3, 0x6b, 0x3f, 0xec, 0x1b, 0xa2, 0x94, 0xc0, 0x22, 0x4c, 0x44, 0xc, 0x4b, 0x84, 0xae, 0x35, 0x7e, 0x11, 0x28, 0x73, 0x9, 0x5e, 0x9c, 0x26, 0x37, 0xe, 0x42, 0x76, 0xb5, 0x88, 0xc0, 0x6d, 0x98, 0xa1, 0x39, 0xf, 0xe4, 0x24, 0x6c, 0x9a, 0x1b, 0x12, 0xd3, 0x1b, 0x9a, 0xcf, 0x82, 0x10, 0x27, 0x72, 0x6e, 0x84, 0xd3, 0xe, 0x7c, 0x94, 0x3f, 0xb3, 0xb2, 0x9e, 0xce, 0xc, 0x59, 0x7c, 0x42, 0xf2, 0xdc, 0xa0, 0xb5, 0xe3, 0xdc, 0x1, 0xa3, 0xe3, 0x9a, 0xb7, 0xac, 0x4d, 0xd7, 0xe2, 0xd2, 0x15, 0x8c, 0x50, 0xea, 0xbb, 0xc3, 0xb4, 0x78, 0x71, 0x49, 0x31, 0x68, 0x1d, 0x7c, 0x8d, 0x34, 0xa0, 0x32, 0x4e, 0xed, 0x90, 0x82, 0xb9, 0x56, 0xe0, 0x55, 0x6d, 0x8, 0x20, 0x7e, 0xea, 0x69, 0xec, 0x86, 0x46, 0xe2, 0x11, 0x57, 0x3d, 0xb2, 0xea, 0x94, 0x60, 0x5c, 0x71, 0xbc, 0x22, 0x2, 0x4f, 0x4e, 0x28, 0xe, 0xeb, 0x12, 0x9e, 0xe2, 0x58, 0x42, 0x81, 0xc4, 0xd8, 0x30, 0x5, 0x15, 0xed, 0x77, 0xa8, 0x54, 0xd7, 0x52, 0xd3, 0xf5, 0x8c, 0x50, 0x42, 0xf5, 0x87, 0x2a, 0x2e, 0x29, 0xd, 0x4f, 0x7f, 0x5e, 0x23, 0x14, 0xa0, 0x46, 0x53, 0xe1, 0xe7, 0xb6, 0x45, 0x33, 0xd8, 0x94, 0xe5, 0x9a, 0x4f, 0x83, 0x42, 0x7f, 0xee, 0xc2, 0x3d, 0xf6, 0x5d, 0x23, 0x36, 0x95, 0xc1, 0x1, 0x3d, 0x2b, 0x19, 0x92, 0x36, 0xe3, 0x13, 0xe9, 0x79, 0x95, 0x5, 0x5c, 0xfc, 0xc6, 0x3c, 0xd2, 0xba, 0xfc, 0x9a, 0x8f, 0x17, 0xd8, 0xaa, 0x85, 0x58, 0xa9, 0x80, 0xab, 0x16, 0xfe, 0xac, 0x63, 0x11, 0x4, 0xc0, 0x5d, 0xa8, 0x61, 0xc2, 0xa0, 0xfc, 0xcc, 0x7e, 0x37, 0x2a, 0x4c, 0xa6, 0xd6, 0xc4, 0x7, 0x82, 0x4d, 0x75, 0x57, 0x61, 0x6c, 0x8b, 0xc3, 0x95, 0xc1, 0xd8, 0xc2, 0x38, 0xa1, 0x9, 0x88, 0x97, 0x8e, 0x5b, 0x25, 0x21, 0x60, 0x75, 0x82, 0xa2, 0x7, 0x86, 0x65, 0x68, 0xb2, 0x19, 0xd7, 0xb8, 0x50, 0x55, 0xb6, 0x1a, 0x86, 0x38, 0x30, 0x1e, 0x44, 0x52, 0x8e, 0xc2, 0x3c, 0x80, 0x70, 0xa4, 0x58, 0x1a, 0x56, 0x46, 0x30, 0x70, 0xc6, 0x60, 0x7a, 0x6c, 0x8a, 0xa0, 0xc0, 0x21, 0x49, 0x8, 0x70, 0x32, 0x5e, 0xfc, 0xd8, 0xdf, 0x90, 0x41, 0x77, 0xe2, 0xe, 0x17, 0x31, 0xf4, 0xa4, 0xfd, 0x3b, 0xaf, 0x17, 0x45, 0xf8, 0xc1, 0x96, 0x56, 0x4c, 0x20, 0x60, 0x27, 0x17, 0x9c, 0x9f, 0xb1, 0x2e, 0x74, 0xd8, 0x5f, 0x52, 0x8f, 0x5e, 0xe8, 0xb3, 0x41, 0x64, 0xe1, 0x46, 0xef, 0xa4, 0x78, 0xd5, 0xb6, 0xba, 0xaf, 0x4f, 0x41, 0xb2, 0xd3, 0xd6, 0x16, 0x1a, 0xea, 0x93, 0x81, 0xf9, 0xfa, 0x64, 0x0, 0x40, 0x9f, 0xdc, 0x34, 0xac, 0xc, 0x54, 0x9f, 0x7c, 0x18, 0xa2, 0x4f, 0x1a, 0x25, 0xd0, 0x27, 0x7, 0x90, 0xd4, 0x27, 0xc3, 0xe0, 0xbf, 0x88, 0x3e, 0xa1, 0xfc, 0x24, 0xf5, 0xc9, 0xe4, 0xba, 0x5d, 0x9f, 0xf4, 0x81, 0x11, 0x4e, 0xa6, 0x3c, 0x9d, 0xe, 0x27, 0x5f, 0x53, 0xbc, 0x44, 0xa7, 0xd, 0x35, 0x2c, 0xd4, 0x12, 0x5, 0xf1, 0x75, 0x44, 0x25, 0x3, 0xd, 0x81, 0x29, 0x21, 0x6d, 0x54, 0x3b, 0x5c, 0x8, 0xa2, 0x1b, 0x12, 0x21, 0xd0, 0xc, 0x90, 0x4c, 0x2b, 0x14, 0xd1, 0x99, 0x30, 0xdd, 0x51, 0xac, 0xff, 0x8b, 0x68, 0xe, 0xc2, 0x4d, 0x52, 0x6f, 0x54, 0x9e, 0xdb, 0xb5, 0x46, 0x9f, 0x1d, 0x71, 0x86, 0x4, 0x42, 0x98, 0xff, 0x4d, 0xc8, 0x4f, 0x9c, 0xbf, 0x9f, 0xfb, 0xc3, 0xc, 0x99, 0x47, 0x3f, 0xef, 0x11, 0xcb, 0xcb, 0x26, 0x46, 0x56, 0x99, 0x2e, 0xe4, 0x7a, 0xcf, 0xc, 0x5d, 0xee, 0x1, 0x71, 0x40, 0x23, 0x81, 0x79, 0x44, 0xe1, 0x4a, 0x31, 0xe0, 0x92, 0x14, 0xb1, 0x27, 0xd7, 0x61, 0xd9, 0xe2, 0x8a, 0xd0, 0xf4, 0x77, 0x64, 0x1c, 0xaa, 0xe0, 0xfd, 0x92, 0x5b, 0x9, 0xea, 0x91, 0x21, 0x46, 0xd7, 0xcb, 0x6, 0xda, 0xdb, 0x47, 0x17, 0xdb, 0xb0, 0x9d, 0xca, 0x6, 0x44, 0xbc, 0x1, 0x6f, 0x4, 0x2f, 0xd0, 0xb4, 0xae, 0xc8, 0xcb, 0x76, 0x7f, 0xb1, 0xc2, 0xa1, 0x59, 0x79, 0x76, 0x85, 0xc, 0xaf, 0xc3, 0x3a, 0x59, 0x1c, 0x93, 0x75, 0xb9, 0xa7, 0x31, 0xad, 0x95, 0x74, 0x92, 0xe5, 0xe2, 0x59, 0x4c, 0x65, 0xb0, 0x80, 0xe8, 0xb7, 0x15, 0xa9, 0xcd, 0x56, 0x58, 0xb0, 0x72, 0x74, 0xee, 0x12, 0x3, 0x45, 0x5, 0x5f, 0x75, 0x44, 0x88, 0x46, 0x96, 0x18, 0x6d, 0xbc, 0x47, 0xe7, 0x2e, 0x99, 0x4b, 0x85, 0x9e, 0x38, 0xf8, 0x7d, 0x5c, 0x65, 0x4, 0xd1, 0xd3, 0x7d, 0x39, 0x63, 0x20, 0xe3, 0x37, 0x2, 0xc, 0xe5, 0x68, 0xf0, 0xf4, 0xd8, 0xf2, 0x9f, 0x69, 0x17, 0x6f, 0xb1, 0xe8, 0x36, 0x6, 0xd5, 0x4a, 0x2a, 0x98, 0xaf, 0x67, 0x28, 0x89, 0x70, 0xfd, 0x3b, 0x1e, 0x5a, 0x35, 0x61, 0xc3, 0x1c, 0xee, 0x1c, 0x45, 0xf, 0xa2, 0xdc, 0xa7, 0xaa, 0x8b, 0x30, 0xdb, 0xa5, 0x35, 0x3b, 0x45, 0xb1, 0x8d, 0x88, 0x41, 0xcc, 0x7b, 0x5d, 0xd6, 0x21, 0x67, 0xfc, 0x25, 0x97, 0xeb, 0x9d, 0x94, 0xf9, 0x8a, 0xc, 0x4d, 0x79, 0x2e, 0xea, 0xcc, 0xad, 0x4d, 0x27, 0xab, 0x1f, 0x4e, 0x35, 0xf1, 0xe5, 0x6b, 0xf1, 0x96, 0xf3, 0xe1, 0xbc, 0xda, 0xe, 0xa, 0xf1, 0x86, 0x72, 0xbe, 0x2b, 0xf6, 0xd5, 0xf1, 0x5c, 0x8b, 0x77, 0xe1, 0x16, 0x34, 0xc4, 0x5d, 0xe6, 0xbe, 0x67, 0x17, 0x3d, 0x3c, 0x22, 0x77, 0xef, 0x36, 0x3f, 0xb5, 0x1f, 0x7f, 0x6e, 0xf8, 0x2b, 0xa4, 0x62, 0x45, 0x44, 0xf2, 0x23, 0x36, 0x88, 0x91, 0xd4, 0x26, 0x4c, 0xf4, 0x13, 0x84, 0xe8, 0xd5, 0xdd, 0x93, 0xa1, 0x3c, 0x8a, 0x1, 0x52, 0x72, 0x90, 0x62, 0x3f, 0xf3, 0x0, 0x3d, 0xf, 0xd0, 0xbf, 0xdb, 0xf1, 0xd, 0x9f, 0x17, 0xf0, 0xe9, 0x3c, 0x3, 0xc3, 0xcf, 0x40, 0xa0, 0x2f, 0x8, 0x82, 0xea, 0x41, 0xde, 0xed, 0x53, 0xd4, 0x44, 0xa3, 0x47, 0xc6, 0x94, 0x13, 0xd6, 0xae, 0x33, 0x6f, 0x9c, 0x38, 0x22, 0x42, 0x95, 0x53, 0xb8, 0x92, 0x2f, 0xbb, 0x73, 0xc1, 0x7e, 0x25, 0x76, 0xbb, 0x79, 0x9f, 0x9, 0x57, 0xe0, 0xb1, 0xa5, 0x17, 0xb3, 0x9d, 0x3e, 0x9c, 0xcf, 0x16, 0x9b, 0xaa, 0x16, 0x21, 0xef, 0xeb, 0xe3, 0xb6, 0xf8, 0x49, 0x1, 0x7e, 0x9e, 0x83, 0xe3, 0x18, 0xa9, 0xe0, 0xe7, 0xbc, 0xe0, 0x81, 0x7a, 0x5, 0x39, 0xfe, 0xb4, 0x8e, 0xfb, 0xf2, 0x41, 0x78, 0xb9, 0x19, 0x52, 0x82, 0x4d, 0x62, 0xd2, 0x6c, 0xe3, 0xea, 0xa4, 0x1c, 0x41, 0xcb, 0x11, 0x34, 0x75, 0xa8, 0xf9, 0x70, 0x2c, 0xf7, 0xcf, 0xe2, 0x41, 0x53, 0xc6, 0x3e, 0xf7, 0x38, 0x2f, 0x2f, 0x75, 0xd9, 0xbd, 0x2, 0x93, 0xa7, 0xe9, 0x74, 0x5a, 0xde, 0x5f, 0x1, 0xc3, 0x6d, 0x9a, 0xf, 0x54, 0xe9, 0xdc, 0x2, 0x1c, 0xe5, 0x8, 0x52, 0x51, 0x1, 0x1a, 0x60, 0x28, 0x22, 0x3, 0xcb, 0x63, 0x19, 0xf3, 0x58, 0x46, 0x25, 0x64, 0x0, 0x83, 0x87, 0x42, 0xd0, 0x64, 0x8c, 0x4b, 0x0, 0xd, 0x4b, 0xb3, 0xc0, 0x3c, 0x9a, 0x35, 0x8f, 0x66, 0x95, 0x9c, 0x12, 0xbd, 0x48, 0xe3, 0xa7, 0xe0, 0x9a, 0xf7, 0x14, 0x9a, 0xe4, 0x24, 0x81, 0x95, 0x77, 0x23, 0x96, 0x77, 0x23, 0x46, 0x5e, 0xfd, 0xb9, 0xa1, 0x7, 0x32, 0x8a, 0xc5, 0xfa, 0xa5, 0xbc, 0x78, 0x59, 0xb1, 0xd3, 0x65, 0x32, 0xdf, 0xd, 0xcf, 0x6b, 0x25, 0x38, 0x50, 0x94, 0x1c, 0xe5, 0xd0, 0x69, 0xa0, 0x5d, 0xf5, 0xf3, 0x5c, 0x8, 0x5a, 0x8e, 0xa0, 0x25, 0x6d, 0x40, 0xa7, 0xa, 0xc8, 0x37, 0xbf, 0xee, 0xaf, 0x40, 0x7, 0x1b, 0xa0, 0xf9, 0x88, 0xd8, 0x0, 0x5d, 0x80, 0x6b, 0x3, 0xfc, 0x54, 0x54, 0x80, 0x98, 0xd, 0xf0, 0x61, 0x79, 0x2c, 0x63, 0x1e, 0xcb, 0x8, 0x6c, 0x80, 0x82, 0xf9, 0x36, 0x20, 0x48, 0xc6, 0xb8, 0xc4, 0x6d, 0x40, 0x0, 0xcc, 0xa3, 0x59, 0xf3, 0x68, 0xd6, 0xb8, 0xd, 0x50, 0xf8, 0x29, 0x78, 0xca, 0x6, 0xb8, 0x5a, 0x9b, 0xc0, 0xca, 0xbb, 0x11, 0xcb, 0xbb, 0x11, 0x23, 0x6f, 0xe8, 0xdc, 0xd0, 0x3, 0x3d, 0x1b, 0xa0, 0xb3, 0xd2, 0x36, 0x40, 0xdf, 0xa9, 0x8d, 0x76, 0x21, 0xb9, 0x84, 0x9e, 0xe0, 0x40, 0x6f, 0x4b, 0xc0, 0x16, 0xd6, 0x69, 0xa0, 0x5d, 0xf5, 0x85, 0x57, 0x4, 0x2d, 0x47, 0xd0, 0x92, 0x36, 0xa0, 0x53, 0x5, 0xe4, 0x33, 0x7d, 0xf7, 0x57, 0xa0, 0x83, 0xd, 0x40, 0x2e, 0x27, 0xfb, 0x36, 0x40, 0x17, 0xe0, 0xda, 0x0, 0x3f, 0x15, 0x15, 0x20, 0x66, 0x3, 0x7c, 0x58, 0x1e, 0xcb, 0x98, 0xc7, 0x32, 0x2, 0x1b, 0xa0, 0x60, 0xbe, 0xd, 0x8, 0x92, 0x31, 0x2e, 0x71, 0x1b, 0x10, 0x0, 0xf3, 0x68, 0xd6, 0x3c, 0x9a, 0x35, 0x6e, 0x3, 0xf4, 0xa5, 0xec, 0x4, 0x3c, 0x65, 0x3, 0x5c, 0xad, 0x4d, 0x60, 0xe5, 0xdd, 0x88, 0xe5, 0xdd, 0x88, 0x51, 0x36, 0xe0, 0x96, 0x1e, 0xe8, 0xd9, 0x0, 0x9d, 0x95, 0xb6, 0x1, 0xe2, 0x6, 0x75, 0xdc, 0x0, 0x88, 0xcb, 0xd4, 0x89, 0xe2, 0x39, 0x19, 0x47, 0x2d, 0x44, 0x2, 0x68, 0x4e, 0x71, 0xc9, 0xd9, 0x47, 0xc8, 0x7d, 0x84, 0x64, 0x8f, 0x4f, 0xb3, 0x2b, 0x9f, 0xd2, 0xbc, 0x87, 0xdd, 0xe, 0x1d, 0xdd, 0xbf, 0x6f, 0xee, 0xf7, 0x72, 0x41, 0xd7, 0xed, 0xe2, 0x4e, 0x52, 0x28, 0x22, 0xac, 0x73, 0x3b, 0x80, 0x9c, 0xcc, 0x92, 0x93, 0x59, 0x40, 0x9f, 0xe6, 0x0, 0xbf, 0x43, 0xbb, 0x69, 0x1, 0x4f, 0x78, 0x57, 0x76, 0x21, 0x39, 0x9d, 0x29, 0xa7, 0x33, 0xc5, 0x7b, 0xb0, 0xb8, 0x49, 0x1f, 0x3, 0xa6, 0xfa, 0x2e, 0xd0, 0xb9, 0x18, 0x4a, 0xde, 0x81, 0x4c, 0xde, 0x81, 0xc, 0xd9, 0x5f, 0xbb, 0x76, 0x18, 0xbf, 0xb3, 0xaa, 0x7c, 0x74, 0x67, 0xd5, 0x37, 0xd9, 0xa3, 0x1d, 0x40, 0x3d, 0x95, 0x1c, 0x2f, 0x5e, 0xef, 0xfb, 0xc2, 0x66, 0xd4, 0x69, 0xa0, 0xfd, 0xf4, 0x35, 0x73, 0x4, 0x2d, 0x47, 0xd0, 0x92, 0xdd, 0xb7, 0x53, 0x5, 0xe4, 0xdb, 0xb5, 0xf7, 0x57, 0xa0, 0x43, 0x3f, 0x46, 0x42, 0x2, 0xf8, 0x5d, 0x59, 0x17, 0xe0, 0xf6, 0x66, 0x3f, 0x15, 0x15, 0x20, 0xd6, 0xa7, 0x7d, 0x58, 0x1e, 0xcb, 0x98, 0xc7, 0x32, 0x82, 0xce, 0xad, 0x60, 0x7e, 0xff, 0xe, 0x92, 0x31, 0x2e, 0xf1, 0x5e, 0x1e, 0x0, 0xf3, 0x68, 0xd6, 0x3c, 0x9a, 0x35, 0xde, 0xdd, 0x75, 0x28, 0x84, 0x4, 0x3c, 0xd5, 0xe9, 0x5d, 0xad, 0x4d, 0x60, 0xe5, 0xdd, 0x88, 0xe5, 0xdd, 0x88, 0x51, 0x6, 0xe0, 0x96, 0x1e, 0xe8, 0xd9, 0x0, 0x9d, 0x95, 0xb6, 0x1, 0x2a, 0x42, 0x41, 0x7c, 0xde, 0x2e, 0x36, 0x9c, 0x53, 0x2b, 0x7, 0x82, 0x90, 0xbb, 0xa6, 0x23, 0x93, 0xe0, 0x6a, 0x8c, 0xc, 0x20, 0x10, 0x22, 0xe5, 0x21, 0x52, 0x7a, 0xd9, 0xae, 0x3, 0xeb, 0xf2, 0xa5, 0xe9, 0x7b, 0x59, 0xef, 0xb2, 0x66, 0x17, 0x44, 0x78, 0x8, 0x96, 0xec, 0x24, 0x75, 0x6f, 0xc5, 0xce, 0x4d, 0xc4, 0xc4, 0x86, 0xae, 0xd7, 0xb9, 0xa0, 0x3c, 0x92, 0x2d, 0x8f, 0x64, 0x83, 0x8b, 0x75, 0x2, 0x14, 0xac, 0xd5, 0x79, 0xa9, 0x8, 0x7f, 0xc4, 0x4a, 0x9d, 0x7, 0xcb, 0x63, 0x19, 0xf3, 0x58, 0xc6, 0xc4, 0x32, 0x9d, 0x8c, 0x67, 0x11, 0x7, 0x27, 0x17, 0xe9, 0xa0, 0x7e, 0xc6, 0x91, 0xf2, 0x4e, 0xa4, 0xf2, 0x4e, 0xa4, 0xc8, 0xc9, 0x79, 0xf7, 0x6e, 0xe6, 0xcf, 0xcd, 0x55, 0x4e, 0xba, 0x9b, 0xd7, 0xd5, 0xfe, 0x57, 0x6f, 0x26, 0xef, 0xdf, 0xea, 0x8, 0x1e, 0xe6, 0xd4, 0xf9, 0xfa, 0xe6, 0xcb, 0x51, 0x3, 0x9e, 0x90, 0xfb, 0x9, 0xe9, 0x7d, 0xa, 0xc9, 0x4a, 0xf4, 0x89, 0xd0, 0x9b, 0x76, 0x1f, 0x5c, 0xe, 0x3, 0x86, 0xa0, 0x8e, 0x89, 0xdf, 0x4a, 0xfa, 0x51, 0x21, 0x47, 0x32, 0xba, 0x32, 0xf4, 0x77, 0x95, 0x58, 0x7d, 0xca, 0x13, 0xdf, 0x3a, 0x8a, 0xbe, 0x81, 0x7a, 0x45, 0xc4, 0xe5, 0x17, 0xd7, 0xb9, 0x27, 0x0, 0x5e, 0xa3, 0x28, 0xe, 0xfb, 0x30, 0x30, 0x2c, 0xb6, 0x29, 0x66, 0x36, 0x82, 0x9f, 0xf9, 0x2f, 0xc5, 0xd5, 0xcb, 0xe5, 0x8d, 0x4e, 0x80, 0x83, 0x12, 0x9a, 0x1d, 0x28, 0xc1, 0xde, 0xcf, 0xb8, 0xfb, 0x72, 0x2, 0x20, 0xfd, 0xb5, 0x1, 0xa4, 0xbf, 0x36, 0x96, 0x79, 0xb9, 0xeb, 0x76, 0x17, 0x65, 0xec, 0x0, 0x14, 0x3c, 0xe6, 0x62, 0x70, 0x1e, 0x0, 0xba, 0x7b, 0x42, 0xa, 0xde, 0x2b, 0x5d, 0x9e, 0xdb, 0xf6, 0xb0, 0xff, 0x64, 0x71, 0x9d, 0x2b, 0x36, 0x25, 0x6b, 0x4a, 0x2, 0xd6, 0x9c, 0x97, 0xbb, 0xa, 0x2, 0xdd, 0xc3, 0x36, 0xc5, 0xba, 0xbc, 0xe8, 0x7d, 0xbe, 0xc, 0xbb, 0x5b, 0xad, 0x80, 0xe2, 0x66, 0x72, 0x8f, 0xd7, 0xbc, 0x38, 0x79, 0xb7, 0xa5, 0x31, 0x8c, 0x38, 0x58, 0x96, 0x3b, 0xac, 0xf6, 0x17, 0x70, 0x63, 0x77, 0xc5, 0x9f, 0xf5, 0x3d, 0x36, 0xf6, 0x89, 0x64, 0xa9, 0x62, 0x3a, 0x99, 0x63, 0xbb, 0x31, 0x8, 0xda, 0x13, 0xa, 0x54, 0x31, 0x2b, 0xe, 0x5f, 0xae, 0x22, 0x1c, 0x46, 0x1c, 0x47, 0x2a, 0x80, 0x29, 0x85, 0x8f, 0xcc, 0xc3, 0x33, 0x33, 0xaa, 0xa9, 0x33, 0x13, 0x25, 0xc8, 0xc4, 0x8, 0xa, 0xc4, 0x35, 0x38, 0x32, 0xc7, 0x5f, 0x9e, 0x58, 0x8d, 0x64, 0xa6, 0xfe, 0xe7, 0xaa, 0xa9, 0x96, 0x55, 0xcd, 0xea, 0xe8, 0x4a, 0x2d, 0x86, 0xd8, 0x91, 0x5c, 0x58, 0xf8, 0xfa, 0xac, 0x7a, 0xe7, 0x70, 0xe2, 0xdf, 0x69, 0xf7, 0x60, 0x74, 0xa6, 0x90, 0x6a, 0x5b, 0xed, 0xf8, 0x2e, 0xfb, 0xe6, 0xbc, 0x97, 0x27, 0x1f, 0xf8, 0x7d, 0x75, 0x8f, 0x38, 0x8a, 0x92, 0x80, 0x33, 0xa1, 0x33, 0x13, 0xd7, 0xc6, 0xe, 0xd8, 0x65, 0x56, 0xf4, 0x4e, 0xdc, 0x6d, 0xd6, 0x7, 0xf1, 0xf3, 0x1b, 0x20, 0x88, 0x30, 0x8f, 0x6d, 0xb1, 0x2e, 0x9a, 0x6d, 0xb9, 0x5e, 0x38, 0x1, 0x58, 0xa6, 0xb1, 0x20, 0x6, 0x32, 0x54, 0x38, 0x86, 0x71, 0x35, 0x43, 0xba, 0xbe, 0xf8, 0x3a, 0x1f, 0xb1, 0xab, 0x17, 0xde, 0xb0, 0xcf, 0x3b, 0xce, 0x90, 0x1, 0x84, 0x5d, 0xb9, 0x3f, 0x13, 0x37, 0x2c, 0x44, 0xbc, 0x7, 0x75, 0xeb, 0x4c, 0xdf, 0xb1, 0x60, 0x69, 0xd9, 0x2, 0x76, 0x8c, 0x85, 0x7d, 0x57, 0x2, 0xc4, 0x4d, 0x19, 0xcd, 0x33, 0xef, 0xa2, 0x12, 0xf, 0xee, 0xd1, 0xd8, 0xc7, 0xe4, 0xf7, 0xa5, 0x7f, 0x8a, 0xc4, 0xb, 0xef, 0x9d, 0xdc, 0x8f, 0xf, 0xe3, 0x3c, 0x80, 0xc, 0x75, 0x75, 0xcc, 0xed, 0x35, 0xbd, 0xaf, 0x8b, 0x8, 0xcc, 0x93, 0xc5, 0x50, 0x3c, 0x31, 0x20, 0x9a, 0xe8, 0xa2, 0x2f, 0x98, 0x80, 0x48, 0xf7, 0xe, 0x6e, 0x8f, 0xd, 0x4f, 0x3f, 0x57, 0x3c, 0xca, 0x0, 0x78, 0xb9, 0x58, 0x85, 0x34, 0x79, 0x1a, 0xca, 0x5a, 0xfb, 0x5d, 0x95, 0x8e, 0x19, 0xed, 0x90, 0x7e, 0xae, 0xab, 0xe7, 0x82, 0x78, 0xa4, 0x9d, 0x9f, 0xc1, 0x10, 0x57, 0x61, 0x57, 0x35, 0xb3, 0x61, 0x3c, 0xd6, 0xf7, 0x36, 0x11, 0x6a, 0x43, 0x9d, 0xcb, 0xc5, 0xc2, 0x5f, 0x85, 0xa5, 0x6a, 0xb7, 0x8e, 0x40, 0xa4, 0x43, 0xc6, 0x5c, 0xf0, 0x22, 0x75, 0x2, 0x58, 0x47, 0xb5, 0x75, 0xa9, 0xea, 0xe0, 0xb9, 0x45, 0x9f, 0x2, 0xe0, 0xdc, 0x58, 0x70, 0xa7, 0x53, 0x33, 0xb, 0xf4, 0x74, 0x8c, 0x33, 0x2e, 0xa, 0x38, 0xd3, 0x3, 0x12, 0x84, 0x37, 0xb, 0x22, 0xb8, 0x3, 0x8, 0xe, 0x7f, 0x78, 0x53, 0xdf, 0x41, 0xf, 0xad, 0x64, 0xfc, 0xd, 0x7b, 0xf4, 0x54, 0x90, 0x3a, 0x4d, 0xc3, 0xac, 0xfb, 0x4b, 0xb5, 0xce, 0xff, 0xc7, 0xff, 0xf9, 0x9f, 0x1c, 0xf4, 0xbf, 0x79, 0x36, 0x7e, 0x2, 0x6e, 0xf8, 0x97, 0x6a, 0x75, 0x3a, 0x34, 0x87, 0x4d, 0x3b, 0x7c, 0xe1, 0xdd, 0x8d, 0xd1, 0xf9, 0xa9, 0xdc, 0xb, 0x4e, 0x7e, 0xde, 0x14, 0x75, 0x53, 0xbe, 0x5f, 0x60, 0x77, 0x68, 0xbd, 0x99, 0xa7, 0xb0, 0x30, 0xae, 0xc7, 0x94, 0x28, 0x5, 0x69, 0x90, 0x54, 0xff, 0x33, 0xfd, 0x6e, 0x61, 0x2e, 0xbb, 0xba, 0x68, 0x1c, 0xe1, 0xa2, 0x2c, 0x14, 0x7c, 0x13, 0xc4, 0x60, 0xf1, 0x40, 0x58, 0x4c, 0x5c, 0x89, 0x7e, 0xd4, 0x29, 0x4e, 0x4d, 0xb4, 0xf3, 0x70, 0xe9, 0xf2, 0x1f, 0xd6, 0x92, 0x6e, 0xaa, 0xaf, 0xcc, 0xe2, 0x3b, 0xbc, 0xf1, 0xf9, 0x8a, 0x3e, 0x7, 0x28, 0xce, 0x8e, 0x6a, 0xa3, 0xfa, 0xf4, 0xc4, 0x6a, 0x66, 0xed, 0x8e, 0x2f, 0x3b, 0xc2, 0xc, 0xf1, 0x23, 0xcf, 0xc2, 0x73, 0xf5, 0x87, 0xfb, 0xe2, 0xf3, 0xb2, 0x38, 0xd, 0x44, 0x99, 0xea, 0xb0, 0x61, 0xcf, 0x10, 0x51, 0x58, 0x4e, 0xe0, 0x7b, 0x2f, 0xba, 0x94, 0xf1, 0x34, 0xb, 0x7e, 0xd2, 0x91, 0x35, 0x73, 0xfe, 0xee, 0x9d, 0x2d, 0xc4, 0xe1, 0x26, 0x59, 0x98, 0xcb, 0x3b, 0x2f, 0x4d, 0xb4, 0xa0, 0x39, 0x5d, 0x1f, 0x3e, 0xcc, 0x10, 0x3d, 0xf4, 0xa9, 0x4a, 0x13, 0x32, 0xf0, 0x89, 0x23, 0xfa, 0x11, 0x41, 0xa7, 0xb4, 0x5, 0xc, 0xc0, 0xfb, 0x60, 0x2c, 0xae, 0x1d, 0x7b, 0xd7, 0x48, 0x5, 0xc4, 0x81, 0xec, 0x90, 0x20, 0x18, 0xe2, 0xab, 0x23, 0xe8, 0xfc, 0x28, 0x5c, 0x58, 0xa, 0x7c, 0xb0, 0x89, 0xa0, 0xe2, 0x4c, 0x6e, 0x11, 0x78, 0x9e, 0x82, 0x83, 0x19, 0x1c, 0x6, 0x6, 0x8b, 0x2e, 0x96, 0xd5, 0xb0, 0x50, 0xa2, 0x2c, 0xbc, 0x8, 0x40, 0xf9, 0x62, 0x6e, 0x6e, 0x82, 0x1a, 0x8a, 0xf9, 0xdf, 0x83, 0x27, 0x23, 0x9b, 0x18, 0x34, 0x54, 0xcf, 0x7e, 0xa2, 0xb9, 0x0, 0x8, 0x3d, 0x32, 0xad, 0xe, 0x65, 0xb2, 0x7e, 0x71, 0xe0, 0x31, 0x34, 0x5d, 0xe8, 0xcc, 0x83, 0xf6, 0x7c, 0x16, 0x4c, 0x3a, 0xbc, 0x23, 0xe1, 0xb7, 0x9c, 0x42, 0x2, 0xd, 0xf, 0x53, 0x10, 0x72, 0xcf, 0xe, 0x39, 0xe7, 0x7d, 0x19, 0xcd, 0x10, 0x90, 0x25, 0x33, 0xbe, 0x3f, 0xc1, 0x60, 0x8a, 0xef, 0x65, 0x8a, 0x8d, 0x84, 0x27, 0x13, 0xfc, 0x41, 0xe1, 0xfb, 0xb, 0x3d, 0x13, 0x55, 0x4d, 0x7, 0x2, 0x34, 0x7a, 0xe7, 0xf5, 0x69, 0xcc, 0x1b, 0xb, 0x57, 0xf, 0x2c, 0x88, 0xfe, 0x68, 0xc7, 0x74, 0xd6, 0x56, 0x79, 0x90, 0xa0, 0x64, 0x5b, 0x50, 0x28, 0x7, 0x47, 0xeb, 0xfc, 0x21, 0x71, 0x80, 0xed, 0x71, 0xc4, 0x6b, 0x8a, 0x32, 0xe4, 0x0, 0x7c, 0x7e, 0x8, 0xd, 0xf0, 0x11, 0x3a, 0xb4, 0x99, 0x34, 0xb, 0x89, 0x26, 0x52, 0xd4, 0x62, 0xe2, 0xf7, 0xc5, 0xd4, 0xbf, 0x87, 0x84, 0x27, 0xbc, 0x37, 0x6a, 0x3c, 0x55, 0x74, 0xac, 0x9, 0x43, 0x45, 0x7c, 0x65, 0x2b, 0xf5, 0x2, 0x45, 0x8, 0xec, 0x96, 0x18, 0x9d, 0x4, 0x78, 0x70, 0xb0, 0xe2, 0x56, 0xe3, 0x21, 0x40, 0x75, 0xee, 0xd3, 0x7c, 0x4, 0x21, 0x43, 0xd4, 0xcb, 0x66, 0x61, 0x27, 0x16, 0xf7, 0xca, 0xa3, 0x64, 0x46, 0xe3, 0x80, 0xce, 0x68, 0xec, 0x10, 0xc2, 0xf9, 0xb6, 0xb, 0x98, 0xb7, 0xac, 0x51, 0xea, 0x41, 0x3, 0xd2, 0xed, 0xc5, 0x55, 0xb, 0x38, 0xa2, 0x50, 0x17, 0xdf, 0xd5, 0xc9, 0xf0, 0xcc, 0xe, 0x1c, 0x22, 0xd8, 0x59, 0x4f, 0xe1, 0x77, 0xf1, 0x90, 0x2e, 0x80, 0x76, 0xd5, 0xcf, 0xbe, 0x53, 0x75, 0xc7, 0x7d, 0xe0, 0x1, 0x13, 0xf2, 0xd1, 0xa8, 0x6b, 0x17, 0xb2, 0x96, 0x10, 0x89, 0xfe, 0x10, 0xad, 0xc2, 0x43, 0xe7, 0x7a, 0x3c, 0x74, 0x10, 0x5, 0xe2, 0xdb, 0x44, 0x14, 0x26, 0x3b, 0x1b, 0xd, 0xcd, 0xb6, 0xe7, 0xe8, 0xd3, 0xe6, 0x28, 0x62, 0x89, 0xfc, 0x31, 0x45, 0xc4, 0x92, 0x5c, 0x48, 0xdb, 0xb0, 0xe8, 0x62, 0x52, 0xb0, 0x4e, 0x4f, 0x33, 0x12, 0xb3, 0x2b, 0x5d, 0xcd, 0x8, 0x6d, 0xda, 0xba, 0x31, 0xf1, 0x66, 0xe6, 0x1e, 0x25, 0x7b, 0xa7, 0xdd, 0xbf, 0x83, 0xd6, 0x3d, 0xe, 0xe0, 0xa6, 0xd6, 0x7a, 0x8d, 0x2f, 0xb8, 0xb3, 0xa1, 0xfe, 0x7e, 0x6e, 0xda, 0x6a, 0x53, 0x95, 0x6b, 0x77, 0x39, 0x16, 0x1a, 0x7, 0xb9, 0x3e, 0xcb, 0x40, 0xcc, 0xf8, 0xab, 0x29, 0x9d, 0xdd, 0x86, 0x11, 0xab, 0xb9, 0x79, 0x53, 0xb2, 0x19, 0x76, 0xd1, 0x96, 0x28, 0xe5, 0xc0, 0x92, 0xb9, 0x10, 0x67, 0xb4, 0x40, 0xbc, 0xac, 0xa4, 0xd9, 0xf9, 0xf1, 0x9a, 0x20, 0x23, 0xaf, 0xd4, 0xe0, 0xa6, 0xc, 0xc7, 0x27, 0x66, 0x53, 0xd7, 0x5f, 0xd6, 0x45, 0x5b, 0xa8, 0x96, 0x56, 0xb, 0xfe, 0xcd, 0x27, 0x91, 0x13, 0xbf, 0x3, 0xda, 0xd, 0x5f, 0x45, 0xfa, 0xa2, 0x91, 0x81, 0x89, 0xbd, 0xb5, 0x1c, 0x22, 0x2b, 0x19, 0xe0, 0x4e, 0x2c, 0x2, 0x9e, 0xca, 0x55, 0xab, 0xee, 0x30, 0x65, 0xef, 0x63, 0x31, 0x5f, 0x64, 0x2b, 0xd1, 0xf3, 0x40, 0xa9, 0x36, 0xb4, 0x62, 0x0, 0x2a, 0xee, 0x13, 0x5b, 0xa0, 0xe1, 0xbb, 0x45, 0xf9, 0x42, 0xae, 0x4f, 0x23, 0x7c, 0xd9, 0x80, 0x38, 0x60, 0x71, 0x96, 0xc, 0x8, 0x9d, 0xf9, 0x31, 0x26, 0x9f, 0xbd, 0xeb, 0xd9, 0x3e, 0x14, 0xb9, 0x94, 0x1d, 0x43, 0x61, 0x6d, 0x22, 0x8d, 0xdb, 0xf7, 0x8e, 0x36, 0x45, 0xf0, 0x4f, 0xe0, 0x84, 0xb5, 0xe8, 0x80, 0x88, 0xd6, 0xa5, 0x6b, 0x58, 0xab, 0x28, 0x7f, 0x11, 0x6c, 0x8a, 0xd3, 0x8e, 0x59, 0x34, 0xcf, 0x7e, 0x4c, 0x2d, 0x82, 0x1d, 0x12, 0x2b, 0x64, 0xa3, 0x13, 0xaa, 0x2f, 0x32, 0xb9, 0x80, 0xe5, 0xc6, 0x5e, 0x8d, 0x69, 0x1c, 0x87, 0x26, 0x34, 0xce, 0x47, 0xf1, 0x8b, 0x7c, 0xfb, 0x88, 0x78, 0x4, 0xe3, 0x4, 0x4e, 0x27, 0x55, 0xeb, 0x54, 0x89, 0xae, 0xa1, 0xf7, 0xa2, 0xfc, 0x45, 0xb0, 0x6f, 0x54, 0x35, 0x8a, 0x67, 0x5c, 0x33, 0x2, 0x76, 0x48, 0xac, 0x8e, 0xaa, 0x96, 0x12, 0x59, 0xa0, 0x6a, 0xbd, 0x88, 0x9e, 0x21, 0x7a, 0x5, 0xa7, 0x10, 0xf0, 0xa9, 0x43, 0x92, 0x62, 0x87, 0x71, 0x1e, 0x52, 0xe8, 0xcd, 0xb9, 0xee, 0x1d, 0xb1, 0x77, 0xa8, 0xae, 0x1e, 0x6c, 0x60, 0xf7, 0xc0, 0x89, 0x15, 0xce, 0x30, 0x1a, 0x4c, 0xea, 0xc2, 0xb8, 0x7f, 0x8c, 0xc7, 0xe9, 0x7a, 0xc8, 0x1d, 0xf9, 0xc4, 0x56, 0x60, 0xb7, 0x78, 0xf0, 0x8, 0xa3, 0x41, 0x8c, 0x4d, 0xd2, 0x38, 0x74, 0xa6, 0xd5, 0xe5, 0xc4, 0x49, 0x9a, 0x18, 0x11, 0x6a, 0x23, 0x8a, 0xe7, 0xbc, 0xa8, 0xa0, 0x9f, 0xb7, 0xa5, 0x35, 0xd5, 0x79, 0xb6, 0x25, 0x54, 0x49, 0x12, 0xec, 0xd, 0xc1, 0xd5, 0x0, 0x37, 0x85, 0x1, 0xc6, 0x67, 0x9, 0x64, 0x6f, 0xa2, 0x11, 0x62, 0x83, 0x7, 0x3e, 0xfc, 0x9, 0x96, 0x3f, 0xfb, 0x49, 0x66, 0xfe, 0xde, 0x6b, 0x95, 0x51, 0xb9, 0x6, 0xef, 0xb1, 0xd0, 0x8d, 0x5, 0x67, 0x71, 0x21, 0x4d, 0xa, 0x4a, 0x37, 0x4, 0x31, 0xb7, 0x4a, 0x67, 0xc7, 0xd6, 0x58, 0x13, 0x32, 0xee, 0xd8, 0x82, 0x1d, 0x70, 0xe3, 0x73, 0xd0, 0xae, 0x2b, 0x81, 0x31, 0xf9, 0xf9, 0xcf, 0x10, 0xf9, 0xd6, 0x11, 0xd9, 0xa4, 0x31, 0x5d, 0x1b, 0xdf, 0x21, 0x44, 0xdd, 0x13, 0x72, 0x60, 0x3, 0xc3, 0x13, 0xeb, 0x3a, 0xc8, 0x6e, 0x5, 0x86, 0x6b, 0x56, 0x31, 0x51, 0xa0, 0xda, 0x83, 0x41, 0x61, 0xc1, 0x4e, 0xcc, 0x5b, 0xf5, 0xf6, 0x8b, 0x17, 0x88, 0x6, 0x61, 0xfd, 0x4e, 0x5d, 0x41, 0x64, 0xb2, 0x2f, 0x3e, 0x5f, 0xa8, 0xd8, 0x34, 0x6a, 0x4a, 0xe5, 0x9d, 0x3f, 0x11, 0x79, 0x9e, 0xeb, 0x2a, 0x15, 0x1d, 0x5e, 0xe3, 0x3d, 0x17, 0xc9, 0x38, 0xf2, 0xf0, 0xad, 0xf7, 0x9e, 0xc, 0x45, 0xaf, 0xf3, 0xea, 0x26, 0x30, 0xbf, 0x6f, 0xd9, 0xc7, 0x37, 0xaf, 0xb8, 0xc9, 0xdc, 0xe0, 0x38, 0xc0, 0x25, 0x85, 0xe0, 0x96, 0x4b, 0x1e, 0x4c, 0x88, 0x1c, 0xae, 0x8c, 0x1f, 0x2b, 0xc0, 0xf6, 0xff, 0x59, 0x59, 0x3d, 0xb5, 0xc3, 0xdf, 0x87, 0x3f, 0x0, 0x2f, 0x26, 0x29, 0x7e, 0xf3, 0x5f, 0xd1, 0x62, 0x7f, 0xd, 0xde, 0xe2, 0xa4, 0x4d, 0x39, 0xe3, 0x7f, 0x6c, 0xa3, 0x3c, 0x57, 0xbb, 0x97, 0x8b, 0x5d, 0xff, 0x35, 0x5a, 0xc1, 0xa3, 0x9a, 0x35, 0x17, 0xea, 0x1, 0x26, 0xe7, 0x30, 0x96, 0xc6, 0xe6, 0x8a, 0x4, 0x4f, 0x42, 0x39, 0xaa, 0x68, 0x54, 0x54, 0xa3, 0xb2, 0x86, 0x73, 0x3a, 0xc7, 0x38, 0x15, 0x45, 0xa7, 0xeb, 0x10, 0xc7, 0x29, 0x3, 0x3b, 0x37, 0xac, 0x4, 0xab, 0x5f, 0x91, 0x22, 0x2b, 0x3, 0xe, 0xe6, 0x60, 0xa9, 0xa0, 0x29, 0x43, 0x98, 0xa3, 0x59, 0xe4, 0x81, 0x20, 0xfd, 0xfc, 0xf, 0xf1, 0x64, 0xa1, 0xb7, 0x88, 0x48, 0x6a, 0x9e, 0x8a, 0xfe, 0x60, 0x99, 0x17, 0x1f, 0x76, 0x69, 0xf, 0x2c, 0x7b, 0xf8, 0x8f, 0x81, 0x11, 0x59, 0x6c, 0x53, 0xba, 0xa, 0x11, 0x60, 0xb1, 0x56, 0xc, 0xc7, 0xaa, 0xe1, 0x63, 0x5b, 0x14, 0x81, 0xf4, 0x99, 0x9, 0xbb, 0x22, 0x17, 0x3d, 0x1f, 0x41, 0xd4, 0x21, 0xba, 0x94, 0x18, 0xab, 0x94, 0xbf, 0x3c, 0xd4, 0x9, 0xdb, 0x1e, 0x71, 0x21, 0x54, 0xd2, 0xaf, 0x7d, 0xa8, 0x60, 0x14, 0x86, 0xaf, 0x6c, 0x24, 0x1e, 0xd4, 0x77, 0xe4, 0xc5, 0xb4, 0x3b, 0x84, 0xc8, 0xea, 0x97, 0x78, 0x87, 0xed, 0x5f, 0xa6, 0xc2, 0x6e, 0x4f, 0xd1, 0x75, 0x96, 0xec, 0x1c, 0xab, 0xba, 0xf6, 0x4c, 0x94, 0xb, 0xb0, 0xf5, 0x74, 0xeb, 0xa1, 0xe1, 0xf, 0x2c, 0xaf, 0x77, 0xf2, 0xd5, 0x45, 0xf0, 0x6a, 0x17, 0x24, 0xc3, 0x2a, 0x85, 0xc0, 0xe0, 0x10, 0x1f, 0x7d, 0x4a, 0x8f, 0x13, 0x68, 0x5a, 0x6, 0xc6, 0x3b, 0xaa, 0x5, 0x1, 0x96, 0x45, 0x2c, 0xd1, 0x70, 0x33, 0x8c, 0x32, 0x14, 0xd7, 0xb4, 0x3d, 0xb8, 0xd7, 0xc, 0x7c, 0x8f, 0xde, 0x7f, 0x5b, 0xa7, 0xef, 0xdc, 0xd7, 0x81, 0x68, 0x48, 0xc3, 0x79, 0xaf, 0x2d, 0x88, 0x77, 0x8b, 0x2e, 0x5d, 0xe2, 0xfb, 0xf4, 0xff, 0x37, 0xeb, 0xfb, 0xff, 0x80, 0xa, 0x52, 0xfd, 0x9d, 0x65, 0x1e, 0xa8, 0x53, 0x7c, 0xe2, 0x95, 0xcc, 0xc1, 0xb1, 0xd8, 0xfb, 0x77, 0x19, 0x1c, 0x1c, 0x15, 0x40, 0x2e, 0x1c, 0xf4, 0xa, 0x3e, 0x7c, 0xf5, 0xf4, 0x37, 0x98, 0xef, 0xd9, 0x82, 0x93, 0x87, 0xf4, 0xb0, 0xa0, 0xa0, 0xee, 0x13, 0x3, 0xc8, 0x93, 0x9a, 0xc9, 0x93, 0x82, 0x81, 0x1d, 0x4b, 0x9f, 0x2d, 0x54, 0x87, 0x44, 0x81, 0x6d, 0x34, 0xe7, 0x8, 0xcd, 0x5d, 0x10, 0xf0, 0x1c, 0xb4, 0xb8, 0xfa, 0x50, 0x97, 0xfe, 0x59, 0x8c, 0x99, 0xff, 0xf0, 0x93, 0x48, 0x1, 0x87, 0x2e, 0xf1, 0x21, 0x5c, 0x22, 0xd6, 0x73, 0x26, 0x23, 0xed, 0x8d, 0x67, 0xb3, 0xbe, 0xfe, 0x6f, 0x38, 0x22, 0xa3, 0x3d, 0x13, 0xd8, 0xba, 0xc, 0xfb, 0x8c, 0xb4, 0x78, 0x31, 0x9a, 0x4f, 0x55, 0x44, 0x28, 0xc9, 0xa0, 0xba, 0xe2, 0x46, 0x8c, 0x7d, 0x89, 0x3a, 0x6d, 0x84, 0x1c, 0x59, 0x81, 0xa0, 0xc4, 0xce, 0x99, 0xd3, 0xce, 0xe7, 0x4f, 0x7c, 0x6e, 0x82, 0x1b, 0x39, 0x42, 0x47, 0xff, 0x50, 0xed, 0x8e, 0x87, 0x53, 0x5b, 0x30, 0x21, 0x82, 0xf5, 0x5e, 0x90, 0xea, 0xbd, 0xd3, 0x3, 0x66, 0x8, 0xaa, 0x9, 0x2d, 0x6e, 0x4a, 0x2, 0x2a, 0xc3, 0x15, 0x3f, 0xfc, 0xea, 0xe5, 0xf5, 0x8e, 0xc8, 0xb2, 0xca, 0xd3, 0x28, 0x32, 0x8, 0x33, 0x8a, 0x93, 0x7a, 0xf8, 0xe7, 0xcd, 0x98, 0x11, 0x53, 0x20, 0xf3, 0x40, 0x4c, 0x6, 0x3b, 0x19, 0x3, 0xa8, 0x97, 0x0, 0x65, 0xa3, 0x4e, 0x3f, 0x32, 0xf0, 0x7b, 0xf9, 0x5c, 0xe0, 0xe1, 0xc4, 0xf, 0x84, 0xcb, 0x89, 0x62, 0xcd, 0x52, 0x9a, 0x55, 0x71, 0x2c, 0xad, 0x3a, 0xbc, 0x25, 0x57, 0xe3, 0x2c, 0x13, 0x71, 0x56, 0xb9, 0xcd, 0x2a, 0xd8, 0x3c, 0x89, 0xe5, 0xab, 0xcf, 0x15, 0xb3, 0x8c, 0x1, 0x59, 0xa, 0x43, 0xf6, 0x71, 0x0, 0x8f, 0xe5, 0xf5, 0x72, 0x5d, 0xc2, 0x88, 0xba, 0x8b, 0x20, 0xec, 0x6e, 0xa4, 0x7f, 0xfc, 0x2b, 0x70, 0x9d, 0x79, 0x83, 0x9f, 0x6b, 0xa8, 0x80, 0x17, 0xe7, 0x8e, 0x8f, 0x77, 0x5a, 0x4b, 0xd8, 0x97, 0xb4, 0xd, 0x0, 0xd4, 0x2, 0x3b, 0x8c, 0x29, 0x46, 0xa8, 0x7, 0xfe, 0x9, 0x7a, 0xe7, 0xf0, 0x3b, 0xbc, 0x87, 0x34, 0xc9, 0xd2, 0xec, 0x24, 0x8a, 0x4a, 0xb0, 0xc8, 0x51, 0x9c, 0xd3, 0xf2, 0xae, 0x30, 0xb0, 0x42, 0x2e, 0xf6, 0x5, 0x30, 0x6f, 0x31, 0xca, 0x21, 0x21, 0x6d, 0xb5, 0x3d, 0xae, 0xbe, 0x64, 0xe, 0x61, 0xd, 0xd7, 0xf, 0xf4, 0x4a, 0x92, 0x5c, 0xdb, 0x18, 0xcd, 0xe2, 0xfb, 0xe3, 0x63, 0xf0, 0x54, 0x8c, 0x7c, 0x9a, 0x7, 0xd2, 0x5, 0x23, 0xb, 0x9b, 0x46, 0x2f, 0x3f, 0xb9, 0x99, 0xc5, 0x12, 0x89, 0x3b, 0x34, 0x48, 0x49, 0xfd, 0xd9, 0xaa, 0x64, 0xcf, 0xa1, 0xd5, 0xf, 0x11, 0xa4, 0xbe, 0xbb, 0x68, 0x61, 0x48, 0x6b, 0xdb, 0x30, 0xfa, 0x60, 0x24, 0x71, 0x58, 0xde, 0x89, 0x51, 0x1d, 0xfa, 0x65, 0x1e, 0xa1, 0xba, 0x7, 0x5f, 0x78, 0xe4, 0xad, 0x3b, 0x9, 0xc6, 0x19, 0x62, 0xc3, 0xe7, 0xf6, 0xbb, 0x34, 0x37, 0xaf, 0xd4, 0xd8, 0xa, 0x85, 0xf7, 0xf3, 0x1c, 0x70, 0x6f, 0x58, 0x31, 0x89, 0xd, 0xf8, 0xe8, 0x6, 0xbb, 0xc7, 0x3b, 0x6, 0x4f, 0xe, 0x8d, 0x83, 0xfd, 0x25, 0xa8, 0xaa, 0x3e, 0xb9, 0x7, 0x4b, 0x18, 0x48, 0x64, 0xda, 0xa5, 0xa7, 0xab, 0x96, 0x70, 0xc6, 0x95, 0xa6, 0x1c, 0xbb, 0x1a, 0x9b, 0x4f, 0xc5, 0xd3, 0x4e, 0xbd, 0x81, 0x59, 0xe, 0x55, 0x70, 0xb5, 0xa2, 0xa, 0x83, 0x74, 0x67, 0xe1, 0xdb, 0x7a, 0xa3, 0xc, 0x51, 0x75, 0xc7, 0x3d, 0x69, 0xe6, 0x1e, 0x21, 0x73, 0x66, 0x85, 0xb1, 0x47, 0x5d, 0x74, 0x94, 0x86, 0x2a, 0x3c, 0x12, 0x2a, 0x46, 0x2d, 0x4e, 0x80, 0xf7, 0xb8, 0x26, 0xe8, 0xd7, 0xda, 0x6f, 0x1d, 0xdb, 0x50, 0x1c, 0xf6, 0xfc, 0xbb, 0x4b, 0xfd, 0x54, 0xe, 0x47, 0x90, 0xb9, 0x36, 0x17, 0xe2, 0x78, 0xed, 0xd8, 0x93, 0x79, 0x24, 0x7f, 0x20, 0xe3, 0x4e, 0xd9, 0x3c, 0xd3, 0x12, 0xc7, 0xd, 0x96, 0x7a, 0x41, 0xd4, 0x91, 0xb4, 0xbe, 0x71, 0x95, 0xa, 0x16, 0x58, 0x41, 0x4f, 0x51, 0x8b, 0xf9, 0xde, 0x2, 0x7, 0xa9, 0x6c, 0xc2, 0xb0, 0x6, 0x2f, 0x39, 0xe, 0x1d, 0x63, 0xc3, 0xb7, 0xe0, 0xb4, 0x1a, 0xf, 0x8d, 0x12, 0x87, 0xab, 0xfc, 0xe9, 0x41, 0x7e, 0x87, 0xa5, 0xe4, 0xfb, 0x26, 0x2, 0xfd, 0xb7, 0x9b, 0x25, 0x44, 0x49, 0x75, 0x70, 0xb5, 0x4c, 0x58, 0x6f, 0xf6, 0xa, 0x4a, 0x48, 0xf3, 0x95, 0xaf, 0xa0, 0x90, 0x4, 0xe3, 0xaf, 0xa0, 0x38, 0xd9, 0xee, 0x7d, 0x5, 0x85, 0x22, 0xe2, 0x1f, 0x46, 0xa1, 0xf1, 0x90, 0x73, 0x1b, 0xdd, 0x90, 0xfd, 0x57, 0x50, 0xa8, 0x5c, 0x91, 0x57, 0x50, 0x9c, 0x2c, 0x77, 0xbd, 0x82, 0xe2, 0x52, 0x30, 0x8f, 0x5f, 0x38, 0xc9, 0x6f, 0xfc, 0xa, 0xa, 0x5a, 0xa4, 0x7e, 0x5, 0x25, 0x2c, 0x98, 0x78, 0x5, 0x5, 0xa7, 0x82, 0x1f, 0xcd, 0x40, 0x88, 0xde, 0xf1, 0xa, 0x8a, 0x43, 0xe5, 0x86, 0x57, 0x50, 0x92, 0xe, 0x31, 0xe8, 0x9d, 0xf8, 0xfa, 0x24, 0x86, 0xa, 0xb7, 0xc7, 0x83, 0xd5, 0xc2, 0x4e, 0x66, 0x21, 0x5c, 0x10, 0xf0, 0xa7, 0x23, 0xb, 0x6f, 0xae, 0x2, 0x2d, 0x75, 0x16, 0xce, 0xe3, 0xbb, 0x3a, 0x5b, 0xdf, 0x5, 0xd0, 0x4b, 0x59, 0xd9, 0x2b, 0xd6, 0xb1, 0xf0, 0x99, 0x6e, 0xb4, 0x48, 0x7f, 0x56, 0x10, 0x90, 0x4, 0x1b, 0xff, 0x9c, 0xbd, 0x61, 0xf8, 0x4c, 0xd5, 0x10, 0xb6, 0x19, 0xbf, 0x95, 0xa9, 0xa2, 0xd1, 0xc0, 0x71, 0x1c, 0x92, 0x6d, 0x8a, 0xe6, 0xfb, 0xda, 0xc0, 0x7c, 0xe1, 0x83, 0xc6, 0x4f, 0x70, 0xc, 0xc9, 0xe6, 0xc, 0xe, 0x36, 0x52, 0x8a, 0x74, 0xa4, 0xe9, 0x31, 0x24, 0x27, 0x15, 0xee, 0x9a, 0xda, 0xd5, 0xb3, 0x60, 0x24, 0xdf, 0x41, 0xe3, 0xc4, 0x2d, 0x5f, 0x4b, 0x14, 0x59, 0xe3, 0x91, 0x97, 0xcb, 0xc1, 0x8c, 0x1, 0xac, 0x19, 0x21, 0x8f, 0xe7, 0x38, 0xd9, 0xfe, 0xdb, 0x25, 0xe2, 0xea, 0xad, 0x55, 0x38, 0xe4, 0x59, 0x84, 0xae, 0x21, 0xed, 0x5d, 0xa, 0xde, 0xd4, 0xc8, 0x7b, 0x55, 0x2e, 0x86, 0xeb, 0x8d, 0xcd, 0x70, 0x9c, 0x4e, 0x5b, 0xb5, 0x5d, 0xd8, 0xd3, 0x83, 0x2c, 0xb2, 0x3c, 0xd1, 0xd6, 0xdd, 0xd8, 0xe7, 0xb4, 0xdc, 0x55, 0xf3, 0x24, 0x56, 0xa2, 0xb2, 0x2e, 0xae, 0xba, 0xd5, 0x9c, 0xa8, 0x49, 0x7, 0x92, 0x60, 0x58, 0xdb, 0x35, 0xfc, 0x45, 0x8c, 0x41, 0x18, 0x71, 0xa2, 0x1b, 0x5e, 0x97, 0x6a, 0x53, 0x47, 0x3e, 0x56, 0xab, 0xd5, 0x7d, 0x4d, 0xed, 0x9e, 0xbe, 0xba, 0x35, 0x5f, 0x82, 0x65, 0x85, 0x44, 0x1e, 0xb, 0x89, 0x8b, 0x31, 0x98, 0x2e, 0x23, 0x67, 0x40, 0xe2, 0xba, 0x17, 0x2c, 0x50, 0xfa, 0x8, 0xc2, 0xa1, 0xdd, 0x5c, 0x77, 0xd1, 0x12, 0xe0, 0x48, 0x4c, 0x2, 0xa7, 0x4b, 0xbb, 0xa6, 0xe, 0xd0, 0x8, 0x49, 0xb9, 0x61, 0x59, 0xd2, 0xe3, 0x4, 0xa4, 0xa4, 0xc8, 0xa4, 0xb1, 0x73, 0x77, 0xc6, 0x69, 0x74, 0xea, 0xe3, 0x89, 0xac, 0x69, 0x49, 0xa5, 0x8, 0x24, 0xad, 0x41, 0xe7, 0xe9, 0xef, 0x6d, 0x79, 0xdf, 0xca, 0x6e, 0x10, 0xf5, 0xeb, 0x66, 0x4c, 0x92, 0x99, 0xef, 0x96, 0xef, 0xdd, 0x66, 0x27, 0xac, 0xab, 0xd, 0x99, 0x48, 0x41, 0x28, 0x2e, 0xdd, 0x48, 0x82, 0x64, 0x2d, 0x70, 0xe2, 0x0, 0x88, 0x35, 0x16, 0xcd, 0x67, 0x18, 0x21, 0xb1, 0x3, 0x26, 0x1d, 0x31, 0x31, 0x51, 0xe9, 0x9b, 0xb2, 0xf8, 0x4d, 0x61, 0x2a, 0x51, 0xed, 0x19, 0xa0, 0x29, 0xef, 0x79, 0x7f, 0xc3, 0xa5, 0xd0, 0x69, 0xc0, 0x82, 0xe2, 0x7a, 0xc2, 0xc2, 0x71, 0xee, 0x1e, 0xb0, 0xf8, 0xe4, 0x82, 0x1, 0x8b, 0x8f, 0x10, 0x19, 0xb0, 0x60, 0xb4, 0x42, 0x63, 0x16, 0xc5, 0x4a, 0x54, 0x36, 0x36, 0x60, 0xa1, 0x6a, 0xd2, 0x81, 0xe4, 0xd, 0x86, 0x67, 0xf5, 0x71, 0x56, 0x8e, 0x1e, 0xe3, 0x55, 0x46, 0x6c, 0x4c, 0x2, 0xaf, 0x4b, 0xb5, 0xc9, 0x33, 0xaa, 0xfc, 0x9, 0x93, 0x7b, 0x9a, 0xba, 0xeb, 0x80, 0x5, 0xcf, 0x97, 0x60, 0x39, 0x31, 0x60, 0x49, 0x88, 0xf1, 0xf6, 0x1, 0x8b, 0x4f, 0x21, 0x18, 0xb0, 0xf8, 0x8, 0xe1, 0x80, 0xe5, 0x87, 0xe5, 0x66, 0x56, 0x8c, 0xe6, 0xf1, 0xb6, 0xf5, 0x6, 0x2b, 0x11, 0x9c, 0x2e, 0x6d, 0x9a, 0x18, 0xac, 0x48, 0x29, 0xdd, 0x3a, 0x58, 0x41, 0x4a, 0xa2, 0x9c, 0x91, 0x17, 0xf, 0xec, 0x66, 0x55, 0x88, 0x2c, 0xd7, 0xab, 0x73, 0xc9, 0xf7, 0x1a, 0xa1, 0x9b, 0x87, 0x57, 0xdd, 0x6b, 0xdd, 0xc5, 0x22, 0xdd, 0x36, 0xbc, 0xba, 0x83, 0x40, 0xd2, 0x76, 0x75, 0x1e, 0x5e, 0xdd, 0x96, 0xf7, 0xad, 0xac, 0x5c, 0xf7, 0xe1, 0xd5, 0x3d, 0x99, 0xef, 0x96, 0xef, 0xdd, 0x46, 0x32, 0xac, 0x6b, 0x30, 0xbc, 0xa, 0x20, 0x14, 0x97, 0xc4, 0xf0, 0xca, 0xaf, 0x5, 0x4e, 0xbc, 0xeb, 0xf0, 0x2a, 0x28, 0x8d, 0x1c, 0x5e, 0xc5, 0x30, 0x93, 0xc3, 0x2b, 0xaa, 0xd2, 0x37, 0x65, 0xf1, 0x9b, 0xe2, 0x3a, 0x5c, 0x9e, 0x98, 0xc5, 0x59, 0x9d, 0xce, 0xbb, 0xa5, 0x7b, 0x2b, 0x72, 0x86, 0x9e, 0x6e, 0xb, 0x62, 0xa4, 0x76, 0xd, 0x82, 0xa, 0xb, 0x82, 0xc7, 0x40, 0xdd, 0xed, 0xc, 0x7, 0xe7, 0xa1, 0xae, 0xf2, 0x65, 0xc9, 0xbc, 0x3, 0xf, 0xc9, 0xae, 0x82, 0xfe, 0x7d, 0xf8, 0x5b, 0x96, 0x15, 0xd9, 0x3b, 0xb3, 0xc5, 0x25, 0xa2, 0xf4, 0x78, 0x66, 0x19, 0x52, 0xd1, 0x67, 0x7, 0x3d, 0x8c, 0x63, 0xc1, 0xea, 0x25, 0x4e, 0x14, 0xe0, 0x4b, 0xfa, 0xde, 0xc1, 0x26, 0xb5, 0xc5, 0x36, 0x16, 0xdb, 0x4f, 0x61, 0xcd, 0x2c, 0xb5, 0xb0, 0x66, 0x1e, 0x94, 0xf7, 0x46, 0x37, 0x81, 0xa9, 0x7d, 0x3c, 0xb6, 0x5e, 0xf8, 0xba, 0x31, 0x71, 0x11, 0xe3, 0xbe, 0xa8, 0xa7, 0x1d, 0xee, 0xa9, 0x86, 0x97, 0x99, 0x9c, 0x2a, 0x38, 0xb7, 0xab, 0xfc, 0xfa, 0x39, 0x40, 0x51, 0x57, 0x77, 0x5d, 0xfd, 0xbe, 0x2b, 0x72, 0x6e, 0x11, 0xe0, 0xa, 0x56, 0x50, 0x3c, 0x80, 0x89, 0xd2, 0xef, 0xbd, 0x28, 0xe9, 0xb5, 0xa2, 0xee, 0xd8, 0x7e, 0xb2, 0xb2, 0x33, 0x61, 0x13, 0xe3, 0x19, 0x4, 0xe4, 0x96, 0x79, 0x76, 0x64, 0x96, 0x3, 0x28, 0x3, 0xc7, 0x8a, 0xa5, 0x22, 0xbc, 0x4, 0xee, 0x10, 0x81, 0x71, 0x66, 0x49, 0x40, 0x84, 0x26, 0xa8, 0xa4, 0x8d, 0xfb, 0x91, 0xaa, 0x6e, 0x62, 0x52, 0x17, 0x5c, 0xae, 0x81, 0xe5, 0x42, 0xd7, 0x87, 0xa7, 0x63, 0xdc, 0xfa, 0xe, 0x8b, 0x80, 0x86, 0x52, 0x70, 0x40, 0x51, 0xca, 0x61, 0x73, 0x4f, 0xc6, 0x93, 0xd5, 0x74, 0x7e, 0xfb, 0xd3, 0xce, 0xe8, 0xb5, 0x36, 0x5b, 0x26, 0x8f, 0x71, 0xe1, 0x1b, 0x1b, 0x95, 0x26, 0xed, 0x4d, 0xe2, 0x6, 0x78, 0x48, 0x8b, 0xee, 0xe4, 0x8, 0x1c, 0xe9, 0x69, 0xb7, 0xf7, 0x6c, 0x45, 0x97, 0xea, 0xdc, 0x21, 0xf8, 0x8d, 0xfa, 0x37, 0xf, 0xda, 0x10, 0xc8, 0x4e, 0xa6, 0x39, 0xb2, 0x23, 0x6e, 0xe2, 0x87, 0xa4, 0x22, 0xa2, 0xb, 0xe1, 0x6f, 0x23, 0x3a, 0x49, 0x97, 0x14, 0x5d, 0x0, 0x7e, 0xad, 0xe8, 0x98, 0x42, 0x47, 0x5d, 0xa6, 0x3f, 0x6a, 0x8, 0xae, 0xa3, 0x28, 0x2a, 0x3d, 0xdc, 0x7f, 0xa, 0x80, 0xaa, 0x83, 0xfc, 0x16, 0xc, 0xc7, 0x5c, 0xb7, 0x6c, 0x9e, 0x29, 0x76, 0x50, 0xee, 0x8e, 0xd8, 0xc, 0x72, 0x9b, 0xcd, 0x72, 0x2, 0x7a, 0xb9, 0x4e, 0xb9, 0xed, 0xba, 0xac, 0x5a, 0x34, 0x95, 0xf9, 0x87, 0x7b, 0x96, 0xcb, 0x56, 0x4f, 0xfe, 0x14, 0x35, 0x4, 0x5b, 0x80, 0x6, 0xf9, 0x78, 0x2a, 0x3f, 0x57, 0x87, 0x73, 0x3, 0x32, 0x98, 0x24, 0x90, 0x49, 0x9e, 0x30, 0x52, 0x8, 0x9e, 0x45, 0x74, 0x93, 0xdc, 0xca, 0xe0, 0x76, 0xd0, 0x1, 0x88, 0x52, 0x3a, 0x1a, 0x30, 0xcc, 0x4e, 0xc9, 0xc3, 0xc, 0x6e, 0xeb, 0x99, 0x76, 0x1b, 0x8e, 0xcb, 0x5d, 0x6f, 0x38, 0xe7, 0x7f, 0x4d, 0xca, 0x1d, 0xe8, 0x5c, 0x8f, 0xb3, 0x1f, 0xbd, 0x38, 0x1c, 0x7e, 0x4c, 0x75, 0xe7, 0x7e, 0x53, 0x3a, 0x3c, 0xc8, 0xb2, 0x68, 0x4a, 0xf9, 0xac, 0x8c, 0xd3, 0xd6, 0xc3, 0xf1, 0xac, 0xdc, 0x5d, 0xb, 0xc9, 0xa5, 0x92, 0x8d, 0xfe, 0xd5, 0x2d, 0x96, 0xbb, 0xaa, 0xb3, 0x8a, 0xd7, 0xa5, 0xea, 0x9b, 0x97, 0xbb, 0x63, 0xfb, 0xcd, 0xbb, 0xe6, 0x22, 0xe2, 0x58, 0xaa, 0xb3, 0x1d, 0xc1, 0x10, 0x50, 0xdf, 0x60, 0x51, 0x4, 0x92, 0x5b, 0xb6, 0x1e, 0xde, 0x2f, 0xdb, 0x53, 0xb9, 0x31, 0x33, 0x10, 0xc, 0x44, 0x2d, 0x76, 0x4c, 0x9e, 0xd8, 0xcc, 0xa0, 0xd4, 0xe4, 0x90, 0xc7, 0xb3, 0xbd, 0x1b, 0x6f, 0xe, 0x1e, 0x56, 0xac, 0xb, 0xa2, 0x8a, 0x95, 0xf, 0x81, 0x6b, 0x72, 0xc8, 0x7b, 0xbd, 0xce, 0x83, 0xa9, 0x1e, 0x1e, 0x56, 0xac, 0xb, 0x22, 0xf7, 0xa1, 0xc4, 0xdb, 0xc3, 0x9a, 0x9c, 0xff, 0x7a, 0xa8, 0xf3, 0xee, 0x23, 0x44, 0xc2, 0xa, 0x4, 0xe9, 0xa4, 0x6c, 0xc5, 0xd3, 0xa7, 0x9a, 0x10, 0xf2, 0xc6, 0xa1, 0xf3, 0xc8, 0x9c, 0x87, 0x87, 0x95, 0xe9, 0x82, 0xa8, 0x62, 0xe5, 0x7b, 0x8d, 0x46, 0x43, 0x82, 0xf7, 0xd5, 0x9c, 0x37, 0xaf, 0x5c, 0x34, 0x54, 0x8f, 0x20, 0x84, 0x5c, 0x33, 0x13, 0xcf, 0xc4, 0x5d, 0xd5, 0xab, 0x5a, 0xf8, 0xd1, 0x29, 0xfb, 0x1e, 0x7, 0x7c, 0x8e, 0x83, 0xc7, 0xbd, 0x7f, 0xc, 0x63, 0xdc, 0xc0, 0xa8, 0x3c, 0x93, 0x2c, 0xf3, 0xc6, 0x90, 0xae, 0x6d, 0xa0, 0xfa, 0x3a, 0x62, 0x16, 0x6e, 0xe, 0xe7, 0x63, 0xbc, 0x82, 0x38, 0xc9, 0x2e, 0xaa, 0x47, 0xf7, 0x6e, 0x59, 0xfb, 0x58, 0xef, 0xe, 0x5e, 0x57, 0x52, 0x99, 0xf4, 0x23, 0x4b, 0x9a, 0x86, 0x73, 0xd6, 0x48, 0xbf, 0xb8, 0xc4, 0xc, 0x95, 0x64, 0x40, 0x1b, 0x2a, 0xf9, 0xeb, 0x4e, 0x43, 0xc5, 0xdd, 0xb4, 0x64, 0x85, 0x49, 0x69, 0xa7, 0x7, 0xf0, 0x9a, 0x1d, 0x7b, 0x35, 0xd6, 0x4c, 0x17, 0x9e, 0x6f, 0x79, 0xcf, 0xdc, 0x23, 0xaf, 0xf3, 0x3a, 0x4e, 0xe, 0xc7, 0x79, 0x50, 0xa8, 0xce, 0x69, 0x96, 0x99, 0x7f, 0xc5, 0xd7, 0xb2, 0x3, 0xe7, 0x98, 0x62, 0x4c, 0xf6, 0xf7, 0xf3, 0x8e, 0x8d, 0x6b, 0x4e, 0x20, 0xf4, 0xd3, 0x24, 0xc3, 0x57, 0x39, 0x26, 0x99, 0x59, 0x50, 0xa8, 0xf6, 0xdb, 0xf2, 0x54, 0xb5, 0x91, 0x70, 0x17, 0x86, 0x6c, 0x6f, 0xb8, 0x1d, 0xf5, 0xc1, 0xcf, 0xed, 0xe8, 0xe2, 0xd0, 0x80, 0xa8, 0xfe, 0xd9, 0x36, 0xef, 0xf2, 0xc4, 0xd8, 0x57, 0xf5, 0x71, 0x96, 0x81, 0xec, 0xcf, 0xdb, 0x13, 0x8c, 0x2a, 0xea, 0x99, 0x6c, 0x70, 0xb1, 0xc1, 0xe4, 0xe8, 0x87, 0xb7, 0x19, 0xac, 0x38, 0x82, 0xc5, 0xc, 0x50, 0x25, 0x93, 0xed, 0xe2, 0x85, 0x20, 0x56, 0xb, 0xdf, 0xcd, 0xea, 0x54, 0x96, 0x7b, 0x79, 0xd7, 0x2a, 0x3c, 0xed, 0x14, 0x8a, 0x7c, 0xfa, 0x51, 0x46, 0x5f, 0xbe, 0x99, 0x49, 0x67, 0x6c, 0x9, 0x1f, 0xee, 0x51, 0x9a, 0x30, 0xcf, 0x9c, 0x36, 0x46, 0x1a, 0xc3, 0x8a, 0x77, 0xfe, 0xa8, 0xce, 0x50, 0xb7, 0x5b, 0x86, 0xb0, 0x2f, 0xaa, 0x9a, 0x78, 0x7c, 0x63, 0x4a, 0x2d, 0x80, 0x45, 0xa2, 0x60, 0x84, 0x6f, 0xfe, 0x80, 0xe7, 0xbd, 0x24, 0x4a, 0x6f, 0x38, 0x6e, 0x7a, 0xfc, 0x55, 0x27, 0xe6, 0x2d, 0x6, 0x87, 0x73, 0xeb, 0x3d, 0x11, 0x46, 0x20, 0x25, 0x31, 0x40, 0x7d, 0x7a, 0x22, 0x6c, 0x48, 0xdf, 0x26, 0xa8, 0x28, 0x22, 0xb6, 0x4b, 0xc0, 0x3b, 0x4, 0xe0, 0x9d, 0x89, 0xc2, 0x66, 0xd1, 0x4f, 0x28, 0x80, 0x24, 0x63, 0x61, 0x6c, 0xa, 0x16, 0xbe, 0x43, 0xf, 0xa, 0x2c, 0x3b, 0xc3, 0x55, 0x71, 0x14, 0x4b, 0x6d, 0xe0, 0x92, 0x8b, 0xbf, 0x64, 0x57, 0xd4, 0xcc, 0x5e, 0xdb, 0x69, 0x29, 0xb1, 0xf8, 0x78, 0xdb, 0x5, 0x16, 0x41, 0xb3, 0xb7, 0x9d, 0xba, 0xc7, 0x28, 0xbd, 0x6e, 0x29, 0x91, 0xe4, 0x3f, 0x32, 0x8, 0x39, 0xec, 0x7a, 0x8f, 0x99, 0xa6, 0xf3, 0x7c, 0xec, 0xab, 0x8f, 0x73, 0x70, 0xae, 0xd8, 0xa0, 0x3c, 0x1c, 0xfd, 0x77, 0xe9, 0x14, 0x61, 0xa6, 0x61, 0xbb, 0xaa, 0x11, 0xc3, 0xe7, 0xbe, 0x9b, 0xc4, 0x2f, 0x6d, 0x5e, 0x5c, 0x6d, 0x9e, 0xe0, 0x19, 0x99, 0x1c, 0xeb, 0x43, 0x83, 0xe5, 0x57, 0x10, 0xca, 0xc9, 0xf0, 0x1b, 0x37, 0xea, 0xb8, 0xa0, 0x90, 0x22, 0x26, 0x81, 0xe4, 0x70, 0x2b, 0xb2, 0x12, 0x81, 0xb4, 0xa4, 0x79, 0xea, 0x1e, 0x33, 0x56, 0xce, 0xaa, 0x95, 0x8b, 0xe, 0xdb, 0x41, 0xeb, 0xd3, 0x98, 0xff, 0xd1, 0x88, 0xd1, 0xe1, 0xd9, 0x8d, 0x3c, 0x8a, 0xe7, 0xbd, 0x3b, 0x32, 0x28, 0x9f, 0x2, 0x4f, 0x71, 0x97, 0x1a, 0xce, 0xdd, 0xc8, 0xa0, 0x7e, 0x7e, 0xb8, 0x23, 0x8f, 0xe6, 0xb5, 0xe2, 0x14, 0x9b, 0x89, 0xe1, 0xdf, 0x8d, 0x5c, 0xaa, 0xc7, 0x53, 0x3b, 0x32, 0xa9, 0x9f, 0x5a, 0x25, 0x79, 0xfc, 0xb3, 0xb6, 0x9c, 0xbf, 0x96, 0xdf, 0x36, 0xa7, 0x62, 0x57, 0x36, 0x3d, 0xfe, 0xf8, 0xd3, 0x89, 0xa9, 0xc7, 0x40, 0x5e, 0xe0, 0x3c, 0x55, 0xc7, 0xb2, 0xb9, 0x6c, 0x4e, 0xfc, 0x32, 0xa3, 0xad, 0x82, 0x51, 0x7e, 0x7e, 0xbf, 0x90, 0x79, 0x99, 0xf6, 0x80, 0x42, 0xf9, 0xa5, 0x46, 0x56, 0xc6, 0xe1, 0xbb, 0x92, 0xff, 0x8e, 0xb4, 0x87, 0x9a, 0xe2, 0xc5, 0x8f, 0x26, 0x5, 0xaf, 0x5a, 0x62, 0xb6, 0xf3, 0xe6, 0xd7, 0xea, 0xf0, 0xbb, 0x39, 0x7c, 0xc5, 0x50, 0x5c, 0xc0, 0x91, 0x71, 0xa9, 0x23, 0xb7, 0x78, 0x42, 0x4c, 0xcb, 0xbd, 0x38, 0x4a, 0x10, 0xc4, 0x7e, 0x36, 0xaf, 0x18, 0x8a, 0x68, 0x48, 0x91, 0xf0, 0xb7, 0xc0, 0x8e, 0x11, 0xd3, 0x7f, 0x72, 0x45, 0x39, 0x52, 0xbd, 0x1, 0xb8, 0x5e, 0xa4, 0x79, 0x9e, 0xa1, 0xd5, 0x23, 0x30, 0x11, 0xa7, 0x2f, 0x2a, 0xd6, 0x1b, 0xce, 0xa5, 0xb3, 0xf6, 0x9c, 0xbd, 0x7, 0x24, 0x21, 0xae, 0xdc, 0x94, 0x1e, 0xad, 0xfb, 0x36, 0x55, 0xa5, 0xf4, 0x5c, 0xf9, 0x6, 0x37, 0xd9, 0x34, 0x7f, 0xf2, 0x6d, 0xd1, 0x81, 0x79, 0x32, 0x6d, 0x3a, 0x5b, 0x97, 0x2f, 0x7d, 0xe4, 0x5a, 0xd5, 0xec, 0x7d, 0x6f, 0x3c, 0xfb, 0xb1, 0xf, 0xfa, 0x71, 0xf0, 0x7b, 0x96, 0xfd, 0x48, 0xe4, 0xa4, 0x21, 0x8f, 0x1e, 0xd, 0xef, 0xf7, 0xfb, 0xf0, 0xfe, 0x2a, 0x93, 0xdb, 0xff, 0x7f, 0x4c, 0xff, 0xcb, 0x73, 0x8c, 0x3c, 0x4c, 0x29, 0xfa, 0x9b, 0xb0, 0x43, 0x22, 0xbe, 0x9, 0x9, 0x71, 0x55, 0xd2, 0xbc, 0xb8, 0xa5, 0x13, 0x55, 0x82, 0xa7, 0x90, 0xba, 0xbc, 0x62, 0xcf, 0x4, 0x24, 0xf4, 0x1c, 0xb3, 0x8f, 0xbd, 0xb1, 0x7e, 0xfd, 0xb6, 0xc7, 0xdc, 0x6e, 0xb5, 0x67, 0xf3, 0x40, 0xde, 0x6f, 0x6e, 0xcf, 0x74, 0x73, 0xe, 0xbf, 0x9f, 0x25, 0x97, 0xa0, 0xe2, 0x1d, 0x10, 0x23, 0xf0, 0x7b, 0x47, 0xfc, 0xbd, 0x23, 0x6, 0x1c, 0x7b, 0x7a, 0x97, 0x58, 0x83, 0x4c, 0x28, 0x9d, 0x9f, 0xfb, 0x77, 0x8d, 0xfb, 0x5d, 0xe3, 0x52, 0x1a, 0x97, 0x5e, 0x87, 0x4e, 0x28, 0x1d, 0x42, 0xe0, 0x77, 0xbd, 0xfb, 0x5d, 0xef, 0x52, 0x7a, 0x97, 0xdc, 0x88, 0x48, 0xa8, 0x5d, 0x98, 0xff, 0x77, 0xad, 0xfb, 0x5d, 0xeb, 0x10, 0xad, 0x13, 0xb, 0xd6, 0x70, 0x71, 0x4e, 0xee, 0xe8, 0x8b, 0x64, 0xec, 0x15, 0x51, 0xf5, 0x3a, 0x81, 0x80, 0xf7, 0xe5, 0x3f, 0x6c, 0xc6, 0xb8, 0xfe, 0x76, 0xf9, 0xed, 0xc0, 0x57, 0xec, 0xfd, 0x50, 0xce, 0x57, 0x88, 0x62, 0x16, 0xca, 0x45, 0x4c, 0x30, 0x5, 0x39, 0x2c, 0xff, 0x5e, 0xae, 0x5a, 0x3f, 0x86, 0xa1, 0x84, 0x89, 0xc5, 0x39, 0x55, 0xca, 0x33, 0x7c, 0xde, 0xdd, 0x8d, 0xd6, 0x7, 0xa8, 0xf1, 0x4, 0x37, 0x83, 0xb8, 0x54, 0xec, 0x5, 0xfc, 0x3, 0x19, 0x38, 0x63, 0xfd, 0x30, 0xb3, 0x2a, 0x7, 0x89, 0xc9, 0xe9, 0xed, 0x9f, 0x31, 0x79, 0x68, 0x52, 0x32, 0x84, 0xc1, 0x85, 0x8, 0x6c, 0xa0, 0x8b, 0x13, 0xb1, 0xa6, 0xfc, 0x4d, 0x38, 0x91, 0xaa, 0x71, 0xf8, 0x49, 0x77, 0xee, 0x32, 0x22, 0xe1, 0x13, 0x66, 0xa0, 0xc6, 0x55, 0xd3, 0x5e, 0x52, 0xf1, 0xd2, 0xed, 0xe6, 0x91, 0xb7, 0x44, 0x3b, 0xce, 0xfc, 0xd8, 0x87, 0x59, 0xb0, 0xd5, 0x74, 0x7b, 0xf0, 0x74, 0x24, 0x88, 0xf6, 0x7d, 0xa7, 0x4d, 0x2, 0x5e, 0x5e, 0xfd, 0x86, 0x9c, 0x4f, 0x8f, 0xe, 0x91, 0x70, 0xff, 0xb3, 0x86, 0x85, 0x5f, 0x4a, 0x3f, 0x48, 0xe9, 0xf9, 0x9, 0xa6, 0xd5, 0xdd, 0xa5, 0xc4, 0x22, 0x14, 0x80, 0x3e, 0x77, 0xe1, 0xa5, 0x47, 0x8e, 0xd9, 0x74, 0xbd, 0xa9, 0xe8, 0xef, 0x72, 0xea, 0x73, 0x2d, 0x7d, 0x12, 0x62, 0x36, 0xbf, 0x29, 0x38, 0xb9, 0xed, 0x2e, 0x79, 0xe9, 0x70, 0x24, 0x86, 0xa0, 0x4c, 0xa, 0x30, 0xc5, 0xec, 0x3d, 0x19, 0x45, 0x2d, 0x52, 0x4d, 0x66, 0xf6, 0xd, 0xba, 0xb3, 0xcc, 0x5b, 0xeb, 0x76, 0x7e, 0x13, 0xb9, 0x8, 0x66, 0xe1, 0xa5, 0x38, 0x73, 0x2c, 0x6, 0xdd, 0xd6, 0xee, 0x13, 0xe9, 0x54, 0x63, 0x2b, 0x28, 0x71, 0x90, 0x35, 0x16, 0x13, 0x7a, 0x81, 0xef, 0x90, 0xe1, 0x5, 0xdc, 0xd0, 0x70, 0x89, 0xc, 0xcf, 0xc3, 0x66, 0xc7, 0x14, 0xec, 0xf6, 0x7c, 0xd1, 0x6c, 0x37, 0xab, 0x57, 0xa7, 0x6c, 0x9, 0x5e, 0x53, 0xb9, 0xe3, 0x99, 0xe3, 0x7a, 0x7d, 0x67, 0xb6, 0x14, 0xc7, 0x89, 0xdc, 0x22, 0x73, 0xaa, 0x4b, 0x51, 0xd, 0x85, 0x77, 0x8d, 0xb8, 0xa8, 0xa2, 0x79, 0x3a, 0x74, 0xa6, 0xcd, 0x13, 0xb3, 0xb7, 0x61, 0x67, 0x32, 0x6b, 0x5c, 0x29, 0xeb, 0xab, 0x96, 0xcc, 0x8a, 0x6e, 0x4, 0x68, 0xbc, 0xae, 0xf6, 0x89, 0x24, 0x40, 0xb9, 0x16, 0x3, 0xef, 0x78, 0x1e, 0x7f, 0x55, 0x94, 0xd3, 0x48, 0x7d, 0xec, 0xe, 0x7a, 0x1c, 0x21, 0xc5, 0x8e, 0x6b, 0x77, 0xa0, 0xb5, 0x71, 0x8c, 0x8a, 0xde, 0x93, 0xf3, 0xa9, 0x88, 0xd5, 0xa0, 0x64, 0xdb, 0xc8, 0x95, 0xa5, 0xa2, 0x43, 0x6e, 0x2, 0xe9, 0xfe, 0x56, 0xe1, 0xb9, 0x49, 0x19, 0x8, 0x60, 0xc7, 0xf6, 0x98, 0x2f, 0x3f, 0xae, 0xb, 0xa2, 0x0, 0xba, 0x31, 0x0, 0x34, 0xca, 0x5, 0xdd, 0xc, 0x94, 0xd3, 0xef, 0xd6, 0x3e, 0x7a, 0xe1, 0x24, 0x55, 0x3d, 0xb5, 0xe, 0x53, 0x74, 0x23, 0x40, 0xe3, 0xdd, 0xdf, 0x50, 0x8a, 0x0, 0x29, 0x25, 0xd, 0xef, 0xd6, 0x5c, 0x65, 0x59, 0x8c, 0x27, 0x73, 0xba, 0x18, 0xba, 0xc5, 0x5c, 0x84, 0x14, 0x3b, 0xaf, 0xec, 0x3e, 0x6a, 0x81, 0x21, 0x79, 0x5b, 0x45, 0x2e, 0x57, 0x14, 0x9d, 0xf2, 0x93, 0x68, 0xf7, 0xb7, 0x8d, 0xcc, 0x4f, 0xca, 0x42, 0x81, 0xbb, 0xb5, 0xcc, 0x7a, 0x3a, 0xd9, 0x4c, 0xa, 0xb2, 0x10, 0xba, 0x61, 0x1c, 0x78, 0x82, 0x97, 0x57, 0x36, 0x4b, 0xd7, 0xb9, 0x23, 0xea, 0xd0, 0xfc, 0x9, 0x90, 0xf7, 0x90, 0x2f, 0x3f, 0x34, 0xbf, 0xf, 0x82, 0x7, 0xbe, 0x7a, 0xf, 0x5d, 0xee, 0x89, 0x8f, 0xbc, 0x3d, 0xf1, 0xcc, 0xdd, 0x5f, 0x26, 0x91, 0x14, 0x53, 0x72, 0x81, 0x1, 0x1e, 0x93, 0xd2, 0x0, 0x2d, 0x11, 0x32, 0xf6, 0x67, 0x34, 0xb4, 0x27, 0x35, 0xc5, 0x1c, 0x8c, 0xa8, 0x39, 0xe6, 0x60, 0xe4, 0x95, 0x8c, 0xbe, 0x17, 0xa2, 0x2, 0x1b, 0x78, 0xc3, 0x1c, 0x99, 0xaf, 0xad, 0xda, 0xba, 0xbc, 0x44, 0x83, 0x27, 0x82, 0x13, 0x0, 0x8f, 0xe1, 0xc1, 0x25, 0x40, 0xc6, 0xc, 0xc6, 0xc2, 0x34, 0x79, 0xe5, 0xc1, 0xa6, 0x7a, 0x3f, 0x91, 0x7c, 0x2a, 0x1b, 0xce, 0xf5, 0xe6, 0x70, 0x68, 0xed, 0x6d, 0x17, 0x28, 0xe6, 0xc4, 0x8d, 0xbd, 0x8e, 0xb1, 0x57, 0x29, 0xf9, 0x23, 0x33, 0x70, 0xd3, 0x4, 0xcf, 0x40, 0xcf, 0xfb, 0x3a, 0x49, 0xb2, 0xab, 0x83, 0x2f, 0x3c, 0xd3, 0x6b, 0x23, 0x19, 0x42, 0x25, 0xb0, 0x44, 0x1d, 0xc8, 0x6, 0x79, 0x2e, 0x61, 0x44, 0x71, 0xec, 0xee, 0xac, 0x57, 0x34, 0x5c, 0xfa, 0xe8, 0xc5, 0xd6, 0x45, 0x3a, 0xb0, 0xd4, 0x99, 0xd6, 0xc5, 0x79, 0x6, 0xe2, 0x15, 0xbd, 0xc1, 0x29, 0xdd, 0x2e, 0xba, 0xf4, 0x22, 0xb, 0x32, 0x5d, 0xea, 0xd1, 0x8d, 0x92, 0xff, 0xc, 0xce, 0xab, 0x34, 0xcb, 0x16, 0xf3, 0xe0, 0xa8, 0x7e, 0xdf, 0xed, 0xf6, 0xf, 0x31, 0xd, 0xa0, 0x96, 0xb1, 0xd4, 0x69, 0x9f, 0x2b, 0x55, 0xf3, 0x56, 0x1e, 0x94, 0x54, 0x50, 0xe4, 0xd7, 0xe0, 0x54, 0x36, 0xc7, 0xc3, 0xbe, 0x11, 0xa7, 0xd3, 0x45, 0xa, 0xa9, 0xd4, 0x28, 0xed, 0x9e, 0x3a, 0x92, 0xea, 0x52, 0xc5, 0x53, 0xc3, 0xb2, 0x7a, 0xde, 0x81, 0x56, 0x10, 0xf, 0x32, 0x7c, 0x72, 0xe5, 0x4a, 0x11, 0x73, 0x1f, 0xa5, 0x14, 0x50, 0x54, 0xbd, 0x3, 0xc8, 0xe5, 0x55, 0xfa, 0x79, 0x23, 0x1b, 0xcf, 0x2d, 0x77, 0x39, 0x6e, 0xca, 0x89, 0xe6, 0xf3, 0x16, 0xc2, 0x5c, 0x83, 0x3a, 0x13, 0x7e, 0x5, 0x4f, 0x37, 0x95, 0x7a, 0x21, 0x25, 0x18, 0x31, 0xb, 0xdf, 0x4d, 0xb8, 0xbd, 0x76, 0xfd, 0x36, 0xb2, 0x4e, 0x96, 0xb3, 0xfd, 0x87, 0xb4, 0xe9, 0x9b, 0xd5, 0x27, 0x59, 0xce, 0xf6, 0x8d, 0x54, 0x29, 0xca, 0xf1, 0xdb, 0xc9, 0xf8, 0xed, 0xa4, 0xf8, 0x1a, 0x39, 0x5d, 0xfe, 0xf1, 0xe6, 0x83, 0xd7, 0x5, 0xf1, 0x85, 0xdf, 0x43, 0xc1, 0xdf, 0xa2, 0x98, 0xe, 0x2d, 0xf3, 0xf, 0x29, 0x86, 0xae, 0xcd, 0x9b, 0x49, 0xff, 0xcd, 0xe4, 0xfb, 0x66, 0x12, 0x7c, 0x85, 0x8c, 0x2e, 0xf7, 0x18, 0x6f, 0xf8, 0xb4, 0xb3, 0x64, 0x80, 0xe4, 0x8c, 0x1a, 0x84, 0xdd, 0x37, 0x9c, 0xbf, 0x89, 0x13, 0xd5, 0x36, 0x30, 0xe1, 0xd4, 0x49, 0x9, 0xe3, 0x44, 0xf9, 0x68, 0xaf, 0x23, 0xd1, 0x7b, 0x99, 0xe9, 0x5e, 0xde, 0x25, 0x26, 0xb6, 0xf8, 0x30, 0xf7, 0xbb, 0x8, 0xb5, 0xb3, 0x1f, 0x7b, 0x55, 0x19, 0xdb, 0xb7, 0x28, 0x23, 0x2a, 0xd7, 0x37, 0xaa, 0x47, 0xa2, 0x8c, 0x98, 0xdf, 0x7b, 0x1b, 0x91, 0xbf, 0x91, 0x54, 0xdf, 0x48, 0x70, 0x77, 0xcb, 0xe6, 0xf2, 0xf, 0xb7, 0xe, 0x5d, 0x1d, 0xd6, 0x2b, 0xf5, 0xf8, 0x3b, 0x9b, 0xa3, 0xb7, 0xa9, 0x45, 0xb2, 0xa5, 0x5e, 0x6f, 0xff, 0xa2, 0xde, 0xed, 0x4d, 0x24, 0xfa, 0x36, 0x42, 0xbb, 0x57, 0x2e, 0x97, 0x6e, 0xa6, 0xd8, 0xae, 0x65, 0x3e, 0x78, 0xb3, 0xfb, 0x0, 0x2, 0x9a, 0xcf, 0x65, 0xf1, 0x1, 0xe0, 0x92, 0x2d, 0xe, 0x91, 0x2e, 0xe8, 0x42, 0x9c, 0x39, 0x24, 0x0, 0x29, 0x74, 0x19, 0x37, 0xf5, 0x6f, 0xcd, 0xb1, 0x75, 0x16, 0x99, 0xbc, 0xde, 0x2c, 0x41, 0xe5, 0x3a, 0xb5, 0xf4, 0x60, 0x10, 0xf5, 0x23, 0xc2, 0x14, 0x21, 0xc9, 0x10, 0x63, 0xe2, 0x39, 0x6a, 0xe2, 0x11, 0xf4, 0x6d, 0x27, 0x74, 0xae, 0x14, 0x37, 0x50, 0x37, 0xe8, 0xdd, 0xa8, 0xf3, 0xb1, 0xdd, 0xd, 0xd4, 0xd, 0x7a, 0x37, 0x8f, 0x79, 0xa7, 0xac, 0x3a, 0x11, 0xb8, 0x97, 0x83, 0x4e, 0xf2, 0xec, 0x44, 0xe0, 0x5e, 0xe, 0x3a, 0xc9, 0xbc, 0x13, 0x1, 0xd4, 0xa7, 0xe9, 0x53, 0x77, 0x69, 0x6d, 0x25, 0x2d, 0x39, 0x2a, 0xee, 0xe, 0xd8, 0x40, 0xb6, 0xb7, 0x60, 0x77, 0xa2, 0xd, 0xa4, 0x76, 0xb, 0x76, 0x27, 0x97, 0x78, 0x9f, 0x94, 0x3a, 0xaa, 0xe9, 0x5d, 0xf9, 0xbb, 0x48, 0xb2, 0xa3, 0x92, 0xde, 0x95, 0xbf, 0x8b, 0xb4, 0x3b, 0xaa, 0x68, 0xe8, 0xb4, 0xf4, 0x1b, 0x39, 0x9, 0xa5, 0x73, 0x8d, 0x7c, 0x52, 0x47, 0xbd, 0x49, 0x6b, 0x12, 0x1d, 0x3a, 0xda, 0xf5, 0x4d, 0xd8, 0xdb, 0x94, 0x4a, 0x77, 0xa4, 0x8d, 0x61, 0x6f, 0x53, 0x2a, 0xdd, 0x55, 0x2a, 0x28, 0xfa, 0xf6, 0x76, 0x15, 0x8e, 0x97, 0x77, 0x33, 0x81, 0x7b, 0x38, 0x88, 0x49, 0xf3, 0xd6, 0xfc, 0xdb, 0xdb, 0x3b, 0xd1, 0xdd, 0xe5, 0x77, 0x69, 0xdf, 0xe, 0x9d, 0xe8, 0xfe, 0x16, 0xc0, 0x75, 0xc0, 0xdf, 0xbd, 0x22, 0xe7, 0x3b, 0x17, 0xff, 0x89, 0x36, 0x2f, 0x7, 0x7e, 0x2, 0x7c, 0x64, 0xf7, 0xca, 0xd5, 0x66, 0x15, 0xb6, 0xcd, 0x4f, 0xed, 0x50, 0x3a, 0x79, 0x1e, 0xdc, 0xac, 0x26, 0xd6, 0x47, 0x88, 0x69, 0xb6, 0xe5, 0xf1, 0xba, 0xa1, 0xb8, 0xf, 0x91, 0x8d, 0xc0, 0xfe, 0x4d, 0xf9, 0x52, 0x63, 0x5f, 0x2f, 0x7c, 0x6c, 0x40, 0x58, 0xed, 0x75, 0x23, 0xc3, 0x56, 0xc, 0xcf, 0x2f, 0xbf, 0x87, 0x94, 0x1f, 0x3b, 0x84, 0xa0, 0x49, 0xab, 0x18, 0x75, 0x7d, 0xf7, 0xe7, 0x33, 0x2e, 0x50, 0x34, 0xe, 0x2e, 0x9d, 0xad, 0xa3, 0x8c, 0x6e, 0x25, 0xdb, 0x73, 0xa3, 0x60, 0x6d, 0x66, 0xfc, 0xf, 0x72, 0x22, 0x60, 0x32, 0x99, 0x10, 0x84, 0x70, 0x11, 0x3e, 0x93, 0x22, 0xa4, 0x39, 0x34, 0xe1, 0xfa, 0x12, 0x2, 0x52, 0x78, 0xbe, 0x5c, 0x6f, 0x3e, 0xce, 0xdc, 0x99, 0xf4, 0xab, 0x65, 0x8f, 0x93, 0xed, 0xdd, 0x12, 0x81, 0xc, 0x25, 0xf4, 0x76, 0xb2, 0x37, 0xf7, 0xbd, 0x13, 0x2, 0x52, 0x78, 0x84, 0xec, 0x13, 0x47, 0x68, 0x17, 0xf7, 0x51, 0x7f, 0xb5, 0xf8, 0x71, 0xb2, 0x9e, 0xf8, 0x35, 0x8b, 0xe4, 0x23, 0x21, 0x28, 0xad, 0xb7, 0x6b, 0x1, 0x79, 0xf9, 0x39, 0x21, 0x20, 0x8e, 0x74, 0xb3, 0xec, 0xe3, 0x11, 0x86, 0x22, 0xa4, 0x5f, 0x2d, 0x78, 0x84, 0xa6, 0x2f, 0x75, 0xc5, 0x5c, 0x42, 0xea, 0x90, 0xd0, 0xdb, 0x89, 0xdc, 0x5c, 0xfd, 0x4d, 0x88, 0x46, 0xe1, 0xdd, 0x2a, 0xf8, 0x44, 0xe4, 0xa4, 0x38, 0xf5, 0x57, 0xcb, 0x1e, 0x27, 0xeb, 0xdb, 0x7b, 0xc5, 0x62, 0x42, 0xfc, 0x1e, 0xad, 0xb7, 0x6b, 0x1, 0x7d, 0xb, 0x36, 0xe5, 0x12, 0x5, 0xda, 0xad, 0xf2, 0x4f, 0xc4, 0x84, 0x8a, 0x12, 0x7f, 0xbd, 0xbb, 0xc5, 0xa8, 0xfa, 0x16, 0x5f, 0x31, 0x98, 0x90, 0xbe, 0x4b, 0xea, 0x2d, 0x84, 0x5f, 0xee, 0x96, 0xe5, 0x1a, 0x8e, 0x4b, 0x53, 0x17, 0x8, 0xd5, 0x19, 0x53, 0x1b, 0xc3, 0x33, 0xb, 0xef, 0x91, 0xfa, 0x44, 0x7b, 0x41, 0x8a, 0x3a, 0x8f, 0x17, 0x20, 0x8a, 0x4, 0x24, 0xbd, 0x12, 0xa1, 0xa8, 0x10, 0x80, 0xbc, 0x92, 0x8a, 0x0, 0xf8, 0x7b, 0x41, 0x7, 0x5b, 0x9b, 0x62, 0xc9, 0xc6, 0x6a, 0xe7, 0x56, 0x46, 0x93, 0xcb, 0x16, 0xe6, 0xe1, 0x6, 0x35, 0x60, 0x86, 0x21, 0x9b, 0x6c, 0x8c, 0xc8, 0x85, 0x5d, 0x9f, 0xc, 0x2a, 0x30, 0x9a, 0x2f, 0xbf, 0x3d, 0x5d, 0xbc, 0x47, 0x93, 0x67, 0xf3, 0xe1, 0x78, 0xf6, 0x23, 0x82, 0x3d, 0x5d, 0x7e, 0x9b, 0xf8, 0xc8, 0x8f, 0x1c, 0xf3, 0x4b, 0x59, 0xb3, 0x31, 0x78, 0xb5, 0x37, 0x41, 0xa1, 0x60, 0x8, 0xd9, 0x51, 0xf8, 0x46, 0xf0, 0x38, 0x7b, 0xa3, 0x68, 0xe0, 0x99, 0x2c, 0xbb, 0x27, 0x5a, 0xf5, 0xbf, 0xce, 0x4c, 0x93, 0xfc, 0x18, 0x88, 0xeb, 0xb5, 0xdb, 0x61, 0xbc, 0x40, 0x51, 0x32, 0xff, 0xa0, 0xb6, 0xc7, 0x75, 0x45, 0xc, 0x7e, 0xb4, 0x14, 0xfe, 0x64, 0x32, 0xc, 0x9c, 0x18, 0x20, 0xc9, 0xd8, 0x7f, 0x20, 0x88, 0x2a, 0x8c, 0x25, 0x3a, 0x1e, 0xce, 0xbc, 0x68, 0xa2, 0x8f, 0x59, 0x86, 0x87, 0xd1, 0x56, 0x16, 0x40, 0x5c, 0xad, 0x84, 0x6f, 0x56, 0x6f, 0xaa, 0x9a, 0x75, 0x95, 0xbc, 0xa8, 0x8f, 0xdb, 0xe2, 0xa7, 0xc3, 0xb1, 0x58, 0x55, 0xed, 0xb7, 0x9f, 0xc7, 0xd9, 0x7b, 0x55, 0xb2, 0xbe, 0x2e, 0x27, 0x7f, 0x60, 0x47, 0xcc, 0x3b, 0x84, 0x9e, 0xc5, 0xb, 0x99, 0xb1, 0x42, 0x96, 0x67, 0xd6, 0x76, 0x7b, 0x1d, 0xe0, 0xd0, 0xf4, 0x1b, 0x2f, 0xbb, 0x6d, 0x55, 0x1e, 0x25, 0xcd, 0xbe, 0xe1, 0x6d, 0x2, 0xe, 0x1d, 0x8f, 0x65, 0xc1, 0xda, 0x73, 0xa5, 0x6f, 0xa, 0xef, 0xe, 0xeb, 0xa2, 0x1e, 0xf0, 0x87, 0x8b, 0x2e, 0xe1, 0x55, 0x6e, 0xe, 0x73, 0x42, 0xf9, 0xfa, 0xdd, 0x74, 0x61, 0xfa, 0x86, 0x78, 0x59, 0x5b, 0x75, 0xc, 0xfd, 0x36, 0xb8, 0x3d, 0x58, 0x2e, 0x7b, 0x8a, 0xbe, 0x2b, 0x38, 0xca, 0x66, 0x96, 0x23, 0x4d, 0x71, 0xd0, 0xac, 0x4e, 0xcc, 0xfa, 0xf0, 0x5a, 0xb5, 0x87, 0xf3, 0x6a, 0xbb, 0x38, 0x9c, 0x5b, 0xde, 0x3c, 0xe2, 0xf6, 0x39, 0x67, 0x64, 0xb8, 0x29, 0xd6, 0xcc, 0xa, 0x48, 0x86, 0xd7, 0x55, 0x51, 0x1f, 0x5e, 0x2e, 0x4e, 0x9c, 0x31, 0xfe, 0x7c, 0x9a, 0x34, 0x4c, 0xcc, 0xe8, 0x94, 0x4c, 0xcb, 0x6, 0xac, 0x1f, 0xbd, 0x5f, 0xc, 0x76, 0x4d, 0x1c, 0x7e, 0x88, 0x82, 0xa3, 0x59, 0xc3, 0x30, 0x67, 0x1, 0x47, 0xbd, 0xe1, 0x44, 0xc5, 0x27, 0xd, 0x63, 0x9c, 0xc2, 0xa2, 0x5d, 0x3c, 0x80, 0x84, 0x63, 0x68, 0xa1, 0x54, 0xfb, 0x9b, 0x44, 0x92, 0xc5, 0xe4, 0x91, 0x45, 0x84, 0x91, 0x51, 0x92, 0xe0, 0xfa, 0x6f, 0x95, 0x48, 0x31, 0x63, 0x74, 0x69, 0xf0, 0x55, 0x6b, 0x8a, 0x49, 0xf9, 0x26, 0x63, 0xac, 0xba, 0x5c, 0x87, 0x1e, 0x3, 0xbc, 0x44, 0xaf, 0x9e, 0x50, 0x50, 0xd7, 0xf8, 0x45, 0x36, 0xf5, 0xe, 0x12, 0x92, 0xef, 0x4d, 0xec, 0x1a, 0x7e, 0x6f, 0x81, 0x47, 0xe3, 0x7e, 0xf2, 0xae, 0x24, 0xf8, 0xd7, 0x16, 0x8, 0x1c, 0x24, 0xc0, 0xd8, 0xaa, 0xae, 0x8e, 0xb9, 0x35, 0xe7, 0xae, 0x45, 0xf6, 0x61, 0x7e, 0x67, 0x10, 0x84, 0xf8, 0xed, 0x82, 0xcb, 0x9d, 0x3d, 0x70, 0x9a, 0x21, 0x92, 0xca, 0xb2, 0x80, 0xbe, 0xe8, 0x75, 0x17, 0x65, 0x88, 0xf8, 0x4d, 0x4, 0xcc, 0x3e, 0x59, 0x1d, 0x30, 0xd9, 0xaa, 0xbd, 0xc9, 0x34, 0x9c, 0xd1, 0x56, 0x4d, 0x65, 0x53, 0x8f, 0xfd, 0xb9, 0x61, 0x6f, 0xad, 0x43, 0x1b, 0xcd, 0x87, 0xd3, 0x89, 0x6d, 0x7c, 0x89, 0xad, 0x83, 0xbd, 0x82, 0xc5, 0x27, 0x1e, 0xe1, 0x55, 0x23, 0xc1, 0x5b, 0x15, 0xc1, 0xdd, 0x16, 0x1d, 0xad, 0xd8, 0xb0, 0x2d, 0x6e, 0x93, 0x4, 0xba, 0x64, 0x9c, 0x12, 0xd0, 0x3c, 0xef, 0xde, 0x83, 0xf0, 0xa5, 0x20, 0xea, 0xa2, 0x8a, 0xde, 0xd, 0x71, 0xc5, 0xab, 0x63, 0xf, 0xfc, 0x2f, 0x27, 0xf6, 0x70, 0x18, 0x37, 0x21, 0x43, 0xf2, 0xe9, 0x5, 0x26, 0x94, 0x84, 0xc, 0x9b, 0x1e, 0xe6, 0x11, 0xfe, 0xf8, 0xc1, 0x7e, 0xba, 0x4f, 0x4d, 0xe9, 0x1c, 0xd2, 0xe0, 0xf2, 0xe8, 0x31, 0x3b, 0x66, 0x55, 0xce, 0xa7, 0x92, 0x18, 0xe9, 0xc, 0x9e, 0xd8, 0xff, 0x18, 0xb3, 0xb2, 0x47, 0xce, 0x78, 0x85, 0x95, 0x20, 0xc5, 0xb7, 0x71, 0x9, 0x92, 0x9e, 0x7d, 0xc, 0x32, 0x8, 0x84, 0xed, 0xf4, 0x78, 0x9, 0x9a, 0xf3, 0xd0, 0x20, 0xba, 0x83, 0x8b, 0x48, 0xe4, 0xd0, 0x38, 0xe8, 0x5e, 0x8e, 0xf6, 0xc6, 0x99, 0xba, 0x70, 0x12, 0xed, 0x8e, 0x4, 0x92, 0x11, 0xc1, 0x4e, 0xf1, 0x31, 0x11, 0x21, 0x4a, 0x10, 0xde, 0x9f, 0x9e, 0xc6, 0x80, 0xf7, 0x5a, 0xf3, 0xfd, 0x24, 0xf1, 0x87, 0xed, 0xe1, 0x50, 0xb7, 0xd5, 0x11, 0x91, 0x9c, 0xed, 0x6a, 0x8f, 0x99, 0x37, 0xfc, 0x15, 0xa3, 0x90, 0x4d, 0xb1, 0xab, 0xea, 0x6f, 0xf9, 0x7f, 0x16, 0xed, 0xa1, 0xff, 0xee, 0x3f, 0xca, 0xfa, 0x73, 0xc9, 0x23, 0x84, 0xf4, 0xfe, 0x5a, 0x9e, 0xcb, 0x77, 0x7d, 0xf3, 0xbb, 0xff, 0x6f, 0x27, 0x26, 0xae, 0x7e, 0xc3, 0x2c, 0xd5, 0xa0, 0x29, 0x4f, 0xd5, 0x26, 0xf6, 0x14, 0xc0, 0x34, 0xb, 0xf4, 0x7c, 0xd1, 0xa1, 0xe7, 0xaa, 0x3a, 0x38, 0x5d, 0xf6, 0x9, 0x47, 0x7f, 0x82, 0xf8, 0x4c, 0x37, 0x9c, 0xce, 0x37, 0x1, 0xa3, 0xce, 0x99, 0xc, 0x70, 0xae, 0x51, 0x65, 0x74, 0x15, 0x2f, 0x18, 0xbd, 0xfb, 0x76, 0x9d, 0x45, 0x56, 0x31, 0x53, 0x0, 0xe9, 0x8, 0x65, 0x11, 0xee, 0xc5, 0xe9, 0x13, 0x34, 0x65, 0xd6, 0x22, 0x6e, 0xc, 0xf7, 0x71, 0xe6, 0x3f, 0xb6, 0xf0, 0x31, 0x15, 0x4e, 0xb5, 0xe3, 0xbb, 0x36, 0xcc, 0x92, 0x86, 0x3, 0x54, 0xcd, 0x46, 0x71, 0x3a, 0x1d, 0xbe, 0x20, 0x2a, 0xe3, 0xc5, 0x7e, 0xcd, 0xe8, 0xf8, 0xc3, 0xa, 0x20, 0x43, 0xbe, 0x8, 0x6f, 0xe6, 0x34, 0x4b, 0xcf, 0x2b, 0xca, 0x75, 0x3, 0x33, 0x36, 0x29, 0x71, 0x24, 0x6, 0x2e, 0xc7, 0xa9, 0x3e, 0x2e, 0x9f, 0x54, 0xe8, 0x39, 0x37, 0x80, 0xa0, 0x8f, 0x0, 0x65, 0x9, 0x1a, 0x64, 0x81, 0xe6, 0x81, 0x2, 0x3f, 0x44, 0xcc, 0xeb, 0xca, 0x14, 0x64, 0x13, 0xb5, 0x7c, 0xcb, 0x32, 0xd1, 0xf2, 0xc4, 0x76, 0x7, 0x93, 0xa5, 0xf3, 0xd0, 0x93, 0xec, 0xa, 0x64, 0x49, 0x4e, 0x69, 0xf2, 0x54, 0x10, 0x56, 0x1e, 0x26, 0x53, 0x5d, 0x9c, 0xf6, 0xed, 0xc9, 0xf2, 0x32, 0x5d, 0xe2, 0x2, 0x9c, 0x3c, 0x40, 0x8b, 0x93, 0x2, 0xc2, 0xa, 0xec, 0xac, 0x32, 0x41, 0x61, 0xce, 0x72, 0x1, 0x56, 0xdc, 0x80, 0xaa, 0x24, 0xa2, 0x35, 0x78, 0x25, 0xef, 0x28, 0x93, 0x6c, 0xc8, 0x50, 0x6b, 0xee, 0x2f, 0xf3, 0x78, 0x38, 0x8a, 0xd9, 0x5f, 0x62, 0xe1, 0xc0, 0x7a, 0x88, 0xb9, 0xf5, 0x10, 0xc2, 0x9e, 0x0, 0xb, 0xf5, 0x38, 0x87, 0x73, 0x79, 0x6d, 0xf0, 0xdf, 0xc0, 0x79, 0xcc, 0xd2, 0xce, 0xc3, 0x79, 0x4f, 0x53, 0x5a, 0x41, 0x11, 0xa3, 0x9a, 0x1c, 0x62, 0xbf, 0x76, 0x94, 0xfb, 0xfa, 0x21, 0xba, 0x7e, 0x8b, 0xce, 0xf1, 0xf7, 0x63, 0x6c, 0x50, 0x80, 0x20, 0xb9, 0x4f, 0xe2, 0x9c, 0x76, 0x45, 0x6d, 0xda, 0x32, 0x70, 0x76, 0x72, 0x32, 0xa2, 0xa1, 0xa1, 0x7f, 0x73, 0xe1, 0xa1, 0x4b, 0x73, 0xe1, 0xa1, 0x17, 0x73, 0xe0, 0xfe, 0x60, 0xd6, 0x79, 0x8, 0xd5, 0x7b, 0xb4, 0xb0, 0xcb, 0x15, 0x5c, 0x73, 0x10, 0xb1, 0xc7, 0xfe, 0xcf, 0xa3, 0xa9, 0x9b, 0x82, 0xcc, 0xbc, 0xca, 0x2e, 0xb4, 0x88, 0x12, 0xc, 0xc6, 0xf3, 0x50, 0xf4, 0x99, 0xbe, 0xf7, 0x3b, 0x2f, 0x36, 0x2d, 0xaa, 0xf1, 0xee, 0xc8, 0xe7, 0x75, 0x1e, 0xce, 0x2d, 0xd2, 0xbb, 0x55, 0x3b, 0xa, 0x99, 0x54, 0x4c, 0xb9, 0x78, 0xf2, 0x55, 0x1b, 0xf5, 0x8a, 0xee, 0x3b, 0xa7, 0x81, 0x35, 0x61, 0xdc, 0xe4, 0x8d, 0x46, 0x41, 0xa7, 0xd7, 0xd5, 0x89, 0xad, 0xe0, 0x2e, 0x4c, 0x50, 0x34, 0xc8, 0x21, 0x28, 0x4e, 0x71, 0x69, 0x78, 0xea, 0xbd, 0x5b, 0xd8, 0xdd, 0xe1, 0x45, 0xa0, 0x14, 0x5d, 0x59, 0xb0, 0xe7, 0x39, 0xa1, 0x8e, 0xea, 0x2a, 0x3a, 0xbe, 0x4b, 0x56, 0xcd, 0xd1, 0xee, 0x91, 0xe7, 0x35, 0xbc, 0x62, 0xa0, 0xe7, 0x72, 0x57, 0xab, 0x91, 0xc2, 0x90, 0xa, 0xca, 0x2e, 0x22, 0xca, 0x50, 0xc2, 0xc9, 0xba, 0x17, 0x18, 0xd4, 0x4c, 0x12, 0xe9, 0xde, 0x7a, 0xe0, 0xe6, 0xed, 0x22, 0xb1, 0xb8, 0xbd, 0x30, 0xe2, 0x20, 0x8a, 0x43, 0x2a, 0xa7, 0xce, 0x16, 0xd0, 0x4d, 0x97, 0x2a, 0x3f, 0xa8, 0x20, 0x27, 0xe1, 0xb7, 0x9c, 0x7a, 0xc8, 0x24, 0xda, 0x74, 0x52, 0x6a, 0x5e, 0x51, 0x60, 0x14, 0x80, 0x36, 0x1d, 0x28, 0xc, 0xa9, 0x9c, 0xba, 0xcf, 0xdb, 0xbd, 0xc, 0xbb, 0xfc, 0x62, 0x5b, 0x1a, 0x3e, 0xf5, 0xa5, 0x43, 0x23, 0x3e, 0xdb, 0x34, 0x59, 0x6c, 0x3f, 0x81, 0x24, 0x5f, 0xc4, 0x96, 0x58, 0xdc, 0x9f, 0xb3, 0x89, 0x2c, 0xcc, 0xa8, 0x93, 0x34, 0xda, 0xaa, 0x2e, 0x8b, 0xd3, 0xa6, 0xfa, 0xaa, 0x71, 0xcc, 0x6f, 0x83, 0xe0, 0x3e, 0xbb, 0x64, 0xf0, 0xbc, 0xe4, 0x0, 0x3d, 0x40, 0x34, 0x28, 0xeb, 0x7a, 0xb0, 0x3d, 0x9c, 0xaa, 0xdf, 0x38, 0xa0, 0xee, 0xad, 0xd, 0xc9, 0x20, 0x5d, 0x67, 0xe0, 0x8b, 0x6b, 0x10, 0x24, 0x13, 0x1c, 0x99, 0xc4, 0x50, 0x34, 0x19, 0xb8, 0x20, 0xa0, 0xf3, 0x39, 0x69, 0x1a, 0x71, 0x5f, 0x7c, 0xd6, 0x70, 0xfe, 0x9, 0x92, 0xf9, 0xaa, 0x80, 0xde, 0xc, 0x2, 0x28, 0x4e, 0xb2, 0x87, 0x2e, 0x57, 0x65, 0x3c, 0x64, 0x95, 0xe8, 0xa2, 0xba, 0x38, 0x6, 0x28, 0x5e, 0xd7, 0xd4, 0x30, 0xf9, 0xc3, 0x82, 0xf4, 0x6e, 0x94, 0x85, 0x9b, 0x14, 0x8d, 0x64, 0x14, 0x56, 0x7e, 0xfa, 0x2f, 0xa6, 0x33, 0xe5, 0x75, 0xc2, 0x7b, 0xde, 0xa0, 0x84, 0x9e, 0x7a, 0x5, 0xaa, 0x94, 0xd0, 0x1c, 0xb2, 0xdd, 0x3b, 0xb4, 0x29, 0xd6, 0x7c, 0xa0, 0xc9, 0x88, 0xa6, 0x41, 0x1b, 0xc1, 0x95, 0xba, 0x23, 0xe7, 0x50, 0xa8, 0x40, 0x90, 0xca, 0x8, 0xf0, 0x4a, 0xf3, 0xc8, 0xa5, 0xdb, 0xeb, 0x50, 0xce, 0x85, 0xd5, 0xda, 0x92, 0xeb, 0xe1, 0x3b, 0xbc, 0xae, 0x5, 0x3, 0xbb, 0x82, 0xdd, 0x9a, 0x3f, 0x54, 0xbb, 0xe3, 0xe1, 0xd4, 0x16, 0xc2, 0x16, 0x99, 0x48, 0xae, 0xf6, 0x69, 0x14, 0x8, 0xdf, 0x56, 0xeb, 0xd2, 0xd9, 0x98, 0x80, 0xc0, 0x66, 0xcb, 0xcc, 0xa4, 0xc3, 0x15, 0x84, 0x56, 0xfb, 0xcf, 0x95, 0x7c, 0x6c, 0x4a, 0xfc, 0x5b, 0xd5, 0x7c, 0xbd, 0x43, 0xef, 0x78, 0x88, 0x91, 0xae, 0x20, 0xce, 0x47, 0x54, 0x79, 0xf6, 0x21, 0xeb, 0x15, 0xb, 0xc4, 0x29, 0xf8, 0x5b, 0x43, 0xc1, 0x80, 0x2b, 0x1c, 0xca, 0xf0, 0x5, 0x0, 0x59, 0xc, 0xc9, 0x78, 0xb1, 0x61, 0x4a, 0xe5, 0x2d, 0xe8, 0x5e, 0xff, 0xcc, 0xd7, 0xeb, 0x3f, 0x57, 0xe5, 0x17, 0x8e, 0xa6, 0x56, 0x9f, 0xd6, 0xe5, 0xe7, 0x6a, 0x55, 0x4a, 0xa3, 0x7b, 0x1d, 0xaa, 0xfa, 0xc, 0xea, 0x97, 0x3e, 0xf8, 0x96, 0xad, 0xe3, 0xa4, 0xc8, 0x17, 0x27, 0x91, 0x24, 0x1f, 0x77, 0xb7, 0x86, 0xdf, 0x21, 0x34, 0xa0, 0x64, 0x92, 0x7c, 0xdc, 0xe3, 0xa9, 0xda, 0xb7, 0xde, 0x4f, 0x14, 0x27, 0x20, 0x9, 0x53, 0xfd, 0x1c, 0xcd, 0xe, 0x7e, 0x87, 0xd0, 0x80, 0x98, 0x49, 0xf2, 0x71, 0xbf, 0x36, 0xf0, 0x3b, 0x84, 0x6, 0x94, 0x4c, 0x92, 0xa7, 0xfd, 0x5e, 0x5b, 0x9a, 0x85, 0x44, 0x33, 0x93, 0x7b, 0x9c, 0x3f, 0x8a, 0x85, 0x44, 0x4b, 0x88, 0xd4, 0x51, 0x61, 0x9e, 0x30, 0x44, 0x69, 0xb7, 0xda, 0x13, 0x9, 0x1b, 0xb0, 0xfe, 0xa, 0x9, 0xad, 0x61, 0x45, 0xdb, 0x2d, 0x9d, 0x8f, 0x87, 0x3a, 0x6, 0x19, 0x3b, 0xf1, 0x8f, 0xf5, 0xff, 0x9b, 0x69, 0x48, 0x61, 0x7a, 0x8f, 0xa2, 0xde, 0x49, 0xc5, 0x63, 0x8, 0x26, 0xa2, 0x14, 0xbd, 0x5, 0x6a, 0xf5, 0x7e, 0xa3, 0x29, 0xe7, 0xe9, 0x69, 0xe4, 0x94, 0xd3, 0xec, 0x3a, 0xb6, 0x18, 0x40, 0xc, 0x5a, 0xcc, 0x87, 0xd1, 0x2d, 0xc6, 0x94, 0x1c, 0xb4, 0x58, 0x90, 0x8f, 0x6c, 0xb1, 0x9b, 0x6b, 0xd5, 0xb9, 0x1d, 0x6f, 0xa7, 0xdc, 0xbd, 0x75, 0xef, 0xa5, 0x7d, 0x77, 0x9b, 0xcb, 0x85, 0x7d, 0xbf, 0x9c, 0xd1, 0x88, 0x6f, 0x75, 0x80, 0x82, 0x76, 0xeb, 0x8e, 0x8d, 0xe, 0x10, 0x83, 0x46, 0xf7, 0x61, 0x74, 0xa3, 0x33, 0xcb, 0xb, 0x1a, 0x3d, 0xc8, 0x97, 0x6e, 0xf4, 0xce, 0xd5, 0xba, 0xbd, 0xd5, 0xbb, 0x93, 0xbe, 0xa3, 0xd9, 0x6f, 0x25, 0x7e, 0x77, 0xbb, 0x8f, 0xc4, 0xa2, 0x3f, 0x20, 0x59, 0xbf, 0x74, 0x6c, 0x61, 0x80, 0x18, 0xb4, 0xb0, 0xf, 0xa3, 0x5b, 0x98, 0x79, 0x69, 0xd0, 0xc2, 0x41, 0xbe, 0x74, 0xb, 0x23, 0x15, 0xb8, 0xbd, 0x2d, 0x31, 0x22, 0x77, 0xb4, 0x1a, 0x4d, 0xe6, 0xd6, 0xf6, 0x9, 0xac, 0xbb, 0x1c, 0x2b, 0x41, 0x4f, 0xe5, 0xb9, 0xd8, 0x9b, 0x6d, 0x87, 0xa2, 0x8, 0x2c, 0x69, 0x9a, 0x62, 0x42, 0x2d, 0x15, 0x49, 0xd0, 0x4f, 0xd3, 0x24, 0x8d, 0xcc, 0x54, 0x66, 0xa0, 0x2, 0x44, 0x66, 0x31, 0x14, 0xba, 0xb8, 0x23, 0xa3, 0x8e, 0x3a, 0xeb, 0xe2, 0x6, 0x6a, 0x8b, 0x80, 0x69, 0xcd, 0x95, 0x63, 0x39, 0xa0, 0xbc, 0x58, 0x6e, 0x42, 0x7f, 0xb1, 0x2a, 0x74, 0xd4, 0x5a, 0x34, 0x6b, 0x57, 0x5d, 0x8d, 0x64, 0xbe, 0x4d, 0x43, 0x15, 0x21, 0xd5, 0x66, 0x6e, 0xcd, 0xfd, 0x66, 0x53, 0x53, 0x2c, 0x6c, 0xdb, 0x5a, 0xce, 0x16, 0x82, 0xdf, 0x62, 0x82, 0x20, 0xf, 0x99, 0xd9, 0x95, 0xdc, 0xb1, 0x7a, 0xd6, 0x5b, 0xbc, 0xef, 0x22, 0x6f, 0x49, 0xe8, 0x13, 0x9f, 0xe8, 0xa9, 0xfe, 0x85, 0xb7, 0x7a, 0xa4, 0xb2, 0xb2, 0x9, 0x4f, 0x79, 0xe2, 0xb7, 0x50, 0x3a, 0x64, 0xd5, 0x11, 0xd9, 0xf9, 0x41, 0x3, 0xef, 0x91, 0x79, 0x39, 0x5d, 0x56, 0x7c, 0x90, 0x71, 0xfe, 0xf5, 0xd3, 0x2, 0x1c, 0x97, 0x8f, 0xd2, 0xe5, 0xc3, 0xed, 0x17, 0xaf, 0x56, 0xe2, 0xb8, 0x45, 0x40, 0x5f, 0xcc, 0xaa, 0xd4, 0x95, 0x84, 0xbe, 0xf3, 0xcb, 0x3d, 0x4d, 0x67, 0x1e, 0x56, 0x16, 0xb3, 0x30, 0x79, 0x80, 0xbe, 0xef, 0xfc, 0x72, 0xf1, 0xf5, 0x1b, 0x75, 0x72, 0xeb, 0x56, 0x9c, 0x7e, 0xed, 0xc3, 0x1f, 0x1e, 0x75, 0xf5, 0xe0, 0x8e, 0x40, 0x50, 0x27, 0x95, 0xfb, 0xce, 0x2f, 0x2f, 0x56, 0xab, 0x7a, 0x17, 0x4a, 0x60, 0xf0, 0x83, 0xe5, 0x7d, 0xfb, 0xe9, 0xf1, 0xa1, 0x9f, 0x2d, 0x63, 0x53, 0x6e, 0x7d, 0xe2, 0x25, 0xba, 0xfc, 0x67, 0xa2, 0x87, 0xee, 0xca, 0xfd, 0xf9, 0x2, 0xb5, 0xc4, 0xec, 0x4, 0x74, 0x54, 0x31, 0x8f, 0x96, 0x78, 0x22, 0xde, 0x6b, 0x94, 0x5, 0xda, 0xde, 0x62, 0x11, 0x62, 0x28, 0x4f, 0x76, 0xf9, 0xc1, 0x4c, 0x6f, 0x2f, 0x5b, 0x55, 0xda, 0xd7, 0x71, 0x19, 0xf9, 0x40, 0x46, 0x2f, 0x74, 0x77, 0x32, 0x14, 0xac, 0x57, 0xf0, 0x47, 0x22, 0x7e, 0xe2, 0x1c, 0xbd, 0xef, 0x7, 0x29, 0x17, 0x7f, 0xc3, 0x1e, 0x6c, 0xcf, 0x33, 0xd5, 0x2c, 0x4f, 0xbc, 0x63, 0x6b, 0x4a, 0xae, 0x20, 0x7a, 0x45, 0x1f, 0x4f, 0x46, 0x1f, 0xd6, 0x30, 0x34, 0x4, 0x70, 0x77, 0x6e, 0xcb, 0x75, 0x3f, 0x48, 0xf1, 0xdf, 0x5c, 0x0, 0x51, 0x11, 0xe4, 0x85, 0xdd, 0x7e, 0x90, 0xb4, 0x35, 0x49, 0xf6, 0x5a, 0x71, 0x98, 0x64, 0xb1, 0xec, 0xe5, 0xdf, 0x30, 0x69, 0xdb, 0xf, 0xb, 0xc, 0xcb, 0xb, 0x8b, 0xb, 0x4b, 0xb, 0xb, 0xb, 0xca, 0xa2, 0x4f, 0xda, 0x57, 0xfb, 0xe3, 0x99, 0xf9, 0xa, 0x26, 0x15, 0xf6, 0x5b, 0x47, 0x90, 0xfd, 0x61, 0xbc, 0x9c, 0x94, 0x33, 0x7e, 0x52, 0x77, 0x5b, 0xae, 0x7e, 0x65, 0x6a, 0xd2, 0xab, 0x8b, 0x65, 0x59, 0xf7, 0x87, 0xdb, 0xb2, 0x3e, 0xea, 0xb9, 0x37, 0xdf, 0x9b, 0x3a, 0x28, 0x80, 0xf8, 0x3b, 0xa9, 0xa7, 0xa2, 0xac, 0x41, 0xb1, 0x5e, 0xf3, 0x80, 0x95, 0xf2, 0x87, 0x5c, 0xd5, 0x13, 0x49, 0x5e, 0xc8, 0xe9, 0xe1, 0xb6, 0x68, 0x6c, 0x8, 0x70, 0xbe, 0x44, 0x77, 0x3a, 0xd4, 0x3, 0xcd, 0x7, 0x84, 0x89, 0x45, 0x38, 0x8d, 0xb0, 0x29, 0xcb, 0x35, 0xb7, 0x76, 0x1e, 0x8e, 0x65, 0xdc, 0x37, 0x7, 0xe, 0x5a, 0xc8, 0x14, 0xe8, 0xcc, 0x12, 0xb7, 0x3c, 0x9d, 0xe, 0x27, 0x94, 0x21, 0x5, 0x89, 0xb0, 0xa3, 0x30, 0x42, 0x66, 0xb4, 0x2d, 0x3, 0x48, 0x1d, 0x58, 0x31, 0xef, 0xb, 0x20, 0xcc, 0x18, 0x58, 0x84, 0x1d, 0x83, 0x13, 0x32, 0xa4, 0x4d, 0xb1, 0x83, 0x96, 0x60, 0x9, 0x96, 0xa4, 0xcf, 0x58, 0x13, 0x72, 0x81, 0x60, 0x94, 0x53, 0x88, 0x80, 0x36, 0xb4, 0x44, 0xe8, 0x6e, 0xda, 0x98, 0x8f, 0xed, 0x9, 0xf3, 0xc8, 0xc3, 0x29, 0x83, 0x1f, 0xba, 0x20, 0x98, 0xa4, 0x7c, 0x26, 0x79, 0x7f, 0x84, 0xe1, 0xe, 0x8e, 0x55, 0x5d, 0x37, 0xc2, 0x3c, 0x8b, 0xbc, 0x3, 0xd6, 0xe5, 0xf4, 0x4f, 0xb1, 0x52, 0xdb, 0x2b, 0x7c, 0x7d, 0x6, 0x7d, 0x4, 0x76, 0xa, 0xf1, 0xac, 0x78, 0x5f, 0xfe, 0x3, 0x1f, 0x19, 0xd7, 0x49, 0xc5, 0x5, 0x5e, 0x7, 0x94, 0x27, 0x29, 0xcd, 0xe9, 0xaf, 0x69, 0xe4, 0x48, 0xbb, 0x46, 0x1a, 0xa9, 0x7b, 0x7, 0x5d, 0x45, 0x55, 0x50, 0xaf, 0xcf, 0x14, 0xf1, 0xe7, 0x67, 0x8a, 0xf8, 0xfb, 0x33, 0x50, 0x55, 0x52, 0x4f, 0x47, 0x5c, 0x6e, 0x7f, 0x8c, 0xe3, 0xae, 0xb7, 0x29, 0x6e, 0x78, 0x23, 0xc3, 0xd, 0xce, 0x7f, 0xb9, 0xfd, 0xb9, 0x83, 0xbb, 0xa2, 0xff, 0xdf, 0xf0, 0xa, 0x81, 0x13, 0xa5, 0xfe, 0x72, 0x73, 0xc0, 0xff, 0x7b, 0x82, 0xe0, 0x93, 0x91, 0xf8, 0xd5, 0x6d, 0x73, 0xc7, 0x3a, 0xc4, 0xef, 0x46, 0x53, 0xe7, 0x20, 0xbc, 0x3e, 0xd4, 0x6e, 0xcf, 0xbb, 0xe5, 0xbe, 0xa8, 0xea, 0x4b, 0xea, 0xf4, 0x38, 0xb8, 0x34, 0x1, 0x2e, 0x61, 0x4, 0xb9, 0xe0, 0xc1, 0x92, 0xf9, 0x7b, 0xf7, 0x88, 0x6e, 0xdf, 0x3d, 0xf3, 0x9c, 0x38, 0xab, 0x1, 0x67, 0x8, 0xf0, 0x2e, 0xbe, 0x73, 0x30, 0x4, 0x32, 0xf7, 0xff, 0x0, 0x50, 0x53, 0x8f, 0xd6, 0x78, 0x8a, 0x1, 0x0, 0x0, 0x1f, 0x8b, 0x8, 0x0, 0x0, 0x0, 0x0, 0x0, 0x2, 0x3, 0xbd, 0x5a, 0x7b, 0x6f, 0xe3, 0x36, 0x12, 0xff, 0x5b, 0x5, 0xfa, 0x1d, 0x58, 0xef, 0x16, 0x92, 0x2f, 0xb2, 0xe4, 0xb8, 0x9b, 0xeb, 0xc1, 0x59, 0x2f, 0xd0, 0xcb, 0x6e, 0xd0, 0x16, 0xed, 0x66, 0x6f, 0x13, 0xe0, 0x70, 0x58, 0x2c, 0x16, 0xb4, 0x44, 0xdb, 0x6c, 0x64, 0x49, 0xa0, 0xe8, 0x3c, 0x10, 0xf8, 0xbb, 0x1f, 0x87, 0xf, 0x89, 0x7a, 0xc5, 0xce, 0xab, 0x6, 0xe2, 0x58, 0xd4, 0xcc, 0x6f, 0x86, 0x43, 0xce, 0x70, 0x66, 0xa4, 0xd7, 0xde, 0x62, 0x93, 0x46, 0x9c, 0x66, 0xa9, 0x37, 0xbc, 0xfb, 0xfe, 0xbb, 0xef, 0xbf, 0x73, 0xae, 0x30, 0x43, 0x45, 0x84, 0xd3, 0x94, 0xa6, 0x4b, 0x34, 0x43, 0xe3, 0x63, 0x31, 0x66, 0xd, 0x7f, 0x26, 0xc5, 0x26, 0xe1, 0xb3, 0x74, 0x93, 0x24, 0xc7, 0x92, 0xde, 0xf0, 0xa3, 0x6b, 0xba, 0xa0, 0x27, 0x59, 0x9a, 0x92, 0x88, 0xff, 0x99, 0xc5, 0x38, 0xf1, 0x68, 0xac, 0x21, 0x1d, 0xba, 0xf0, 0x2c, 0x5e, 0xc9, 0x3c, 0x84, 0x71, 0x87, 0x11, 0xbe, 0x61, 0xa9, 0x2, 0x92, 0x22, 0xd6, 0xc0, 0x29, 0xc4, 0xbe, 0xf6, 0xdc, 0x57, 0x91, 0x2, 0x1b, 0xc9, 0x31, 0x77, 0x78, 0x6c, 0x68, 0x70, 0x2e, 0x8, 0x2a, 0xbc, 0x0, 0xe7, 0x5f, 0x68, 0xfc, 0x55, 0x83, 0x48, 0xe2, 0x60, 0x41, 0xd3, 0x58, 0x20, 0xc8, 0x8b, 0x91, 0xc1, 0xe1, 0x94, 0x27, 0xc4, 0x1d, 0x6, 0x9c, 0xdc, 0x70, 0xcf, 0xd5, 0xaa, 0x22, 0x9e, 0x21, 0xf7, 0x0, 0xe7, 0x41, 0x51, 0x8, 0x7d, 0x8f, 0xb5, 0xb6, 0xe2, 0x9a, 0xa4, 0xd1, 0x6c, 0x36, 0x86, 0x19, 0x38, 0xf7, 0xa2, 0xe6, 0xb8, 0x28, 0xae, 0x33, 0x16, 0xb, 0xe0, 0x15, 0x8d, 0x89, 0xa7, 0x30, 0xee, 0xe3, 0x48, 0x33, 0x9b, 0xa9, 0x58, 0x65, 0xd7, 0x9a, 0x69, 0xb, 0x5f, 0x24, 0x29, 0xc8, 0x43, 0x84, 0x5a, 0xfc, 0xfb, 0xb, 0x2d, 0x35, 0xdd, 0x57, 0xd0, 0x88, 0xa6, 0xf9, 0x86, 0xb, 0xce, 0x2b, 0xb1, 0xb0, 0xae, 0x5b, 0xea, 0x5b, 0x99, 0x3c, 0xc6, 0x1c, 0x7b, 0x2e, 0xce, 0x5d, 0x1f, 0xe7, 0x6, 0xb9, 0xb5, 0x8a, 0x28, 0x28, 0xe1, 0x39, 0x49, 0x79, 0xa0, 0x6f, 0xd6, 0xa7, 0xb1, 0x93, 0xab, 0xd8, 0x44, 0x11, 0x29, 0x8a, 0xba, 0xc5, 0xf7, 0x95, 0x25, 0xb6, 0x75, 0x9d, 0xb1, 0x9a, 0x82, 0xfc, 0xf6, 0xee, 0x40, 0x95, 0x29, 0x67, 0x1b, 0xe2, 0xcf, 0x71, 0x74, 0x19, 0xb3, 0x2c, 0x9f, 0x2e, 0xb0, 0x58, 0x95, 0xad, 0x3d, 0xad, 0x1d, 0x66, 0x5a, 0x64, 0xd1, 0xa6, 0x50, 0x2, 0xb6, 0x6d, 0x37, 0x39, 0x17, 0x9b, 0xd7, 0xf8, 0x9b, 0x63, 0x9c, 0x6d, 0x76, 0x28, 0xd5, 0x9, 0x43, 0xd0, 0xd, 0x31, 0xb9, 0xb7, 0x7d, 0x4, 0xca, 0xa0, 0x9c, 0x65, 0x4b, 0x31, 0x50, 0x18, 0xe1, 0xc0, 0x32, 0x52, 0x14, 0x6d, 0x23, 0xc8, 0x9b, 0x86, 0xc3, 0xb6, 0xac, 0x24, 0x8, 0xf0, 0x5f, 0xf8, 0xc6, 0x83, 0x9f, 0xc8, 0x51, 0xdb, 0xcc, 0xe1, 0xb7, 0x39, 0x99, 0xba, 0x9f, 0xce, 0xce, 0x2f, 0x5c, 0x5f, 0x8d, 0x6c, 0x58, 0x32, 0x75, 0x43, 0x9c, 0xd3, 0x10, 0xb4, 0xd, 0x1, 0xd1, 0xdc, 0x82, 0x65, 0x9e, 0x82, 0x3, 0xfb, 0x70, 0xa5, 0xc6, 0xf4, 0x7a, 0x4c, 0x51, 0x19, 0x4b, 0x80, 0xca, 0xcc, 0xcf, 0xb1, 0xa6, 0x38, 0x3e, 0xae, 0x8d, 0x29, 0x7, 0x16, 0xde, 0xc, 0xf4, 0xd5, 0x2d, 0x6d, 0x2, 0x33, 0x7, 0x6d, 0x4, 0x35, 0x5f, 0x4d, 0xd2, 0xb6, 0x82, 0xed, 0x7, 0xdd, 0x86, 0xa8, 0x6f, 0x7a, 0xe9, 0xe7, 0x20, 0x57, 0xc4, 0x8f, 0x6f, 0x51, 0xb6, 0x49, 0x79, 0xe5, 0xee, 0x6d, 0x1, 0x23, 0xb2, 0xce, 0xf9, 0x6d, 0x4b, 0x4c, 0x8b, 0x8c, 0xe3, 0xb9, 0x8c, 0x31, 0x76, 0x28, 0xd0, 0x8e, 0xed, 0x94, 0xbe, 0xbd, 0x4b, 0x46, 0x9d, 0xb9, 0x57, 0x46, 0x6d, 0x61, 0x3b, 0x8, 0x11, 0x9f, 0x67, 0xf1, 0x2d, 0xe2, 0x4c, 0xd0, 0x32, 0xb2, 0xce, 0xae, 0x0, 0x14, 0x85, 0xa1, 0x14, 0x83, 0x24, 0x4a, 0xc5, 0x1b, 0x86, 0x45, 0xc6, 0x38, 0x32, 0x97, 0xda, 0x30, 0x7a, 0x69, 0x2, 0x88, 0x8f, 0xe2, 0x76, 0x75, 0x58, 0x60, 0x7f, 0x3e, 0xbc, 0x53, 0xd1, 0x1b, 0xcd, 0x3, 0x26, 0x82, 0x27, 0x1a, 0x21, 0xac, 0x7e, 0x6c, 0x6d, 0x9d, 0x16, 0x19, 0xf3, 0xa8, 0x58, 0x77, 0xfa, 0xb6, 0x66, 0xeb, 0x63, 0x7a, 0x70, 0xa0, 0x8d, 0x8d, 0xd4, 0xc7, 0xec, 0xa6, 0xea, 0xb2, 0x8c, 0xf5, 0x9a, 0xf3, 0xb, 0xfd, 0x7a, 0xdc, 0x41, 0xc2, 0x99, 0x3a, 0x2f, 0xde, 0x72, 0xf6, 0x4e, 0x7, 0x26, 0x8b, 0x82, 0xb3, 0x32, 0x32, 0x8d, 0x68, 0xec, 0xfa, 0xd4, 0xd8, 0x15, 0x95, 0x1f, 0xa7, 0x35, 0x20, 0x61, 0xe3, 0x6f, 0x29, 0x5e, 0x13, 0x83, 0x1d, 0x97, 0xd8, 0x36, 0xa1, 0x26, 0x52, 0x47, 0x4a, 0xed, 0x10, 0xe9, 0x24, 0xc3, 0x79, 0x4e, 0xd2, 0xf8, 0x22, 0xf3, 0x38, 0xab, 0x6c, 0xd4, 0x96, 0x1b, 0xad, 0x84, 0xbb, 0x90, 0xa4, 0x14, 0x8d, 0xa2, 0x44, 0xc4, 0x97, 0xd9, 0x0, 0xa4, 0x8c, 0x22, 0x11, 0xcb, 0x8, 0x1b, 0xf4, 0xa9, 0xa3, 0x79, 0x4b, 0x8d, 0xf4, 0x75, 0x7, 0x71, 0x18, 0x5a, 0xe4, 0x7b, 0x6a, 0x26, 0xe, 0xc5, 0x5d, 0x5a, 0xb5, 0x95, 0x32, 0x2b, 0x20, 0x98, 0xe1, 0x70, 0x80, 0x93, 0xb5, 0x43, 0x9d, 0xe2, 0x9a, 0xf2, 0x68, 0xa5, 0x4f, 0x5e, 0xe3, 0x87, 0xd6, 0x7d, 0x27, 0xc2, 0x5, 0x41, 0xe3, 0x69, 0xfb, 0x86, 0xa3, 0x14, 0x53, 0x53, 0x1e, 0x9c, 0x7d, 0xfa, 0xf0, 0x71, 0xd0, 0x81, 0xef, 0x38, 0x73, 0x46, 0xf0, 0xe5, 0x71, 0xf, 0xf0, 0xe1, 0x4e, 0xe0, 0x93, 0x3f, 0xce, 0xce, 0x3f, 0xbc, 0x7f, 0x4, 0xf4, 0xe4, 0xe5, 0xa0, 0x7f, 0x7a, 0x39, 0xe8, 0x37, 0x2f, 0x2, 0x1d, 0x93, 0x5, 0x16, 0xa1, 0xe9, 0x25, 0xb0, 0xb7, 0x5d, 0xee, 0x0, 0x88, 0x7b, 0xee, 0xed, 0x82, 0x2e, 0x53, 0x6c, 0x39, 0xdd, 0xde, 0x5e, 0x27, 0x53, 0x63, 0xc9, 0xfc, 0x2d, 0x8f, 0xe0, 0x34, 0x3b, 0x1c, 0x8f, 0xff, 0x21, 0xf6, 0x31, 0x4, 0xc3, 0x70, 0x72, 0xf4, 0xcf, 0x60, 0x7c, 0x2f, 0x4f, 0x91, 0xe3, 0x54, 0x4b, 0x95, 0x3f, 0xb5, 0xd8, 0x4, 0xcf, 0x49, 0x32, 0x78, 0xf7, 0x36, 0x84, 0xc1, 0x4e, 0xb9, 0x16, 0xbf, 0xb2, 0x5a, 0xa5, 0x44, 0xc0, 0xb3, 0x53, 0x7a, 0x43, 0x44, 0x3e, 0xb7, 0x98, 0xb8, 0xc3, 0x3, 0xf7, 0x47, 0xb7, 0x73, 0xe6, 0x90, 0x97, 0x57, 0x8a, 0xbf, 0x43, 0x3f, 0x8f, 0x87, 0xb6, 0x56, 0x1, 0x8e, 0xe3, 0x13, 0xd0, 0xc6, 0x73, 0xa5, 0x36, 0xa3, 0x32, 0xf1, 0x6a, 0x2b, 0x3, 0x47, 0x1b, 0x6a, 0xe2, 0xbd, 0xd9, 0x81, 0x77, 0x8d, 0x59, 0x2a, 0xf3, 0xb1, 0x1e, 0x3c, 0x6b, 0x42, 0x4d, 0xd6, 0x18, 0xa7, 0x4b, 0xc2, 0xba, 0xa7, 0x55, 0x13, 0x59, 0x2e, 0xbe, 0x59, 0xe1, 0xee, 0xb8, 0xa9, 0xee, 0xed, 0xdc, 0x2b, 0x22, 0x98, 0x95, 0x24, 0x9d, 0xc7, 0x2d, 0xe4, 0x7e, 0x94, 0x15, 0xdc, 0x1b, 0x76, 0xf1, 0x37, 0xcf, 0x1a, 0x6b, 0xcf, 0xea, 0x9f, 0x5b, 0x9d, 0x67, 0x2d, 0x30, 0x4d, 0xa6, 0xcd, 0xda, 0xac, 0x95, 0x4b, 0xfd, 0x9d, 0xe9, 0xd2, 0x7e, 0x19, 0xd1, 0xce, 0x84, 0x48, 0x4f, 0x53, 0xfe, 0x13, 0x99, 0x82, 0x3a, 0xf6, 0xb7, 0xbd, 0xa5, 0xa4, 0x7, 0x47, 0xaa, 0x9f, 0x5f, 0x97, 0xb5, 0x24, 0x78, 0x4e, 0x9e, 0x15, 0xfc, 0xbd, 0x38, 0x53, 0x84, 0xdb, 0xdc, 0xd, 0x80, 0x60, 0x30, 0x95, 0x64, 0x3, 0x41, 0x37, 0x98, 0x8a, 0xaf, 0xed, 0xc3, 0xb, 0x90, 0x87, 0x94, 0x12, 0xcf, 0x50, 0x80, 0x3c, 0x3d, 0x2b, 0x37, 0xaa, 0xdb, 0x89, 0xf9, 0xef, 0xe7, 0x67, 0x1f, 0x83, 0x82, 0x33, 0x21, 0x83, 0x2e, 0x6e, 0x3d, 0x63, 0xa7, 0xa1, 0xa6, 0xd1, 0x9a, 0x5c, 0x0, 0x34, 0x12, 0x19, 0x51, 0x9e, 0xd0, 0x8, 0x83, 0xc5, 0xc3, 0xbf, 0x8a, 0xac, 0x4c, 0xf1, 0x4d, 0x3a, 0xdf, 0x97, 0xcd, 0x3f, 0xce, 0xa8, 0xce, 0x83, 0xec, 0xda, 0xde, 0x54, 0x8f, 0xa8, 0xed, 0x1e, 0x28, 0x16, 0xad, 0x7e, 0x32, 0xe9, 0x8b, 0xe3, 0xe8, 0x2e, 0xc1, 0x67, 0x92, 0xe0, 0x5b, 0x94, 0xa, 0x7f, 0xd2, 0x8, 0x24, 0x56, 0x1d, 0x3, 0xd8, 0x6f, 0x7, 0xae, 0xd8, 0xa9, 0x7c, 0x85, 0x68, 0x2e, 0xac, 0x79, 0x20, 0xb3, 0x54, 0x9a, 0x57, 0x79, 0xbb, 0xfe, 0x2f, 0xb, 0x3e, 0x8e, 0xb9, 0xae, 0x7, 0xf7, 0x74, 0xf3, 0xc7, 0x95, 0xce, 0xce, 0x63, 0x37, 0xaf, 0xf3, 0x84, 0x2, 0xba, 0x3d, 0xc7, 0x9a, 0x87, 0xb7, 0xdd, 0x3b, 0x5a, 0x91, 0xe8, 0xf2, 0x37, 0x38, 0x50, 0x53, 0xc2, 0x3d, 0xdb, 0xb1, 0xb, 0x89, 0xf1, 0x8d, 0xea, 0x7b, 0x33, 0x19, 0x4d, 0xe4, 0xd8, 0xc8, 0x8c, 0xe9, 0xc3, 0xa2, 0x41, 0x69, 0xd2, 0x6, 0x40, 0x16, 0xa, 0x6, 0x41, 0x30, 0x78, 0x9a, 0x73, 0xd9, 0x2a, 0xd6, 0x5c, 0xcc, 0x75, 0x9f, 0xd5, 0x99, 0x4c, 0x11, 0xaa, 0xe6, 0x33, 0x9b, 0x1d, 0x56, 0x25, 0x68, 0xf7, 0x14, 0xff, 0xf7, 0xe1, 0xfc, 0x87, 0x41, 0x5f, 0x65, 0x79, 0x1f, 0xe3, 0xc7, 0x33, 0x34, 0xf5, 0x6a, 0x9c, 0xad, 0x85, 0xea, 0xe9, 0x56, 0xe8, 0x85, 0xbd, 0x7b, 0x4a, 0xb, 0x41, 0x62, 0xbc, 0xa4, 0x21, 0xad, 0xed, 0xa3, 0x6d, 0x69, 0x6d, 0x1e, 0x2d, 0xbe, 0x9c, 0xbc, 0xbd, 0xd7, 0x72, 0xdd, 0x6e, 0x34, 0xfb, 0x2c, 0xef, 0x24, 0x3, 0x7f, 0xaf, 0x13, 0xc2, 0x48, 0x45, 0xaa, 0xcb, 0x97, 0x72, 0x2d, 0x85, 0x86, 0x5a, 0x8f, 0x72, 0x41, 0x91, 0x4a, 0xac, 0x8f, 0xa6, 0xe5, 0xb5, 0x53, 0x53, 0xb8, 0xde, 0x98, 0x24, 0x0, 0x6e, 0xe8, 0x2a, 0xe, 0x3b, 0xf9, 0x35, 0x88, 0x6f, 0x76, 0x20, 0x9e, 0x8a, 0x20, 0x53, 0x69, 0xda, 0x0, 0x69, 0x96, 0x12, 0x7d, 0x20, 0xbf, 0xe4, 0xe8, 0x63, 0xc6, 0xd1, 0xa9, 0xa8, 0xde, 0xe3, 0x5e, 0x30, 0xa3, 0xd1, 0x64, 0x7, 0xd8, 0x7f, 0x59, 0x96, 0x2e, 0xd1, 0xa7, 0xb2, 0x21, 0xb9, 0x3, 0xee, 0x70, 0x3f, 0x93, 0xd9, 0xa9, 0x64, 0x1f, 0xd4, 0x78, 0x7, 0x14, 0xcc, 0x51, 0xc0, 0x2d, 0xe8, 0x72, 0xc3, 0xc8, 0x3d, 0x9a, 0x19, 0xc7, 0xb3, 0xb6, 0x87, 0x42, 0x50, 0x3b, 0x40, 0xf6, 0x1, 0x9c, 0x3a, 0xd, 0xcd, 0x2d, 0xa, 0x9a, 0x77, 0x74, 0xa2, 0xea, 0x1b, 0x67, 0x36, 0x3b, 0x1a, 0x36, 0xba, 0x45, 0x73, 0x9e, 0x8e, 0x62, 0x5a, 0xf4, 0xc5, 0x7e, 0x49, 0x23, 0x3c, 0x5e, 0x18, 0xf5, 0x72, 0x24, 0xbb, 0x76, 0xad, 0x66, 0x52, 0x23, 0xf6, 0xde, 0x1b, 0x47, 0xaa, 0x56, 0xe5, 0x7d, 0x2, 0x3a, 0x54, 0x68, 0xa9, 0xd9, 0x6a, 0x87, 0xed, 0x19, 0x7a, 0xde, 0x97, 0x20, 0x4f, 0xb, 0x3f, 0x96, 0x32, 0x2f, 0x18, 0x82, 0xba, 0x4f, 0xfa, 0xda, 0x1c, 0x9f, 0xe5, 0x94, 0x1b, 0x74, 0x1b, 0x8c, 0x41, 0xae, 0xf2, 0x9f, 0xd, 0x61, 0xb7, 0x4f, 0x8c, 0xd8, 0x12, 0x48, 0x86, 0x6c, 0xf2, 0x92, 0xe6, 0x7a, 0x1d, 0x10, 0x6c, 0x42, 0xa6, 0x14, 0x59, 0xf8, 0x25, 0x29, 0x4d, 0x63, 0x72, 0xe3, 0x53, 0x4e, 0xd6, 0xb6, 0xb, 0x80, 0xf1, 0xc4, 0xde, 0xd2, 0x71, 0x58, 0xf2, 0x8c, 0xe6, 0x1b, 0xce, 0xb3, 0x74, 0xe4, 0x1e, 0x0, 0xb1, 0xc2, 0xb1, 0xfb, 0x8f, 0x72, 0x40, 0xdb, 0xa3, 0xa2, 0x90, 0xc8, 0xd2, 0xdd, 0x88, 0x45, 0xbc, 0xd5, 0x1, 0xd7, 0xce, 0xde, 0xf6, 0xda, 0xaa, 0x35, 0x21, 0xb1, 0x5f, 0xc5, 0x7d, 0xb3, 0xe2, 0xfd, 0x4a, 0xc7, 0x46, 0x3e, 0xd4, 0xce, 0xda, 0xed, 0x4d, 0x1b, 0x5a, 0x70, 0xd5, 0xd2, 0xd0, 0x57, 0x40, 0x2f, 0x92, 0xce, 0xb3, 0xd3, 0x53, 0x13, 0x98, 0x80, 0x44, 0xf5, 0x76, 0x75, 0x75, 0xc, 0xae, 0xd7, 0x28, 0xd3, 0x81, 0xa6, 0x2a, 0x9f, 0xa5, 0x6f, 0xaa, 0x2e, 0x8c, 0xdb, 0xf9, 0xd8, 0xa9, 0x57, 0xea, 0xc7, 0x7b, 0x85, 0xd6, 0x31, 0x3b, 0x84, 0x36, 0xb4, 0x32, 0x92, 0xbb, 0x4c, 0x79, 0x91, 0x2d, 0x97, 0x9, 0xb1, 0x1e, 0x20, 0x82, 0xd, 0x63, 0x5d, 0xf0, 0xb9, 0x92, 0xc4, 0x9d, 0xd2, 0x78, 0xfb, 0xf8, 0xcd, 0xcd, 0xa5, 0x84, 0xfb, 0x6a, 0xa7, 0xf8, 0xd9, 0xeb, 0xa6, 0xc6, 0x2e, 0x29, 0x23, 0x3e, 0xe9, 0xb, 0x16, 0x70, 0x15, 0x86, 0x5, 0x49, 0x8b, 0x8c, 0xe9, 0x47, 0xb0, 0x22, 0xe4, 0x5e, 0xe1, 0xc2, 0x24, 0x22, 0xf2, 0xce, 0x28, 0x5a, 0x61, 0xa6, 0xed, 0xae, 0x6e, 0x7, 0x98, 0x73, 0xe6, 0xb9, 0xd7, 0x34, 0xe6, 0x2b, 0xd7, 0xd7, 0x63, 0x39, 0x66, 0x62, 0xa, 0xde, 0x30, 0x90, 0xc3, 0xaa, 0x3d, 0xa1, 0x20, 0xf9, 0xd, 0xf4, 0xd8, 0xb3, 0x68, 0xb3, 0x86, 0x2c, 0x7f, 0x49, 0xf8, 0x87, 0x84, 0xc0, 0xcf, 0x7f, 0xdf, 0xfe, 0x16, 0x7b, 0x3, 0x5b, 0xc8, 0x60, 0x8, 0xb7, 0x4f, 0xc0, 0x1a, 0x10, 0x87, 0x26, 0xf1, 0xc0, 0x14, 0xf0, 0x0, 0x94, 0xe5, 0x30, 0x6b, 0x50, 0xee, 0xe, 0xa7, 0x74, 0x2d, 0xd, 0x84, 0xf4, 0xa3, 0x33, 0x54, 0x4a, 0x3, 0x1c, 0x53, 0xbb, 0xcb, 0x45, 0x13, 0x1f, 0xd9, 0xd2, 0x29, 0xa6, 0xe8, 0xcb, 0x57, 0xdf, 0xc, 0x81, 0x75, 0xa, 0xc2, 0x61, 0xb0, 0xde, 0x32, 0x69, 0x75, 0x86, 0x35, 0xfb, 0x14, 0xd, 0x2e, 0xc8, 0x3a, 0x27, 0x4c, 0xd8, 0x97, 0x91, 0x81, 0xdf, 0x26, 0x5b, 0xd0, 0x24, 0x39, 0xc9, 0x92, 0x8c, 0x9, 0x52, 0xb6, 0x9c, 0x63, 0x6f, 0x32, 0x19, 0xfb, 0xe6, 0x6f, 0x1c, 0x4c, 0x86, 0x5d, 0x4c, 0x62, 0x43, 0x64, 0x97, 0xa4, 0x97, 0xed, 0xb0, 0x93, 0x29, 0xcf, 0x44, 0xc4, 0x7e, 0xc, 0xcf, 0x79, 0x4d, 0xda, 0xab, 0xc5, 0x62, 0xd1, 0x4b, 0xfa, 0x2b, 0x5d, 0xae, 0x12, 0xf1, 0xc7, 0x4f, 0xc5, 0xb4, 0xf6, 0x26, 0x56, 0x2, 0xf6, 0xd7, 0x4a, 0x7a, 0x86, 0x58, 0x97, 0x46, 0xdb, 0xca, 0xdf, 0x7b, 0x4d, 0x7e, 0xdd, 0xac, 0x69, 0x4c, 0xf9, 0xed, 0x5e, 0xb, 0x72, 0x78, 0x74, 0xe8, 0x1f, 0xfe, 0xeb, 0x67, 0x7f, 0x32, 0x3e, 0x7a, 0xc8, 0x82, 0xd8, 0x6c, 0xfb, 0x2e, 0xc8, 0x9e, 0x3c, 0x7f, 0xf3, 0x82, 0xec, 0xd6, 0xaa, 0x67, 0x41, 0x8c, 0xdb, 0x38, 0x8e, 0xba, 0xa3, 0x1b, 0x60, 0x61, 0x48, 0x53, 0xca, 0x25, 0x93, 0x39, 0xcb, 0xc0, 0x9, 0x13, 0x9a, 0x92, 0x13, 0x70, 0x44, 0xe1, 0x84, 0x29, 0xb9, 0x46, 0xf2, 0xb7, 0x27, 0x2, 0xc1, 0x30, 0xf8, 0x43, 0xdc, 0xf2, 0x4a, 0x27, 0xf5, 0x8d, 0x53, 0xf, 0x1b, 0x2f, 0x7b, 0xa8, 0xa8, 0xf0, 0x99, 0xe0, 0xf8, 0xd1, 0x59, 0x46, 0xbc, 0xe2, 0x22, 0x18, 0xe3, 0xf8, 0x45, 0x53, 0xc, 0x11, 0x25, 0xc5, 0x49, 0x9f, 0x8f, 0x60, 0xdc, 0xbc, 0xfa, 0x21, 0x3, 0x2f, 0x8c, 0x96, 0x5d, 0xf2, 0xc9, 0x50, 0x9c, 0x6f, 0x27, 0x6e, 0xad, 0x15, 0xb2, 0xda, 0xac, 0xdb, 0x5c, 0x62, 0xb0, 0xce, 0xf4, 0x63, 0xc5, 0x14, 0x86, 0xd2, 0x6c, 0x28, 0xdf, 0x14, 0x2b, 0xb0, 0xaa, 0xfd, 0x20, 0xb2, 0xb2, 0x38, 0x1c, 0x8a, 0x60, 0x59, 0xef, 0x4b, 0xa9, 0x86, 0x6f, 0xa0, 0xbf, 0xfa, 0xae, 0xdb, 0xd1, 0x3e, 0x81, 0x93, 0x0, 0x62, 0xac, 0x8, 0x87, 0x32, 0x71, 0x87, 0x57, 0x30, 0x2a, 0xfb, 0xfb, 0x47, 0xe3, 0xf1, 0x58, 0x3e, 0xd7, 0x5, 0x63, 0x22, 0x72, 0x25, 0xf2, 0x3f, 0x74, 0x54, 0xc8, 0xb7, 0x76, 0xc4, 0x97, 0x49, 0xc7, 0x75, 0xb2, 0x2e, 0x4c, 0xe4, 0x46, 0xc2, 0x94, 0x97, 0x6e, 0x95, 0x6b, 0x11, 0x95, 0x6e, 0x90, 0x20, 0x67, 0x82, 0x3b, 0xe5, 0xef, 0xd5, 0x49, 0xae, 0xf3, 0x75, 0x22, 0xce, 0xa8, 0x2c, 0xff, 0xc4, 0xb2, 0x1c, 0x2f, 0xb1, 0xea, 0x52, 0x55, 0x19, 0xcb, 0xf, 0xa6, 0x1b, 0xad, 0xfa, 0x66, 0xf5, 0x82, 0xc1, 0x28, 0xdf, 0x59, 0x11, 0x3c, 0xa7, 0x22, 0xcd, 0x4a, 0xa1, 0x14, 0xee, 0x48, 0xe9, 0xe6, 0x68, 0xab, 0x9, 0xed, 0x79, 0x52, 0xde, 0x50, 0xe6, 0x51, 0xea, 0x80, 0x87, 0xe9, 0x66, 0x1, 0x9, 0xa2, 0xd, 0x83, 0x73, 0xf7, 0x2, 0x33, 0x71, 0x72, 0xe, 0x6b, 0xcf, 0xa2, 0x15, 0x4e, 0xd7, 0x6b, 0x53, 0x7a, 0xd1, 0x2b, 0xfb, 0xe9, 0x4, 0x59, 0xe7, 0x8d, 0xcf, 0x68, 0xbe, 0x9a, 0xb6, 0x7c, 0x45, 0xb, 0xa3, 0xa2, 0x4a, 0xb2, 0x14, 0x49, 0x23, 0x27, 0xab, 0xaf, 0x6d, 0x8f, 0x75, 0xeb, 0xef, 0xc7, 0xe8, 0x7c, 0xb7, 0xac, 0xc1, 0x9e, 0xc9, 0xca, 0x7b, 0xbf, 0x2d, 0xd6, 0x78, 0x45, 0xc9, 0xc6, 0xc8, 0xaf, 0xe3, 0x92, 0x60, 0xff, 0x57, 0xa0, 0xec, 0xad, 0x67, 0x9e, 0x54, 0xe8, 0xe7, 0xff, 0xf2, 0x61, 0x45, 0xb9, 0x82, 0x3a, 0xea, 0x36, 0x1b, 0xa4, 0xed, 0x5a, 0x4d, 0x72, 0x94, 0x65, 0xe2, 0xff, 0x1, 0x8e, 0x80, 0xd0, 0xef, 0x98, 0x27, 0x0, 0x0, 0x0, 0x1f, 0x8b, 0x8, 0x0, 0x0, 0x0, 0x0, 0x0, 0x2, 0x3, 0xed, 0x7d, 0x69, 0x77, 0xdb, 0x46, 0xb2, 0xe8, 0xe7, 0x37, 0xbf, 0x42, 0xc2, 0x24, 0xa, 0x20, 0x36, 0x29, 0x52, 0x19, 0xe7, 0xce, 0x5, 0x5, 0xf1, 0xd8, 0x8e, 0x33, 0xc9, 0x4c, 0x16, 0x8f, 0xed, 0x4c, 0x16, 0x59, 0xc9, 0x1, 0x81, 0x26, 0x9, 0x9b, 0x2, 0x18, 0x2, 0x94, 0x25, 0x4b, 0x7c, 0xbf, 0xfd, 0x55, 0x55, 0x2f, 0xe8, 0x6, 0x1a, 0x94, 0xec, 0x64, 0x96, 0xfb, 0x6e, 0xce, 0x4c, 0x2c, 0xb0, 0xf7, 0xa5, 0xba, 0xb6, 0xae, 0xaa, 0x3e, 0x3a, 0xfa, 0xf1, 0xc9, 0xd3, 0x17, 0xdf, 0xfc, 0xe1, 0x32, 0x5e, 0xef, 0xfd, 0xc8, 0x57, 0x55, 0x11, 0xcd, 0x36, 0x79, 0x52, 0x65, 0x45, 0xee, 0x7, 0x37, 0xea, 0x73, 0xef, 0x33, 0x3f, 0xe, 0x6e, 0xd6, 0xbc, 0xda, 0xac, 0xf3, 0xbd, 0x7c, 0xb3, 0x5c, 0x46, 0x51, 0x3c, 0x79, 0x5e, 0xad, 0xb3, 0x7c, 0xe, 0x19, 0xe1, 0xd5, 0xd9, 0xf5, 0x20, 0x89, 0x97, 0x4b, 0xf8, 0x3e, 0xbf, 0xbd, 0xf5, 0x8a, 0xe9, 0x2b, 0x9e, 0x54, 0xde, 0x56, 0xd7, 0xfe, 0x4b, 0x5d, 0xdb, 0x53, 0x89, 0x5e, 0x14, 0x61, 0xa3, 0x75, 0xa1, 0xcf, 0x1b, 0x5d, 0xec, 0x47, 0xf1, 0xc1, 0x41, 0xc, 0x1d, 0xd, 0xde, 0x64, 0x79, 0x5a, 0xbc, 0xa9, 0x4b, 0x7e, 0xe1, 0x2c, 0x39, 0xc8, 0x8b, 0x94, 0xbf, 0xb8, 0x5e, 0x71, 0xac, 0xf2, 0xe9, 0x37, 0x8f, 0xbf, 0xfd, 0xea, 0xc9, 0xd7, 0x2f, 0x7e, 0xfe, 0xfa, 0x9b, 0x4f, 0x9f, 0xd4, 0x35, 0xff, 0x6a, 0xc, 0x44, 0x8e, 0xb2, 0x39, 0x8c, 0xbf, 0x19, 0x8d, 0x63, 0xf1, 0x83, 0x83, 0xfd, 0xcf, 0xe9, 0xcf, 0x37, 0x54, 0x7e, 0x30, 0xe7, 0xd5, 0xd3, 0x75, 0x51, 0x15, 0x15, 0xf4, 0xf4, 0xcd, 0xc, 0x72, 0xa2, 0x48, 0xe6, 0xac, 0x54, 0x72, 0xdd, 0xd8, 0x97, 0x46, 0x7f, 0xf9, 0xe6, 0x62, 0xca, 0xd7, 0xd0, 0x1f, 0x16, 0x29, 0x66, 0x7b, 0xf1, 0x60, 0xc9, 0xf3, 0x79, 0xb5, 0xa8, 0x4b, 0x7f, 0x65, 0x74, 0x3d, 0x97, 0xb, 0xca, 0xf4, 0x6e, 0xb4, 0xe6, 0xbc, 0x35, 0x46, 0xfd, 0xb5, 0x91, 0xad, 0x1a, 0x3e, 0x1d, 0x4e, 0x92, 0xc1, 0x2c, 0x1f, 0x24, 0x45, 0x9e, 0xc4, 0xd5, 0x20, 0x5e, 0xad, 0x96, 0xd7, 0xfe, 0xd9, 0x39, 0x83, 0xd, 0x8b, 0xeb, 0x9a, 0xdf, 0x58, 0x35, 0xd7, 0x7c, 0xb5, 0x8c, 0x13, 0xee, 0x1f, 0x85, 0xe1, 0xd1, 0x9c, 0x79, 0x47, 0x5e, 0x50, 0x27, 0xf9, 0x67, 0xf, 0xfb, 0x3f, 0x9e, 0xf7, 0x2, 0xf1, 0xf7, 0x2c, 0xee, 0xbf, 0x3d, 0xf, 0xb0, 0xd0, 0x7, 0xa3, 0x9f, 0x3f, 0x38, 0xb6, 0xb, 0x42, 0xde, 0xcb, 0xf4, 0x5c, 0x96, 0x74, 0x17, 0xfa, 0x19, 0x53, 0xfb, 0x90, 0x52, 0x15, 0x5f, 0x16, 0x6f, 0xf8, 0xfa, 0x71, 0x5c, 0x72, 0xdf, 0x98, 0xd1, 0x53, 0x73, 0x5c, 0x7b, 0x59, 0xbe, 0xf7, 0x6a, 0xf2, 0xea, 0x2c, 0x3e, 0xf, 0xf1, 0x9f, 0x28, 0xe7, 0x6f, 0xf6, 0x9e, 0xf1, 0xf9, 0x93, 0xab, 0x95, 0xef, 0xf9, 0x3f, 0xdd, 0xbe, 0x7c, 0x59, 0x6, 0x5e, 0x2f, 0xee, 0x79, 0x3e, 0x7c, 0xdd, 0x7e, 0x10, 0x78, 0x46, 0x3b, 0x7f, 0x87, 0x35, 0x9c, 0x36, 0x37, 0x61, 0x5f, 0x6d, 0xc2, 0xf4, 0xf6, 0xf6, 0xf5, 0x19, 0x2e, 0xc1, 0xf9, 0x64, 0x1a, 0x4e, 0x7b, 0xde, 0xea, 0xca, 0x0, 0xdb, 0x67, 0x38, 0x4, 0x3c, 0x17, 0x53, 0x96, 0x8c, 0xe5, 0x50, 0x32, 0xe8, 0xfe, 0xf6, 0xd6, 0x9f, 0x46, 0x8b, 0x41, 0xb2, 0xe6, 0x71, 0xc5, 0x9f, 0x2c, 0xf9, 0x5, 0xcf, 0x2b, 0x28, 0xca, 0x16, 0x83, 0x69, 0x91, 0x5e, 0xe3, 0x42, 0xf3, 0x3c, 0x7d, 0xbc, 0xc8, 0x96, 0xa9, 0x3f, 0xd, 0x58, 0x12, 0x1, 0xc8, 0x3c, 0x2e, 0x2e, 0x56, 0x9b, 0x8a, 0xa7, 0xcf, 0xab, 0xeb, 0x25, 0xf7, 0xa7, 0xcc, 0x83, 0x89, 0xb, 0x48, 0x5a, 0xf1, 0x75, 0x75, 0xfd, 0x8f, 0x78, 0xb9, 0xe1, 0xbe, 0x97, 0x66, 0x25, 0xac, 0xce, 0xb5, 0x17, 0xb0, 0xe9, 0x60, 0x15, 0xaf, 0xa1, 0xd9, 0xaf, 0x1, 0xa6, 0x61, 0xcd, 0x2e, 0x8a, 0x4b, 0xae, 0x1b, 0xf4, 0xf2, 0x22, 0xe7, 0x0, 0x47, 0xc9, 0xc1, 0x81, 0x9f, 0x44, 0xde, 0x74, 0x59, 0x24, 0xaf, 0xa1, 0xa, 0x8e, 0x2c, 0x4a, 0xc4, 0xdf, 0x7a, 0xe, 0xcf, 0xd, 0x8, 0x4c, 0xb0, 0x5, 0x68, 0xd5, 0x83, 0xd5, 0x8c, 0x27, 0x33, 0x9, 0x61, 0x3, 0x95, 0x1c, 0x84, 0xc9, 0xe0, 0x22, 0x5e, 0xa9, 0x14, 0xec, 0xba, 0x74, 0x81, 0xdf, 0x8, 0xf, 0x98, 0x3a, 0x6c, 0x93, 0x38, 0xbc, 0x2c, 0xb2, 0x74, 0x6f, 0x68, 0x42, 0xe3, 0xb, 0x3f, 0x61, 0x29, 0xe3, 0x80, 0x3f, 0x8a, 0xb5, 0x3f, 0xc5, 0xcd, 0x4b, 0x3, 0xe, 0xa3, 0xfd, 0x9b, 0x9f, 0x9e, 0x4d, 0xcf, 0x83, 0xdb, 0xdb, 0x27, 0xe2, 0x23, 0x98, 0xa8, 0x24, 0x38, 0x65, 0x7f, 0xf3, 0x13, 0xf1, 0x45, 0x7f, 0xa3, 0x9b, 0x6d, 0xc0, 0x9e, 0xe8, 0xcc, 0x27, 0x76, 0xe6, 0xd9, 0x79, 0xc0, 0x5e, 0xd0, 0x27, 0xc3, 0x12, 0xd0, 0x55, 0x10, 0xe2, 0xc7, 0x7e, 0x84, 0xa8, 0x40, 0x94, 0xa1, 0xaa, 0xf5, 0x98, 0xbe, 0x35, 0xe1, 0x40, 0xe2, 0xb0, 0xe9, 0x24, 0x41, 0xf4, 0x85, 0xff, 0xc, 0x66, 0xd9, 0xb2, 0xe2, 0x30, 0x5a, 0xa3, 0xca, 0x3f, 0xb0, 0xa, 0x83, 0xa9, 0xe8, 0x6a, 0x7f, 0x81, 0xfc, 0xc9, 0x54, 0x1d, 0x4d, 0xcc, 0x9, 0xa7, 0x75, 0xf9, 0xef, 0x44, 0xf9, 0xe0, 0x46, 0xb4, 0x9e, 0x4c, 0x62, 0xb9, 0x75, 0xf, 0x2b, 0x40, 0x95, 0x53, 0xd8, 0x7f, 0xa8, 0x1e, 0xc6, 0x83, 0x92, 0x57, 0x46, 0xa, 0x54, 0xa8, 0x9b, 0xf8, 0x9e, 0x7e, 0x13, 0xd0, 0xa5, 0x11, 0x74, 0xb4, 0x8c, 0xcb, 0xf2, 0xeb, 0xf8, 0x82, 0x3, 0x56, 0xf5, 0x18, 0x8f, 0xd2, 0x83, 0x83, 0x74, 0x30, 0x85, 0x93, 0x2, 0x0, 0x83, 0x73, 0x55, 0x50, 0x99, 0x44, 0x88, 0x90, 0xf9, 0x44, 0x67, 0x86, 0x69, 0xe8, 0x1b, 0x3f, 0xa3, 0x24, 0x34, 0x1a, 0x8b, 0x12, 0x26, 0xf6, 0xcc, 0xe8, 0xf8, 0x7, 0xdc, 0xe0, 0x6a, 0x7d, 0xad, 0x8f, 0xdc, 0xc4, 0xab, 0xd6, 0x1b, 0x4, 0xb3, 0x18, 0xc0, 0xdd, 0x9b, 0xc5, 0xcb, 0x92, 0x7e, 0x4c, 0xf6, 0x47, 0xa1, 0x87, 0xf3, 0xa3, 0x1f, 0xf8, 0x11, 0xe2, 0xc1, 0xa3, 0x5f, 0xbd, 0x38, 0x3c, 0xfa, 0xe9, 0xec, 0xe5, 0xd9, 0xcb, 0x9b, 0xf3, 0xa3, 0x41, 0xc5, 0x4b, 0x3c, 0x14, 0x80, 0x82, 0x0, 0x92, 0x4b, 0xfe, 0xd7, 0xe7, 0xdf, 0x20, 0x8e, 0xa, 0x9, 0xf9, 0x0, 0x3a, 0x4a, 0x16, 0x7e, 0xbd, 0x1b, 0xf1, 0xb6, 0x1e, 0xc8, 0x8f, 0x62, 0x9f, 0xa6, 0x50, 0x78, 0x8c, 0xe0, 0x83, 0x4b, 0x91, 0x44, 0x43, 0x96, 0x46, 0x26, 0x5c, 0x4a, 0x14, 0x37, 0x4e, 0x4f, 0x93, 0x71, 0xd2, 0xeb, 0x5, 0x3f, 0x5a, 0x50, 0x7b, 0x96, 0x9c, 0x43, 0x1b, 0x5b, 0xac, 0x2a, 0x77, 0x90, 0x3d, 0x64, 0x8f, 0x60, 0xfd, 0x0, 0xfb, 0xcd, 0x22, 0x3e, 0x28, 0x97, 0x59, 0xc2, 0xd9, 0x1c, 0xbe, 0xc4, 0xae, 0xb3, 0x45, 0x24, 0x68, 0xcc, 0x20, 0x2d, 0x92, 0xd, 0x1e, 0x67, 0x96, 0x1, 0x0, 0xb2, 0x57, 0xf8, 0xcf, 0xeb, 0xe8, 0xc6, 0x4b, 0x8a, 0xe5, 0xe6, 0x22, 0xef, 0x27, 0xc5, 0x26, 0xaf, 0xbc, 0x70, 0xc4, 0xc4, 0xef, 0x12, 0xbe, 0xbc, 0x59, 0x91, 0x57, 0xfd, 0x37, 0x3c, 0x9b, 0x2f, 0x28, 0xc7, 0x5b, 0x66, 0x39, 0xef, 0x2f, 0xf4, 0xef, 0x62, 0x15, 0x27, 0x59, 0x75, 0x8d, 0x39, 0x6f, 0xfb, 0xd0, 0x7, 0xbf, 0xc2, 0xd4, 0xb7, 0x45, 0x71, 0x11, 0x8e, 0xb6, 0x6c, 0x19, 0x1d, 0xfd, 0xf4, 0xb2, 0x3c, 0x3c, 0xf1, 0x5f, 0xbe, 0xe9, 0xdd, 0xee, 0x7, 0x67, 0x3f, 0x9d, 0x9e, 0x1f, 0x9e, 0x1e, 0xb1, 0xb, 0x48, 0xa6, 0xb4, 0x0, 0x32, 0x5f, 0x1e, 0x4d, 0x4e, 0xfd, 0x49, 0x78, 0xf2, 0xf2, 0xe8, 0xe5, 0xe8, 0xf4, 0x36, 0xf8, 0xe0, 0x88, 0xe5, 0xd1, 0xd1, 0x89, 0x3f, 0xd9, 0x7, 0x4, 0x11, 0xdf, 0x4e, 0xd7, 0xb7, 0x30, 0x98, 0x5b, 0xe, 0x68, 0x2d, 0xbd, 0x5d, 0xac, 0x6f, 0xb3, 0x8b, 0xf9, 0x6d, 0x96, 0x3, 0xae, 0xb9, 0x85, 0x81, 0xbc, 0xbe, 0xbd, 0xe0, 0x55, 0x7c, 0xb, 0x1b, 0x10, 0x5f, 0x4, 0xbe, 0x7f, 0xf6, 0xf2, 0x4d, 0x8, 0xf8, 0x9b, 0x7a, 0x9, 0x5e, 0x1e, 0x9d, 0x1e, 0xcd, 0x33, 0x56, 0x40, 0x57, 0xd0, 0x3a, 0x22, 0xae, 0xdb, 0x45, 0x75, 0xb1, 0x84, 0xf6, 0x33, 0xb6, 0x8a, 0x8e, 0x6a, 0xd4, 0xfd, 0x4b, 0x74, 0xe6, 0x5d, 0xc6, 0x4b, 0x8f, 0x79, 0x49, 0x59, 0xc2, 0xbf, 0x58, 0xa, 0xfe, 0x54, 0xfc, 0xaa, 0x82, 0x3f, 0x69, 0x5c, 0xc5, 0xf0, 0xe7, 0x4d, 0x96, 0x56, 0xb, 0xcc, 0x14, 0x13, 0x67, 0x5e, 0x31, 0x9b, 0x1, 0x98, 0x7b, 0xe7, 0x6c, 0xd, 0xd5, 0xe3, 0x19, 0x2c, 0x32, 0x24, 0xae, 0x0, 0xfb, 0x3, 0x6a, 0x84, 0xaf, 0x29, 0x87, 0xbd, 0xe5, 0xf0, 0x21, 0x90, 0x25, 0x94, 0x2b, 0x5b, 0x18, 0xd5, 0xab, 0xe2, 0xe9, 0x92, 0x3, 0x66, 0xab, 0x1c, 0x59, 0x6b, 0x48, 0xdf, 0x44, 0x0, 0xb1, 0x61, 0x3b, 0xf, 0x27, 0x83, 0xd5, 0xf0, 0x6f, 0x58, 0xb2, 0x6a, 0xc1, 0xe3, 0x14, 0xff, 0xce, 0x8a, 0xa2, 0xc2, 0xbf, 0x69, 0x58, 0x41, 0x22, 0xfc, 0xe3, 0x1d, 0x7a, 0xed, 0xea, 0x69, 0x76, 0x9, 0xf4, 0x83, 0x5d, 0x46, 0x47, 0x9, 0x20, 0xed, 0x25, 0xaf, 0xf8, 0xed, 0xb2, 0x88, 0x53, 0x58, 0xde, 0x2c, 0x87, 0x69, 0xc4, 0x0, 0xa6, 0x97, 0xfc, 0x88, 0xbd, 0x89, 0x10, 0xd6, 0xdf, 0xf4, 0xcf, 0xf, 0x61, 0x47, 0xae, 0x10, 0x50, 0xae, 0xa3, 0x2b, 0x20, 0x66, 0x82, 0x2b, 0x62, 0x6f, 0x31, 0xe5, 0x71, 0xe4, 0x6e, 0x9d, 0x7d, 0xa, 0x23, 0x8f, 0xa7, 0x4, 0xe, 0x21, 0x4e, 0xf3, 0xb, 0x2, 0xc, 0x6, 0x45, 0xd3, 0x22, 0x5f, 0x5e, 0x87, 0x1e, 0x7e, 0x7d, 0x3, 0x5f, 0x1e, 0x2, 0xd8, 0xda, 0xb, 0x69, 0xd5, 0x3f, 0x2b, 0x70, 0x11, 0xe9, 0x18, 0x43, 0x8a, 0x3e, 0xce, 0x1e, 0xbb, 0x88, 0xaf, 0xc4, 0x79, 0x8, 0x3d, 0xf8, 0xfc, 0x92, 0x3e, 0x3d, 0x96, 0xf0, 0xe5, 0xb2, 0x44, 0xf0, 0xcb, 0xe7, 0x50, 0x1a, 0x7e, 0x3c, 0x17, 0x3f, 0x44, 0xce, 0x2a, 0x4e, 0x53, 0x9d, 0xf3, 0x54, 0xfc, 0x80, 0x11, 0x14, 0x6f, 0xa0, 0x4a, 0xe, 0x3, 0x28, 0xde, 0x40, 0xf1, 0xdc, 0x43, 0x50, 0x17, 0x29, 0xf0, 0x21, 0x52, 0x36, 0x25, 0x7, 0x32, 0x11, 0x7a, 0xf0, 0xf7, 0xab, 0x78, 0xe5, 0xb1, 0x19, 0x40, 0x17, 0x9f, 0x16, 0xeb, 0x94, 0xaf, 0x43, 0x8f, 0x7e, 0x3c, 0xa2, 0x1f, 0x58, 0x17, 0x56, 0xc, 0xfe, 0x9f, 0x66, 0xb4, 0x95, 0xd8, 0x6, 0x25, 0x3c, 0x91, 0x9, 0xde, 0x96, 0x3d, 0x89, 0x1e, 0xae, 0xd7, 0xf1, 0xf5, 0x20, 0x2b, 0xe9, 0xef, 0xed, 0xad, 0x83, 0xe0, 0x20, 0xf9, 0x2f, 0xab, 0x38, 0x4f, 0x90, 0x62, 0x53, 0xb1, 0xad, 0x42, 0x7c, 0x6f, 0x81, 0x62, 0x1, 0x2e, 0xe1, 0x65, 0xcd, 0xb5, 0x12, 0xfa, 0xc8, 0x66, 0xfe, 0x3e, 0xd0, 0xf6, 0x7d, 0x40, 0x5e, 0xa3, 0x7d, 0x93, 0x5e, 0x5, 0xa2, 0xe2, 0xfe, 0x68, 0x2c, 0x10, 0xb, 0x70, 0x97, 0x7c, 0xfa, 0x3a, 0xab, 0xbe, 0x12, 0xcd, 0x3c, 0xe7, 0x4b, 0x60, 0xe5, 0x8a, 0xf5, 0xed, 0x6d, 0x3c, 0xb8, 0x28, 0xde, 0x3a, 0x52, 0xb, 0x57, 0x49, 0x3b, 0x69, 0xc, 0xbd, 0x27, 0x81, 0x42, 0xcd, 0x8a, 0x5a, 0x4c, 0x3, 0xea, 0x12, 0xe8, 0x22, 0x74, 0x5a, 0x53, 0x77, 0x40, 0x48, 0xfb, 0x5c, 0x4d, 0x67, 0x6, 0xc4, 0x8b, 0x47, 0x8f, 0x3, 0x8b, 0x87, 0x0, 0xce, 0x22, 0x8d, 0xfe, 0xef, 0xdb, 0xc1, 0x2f, 0x65, 0xec, 0x73, 0x68, 0x66, 0x40, 0x70, 0x43, 0xbc, 0x27, 0x83, 0xa, 0x8f, 0x2d, 0xfe, 0x0, 0xb, 0x6f, 0xd9, 0xc3, 0xc8, 0xb5, 0x8c, 0x35, 0xf3, 0xd5, 0xef, 0xf9, 0x83, 0x60, 0x2, 0x87, 0xdb, 0x5e, 0x35, 0x59, 0x70, 0xa, 0x24, 0xae, 0x2a, 0xbe, 0x85, 0x21, 0x48, 0xae, 0x2c, 0xf4, 0x3c, 0x20, 0xef, 0xec, 0x91, 0xab, 0xd5, 0x36, 0xa3, 0x4a, 0x14, 0x4c, 0xf7, 0xa9, 0x6, 0x3b, 0x5, 0x46, 0x39, 0xc1, 0x56, 0xde, 0xe, 0x0, 0x46, 0xe6, 0x78, 0x1a, 0x22, 0xa3, 0xa, 0xb1, 0xb, 0xb8, 0x3e, 0x73, 0x96, 0xb1, 0x57, 0x6a, 0x3d, 0x2e, 0x4, 0x19, 0x99, 0x22, 0xe1, 0x9f, 0x47, 0x89, 0xdf, 0x3c, 0x4e, 0x82, 0x7, 0x1c, 0x7c, 0x30, 0xa, 0x82, 0x80, 0xcd, 0x91, 0x2f, 0x53, 0x73, 0x84, 0xa, 0xd3, 0x48, 0xff, 0xf2, 0x73, 0xe6, 0x9d, 0x7c, 0x30, 0x3a, 0x3d, 0x39, 0xfa, 0xe0, 0xf8, 0xd4, 0xb, 0x70, 0x41, 0x5, 0xa7, 0x90, 0x46, 0xcb, 0xba, 0x8b, 0xba, 0x35, 0x96, 0x22, 0xd3, 0xb2, 0x81, 0x6, 0xd3, 0x8, 0x90, 0x44, 0x0, 0x94, 0x60, 0x73, 0x96, 0x9e, 0xb3, 0x57, 0x30, 0x9d, 0x9c, 0xaf, 0x3f, 0x7f, 0xf1, 0xd5, 0x97, 0x91, 0xe7, 0xf5, 0xa6, 0x40, 0x43, 0x92, 0x1, 0x8f, 0x81, 0x98, 0x49, 0x6e, 0xea, 0x95, 0x41, 0x85, 0x2, 0x66, 0x48, 0x52, 0xaf, 0xac, 0x5d, 0xaa, 0x16, 0x59, 0x19, 0x6c, 0x61, 0x1c, 0x7f, 0xf3, 0x39, 0xce, 0x2d, 0x83, 0xb9, 0xcd, 0x81, 0x55, 0x14, 0x6d, 0xf1, 0xc6, 0xb6, 0xfc, 0x62, 0xec, 0xf8, 0x69, 0x7f, 0x34, 0x41, 0xe, 0xf, 0x39, 0x89, 0x6c, 0x10, 0x3, 0x1b, 0x41, 0x65, 0xb0, 0xad, 0x39, 0xae, 0xed, 0x8f, 0x91, 0x73, 0x4b, 0x63, 0x24, 0xe3, 0xc8, 0xfb, 0xf, 0x7e, 0xfe, 0x99, 0xe4, 0x94, 0x9f, 0x7f, 0x8e, 0x50, 0x38, 0x60, 0xc8, 0x8d, 0x8, 0xa8, 0x8d, 0xa6, 0xc4, 0x64, 0xc4, 0xd8, 0x4a, 0x56, 0xfe, 0x18, 0xdd, 0x75, 0x10, 0xa1, 0x2f, 0x2a, 0x9a, 0x67, 0xf6, 0x46, 0x8a, 0x6d, 0xe4, 0x63, 0x3a, 0x82, 0x81, 0x3e, 0xa7, 0x3f, 0xfa, 0x1, 0x26, 0x79, 0x25, 0xe1, 0xc7, 0x5a, 0xc, 0x9a, 0x6, 0x90, 0x8a, 0x5b, 0x5, 0xe9, 0x17, 0x3e, 0x70, 0xb7, 0x27, 0x90, 0x37, 0x3d, 0x1b, 0x9e, 0x1f, 0x1c, 0xe8, 0xad, 0x9, 0x78, 0x54, 0x43, 0xd, 0xf4, 0xa1, 0x37, 0xa, 0x7a, 0x63, 0xd3, 0x8, 0xb9, 0x90, 0x31, 0x7, 0x6, 0x5, 0x8f, 0x7d, 0x8a, 0xc7, 0x5d, 0x1f, 0x3e, 0x3f, 0x45, 0xce, 0x2e, 0x47, 0xbe, 0x79, 0x8c, 0x8d, 0xe0, 0x19, 0x5a, 0xe0, 0x7a, 0xa9, 0xe2, 0xc8, 0xd1, 0xd5, 0xa5, 0x17, 0x28, 0xa0, 0xc4, 0xe9, 0x35, 0x16, 0x87, 0x4c, 0x5a, 0x8, 0xa3, 0xc0, 0x14, 0x13, 0x9f, 0x88, 0x1, 0x7d, 0x45, 0x4d, 0x42, 0x2b, 0x7b, 0x90, 0xf6, 0x57, 0x91, 0x86, 0xac, 0xa8, 0x31, 0x1c, 0xcc, 0xe9, 0x9a, 0x83, 0x9a, 0xee, 0x6f, 0x30, 0x95, 0xad, 0xb1, 0xc6, 0x88, 0x1f, 0xb6, 0x20, 0x72, 0x38, 0x81, 0x40, 0x6c, 0x96, 0x80, 0x17, 0x84, 0xb5, 0x2b, 0xc0, 0xc5, 0xa9, 0xb5, 0xcf, 0x52, 0xd8, 0x89, 0x94, 0x6c, 0xb0, 0x9e, 0x13, 0x37, 0x54, 0xb2, 0x51, 0x20, 0x8f, 0xa4, 0x37, 0x2d, 0x8a, 0x25, 0x8f, 0x73, 0x43, 0x8e, 0xa5, 0xa3, 0x16, 0xb3, 0x18, 0x0, 0xaa, 0x5c, 0x64, 0xb3, 0xca, 0xf, 0x10, 0x92, 0x81, 0x6c, 0x3d, 0xa1, 0x83, 0xa1, 0x9a, 0x7, 0xa4, 0xf0, 0x82, 0x98, 0x66, 0x84, 0x56, 0x1, 0x66, 0x30, 0x85, 0xc6, 0x48, 0x9, 0x29, 0xc3, 0xe9, 0xf4, 0xfe, 0x28, 0xa1, 0x0, 0xb0, 0xe5, 0x3e, 0x70, 0xbd, 0xde, 0x40, 0xfd, 0x9e, 0x47, 0xe9, 0xed, 0x2d, 0x7, 0xc, 0x45, 0x4c, 0x9c, 0x3f, 0x2, 0xe, 0x1c, 0xd9, 0x37, 0xb1, 0xcc, 0x73, 0x35, 0x4c, 0xd2, 0x11, 0x1c, 0x1c, 0x2c, 0x80, 0x5f, 0x9e, 0xf8, 0x88, 0xe5, 0x41, 0xd8, 0x92, 0x48, 0xe3, 0xd1, 0xf5, 0x17, 0x29, 0x14, 0xc, 0x26, 0xc0, 0x25, 0x86, 0x67, 0xe7, 0xa1, 0x4d, 0x1f, 0xe, 0xe, 0xfe, 0xdb, 0xfa, 0x3d, 0x81, 0x12, 0x72, 0x35, 0xa0, 0xb1, 0xfd, 0x14, 0x98, 0x6c, 0xb3, 0xb1, 0xf2, 0xd1, 0xf5, 0x63, 0x45, 0x87, 0xa1, 0xd1, 0xb0, 0x91, 0xf7, 0x22, 0x9e, 0x53, 0xe, 0xb1, 0xfd, 0xbf, 0x6c, 0xf8, 0xfa, 0x5a, 0xd1, 0x88, 0x87, 0xd0, 0x20, 0x0, 0x5, 0xee, 0x3, 0x12, 0xc5, 0x18, 0xe, 0x16, 0x30, 0xb, 0x8a, 0xfd, 0x94, 0x2d, 0xe8, 0xac, 0x89, 0xfb, 0x50, 0xc3, 0x48, 0xa7, 0xa8, 0xf9, 0x50, 0xc5, 0x50, 0x7a, 0x9, 0xed, 0xa2, 0xc8, 0x42, 0x8f, 0xa7, 0x12, 0x1b, 0xd6, 0x54, 0x27, 0x18, 0x8b, 0x63, 0x57, 0x3, 0xd8, 0xfe, 0x70, 0xac, 0x48, 0x23, 0xe, 0xa, 0x37, 0x37, 0xfa, 0xc, 0x3e, 0xb2, 0xf2, 0x33, 0xd9, 0x60, 0xf4, 0x17, 0xfa, 0xf9, 0x1d, 0x71, 0xca, 0xd1, 0xe7, 0xf4, 0x83, 0xa8, 0x71, 0xf4, 0x84, 0xbe, 0x9f, 0x2e, 0x61, 0xc, 0x42, 0x17, 0x12, 0xfd, 0x8d, 0x52, 0x9e, 0x5c, 0xac, 0xaa, 0x6b, 0x99, 0xd2, 0x2, 0xb3, 0xb1, 0x16, 0xe, 0xe3, 0x9a, 0x28, 0xab, 0xb1, 0xe0, 0x10, 0xb2, 0x5c, 0xb4, 0x6e, 0x4e, 0xc8, 0x20, 0x2d, 0x5c, 0x61, 0x45, 0xb1, 0x3b, 0x53, 0x16, 0xa3, 0x24, 0x85, 0xeb, 0x9, 0x2b, 0xbe, 0x44, 0xc2, 0x15, 0x3d, 0xc4, 0x89, 0xc0, 0x39, 0x8b, 0x3a, 0x94, 0x28, 0x28, 0xb4, 0x78, 0x5e, 0x28, 0x58, 0xb6, 0x5a, 0x7f, 0x43, 0x75, 0x94, 0x42, 0xb, 0x5b, 0xdc, 0x6c, 0xb2, 0x14, 0x44, 0x10, 0x80, 0xef, 0xcd, 0x6a, 0x55, 0xac, 0x2b, 0xe4, 0xed, 0xf0, 0xfc, 0xac, 0xd6, 0xe2, 0xb, 0xd8, 0x21, 0x27, 0x1c, 0x3, 0x22, 0x7, 0x58, 0x3e, 0x3b, 0x47, 0xb4, 0x81, 0xaa, 0xa0, 0x0, 0xa7, 0xcc, 0xa3, 0xe1, 0x98, 0x9f, 0x28, 0x25, 0xcd, 0x98, 0x83, 0xf4, 0x92, 0x44, 0x20, 0xee, 0x9c, 0x71, 0x94, 0x63, 0x99, 0x50, 0xee, 0x24, 0x28, 0xe8, 0xad, 0x36, 0xe5, 0x2, 0x8e, 0x8d, 0xc0, 0x25, 0x58, 0x75, 0x26, 0x56, 0x4b, 0x14, 0x9f, 0x81, 0x2c, 0xe3, 0x2c, 0x2e, 0x27, 0xf8, 0x35, 0x20, 0x8c, 0xad, 0x24, 0x29, 0xee, 0x53, 0xa6, 0x87, 0x45, 0x50, 0x2, 0x42, 0xd6, 0x38, 0xa9, 0xc7, 0x85, 0x52, 0x15, 0x82, 0x88, 0x5c, 0x7, 0x14, 0xa9, 0x12, 0x86, 0x7f, 0x80, 0x8e, 0x47, 0xfb, 0xa3, 0x40, 0x8b, 0x6e, 0x7a, 0x74, 0xa9, 0x18, 0x9d, 0x59, 0x9, 0x48, 0x66, 0xca, 0xf0, 0x4f, 0xa3, 0xd2, 0x58, 0xd7, 0x86, 0x1, 0xce, 0x81, 0x48, 0xbb, 0x11, 0xd6, 0xbc, 0xe6, 0x9d, 0xb6, 0x4c, 0x4a, 0x68, 0x28, 0x48, 0xa2, 0x88, 0x5f, 0x8b, 0x95, 0x11, 0xfe, 0x23, 0x7e, 0x6a, 0x12, 0xea, 0x3d, 0x12, 0x68, 0x6a, 0xef, 0x6b, 0x52, 0xf8, 0xec, 0x89, 0x2d, 0xde, 0x53, 0xa0, 0x2c, 0xb8, 0xc8, 0xbd, 0x4f, 0x81, 0x95, 0x90, 0x7a, 0xa4, 0x3d, 0x1, 0xa6, 0x7b, 0x4f, 0xd6, 0x6b, 0xe0, 0xb2, 0x7, 0xe5, 0x6a, 0x9, 0x98, 0xd2, 0xdb, 0xf3, 0x82, 0x6, 0x2d, 0xbe, 0x3a, 0xf3, 0xce, 0x84, 0xe6, 0x70, 0xf, 0xe8, 0x7f, 0xcf, 0x3b, 0xf7, 0xce, 0x91, 0x76, 0x59, 0x3a, 0x2c, 0x42, 0x7f, 0x79, 0x74, 0x23, 0x51, 0x60, 0xc8, 0x15, 0x32, 0x4, 0x6, 0x3f, 0xdd, 0x24, 0x3c, 0x44, 0x95, 0xe, 0x7e, 0x30, 0xdc, 0x32, 0xf8, 0x85, 0x7f, 0x58, 0x9, 0x80, 0x5, 0xdf, 0xf8, 0x87, 0x49, 0xc8, 0xe, 0x35, 0x8c, 0x33, 0xa1, 0xc4, 0x83, 0x4, 0xf1, 0xc1, 0x90, 0x3, 0x77, 0x40, 0x75, 0xe2, 0xb, 0x1d, 0xe, 0x32, 0x18, 0x5d, 0x1c, 0x99, 0x3c, 0x2e, 0x2, 0x11, 0xc3, 0xc2, 0x12, 0x22, 0xd, 0xd, 0x5e, 0x45, 0xb7, 0x35, 0x93, 0x4a, 0x43, 0x6a, 0x4d, 0x13, 0x3, 0xac, 0x43, 0x54, 0xd2, 0x35, 0x80, 0x4b, 0x81, 0x88, 0x17, 0x82, 0x8e, 0x3e, 0xaf, 0x60, 0x85, 0x11, 0xf, 0x93, 0x66, 0x6c, 0x12, 0x3, 0x78, 0x82, 0xc0, 0x5, 0xc2, 0xc6, 0x93, 0x4b, 0x68, 0xe9, 0xcb, 0xac, 0x4, 0xa, 0xc4, 0xd7, 0xbe, 0xf7, 0xe9, 0x37, 0x5f, 0x3d, 0x16, 0xa2, 0xc1, 0x97, 0x24, 0x6a, 0x79, 0x26, 0xeb, 0x84, 0xb5, 0xb6, 0xc, 0xa0, 0x87, 0xe1, 0x38, 0xb6, 0xc, 0x30, 0x6c, 0xdd, 0xb3, 0xc1, 0xb5, 0x92, 0xe, 0x44, 0x62, 0x3, 0x62, 0xb0, 0x42, 0xfc, 0xf7, 0x6c, 0x7a, 0x1a, 0xd, 0x49, 0xb9, 0x87, 0xbf, 0x24, 0x74, 0x9f, 0x6f, 0x59, 0x55, 0x10, 0xc, 0x38, 0xe6, 0x4d, 0xe5, 0xa0, 0x13, 0x1f, 0xd7, 0x26, 0x7b, 0xcb, 0xbb, 0x8a, 0x48, 0xf5, 0x2d, 0x13, 0x8c, 0x5d, 0x57, 0x29, 0x6e, 0x11, 0x41, 0xa1, 0x1b, 0xda, 0x8f, 0x28, 0xab, 0x46, 0xc7, 0x7, 0x7, 0x8d, 0x4, 0x17, 0xb7, 0xb8, 0x65, 0xd8, 0x96, 0x6b, 0xd1, 0xf9, 0x80, 0x5f, 0x2, 0x6d, 0xa9, 0xa7, 0x7e, 0x8f, 0xad, 0xdf, 0xc7, 0x3, 0xb9, 0x55, 0x6b, 0x2a, 0xf4, 0x20, 0xae, 0xb6, 0x51, 0x77, 0x3f, 0xa1, 0xd1, 0xe5, 0x45, 0xe5, 0xeb, 0xf, 0xc0, 0x1a, 0x21, 0xf0, 0xac, 0xce, 0x2e, 0xd, 0x86, 0x43, 0x4a, 0x46, 0x88, 0x9d, 0x5, 0xb0, 0xc1, 0xde, 0x87, 0xce, 0xb3, 0x9e, 0xf8, 0x8f, 0x44, 0xeb, 0x2, 0xc0, 0xfd, 0x84, 0x72, 0x3, 0xac, 0x93, 0x95, 0xae, 0x81, 0x19, 0x7b, 0x70, 0x3a, 0x3c, 0x38, 0xa8, 0xfb, 0xa2, 0x5d, 0x1f, 0xa2, 0x9e, 0x7b, 0xcb, 0x60, 0xa8, 0x16, 0xac, 0x8, 0xc5, 0x9a, 0xc0, 0xc8, 0x7f, 0x21, 0xa6, 0x5f, 0xe0, 0x2a, 0xe2, 0xb4, 0x1c, 0xfb, 0x5, 0xdd, 0x4d, 0x8d, 0x39, 0xc6, 0xc1, 0xed, 0xad, 0x44, 0xb4, 0x72, 0x53, 0x4, 0xb3, 0x46, 0x1c, 0x6f, 0xd4, 0xe6, 0x6d, 0xc5, 0xc2, 0x69, 0xd5, 0x62, 0xf8, 0x25, 0x75, 0x9, 0x1d, 0xf, 0xb2, 0x8a, 0x5f, 0x4, 0xa, 0x5a, 0xa7, 0xb8, 0x96, 0xc0, 0xd6, 0x89, 0xd2, 0x4d, 0xc6, 0x9, 0xc6, 0xc0, 0xd, 0x9, 0xe0, 0x64, 0xa8, 0x91, 0x3d, 0xae, 0xe9, 0xd6, 0xe0, 0xf, 0xb7, 0x6c, 0x11, 0x77, 0xaf, 0x95, 0x1c, 0x46, 0x1b, 0x4e, 0xff, 0x2a, 0xf4, 0x74, 0x9a, 0x8b, 0x90, 0x53, 0x85, 0x31, 0xd1, 0x24, 0x5, 0xd7, 0x19, 0x7, 0x3, 0x3c, 0xc, 0xbe, 0x0, 0xc4, 0x5f, 0x1c, 0xbd, 0xf4, 0x47, 0x74, 0x2, 0xa9, 0x2f, 0xc1, 0x9c, 0xc5, 0xe2, 0x8, 0xaa, 0x5f, 0xac, 0x17, 0xf7, 0x46, 0x1, 0x2, 0xdb, 0xba, 0xac, 0xcc, 0xf3, 0x42, 0x8a, 0xba, 0x48, 0xee, 0x9b, 0xa6, 0xd, 0xc0, 0x6e, 0xd1, 0xc8, 0x62, 0x52, 0xd0, 0x6e, 0x19, 0xf0, 0x59, 0x5d, 0xb5, 0xc, 0x58, 0xe8, 0x8f, 0xba, 0x5b, 0xc0, 0x89, 0x84, 0x6d, 0x7e, 0x37, 0xa5, 0x46, 0xc6, 0x1a, 0x8f, 0x0, 0x53, 0xa0, 0x2f, 0x87, 0x14, 0x93, 0x3b, 0x31, 0x95, 0xc4, 0xce, 0x41, 0x8c, 0xf5, 0x61, 0x2c, 0x8b, 0xb, 0x2e, 0x36, 0x36, 0x75, 0x9d, 0xa, 0x63, 0xa5, 0xc5, 0xb1, 0xd8, 0x6, 0x21, 0x2c, 0x9d, 0x31, 0x7, 0xe8, 0x4c, 0xf0, 0xf7, 0x35, 0x28, 0xcb, 0x95, 0x44, 0xdc, 0xde, 0xde, 0xc0, 0xba, 0x30, 0xb5, 0x7, 0xb3, 0x45, 0xca, 0xbf, 0x2c, 0x4a, 0x6e, 0xae, 0x98, 0x26, 0xfd, 0xa9, 0x5a, 0x6a, 0x64, 0xae, 0x47, 0xc4, 0x87, 0xb5, 0x27, 0x4c, 0x9a, 0x8, 0x9c, 0x74, 0x30, 0x6, 0xfe, 0x7b, 0xdf, 0xe7, 0x93, 0x1a, 0x8, 0xd3, 0x0, 0x70, 0x6a, 0x58, 0x9f, 0xb8, 0x14, 0x7, 0x38, 0xe, 0xd2, 0x28, 0x15, 0x1c, 0xe9, 0xfe, 0x17, 0x50, 0x84, 0xa0, 0x54, 0x23, 0xb4, 0xb1, 0x5, 0xa6, 0x22, 0xdd, 0x6, 0x55, 0xa5, 0xec, 0x9d, 0xa2, 0x96, 0x56, 0x6e, 0x49, 0xaa, 0xf, 0x38, 0xb6, 0x2e, 0x48, 0x5b, 0xea, 0xb8, 0x93, 0xf0, 0x63, 0x4b, 0xa7, 0x12, 0xd0, 0x10, 0x62, 0x3a, 0xdd, 0xe6, 0xc1, 0x99, 0xc0, 0xc1, 0x93, 0x7, 0x7, 0xe1, 0x5b, 0x5d, 0x5c, 0xa8, 0xb1, 0x7d, 0x2b, 0xf6, 0x43, 0x8e, 0xce, 0x75, 0x8e, 0xbe, 0x55, 0x48, 0x6a, 0xb5, 0xdc, 0x24, 0xaf, 0x7d, 0xaf, 0xee, 0x12, 0x95, 0xa, 0xc4, 0x2c, 0xca, 0xcb, 0x14, 0x77, 0xed, 0x1d, 0x7b, 0xf8, 0x5c, 0x61, 0x14, 0xd1, 0x8c, 0xa0, 0x86, 0x65, 0x17, 0x55, 0x71, 0xb7, 0x61, 0x10, 0x3f, 0x53, 0xf, 0xb1, 0x25, 0x42, 0x36, 0x5d, 0x2, 0x6e, 0x2a, 0xef, 0x3b, 0x2e, 0x7, 0x1b, 0xf6, 0xdc, 0xb7, 0x24, 0x8, 0xd7, 0xd5, 0x10, 0x49, 0x24, 0x5b, 0x35, 0x9, 0x8e, 0xec, 0xff, 0x7d, 0xe9, 0x22, 0x25, 0x9a, 0xda, 0x15, 0x1c, 0x35, 0x2d, 0xb3, 0x93, 0xcf, 0x71, 0x71, 0x39, 0x35, 0x2b, 0x80, 0x57, 0x60, 0x38, 0xe9, 0x45, 0xf1, 0xe6, 0xbe, 0xfd, 0xab, 0x5b, 0x35, 0x81, 0xb0, 0xf0, 0x9a, 0x6e, 0x20, 0xaf, 0xe3, 0xe0, 0x24, 0xb4, 0x13, 0x61, 0x80, 0xf5, 0x4d, 0x5c, 0xeb, 0x82, 0x8f, 0x6, 0x76, 0xc7, 0x1d, 0x9f, 0xbb, 0xd9, 0x67, 0x8a, 0xc4, 0xa6, 0x1c, 0x25, 0xc7, 0x80, 0x36, 0x4f, 0x6a, 0xb1, 0xbe, 0xcb, 0xaa, 0x45, 0x27, 0x76, 0x17, 0x1a, 0x75, 0x44, 0x52, 0x82, 0x75, 0x40, 0x14, 0xf0, 0x66, 0xdd, 0xe0, 0x12, 0xc5, 0xf9, 0x42, 0x92, 0x8e, 0x4, 0x50, 0x62, 0x1, 0x38, 0x2c, 0xd3, 0x40, 0xe0, 0x5, 0x42, 0x72, 0xc8, 0xfa, 0xc, 0x3, 0xbc, 0x6d, 0x32, 0xb6, 0xfb, 0xf6, 0xd6, 0xa4, 0xb7, 0x4a, 0x50, 0x73, 0x2d, 0xe5, 0x2c, 0xb8, 0x51, 0x84, 0x3, 0xfb, 0x27, 0x41, 0x77, 0x12, 0x9b, 0x8c, 0x42, 0x10, 0xe2, 0xd5, 0x14, 0xe0, 0xa7, 0x9c, 0x63, 0xd3, 0xfe, 0xfe, 0x30, 0x8, 0x53, 0x9a, 0xa8, 0xac, 0x60, 0x8d, 0xb9, 0x1e, 0xa8, 0x6a, 0x18, 0x3f, 0xf5, 0x7c, 0x25, 0x8e, 0xd2, 0xd8, 0x63, 0x8c, 0xca, 0x8, 0x7d, 0xa7, 0xe9, 0x7, 0x81, 0x12, 0x68, 0x82, 0x18, 0x18, 0x75, 0x22, 0x3d, 0x7e, 0x30, 0xa6, 0x89, 0xa, 0x25, 0xab, 0x3c, 0x77, 0xc6, 0x84, 0xc4, 0x38, 0xbe, 0x40, 0x58, 0xec, 0x5a, 0xbd, 0xee, 0xe9, 0x2b, 0xfd, 0x57, 0x24, 0x17, 0x81, 0x2e, 0x9c, 0xd4, 0x71, 0xf6, 0x3, 0x36, 0x8f, 0xec, 0xd5, 0x48, 0x83, 0x30, 0x1e, 0xcf, 0x14, 0xe2, 0x9f, 0xe9, 0x35, 0x9b, 0xc3, 0x2a, 0xa9, 0x11, 0xce, 0x69, 0x71, 0x36, 0xb9, 0xbd, 0x9f, 0xf6, 0xfe, 0x8b, 0xad, 0xf2, 0x83, 0x16, 0x60, 0xab, 0xcd, 0x30, 0x80, 0xc8, 0x57, 0x69, 0xc6, 0x32, 0x69, 0x56, 0x90, 0xf6, 0xe5, 0xdd, 0xf0, 0x8e, 0x40, 0x38, 0xe6, 0x7e, 0xe2, 0x78, 0x17, 0x59, 0xda, 0xd9, 0x4e, 0x52, 0x96, 0xf5, 0x51, 0x90, 0xe7, 0x28, 0x40, 0xa6, 0x7c, 0x3e, 0x5f, 0x72, 0x17, 0x77, 0xef, 0x3c, 0xb3, 0xa, 0x68, 0x69, 0x32, 0x63, 0xa1, 0xce, 0x98, 0xa8, 0x43, 0x99, 0xda, 0x9d, 0x4, 0xe1, 0x34, 0x0, 0xa8, 0x43, 0x94, 0xe0, 0x3, 0xb8, 0xd, 0x70, 0x74, 0x82, 0x99, 0x59, 0xad, 0xf9, 0xa5, 0x5b, 0x96, 0xb2, 0x50, 0x3d, 0x94, 0xca, 0x8a, 0x4d, 0x29, 0x55, 0x33, 0xcf, 0x5, 0x3e, 0x5, 0xb4, 0xaf, 0x98, 0x82, 0xf8, 0xf6, 0x16, 0x55, 0xc5, 0xc0, 0x73, 0xf2, 0xab, 0xea, 0xee, 0xf6, 0xb0, 0xd4, 0xdd, 0x6d, 0xe1, 0xb5, 0x8f, 0xab, 0xad, 0x21, 0xc9, 0xda, 0x4a, 0x22, 0x9b, 0x38, 0x56, 0xc7, 0xa2, 0xf5, 0x35, 0x62, 0x1d, 0xab, 0xad, 0x27, 0xe4, 0xec, 0xeb, 0x43, 0xf0, 0xf, 0xc9, 0x3e, 0x30, 0xd4, 0xe0, 0x22, 0xf, 0x41, 0x3d, 0x60, 0xda, 0x44, 0x1e, 0xb9, 0xba, 0x8d, 0x10, 0x65, 0x18, 0xd8, 0xac, 0x8e, 0x79, 0xde, 0x7b, 0x6c, 0x49, 0x64, 0xf4, 0x4a, 0xc5, 0xb0, 0x49, 0x29, 0x8, 0x4a, 0x6e, 0xd8, 0x48, 0x89, 0xd4, 0xb5, 0xba, 0xe7, 0x85, 0x9e, 0xd7, 0x4b, 0x9c, 0x83, 0x34, 0xca, 0xcb, 0x61, 0xa2, 0x8e, 0xbc, 0x1e, 0x66, 0x52, 0x2b, 0xa8, 0xa5, 0x42, 0x53, 0x32, 0xed, 0xda, 0x24, 0x24, 0xb9, 0xbd, 0x1d, 0xdd, 0x39, 0x3, 0x81, 0x97, 0x90, 0xe1, 0xd5, 0xe8, 0x9a, 0x6e, 0x97, 0x48, 0x17, 0x9c, 0x8, 0x45, 0xf, 0xe9, 0xb6, 0x92, 0xe0, 0x3b, 0x31, 0x47, 0x90, 0xba, 0xd0, 0x20, 0x41, 0x28, 0x73, 0x64, 0x5a, 0xc2, 0xe4, 0x2, 0x0, 0x3, 0xc5, 0x94, 0xd8, 0x59, 0x9b, 0x6, 0x24, 0x1, 0xed, 0x84, 0x81, 0x78, 0xf, 0xe, 0x54, 0x97, 0x38, 0x57, 0xad, 0xa3, 0x4, 0xee, 0x4c, 0x27, 0x36, 0x5b, 0x38, 0x38, 0x48, 0xd4, 0x22, 0x41, 0xb6, 0x5a, 0x27, 0xd4, 0x7d, 0xf2, 0x30, 0x56, 0xc2, 0xeb, 0x43, 0x6b, 0x8d, 0xe2, 0xdd, 0xa7, 0xae, 0x35, 0x6b, 0x54, 0x41, 0xd6, 0xa, 0x13, 0xa7, 0x0, 0xf3, 0x9d, 0xe6, 0x4e, 0x99, 0x96, 0x66, 0x57, 0x40, 0x18, 0xc3, 0x8e, 0xdb, 0x8a, 0x4f, 0xc9, 0xcc, 0x26, 0x66, 0x77, 0xef, 0x44, 0x22, 0x58, 0x7, 0x34, 0x7e, 0xf9, 0x87, 0x5e, 0x69, 0x26, 0x93, 0xd4, 0xf2, 0x11, 0x95, 0x53, 0x53, 0x7, 0xde, 0x80, 0xe1, 0xb5, 0x75, 0x68, 0xb, 0xc9, 0xe2, 0xb4, 0xd0, 0x85, 0x76, 0xdf, 0xeb, 0xd5, 0x57, 0x47, 0x2b, 0xe6, 0xf5, 0x3f, 0x18, 0x35, 0xd, 0x95, 0x80, 0x3c, 0xba, 0xc6, 0x46, 0x17, 0x32, 0x29, 0x34, 0x17, 0x1a, 0x3f, 0x35, 0xb9, 0x10, 0xb2, 0x7f, 0xc4, 0x27, 0x3f, 0xf8, 0x1c, 0xed, 0x20, 0xd8, 0x65, 0xfc, 0xfe, 0xa7, 0x9b, 0x52, 0x2f, 0x91, 0xa9, 0x68, 0x1d, 0x23, 0x4a, 0xb5, 0xe6, 0xae, 0xe8, 0xe6, 0xe0, 0x62, 0xb3, 0xac, 0xb2, 0xd5, 0x92, 0x4f, 0xc, 0x52, 0x4a, 0xf2, 0x9d, 0x57, 0xac, 0xc8, 0x2c, 0x2f, 0xe8, 0x96, 0x13, 0x5, 0xbb, 0x42, 0xa, 0x6c, 0x9e, 0x6e, 0x3, 0x85, 0xc9, 0xa8, 0x37, 0x4f, 0x77, 0xa6, 0x7a, 0x67, 0xc2, 0x4, 0xa0, 0x49, 0xcb, 0xf5, 0x85, 0xc6, 0x2e, 0x9c, 0xa5, 0x68, 0xa7, 0x35, 0xb5, 0x74, 0x20, 0x5a, 0xc4, 0xfb, 0x85, 0x59, 0xa4, 0x7e, 0x3d, 0x55, 0x74, 0x4f, 0x65, 0x2, 0x85, 0xbd, 0xa9, 0x0, 0xb2, 0x38, 0x6c, 0xd8, 0xaa, 0x3f, 0xc3, 0x7f, 0xd9, 0x92, 0xcf, 0x50, 0x77, 0x86, 0x7f, 0xfa, 0x33, 0xfa, 0xb3, 0x1d, 0xc3, 0xc1, 0x8f, 0xab, 0x2c, 0xa9, 0x29, 0xc5, 0xaa, 0x28, 0x33, 0xb1, 0x4, 0x78, 0xdb, 0x38, 0x50, 0x3f, 0x23, 0x6f, 0xcd, 0x97, 0x31, 0x5e, 0xfa, 0x3, 0xc7, 0x27, 0x8a, 0x22, 0x3d, 0xa6, 0xfb, 0x2d, 0xe3, 0x68, 0x6, 0xc6, 0x1e, 0x8f, 0x5, 0xa7, 0x60, 0x1c, 0xc9, 0x47, 0xc5, 0x26, 0xc7, 0x1b, 0xf6, 0xc7, 0xcb, 0xc, 0x46, 0xfb, 0xc, 0x56, 0xd0, 0x57, 0x50, 0x71, 0x43, 0x83, 0x9b, 0xd2, 0xa8, 0x7a, 0x52, 0xc9, 0xb9, 0x8a, 0xe7, 0xfc, 0xfb, 0x6f, 0x68, 0x42, 0xc, 0xe7, 0x82, 0x1a, 0xc6, 0x95, 0x99, 0xf9, 0x83, 0xcc, 0x24, 0xbb, 0x8b, 0xf0, 0xab, 0xb8, 0x5a, 0xc, 0xd6, 0xd8, 0x5, 0xb0, 0xe8, 0x94, 0x14, 0x30, 0x61, 0x89, 0x61, 0x67, 0x89, 0xb4, 0x60, 0xb, 0x44, 0xbe, 0x34, 0x25, 0x1, 0xc4, 0x89, 0xb8, 0x35, 0xa, 0xe2, 0xe4, 0x94, 0x4e, 0x8e, 0x25, 0xaa, 0x84, 0xe5, 0x56, 0xc2, 0x39, 0xce, 0x7a, 0x26, 0xe7, 0x8a, 0x3f, 0x78, 0x9b, 0xf9, 0x9d, 0x31, 0xe2, 0x8d, 0x9b, 0xca, 0x10, 0xbd, 0xf1, 0x33, 0xc1, 0xf2, 0x9e, 0x3d, 0x14, 0xe6, 0xa2, 0xbc, 0xcd, 0x24, 0xb, 0xf6, 0xf4, 0x9, 0xa9, 0xa6, 0xe9, 0x4e, 0x38, 0xba, 0xd1, 0x37, 0xfe, 0x52, 0xc1, 0x1b, 0x37, 0xf4, 0xb2, 0x73, 0x34, 0xf9, 0xaa, 0x5b, 0x9e, 0x76, 0xb4, 0x4c, 0x77, 0x4f, 0xf3, 0x2d, 0x99, 0x6, 0x2d, 0x80, 0x87, 0xb7, 0xaf, 0x24, 0xd1, 0x12, 0x34, 0x48, 0x6f, 0x6f, 0x87, 0x80, 0xe1, 0xd2, 0xc9, 0x22, 0x42, 0xc3, 0xc0, 0x1e, 0x10, 0x9b, 0xde, 0xdf, 0x69, 0x8d, 0xc2, 0x6e, 0xc1, 0x45, 0x30, 0xf1, 0x2, 0x99, 0xaa, 0x1e, 0x7d, 0xac, 0xae, 0x54, 0x44, 0x7b, 0xc6, 0x6d, 0x47, 0xc, 0x63, 0x15, 0x9d, 0xe0, 0xd7, 0x64, 0xd1, 0x83, 0x8e, 0xa6, 0xaa, 0x23, 0x10, 0x41, 0x91, 0x4e, 0xf4, 0xbc, 0xb1, 0xf7, 0xee, 0xfd, 0x4d, 0xa9, 0xbf, 0x3b, 0xc5, 0x2c, 0x51, 0x1b, 0x60, 0xe0, 0x5, 0x50, 0xcb, 0x5e, 0x4, 0x5d, 0xf5, 0x16, 0x88, 0x91, 0x85, 0x41, 0x8a, 0x4b, 0xae, 0x9b, 0x48, 0x2e, 0x42, 0xc8, 0xd2, 0xc8, 0x3d, 0x23, 0xe6, 0x8, 0x6d, 0xce, 0xb3, 0xe6, 0x26, 0x75, 0x49, 0x85, 0x63, 0x48, 0x33, 0x45, 0x37, 0x65, 0xee, 0xe6, 0x4d, 0xa5, 0x89, 0x2d, 0xd5, 0x35, 0x88, 0x11, 0x69, 0x97, 0xbf, 0xa7, 0x85, 0x65, 0x4f, 0x49, 0xb, 0x89, 0xf7, 0x55, 0x71, 0x9a, 0xee, 0x68, 0xdc, 0x8d, 0x69, 0x70, 0xe7, 0x6b, 0x1b, 0x1a, 0x49, 0x22, 0x83, 0x1b, 0xd2, 0xe, 0xa, 0xe, 0xfe, 0x7b, 0xcd, 0xc1, 0x1b, 0x58, 0x88, 0x83, 0xac, 0x21, 0xa9, 0xdd, 0xd1, 0xcb, 0xb2, 0x77, 0x34, 0x77, 0x13, 0x3c, 0xc5, 0x66, 0xa9, 0x69, 0xfb, 0x86, 0xea, 0x50, 0x53, 0x41, 0x96, 0x6a, 0xba, 0x2e, 0xfa, 0x62, 0xbc, 0xe7, 0xf3, 0x9, 0x50, 0x51, 0x60, 0x70, 0x82, 0x5e, 0x3a, 0x78, 0x55, 0x64, 0x39, 0x11, 0x55, 0x38, 0xb3, 0x62, 0xb5, 0x15, 0xc5, 0x6e, 0x4c, 0x77, 0x27, 0xa3, 0x9c, 0x74, 0x4e, 0xb6, 0x71, 0x7, 0xb8, 0xf7, 0xbd, 0x96, 0x5c, 0xc7, 0xa9, 0x9e, 0xbe, 0x41, 0x56, 0xd3, 0xe0, 0x1e, 0x53, 0x4f, 0x1, 0xa1, 0x2a, 0xe2, 0x89, 0x5b, 0xc4, 0x70, 0x2, 0x70, 0xec, 0x64, 0xe3, 0xa9, 0xbc, 0xfa, 0xc6, 0x29, 0x29, 0x8e, 0xbf, 0x39, 0x1b, 0xc3, 0xe4, 0x72, 0xea, 0xda, 0x3e, 0x69, 0x2b, 0x32, 0xd3, 0x84, 0x62, 0x5e, 0x13, 0x7f, 0x2e, 0x3b, 0x2, 0xa1, 0x70, 0x7e, 0xd7, 0x68, 0x61, 0xd9, 0x7c, 0x32, 0x5, 0x99, 0xec, 0xcf, 0xea, 0xad, 0x9a, 0xa2, 0x38, 0xa, 0xa2, 0x98, 0x82, 0x2a, 0x4c, 0x98, 0xd, 0x8c, 0x75, 0x27, 0x34, 0xa2, 0x37, 0xa4, 0x4c, 0xd6, 0xc5, 0x72, 0xf9, 0xc2, 0x64, 0x66, 0xa6, 0x5a, 0x6c, 0x55, 0xd4, 0x41, 0x32, 0xbc, 0x9e, 0x2e, 0xec, 0xd5, 0x4c, 0xd9, 0xd8, 0xba, 0xc1, 0x48, 0x34, 0x2f, 0x5b, 0x37, 0xac, 0x52, 0xc, 0xd4, 0x6f, 0x20, 0x87, 0x64, 0xd2, 0x3a, 0xe0, 0xaa, 0x66, 0x34, 0xdd, 0x86, 0x5d, 0x99, 0xbe, 0xf1, 0xeb, 0x7b, 0xba, 0xc, 0xda, 0xaa, 0xc9, 0x7c, 0x89, 0x24, 0xe9, 0xde, 0xb3, 0xc1, 0xd2, 0xf7, 0x9e, 0xe, 0x35, 0x6d, 0xce, 0xe7, 0xfb, 0x7b, 0xcf, 0x7, 0xab, 0xee, 0x9c, 0x90, 0x64, 0x7f, 0xc4, 0xef, 0x1f, 0xc4, 0x84, 0x14, 0x19, 0x37, 0x6b, 0xb9, 0x66, 0xa3, 0xf5, 0xcf, 0x4c, 0x10, 0xee, 0x6, 0x7b, 0x21, 0x35, 0x92, 0x35, 0x97, 0xc1, 0xa3, 0x42, 0x9a, 0x76, 0x28, 0x56, 0x9c, 0xf4, 0x35, 0x13, 0xe2, 0x3d, 0x86, 0x82, 0xe3, 0x18, 0x6e, 0x81, 0x72, 0xab, 0x1a, 0x6a, 0x59, 0x52, 0xe2, 0x4b, 0x22, 0xba, 0xaf, 0xfc, 0x6c, 0x59, 0x88, 0xab, 0x8e, 0x40, 0xb0, 0x20, 0x17, 0x40, 0x82, 0xb3, 0xbc, 0xf, 0x5, 0xe0, 0xc8, 0x3, 0x89, 0x20, 0x4, 0x1, 0x3c, 0xcb, 0xce, 0xd2, 0x58, 0x42, 0x16, 0x27, 0x9e, 0xa7, 0x67, 0x97, 0x9e, 0x12, 0x8f, 0x47, 0x15, 0x84, 0x91, 0x1e, 0x36, 0xdf, 0x17, 0x6, 0x9b, 0xaa, 0x16, 0xf1, 0x1e, 0x77, 0x55, 0xa3, 0x91, 0x98, 0xf5, 0x68, 0xaa, 0x62, 0x3a, 0xbc, 0x66, 0xb3, 0xe4, 0x90, 0x45, 0xa3, 0xdb, 0xad, 0xe2, 0x3, 0x9f, 0x36, 0x94, 0xaa, 0x3b, 0xf5, 0xa, 0x4a, 0x9b, 0x13, 0xb7, 0xb7, 0xe2, 0xf6, 0x56, 0x5c, 0x26, 0x8e, 0x51, 0xbb, 0x2f, 0xb7, 0x20, 0xae, 0xd7, 0xff, 0xe0, 0xa0, 0xe6, 0xeb, 0xea, 0x95, 0xaa, 0x59, 0x3b, 0x54, 0x3, 0xc5, 0x56, 0x83, 0xf5, 0x5d, 0x34, 0x31, 0x46, 0xe8, 0x31, 0x91, 0xf2, 0xa, 0x2f, 0xcd, 0xe9, 0x5b, 0x1c, 0x7b, 0x76, 0xd6, 0x34, 0x71, 0x3d, 0x77, 0x62, 0x13, 0x65, 0xb8, 0xad, 0x2d, 0xed, 0x6, 0x47, 0x4e, 0x3d, 0x29, 0x89, 0xaa, 0xa6, 0x89, 0x1d, 0x90, 0x6d, 0xec, 0x8e, 0xb8, 0x98, 0x26, 0x96, 0x3, 0xec, 0xd6, 0x38, 0x5a, 0x9c, 0x8e, 0xd6, 0xe7, 0xc0, 0x88, 0x4e, 0xe6, 0x67, 0x1e, 0x9, 0xe6, 0x5e, 0x2f, 0x3d, 0xf, 0xbf, 0xa0, 0x94, 0xa6, 0x19, 0xc9, 0x99, 0x3c, 0xa7, 0x54, 0xc4, 0x9f, 0xd9, 0x80, 0xc, 0x2b, 0x36, 0x83, 0x5e, 0x43, 0xb7, 0x90, 0x3b, 0xaf, 0x31, 0x2c, 0xad, 0xe4, 0x54, 0x51, 0x3, 0xe, 0xc4, 0x10, 0x79, 0x2e, 0x9f, 0x64, 0x54, 0x40, 0xe5, 0x6c, 0xed, 0x20, 0x6, 0xf5, 0x8d, 0xc3, 0xf4, 0xc3, 0x63, 0x31, 0xc1, 0xf8, 0x3c, 0x6a, 0x5e, 0x9f, 0xb0, 0x19, 0x9c, 0x26, 0xe9, 0x7b, 0xa0, 0x2d, 0x8e, 0x1c, 0xa4, 0x2d, 0x6, 0x6, 0xd, 0xfd, 0x1f, 0xf4, 0x5d, 0x5, 0xaa, 0x49, 0x62, 0xbc, 0xc5, 0x15, 0xdf, 0xca, 0xa8, 0x7f, 0x1a, 0x9a, 0x96, 0x56, 0xc4, 0xf1, 0x45, 0x4e, 0xed, 0x25, 0x57, 0x8c, 0xee, 0x88, 0x90, 0x94, 0x73, 0xd, 0x58, 0x6, 0xe0, 0x8, 0xdc, 0x60, 0x16, 0x66, 0xa6, 0xd5, 0x66, 0x16, 0xd, 0xb1, 0xab, 0x6c, 0x80, 0x7a, 0x1c, 0xa9, 0xc0, 0xc1, 0x5b, 0x1c, 0x4c, 0x22, 0x25, 0x23, 0x5d, 0xdd, 0x86, 0xc7, 0x94, 0x12, 0x6a, 0xa1, 0xe0, 0x55, 0x64, 0xdc, 0xfe, 0xb4, 0xec, 0x7d, 0xd8, 0xc, 0x98, 0x45, 0x27, 0x4d, 0x5, 0x8c, 0x35, 0x27, 0xc8, 0xb5, 0xb4, 0x6c, 0xda, 0xca, 0x4c, 0xb3, 0xe4, 0x7b, 0x89, 0xa9, 0x1, 0x6, 0x4e, 0x5, 0xfa, 0x1, 0xde, 0xf0, 0x91, 0x54, 0x96, 0xc2, 0x64, 0xd8, 0xab, 0x83, 0x83, 0x1f, 0x1b, 0x7e, 0x45, 0xd2, 0x16, 0x46, 0x9f, 0x22, 0x58, 0xd6, 0xe7, 0x8f, 0x9f, 0x7d, 0xf1, 0xf4, 0x85, 0xb7, 0x6f, 0x26, 0xdb, 0x10, 0x8b, 0x86, 0xaf, 0x15, 0x49, 0xff, 0x64, 0xb, 0x7e, 0xf4, 0x2a, 0xbe, 0x8c, 0x1, 0xce, 0xb2, 0x55, 0x25, 0x6a, 0x61, 0x1e, 0x96, 0x29, 0xd7, 0xc9, 0xed, 0xad, 0x14, 0x5d, 0x38, 0xc8, 0x86, 0x82, 0xc9, 0x13, 0x9, 0x2c, 0xae, 0xb5, 0x4a, 0x44, 0x52, 0xb7, 0x81, 0x38, 0x82, 0x67, 0xe9, 0x24, 0xee, 0x79, 0x2f, 0xa, 0x60, 0x84, 0xc4, 0xc, 0xbc, 0x9e, 0x3f, 0x9d, 0x78, 0x62, 0x1e, 0x90, 0xf8, 0x90, 0x2c, 0xca, 0x3, 0x3, 0x96, 0xcc, 0x9b, 0xe4, 0x69, 0x80, 0x16, 0x92, 0x2, 0x6e, 0x89, 0x46, 0x3, 0x8, 0xbc, 0x1d, 0xfc, 0x58, 0x5b, 0xf8, 0x8, 0xdb, 0xc7, 0xb7, 0x83, 0x4d, 0x9e, 0xfd, 0x12, 0x3d, 0x82, 0x8f, 0x94, 0x43, 0x27, 0x59, 0xbc, 0xcc, 0xde, 0x72, 0x12, 0x14, 0xa2, 0x1f, 0x60, 0x18, 0x6f, 0xc9, 0x1d, 0xee, 0x2d, 0x4b, 0xb6, 0xb0, 0x94, 0x72, 0x6, 0xc2, 0x45, 0x8e, 0xfe, 0x95, 0x4e, 0x14, 0x70, 0x14, 0x65, 0xde, 0x7, 0x20, 0x37, 0xaa, 0x4f, 0x51, 0xc4, 0xbe, 0x24, 0xd1, 0x3e, 0xe, 0x4b, 0xcb, 0x2a, 0xf7, 0xe7, 0xb7, 0x19, 0xc8, 0x1c, 0xbe, 0xf8, 0x88, 0xa6, 0xbd, 0x9e, 0xe1, 0x96, 0x71, 0x51, 0xbb, 0xa0, 0x10, 0xaf, 0x86, 0xf3, 0x64, 0xd3, 0x41, 0x5e, 0x6, 0x82, 0x45, 0x5, 0x9a, 0x87, 0x3f, 0x24, 0x40, 0xfb, 0xf3, 0x33, 0xe9, 0x83, 0x77, 0x76, 0xde, 0x96, 0xe3, 0x75, 0x9f, 0xfb, 0x3e, 0xda, 0x45, 0x4f, 0x7, 0xa4, 0xb8, 0xe1, 0xfb, 0x80, 0xae, 0x38, 0xfe, 0xcc, 0x4b, 0xc0, 0xa8, 0x5c, 0x63, 0xd4, 0x12, 0x76, 0x38, 0x39, 0x38, 0x40, 0xf, 0xa1, 0x59, 0x8e, 0xe6, 0x2, 0x4b, 0x60, 0x24, 0x81, 0x87, 0x25, 0x6d, 0xf, 0x5f, 0xee, 0x47, 0xa4, 0xb2, 0xd7, 0x23, 0x35, 0x34, 0xe4, 0xbe, 0xe7, 0xf5, 0x62, 0xc5, 0x29, 0x7a, 0x3, 0x4f, 0x4b, 0xba, 0x3c, 0x24, 0x13, 0xbe, 0xbc, 0xc, 0x6b, 0xf3, 0x3d, 0x32, 0x78, 0x1, 0x89, 0x41, 0xb3, 0xba, 0x86, 0x2f, 0x48, 0x61, 0xda, 0x6b, 0x99, 0x2e, 0x5f, 0x93, 0xf0, 0xa7, 0xdb, 0x3d, 0x74, 0xf9, 0xd2, 0x88, 0x16, 0x6a, 0x2, 0x9f, 0x39, 0x38, 0xdc, 0x9b, 0x0, 0xe3, 0x8c, 0x5, 0xf6, 0x1a, 0x7e, 0x60, 0x2b, 0x5b, 0xc3, 0x4, 0x3b, 0xbe, 0x84, 0xe9, 0x66, 0xb4, 0x4, 0xe4, 0x5e, 0x76, 0x7b, 0xbb, 0xbf, 0x6f, 0x38, 0xf3, 0xfc, 0x62, 0xf4, 0xfd, 0x9a, 0xb4, 0x51, 0x50, 0xf6, 0x95, 0x50, 0x4b, 0xd5, 0xa5, 0xd6, 0xc2, 0x74, 0x19, 0x30, 0xd8, 0x2, 0xed, 0x96, 0xc5, 0xa, 0x5c, 0x44, 0x78, 0xa5, 0xcf, 0x8a, 0x68, 0x7e, 0x76, 0x81, 0xce, 0x62, 0xf8, 0x7, 0x5d, 0x96, 0xc6, 0x69, 0xcd, 0x8f, 0x1e, 0x39, 0xb8, 0x51, 0xb1, 0xc9, 0x64, 0xfb, 0x8f, 0x18, 0x2d, 0xd5, 0xe6, 0x52, 0xbe, 0xc2, 0x13, 0xca, 0x3c, 0x95, 0xb, 0x5b, 0xf2, 0x79, 0x84, 0x95, 0x80, 0xcd, 0x9d, 0xe5, 0x11, 0x7, 0xc, 0xd, 0xdb, 0x12, 0x2d, 0xe0, 0x2f, 0x4d, 0xe8, 0x35, 0xdd, 0xe0, 0xb6, 0x75, 0xae, 0x48, 0x9c, 0x96, 0x31, 0x48, 0xeb, 0x2f, 0x0, 0xd9, 0x72, 0x45, 0xfe, 0xf6, 0xe1, 0x90, 0x26, 0xfb, 0x42, 0xb1, 0x7, 0xeb, 0x12, 0x37, 0xac, 0x1, 0x12, 0x24, 0x2b, 0x40, 0xd, 0x9d, 0xf6, 0x40, 0xfa, 0x22, 0x15, 0xba, 0x86, 0x65, 0x8d, 0x32, 0x1a, 0x1c, 0xfc, 0x5, 0x11, 0x7c, 0x4c, 0x76, 0x75, 0x57, 0xd7, 0x51, 0x53, 0xd, 0x14, 0x5d, 0xa1, 0x68, 0x0, 0x1d, 0x65, 0xe5, 0x17, 0x17, 0x17, 0x3c, 0xcd, 0x60, 0x48, 0x28, 0xc9, 0xc6, 0xf3, 0x18, 0x8b, 0x3d, 0x7, 0x7e, 0x62, 0xc5, 0x53, 0x20, 0x2f, 0x37, 0xb0, 0x57, 0x71, 0x15, 0x47, 0x33, 0x61, 0x3e, 0x1f, 0x2d, 0xe5, 0x20, 0xa6, 0x68, 0xcc, 0xc, 0x83, 0x28, 0x51, 0x25, 0x8c, 0x9e, 0x81, 0xf0, 0x9f, 0x32, 0x1e, 0x91, 0x39, 0x41, 0xcd, 0x74, 0x91, 0xfd, 0x19, 0xac, 0x48, 0x3c, 0x40, 0x45, 0x3e, 0xc, 0xfb, 0x53, 0x3e, 0x8b, 0x37, 0x4b, 0xe4, 0xe4, 0x0, 0x9c, 0xa1, 0x33, 0xa3, 0x6f, 0x54, 0x30, 0xa5, 0xc0, 0xb, 0xcc, 0x7, 0x19, 0x30, 0x79, 0x82, 0x44, 0xb0, 0x42, 0xc8, 0x6e, 0x73, 0xa0, 0x3f, 0x4d, 0xfb, 0x25, 0xe4, 0x7d, 0xa7, 0x78, 0xd7, 0xdc, 0x32, 0x6c, 0xfa, 0xc5, 0x87, 0xcd, 0xc0, 0x65, 0xa1, 0x35, 0x60, 0x2b, 0x7f, 0xe, 0x30, 0x62, 0x1d, 0x9b, 0x52, 0x1d, 0x70, 0xa6, 0x65, 0x1a, 0x3c, 0xc2, 0x63, 0x9f, 0xac, 0xb1, 0x83, 0xdd, 0x0, 0x3, 0x7b, 0x5a, 0x23, 0x8, 0x67, 0x36, 0x6c, 0x7, 0xaf, 0xf8, 0xde, 0xfc, 0x6c, 0x76, 0x7e, 0x36, 0x1d, 0x64, 0xe7, 0xcc, 0x13, 0xb4, 0xa1, 0x35, 0x7e, 0xf2, 0xa0, 0x75, 0xe4, 0xc1, 0x14, 0xa6, 0x38, 0x85, 0xa9, 0x9e, 0x2, 0x8a, 0xc0, 0x2, 0x53, 0xeb, 0x49, 0x5c, 0x99, 0x12, 0x9b, 0xf, 0xc8, 0x6c, 0x1f, 0xfa, 0x2a, 0xe5, 0xa, 0x3f, 0x15, 0xeb, 0xcd, 0xd1, 0x22, 0x0, 0xf3, 0x40, 0xe0, 0x9a, 0xe2, 0xa2, 0x13, 0x9d, 0x7d, 0x63, 0xaa, 0x71, 0x12, 0x75, 0x75, 0x96, 0xc2, 0x56, 0x8e, 0xa7, 0xd, 0x56, 0xc1, 0x60, 0x17, 0xcf, 0x92, 0xf3, 0xa8, 0x62, 0x80, 0xbe, 0xb8, 0x84, 0x85, 0xd4, 0x80, 0xc6, 0x2d, 0x9b, 0x62, 0xfe, 0x6, 0xc0, 0xd1, 0x4f, 0x1, 0x1e, 0xed, 0x41, 0xec, 0x23, 0xb4, 0xb4, 0x93, 0xd1, 0xe3, 0x6, 0x9b, 0x27, 0xe4, 0x8f, 0xeb, 0x91, 0x4e, 0x50, 0x88, 0xd5, 0x49, 0x4, 0x3e, 0xc0, 0xda, 0x92, 0x42, 0xc9, 0x84, 0x1f, 0xb4, 0x72, 0x68, 0x25, 0x12, 0x57, 0xe5, 0xbb, 0xd6, 0x20, 0xaa, 0x0, 0xb6, 0xc, 0x2c, 0x73, 0x6d, 0x5a, 0xa1, 0xdc, 0x14, 0xeb, 0xc, 0x18, 0xfa, 0x78, 0x49, 0x3b, 0x10, 0xc6, 0x5b, 0xd3, 0x44, 0xf6, 0x52, 0x19, 0x92, 0x3, 0xfe, 0x41, 0x2e, 0x11, 0xe6, 0x81, 0x6b, 0x89, 0x9f, 0xa4, 0x30, 0x52, 0x90, 0x7e, 0x45, 0xd6, 0x18, 0x5b, 0x61, 0xe2, 0x39, 0x8d, 0x46, 0xd0, 0xae, 0xf0, 0xb0, 0xa9, 0xcd, 0x5b, 0x85, 0xfb, 0x1b, 0xba, 0xa1, 0xd4, 0xc6, 0xbd, 0x6c, 0xe6, 0x30, 0x92, 0x6d, 0xeb, 0xf0, 0xb6, 0xa8, 0x5d, 0xdd, 0xb2, 0x5, 0xfe, 0x93, 0x45, 0x5e, 0x91, 0xcf, 0x0, 0x33, 0x95, 0x19, 0xb9, 0x94, 0x4a, 0x92, 0xfe, 0xa, 0xd, 0x1f, 0x21, 0x31, 0xf4, 0x54, 0x1e, 0x9b, 0x2e, 0x37, 0x6b, 0xf9, 0xb3, 0xd8, 0x54, 0x1e, 0xf9, 0xd4, 0x5d, 0x14, 0x9b, 0x92, 0xe3, 0x9a, 0x40, 0xe, 0x7d, 0x3, 0xe4, 0xad, 0x3d, 0x46, 0x9f, 0x4b, 0x1e, 0x5f, 0x72, 0x95, 0x8c, 0x15, 0xc6, 0xb, 0x60, 0x7c, 0xb2, 0xe4, 0x75, 0xb4, 0x18, 0x50, 0x22, 0xf4, 0x93, 0xab, 0xef, 0xcd, 0x4a, 0x7d, 0x21, 0xf0, 0x46, 0xde, 0x57, 0xf8, 0x49, 0x2b, 0x58, 0x7a, 0x8, 0x66, 0xf8, 0x15, 0xdd, 0xa0, 0xdd, 0xd9, 0x5a, 0x99, 0xea, 0x81, 0xd0, 0x1e, 0x37, 0xd1, 0x92, 0xbe, 0x3, 0x98, 0x47, 0xc7, 0x96, 0xfa, 0x1d, 0x77, 0xb8, 0x61, 0xd, 0x7f, 0x4c, 0xfa, 0x49, 0xd4, 0x26, 0x8a, 0x2a, 0xb, 0x7, 0x9c, 0x4e, 0x25, 0x68, 0x26, 0x6c, 0xe, 0xa8, 0x53, 0xe2, 0xa5, 0x66, 0x4b, 0x41, 0x10, 0x1a, 0x80, 0xab, 0xb6, 0x70, 0x21, 0x38, 0x1, 0x22, 0x22, 0x8b, 0x2d, 0xf4, 0x84, 0xee, 0x44, 0x8a, 0x18, 0xcc, 0x27, 0x80, 0x53, 0x36, 0xb9, 0xb0, 0xb4, 0x9f, 0xa, 0x4f, 0x47, 0x35, 0x1b, 0xd9, 0x25, 0xb2, 0x73, 0x6c, 0x8e, 0x6d, 0x8b, 0x64, 0x55, 0x6c, 0x5c, 0x2d, 0xd6, 0xc5, 0x1b, 0xa2, 0xa4, 0x78, 0x6d, 0x43, 0xa6, 0xae, 0xbe, 0xc7, 0xaf, 0x56, 0xa4, 0xd0, 0xdf, 0xd3, 0x9e, 0xf9, 0x68, 0xa6, 0x87, 0xc8, 0x1e, 0x1d, 0xd4, 0xba, 0xac, 0xaf, 0x85, 0xc, 0xa1, 0x52, 0x65, 0x85, 0x4d, 0xde, 0xaa, 0xd2, 0xa8, 0x30, 0x9b, 0x49, 0x6b, 0x5e, 0x2a, 0xf, 0xac, 0x6c, 0xa3, 0x7d, 0x43, 0xf1, 0x63, 0xf5, 0x0, 0xf8, 0x71, 0x4, 0xb, 0x84, 0x8b, 0x5d, 0xb5, 0x17, 0x1b, 0xed, 0xc5, 0x37, 0x8e, 0xe4, 0x11, 0xb9, 0xf1, 0xfd, 0x24, 0x7c, 0x19, 0x6f, 0x8d, 0xe3, 0xfc, 0xc1, 0xed, 0x32, 0xbe, 0xe6, 0xeb, 0xb3, 0xef, 0x7f, 0x38, 0xff, 0x20, 0x40, 0x5f, 0xbe, 0x1b, 0x9b, 0x2a, 0x0, 0xd7, 0xd9, 0x3a, 0xba, 0x1e, 0x43, 0x32, 0xe1, 0xa2, 0x55, 0x58, 0x7a, 0x7, 0xd, 0x13, 0x15, 0x1b, 0xe5, 0x1d, 0xc5, 0xb6, 0xe3, 0x58, 0x8, 0x9f, 0x4b, 0xe, 0x19, 0xfc, 0xae, 0x95, 0x57, 0x6, 0xef, 0x72, 0xe5, 0xef, 0x57, 0xd, 0xd6, 0xdf, 0xaa, 0xb7, 0xcc, 0x2e, 0x79, 0xe4, 0x36, 0x16, 0xd5, 0x4c, 0x7, 0x89, 0xdb, 0x81, 0x1e, 0x97, 0x6f, 0x5c, 0x3, 0x15, 0x6b, 0xea, 0x43, 0x5a, 0xe, 0x88, 0xe1, 0x67, 0xf7, 0x6d, 0xb0, 0x1e, 0xf3, 0x1d, 0x4d, 0x16, 0xb9, 0xd9, 0xe2, 0xdc, 0x64, 0xb5, 0x5e, 0xb3, 0x25, 0xbb, 0xb0, 0xcd, 0xf7, 0x80, 0x7b, 0x41, 0x6f, 0xb3, 0x89, 0x2f, 0x49, 0xcc, 0xb4, 0x71, 0x53, 0x70, 0x21, 0x80, 0xa, 0x9b, 0x99, 0x42, 0x33, 0x40, 0x26, 0x2e, 0x2, 0x90, 0x8a, 0x81, 0xb2, 0x3, 0xbb, 0xe2, 0x67, 0xf0, 0x6f, 0x46, 0xd8, 0x1e, 0xb0, 0x6b, 0x6, 0xdc, 0xd4, 0x22, 0x9a, 0xa3, 0x97, 0x17, 0x10, 0x13, 0xee, 0x2f, 0x20, 0x73, 0x21, 0x2c, 0xd9, 0xc9, 0x69, 0xb, 0x73, 0xd1, 0xe3, 0x5e, 0x31, 0x17, 0x59, 0xb4, 0x81, 0xd6, 0x9a, 0xda, 0x57, 0xa4, 0xec, 0x20, 0x74, 0xf9, 0xaf, 0x5d, 0x6e, 0x8, 0xa5, 0xf, 0x92, 0x34, 0xc9, 0x4a, 0x28, 0x9b, 0x65, 0x6e, 0x6, 0xb, 0x39, 0x2b, 0x68, 0x60, 0xd9, 0xe6, 0xe6, 0x0, 0x6d, 0xc7, 0xe8, 0x4c, 0x44, 0xac, 0x5c, 0x30, 0x90, 0x36, 0x7f, 0xc0, 0x66, 0x70, 0x65, 0xc7, 0x63, 0xb8, 0x16, 0xce, 0xe8, 0xee, 0x91, 0xdc, 0x61, 0x84, 0xef, 0x8f, 0x8f, 0x8e, 0x4e, 0xec, 0x26, 0xd9, 0xac, 0x51, 0xae, 0x15, 0xfc, 0x60, 0x38, 0x63, 0x8, 0x14, 0x9f, 0x65, 0x6b, 0xa0, 0x8a, 0x1c, 0x89, 0xe8, 0x6b, 0x58, 0x91, 0x40, 0xe, 0x6c, 0xc6, 0x0, 0x95, 0x74, 0x61, 0x33, 0x86, 0x6e, 0x78, 0x6, 0x37, 0xb8, 0x46, 0x77, 0x24, 0xd8, 0x2b, 0x60, 0x49, 0xd9, 0xf2, 0xf6, 0xf6, 0xb5, 0xb4, 0x0, 0xa6, 0x2d, 0x9d, 0xcd, 0x6c, 0xef, 0xbf, 0xb9, 0xc2, 0xa4, 0xef, 0xb4, 0x97, 0xb, 0x89, 0x51, 0x52, 0xe1, 0x54, 0xb4, 0xa0, 0x8d, 0x4c, 0x69, 0x23, 0x71, 0x3b, 0xe7, 0x6a, 0x23, 0xe7, 0x51, 0xa, 0x74, 0x30, 0x41, 0x45, 0x80, 0xdc, 0xaa, 0x39, 0x6e, 0xd5, 0xa2, 0x75, 0x3d, 0x52, 0x2a, 0x2d, 0xf2, 0x9c, 0xa5, 0xc6, 0x70, 0x81, 0xc, 0xce, 0xe7, 0x7c, 0xed, 0x6, 0xec, 0x69, 0x34, 0x13, 0x64, 0xd9, 0xf6, 0x81, 0xc1, 0x71, 0xc7, 0x3, 0x22, 0x44, 0xa8, 0x40, 0xbe, 0x12, 0x92, 0x9b, 0xe0, 0x58, 0xc5, 0x5, 0x75, 0xab, 0xf7, 0x29, 0x1, 0x2, 0x49, 0x23, 0x20, 0x55, 0x1b, 0x91, 0x52, 0x24, 0xf9, 0x15, 0xf6, 0xec, 0x54, 0x48, 0xde, 0xe4, 0xcb, 0x1f, 0xe8, 0xa2, 0x89, 0x86, 0x2e, 0x68, 0x8f, 0x49, 0x3d, 0x7a, 0xa6, 0x5d, 0xc4, 0xc0, 0xca, 0x22, 0x67, 0x24, 0x79, 0x3b, 0x21, 0xe7, 0xf5, 0x79, 0x9c, 0xa7, 0x4b, 0xb4, 0x50, 0x46, 0xc4, 0xd0, 0x98, 0xb3, 0xcc, 0x73, 0x10, 0x4a, 0x60, 0x59, 0x77, 0x5c, 0x35, 0xc1, 0xf9, 0xc2, 0xab, 0x0, 0x0, 0x99, 0xc6, 0x42, 0x4c, 0xf1, 0xda, 0x43, 0x2d, 0x43, 0x2a, 0x41, 0x17, 0x8e, 0x92, 0xdc, 0xe2, 0xb, 0x74, 0x6a, 0x93, 0xca, 0x83, 0x69, 0xe0, 0x76, 0x50, 0xe5, 0x91, 0x64, 0x47, 0x61, 0xaf, 0xa1, 0x89, 0x3b, 0x24, 0x8, 0xc, 0x59, 0xa0, 0x63, 0x54, 0x4, 0x8c, 0x6f, 0x99, 0xe2, 0x4c, 0xf6, 0x14, 0x4b, 0x22, 0x3e, 0xf6, 0x90, 0x4f, 0xd9, 0x43, 0x67, 0xef, 0xbd, 0x35, 0x47, 0x63, 0xe7, 0x3d, 0xa1, 0x37, 0xdb, 0xdb, 0xe4, 0x94, 0x48, 0x2c, 0xc8, 0x5e, 0x3a, 0x5d, 0x8a, 0xf, 0xcd, 0x89, 0xec, 0x49, 0x3e, 0x64, 0x4f, 0x73, 0x21, 0x7b, 0x9a, 0xa3, 0xd9, 0x53, 0x4c, 0xcc, 0x5e, 0xcd, 0xf0, 0xec, 0xd5, 0x4c, 0xce, 0x5e, 0xb2, 0x88, 0xf3, 0x39, 0x74, 0x44, 0xb8, 0x6f, 0xef, 0x35, 0xbf, 0xa6, 0x6, 0xe1, 0x2f, 0x10, 0xa4, 0xb2, 0xc4, 0xf, 0x68, 0x97, 0x37, 0x9d, 0x52, 0x9c, 0xbc, 0x7e, 0xdc, 0xd4, 0x1f, 0xee, 0x36, 0x28, 0x98, 0x92, 0x2f, 0x21, 0x53, 0x36, 0xda, 0x72, 0xbb, 0x51, 0x5f, 0x86, 0xe6, 0x9b, 0x62, 0xbf, 0x1a, 0xa4, 0x7c, 0x46, 0xb7, 0x58, 0xd2, 0xdb, 0x4f, 0x6c, 0x52, 0x20, 0xfd, 0xa8, 0x35, 0x6e, 0x97, 0xe, 0xba, 0xb4, 0xdb, 0xb, 0x12, 0x97, 0x3d, 0xc9, 0x8c, 0xa1, 0xe, 0x7d, 0x7f, 0x88, 0x9c, 0xd3, 0x34, 0x50, 0xa, 0x5e, 0x2, 0xf6, 0x69, 0xe0, 0x4d, 0x37, 0xd3, 0xe9, 0x92, 0x97, 0x1e, 0x22, 0x28, 0x28, 0xb5, 0x3f, 0x3d, 0xe3, 0xe7, 0x61, 0x2, 0xff, 0x44, 0xf8, 0x55, 0xdf, 0xfd, 0xa2, 0x3, 0xa3, 0x68, 0x1b, 0xf, 0xfd, 0xfe, 0x30, 0x60, 0x57, 0xe8, 0x1d, 0xb2, 0xf5, 0x77, 0xa9, 0x5b, 0x2e, 0x7c, 0xc9, 0x59, 0x8, 0xe9, 0x42, 0xc1, 0x62, 0xed, 0x2a, 0x5, 0x28, 0x54, 0x9f, 0x5, 0xc0, 0x59, 0x0, 0x54, 0xfb, 0xdc, 0xc1, 0xbc, 0xfb, 0xb6, 0xba, 0x83, 0x49, 0xaf, 0x65, 0xad, 0x52, 0x98, 0x2f, 0x8b, 0x69, 0xbc, 0x9c, 0x5c, 0xa0, 0xec, 0x26, 0x24, 0x3a, 0x5, 0x77, 0x86, 0x46, 0x3, 0x63, 0x5b, 0xc8, 0x92, 0x7, 0x7, 0x74, 0x7, 0x3c, 0x10, 0x21, 0x5, 0x7a, 0xbd, 0x83, 0x3, 0x3c, 0x5d, 0xc4, 0xbd, 0x79, 0xf1, 0xab, 0xf8, 0xea, 0x39, 0x9c, 0x8d, 0xca, 0xd6, 0x61, 0x58, 0xb5, 0xf7, 0xfb, 0x7d, 0x55, 0xb9, 0x5d, 0x15, 0xaf, 0x10, 0x2c, 0x6d, 0x6, 0x33, 0x34, 0x0, 0x64, 0x8f, 0x78, 0xa5, 0x55, 0xdf, 0x53, 0x69, 0x4d, 0xf9, 0x1c, 0x68, 0x82, 0xc0, 0xe9, 0x9, 0xde, 0x75, 0x6, 0x12, 0x7d, 0xd2, 0x99, 0x17, 0xed, 0x3e, 0xd2, 0xe5, 0x3c, 0x76, 0x6, 0x45, 0xa4, 0x63, 0x17, 0x1e, 0x31, 0xdf, 0x28, 0x66, 0x16, 0x68, 0xc7, 0x1a, 0x59, 0xd7, 0xbc, 0x9e, 0x34, 0x95, 0x54, 0x3, 0x2, 0x72, 0xe6, 0x95, 0x9b, 0x24, 0x1, 0xd0, 0xf7, 0xc6, 0xe8, 0x6e, 0x47, 0x9f, 0x62, 0x48, 0xa8, 0x71, 0x9e, 0x21, 0xb3, 0x4b, 0x41, 0x50, 0xe0, 0x74, 0x14, 0xcb, 0x4b, 0x61, 0xcd, 0xc8, 0xb1, 0xa7, 0x19, 0xf5, 0x45, 0xe4, 0x56, 0x8e, 0x41, 0xb6, 0xc3, 0xce, 0xb0, 0xaf, 0x18, 0x32, 0x2b, 0x20, 0x5f, 0x76, 0xb8, 0x15, 0x87, 0xf4, 0x9d, 0xea, 0xc5, 0x49, 0x7, 0x74, 0xee, 0x44, 0xef, 0x33, 0x74, 0x9a, 0x81, 0xc3, 0x22, 0xa4, 0xce, 0x35, 0x47, 0xc, 0x4f, 0x9d, 0x23, 0x45, 0xc4, 0x1c, 0xea, 0x3c, 0x85, 0x61, 0x50, 0xe7, 0xc2, 0x8d, 0xc, 0xb3, 0x40, 0x1a, 0x3, 0x44, 0x46, 0xbd, 0x8b, 0x39, 0xd7, 0xbd, 0x57, 0x8a, 0x45, 0x93, 0x46, 0x2f, 0xba, 0x67, 0xfc, 0x12, 0xa1, 0x27, 0x94, 0x1b, 0x1, 0x75, 0x4d, 0xd6, 0x6b, 0xa2, 0xfd, 0xc7, 0x32, 0x5f, 0xcc, 0xe, 0x5a, 0x5f, 0xf9, 0xe6, 0xbc, 0x36, 0x40, 0x4c, 0xea, 0x5f, 0x97, 0xa6, 0xba, 0x11, 0x75, 0x20, 0x91, 0xb6, 0xd7, 0x1a, 0x7b, 0x20, 0xcc, 0xe0, 0x4d, 0xf, 0x13, 0x19, 0xd1, 0xab, 0x89, 0x8, 0xf0, 0x11, 0xc2, 0x77, 0x36, 0xf1, 0x5e, 0x95, 0x40, 0x7f, 0xc2, 0xb9, 0x8e, 0xe6, 0xe2, 0x49, 0xd, 0x6f, 0xb8, 0x50, 0x49, 0x40, 0xa8, 0xae, 0xa0, 0x3c, 0xe0, 0x5, 0x11, 0x12, 0xa4, 0xee, 0xf6, 0x8d, 0x15, 0x79, 0x9, 0xfd, 0x77, 0x27, 0x71, 0xe8, 0xc7, 0x3d, 0xef, 0xc0, 0xeb, 0x4d, 0x8d, 0x48, 0x50, 0x67, 0x7, 0x93, 0xf3, 0x9b, 0x11, 0x3b, 0xde, 0x1e, 0x31, 0x6f, 0xe2, 0xd9, 0x6a, 0x5, 0x4, 0x77, 0xc0, 0xf4, 0xb8, 0x91, 0x9f, 0xc6, 0x55, 0x8c, 0x4a, 0x96, 0x94, 0xfe, 0xd6, 0x66, 0x7b, 0x82, 0x7b, 0xf2, 0x45, 0x86, 0x90, 0xbb, 0x49, 0x5f, 0x44, 0xe, 0x1, 0xf1, 0x85, 0xfc, 0x89, 0x34, 0x65, 0x1d, 0xa7, 0x74, 0xb, 0x14, 0x2f, 0x41, 0x8, 0xdf, 0x17, 0xe9, 0xa8, 0xf8, 0x94, 0x5a, 0xec, 0xbf, 0x3c, 0x41, 0x7d, 0xb7, 0xf8, 0xd9, 0x54, 0x75, 0x43, 0x2b, 0x9b, 0xf5, 0x32, 0x7a, 0x23, 0xfe, 0x32, 0xd9, 0x99, 0xfc, 0x1b, 0xb5, 0x20, 0xfc, 0xda, 0xd7, 0x50, 0x55, 0x7, 0x42, 0xd0, 0xb2, 0x36, 0x6c, 0x15, 0xe9, 0xe6, 0x88, 0x27, 0x61, 0x89, 0xaa, 0xce, 0xac, 0x32, 0xc8, 0xc5, 0xc8, 0x32, 0x2a, 0xff, 0x6, 0xba, 0xe, 0xa7, 0xc2, 0x76, 0x2d, 0x61, 0xf2, 0x70, 0x84, 0x29, 0x25, 0xa0, 0x40, 0x7, 0xec, 0x5a, 0x3d, 0x84, 0x87, 0xbe, 0xd, 0xd8, 0xc0, 0xfa, 0xc4, 0xca, 0x61, 0x17, 0x6, 0x0, 0x9c, 0x6b, 0x93, 0x5f, 0x1, 0x7c, 0x28, 0x69, 0x70, 0xc2, 0xc, 0xee, 0x95, 0xee, 0x3f, 0xe4, 0x22, 0x67, 0x4, 0xff, 0xc0, 0x41, 0xa6, 0x13, 0xe8, 0xad, 0xe7, 0x9d, 0x79, 0x3d, 0x7f, 0x51, 0x47, 0x7c, 0x8b, 0xa2, 0x99, 0x71, 0x23, 0x33, 0x9b, 0x24, 0x64, 0xc6, 0xe0, 0x9d, 0x7b, 0x88, 0x50, 0xf, 0xe, 0xe6, 0x13, 0x52, 0x91, 0xf9, 0xd9, 0x20, 0x8f, 0x2f, 0x80, 0xdf, 0x95, 0x96, 0x62, 0x61, 0x5d, 0xe3, 0xf6, 0x96, 0x9c, 0xbd, 0xeb, 0xe6, 0x26, 0x38, 0x8d, 0x8c, 0x91, 0x45, 0x9d, 0xa8, 0x8c, 0x3, 0xda, 0xa, 0xfd, 0x6, 0x2a, 0x5e, 0xa7, 0xe8, 0x97, 0xdb, 0x8a, 0xde, 0x33, 0x8b, 0x8e, 0x4e, 0x4, 0xa4, 0xbe, 0x9c, 0x9e, 0xfd, 0x74, 0x72, 0x7e, 0xe8, 0x4f, 0x42, 0x7f, 0xb2, 0x7f, 0xf2, 0xf2, 0x48, 0xa4, 0x9e, 0x6, 0x27, 0x94, 0x1c, 0x1c, 0xd6, 0x49, 0x18, 0xd, 0x67, 0x2e, 0xa2, 0xe1, 0x20, 0x20, 0xdf, 0x22, 0xc3, 0x9b, 0x25, 0xc4, 0x4a, 0x4, 0x2f, 0x8d, 0xdb, 0x8d, 0x23, 0x60, 0x68, 0x3b, 0x8b, 0xc1, 0x51, 0x80, 0xfc, 0x2c, 0xf2, 0x8c, 0xe4, 0x23, 0x3a, 0x44, 0xec, 0x55, 0x24, 0xee, 0x49, 0x44, 0xfc, 0x9c, 0xd7, 0x22, 0xf2, 0xcf, 0x7, 0x47, 0x6c, 0x89, 0x7, 0xdf, 0xe, 0x12, 0x13, 0x7b, 0xc1, 0x78, 0x39, 0x58, 0xac, 0xf9, 0x4c, 0xcd, 0x6c, 0x59, 0x88, 0xb6, 0x28, 0x91, 0x29, 0xac, 0xf, 0x73, 0x87, 0x4f, 0x40, 0x7, 0xe8, 0x1, 0xfb, 0xb4, 0x26, 0xd6, 0xb4, 0xeb, 0x78, 0x2d, 0xe4, 0x7b, 0xb8, 0x6d, 0xa4, 0xcf, 0xd2, 0xa, 0x4, 0x51, 0x3, 0xf5, 0xc6, 0x74, 0x21, 0xc5, 0x2e, 0xc8, 0x98, 0xe, 0xc7, 0xb8, 0x7a, 0xc, 0xc8, 0x66, 0x1a, 0x27, 0xaf, 0x61, 0x1d, 0x7c, 0xb, 0x18, 0x67, 0xc1, 0x64, 0x6, 0x3c, 0xe6, 0xc, 0x4f, 0x39, 0x95, 0xf4, 0x7a, 0x7b, 0xbd, 0x1e, 0x3a, 0xde, 0xb7, 0xc6, 0x2e, 0x11, 0x4, 0x4a, 0x45, 0x62, 0xec, 0x67, 0xf3, 0x73, 0xf6, 0xda, 0x92, 0x5c, 0x62, 0x8c, 0xb3, 0xd0, 0x60, 0x3d, 0x3d, 0xc1, 0xe3, 0x30, 0x54, 0x7b, 0xc6, 0xd3, 0x82, 0xe8, 0x1e, 0x2c, 0xcd, 0xd, 0x7d, 0x87, 0xaf, 0xb5, 0x6e, 0x84, 0xd0, 0x2f, 0x60, 0x84, 0x8b, 0xc, 0xe, 0xe6, 0x12, 0xce, 0xc, 0xb6, 0x5, 0xcd, 0x7a, 0xc4, 0xa1, 0xc9, 0x46, 0x6c, 0x5e, 0x35, 0x1, 0x4e, 0x6b, 0xfd, 0x22, 0xbb, 0x40, 0x2e, 0xcc, 0xbf, 0x50, 0x55, 0x40, 0x6e, 0xa8, 0x2f, 0xca, 0x98, 0xec, 0x5e, 0x1d, 0xff, 0x83, 0x83, 0x57, 0x93, 0xb5, 0xff, 0xa, 0x2f, 0x2b, 0x96, 0x82, 0x90, 0x97, 0x42, 0xab, 0x92, 0xc0, 0xf0, 0x64, 0x27, 0x22, 0x83, 0xe9, 0x49, 0x46, 0x19, 0x5e, 0xad, 0x59, 0xcb, 0x96, 0xc1, 0x39, 0xcf, 0xa8, 0x19, 0x5c, 0x8e, 0x57, 0x91, 0x96, 0x8c, 0x7e, 0xf1, 0xa1, 0xb6, 0x24, 0x9d, 0xfe, 0x6b, 0x5f, 0xcd, 0x98, 0x2d, 0x41, 0x80, 0xa9, 0x1b, 0x34, 0xc3, 0x87, 0x44, 0x9a, 0x7b, 0xdb, 0x82, 0xd8, 0x52, 0xae, 0xe1, 0x8, 0x22, 0x26, 0xaa, 0xb1, 0xe8, 0xcb, 0x89, 0x3f, 0xe8, 0x5, 0xd1, 0xcb, 0x9, 0x62, 0xd1, 0xf, 0x46, 0x91, 0xd7, 0xa3, 0x80, 0x22, 0x18, 0xfb, 0xc8, 0x8a, 0x26, 0xb3, 0x40, 0x8e, 0xb9, 0x12, 0xab, 0x81, 0x7e, 0x93, 0xfe, 0x45, 0x54, 0xf2, 0x4a, 0x2d, 0x8f, 0xd1, 0x25, 0xc, 0x4b, 0x16, 0xc3, 0xad, 0xd0, 0x75, 0x2, 0x1c, 0xe5, 0x56, 0xc2, 0xdd, 0x73, 0x5e, 0x55, 0xe8, 0x55, 0x14, 0xdd, 0xe0, 0xaa, 0x85, 0x84, 0x42, 0x59, 0xcd, 0x4b, 0x84, 0x1b, 0x8d, 0xa5, 0x36, 0x8c, 0x96, 0xd, 0xfe, 0x2a, 0xd2, 0x46, 0x9f, 0x44, 0xef, 0x42, 0xa1, 0xb0, 0x22, 0xae, 0x26, 0xdc, 0x1f, 0xb2, 0xab, 0xc5, 0xda, 0x61, 0x27, 0x80, 0x6a, 0x2b, 0x79, 0x1a, 0xbe, 0xff, 0xea, 0xcb, 0xcf, 0xab, 0x6a, 0xf5, 0x8c, 0xff, 0xb2, 0x1, 0x22, 0x4, 0x83, 0x81, 0x3e, 0x56, 0x55, 0x19, 0xde, 0x8, 0xe0, 0xb, 0x9b, 0x17, 0x92, 0x6c, 0xcf, 0x3a, 0x8e, 0x1d, 0xe9, 0x57, 0x7d, 0xe3, 0xa, 0x93, 0x21, 0x98, 0x87, 0x19, 0x83, 0x3, 0x1d, 0x5a, 0x87, 0x19, 0x12, 0xd8, 0x1e, 0xb5, 0x8f, 0x64, 0x4f, 0x18, 0xe8, 0xbf, 0x12, 0xb6, 0xf0, 0xa2, 0xdb, 0x15, 0xa2, 0x54, 0x6f, 0xcb, 0x40, 0x74, 0x0, 0xa2, 0x55, 0x5c, 0xc0, 0xaf, 0x70, 0x7f, 0xc4, 0xe4, 0xf2, 0x85, 0x43, 0x66, 0xd0, 0x33, 0x9c, 0x6d, 0x2, 0x18, 0x97, 0x87, 0xa8, 0xc2, 0x12, 0x6b, 0xda, 0x12, 0xf2, 0x17, 0x28, 0xe4, 0x2b, 0x89, 0xfd, 0x66, 0x8b, 0x47, 0xe4, 0x86, 0xee, 0xb4, 0xe3, 0x1, 0x70, 0xa8, 0xb0, 0xac, 0x9c, 0xee, 0xe4, 0xd4, 0xb7, 0x2f, 0x9c, 0x61, 0x84, 0x37, 0xbe, 0xb5, 0x4b, 0x81, 0xbe, 0xb0, 0x9c, 0x9d, 0xa5, 0x68, 0x14, 0x8c, 0x7f, 0x22, 0xbb, 0xc, 0xfa, 0xea, 0x8f, 0xb, 0x38, 0xf0, 0x6c, 0x36, 0x30, 0x66, 0x0, 0xb4, 0x68, 0xe1, 0xc4, 0x53, 0x0, 0x8c, 0x84, 0xa7, 0x66, 0x44, 0x17, 0xe5, 0xf, 0xf1, 0xc7, 0x6e, 0x21, 0x5a, 0xa, 0xd, 0x74, 0x52, 0x2c, 0x7b, 0xde, 0xd1, 0x91, 0xd7, 0x3, 0x4, 0x57, 0x94, 0xd5, 0x3e, 0x14, 0xb6, 0xd3, 0x17, 0x94, 0x8e, 0xfd, 0x43, 0x8b, 0xd0, 0xef, 0x4c, 0x50, 0xde, 0x6, 0x1e, 0x54, 0x81, 0xb6, 0xf0, 0xae, 0xe6, 0xa, 0x86, 0x4b, 0xc8, 0x2c, 0x83, 0x61, 0x28, 0x62, 0x8, 0xf8, 0x16, 0xce, 0xc4, 0xa0, 0x87, 0x27, 0x42, 0xf0, 0x2a, 0xd4, 0x10, 0x69, 0x6e, 0x5f, 0x91, 0xae, 0x46, 0x62, 0x32, 0x9a, 0x29, 0xee, 0xc1, 0xbe, 0x54, 0xd, 0x4c, 0x85, 0x53, 0x30, 0xa4, 0xe0, 0x1, 0x1d, 0xc2, 0x89, 0xd7, 0xd7, 0xda, 0x19, 0x10, 0x27, 0x51, 0xb, 0xbe, 0x83, 0x7a, 0x70, 0xe2, 0x2f, 0xf3, 0x7e, 0x86, 0x63, 0x87, 0x41, 0x5, 0x6, 0x39, 0x7a, 0x99, 0xc0, 0xd0, 0x64, 0x69, 0xe0, 0xa5, 0x14, 0xfa, 0x7d, 0xd5, 0xaa, 0x35, 0x13, 0xc8, 0x77, 0x22, 0xff, 0xf6, 0xbc, 0x68, 0xe2, 0x85, 0xf2, 0x87, 0x40, 0x11, 0xe8, 0xf0, 0x90, 0x48, 0xdc, 0xc, 0x99, 0xe8, 0x6a, 0x58, 0xa3, 0x7d, 0xe0, 0x40, 0xe7, 0x62, 0xfa, 0xf, 0xd9, 0x5, 0x2c, 0x80, 0x3c, 0xc, 0x67, 0xd9, 0x39, 0xcb, 0x51, 0x4d, 0xdf, 0x8c, 0xad, 0x90, 0x9f, 0xc5, 0xb6, 0x29, 0xfb, 0x79, 0x44, 0x8c, 0xfa, 0x96, 0x55, 0xa4, 0x2b, 0xc5, 0x98, 0x66, 0xbd, 0x10, 0x68, 0xd9, 0xcb, 0x23, 0x6b, 0xe1, 0x26, 0x3a, 0x54, 0x4d, 0xd8, 0xdc, 0xc, 0xb5, 0x81, 0xec, 0x1a, 0xfa, 0x87, 0xd3, 0xb, 0x8, 0xf5, 0x6d, 0x74, 0x8d, 0x71, 0xe, 0xe5, 0x11, 0xfd, 0x1c, 0xb0, 0x10, 0xa7, 0xb8, 0x58, 0x73, 0x60, 0x3, 0x34, 0xfe, 0xbe, 0x6e, 0x41, 0xd9, 0xca, 0xf7, 0xbe, 0xef, 0xcb, 0x4a, 0x3c, 0xed, 0x23, 0x87, 0xed, 0x31, 0xcf, 0x3e, 0xef, 0x1e, 0x72, 0xbb, 0xde, 0x43, 0x9a, 0xa6, 0xc7, 0x2e, 0xd0, 0x55, 0xe6, 0x8, 0x63, 0x34, 0xf9, 0x38, 0xfb, 0xb, 0x38, 0x66, 0x2f, 0x48, 0x79, 0x70, 0x81, 0x4c, 0xd6, 0x85, 0xb6, 0x44, 0x85, 0x66, 0x30, 0x78, 0x12, 0x21, 0xbc, 0xb, 0xc5, 0xfe, 0x32, 0xcd, 0xfe, 0x5e, 0xf, 0x50, 0x5a, 0x5f, 0x67, 0x29, 0xff, 0x4a, 0xb6, 0x70, 0x70, 0xd0, 0x4e, 0x3, 0xf2, 0x1, 0xfd, 0xcc, 0x94, 0x3f, 0x97, 0xe8, 0xc8, 0xfa, 0x29, 0x81, 0x68, 0xa6, 0xd8, 0x54, 0xc1, 0x54, 0xce, 0x1c, 0x4c, 0x25, 0xc, 0xf, 0xa6, 0x21, 0x7d, 0x55, 0xfa, 0x58, 0xd7, 0x63, 0x8d, 0x96, 0x6d, 0xc4, 0xd3, 0x7f, 0xf3, 0xe6, 0x4d, 0x1f, 0x8e, 0xf6, 0x45, 0x1f, 0xb6, 0x83, 0xe7, 0x49, 0x81, 0x81, 0x12, 0x70, 0x5, 0x17, 0xb4, 0xba, 0xa5, 0x88, 0x2e, 0x82, 0xc7, 0xbe, 0x4e, 0x5a, 0x61, 0x30, 0x29, 0xf5, 0xb, 0x24, 0x69, 0x2, 0xff, 0xf6, 0xce, 0x44, 0x2b, 0x5c, 0x80, 0x9c, 0x2e, 0x97, 0xd1, 0x7c, 0x8a, 0xb, 0xb5, 0x44, 0x64, 0xdb, 0xcc, 0xfd, 0x29, 0x82, 0x4d, 0x35, 0xe2, 0x3a, 0xdc, 0x38, 0xeb, 0x0, 0x5a, 0x37, 0x9, 0xee, 0x43, 0x1, 0x9b, 0x18, 0x55, 0x68, 0x7f, 0x24, 0x7b, 0x87, 0xd2, 0x9b, 0xf2, 0x34, 0x3a, 0x1e, 0xe, 0x71, 0x91, 0xc5, 0xcf, 0x93, 0x8f, 0x87, 0x70, 0xd4, 0x3e, 0x1e, 0x52, 0x27, 0x22, 0x89, 0x6c, 0xa4, 0xd5, 0xf, 0x54, 0x88, 0x65, 0x18, 0x43, 0x2e, 0x8a, 0x2a, 0x18, 0xd, 0x5e, 0x2e, 0x5f, 0xfa, 0xe6, 0x7e, 0x5f, 0xa3, 0xc2, 0xf3, 0x19, 0x2f, 0x57, 0x45, 0x5e, 0x72, 0x31, 0x2d, 0x5f, 0x5, 0x9c, 0xeb, 0x13, 0x1b, 0x84, 0x57, 0x6f, 0x34, 0x3, 0x51, 0x6, 0x8d, 0x9f, 0xc7, 0x18, 0xf2, 0x52, 0x9d, 0x6f, 0x94, 0x78, 0xfc, 0x11, 0x43, 0x23, 0x95, 0x0, 0x35, 0x55, 0x24, 0xd8, 0x60, 0xa2, 0x59, 0xb, 0x60, 0x31, 0x14, 0x62, 0x51, 0x84, 0xe8, 0xc0, 0x9f, 0x46, 0xaf, 0xd5, 0xcd, 0x9c, 0x8, 0x87, 0x19, 0x1b, 0x1, 0x2f, 0xd1, 0x1e, 0x5b, 0x4, 0xbb, 0x4, 0x59, 0x17, 0x48, 0xf6, 0x36, 0x99, 0x94, 0xc0, 0xc1, 0x7a, 0x54, 0x62, 0x2d, 0x19, 0x89, 0x6b, 0x86, 0x27, 0x38, 0x44, 0xf5, 0x9b, 0xf8, 0x14, 0x21, 0x55, 0x4a, 0xbd, 0x52, 0x38, 0x50, 0x61, 0xdd, 0xc4, 0x54, 0xd2, 0x44, 0x72, 0x21, 0xa1, 0x64, 0x1d, 0x54, 0xcd, 0x2d, 0xb0, 0x16, 0xf0, 0x69, 0x87, 0x5b, 0xb9, 0x1e, 0x50, 0x21, 0x38, 0x95, 0x92, 0x8b, 0xb1, 0x2b, 0xb1, 0x6b, 0xdc, 0x16, 0x3a, 0xb8, 0x9f, 0x65, 0x7c, 0x99, 0x5a, 0x80, 0x54, 0x27, 0x5e, 0xa3, 0x36, 0xc6, 0x48, 0x40, 0xbd, 0xc, 0xee, 0xec, 0x23, 0x60, 0x76, 0xcb, 0xeb, 0x3c, 0x41, 0x2e, 0x73, 0x86, 0x56, 0xb3, 0xf8, 0x3, 0xe8, 0xd9, 0x18, 0xa0, 0x3, 0xd8, 0xe, 0x5f, 0xc0, 0xbe, 0x40, 0xe7, 0xec, 0x11, 0xfe, 0x85, 0xa9, 0x93, 0x0, 0x30, 0x83, 0x95, 0x2a, 0xcb, 0x37, 0xc5, 0x3a, 0x15, 0x24, 0x8b, 0xba, 0xcc, 0x83, 0xb7, 0x52, 0xd7, 0x7c, 0xcd, 0x72, 0x82, 0x58, 0xed, 0x36, 0x60, 0x72, 0x2d, 0xf, 0x3b, 0xb8, 0x96, 0xe, 0x90, 0x6c, 0x2f, 0x81, 0xe2, 0x6d, 0xd4, 0xca, 0xb1, 0x99, 0xc1, 0xe1, 0xe0, 0x9, 0x1, 0x62, 0x2b, 0x4e, 0xf1, 0x44, 0xfc, 0x21, 0x2e, 0x5, 0xb2, 0x90, 0x4e, 0xa3, 0xc6, 0xb2, 0xcd, 0xa1, 0x48, 0xce, 0xda, 0xba, 0x86, 0xb3, 0xa2, 0xa6, 0xc4, 0xe8, 0x54, 0x52, 0x35, 0xed, 0xdf, 0x10, 0xba, 0x9c, 0x35, 0x6a, 0xf5, 0xc, 0xd9, 0x2c, 0x79, 0x4f, 0xbf, 0x79, 0xfe, 0xc2, 0x93, 0xa8, 0xdf, 0x17, 0x97, 0x68, 0x30, 0x10, 0xa, 0x81, 0xf3, 0xee, 0x4d, 0x2a, 0x3a, 0x29, 0xc8, 0x60, 0xa3, 0x59, 0xbc, 0x19, 0x2, 0x7e, 0xda, 0x52, 0xfa, 0x4a, 0x1b, 0x24, 0x97, 0xcf, 0xb, 0xe9, 0xec, 0x5, 0xab, 0x22, 0x1c, 0xd1, 0xd0, 0xcb, 0xd5, 0x34, 0x5d, 0x0, 0xee, 0x57, 0x8a, 0xc4, 0x18, 0x4a, 0x2f, 0x53, 0x8a, 0x9d, 0xb1, 0x76, 0x30, 0x57, 0x96, 0x79, 0x48, 0x98, 0x89, 0x38, 0xce, 0x91, 0xf7, 0x5e, 0xc0, 0x9f, 0x11, 0xf2, 0xce, 0xaa, 0x82, 0xc5, 0x1b, 0xf1, 0x1, 0x32, 0x5f, 0xfe, 0x62, 0x12, 0xfb, 0xde, 0x49, 0x9a, 0x5d, 0x9e, 0x7a, 0x81, 0x48, 0xa9, 0xcd, 0x2f, 0xc9, 0x15, 0x45, 0x3a, 0x38, 0x2d, 0x48, 0xf5, 0xc, 0xa4, 0xff, 0x95, 0x5c, 0x1a, 0x6e, 0x19, 0xd, 0xc8, 0xf9, 0x67, 0xf2, 0xe6, 0x89, 0xa6, 0xf3, 0x36, 0x12, 0x68, 0xf6, 0xdb, 0x67, 0x5f, 0xa0, 0xc2, 0xa5, 0xc8, 0xd1, 0x5c, 0x54, 0xea, 0x15, 0x5c, 0xa, 0x71, 0x74, 0x1d, 0xd0, 0x56, 0xbe, 0x20, 0xac, 0x36, 0xca, 0xb4, 0x75, 0x0, 0x49, 0x94, 0x20, 0x3, 0x23, 0x1d, 0x1b, 0x45, 0x3c, 0x67, 0x4f, 0x8c, 0x40, 0x98, 0x9b, 0xbc, 0x25, 0xc7, 0x10, 0xe0, 0x2a, 0xde, 0xe2, 0x15, 0xf0, 0x96, 0x3d, 0x24, 0x5d, 0x50, 0x82, 0x3c, 0xbc, 0x30, 0x98, 0x3a, 0x30, 0x63, 0x6a, 0x7f, 0x78, 0x3c, 0xc4, 0xa8, 0xda, 0x3d, 0xaf, 0x43, 0x23, 0x4a, 0x1b, 0xab, 0xd, 0xdd, 0x1a, 0xd1, 0xb5, 0x74, 0xf4, 0x37, 0xa, 0x59, 0xc5, 0xb8, 0x3b, 0x84, 0xa4, 0x54, 0x3c, 0x4f, 0xf4, 0x17, 0x7a, 0xb2, 0xf9, 0xd2, 0xb1, 0xe1, 0x6, 0x8f, 0x75, 0x38, 0x65, 0x24, 0xd7, 0x87, 0xf1, 0xb6, 0xd6, 0xfd, 0x99, 0x17, 0x5, 0xe4, 0x90, 0x26, 0x35, 0xd, 0xca, 0x10, 0x9c, 0xcb, 0x90, 0x69, 0xcc, 0x90, 0x61, 0xd1, 0x91, 0x5c, 0x52, 0x4e, 0xc0, 0xdb, 0x33, 0xa1, 0x34, 0x98, 0x12, 0x1d, 0x40, 0xfc, 0xc3, 0x2b, 0x22, 0xac, 0x86, 0x71, 0xa2, 0xc1, 0xd3, 0xe0, 0xc5, 0x11, 0x5e, 0x7b, 0x60, 0x94, 0x51, 0xd4, 0x28, 0x94, 0x9b, 0xe9, 0x45, 0x86, 0x15, 0x60, 0x91, 0x3d, 0x40, 0xe5, 0x5c, 0x7d, 0x4f, 0x37, 0x55, 0x5, 0xe0, 0x2f, 0x7e, 0x20, 0x81, 0x11, 0x9f, 0xbe, 0x87, 0xca, 0xa2, 0x42, 0xa6, 0x3, 0x2b, 0x98, 0xbc, 0x9e, 0x16, 0x57, 0xf8, 0x93, 0xe8, 0x3d, 0xfe, 0x26, 0x83, 0x16, 0xee, 0xc7, 0xc0, 0x7c, 0xa2, 0x22, 0x43, 0xb8, 0x50, 0xa7, 0xf2, 0xf4, 0xe8, 0x45, 0x6e, 0x19, 0xbb, 0x1a, 0x30, 0x22, 0x6f, 0x3d, 0xcd, 0xed, 0xf0, 0xbb, 0x54, 0xfb, 0xb4, 0xbe, 0x6d, 0x68, 0x44, 0xf3, 0x3f, 0x34, 0x7b, 0x26, 0x18, 0x71, 0x66, 0xb, 0x1d, 0xb, 0x85, 0x64, 0xa8, 0x41, 0x46, 0x8d, 0x92, 0x56, 0x25, 0x6a, 0x18, 0xfa, 0xdb, 0x97, 0x5, 0x41, 0x7d, 0x59, 0xa0, 0x56, 0x91, 0x19, 0x91, 0xf, 0x1d, 0x5e, 0x1, 0x4a, 0xbf, 0xae, 0x8a, 0x4b, 0x4f, 0x5e, 0xfe, 0x8b, 0x3f, 0xac, 0xb5, 0xec, 0x49, 0x40, 0x11, 0xe2, 0xda, 0x2a, 0x76, 0x19, 0x68, 0x40, 0x5c, 0x5e, 0xca, 0x11, 0xfa, 0xb6, 0x7b, 0xbe, 0x13, 0xb6, 0x3d, 0x1d, 0xd8, 0x12, 0x8, 0xd1, 0xcd, 0x16, 0xaf, 0xe3, 0xa4, 0xc8, 0x14, 0xb, 0x43, 0x4e, 0x76, 0xf3, 0x63, 0xd8, 0x71, 0x7f, 0x37, 0x95, 0xb1, 0x31, 0x65, 0x85, 0x29, 0xad, 0xe, 0x6a, 0xf7, 0x74, 0x6c, 0xcc, 0x84, 0x62, 0x63, 0x4e, 0x7, 0x3f, 0xff, 0xfc, 0x23, 0x88, 0x4, 0x6c, 0x8a, 0x41, 0x89, 0x7e, 0x74, 0xb8, 0xdf, 0x68, 0x55, 0x96, 0x56, 0x4b, 0xa2, 0x82, 0x14, 0x6a, 0x91, 0x8d, 0xd8, 0x76, 0x1b, 0x10, 0xc3, 0xd1, 0x72, 0x99, 0x53, 0xc7, 0x44, 0x7, 0xc6, 0x16, 0x2b, 0xd9, 0x2c, 0xa7, 0x8c, 0x50, 0x9b, 0xe9, 0xd6, 0x51, 0x35, 0x82, 0x78, 0x53, 0xd4, 0x9b, 0x66, 0xb0, 0x6d, 0xf2, 0x8a, 0xde, 0xde, 0x71, 0x65, 0x32, 0x27, 0xa9, 0xe2, 0x46, 0xa, 0x55, 0x18, 0x9a, 0xee, 0x15, 0x72, 0x3b, 0x53, 0x90, 0x2a, 0x90, 0x59, 0xd0, 0x82, 0xe4, 0xdc, 0x10, 0x6b, 0x16, 0x28, 0x86, 0xa1, 0x74, 0x25, 0xcc, 0x95, 0xe9, 0x1a, 0x53, 0x67, 0x9f, 0xcd, 0x5, 0xb7, 0xf0, 0x3a, 0xc2, 0x70, 0x6, 0x58, 0xec, 0x75, 0xa3, 0xc0, 0xeb, 0xf3, 0x6d, 0x23, 0x64, 0x2e, 0x4a, 0xa1, 0x73, 0x43, 0xab, 0x4a, 0x8a, 0xc9, 0xfa, 0xa6, 0x18, 0xaf, 0x87, 0x40, 0x98, 0xa2, 0x5b, 0xa2, 0x5e, 0x2f, 0xa6, 0x28, 0x7d, 0x48, 0x5e, 0xa6, 0x67, 0xb, 0xa, 0xd1, 0xf, 0x7f, 0xa2, 0xc, 0xd1, 0xa6, 0x3a, 0x6f, 0x62, 0xd4, 0xc0, 0xa1, 0x63, 0x98, 0xdd, 0x57, 0x67, 0x40, 0xdf, 0x41, 0xf6, 0x1, 0xfe, 0xe7, 0x55, 0xdd, 0x45, 0x56, 0x2f, 0x7e, 0xed, 0x72, 0xa8, 0x2e, 0x9f, 0xc9, 0x9d, 0x97, 0x1c, 0xab, 0x81, 0x35, 0x9d, 0x99, 0x5a, 0x26, 0xe0, 0x85, 0x61, 0x35, 0x38, 0x9d, 0xc5, 0x5a, 0xe2, 0x10, 0xae, 0xc4, 0x22, 0x68, 0x7d, 0xea, 0xcb, 0x5c, 0x6d, 0xb0, 0x2a, 0x72, 0x89, 0x40, 0xa1, 0x10, 0x4e, 0x30, 0xda, 0xb2, 0x43, 0x86, 0x5a, 0xf5, 0x1, 0x4e, 0xb6, 0x82, 0xb6, 0x63, 0xcc, 0xc1, 0x48, 0x18, 0x5b, 0xa0, 0x66, 0x9b, 0x22, 0xa3, 0xab, 0x98, 0x87, 0x64, 0xd6, 0xc5, 0xaf, 0x56, 0x31, 0x0, 0x4a, 0xe4, 0xd1, 0x16, 0xa3, 0xae, 0xe, 0x95, 0x27, 0x28, 0x98, 0xb2, 0x19, 0xe2, 0x1f, 0x5d, 0xd7, 0x7d, 0xa1, 0xad, 0x77, 0x17, 0x23, 0xd8, 0xb7, 0xee, 0xb4, 0x5d, 0xe, 0x66, 0xc8, 0x1b, 0x74, 0x5d, 0xd1, 0xa3, 0x3d, 0x1a, 0x93, 0xe, 0x53, 0xb5, 0xbf, 0xfe, 0x5c, 0xc7, 0x36, 0x9a, 0xaa, 0x5b, 0x32, 0xb7, 0xbb, 0xe3, 0x42, 0x7b, 0x9f, 0xd5, 0x57, 0xd3, 0x42, 0x6d, 0xf7, 0xa9, 0x35, 0x81, 0xa4, 0xd3, 0x68, 0x4d, 0xd0, 0xd5, 0xc4, 0xf4, 0x5, 0xb, 0x2, 0xd6, 0x19, 0x50, 0x42, 0xfa, 0xba, 0x72, 0xc, 0x35, 0x3a, 0x43, 0x90, 0x9f, 0x9d, 0x8f, 0xe7, 0x9a, 0x60, 0x1, 0x22, 0x98, 0x5b, 0x47, 0x46, 0x5b, 0x58, 0x26, 0x13, 0x19, 0x4a, 0x24, 0xa4, 0xe0, 0x33, 0x30, 0xd6, 0x33, 0x69, 0x6c, 0x9, 0x9b, 0x4c, 0xd1, 0x16, 0x76, 0xf8, 0x8c, 0x88, 0xfd, 0x3c, 0x9b, 0x8a, 0xbd, 0xb1, 0x6e, 0x71, 0x4d, 0xf7, 0x24, 0xe9, 0xaa, 0x7d, 0xa8, 0x4d, 0xaa, 0x55, 0xf, 0x11, 0xc5, 0x5d, 0xa2, 0x9b, 0x1d, 0x54, 0x92, 0xb, 0xff, 0x37, 0x16, 0x1b, 0x2b, 0xe5, 0x7, 0x2c, 0x31, 0x62, 0xe3, 0xa1, 0xf3, 0x9d, 0xc4, 0x0, 0xe3, 0x3f, 0x1c, 0x1d, 0x3d, 0x5e, 0xc4, 0x6b, 0xe0, 0x24, 0xff, 0x60, 0x45, 0xc4, 0xd9, 0xa0, 0x14, 0x2, 0x8b, 0x99, 0x54, 0x9e, 0xb4, 0xbc, 0xa2, 0xad, 0xc8, 0xa2, 0x6a, 0x40, 0xe5, 0x4d, 0x1e, 0xa1, 0x92, 0xbe, 0x58, 0x49, 0x9c, 0x5f, 0xc6, 0x25, 0x94, 0x10, 0x1f, 0x62, 0x99, 0x93, 0xea, 0x2a, 0xaa, 0x94, 0x86, 0x46, 0xd7, 0xc0, 0x9b, 0x5, 0x85, 0xd6, 0xcf, 0x54, 0xc0, 0xf8, 0x5e, 0x76, 0x3e, 0xb1, 0x7e, 0x85, 0xfa, 0x66, 0x59, 0xda, 0x6c, 0xfe, 0x23, 0xe3, 0x6d, 0xc, 0x8, 0xfd, 0xb7, 0x9d, 0x7d, 0x33, 0x8c, 0x41, 0x24, 0xd6, 0x8d, 0x9c, 0x77, 0x0, 0x1b, 0xe8, 0x71, 0x79, 0xdf, 0x9, 0x47, 0x26, 0x96, 0x8b, 0x2, 0xc2, 0xab, 0xc7, 0x2a, 0xf1, 0xb9, 0x70, 0xf4, 0x1, 0x94, 0x2d, 0x93, 0x64, 0x2b, 0x9c, 0xe9, 0x4, 0x59, 0x2b, 0x97, 0xe, 0xa3, 0x46, 0x57, 0x76, 0x9d, 0x46, 0x2f, 0x8d, 0xfa, 0x16, 0x3f, 0x10, 0x97, 0x68, 0x8e, 0xf7, 0xc, 0x65, 0x7e, 0xa3, 0xbd, 0x23, 0xa3, 0x3a, 0x2b, 0xd1, 0x32, 0x35, 0xcb, 0xe3, 0xe7, 0xb0, 0x9d, 0xdc, 0x74, 0x73, 0x18, 0x73, 0xb5, 0x48, 0x65, 0x74, 0x23, 0xf5, 0xa9, 0x37, 0x71, 0x9e, 0x5d, 0x8, 0xb3, 0x33, 0x20, 0x5c, 0xfa, 0xc7, 0xf3, 0x8a, 0xaf, 0xca, 0xf0, 0x13, 0x23, 0xe5, 0x49, 0x5c, 0x52, 0x3c, 0x78, 0xe, 0x58, 0xe4, 0x9b, 0x4d, 0xf5, 0xf7, 0xd, 0x5e, 0x3e, 0x53, 0x8, 0x25, 0xea, 0x7, 0x6b, 0x97, 0xf8, 0xf1, 0x8d, 0xd4, 0x89, 0xa0, 0x52, 0x93, 0x12, 0x44, 0x53, 0x24, 0x68, 0xe8, 0xdf, 0xb4, 0xba, 0x56, 0x1a, 0xb4, 0x46, 0xbb, 0x62, 0x24, 0x7e, 0x99, 0xe5, 0xfc, 0x71, 0xb1, 0x2c, 0xd6, 0xa1, 0xb7, 0x9e, 0x4f, 0x63, 0x7f, 0xc8, 0xf0, 0x7f, 0x83, 0x51, 0xe0, 0xd5, 0xf9, 0xa2, 0x21, 0xd5, 0x13, 0xc, 0xe6, 0xcb, 0x78, 0xa, 0xbc, 0x87, 0x1e, 0xd, 0xfd, 0xc, 0xbd, 0x93, 0xf, 0x23, 0xc2, 0x93, 0x1f, 0x9e, 0xca, 0xba, 0x5f, 0x0, 0x37, 0x1, 0x7c, 0x46, 0x89, 0x41, 0xf4, 0x75, 0xe1, 0x47, 0x7c, 0x9e, 0xe5, 0xf, 0xab, 0x1f, 0xf9, 0xba, 0xd0, 0xa3, 0xff, 0xac, 0xc8, 0xab, 0xcf, 0xe2, 0x8b, 0xc, 0xa3, 0xee, 0x7f, 0xf4, 0x39, 0x5f, 0x5e, 0xc2, 0xd2, 0x26, 0xf1, 0xde, 0xd7, 0x7c, 0xc3, 0x3f, 0x62, 0x7b, 0x75, 0xa, 0xfe, 0x78, 0x88, 0xa8, 0x19, 0x3e, 0xca, 0x38, 0x2f, 0xfb, 0x88, 0xa8, 0x67, 0x5e, 0xdd, 0xc8, 0x73, 0xc, 0x15, 0x39, 0x3a, 0x36, 0x12, 0x10, 0x30, 0x43, 0x2f, 0x2f, 0xd6, 0x17, 0xf8, 0x7c, 0x82, 0x4e, 0x97, 0x53, 0xfe, 0xe3, 0x27, 0x9f, 0x7c, 0x82, 0x21, 0xff, 0x49, 0xad, 0x90, 0x5d, 0xd2, 0x7a, 0xa2, 0x12, 0xc, 0xad, 0xee, 0x1f, 0xd6, 0x40, 0x40, 0x83, 0x87, 0x79, 0xbf, 0x28, 0xa, 0x8c, 0xdc, 0x40, 0x33, 0x4f, 0x36, 0x65, 0x55, 0x5c, 0xd4, 0x29, 0x23, 0x56, 0x89, 0x6f, 0x61, 0x69, 0x11, 0x9e, 0x79, 0xda, 0x12, 0x5, 0x5f, 0x6a, 0x28, 0x36, 0xc9, 0xa2, 0x24, 0x5b, 0x2, 0xf9, 0x43, 0x66, 0x68, 0xfb, 0xda, 0x73, 0x55, 0xff, 0xb3, 0x6c, 0xb9, 0x6c, 0xef, 0xc8, 0x70, 0xf0, 0x67, 0xd8, 0x12, 0x55, 0xe4, 0x57, 0xae, 0x97, 0xd1, 0x8c, 0x58, 0xb1, 0x3f, 0x59, 0x49, 0xf6, 0x9a, 0x19, 0x39, 0x6a, 0xd5, 0x66, 0xb3, 0xba, 0x91, 0x17, 0x59, 0xf5, 0xeb, 0x37, 0xb0, 0xd9, 0x56, 0x63, 0x54, 0x75, 0xba, 0x18, 0xda, 0xb4, 0x58, 0xa6, 0xed, 0x4a, 0xae, 0xd1, 0xfd, 0x20, 0x5f, 0x55, 0x8, 0x3f, 0x51, 0x29, 0xdf, 0xb7, 0x52, 0x1e, 0xc7, 0x70, 0x94, 0xa9, 0xc7, 0x3f, 0xeb, 0xa4, 0x62, 0x9d, 0xf3, 0xf5, 0x33, 0x10, 0x3f, 0x36, 0xa5, 0x51, 0x55, 0x7a, 0xc9, 0x8e, 0x86, 0xba, 0x6f, 0xa0, 0x29, 0xe8, 0xc7, 0x81, 0xc0, 0x9f, 0xcd, 0xf6, 0xfc, 0x25, 0x9e, 0x84, 0xe0, 0xe6, 0xc3, 0x53, 0x38, 0xb, 0xf4, 0xfd, 0xe1, 0x69, 0xb8, 0x77, 0xf2, 0xe1, 0x96, 0x12, 0xf6, 0xe8, 0x74, 0xec, 0xe1, 0xf1, 0xa0, 0x8, 0x20, 0x2f, 0xda, 0x6d, 0x74, 0x95, 0xf9, 0x1b, 0xbf, 0x7e, 0x14, 0x27, 0xaf, 0xe7, 0x14, 0x44, 0x42, 0x4d, 0xb1, 0xc8, 0x1f, 0x2a, 0xbc, 0x1, 0x38, 0x77, 0x8e, 0xb6, 0x4a, 0xe6, 0x95, 0xcd, 0xd6, 0x2c, 0xa0, 0x6c, 0x15, 0xac, 0x2, 0xdb, 0x2d, 0x3a, 0xab, 0x2, 0x81, 0x2e, 0x91, 0xd1, 0x42, 0xf4, 0x59, 0x2, 0xff, 0xb4, 0xe0, 0x4b, 0xc0, 0xdf, 0x98, 0x4, 0x18, 0xb3, 0x6c, 0x84, 0x2e, 0x6, 0x82, 0xa1, 0x6e, 0xb3, 0x4b, 0xb7, 0x4d, 0x7b, 0xd3, 0x1e, 0xf1, 0x63, 0x11, 0xe6, 0xc, 0xa3, 0xf2, 0x54, 0x52, 0x48, 0x1, 0x42, 0xd9, 0xab, 0x2c, 0x81, 0x25, 0x27, 0xdd, 0x53, 0x1e, 0xd, 0xc7, 0xf9, 0x89, 0xca, 0x19, 0xe7, 0x18, 0xfd, 0x58, 0xeb, 0x9, 0xce, 0xaa, 0xb3, 0xfc, 0x9c, 0xe5, 0xda, 0xf0, 0x11, 0x95, 0x39, 0x3a, 0xa8, 0x3, 0xb6, 0x51, 0x10, 0x5f, 0x63, 0xd7, 0x28, 0xce, 0x59, 0x61, 0xd5, 0x60, 0x45, 0x24, 0xa3, 0x64, 0x59, 0x64, 0x53, 0x90, 0xc5, 0x9a, 0xdb, 0xc4, 0x89, 0xd6, 0x2e, 0xa0, 0xac, 0x4, 0xc2, 0x8a, 0xae, 0xe9, 0xdf, 0xbc, 0xc9, 0x75, 0xa0, 0x87, 0x92, 0xcc, 0x4f, 0xcf, 0xca, 0xf3, 0x8, 0xa3, 0xbc, 0xb0, 0xc, 0xd8, 0x22, 0x5c, 0xad, 0x46, 0x3c, 0xf7, 0xaa, 0x66, 0xf9, 0xfd, 0x7b, 0x2d, 0xd7, 0xc8, 0x10, 0x6, 0x80, 0x36, 0xc3, 0x3f, 0x8d, 0x81, 0x64, 0xce, 0x81, 0x54, 0x6a, 0x20, 0x18, 0x42, 0xc, 0x7d, 0x3, 0xca, 0xc1, 0x5, 0x5f, 0xcf, 0x5b, 0xa2, 0x6f, 0x75, 0xbf, 0x4d, 0xab, 0x4d, 0x56, 0x2b, 0x6d, 0xe7, 0x7e, 0x43, 0xe2, 0xab, 0xa1, 0xd1, 0xaa, 0xe8, 0x76, 0x58, 0x47, 0xa4, 0x68, 0x70, 0x15, 0xb0, 0xdf, 0xcd, 0xae, 0x64, 0x41, 0xad, 0xb1, 0xd2, 0x5c, 0x7a, 0x56, 0xc7, 0x8e, 0x13, 0x91, 0xb9, 0x2b, 0x33, 0x32, 0x37, 0x42, 0xe, 0xca, 0x17, 0xc6, 0x5, 0x8e, 0x32, 0x7a, 0xec, 0x8f, 0xb6, 0x6c, 0x1d, 0xf9, 0x40, 0xa0, 0x17, 0x7c, 0xcd, 0x1b, 0x23, 0x10, 0xcd, 0xd5, 0xa2, 0xbe, 0x64, 0x35, 0x8d, 0x9d, 0x45, 0x25, 0x36, 0xfc, 0x43, 0xd7, 0xd9, 0x14, 0x4f, 0x56, 0xda, 0x26, 0xa, 0x1e, 0xef, 0x6b, 0xd8, 0xcc, 0xef, 0x5a, 0xed, 0x22, 0xf8, 0x73, 0x32, 0xb, 0xe9, 0x8f, 0xea, 0x61, 0xc3, 0xc1, 0xe9, 0x8d, 0xc6, 0x65, 0x3d, 0xf0, 0x12, 0x6, 0x2e, 0x40, 0x3b, 0xc2, 0xbd, 0xc1, 0x33, 0x90, 0xf9, 0xb9, 0x36, 0x0, 0xc8, 0xb7, 0xaa, 0x97, 0xa7, 0x32, 0xa6, 0xd9, 0xae, 0x9e, 0xf4, 0x61, 0x31, 0xfb, 0xeb, 0x43, 0x7f, 0xa7, 0xb0, 0x5a, 0x65, 0xbf, 0x7f, 0x77, 0x4f, 0x59, 0xe, 0xcd, 0x67, 0x55, 0xe9, 0x80, 0x7a, 0xe1, 0x4a, 0x1c, 0x55, 0x7, 0x7, 0x2d, 0x18, 0x47, 0xd5, 0x3d, 0x30, 0x9f, 0x1b, 0x14, 0xbf, 0x3d, 0x90, 0x3a, 0x6, 0xc6, 0x6f, 0xc7, 0xed, 0x70, 0x97, 0xe5, 0x34, 0x2b, 0xa3, 0x66, 0xb8, 0x0, 0xa3, 0xa1, 0x88, 0x6f, 0xeb, 0x1d, 0xaa, 0xbd, 0x43, 0xb3, 0xfa, 0x9b, 0x71, 0x23, 0x1d, 0xa5, 0x28, 0x18, 0xaf, 0x3a, 0x69, 0x6b, 0x6, 0x3, 0x8f, 0x7d, 0xa3, 0x4, 0xc0, 0x25, 0x64, 0xff, 0xfc, 0x73, 0xb9, 0x81, 0x49, 0xfc, 0xfc, 0xb3, 0xdd, 0x10, 0x4a, 0x70, 0x11, 0x46, 0xcd, 0x2a, 0x56, 0x91, 0x85, 0x2b, 0x37, 0x90, 0x8a, 0x11, 0xe6, 0x5b, 0xe7, 0x65, 0xa8, 0x75, 0xdf, 0xcd, 0xf9, 0x7a, 0x9, 0x32, 0xe0, 0x7d, 0xaf, 0x57, 0xf5, 0x7a, 0x20, 0xca, 0xa3, 0x69, 0x25, 0x0, 0x62, 0xbc, 0xce, 0xad, 0x45, 0x96, 0xea, 0x2, 0x9c, 0x70, 0xb1, 0xe4, 0x4e, 0x93, 0x62, 0xbb, 0x8, 0x35, 0x71, 0x70, 0x60, 0xfe, 0x42, 0xc0, 0x64, 0x2b, 0x68, 0x3d, 0xbe, 0x48, 0x23, 0x47, 0x3, 0xc0, 0x70, 0x2, 0x9b, 0x76, 0x70, 0x20, 0xfe, 0x62, 0x29, 0x90, 0x31, 0x61, 0xd3, 0x4b, 0x11, 0x79, 0xdd, 0x81, 0x8e, 0xf6, 0x21, 0x2f, 0xfe, 0xda, 0x37, 0xa2, 0xd, 0x54, 0x78, 0x19, 0x96, 0x95, 0x9f, 0xa1, 0x75, 0x27, 0xa7, 0xe, 0xe7, 0x88, 0x44, 0xcc, 0xbb, 0xf0, 0x1a, 0x99, 0x51, 0x44, 0x23, 0xc8, 0x93, 0x1b, 0x8e, 0x3f, 0x9, 0x1d, 0x5c, 0x60, 0x95, 0x2c, 0xef, 0xae, 0x92, 0xe5, 0xcd, 0x2a, 0x97, 0x78, 0x7c, 0x13, 0x33, 0x78, 0xbf, 0x4, 0x7d, 0xf2, 0xb9, 0xc9, 0x2, 0x11, 0x29, 0xe2, 0x54, 0x1f, 0xfd, 0x6c, 0xab, 0xd4, 0x5e, 0x33, 0x7a, 0xb7, 0x85, 0x9f, 0x56, 0x4d, 0xac, 0xb0, 0x57, 0x21, 0xc8, 0x83, 0x28, 0xf2, 0x29, 0x4f, 0x80, 0xfe, 0x2d, 0x9f, 0xa2, 0xb0, 0x5f, 0xba, 0x6, 0x55, 0x7d, 0x88, 0x2f, 0x4f, 0xc, 0xf, 0xe, 0x90, 0x42, 0x1, 0x7c, 0xd7, 0x37, 0xda, 0x86, 0xe7, 0xec, 0xd9, 0xe8, 0x5c, 0x9e, 0xbf, 0x10, 0xed, 0x46, 0x9e, 0xc3, 0x1c, 0x51, 0x31, 0x9, 0xec, 0x8b, 0xb3, 0xc9, 0x43, 0x9a, 0xdb, 0xe0, 0xe9, 0x17, 0x47, 0xa3, 0x3f, 0xf, 0x61, 0x82, 0x57, 0x38, 0x41, 0x8c, 0x8, 0x97, 0xcf, 0x81, 0x4f, 0x59, 0x17, 0x17, 0x4f, 0x8b, 0xcc, 0xb4, 0xea, 0x35, 0x70, 0x55, 0x36, 0xb8, 0xea, 0x57, 0x83, 0x2b, 0x38, 0x2f, 0xd9, 0xe0, 0x1a, 0xbe, 0xae, 0x81, 0x2, 0x53, 0x63, 0xe5, 0x2f, 0xeb, 0xca, 0xe7, 0x87, 0xbc, 0x57, 0x1e, 0x96, 0xe8, 0xd4, 0x7a, 0x7c, 0x28, 0xfb, 0xe8, 0xd1, 0x5f, 0x10, 0x2d, 0xf3, 0x63, 0xbf, 0xc4, 0xb8, 0x38, 0xca, 0xd8, 0xf8, 0x14, 0xc0, 0x61, 0x78, 0x5a, 0x2, 0x69, 0x28, 0x7a, 0x75, 0xf1, 0x80, 0x81, 0x28, 0x82, 0xd1, 0x1d, 0xb, 0x96, 0x66, 0xe2, 0x15, 0x99, 0x50, 0x20, 0x88, 0x78, 0x99, 0xc5, 0xe5, 0xd3, 0xec, 0x8a, 0x2f, 0xdd, 0xeb, 0x74, 0xc, 0xe8, 0x77, 0x38, 0x19, 0x86, 0x83, 0x7, 0xb0, 0x4, 0xd7, 0x38, 0x25, 0x5c, 0x20, 0x90, 0x1d, 0x36, 0xeb, 0xcb, 0x26, 0xda, 0x42, 0x32, 0x25, 0x10, 0x52, 0x3d, 0x78, 0xfa, 0x5a, 0x15, 0x6f, 0x7c, 0x35, 0xc7, 0xe3, 0xa0, 0x67, 0xa4, 0x89, 0xd9, 0x1e, 0x7, 0x38, 0x39, 0x47, 0x25, 0xe, 0x95, 0xb2, 0x46, 0x25, 0xe, 0x95, 0x32, 0x59, 0x9, 0x48, 0xef, 0x61, 0x7e, 0xe4, 0xe7, 0xbd, 0x2, 0x8d, 0xea, 0xca, 0xc3, 0x42, 0x7c, 0x2b, 0x9f, 0x67, 0xf2, 0x6f, 0xf, 0x6f, 0xae, 0x42, 0xec, 0x3c, 0x3e, 0xa4, 0xe6, 0x60, 0xc, 0x30, 0x91, 0x10, 0xbb, 0xa6, 0x14, 0x1a, 0x1, 0x32, 0x8, 0x9b, 0x4a, 0x97, 0xed, 0x2d, 0x9a, 0x65, 0x45, 0x8a, 0x2c, 0x4b, 0xb, 0x7, 0x94, 0x33, 0xd9, 0x20, 0xff, 0xf6, 0xd, 0x6, 0xe8, 0xf8, 0x66, 0xf6, 0x55, 0x3c, 0x87, 0x13, 0xb4, 0x49, 0x79, 0xe7, 0x21, 0x98, 0x2d, 0xb, 0xc0, 0xe2, 0xf4, 0xb9, 0x2c, 0xe6, 0x90, 0x7b, 0x44, 0xdf, 0x5f, 0x7e, 0x3d, 0xc2, 0x98, 0x9d, 0xec, 0xb1, 0x38, 0x10, 0xb2, 0x55, 0x92, 0xfb, 0x9e, 0xd9, 0x17, 0xc1, 0x72, 0x91, 0x59, 0x2e, 0x96, 0x19, 0xc0, 0x1, 0x16, 0xc0, 0x68, 0x3a, 0x3b, 0xf2, 0x47, 0x83, 0x7, 0x87, 0x3c, 0xc0, 0xc5, 0x28, 0x4e, 0xa3, 0x18, 0xc8, 0x34, 0xf6, 0x3, 0xa4, 0xf2, 0x2, 0xfe, 0x8c, 0x97, 0xb0, 0x97, 0x6b, 0xf4, 0x65, 0xe9, 0x45, 0x83, 0x7, 0x6c, 0x7d, 0xa, 0xff, 0x1e, 0x1c, 0xec, 0x97, 0x93, 0x75, 0x1f, 0xbe, 0x42, 0x4a, 0x35, 0xdf, 0xfd, 0x13, 0x20, 0x36, 0x2d, 0xfd, 0x65, 0x7f, 0x8d, 0xf, 0xbe, 0x91, 0xe9, 0x62, 0x2a, 0x92, 0x13, 0x9e, 0x2d, 0xfd, 0x25, 0xf4, 0x77, 0xa8, 0xf7, 0x5, 0xb8, 0xe3, 0x4d, 0x10, 0x4, 0x8d, 0x4, 0x44, 0x5f, 0x0, 0x3e, 0xc6, 0x28, 0xd7, 0xf7, 0xa9, 0x35, 0x8b, 0xd2, 0xfe, 0xa, 0x70, 0x44, 0x23, 0xf9, 0x79, 0x64, 0xc4, 0x54, 0x9b, 0x1d, 0x5d, 0x6, 0x63, 0xff, 0xf9, 0x69, 0x7c, 0x7b, 0x1b, 0x9f, 0x1e, 0x1f, 0x3e, 0xc7, 0x8b, 0x87, 0x5, 0xbd, 0xad, 0x2, 0x69, 0xc1, 0xe5, 0x21, 0x2c, 0x4f, 0xab, 0x3c, 0x7b, 0xae, 0x4e, 0xbe, 0xbf, 0x88, 0xcc, 0x28, 0xe, 0x80, 0x79, 0x37, 0x40, 0x55, 0x9, 0xeb, 0x5c, 0x1e, 0x1d, 0x8b, 0x52, 0xc1, 0x74, 0xcd, 0xe3, 0xd7, 0xe3, 0xcb, 0x23, 0x57, 0x53, 0x2, 0x1f, 0xb9, 0xf3, 0xb4, 0x37, 0x21, 0xf4, 0xf3, 0x3c, 0x2a, 0x60, 0x22, 0xb3, 0xa3, 0xe7, 0x70, 0x8, 0x4b, 0x12, 0xd7, 0x9f, 0x33, 0xfc, 0x2b, 0x24, 0xf2, 0x4b, 0x6, 0xb8, 0x31, 0x5c, 0xe1, 0x33, 0x72, 0xe1, 0xaa, 0xf7, 0xfc, 0xf0, 0x92, 0x80, 0xab, 0x92, 0xb2, 0x41, 0x3, 0x5b, 0x68, 0x55, 0x29, 0x37, 0xb1, 0xc7, 0xd1, 0xcb, 0xef, 0xa4, 0xb1, 0x8, 0xe0, 0x32, 0x24, 0x93, 0xfa, 0x9e, 0xb, 0x8d, 0x39, 0x41, 0xd6, 0xc4, 0x62, 0x2b, 0xbc, 0x57, 0x5a, 0xad, 0x2d, 0xc, 0x14, 0xdc, 0xac, 0x88, 0xff, 0x91, 0xa8, 0x79, 0x65, 0xde, 0x55, 0x6e, 0xc7, 0x6f, 0xd0, 0xc2, 0x1a, 0x1a, 0x50, 0xa5, 0xfc, 0x8f, 0x80, 0xe2, 0x19, 0x96, 0xc3, 0x2f, 0xd7, 0x2f, 0xab, 0x97, 0xf9, 0x39, 0x5e, 0x7a, 0xed, 0x69, 0x67, 0x69, 0x90, 0x65, 0x3c, 0x15, 0x4f, 0xe0, 0xff, 0x58, 0xef, 0xd2, 0xfa, 0x3f, 0xdd, 0x7e, 0x78, 0x1a, 0x9c, 0xfd, 0xf4, 0xb2, 0x3a, 0x3f, 0xc, 0x3e, 0x12, 0xcf, 0xd2, 0xbe, 0x5c, 0x9b, 0x45, 0x5e, 0x56, 0x91, 0x3f, 0x38, 0x9c, 0x4, 0x1f, 0x9e, 0x62, 0xee, 0x47, 0xec, 0x83, 0x11, 0xfb, 0xa8, 0x6e, 0xf8, 0xff, 0xe8, 0x76, 0x3f, 0xa, 0xc6, 0x75, 0xf2, 0x87, 0xa7, 0x3a, 0x5d, 0xf, 0x53, 0x67, 0x52, 0xfb, 0x22, 0xf3, 0xe5, 0xcb, 0x8f, 0xd0, 0x1c, 0x16, 0xea, 0x2a, 0x4d, 0xf7, 0x4a, 0xe4, 0x7c, 0x44, 0xcd, 0x85, 0xe5, 0x59, 0x75, 0x1e, 0xe1, 0x3f, 0xfa, 0xb1, 0xd9, 0x9, 0x2a, 0xb1, 0x42, 0x8e, 0x3e, 0xa0, 0x95, 0xf9, 0xf6, 0x96, 0x5a, 0x5d, 0xcd, 0xce, 0x22, 0x1b, 0x2b, 0x78, 0xb3, 0x5a, 0x90, 0x10, 0x1b, 0x4, 0xa7, 0xfa, 0x8d, 0xa0, 0x2, 0x80, 0x87, 0x60, 0x3b, 0x85, 0xfe, 0xa4, 0x3, 0x6b, 0x16, 0xc4, 0xe2, 0x88, 0x9b, 0xa8, 0x4c, 0x43, 0x10, 0x49, 0x93, 0x4a, 0x54, 0x14, 0x44, 0xa, 0xfd, 0xd, 0xa, 0x43, 0x5a, 0x40, 0x7c, 0x50, 0x80, 0x90, 0x14, 0x3d, 0x86, 0x6, 0x6f, 0xc4, 0xfd, 0x1f, 0x52, 0xc, 0x40, 0x85, 0x23, 0x21, 0x19, 0x14, 0x8, 0x53, 0x9c, 0x74, 0x4c, 0x4f, 0x66, 0x33, 0x9e, 0xa0, 0x8a, 0xa, 0x91, 0x78, 0x6c, 0x70, 0x73, 0x6, 0xd2, 0xc7, 0xc7, 0x2e, 0x4a, 0xfe, 0x45, 0xfe, 0xf7, 0x4d, 0x9c, 0x3a, 0xb, 0x1c, 0xca, 0x22, 0x42, 0x55, 0xe5, 0x2a, 0xd3, 0x1f, 0x1d, 0x2, 0x41, 0xac, 0xfa, 0xc7, 0x81, 0x6a, 0xac, 0xbb, 0xac, 0x5f, 0x1d, 0x21, 0xe6, 0x39, 0x19, 0x4d, 0x0, 0x79, 0x41, 0xdb, 0x61, 0x7f, 0x8, 0x1f, 0x7e, 0xbf, 0x2f, 0x5b, 0xe8, 0x8f, 0x74, 0x23, 0x8f, 0x37, 0xd3, 0x2c, 0xe9, 0x18, 0x92, 0x31, 0xa8, 0xce, 0x62, 0xa3, 0x43, 0xdf, 0xaf, 0xa2, 0xea, 0x68, 0x4, 0x6d, 0x62, 0x8d, 0xde, 0xc8, 0x1c, 0x5f, 0x57, 0xb5, 0xe6, 0x0, 0x61, 0x88, 0x38, 0x40, 0x18, 0x5c, 0x74, 0x2c, 0x9a, 0xa9, 0xa7, 0x49, 0xaa, 0xbb, 0xce, 0x11, 0xda, 0xb, 0xe7, 0x2c, 0xd8, 0x6f, 0x8e, 0xf1, 0xb0, 0xea, 0x8f, 0x1a, 0xab, 0xe8, 0xac, 0xd8, 0x1e, 0xa5, 0x5e, 0xca, 0x7a, 0xa4, 0x87, 0xe6, 0x96, 0xfc, 0x7d, 0x93, 0xe5, 0x55, 0xc7, 0x32, 0x41, 0x63, 0xaa, 0x7b, 0x6b, 0xd0, 0xdd, 0x35, 0x1a, 0x83, 0x6e, 0x2e, 0x6e, 0x57, 0x55, 0xd7, 0xb0, 0x5b, 0xb, 0xdc, 0x58, 0xe4, 0xe7, 0x99, 0x19, 0x25, 0xdb, 0x5c, 0x3a, 0x41, 0x9c, 0x8a, 0x12, 0x5a, 0x1d, 0xd5, 0xc, 0x19, 0xb0, 0xa, 0xbd, 0x91, 0x9e, 0x44, 0x47, 0xed, 0x3d, 0x59, 0x1b, 0x4e, 0x49, 0xab, 0xb6, 0x31, 0x8f, 0xae, 0xbe, 0x69, 0xa1, 0x75, 0xf7, 0xb2, 0xee, 0x21, 0x34, 0x64, 0xc2, 0xef, 0x93, 0xab, 0x55, 0xe1, 0xea, 0x1a, 0x2f, 0x7c, 0xaa, 0xc9, 0x28, 0x34, 0x8, 0xe3, 0x31, 0x1b, 0xd, 0x71, 0x1b, 0x70, 0x45, 0x3, 0x3d, 0xf6, 0xae, 0x6, 0x46, 0xba, 0x1, 0xbf, 0x6f, 0x34, 0xd1, 0x87, 0x36, 0x70, 0x8, 0xf6, 0x56, 0xec, 0x1e, 0xc5, 0x30, 0x54, 0x8d, 0x59, 0x5b, 0xd3, 0x1c, 0x18, 0xe, 0x8b, 0x76, 0xa9, 0xd9, 0x1f, 0x9c, 0xdb, 0xc0, 0xd8, 0xab, 0xc7, 0xd9, 0xda, 0x7d, 0x62, 0x4f, 0xa3, 0xd1, 0x4, 0x0, 0x54, 0x2d, 0x34, 0x31, 0x7e, 0xa3, 0xbe, 0x2, 0xbc, 0x7a, 0xd5, 0xf0, 0x60, 0x76, 0xb4, 0xa1, 0x76, 0x4c, 0x55, 0xd5, 0x0, 0x68, 0x9d, 0x6a, 0x77, 0xe5, 0x7a, 0x72, 0xc6, 0xd6, 0xc9, 0x96, 0x2a, 0xd1, 0x7f, 0xd8, 0x4c, 0x57, 0x0, 0x69, 0xae, 0xe7, 0x13, 0x7c, 0x1a, 0xa5, 0x81, 0x36, 0x84, 0x80, 0x3d, 0x1a, 0xfc, 0xd7, 0x70, 0xf4, 0xe0, 0xcf, 0xc, 0x5d, 0x5, 0xca, 0x48, 0x7, 0xbe, 0x32, 0x56, 0x59, 0x4c, 0x16, 0x57, 0x5a, 0xc8, 0xfb, 0x83, 0x8f, 0x3, 0x56, 0x9e, 0x68, 0xbe, 0xb, 0xb2, 0x7c, 0xa8, 0xc8, 0xb2, 0x88, 0x1f, 0xfd, 0x29, 0x8, 0xf1, 0x8f, 0x5f, 0xb3, 0xf4, 0xe2, 0x3, 0x91, 0xba, 0x3f, 0x3a, 0x2, 0xe9, 0xa0, 0xef, 0x97, 0xed, 0x4d, 0x82, 0xe6, 0x83, 0x1a, 0xac, 0x8f, 0xf, 0x81, 0xf5, 0xaa, 0xfa, 0x59, 0xa0, 0x1a, 0x39, 0xe2, 0x81, 0x9, 0x5c, 0xff, 0x29, 0x53, 0xb1, 0x26, 0x42, 0x30, 0x7c, 0xc7, 0x24, 0x1a, 0xf0, 0xfd, 0xbe, 0xf3, 0x38, 0x16, 0xf3, 0x0, 0xb0, 0x30, 0x27, 0x72, 0x8, 0x4c, 0xf5, 0xaf, 0x98, 0xcc, 0xe8, 0xb4, 0x9a, 0xf4, 0x1, 0x92, 0xde, 0x6b, 0x77, 0xc2, 0xd6, 0x52, 0xdc, 0xab, 0xda, 0xe1, 0xe0, 0x81, 0xb1, 0x24, 0xa8, 0x42, 0xee, 0x5e, 0x8c, 0x71, 0x1b, 0xe9, 0xfb, 0x7e, 0xd6, 0xc3, 0x8f, 0x7e, 0x56, 0x3, 0xc7, 0xbd, 0x1b, 0x31, 0xe9, 0x80, 0x6a, 0xa8, 0x97, 0x35, 0xb6, 0xe8, 0x5e, 0xad, 0xb5, 0x48, 0x83, 0xf, 0xed, 0x1d, 0x42, 0xa1, 0x7, 0xc7, 0xf, 0x2, 0x35, 0x40, 0x9b, 0x52, 0xb4, 0x4a, 0x60, 0xcf, 0x35, 0x32, 0xc2, 0x50, 0xd0, 0x89, 0x1b, 0xf9, 0xf7, 0xdf, 0xc, 0xd4, 0x4c, 0xa9, 0x10, 0xa2, 0x1, 0x63, 0xf6, 0x5d, 0x15, 0xc5, 0x9a, 0x9d, 0x8c, 0x8e, 0x8e, 0x7, 0xff, 0xf5, 0x60, 0xf2, 0x5f, 0x83, 0x7, 0x9f, 0x1c, 0xb, 0x26, 0xe6, 0x98, 0x52, 0x60, 0xef, 0x61, 0x49, 0x64, 0x32, 0x6d, 0xdd, 0xe0, 0x1, 0x65, 0xe0, 0xd0, 0xf0, 0x4f, 0x78, 0x2c, 0x13, 0x5a, 0x25, 0x8f, 0x7, 0xc7, 0x46, 0xd1, 0xff, 0xfe, 0x18, 0xb, 0x37, 0x4b, 0x7c, 0x62, 0x15, 0xf9, 0xf3, 0x9f, 0xb0, 0x90, 0xb9, 0xca, 0x5d, 0xa3, 0x1e, 0x60, 0x77, 0xb0, 0x70, 0x62, 0xce, 0x6a, 0x5d, 0x0, 0x94, 0x2a, 0x5a, 0xcf, 0xe6, 0x52, 0x1c, 0x13, 0xf, 0xd2, 0x1b, 0x3c, 0x40, 0xf7, 0xe4, 0x29, 0xea, 0x41, 0x84, 0x1, 0x33, 0x5e, 0x33, 0x7c, 0x86, 0x8f, 0x4e, 0x3b, 0xc, 0x32, 0xa5, 0x72, 0xcb, 0x28, 0x49, 0x17, 0x12, 0x54, 0x5c, 0xc7, 0xa4, 0x13, 0xef, 0x3f, 0x3f, 0xdb, 0x59, 0xe6, 0xa2, 0x78, 0xbb, 0xbb, 0x40, 0x71, 0x47, 0xfd, 0xb2, 0x23, 0xdf, 0x1, 0x5, 0xb2, 0x8a, 0x61, 0xde, 0x5a, 0xb1, 0x11, 0xff, 0xf8, 0xe8, 0x93, 0x61, 0x40, 0x9a, 0xbe, 0xa7, 0x11, 0xdd, 0xb2, 0x27, 0x7c, 0x79, 0x8f, 0xa9, 0xd7, 0x5, 0x3b, 0x67, 0xfe, 0x78, 0x57, 0x11, 0x98, 0xf8, 0xce, 0xfc, 0x62, 0x77, 0xed, 0xd2, 0x9d, 0xdd, 0x3d, 0x6b, 0xcb, 0x74, 0xdc, 0x9e, 0xf7, 0x97, 0x28, 0xc5, 0xe8, 0xdb, 0xea, 0x2f, 0x2d, 0x2d, 0xaa, 0xd6, 0x4a, 0xb0, 0x42, 0x99, 0x4b, 0xc, 0xf1, 0x55, 0x58, 0xb2, 0x10, 0x7a, 0x33, 0x10, 0x72, 0x6, 0x5b, 0x9a, 0xeb, 0x14, 0xf7, 0x7a, 0xf2, 0xd6, 0x3e, 0x3e, 0xca, 0xd8, 0x3a, 0x42, 0x43, 0x46, 0xba, 0xe9, 0x5f, 0x2e, 0x41, 0xb2, 0x59, 0x63, 0x80, 0xcb, 0x80, 0x95, 0xc6, 0xef, 0x80, 0x65, 0xa7, 0xf1, 0xa4, 0xa8, 0x87, 0x20, 0x96, 0x7e, 0xea, 0x2f, 0x83, 0x50, 0x69, 0x16, 0x8b, 0x60, 0x3b, 0xc6, 0x4, 0xa9, 0x3, 0x7c, 0x26, 0x3, 0xc7, 0x3f, 0x55, 0xa1, 0xe4, 0x5b, 0xd8, 0x6, 0x47, 0x1d, 0x55, 0x3, 0x2b, 0xf0, 0xd3, 0xed, 0x6d, 0x85, 0xf6, 0x2, 0x3, 0x2b, 0x2c, 0x7, 0x24, 0xa2, 0xd7, 0x97, 0xa, 0x14, 0x9, 0x82, 0xda, 0x1d, 0x61, 0xe5, 0xf7, 0x40, 0x82, 0xc7, 0xbb, 0x5e, 0x5e, 0x4e, 0xfc, 0x2c, 0xd2, 0x3f, 0xd0, 0xd8, 0x32, 0xa1, 0xd2, 0xdf, 0xf7, 0xb, 0xa, 0xd1, 0xa, 0x84, 0xc8, 0x91, 0xfb, 0x3, 0xe4, 0x56, 0xc5, 0x2a, 0x8, 0xa9, 0xb2, 0xa3, 0x86, 0x5d, 0x8c, 0xa1, 0xd2, 0x8a, 0x5d, 0xa3, 0x7, 0x2a, 0x2a, 0xf4, 0x64, 0x1c, 0xb4, 0x96, 0x5e, 0xb5, 0x6a, 0x85, 0x48, 0x9b, 0xb4, 0x93, 0x7c, 0x2c, 0x1a, 0x56, 0x68, 0x6d, 0x15, 0xcb, 0x98, 0x15, 0x13, 0xeb, 0x97, 0xef, 0x15, 0xb9, 0xd7, 0x13, 0xa5, 0xce, 0xc4, 0xf7, 0x79, 0x84, 0xea, 0xf5, 0xd7, 0x84, 0x16, 0x74, 0xc, 0x33, 0x47, 0xf7, 0x8e, 0x8, 0x67, 0x13, 0x67, 0x2a, 0xe, 0x2, 0xdf, 0x9c, 0xc, 0x2b, 0x19, 0xd, 0x56, 0x8d, 0xc3, 0xf8, 0xe5, 0x1c, 0x47, 0xb2, 0x65, 0x9f, 0x21, 0xa4, 0xa2, 0xc5, 0xa4, 0xb8, 0x8e, 0x77, 0xc, 0x83, 0xac, 0x1d, 0x4b, 0xa0, 0xed, 0xea, 0x33, 0xc2, 0x1b, 0x2e, 0xeb, 0xc2, 0x2d, 0xab, 0xcb, 0x9d, 0x65, 0x96, 0x39, 0x90, 0xa, 0x7a, 0x56, 0x59, 0xf7, 0x1c, 0x5f, 0xa2, 0xe5, 0xa, 0x5e, 0xa, 0x28, 0xfb, 0x95, 0x8c, 0x19, 0xf5, 0xc5, 0x1b, 0x60, 0x32, 0x40, 0x93, 0x63, 0x58, 0x8d, 0xdb, 0x3e, 0x1a, 0xe6, 0xeb, 0x66, 0x8b, 0x5c, 0xb8, 0xde, 0x6, 0xec, 0x59, 0x44, 0xe0, 0xfd, 0x55, 0x7c, 0x95, 0x5d, 0x6c, 0x2e, 0xc8, 0x44, 0xc3, 0x75, 0xb9, 0xe3, 0x78, 0xfe, 0x2d, 0x93, 0x70, 0x43, 0x75, 0xb6, 0xec, 0x85, 0xd5, 0x90, 0x30, 0xb8, 0x79, 0xc7, 0x96, 0x44, 0x25, 0x7c, 0xf2, 0xde, 0x37, 0xdb, 0xc2, 0x3b, 0xf5, 0xf6, 0x28, 0x6d, 0xd3, 0x19, 0x67, 0x4f, 0x49, 0x75, 0x85, 0x37, 0x52, 0xb6, 0xf9, 0x4e, 0xd9, 0x32, 0xd9, 0x51, 0x1e, 0xc7, 0xfc, 0x32, 0x4b, 0x38, 0xe9, 0xae, 0xc9, 0x5a, 0x83, 0xec, 0xd7, 0x65, 0x49, 0x11, 0x65, 0x5f, 0xda, 0xc, 0xf5, 0xbc, 0xd5, 0x95, 0xc7, 0x1a, 0x79, 0xd2, 0x1c, 0xa8, 0x6c, 0x64, 0xaa, 0xe4, 0xc3, 0x8e, 0x4e, 0xea, 0x92, 0xb2, 0xf1, 0x1d, 0x5, 0xc9, 0xea, 0xc4, 0xef, 0xca, 0xef, 0x48, 0x27, 0x6b, 0xc3, 0xaf, 0xe8, 0x90, 0x3, 0xde, 0xb4, 0x8d, 0xbc, 0x70, 0x81, 0x44, 0x3a, 0xa1, 0x1b, 0xb4, 0xf, 0xa9, 0xe4, 0x2a, 0x55, 0xfa, 0x81, 0x9, 0xf6, 0x5d, 0x84, 0xf, 0x59, 0xa2, 0xd1, 0x4, 0x6a, 0x8b, 0x5a, 0x27, 0x40, 0xed, 0x61, 0xcf, 0xdb, 0xc3, 0x2b, 0x2c, 0x98, 0x3e, 0xfc, 0xe5, 0x5b, 0xf6, 0x16, 0xaa, 0x2d, 0x8b, 0x7c, 0xe, 0x94, 0x12, 0x9d, 0x5e, 0x1c, 0x27, 0x7, 0x1b, 0x95, 0x1, 0x26, 0xcb, 0xfa, 0x7e, 0xc, 0xef, 0xa7, 0xcd, 0x93, 0x23, 0xcd, 0xb1, 0x6, 0x17, 0xc0, 0x43, 0x6c, 0xd6, 0xe4, 0xe9, 0x3, 0xc9, 0x62, 0x98, 0xe3, 0x32, 0xe2, 0xa7, 0xe5, 0x4, 0xa3, 0xc0, 0x1, 0x82, 0xdf, 0xb2, 0x47, 0xd0, 0x67, 0xba, 0x8e, 0xdf, 0x3c, 0x43, 0x5c, 0xca, 0x53, 0x9c, 0x15, 0xdd, 0x53, 0x74, 0x50, 0x97, 0x6a, 0x30, 0x45, 0x2b, 0xa2, 0xa7, 0xc0, 0xe7, 0x2, 0x51, 0x82, 0x2e, 0x0, 0x73, 0xbc, 0x28, 0x80, 0xc7, 0x2c, 0x90, 0x44, 0x54, 0x44, 0x6b, 0xe8, 0x77, 0xd9, 0x97, 0x29, 0xbf, 0x6c, 0x62, 0x68, 0x1f, 0x84, 0x1, 0xba, 0xaf, 0x10, 0x79, 0x78, 0x96, 0xf0, 0x5f, 0xbc, 0x34, 0x30, 0xeb, 0x40, 0x4a, 0xde, 0x2f, 0xba, 0x6b, 0xf5, 0x72, 0x26, 0x5b, 0xee, 0xe5, 0x56, 0x4d, 0x9d, 0xd2, 0xae, 0x27, 0x6a, 0xd5, 0x2d, 0xab, 0x3a, 0xaa, 0x77, 0x57, 0xd, 0xa6, 0xe7, 0x43, 0x21, 0xa5, 0xc4, 0x6c, 0xd1, 0xbe, 0x4c, 0x29, 0x21, 0xc9, 0x46, 0x83, 0xf, 0xc8, 0x83, 0xc4, 0x5a, 0xa8, 0x52, 0xde, 0xb2, 0x8a, 0xe7, 0x64, 0xca, 0x28, 0x93, 0x26, 0x80, 0x88, 0x48, 0x22, 0x69, 0xf, 0x98, 0xa5, 0xd1, 0x6, 0x43, 0xa8, 0xd7, 0xad, 0x9d, 0xc9, 0xf4, 0x73, 0x69, 0x62, 0x38, 0xa8, 0xed, 0xa2, 0xe4, 0xdb, 0xb8, 0x22, 0x22, 0x8f, 0x2f, 0xd, 0x37, 0xf1, 0xa6, 0x50, 0x98, 0xc9, 0x1a, 0x6f, 0x46, 0x20, 0xe0, 0xe1, 0x75, 0x2c, 0xe, 0xca, 0xb8, 0x78, 0xbd, 0xa9, 0xb, 0x77, 0x84, 0x1f, 0xdf, 0xa, 0x97, 0x35, 0x47, 0xee, 0x57, 0x7e, 0x3d, 0x7a, 0x15, 0x93, 0xc, 0xa3, 0xb9, 0x39, 0x8a, 0x3e, 0x15, 0x45, 0x6d, 0xf6, 0x40, 0xd5, 0x11, 0xa3, 0xf, 0x5b, 0xe6, 0x92, 0xd8, 0x96, 0xaf, 0x9c, 0x57, 0xeb, 0xae, 0x34, 0xc6, 0x55, 0xef, 0x1, 0x9a, 0xa9, 0x1, 0xa2, 0x23, 0x63, 0x89, 0x7, 0xe, 0xab, 0xb1, 0x9, 0x3f, 0x32, 0xea, 0x19, 0x36, 0x85, 0xe1, 0xb, 0x47, 0x83, 0x35, 0x4e, 0x95, 0xc6, 0x8b, 0x75, 0x9, 0x65, 0xf2, 0x98, 0x69, 0xdb, 0xc5, 0x3a, 0x4f, 0xe1, 0x29, 0xf6, 0xd0, 0x5a, 0x25, 0x57, 0xe0, 0x2a, 0xbc, 0xe0, 0x37, 0x2e, 0xe8, 0xef, 0x69, 0x8e, 0x52, 0xaf, 0xde, 0x6c, 0x59, 0xbc, 0x9, 0x13, 0xf8, 0x80, 0x23, 0xea, 0x56, 0x18, 0x6b, 0x30, 0xc1, 0xa2, 0xa, 0x4c, 0xd4, 0xa, 0xe9, 0x4d, 0x39, 0x38, 0xd8, 0xaf, 0x26, 0xd, 0x36, 0x52, 0xc, 0x1e, 0x51, 0x40, 0x47, 0x25, 0x32, 0x70, 0xec, 0xc8, 0x13, 0x56, 0x93, 0x76, 0xa6, 0xc3, 0x38, 0xaa, 0xb3, 0x80, 0x32, 0x8e, 0x12, 0xf, 0x82, 0x84, 0xf5, 0x58, 0x9a, 0x53, 0x70, 0xd4, 0x31, 0xcc, 0x79, 0xeb, 0xb7, 0xb1, 0xa5, 0x96, 0x9f, 0xcf, 0xb9, 0xf9, 0xd6, 0xad, 0x5e, 0xa7, 0xc7, 0xbe, 0xd5, 0xea, 0x92, 0xca, 0x29, 0xdd, 0xbe, 0x7c, 0x9b, 0x8b, 0xa5, 0x80, 0x7f, 0xd7, 0xc5, 0x75, 0xeb, 0xa1, 0x5, 0x3a, 0x25, 0x30, 0xb0, 0xcf, 0xe4, 0x79, 0x23, 0x13, 0xea, 0x4b, 0x71, 0x59, 0x53, 0x1b, 0x8, 0x5b, 0xb0, 0x35, 0xae, 0x3a, 0x60, 0x4a, 0x53, 0x8b, 0x36, 0x44, 0x41, 0x96, 0xeb, 0x7d, 0x9b, 0x89, 0xef, 0x4e, 0xf7, 0x65, 0x68, 0xfe, 0x80, 0x75, 0xe5, 0xcb, 0x90, 0xfd, 0x1, 0xae, 0xaf, 0x55, 0xa4, 0x7e, 0x29, 0xad, 0xa3, 0xd, 0xa3, 0x80, 0x6e, 0x84, 0x49, 0x93, 0x6f, 0x17, 0xfa, 0xda, 0x9a, 0xb6, 0x9a, 0xa1, 0xcd, 0x61, 0x79, 0x48, 0x5f, 0xd0, 0x48, 0x22, 0xb5, 0x23, 0xba, 0xc9, 0x60, 0x1e, 0x92, 0xb5, 0x2f, 0xd5, 0xbb, 0xa0, 0x76, 0x2a, 0xc5, 0x8f, 0x16, 0x57, 0x34, 0x6d, 0xae, 0x65, 0xbf, 0x7e, 0x8f, 0x53, 0x5a, 0xb, 0xc8, 0x48, 0xce, 0x8d, 0x46, 0xd4, 0x2b, 0x93, 0x50, 0x63, 0x88, 0xf1, 0x9a, 0x4c, 0x73, 0x24, 0x22, 0xaf, 0xee, 0x6a, 0x20, 0x45, 0x91, 0xc3, 0x3c, 0xbe, 0xeb, 0x28, 0x1f, 0xae, 0x1, 0x46, 0xd0, 0x42, 0xbc, 0x68, 0xf9, 0x53, 0x60, 0x9c, 0x40, 0xfd, 0xb6, 0x46, 0x63, 0xf8, 0x15, 0xeb, 0x84, 0x6c, 0xdb, 0x9a, 0x55, 0x9e, 0x63, 0x77, 0xa6, 0x4f, 0xaf, 0xc0, 0xeb, 0x47, 0x81, 0x3, 0xd5, 0x19, 0xfa, 0x32, 0x80, 0xc0, 0xac, 0x2a, 0xab, 0x9f, 0xda, 0xad, 0xd0, 0x78, 0x51, 0x82, 0x2d, 0x40, 0xd8, 0x73, 0x95, 0xea, 0xc3, 0x22, 0x9e, 0xd2, 0xad, 0x6c, 0x6c, 0xe7, 0x9f, 0xad, 0xcf, 0x7, 0x2b, 0xb4, 0x9b, 0x28, 0xa5, 0x6f, 0x92, 0x99, 0x31, 0x8d, 0xd7, 0xae, 0xe4, 0x92, 0xcf, 0x5, 0x12, 0x5b, 0x60, 0x38, 0x67, 0x56, 0x91, 0x8f, 0x39, 0x3d, 0x90, 0xbd, 0x0, 0x6c, 0xdb, 0xef, 0xab, 0xb0, 0x69, 0x67, 0xe7, 0x6c, 0x23, 0xde, 0x3b, 0x6e, 0x1a, 0xff, 0x10, 0xcf, 0x1, 0x1c, 0x7, 0x43, 0x8f, 0x31, 0x10, 0x5d, 0xe1, 0x9f, 0xb5, 0xc3, 0xa0, 0xcc, 0xec, 0xd8, 0x16, 0x1e, 0xd0, 0xf8, 0x48, 0x8e, 0x3a, 0x93, 0xc3, 0xcc, 0xea, 0x71, 0x55, 0x67, 0xb, 0x7c, 0x12, 0xf, 0xfe, 0x45, 0xc3, 0x2b, 0x61, 0x2f, 0x1f, 0xa0, 0x97, 0x83, 0x30, 0x46, 0x83, 0x74, 0xe4, 0x1, 0xcb, 0xd6, 0x63, 0x5b, 0x0, 0x73, 0x4b, 0x59, 0x6, 0xd, 0x13, 0xd6, 0xea, 0xfb, 0x1a, 0xdd, 0xb, 0xe8, 0xbb, 0xbe, 0x39, 0xb6, 0x51, 0x8d, 0xcb, 0xee, 0x94, 0xa1, 0xb3, 0xed, 0x46, 0x3a, 0xf, 0xce, 0xb2, 0xe5, 0x12, 0xc4, 0xad, 0x9f, 0xcb, 0xf8, 0x92, 0xa7, 0x18, 0xbd, 0x5e, 0x98, 0x22, 0xa3, 0xe4, 0xab, 0x7f, 0x30, 0x44, 0x4c, 0xaf, 0x79, 0x5d, 0x4c, 0xfc, 0xd6, 0x5, 0x8d, 0x9f, 0x5b, 0xd, 0xac, 0x45, 0x74, 0xe1, 0xaf, 0xf1, 0xc5, 0x96, 0x39, 0xfe, 0xc9, 0xe1, 0xd7, 0x12, 0x3d, 0x52, 0xe7, 0xf8, 0x7, 0xe4, 0xd6, 0xfc, 0xb4, 0x89, 0x9b, 0x8e, 0x8e, 0x27, 0x39, 0x89, 0xb3, 0x7e, 0xd1, 0xe3, 0xc1, 0xd1, 0xf1, 0xd6, 0x4, 0x76, 0xd8, 0x40, 0xbc, 0x24, 0xe5, 0x83, 0xaf, 0x8c, 0x9, 0xf9, 0xd0, 0x4e, 0x3a, 0xb8, 0x82, 0x2a, 0xe9, 0xe0, 0x9a, 0x5d, 0x29, 0x3b, 0x5f, 0x6b, 0x1, 0x1a, 0x46, 0xc0, 0xec, 0x7a, 0x57, 0x29, 0x65, 0x3c, 0xcc, 0xae, 0xcc, 0xe7, 0x71, 0x9a, 0x4d, 0xc9, 0x57, 0xe0, 0xf4, 0xf2, 0x38, 0x4b, 0x69, 0xa3, 0x6e, 0x26, 0x1e, 0xc7, 0xec, 0x2c, 0xa7, 0xec, 0x98, 0xd9, 0xac, 0x36, 0xa9, 0xee, 0x2a, 0x28, 0xb2, 0xd9, 0x4c, 0x1b, 0x46, 0x77, 0x15, 0xa4, 0x5c, 0x51, 0xe, 0x39, 0xa0, 0xce, 0x62, 0x90, 0xc9, 0x2a, 0x34, 0xa7, 0x7e, 0xb1, 0x73, 0x90, 0xb6, 0xc5, 0xb5, 0xa8, 0xf1, 0xd9, 0xee, 0xe1, 0x36, 0xac, 0xc4, 0xeb, 0x3a, 0xdd, 0x3, 0xb7, 0x8d, 0xbe, 0x8d, 0x1a, 0x5d, 0x53, 0xb0, 0xac, 0xc7, 0x59, 0x62, 0x9a, 0x70, 0xbb, 0x8a, 0x9b, 0x36, 0xde, 0x6c, 0x29, 0x3c, 0x1a, 0x12, 0x26, 0x88, 0x31, 0x4d, 0xc, 0x3, 0xe6, 0x18, 0x3f, 0xd, 0x3, 0xec, 0xce, 0x33, 0x65, 0xd9, 0x69, 0x8b, 0x21, 0x87, 0x88, 0x77, 0x6, 0xd4, 0x3e, 0x23, 0xf0, 0xe, 0x6b, 0x48, 0x67, 0x20, 0xc7, 0x85, 0x26, 0xb9, 0x6, 0xb9, 0x57, 0x20, 0xdb, 0x70, 0x7, 0x2, 0xde, 0x6, 0x12, 0x85, 0xb, 0xcb, 0x93, 0xbc, 0x61, 0xd1, 0xaa, 0x84, 0x68, 0x39, 0x4d, 0xa5, 0xf7, 0xf2, 0xd5, 0x91, 0x31, 0x4e, 0x8b, 0x61, 0xad, 0x92, 0x9, 0x13, 0x27, 0x2b, 0x5, 0xf0, 0xc9, 0x6f, 0x79, 0x8a, 0xfe, 0x7f, 0x39, 0x21, 0x9, 0xfa, 0xb, 0x8, 0x95, 0x87, 0x1b, 0xb0, 0x94, 0x3f, 0xc1, 0x3b, 0xc2, 0x20, 0xc5, 0x2f, 0x6a, 0xf0, 0x86, 0x55, 0xb, 0x57, 0x3b, 0x80, 0xe8, 0x1d, 0x20, 0x46, 0x60, 0xe3, 0xb1, 0xe5, 0xc9, 0xcb, 0xaa, 0xe2, 0x11, 0xd0, 0xae, 0x4f, 0xfe, 0xf4, 0xc5, 0x45, 0x3c, 0xef, 0x7e, 0x2d, 0xda, 0x60, 0x28, 0x61, 0x58, 0xe8, 0xce, 0xf6, 0xed, 0xb3, 0x2f, 0xd, 0x81, 0xc2, 0x96, 0x9a, 0xc, 0xb5, 0x18, 0xda, 0x54, 0xb, 0x79, 0xd0, 0x61, 0x1d, 0x6f, 0xd8, 0x20, 0x97, 0xd1, 0xfd, 0x4d, 0x8a, 0x91, 0xd7, 0x31, 0xad, 0x85, 0x41, 0x60, 0xae, 0x7f, 0x61, 0x78, 0xb1, 0xd2, 0x36, 0x8, 0xd6, 0x96, 0xf9, 0xd6, 0x48, 0x80, 0x8d, 0xc9, 0x49, 0x19, 0x6e, 0x54, 0x16, 0xbe, 0xdc, 0xca, 0xa0, 0xba, 0x23, 0x1f, 0x78, 0x81, 0xda, 0xcd, 0xeb, 0xac, 0x99, 0x7b, 0x3e, 0x29, 0xfc, 0x5d, 0xd9, 0x41, 0x78, 0x63, 0xba, 0x89, 0xa1, 0xc9, 0x4e, 0xec, 0x2f, 0x99, 0xf6, 0xae, 0xc3, 0x47, 0x57, 0x85, 0x5f, 0x6, 0x66, 0x95, 0xa6, 0xf9, 0x33, 0x26, 0xb4, 0x2d, 0x47, 0xb, 0xd4, 0x9c, 0xeb, 0xda, 0x32, 0x36, 0x29, 0xb3, 0x7a, 0x60, 0x19, 0x45, 0xac, 0x1a, 0x1b, 0x81, 0xbc, 0x4a, 0x68, 0xa0, 0x90, 0xe2, 0x86, 0x40, 0x25, 0xa9, 0xef, 0xa1, 0x1b, 0xff, 0x5e, 0x5e, 0x54, 0x7b, 0xd0, 0xe5, 0x65, 0x96, 0x62, 0x48, 0xfa, 0x62, 0x4d, 0x10, 0xb0, 0x27, 0xa0, 0x6d, 0xaf, 0x2c, 0xf6, 0xb2, 0x6a, 0xf, 0x18, 0x96, 0xfc, 0xa3, 0x6a, 0x6f, 0xca, 0x79, 0xbe, 0xb7, 0xe6, 0x73, 0xd4, 0xd8, 0xae, 0x31, 0x14, 0x8e, 0x16, 0x63, 0x51, 0x33, 0x21, 0x39, 0x4f, 0x6b, 0xc3, 0x63, 0xc5, 0xae, 0xb6, 0x94, 0x8, 0xce, 0x9d, 0x96, 0xaf, 0xc9, 0xc5, 0x18, 0x21, 0x4e, 0x68, 0x16, 0x64, 0xa3, 0x77, 0x2b, 0x17, 0x48, 0xe2, 0xaf, 0x8a, 0xb5, 0xf3, 0x9e, 0xaf, 0x9a, 0x34, 0xf1, 0x26, 0x79, 0x9c, 0x56, 0x42, 0xf9, 0x21, 0x39, 0x1b, 0xf8, 0x29, 0x4f, 0x4c, 0x18, 0x1b, 0xe2, 0x96, 0xc8, 0xd4, 0xaa, 0x8, 0x7c, 0x27, 0xa1, 0xe3, 0xd0, 0x88, 0x92, 0x51, 0x21, 0x1d, 0x4, 0xa5, 0xd0, 0x62, 0x64, 0xc9, 0x3f, 0xb2, 0xa9, 0xcd, 0x2a, 0x8d, 0x2b, 0xe7, 0x70, 0x1b, 0x72, 0x42, 0x26, 0x85, 0x41, 0x39, 0xcc, 0x4c, 0x8c, 0x1a, 0xc3, 0x4d, 0xc9, 0xbf, 0x51, 0xa5, 0x18, 0x2f, 0xd1, 0x72, 0xb5, 0x8e, 0xf3, 0xe6, 0x1b, 0x7c, 0xa6, 0xf3, 0xa7, 0x43, 0xe, 0x11, 0xe, 0xb8, 0x91, 0x5f, 0xf5, 0xcd, 0xae, 0x0, 0x7a, 0xf, 0xb3, 0x9e, 0x9d, 0xd2, 0xe8, 0xca, 0xa6, 0x3b, 0xed, 0xa5, 0xb9, 0x91, 0x34, 0xf, 0x39, 0x35, 0xfa, 0xb8, 0xde, 0xd2, 0xd3, 0xa4, 0xc2, 0x10, 0xb2, 0xbd, 0x92, 0x52, 0xbe, 0x90, 0x4f, 0x1a, 0x13, 0x36, 0x51, 0x30, 0xa0, 0x9d, 0x0, 0xf8, 0x40, 0x58, 0x55, 0x37, 0xb3, 0xfc, 0x1b, 0xf9, 0xf6, 0x3c, 0xba, 0xec, 0x65, 0x39, 0x19, 0xd2, 0x86, 0x2e, 0xd3, 0x6b, 0xe1, 0xdb, 0x99, 0x55, 0x9f, 0xc2, 0x6, 0x51, 0xa6, 0x40, 0xca, 0x62, 0xa6, 0x6b, 0xfa, 0x1e, 0x9b, 0x46, 0xbc, 0x78, 0x11, 0x2f, 0x57, 0xa6, 0x61, 0xcb, 0x2c, 0x12, 0xd1, 0x2e, 0xf9, 0xa4, 0xb6, 0x55, 0x66, 0x78, 0xf7, 0x8c, 0x38, 0xd8, 0xf5, 0x4, 0xa2, 0x1c, 0xa2, 0xf2, 0x38, 0x50, 0xee, 0xba, 0xe3, 0xa6, 0x9a, 0x33, 0x5e, 0xcb, 0xe7, 0xeb, 0xaf, 0x98, 0xec, 0xc3, 0x18, 0x1d, 0x1b, 0x32, 0xc3, 0xcc, 0xdb, 0xd2, 0x19, 0x32, 0xc5, 0x93, 0x8b, 0x40, 0x5, 0x52, 0xe9, 0xa5, 0x99, 0x74, 0xa9, 0x8e, 0xfc, 0xae, 0x56, 0x11, 0x88, 0xcc, 0xef, 0xa4, 0x8a, 0x0, 0xe9, 0xb6, 0x51, 0xb3, 0x96, 0x3, 0x44, 0x96, 0xd1, 0xbe, 0x8f, 0x36, 0xd1, 0xb8, 0x3f, 0xf, 0xd7, 0x89, 0x63, 0x2b, 0x76, 0xad, 0xbf, 0xc3, 0x44, 0x5e, 0x9c, 0x38, 0x84, 0x16, 0xb4, 0xbd, 0xc6, 0xbb, 0x19, 0x68, 0x93, 0xd4, 0xc2, 0xa7, 0x6a, 0x98, 0x80, 0x90, 0xa8, 0xe, 0xbd, 0x42, 0x83, 0x1f, 0x27, 0x22, 0x7, 0xba, 0xa3, 0x74, 0x10, 0x3b, 0xf8, 0x40, 0x59, 0xba, 0xcb, 0x5a, 0x64, 0xc, 0x2e, 0x76, 0x17, 0xab, 0xa9, 0x5c, 0x59, 0x93, 0xcc, 0xbf, 0x9f, 0x59, 0xfb, 0x9d, 0x1f, 0x1c, 0x14, 0x3b, 0xc1, 0xda, 0xd8, 0xb6, 0x7a, 0x48, 0x3d, 0xdf, 0x1a, 0x49, 0xbf, 0x91, 0xd, 0x12, 0xd, 0x88, 0x3f, 0x7e, 0xb3, 0xcf, 0x7e, 0x73, 0x88, 0x50, 0xae, 0xd7, 0x4c, 0x1b, 0x37, 0xce, 0x51, 0xaf, 0xb6, 0x76, 0x83, 0xc3, 0xa9, 0x4f, 0x55, 0xaf, 0x36, 0x63, 0x83, 0xe4, 0x6d, 0x13, 0xfe, 0x2c, 0xe2, 0x4b, 0xf0, 0x96, 0x59, 0xf0, 0x96, 0x75, 0xc1, 0x9b, 0x31, 0x5c, 0xd6, 0x98, 0x15, 0xb3, 0xe6, 0xbc, 0xa3, 0xd, 0x63, 0x36, 0x76, 0x9d, 0x56, 0x8b, 0x18, 0x5f, 0x3c, 0xb3, 0xa0, 0x39, 0xdb, 0xd, 0xcd, 0xd9, 0x2e, 0x68, 0xce, 0xba, 0xa1, 0x39, 0x53, 0xd0, 0x2c, 0x1a, 0xf8, 0x2b, 0x80, 0x60, 0xe4, 0x4d, 0xf9, 0x25, 0x47, 0x1f, 0x58, 0x6a, 0x7, 0xdd, 0xb0, 0xa9, 0xad, 0x83, 0x83, 0xcc, 0x80, 0x78, 0x4, 0xf8, 0xfa, 0xc6, 0xc2, 0x81, 0x81, 0x1a, 0xc7, 0xde, 0x3e, 0xe5, 0x2c, 0x33, 0x5d, 0xcc, 0x8f, 0x95, 0xb3, 0xfc, 0x55, 0x3f, 0x53, 0x2a, 0xe6, 0xab, 0x5e, 0xa6, 0x7c, 0xd7, 0xa7, 0xc0, 0xa7, 0xf5, 0xfd, 0xfa, 0x53, 0x2c, 0x29, 0x4a, 0xd7, 0xcd, 0x99, 0x1e, 0x1d, 0x8f, 0x5b, 0x83, 0xf6, 0x79, 0x2f, 0x2a, 0x58, 0xd9, 0x87, 0x7f, 0x72, 0xf8, 0xc2, 0x73, 0x6b, 0x23, 0x98, 0x1d, 0x27, 0xfd, 0xd7, 0x20, 0x10, 0x79, 0x3d, 0x23, 0xf7, 0x16, 0x7, 0x6e, 0x5c, 0x81, 0x70, 0x66, 0x5e, 0xa2, 0x94, 0x8d, 0x5f, 0x56, 0xd, 0x85, 0x6d, 0x9a, 0xf3, 0x32, 0xd0, 0x8f, 0x7a, 0x72, 0xbd, 0x83, 0x1e, 0x1b, 0x8b, 0xb6, 0xed, 0x20, 0x7, 0xb5, 0x59, 0xa2, 0xdc, 0x7, 0x73, 0x77, 0xa0, 0xaf, 0x13, 0xb5, 0x29, 0x76, 0x7a, 0x26, 0xcb, 0x5f, 0xc3, 0xe7, 0x49, 0xbd, 0x59, 0x92, 0xf9, 0x15, 0xb8, 0xe3, 0x1d, 0x61, 0x43, 0x89, 0x84, 0x63, 0x79, 0xe3, 0xf6, 0x9d, 0xd8, 0xf8, 0x99, 0x96, 0xd4, 0xf5, 0x2f, 0x21, 0x20, 0xab, 0x9f, 0x42, 0xe8, 0x91, 0xeb, 0x74, 0xf5, 0x70, 0x99, 0xcd, 0x1, 0x90, 0x13, 0x7a, 0xf5, 0x40, 0x42, 0xf2, 0xb5, 0x4c, 0x8c, 0xa7, 0xe8, 0x84, 0x6e, 0xdd, 0x7c, 0xa0, 0xec, 0x22, 0x5, 0xb6, 0x88, 0x80, 0xd1, 0xba, 0xbf, 0x93, 0xcf, 0x7f, 0x5f, 0x55, 0xf2, 0x1e, 0xaf, 0x77, 0x7c, 0x28, 0x7a, 0x51, 0x32, 0x9e, 0x4, 0x59, 0x35, 0x46, 0x95, 0xaf, 0x4, 0x44, 0xf4, 0x28, 0xee, 0xd5, 0x1d, 0x9, 0x21, 0xaa, 0x97, 0x8d, 0xe5, 0x92, 0xf2, 0xa3, 0xe3, 0x96, 0x1e, 0x68, 0x62, 0x4d, 0x83, 0xde, 0xd9, 0x95, 0x68, 0xaf, 0xf, 0xc5, 0x4f, 0x86, 0x4a, 0x55, 0xab, 0x4a, 0xac, 0x85, 0x86, 0x58, 0x4e, 0xb4, 0x9f, 0xd7, 0x25, 0xd4, 0xac, 0x41, 0x12, 0x2f, 0xde, 0x78, 0x4a, 0x93, 0x5b, 0xb7, 0xc5, 0xa4, 0xce, 0x11, 0x2a, 0x91, 0xcb, 0xf2, 0x8e, 0xe3, 0x40, 0x63, 0x24, 0x11, 0x2b, 0x30, 0xbe, 0x5, 0x97, 0x47, 0xae, 0x24, 0x37, 0xe5, 0x9b, 0xac, 0x52, 0xba, 0x41, 0xd1, 0x71, 0x70, 0x93, 0x0, 0x40, 0xc8, 0x35, 0xf, 0x3b, 0xae, 0x30, 0x2d, 0x54, 0xd9, 0xcf, 0x8c, 0xb3, 0x60, 0x42, 0x9d, 0xb1, 0x78, 0xaa, 0xa8, 0x9f, 0xb5, 0xb2, 0x82, 0x56, 0xed, 0xfe, 0xbb, 0xd6, 0xb6, 0x99, 0x8, 0x71, 0xfe, 0xc6, 0xc2, 0x19, 0x86, 0x26, 0x23, 0x96, 0x32, 0x54, 0xb, 0xd7, 0xcb, 0x1c, 0xe3, 0xbb, 0xc7, 0x44, 0x7b, 0xf7, 0x9f, 0xa8, 0xa3, 0x8b, 0x7b, 0x4f, 0xb3, 0xa3, 0xae, 0x6b, 0x92, 0x5b, 0x73, 0xff, 0xae, 0xcc, 0xfd, 0x13, 0x10, 0x58, 0xc3, 0x8d, 0xa4, 0xf3, 0xa6, 0xa8, 0xdf, 0xee, 0xc5, 0x5c, 0x33, 0x1, 0xa0, 0x75, 0xb, 0xf7, 0xa9, 0xbf, 0x7d, 0x44, 0xb2, 0x5a, 0x4c, 0x57, 0xe0, 0xad, 0xf2, 0x26, 0x6e, 0x6c, 0x2, 0xad, 0x56, 0xa6, 0x40, 0x16, 0x7e, 0x37, 0xd1, 0x1, 0x25, 0xa2, 0xf8, 0x8f, 0x2b, 0x18, 0x79, 0x17, 0x59, 0x9a, 0x2e, 0xb9, 0x27, 0xdb, 0xb1, 0xcf, 0x3c, 0x2b, 0x7a, 0x74, 0x4a, 0x7a, 0xe5, 0xd1, 0xb1, 0x62, 0xf4, 0x4c, 0xfd, 0xab, 0x93, 0xe3, 0x73, 0x9, 0x66, 0x1a, 0x45, 0xbc, 0x1f, 0x4a, 0xd3, 0x9a, 0x40, 0x55, 0xdd, 0x52, 0xd, 0x36, 0xca, 0x18, 0xd, 0x35, 0xf4, 0x94, 0xb2, 0x35, 0xf3, 0x2, 0x4c, 0x68, 0x1, 0xe5, 0x5d, 0xc4, 0xa1, 0x8d, 0xc9, 0xfc, 0x76, 0x9, 0xb4, 0x6d, 0xb5, 0x27, 0x0, 0xb, 0xd3, 0x44, 0x79, 0x3d, 0x74, 0xc5, 0xeb, 0x1a, 0x26, 0xda, 0x71, 0xd0, 0x42, 0xd8, 0x5, 0xc6, 0x36, 0x8b, 0xe0, 0x40, 0xc1, 0x58, 0x52, 0xe2, 0x60, 0x60, 0x20, 0xde, 0xfa, 0x9a, 0x9b, 0xd0, 0xc3, 0x61, 0xc6, 0x78, 0x83, 0x9e, 0x3d, 0x97, 0x8f, 0x49, 0xf, 0x7f, 0x96, 0xb1, 0xea, 0x5c, 0x6, 0x86, 0x53, 0x16, 0x32, 0xd, 0x7c, 0x2e, 0x6d, 0x3c, 0x8c, 0x85, 0x52, 0x7c, 0xc5, 0x75, 0xbf, 0x3c, 0x19, 0xa, 0xdc, 0x7c, 0x1d, 0x95, 0x8a, 0xe3, 0x2c, 0x4f, 0x5b, 0x17, 0x89, 0x1a, 0xfb, 0xb6, 0xef, 0x18, 0xfb, 0x4a, 0xbc, 0xbf, 0x72, 0x69, 0xff, 0xe5, 0xf1, 0x90, 0xc7, 0x44, 0x68, 0xd9, 0xd, 0xa2, 0xab, 0x78, 0x5f, 0x2b, 0x1f, 0x2f, 0x5f, 0x2b, 0xc, 0x59, 0xf3, 0x79, 0x83, 0xd, 0xb0, 0x99, 0xdd, 0xeb, 0xbe, 0x35, 0xa3, 0x9e, 0x4d, 0xa3, 0xe0, 0xe4, 0xf4, 0x1b, 0x26, 0xe1, 0x12, 0x71, 0x58, 0x3b, 0x78, 0x74, 0x1c, 0x66, 0x3d, 0x5f, 0xef, 0xae, 0x5a, 0xdc, 0x43, 0xde, 0x6b, 0x81, 0x84, 0x1b, 0x4, 0xba, 0x5, 0xc2, 0xdd, 0xa4, 0xe5, 0x51, 0x63, 0xb7, 0x35, 0xb9, 0xb0, 0x26, 0xc5, 0xea, 0xa5, 0x32, 0x1, 0xdd, 0x81, 0x3d, 0xc6, 0x2d, 0xb1, 0xf3, 0x3e, 0x12, 0x9f, 0x8d, 0x35, 0xd, 0xd4, 0x42, 0x8, 0xf2, 0xe, 0xc4, 0x62, 0x22, 0x28, 0xeb, 0xbe, 0x81, 0x55, 0xae, 0xf3, 0xd0, 0x46, 0x47, 0x98, 0xc3, 0x4c, 0x4a, 0xa1, 0x39, 0x10, 0x15, 0xb9, 0xb0, 0x86, 0x2, 0x7f, 0x48, 0xb4, 0xac, 0x6e, 0x97, 0x8e, 0x87, 0x79, 0x79, 0x27, 0x4e, 0x49, 0xc3, 0xf4, 0x6e, 0x27, 0x2a, 0xd5, 0xc3, 0xc9, 0x9c, 0xa3, 0x68, 0x9d, 0x37, 0xc7, 0xa8, 0x78, 0x6f, 0x14, 0x38, 0x10, 0xb6, 0xf3, 0xc6, 0x41, 0x16, 0x23, 0x6b, 0xaf, 0xfb, 0xce, 0x1a, 0xdb, 0xef, 0x37, 0x40, 0x91, 0x75, 0xa1, 0x5b, 0xf8, 0xb5, 0x7b, 0x2c, 0xa8, 0xb, 0xa2, 0xec, 0x7f, 0xc9, 0x50, 0xb6, 0x4a, 0x2d, 0x49, 0x44, 0x46, 0x18, 0xa, 0xbe, 0x1b, 0x75, 0xa1, 0x80, 0x95, 0x6c, 0xba, 0xc9, 0x96, 0xe9, 0xf, 0x32, 0x5c, 0x55, 0xb3, 0xcc, 0xb5, 0x74, 0xc3, 0x3c, 0x3b, 0xd7, 0xce, 0xce, 0x55, 0x74, 0x29, 0xdf, 0x41, 0x54, 0x8e, 0xb9, 0x78, 0x49, 0x39, 0x1c, 0x2b, 0x96, 0x9e, 0xfc, 0x76, 0xc7, 0x59, 0xaf, 0x17, 0x98, 0x2d, 0x88, 0xbb, 0xd3, 0xc7, 0x8a, 0x52, 0x9a, 0x3e, 0x9a, 0xca, 0xf, 0x53, 0xe4, 0x5d, 0x64, 0x79, 0x2f, 0x3b, 0x6c, 0x74, 0x30, 0xa8, 0x8a, 0xcf, 0xb2, 0x2b, 0x9e, 0x52, 0xf4, 0x11, 0x89, 0x8e, 0x45, 0xc3, 0x86, 0x40, 0x25, 0x55, 0x44, 0xf2, 0x6e, 0xbd, 0xd4, 0x31, 0xb8, 0x26, 0xdd, 0xa8, 0x5f, 0xe, 0x2e, 0x8, 0xf1, 0x55, 0x83, 0x34, 0xfd, 0x5e, 0x44, 0xe9, 0x6a, 0x59, 0x3f, 0x5d, 0x99, 0x73, 0x50, 0x5a, 0x59, 0x1a, 0x74, 0xf9, 0x18, 0x40, 0xaf, 0xea, 0xf5, 0x98, 0xb9, 0xa2, 0xc2, 0x24, 0xa3, 0xd9, 0x58, 0xa3, 0x2d, 0x11, 0x30, 0xa6, 0xdd, 0x56, 0xbf, 0x6f, 0xb5, 0x5, 0x7f, 0x5a, 0x4d, 0x90, 0xe4, 0x2f, 0x74, 0x79, 0xe6, 0xc4, 0x27, 0x16, 0x7c, 0x84, 0x43, 0xad, 0x34, 0xe8, 0x2a, 0x2a, 0x29, 0x4c, 0xb, 0x3d, 0xf7, 0x1f, 0x84, 0x2d, 0x6c, 0x58, 0xf7, 0x29, 0xa9, 0xc9, 0xca, 0x4, 0x65, 0xd5, 0x49, 0xdf, 0xca, 0x1b, 0x4b, 0x3, 0x81, 0xc8, 0x2e, 0xd3, 0x68, 0x8f, 0x0, 0x4b, 0x72, 0x73, 0xd2, 0xa1, 0xff, 0x7, 0x12, 0x3a, 0x55, 0x8c, 0xe3, 0x81, 0x9, 0xa1, 0x6a, 0xc5, 0x74, 0x59, 0xb1, 0xcc, 0xcf, 0x8a, 0x4a, 0x3e, 0x89, 0x3d, 0xce, 0x4e, 0x77, 0x77, 0x17, 0xdc, 0x31, 0x1e, 0x26, 0x97, 0xca, 0x80, 0x2f, 0xf6, 0x4e, 0xc3, 0x3b, 0x69, 0x56, 0x97, 0x10, 0xd9, 0x39, 0xe4, 0x2d, 0xeb, 0xc8, 0x6a, 0x1b, 0x36, 0x59, 0xbc, 0xd0, 0x4c, 0xb3, 0x41, 0x68, 0x84, 0xb1, 0x83, 0x15, 0x92, 0x30, 0x87, 0xc6, 0x1d, 0xb5, 0xa1, 0xf0, 0x9d, 0xa5, 0x2d, 0x70, 0x55, 0xdc, 0x9c, 0x6a, 0x61, 0xac, 0xe8, 0xf0, 0x15, 0x61, 0x1e, 0x89, 0xd8, 0x9e, 0x9, 0x43, 0x3b, 0x60, 0x17, 0x24, 0x3a, 0xb7, 0x72, 0xbf, 0x4, 0xaa, 0x17, 0x69, 0xf9, 0xd5, 0x58, 0xa0, 0xde, 0x68, 0x38, 0x41, 0x5e, 0xc1, 0x91, 0xce, 0x8c, 0x51, 0xa8, 0x65, 0x89, 0x64, 0xaa, 0xa5, 0x13, 0xce, 0x59, 0xb1, 0x83, 0xc7, 0x93, 0xd3, 0x90, 0xa8, 0xe3, 0xca, 0x40, 0x1d, 0x85, 0x46, 0x6c, 0x56, 0x7c, 0x88, 0xc6, 0x8e, 0xf9, 0xa, 0x39, 0x1b, 0x49, 0x40, 0x32, 0xfb, 0x9f, 0xb4, 0x1a, 0x3c, 0x8d, 0xc5, 0x73, 0x79, 0x8e, 0x71, 0x4b, 0xfb, 0x9b, 0x46, 0x61, 0x47, 0xc1, 0x93, 0xe8, 0xbf, 0x87, 0xce, 0x8c, 0xd3, 0xe1, 0x38, 0x90, 0x11, 0x43, 0x50, 0x95, 0xf9, 0xdc, 0x77, 0x94, 0x41, 0x82, 0x19, 0xe5, 0x87, 0x1c, 0xce, 0x5d, 0x7e, 0x8, 0x92, 0x50, 0x93, 0xd5, 0x6a, 0xaf, 0xfe, 0x9f, 0xb5, 0x7e, 0xa0, 0xb5, 0x5b, 0xad, 0xda, 0x1, 0xeb, 0xda, 0x75, 0x27, 0xed, 0xb2, 0x87, 0xa6, 0xf0, 0xa4, 0xb9, 0xfe, 0xf9, 0x61, 0x31, 0x76, 0xce, 0x54, 0xd, 0xaa, 0xc6, 0x2d, 0x5a, 0x57, 0xdb, 0x31, 0xef, 0xc3, 0xa2, 0xf7, 0xb1, 0xbc, 0xf0, 0x6f, 0x75, 0x33, 0xdc, 0x3d, 0x6e, 0xb, 0x9b, 0x39, 0x96, 0xc1, 0x28, 0x63, 0x9c, 0x56, 0x81, 0x8, 0xc2, 0x84, 0x98, 0x54, 0xc8, 0x7a, 0x8, 0x12, 0x6c, 0x97, 0x5a, 0xad, 0x46, 0x30, 0x7d, 0x6b, 0x5a, 0x66, 0x73, 0x5d, 0xbc, 0xb8, 0xd1, 0xbc, 0x1f, 0x1c, 0x69, 0x3a, 0x29, 0x1a, 0xba, 0x88, 0xaf, 0x2, 0xfb, 0x7d, 0x53, 0xb5, 0x60, 0xd9, 0xa1, 0xba, 0x7e, 0x81, 0xc2, 0x16, 0x96, 0x71, 0x74, 0xe4, 0x3b, 0x37, 0xc1, 0xe0, 0x90, 0xfb, 0x1d, 0x30, 0xd2, 0xeb, 0x58, 0xd8, 0x0, 0x2d, 0x99, 0xb2, 0x23, 0x15, 0x6, 0xc9, 0x6f, 0x11, 0x3a, 0x5f, 0x3d, 0xf5, 0xc, 0x42, 0xc9, 0x5f, 0xd6, 0x59, 0x8a, 0xcc, 0x10, 0xc6, 0x3f, 0x19, 0x5, 0x18, 0xe1, 0xad, 0x8c, 0xf8, 0xa1, 0xab, 0x6d, 0xec, 0x72, 0xdc, 0x78, 0x2b, 0xda, 0x6c, 0x0, 0xc0, 0xa6, 0xec, 0x45, 0x4, 0xa9, 0x86, 0xa1, 0x6, 0x5a, 0x8b, 0x3a, 0x6e, 0xe, 0xd5, 0x95, 0xb7, 0x7d, 0xdf, 0x2a, 0x49, 0xef, 0x9d, 0x3a, 0x69, 0x7f, 0x27, 0x1d, 0x9, 0x8e, 0x6a, 0x76, 0x8, 0x56, 0xc2, 0x18, 0x8c, 0x7b, 0x52, 0x12, 0x37, 0x69, 0x2e, 0xc6, 0xdf, 0xcd, 0x5c, 0xdb, 0x9c, 0x7a, 0xee, 0x9b, 0xfc, 0x4c, 0xcd, 0xa5, 0x1b, 0x8e, 0x66, 0x4d, 0xd8, 0x28, 0xd8, 0xc2, 0x1c, 0x54, 0x1c, 0xb0, 0x65, 0xa4, 0x39, 0xa7, 0xcf, 0x8b, 0x75, 0xf6, 0x16, 0x1a, 0x8e, 0x97, 0xb4, 0xa8, 0x63, 0x4b, 0x7a, 0x11, 0xda, 0x99, 0x6e, 0xf1, 0xc5, 0x66, 0xbf, 0x50, 0xf7, 0xac, 0x45, 0x81, 0x9c, 0xf1, 0x3e, 0x20, 0x75, 0xe8, 0xc, 0xe3, 0x5b, 0x17, 0xb7, 0xb7, 0xf8, 0x72, 0xd2, 0x12, 0x2d, 0x36, 0xd9, 0x12, 0xb, 0x9a, 0x7a, 0xb0, 0xe2, 0x74, 0x88, 0xa6, 0xb4, 0xd, 0xb5, 0xf9, 0x5c, 0x6e, 0xb4, 0x52, 0x9c, 0xb7, 0x94, 0xee, 0xaa, 0x0, 0xad, 0x14, 0x59, 0xd2, 0x36, 0x5a, 0x58, 0xee, 0xaa, 0xbd, 0xd4, 0x35, 0xd9, 0xa2, 0x17, 0x99, 0x31, 0x9f, 0xcc, 0x86, 0x68, 0xb4, 0xbe, 0xa1, 0xb5, 0x5f, 0x34, 0x15, 0x6c, 0x82, 0xcc, 0x2e, 0xcc, 0x7b, 0x3f, 0x5b, 0x20, 0xc, 0xd8, 0x7b, 0xe, 0xac, 0x4b, 0x5b, 0x8, 0x6c, 0x9b, 0x35, 0xc, 0xbe, 0xab, 0x77, 0x75, 0x1d, 0x9d, 0x5b, 0x24, 0xbf, 0x21, 0xdd, 0x19, 0x8a, 0xd, 0x83, 0xec, 0xf1, 0xa0, 0x27, 0xf, 0xb3, 0xb1, 0x1c, 0x79, 0xbb, 0x58, 0xc7, 0xf9, 0x1e, 0x3c, 0x8, 0x81, 0x70, 0x3a, 0x9a, 0x28, 0x22, 0x37, 0x6, 0x8a, 0x6b, 0xa8, 0xfc, 0x7, 0x5f, 0x63, 0x84, 0x54, 0x9, 0x93, 0x8, 0x41, 0xfc, 0xf6, 0x36, 0x6, 0x8, 0x8a, 0x9, 0x82, 0xe2, 0x26, 0x4, 0xf1, 0x7f, 0x33, 0x4, 0xc5, 0x26, 0x90, 0xe4, 0x36, 0xab, 0x6c, 0xec, 0x54, 0xde, 0x64, 0xb1, 0xfb, 0x1f, 0xff, 0xb, 0xe1, 0xe6, 0xce, 0x71, 0xa9, 0x9c, 0xde, 0x83, 0xee, 0x51, 0x61, 0x6, 0xd9, 0x9f, 0x20, 0x56, 0x40, 0x3b, 0xa, 0xb2, 0xab, 0x2d, 0x59, 0x31, 0xb1, 0x9b, 0x18, 0x49, 0x26, 0x4f, 0x27, 0xfc, 0x19, 0x6b, 0xac, 0x71, 0xb7, 0xb9, 0xdf, 0x1f, 0x1d, 0x76, 0x72, 0x34, 0x4d, 0x84, 0x67, 0x22, 0xa4, 0x62, 0xa2, 0x14, 0xc6, 0x5d, 0x3a, 0x5b, 0x28, 0x21, 0xb1, 0x53, 0xe8, 0xe1, 0x8b, 0xc3, 0xb6, 0x76, 0x62, 0xc8, 0x86, 0x34, 0xa, 0x61, 0x9, 0xa3, 0xf, 0x87, 0xba, 0xb6, 0xc4, 0x38, 0x76, 0xcb, 0xf7, 0x90, 0xaf, 0xd1, 0x93, 0x26, 0xba, 0xf0, 0xcf, 0x5a, 0xb2, 0x14, 0xe1, 0x86, 0xf3, 0x80, 0x35, 0x69, 0xbb, 0x43, 0x44, 0x2b, 0x89, 0x97, 0xea, 0x37, 0x35, 0xa8, 0x3d, 0x79, 0x79, 0x96, 0xbc, 0x4e, 0xd7, 0xc5, 0x4a, 0x12, 0x91, 0x1f, 0xe4, 0xb, 0xd9, 0xa2, 0x8e, 0x41, 0xee, 0x1f, 0xd3, 0xa2, 0x48, 0xfb, 0xdc, 0xbb, 0x59, 0xc, 0xc5, 0x60, 0xc4, 0x57, 0x35, 0xf3, 0xa0, 0xa3, 0xc, 0xd4, 0x49, 0x87, 0x59, 0x9b, 0xa4, 0xca, 0x99, 0xe3, 0x9a, 0x3f, 0x5c, 0x27, 0x93, 0x7f, 0xea, 0x4, 0xe5, 0x37, 0xaf, 0x68, 0x6b, 0x9e, 0x1b, 0x4e, 0x57, 0xb6, 0x40, 0xf6, 0x3f, 0x51, 0xc3, 0x41, 0x3a, 0x5a, 0xc, 0xc6, 0xb2, 0xb9, 0x98, 0xf1, 0x35, 0xb7, 0x2, 0x13, 0x68, 0xb6, 0x52, 0x9b, 0xb2, 0x1c, 0x35, 0x59, 0xab, 0x2d, 0x33, 0x97, 0x25, 0x74, 0x9a, 0xec, 0x97, 0xc2, 0x68, 0x9f, 0x2d, 0xd8, 0x92, 0xad, 0x59, 0xc2, 0x36, 0x2c, 0x6d, 0x0, 0x2b, 0x6c, 0x8b, 0xe0, 0x7b, 0xf1, 0xa0, 0xd2, 0x1c, 0x3f, 0xd3, 0xa, 0x2, 0x66, 0xde, 0xec, 0xe2, 0xb3, 0xce, 0xc6, 0x5, 0x3d, 0x9b, 0xc3, 0x5a, 0xd5, 0x42, 0xbd, 0x12, 0x59, 0xe5, 0x45, 0x44, 0xbb, 0x35, 0xe6, 0x4a, 0xaf, 0xaf, 0x24, 0xec, 0xc, 0x75, 0x2f, 0x21, 0xf6, 0xa3, 0x39, 0x71, 0xb1, 0x29, 0x91, 0x52, 0xaf, 0x11, 0x8a, 0xd1, 0xc6, 0xbd, 0x19, 0xbe, 0xea, 0xd4, 0x21, 0x26, 0xef, 0xdc, 0x36, 0x43, 0xff, 0x79, 0x96, 0x9d, 0xc3, 0xf6, 0xc8, 0x8b, 0xdd, 0x7, 0xc, 0x5, 0xbd, 0xec, 0xf6, 0x36, 0x53, 0xf2, 0x9e, 0x31, 0x94, 0xa3, 0x63, 0xc, 0x7c, 0x42, 0x82, 0xd0, 0xe0, 0xaa, 0x57, 0x9e, 0xae, 0x80, 0x16, 0xc0, 0x2a, 0xe1, 0x37, 0x50, 0x4b, 0xba, 0xcc, 0xbb, 0xea, 0x97, 0x27, 0x73, 0x48, 0x9e, 0x47, 0xf4, 0xd, 0x94, 0x2e, 0xb, 0x82, 0xb0, 0x3d, 0x2b, 0x54, 0xf4, 0xe3, 0xcd, 0xaf, 0xd1, 0x6, 0xa7, 0x36, 0x42, 0xa9, 0xeb, 0xb0, 0xca, 0x22, 0x11, 0xbc, 0xea, 0x73, 0xa3, 0x65, 0x4e, 0x2d, 0x8f, 0x97, 0xd1, 0x9c, 0xad, 0x8d, 0x90, 0x84, 0x2b, 0xe3, 0xda, 0x5e, 0x93, 0x5f, 0x58, 0xb5, 0x2f, 0x30, 0xe2, 0x30, 0x19, 0x96, 0xf8, 0x39, 0x46, 0x47, 0x74, 0xa4, 0xc7, 0x18, 0x22, 0x76, 0x7d, 0xa4, 0x5, 0xb2, 0xa2, 0x57, 0x7, 0x80, 0x62, 0x9b, 0x68, 0x59, 0xe7, 0x2c, 0xcc, 0x9c, 0x24, 0x9a, 0xf9, 0x49, 0x30, 0x49, 0xc2, 0x21, 0x14, 0x9a, 0xf9, 0x9b, 0x60, 0xb2, 0x51, 0x6a, 0x2a, 0x13, 0x4b, 0xa4, 0x7d, 0x7f, 0xd3, 0x4b, 0x2, 0x25, 0x43, 0x2, 0x2c, 0xb, 0xc, 0x26, 0x2c, 0x9e, 0x36, 0xf8, 0xc2, 0x6, 0xb3, 0x13, 0xbb, 0xcd, 0xd5, 0x84, 0xe8, 0x22, 0xd, 0xce, 0x8c, 0x4e, 0x50, 0x3, 0xd2, 0x6b, 0x26, 0x4a, 0x41, 0x54, 0x34, 0x1c, 0x81, 0x1c, 0xc1, 0xf5, 0x20, 0xae, 0x65, 0xa2, 0x75, 0x3e, 0xe8, 0x98, 0xd6, 0xcb, 0xe2, 0xc0, 0xad, 0xdd, 0x67, 0x54, 0xcb, 0x30, 0x87, 0x59, 0x5f, 0x2f, 0x11, 0x35, 0x68, 0x41, 0x6d, 0xf7, 0xcc, 0xec, 0x1d, 0xa9, 0x82, 0xda, 0xe2, 0x49, 0xeb, 0x7, 0xb8, 0xb6, 0x43, 0x94, 0x73, 0x52, 0xd6, 0xeb, 0xb8, 0x33, 0x75, 0xa6, 0x9c, 0xdb, 0xf6, 0xdd, 0xad, 0xef, 0x30, 0x18, 0x64, 0x87, 0xe4, 0xa1, 0xe2, 0xd3, 0x2, 0xf, 0x26, 0x39, 0x49, 0xb4, 0x4d, 0x3b, 0xf4, 0x5b, 0xd4, 0xa6, 0x46, 0xa9, 0x1a, 0x8, 0xe5, 0x80, 0xa4, 0x8d, 0x81, 0xc5, 0xe2, 0x48, 0x67, 0xaa, 0xdd, 0x7c, 0x4e, 0x37, 0x7f, 0x64, 0x50, 0xa7, 0xa0, 0xdb, 0x74, 0x50, 0x2e, 0x96, 0x39, 0x16, 0xc0, 0x96, 0xf7, 0x30, 0x1e, 0xf4, 0xe5, 0xf5, 0x93, 0xd5, 0xb4, 0xa1, 0x60, 0x1a, 0x8e, 0xe3, 0x36, 0xce, 0x8a, 0x1, 0x67, 0x95, 0x1d, 0x38, 0x2b, 0x6e, 0xa8, 0x1e, 0x4d, 0x52, 0x5e, 0x53, 0x13, 0xde, 0xa4, 0x26, 0x1, 0x61, 0xa6, 0x78, 0xa2, 0x99, 0x3c, 0xbc, 0x1, 0x43, 0x2b, 0xa8, 0xb0, 0xb6, 0x1b, 0x92, 0x29, 0xe3, 0xae, 0x99, 0x6c, 0xd5, 0xda, 0xd7, 0xa2, 0x9c, 0x0, 0x88, 0x5f, 0x71, 0x2d, 0xad, 0x9b, 0x7a, 0x24, 0x29, 0xbb, 0x7a, 0x23, 0xa9, 0xc3, 0x5, 0xbe, 0x25, 0x2, 0x2b, 0x8e, 0xc0, 0xbc, 0x63, 0x32, 0xae, 0x59, 0x24, 0xdc, 0x2c, 0x14, 0xe9, 0x6a, 0x30, 0x10, 0xdf, 0xb3, 0xa2, 0x79, 0xc5, 0xe2, 0x2c, 0xf7, 0x3, 0xd3, 0x56, 0x3b, 0xad, 0x16, 0x9c, 0xb6, 0x3b, 0x2d, 0x46, 0x65, 0xfb, 0x1e, 0x96, 0x4, 0xe6, 0x6d, 0x62, 0xed, 0x38, 0xd4, 0xbe, 0x46, 0x93, 0x0, 0x59, 0x50, 0x70, 0x5d, 0x21, 0xc6, 0xed, 0x5b, 0x80, 0x7d, 0xd3, 0x3a, 0x1, 0x64, 0x76, 0xb7, 0x53, 0xe6, 0xd1, 0x25, 0xa8, 0x5b, 0xd, 0xb2, 0x59, 0x8b, 0xae, 0xf5, 0x47, 0xe3, 0xc, 0x43, 0xaa, 0x67, 0x18, 0x52, 0x5d, 0x3b, 0x51, 0x5a, 0xed, 0xab, 0x13, 0xcf, 0x3b, 0x9, 0xf1, 0x9d, 0x40, 0x1d, 0x5f, 0xe1, 0x35, 0xcf, 0x2e, 0xb3, 0x18, 0xc7, 0x19, 0x35, 0x85, 0x5f, 0x80, 0x6e, 0x8e, 0x56, 0x7f, 0x9d, 0x2, 0xb0, 0x21, 0xdc, 0xbe, 0xe7, 0x0, 0x41, 0x1e, 0x6a, 0x98, 0x9d, 0xfd, 0x46, 0xbc, 0x4d, 0xb, 0x1c, 0xec, 0x62, 0x62, 0x87, 0xc, 0xcb, 0x2c, 0xcb, 0xe0, 0x42, 0xc9, 0xcb, 0x56, 0x22, 0x50, 0xb1, 0x45, 0x14, 0xc3, 0xbf, 0xcb, 0x68, 0x71, 0x8a, 0xc, 0xcb, 0x69, 0xd1, 0x47, 0xff, 0x52, 0x64, 0x5c, 0x16, 0x82, 0x7f, 0x81, 0x4, 0x4b, 0xcb, 0x43, 0xac, 0xcd, 0x44, 0x81, 0x6e, 0x98, 0x11, 0x3e, 0xd1, 0x3f, 0xe3, 0x53, 0xc8, 0x13, 0x66, 0x3e, 0x1d, 0xea, 0xa0, 0x75, 0x2d, 0x72, 0x2d, 0x27, 0xde, 0xb4, 0xa8, 0xaa, 0xe2, 0xc2, 0x21, 0x7d, 0xd9, 0xbc, 0x15, 0x53, 0x58, 0x9, 0x1f, 0x7e, 0x23, 0xbf, 0x4e, 0x15, 0x74, 0x47, 0x86, 0x6, 0x61, 0x9e, 0x88, 0x50, 0xe0, 0xb1, 0x26, 0x53, 0xeb, 0x8, 0x41, 0x6f, 0x7, 0x69, 0x42, 0xb5, 0xb8, 0xfb, 0x2d, 0x56, 0xa0, 0x85, 0xb5, 0x8b, 0xb4, 0xed, 0xef, 0xa0, 0x9d, 0x85, 0xac, 0x38, 0xf, 0x2a, 0xc8, 0x3, 0x7e, 0xa0, 0xa3, 0x3f, 0x1a, 0xe0, 0xa2, 0x1b, 0xe7, 0x3, 0x11, 0x2, 0xa, 0xd8, 0xe1, 0x89, 0xf0, 0xa0, 0xf6, 0xdb, 0x5c, 0x3b, 0xdf, 0x6, 0x21, 0xc6, 0x1a, 0x6, 0xa4, 0x55, 0xbb, 0x57, 0x5f, 0x14, 0xe9, 0x6, 0x2d, 0xb4, 0xc5, 0x5f, 0x7c, 0x17, 0xad, 0x58, 0x93, 0x87, 0xb5, 0x9d, 0x10, 0xd1, 0x5, 0x34, 0xbd, 0x69, 0x15, 0x61, 0xc4, 0xff, 0xbc, 0x78, 0x5c, 0xe4, 0xb3, 0x65, 0x96, 0xb8, 0x5e, 0x79, 0x55, 0x5, 0x81, 0x10, 0xc3, 0x52, 0x1a, 0x3e, 0xf8, 0xec, 0x1d, 0xdf, 0xce, 0xca, 0xd4, 0x73, 0x27, 0xc0, 0x33, 0xdd, 0xb4, 0xdf, 0x27, 0x1a, 0xd6, 0x6f, 0x1e, 0x69, 0x2d, 0x8f, 0x4e, 0xfd, 0x8b, 0xa9, 0x4a, 0xb1, 0x9f, 0x4f, 0x1a, 0x3e, 0x50, 0xef, 0x27, 0xfd, 0xc5, 0x54, 0xc8, 0x98, 0x6f, 0x28, 0x35, 0xb4, 0x90, 0x56, 0x5f, 0x96, 0x2e, 0x8, 0x73, 0xa6, 0xf1, 0xfa, 0xb9, 0x36, 0x78, 0x55, 0x9, 0xb5, 0x8d, 0x6d, 0x78, 0x8c, 0x9, 0x44, 0x1e, 0x9f, 0xaf, 0xe2, 0x4, 0x3d, 0xf1, 0x1e, 0x60, 0xca, 0xa7, 0xc2, 0x29, 0x59, 0xa5, 0x8d, 0x98, 0x1d, 0x6a, 0x20, 0xfc, 0xe8, 0x64, 0xb3, 0xdc, 0x4b, 0x96, 0x71, 0x59, 0x46, 0xf8, 0xf8, 0x4c, 0xde, 0x7a, 0xc2, 0xf3, 0xc3, 0xd3, 0xbe, 0xa8, 0xe2, 0x9d, 0x9e, 0x7c, 0x48, 0x9e, 0x40, 0x12, 0x73, 0xe, 0xc7, 0x7b, 0xd9, 0x49, 0xc3, 0x79, 0x1b, 0x92, 0xf0, 0xd1, 0x8b, 0xf, 0x4f, 0x4f, 0x96, 0xd9, 0xe9, 0x49, 0xb9, 0x8a, 0xf3, 0x3d, 0x72, 0xe3, 0x8f, 0xbc, 0xa9, 0x36, 0x64, 0xe8, 0x27, 0xb4, 0x58, 0xd0, 0x99, 0xf6, 0xd4, 0xce, 0xce, 0x6b, 0x3, 0x93, 0xf, 0x4f, 0xa1, 0xa3, 0x23, 0xac, 0x7a, 0x8a, 0xf, 0xea, 0xf8, 0x66, 0x21, 0xf3, 0x6d, 0x9d, 0x56, 0x3a, 0xa6, 0xe2, 0x2b, 0x3b, 0x47, 0xd8, 0xb5, 0xf8, 0xda, 0x2c, 0x4f, 0x3f, 0xda, 0x8e, 0x33, 0xd3, 0xdf, 0x4b, 0x3e, 0x8e, 0xea, 0x3d, 0x8a, 0x81, 0x60, 0x29, 0xe7, 0xa8, 0x10, 0x20, 0xc2, 0xa1, 0xe8, 0xa8, 0x2c, 0x1d, 0xa1, 0x3c, 0x2a, 0x82, 0x89, 0x26, 0xe9, 0xf3, 0x31, 0x2d, 0x5b, 0x26, 0x7e, 0xe8, 0xf6, 0x1b, 0x1a, 0x41, 0x7a, 0x28, 0x4a, 0x61, 0x5a, 0xe8, 0xf5, 0xfb, 0xd0, 0xf5, 0x92, 0x4e, 0x53, 0xc1, 0x88, 0x78, 0x86, 0xf6, 0xd5, 0xd7, 0x5c, 0xa3, 0xa5, 0xa3, 0xec, 0xe7, 0xb5, 0xb1, 0xaa, 0xd9, 0xba, 0xa8, 0xa3, 0xb9, 0xe5, 0xbd, 0xa2, 0x17, 0x3, 0x1b, 0x9c, 0x1d, 0x22, 0xd, 0x6f, 0xc0, 0x42, 0x2f, 0xb6, 0xb4, 0x28, 0xba, 0xc7, 0x4e, 0xef, 0xbf, 0x3b, 0x6e, 0xb, 0xfb, 0xc7, 0xa2, 0x17, 0x13, 0x6, 0xad, 0xf6, 0xd7, 0x8d, 0xe6, 0x1b, 0xde, 0x7, 0x8e, 0xa9, 0xf7, 0x29, 0xb6, 0xac, 0x6b, 0xf0, 0xda, 0xc7, 0xec, 0xa8, 0x42, 0x44, 0x6a, 0xf9, 0xdf, 0xa3, 0x8f, 0xbe, 0xe5, 0x9, 0x69, 0xbe, 0xdb, 0x85, 0xfe, 0x1e, 0x75, 0xf0, 0x2d, 0xc3, 0xa3, 0xab, 0xe1, 0x6e, 0x29, 0xf2, 0x1d, 0x5e, 0xb5, 0xf5, 0x73, 0x5d, 0x18, 0xa5, 0x81, 0x7c, 0xf4, 0x26, 0x8a, 0xcc, 0xc2, 0x1c, 0xcb, 0x87, 0x95, 0x40, 0xe8, 0x55, 0x10, 0x9e, 0x9d, 0x8f, 0xf5, 0xf3, 0x86, 0x98, 0xe5, 0xdb, 0xb8, 0x57, 0x29, 0xe4, 0xce, 0x3c, 0xd, 0xfc, 0x1e, 0xf3, 0xc, 0xa3, 0x7a, 0x8f, 0x9c, 0xff, 0xb9, 0xb0, 0x52, 0xca, 0x1a, 0x98, 0x5b, 0xd7, 0x81, 0x41, 0x2c, 0x80, 0x44, 0x2d, 0x91, 0x4c, 0x7d, 0x26, 0xac, 0x73, 0x8c, 0x36, 0xcc, 0x5c, 0x81, 0x2e, 0xb6, 0x6, 0xb3, 0xaa, 0x1c, 0x81, 0x29, 0x3e, 0x39, 0xa5, 0xc2, 0x38, 0x15, 0x58, 0x6b, 0x87, 0x6, 0xd, 0xda, 0x86, 0x4d, 0xbf, 0xed, 0x6b, 0x6a, 0xe3, 0x22, 0x56, 0x5b, 0xe6, 0xb7, 0x8b, 0xe9, 0x2c, 0x87, 0xe7, 0x73, 0x3d, 0xdb, 0xca, 0x1d, 0x4d, 0x41, 0xc6, 0x56, 0xa7, 0xf3, 0x1e, 0x66, 0xe2, 0xdc, 0xcb, 0x27, 0xd9, 0x6b, 0xd7, 0xe2, 0xac, 0x15, 0xa7, 0x40, 0xa5, 0x9b, 0xe, 0xb, 0x18, 0x8a, 0x1, 0x76, 0x68, 0x3b, 0xb6, 0x83, 0x50, 0x88, 0xd8, 0x9, 0xf5, 0xaa, 0x8b, 0xb7, 0x3d, 0x8d, 0xf7, 0x97, 0x72, 0xbc, 0x56, 0xc3, 0xca, 0xa2, 0x28, 0x7a, 0x51, 0x5a, 0xb, 0xe7, 0xab, 0xb0, 0xeb, 0xc2, 0xa1, 0x1c, 0x25, 0x12, 0x41, 0xfe, 0xf3, 0x73, 0x26, 0x7b, 0xf9, 0xd2, 0x1c, 0xfe, 0x8e, 0x21, 0xba, 0xa7, 0x64, 0x6d, 0x36, 0xe4, 0x58, 0xbf, 0xd1, 0x4f, 0xd5, 0x51, 0x54, 0x6e, 0x46, 0xd6, 0x84, 0x5, 0x8a, 0x45, 0x61, 0xc6, 0x6a, 0xd0, 0x66, 0x57, 0x86, 0x3f, 0x9f, 0x50, 0x38, 0xca, 0x57, 0xe, 0x95, 0x39, 0xa9, 0xd, 0x2d, 0x86, 0x7b, 0x2b, 0xba, 0x3c, 0x48, 0x3d, 0xa2, 0x40, 0x8b, 0x52, 0x15, 0xce, 0xba, 0x8e, 0x82, 0x8, 0x56, 0xa5, 0x81, 0xac, 0x62, 0x37, 0x86, 0x71, 0xa7, 0x68, 0xc3, 0x81, 0xe1, 0x1c, 0x91, 0x43, 0x2, 0x76, 0xd5, 0x55, 0xe9, 0x7b, 0x67, 0x5, 0x6, 0x68, 0x3f, 0x50, 0xbe, 0x52, 0xf6, 0x68, 0xb7, 0xb5, 0xca, 0xdf, 0x5a, 0xa, 0xc1, 0x10, 0xf9, 0x41, 0xa7, 0x6e, 0x58, 0x34, 0x23, 0x32, 0xfd, 0x1a, 0x9c, 0xdb, 0xa1, 0x58, 0xd8, 0x7b, 0x21, 0x83, 0x5d, 0xf8, 0x44, 0xe, 0xb7, 0x35, 0x52, 0x55, 0xdc, 0xc2, 0xbc, 0x7c, 0x77, 0xe0, 0x12, 0xb9, 0x25, 0xe2, 0x8, 0x20, 0xb4, 0x33, 0xb1, 0x81, 0xac, 0xac, 0x21, 0xc4, 0x46, 0x78, 0x56, 0xeb, 0x5a, 0xbe, 0x62, 0x84, 0x8d, 0xd1, 0x6b, 0xcf, 0x11, 0x87, 0x13, 0x99, 0x56, 0x3b, 0x8e, 0x8e, 0xb2, 0x41, 0xa3, 0x2e, 0x29, 0x5e, 0x22, 0x33, 0xb4, 0xa, 0x4d, 0x66, 0x3, 0x35, 0xb, 0xd8, 0x93, 0xa1, 0x2c, 0xd5, 0x5c, 0x41, 0x2c, 0x62, 0xc2, 0xa8, 0xa2, 0x99, 0x7c, 0x44, 0xcc, 0x55, 0x6, 0x39, 0x8, 0xe9, 0x8, 0xe4, 0xe7, 0xc0, 0xa0, 0xe7, 0xc0, 0xa0, 0xeb, 0xf7, 0x84, 0x5c, 0xcb, 0x54, 0x0, 0xe7, 0xae, 0x3, 0xc0, 0x48, 0xfd, 0xbb, 0x78, 0x9c, 0xf3, 0x3e, 0x6e, 0xed, 0x82, 0xd, 0xad, 0x43, 0xc8, 0x64, 0x8e, 0xfd, 0xa4, 0xa8, 0x93, 0xb4, 0x14, 0x99, 0x72, 0x7a, 0xa5, 0x47, 0xdd, 0xf2, 0xe8, 0xc6, 0xd6, 0xe1, 0xda, 0xf8, 0xb5, 0x7e, 0x8a, 0x53, 0x39, 0x41, 0xb5, 0x83, 0x3a, 0x19, 0x87, 0xcb, 0xc, 0x3, 0xe5, 0x8, 0x43, 0xd1, 0x11, 0x84, 0xc1, 0x7e, 0x40, 0xb3, 0x23, 0x60, 0x82, 0xf5, 0x1c, 0x67, 0x57, 0xf0, 0x5, 0xfb, 0x89, 0xce, 0xce, 0x60, 0xe, 0x8d, 0xf7, 0x41, 0x99, 0x21, 0xad, 0x87, 0x2a, 0x8, 0x11, 0x9b, 0x1a, 0x3c, 0x7b, 0xbb, 0xb6, 0xc1, 0xd1, 0x3, 0xa7, 0x67, 0x3c, 0x49, 0xda, 0x2e, 0x6a, 0xbe, 0x58, 0xda, 0x32, 0x85, 0x69, 0xef, 0x2f, 0x77, 0xbd, 0xd3, 0xe3, 0x93, 0xa1, 0x9c, 0xcb, 0xbc, 0xd5, 0x18, 0xa6, 0xf2, 0x82, 0xac, 0xbb, 0xb, 0xc6, 0xdc, 0x32, 0xd8, 0xc0, 0x90, 0xdb, 0xf2, 0xea, 0x3a, 0xac, 0x68, 0x79, 0x42, 0x6e, 0x84, 0x73, 0xf4, 0x77, 0xac, 0xf8, 0xae, 0x75, 0xde, 0xb5, 0xb8, 0x1, 0xd3, 0xaa, 0x15, 0x17, 0x68, 0x69, 0x15, 0x8b, 0x56, 0x47, 0x76, 0x94, 0x92, 0xd4, 0xd7, 0x21, 0xe4, 0xb4, 0xcb, 0x3b, 0x44, 0x21, 0xd6, 0xba, 0xe, 0xef, 0xa8, 0x67, 0x95, 0x61, 0xd6, 0xd5, 0x77, 0x47, 0x8d, 0xfa, 0xaa, 0xbe, 0x9d, 0x6f, 0x4b, 0x6a, 0x43, 0x66, 0xdd, 0x94, 0xff, 0x8a, 0xf6, 0x1c, 0x6f, 0xb9, 0x82, 0x70, 0xb8, 0x72, 0x45, 0x4c, 0xd1, 0xf, 0xfd, 0x4e, 0x86, 0x3b, 0x78, 0xa7, 0xc9, 0xe, 0xee, 0x2b, 0x14, 0xf, 0xd5, 0x2a, 0xb8, 0x71, 0xe, 0x5a, 0x6a, 0xb3, 0x95, 0x63, 0xbc, 0x7b, 0x4, 0x92, 0x35, 0xb2, 0x2a, 0xab, 0x57, 0x87, 0x91, 0x8d, 0x96, 0xa0, 0x9a, 0xb3, 0x9b, 0xe6, 0x31, 0xe1, 0xf4, 0xba, 0x1e, 0x13, 0x4f, 0x1c, 0x39, 0x46, 0x40, 0x36, 0x43, 0xf5, 0xc3, 0x47, 0xee, 0x12, 0x2, 0xd0, 0xf0, 0x49, 0x24, 0x57, 0xbe, 0x7a, 0xc7, 0x98, 0x5e, 0x4b, 0xda, 0x55, 0xa0, 0xd7, 0xd1, 0xff, 0xe1, 0x8e, 0x5e, 0x35, 0x8b, 0x4c, 0xb7, 0xe2, 0x9a, 0xc5, 0xab, 0x85, 0x3e, 0x1f, 0xed, 0xcd, 0x60, 0xfb, 0x50, 0x28, 0x69, 0x5c, 0x61, 0xf0, 0xf6, 0x13, 0x93, 0x2a, 0x96, 0x42, 0x4d, 0x79, 0xf8, 0xf9, 0x7d, 0x58, 0xc8, 0x4a, 0xb2, 0x90, 0xd9, 0x3b, 0x33, 0x36, 0xdc, 0x18, 0xbf, 0x65, 0xc9, 0x3d, 0xea, 0xe0, 0x77, 0xd8, 0x7b, 0xf3, 0x5c, 0xc8, 0xef, 0x39, 0x5b, 0x34, 0xf9, 0xda, 0xd6, 0xec, 0xdd, 0x6c, 0x6e, 0xab, 0x98, 0xce, 0x2, 0xce, 0xf4, 0xf, 0x16, 0x23, 0x26, 0x3a, 0xd3, 0x46, 0xed, 0xda, 0x5a, 0x59, 0x71, 0x5e, 0xca, 0x4c, 0xdd, 0xde, 0x21, 0x8b, 0x49, 0x33, 0xed, 0xd8, 0x1b, 0xac, 0x5a, 0x9b, 0x23, 0x22, 0xe, 0x8b, 0xf6, 0x4c, 0x5a, 0xb6, 0x5b, 0xa3, 0x31, 0x7b, 0xa5, 0x18, 0x99, 0x56, 0x9c, 0x68, 0x3, 0xa7, 0x3b, 0x38, 0x66, 0x76, 0xe3, 0xde, 0x91, 0xae, 0x85, 0xdd, 0x2a, 0x6f, 0x9d, 0x5a, 0x2e, 0x7b, 0x47, 0x62, 0xbf, 0x95, 0xb6, 0x78, 0x16, 0xaf, 0x5a, 0x5, 0xdd, 0xd1, 0x1, 0x6e, 0x6f, 0x47, 0x63, 0x33, 0xf2, 0xe4, 0xb8, 0xe9, 0x9d, 0x5c, 0xb7, 0x46, 0x41, 0x86, 0xb2, 0x3b, 0x57, 0xd3, 0xe0, 0x2f, 0xc5, 0xb2, 0x36, 0x8f, 0x8b, 0x15, 0xe, 0x8f, 0xca, 0x74, 0x89, 0x15, 0x83, 0x3a, 0xb0, 0x89, 0x7f, 0xf3, 0xee, 0x12, 0x0, 0x6f, 0x9c, 0x88, 0x1a, 0x97, 0x41, 0xaf, 0x82, 0xf7, 0x7a, 0xef, 0xc3, 0xb1, 0x5, 0x84, 0x20, 0xc3, 0x2e, 0x35, 0x4, 0xab, 0xed, 0xd6, 0x8c, 0xdc, 0xf8, 0x2b, 0x75, 0x96, 0x22, 0x98, 0xa0, 0xad, 0x1d, 0x54, 0x89, 0xc6, 0x21, 0x94, 0x6f, 0x46, 0x5b, 0x39, 0x4a, 0x77, 0x8, 0x6d, 0xa1, 0xee, 0x3b, 0x9e, 0x3, 0xff, 0x93, 0xf3, 0xf5, 0xe3, 0x4d, 0x55, 0x6c, 0xaa, 0xf0, 0x41, 0xeb, 0xa5, 0xfa, 0xd1, 0xb0, 0xfb, 0xa9, 0x7a, 0xf1, 0x42, 0x84, 0x27, 0xf3, 0x39, 0x99, 0x37, 0xf1, 0xfa, 0xb5, 0x7b, 0x2e, 0xdf, 0xaf, 0xff, 0xad, 0x55, 0x90, 0x2a, 0x96, 0xe2, 0x7b, 0xa9, 0x20, 0x55, 0xe5, 0x9d, 0x2a, 0x48, 0xb3, 0x90, 0xa9, 0x82, 0x6c, 0xa5, 0xbf, 0x9b, 0xa, 0xf2, 0xd3, 0x62, 0x33, 0x5f, 0xe4, 0x9b, 0xea, 0x3e, 0x7a, 0x48, 0x69, 0x29, 0x30, 0x57, 0x41, 0x48, 0x5b, 0x61, 0x38, 0x22, 0x9f, 0xe3, 0x5d, 0xa9, 0xb4, 0x70, 0xb1, 0x2, 0xbc, 0x36, 0xb1, 0xc2, 0xb9, 0xd4, 0xde, 0x69, 0xda, 0xd7, 0x2, 0x88, 0xa3, 0x63, 0x6d, 0x18, 0xf0, 0x5c, 0x64, 0x62, 0x34, 0x97, 0xc, 0x63, 0xba, 0xe8, 0x39, 0x38, 0x4, 0x86, 0xab, 0xb0, 0xed, 0xc3, 0xa9, 0xe, 0x97, 0x39, 0x80, 0xa3, 0xe3, 0x6d, 0xf0, 0x6f, 0xd2, 0xd0, 0xc9, 0xe9, 0x34, 0xb4, 0x74, 0x26, 0xb2, 0xd2, 0xa1, 0x39, 0xef, 0x96, 0xcf, 0xdf, 0x59, 0x3d, 0x27, 0x49, 0xd9, 0x2e, 0xfd, 0x9b, 0xc6, 0x2c, 0x2f, 0xe0, 0xf8, 0x2c, 0xfd, 0xaa, 0xc6, 0xa4, 0xae, 0xe0, 0x4f, 0x92, 0x5, 0x21, 0x25, 0x8a, 0x11, 0x16, 0xb6, 0xa1, 0x0, 0x68, 0xcf, 0xdb, 0x81, 0xe4, 0x1, 0xa6, 0xca, 0x4e, 0x31, 0x7d, 0xec, 0x10, 0x87, 0x3b, 0x16, 0x4a, 0x49, 0xd2, 0xea, 0xaa, 0xb, 0x3, 0xa5, 0xa8, 0x97, 0xb5, 0x55, 0xd4, 0x5a, 0x37, 0xef, 0x54, 0xdb, 0xe4, 0x66, 0xd2, 0x95, 0xa4, 0x79, 0xb4, 0xed, 0x44, 0x7c, 0xd9, 0x31, 0x41, 0x2b, 0xcc, 0x21, 0xab, 0x59, 0x34, 0xd, 0xae, 0x9a, 0x89, 0x12, 0x48, 0x9c, 0x19, 0x67, 0x25, 0x74, 0xc4, 0x90, 0xe6, 0x36, 0xd3, 0x6d, 0xc4, 0xb7, 0x31, 0xe2, 0xd4, 0xbc, 0x53, 0xc5, 0x23, 0xc0, 0x95, 0x36, 0x93, 0xe9, 0x44, 0xb2, 0x26, 0xfb, 0x33, 0x48, 0x6c, 0xb5, 0x9d, 0x4a, 0xd6, 0x9, 0x18, 0x5b, 0x35, 0xd1, 0xa2, 0x95, 0x4b, 0xc5, 0xda, 0x22, 0x6, 0xac, 0x53, 0x69, 0xdb, 0x3e, 0xf7, 0x6d, 0x9e, 0xcd, 0x59, 0x56, 0xa9, 0x56, 0x55, 0x80, 0x9e, 0x70, 0xa4, 0x1e, 0x85, 0x7b, 0xfa, 0x5, 0x4b, 0x2c, 0xb3, 0x3e, 0xd7, 0x82, 0x9, 0xc2, 0xa0, 0x56, 0xac, 0xbe, 0x85, 0x36, 0x2b, 0xd6, 0xb4, 0xd7, 0xd2, 0xa2, 0x6e, 0xd1, 0xeb, 0x2, 0xdf, 0xeb, 0x68, 0xc7, 0x18, 0x57, 0x2c, 0x98, 0xe9, 0x8, 0xd2, 0x61, 0x62, 0x58, 0xb5, 0x6d, 0xc, 0xe5, 0xe3, 0x6e, 0xf8, 0xa4, 0x97, 0xf2, 0x6c, 0xa8, 0xf0, 0x0, 0x9a, 0xad, 0xd1, 0x89, 0x6c, 0x63, 0x65, 0x2a, 0x17, 0xd, 0x5d, 0xe7, 0xd4, 0x2c, 0xd1, 0xab, 0x1f, 0xd1, 0x55, 0x73, 0xd3, 0x2c, 0x41, 0x87, 0x2e, 0xb1, 0x89, 0xb, 0x4c, 0xe8, 0xff, 0x95, 0xaa, 0x45, 0x13, 0x75, 0xed, 0x3a, 0xcd, 0x5d, 0x3a, 0x45, 0x17, 0x73, 0x6d, 0xe8, 0x44, 0xd4, 0xb3, 0xe3, 0xf4, 0xa4, 0x76, 0xe8, 0x3a, 0xcb, 0xfd, 0x91, 0xfb, 0x34, 0x67, 0xe8, 0x1c, 0xb3, 0x63, 0x7b, 0xef, 0xe6, 0xb0, 0x6b, 0x14, 0x60, 0xf2, 0xd8, 0xef, 0x41, 0x9b, 0xfe, 0xa9, 0xc4, 0xf5, 0x1e, 0x6b, 0x2f, 0xa7, 0x7c, 0xd3, 0xc6, 0x5c, 0x3b, 0xb1, 0xd3, 0x3b, 0x63, 0xa0, 0x6d, 0xd, 0x88, 0x5d, 0x2, 0x0, 0x6c, 0xa2, 0x2d, 0x1, 0xdc, 0x35, 0x7e, 0xc1, 0xc3, 0x9b, 0x9c, 0xb9, 0x3, 0x2f, 0xdc, 0x75, 0xf4, 0xff, 0xe9, 0x13, 0x67, 0x64, 0xa7, 0xaa, 0xe2, 0x8e, 0x45, 0x95, 0x19, 0xbb, 0xd, 0x10, 0xad, 0x39, 0x2a, 0xc, 0xcd, 0x29, 0x82, 0xa6, 0xa3, 0xe5, 0x8, 0x27, 0x99, 0xa4, 0x2e, 0x1d, 0x19, 0x18, 0x10, 0xd6, 0xe6, 0xc4, 0xd, 0xf1, 0xca, 0xe5, 0x4f, 0xf3, 0x8d, 0xbc, 0x37, 0x3a, 0x37, 0x5b, 0xa9, 0xc7, 0x62, 0xc8, 0x9, 0x2c, 0x13, 0x81, 0x40, 0x7, 0x8a, 0x5f, 0x6c, 0xb0, 0x91, 0x4f, 0x33, 0x6e, 0x70, 0x90, 0x0, 0xa8, 0x7c, 0x8d, 0xe4, 0x97, 0xdd, 0xb8, 0x79, 0xfa, 0x21, 0x3e, 0x1d, 0xb4, 0xfd, 0x4d, 0xed, 0x25, 0xfe, 0xfd, 0xb6, 0x11, 0xfc, 0x6d, 0x86, 0x13, 0x5c, 0x5f, 0xf2, 0xc6, 0xcf, 0x17, 0x1c, 0x0, 0xb0, 0xc8, 0xc3, 0xc1, 0x9f, 0x18, 0x59, 0x19, 0x7d, 0x5a, 0x54, 0x58, 0x42, 0x7d, 0x4b, 0xf8, 0xa9, 0x33, 0x4d, 0xa9, 0x68, 0x24, 0x52, 0x3f, 0x6f, 0x45, 0x84, 0xc, 0x8f, 0x87, 0xea, 0x2a, 0xaf, 0x16, 0xb8, 0xac, 0x4, 0x25, 0x56, 0xc9, 0x44, 0xba, 0xa9, 0x83, 0x32, 0xff, 0xa1, 0xb6, 0x17, 0x6, 0xd5, 0xff, 0x17, 0x59, 0x5f, 0xe0, 0xce, 0xdd, 0x5b, 0xec, 0x21, 0x39, 0x5f, 0x5d, 0x4a, 0xd3, 0x8f, 0xbb, 0x2f, 0xa4, 0x1d, 0xfb, 0xc9, 0xd6, 0xe, 0x1e, 0xce, 0x6, 0x4, 0xb7, 0x42, 0x54, 0x95, 0x61, 0xed, 0xd8, 0xa0, 0x8e, 0x82, 0x6d, 0x70, 0x71, 0xdd, 0xad, 0xb4, 0x3, 0xcf, 0xd5, 0x6f, 0xdd, 0x38, 0x62, 0x8b, 0xd6, 0x61, 0x44, 0x8d, 0x70, 0x9f, 0xbd, 0x8e, 0x80, 0xa5, 0x18, 0x68, 0xf4, 0x3f, 0xc7, 0x26, 0x82, 0x36, 0xac, 0xcb, 0x2a, 0x42, 0x64, 0xfe, 0x87, 0xdb, 0x45, 0xfc, 0xcb, 0x4c, 0x12, 0x8, 0x7e, 0x54, 0x46, 0xfd, 0x43, 0xa4, 0x3f, 0xb7, 0xaa, 0x35, 0x93, 0x44, 0x99, 0xf7, 0x37, 0x68, 0x10, 0xd5, 0x1b, 0xfa, 0xe8, 0xfa, 0xe0, 0xfd, 0x4a, 0xa3, 0x86, 0xd6, 0x68, 0xcd, 0x95, 0x31, 0x26, 0xda, 0x34, 0x6d, 0x90, 0x7, 0xaa, 0x61, 0xdf, 0xe0, 0xaa, 0xa0, 0xd, 0x1c, 0xec, 0x2a, 0xb5, 0x95, 0x43, 0x73, 0x8, 0xb5, 0xa9, 0xc3, 0x5d, 0x36, 0xe, 0x4e, 0x38, 0x95, 0x9a, 0x7e, 0x6d, 0xb2, 0xe0, 0xd6, 0x3b, 0x7e, 0xef, 0xdf, 0xdf, 0xbe, 0xe0, 0x3f, 0xd3, 0xcc, 0xc0, 0x79, 0x40, 0x77, 0x19, 0x1a, 0x88, 0xa, 0xef, 0x62, 0x6a, 0x60, 0x18, 0x1a, 0x8, 0x28, 0x94, 0x37, 0xa7, 0x96, 0xa1, 0x81, 0x85, 0x45, 0x7e, 0xb, 0xed, 0x85, 0x53, 0xc3, 0xaf, 0x4f, 0xba, 0x1c, 0xc8, 0xfd, 0x35, 0x1b, 0xa6, 0x6e, 0x63, 0x87, 0x3d, 0x80, 0x30, 0x25, 0x64, 0xf9, 0x2e, 0x7b, 0x0, 0xf7, 0xc2, 0x77, 0x59, 0x4, 0x14, 0xbf, 0x5b, 0x4, 0xfc, 0x8f, 0xb0, 0x8, 0xc8, 0x7f, 0xb7, 0x8, 0xf8, 0xdd, 0x22, 0xe0, 0xb7, 0xb5, 0x8, 0xb0, 0x79, 0xd7, 0xde, 0x9d, 0xfc, 0xef, 0xbf, 0xd4, 0x2a, 0xa0, 0xf8, 0xdf, 0x60, 0x15, 0x20, 0x4d, 0xbf, 0xf1, 0xbd, 0xe9, 0x5f, 0x69, 0xd, 0x70, 0x4f, 0xfe, 0xeb, 0x2e, 0x8b, 0x0, 0x79, 0xcb, 0xf9, 0xe, 0xf7, 0xfe, 0x3b, 0x6f, 0xe9, 0x77, 0xf0, 0x6d, 0xee, 0xb2, 0x4e, 0xd6, 0xea, 0xdf, 0x72, 0x55, 0x2f, 0x17, 0xf4, 0x5d, 0x2f, 0xeb, 0xff, 0xed, 0x37, 0xeb, 0x66, 0x50, 0x12, 0x4d, 0x77, 0xed, 0x17, 0xcb, 0xd5, 0x9b, 0x4, 0x20, 0x62, 0x90, 0xb8, 0x45, 0xfb, 0xbc, 0xb5, 0x2c, 0x29, 0x85, 0x4d, 0xad, 0x66, 0x7b, 0x66, 0x20, 0xdc, 0x7d, 0xd, 0x53, 0xfa, 0x6e, 0xc1, 0xd7, 0xa8, 0x62, 0xcd, 0x21, 0xf7, 0xf6, 0xb6, 0x42, 0xe3, 0xca, 0x9d, 0x75, 0x9e, 0xae, 0xf9, 0x65, 0x6, 0xa2, 0x5d, 0xb3, 0xde, 0x7b, 0x5c, 0xf8, 0x2b, 0x4f, 0x48, 0x3e, 0x78, 0x43, 0x8d, 0x69, 0x1e, 0x2b, 0xf, 0xc6, 0xdd, 0x6c, 0x57, 0xdb, 0x14, 0xc0, 0x56, 0x2a, 0xde, 0x79, 0x73, 0xdf, 0x75, 0x4c, 0x38, 0xdd, 0xcd, 0x5b, 0x60, 0xa1, 0xad, 0xa9, 0x6a, 0xed, 0x11, 0xe1, 0x33, 0x1c, 0xda, 0x82, 0xb5, 0xfd, 0x94, 0xcb, 0x28, 0xc3, 0x28, 0x5e, 0xd9, 0xc9, 0x42, 0x2b, 0xf8, 0x26, 0x5d, 0xd, 0x29, 0x35, 0xd4, 0x10, 0xdd, 0x51, 0x81, 0xa8, 0xad, 0x8b, 0xa5, 0x60, 0xf0, 0x60, 0x3d, 0x50, 0xf1, 0xd, 0x4, 0x1, 0x8b, 0xf9, 0x78, 0x93, 0xb7, 0x20, 0xad, 0x24, 0x2b, 0xd4, 0x27, 0xc5, 0x76, 0xb6, 0x2a, 0x9, 0x55, 0xe7, 0xe0, 0xfa, 0xd4, 0x71, 0xa0, 0x27, 0x1d, 0x65, 0x5d, 0xb6, 0x13, 0x61, 0x47, 0xd9, 0x13, 0xa3, 0x6c, 0x1d, 0xb5, 0x85, 0x54, 0x9e, 0x77, 0xb6, 0x6d, 0x4, 0x88, 0x6a, 0xd, 0x9b, 0x54, 0xb6, 0xf7, 0x1c, 0xb6, 0x2c, 0x7b, 0xaf, 0x61, 0xcb, 0xb2, 0xf7, 0x1e, 0xb6, 0xa3, 0x6d, 0x63, 0xd8, 0xa, 0x28, 0xca, 0xa6, 0x97, 0xa9, 0xda, 0xd7, 0xb6, 0xa6, 0x8f, 0x95, 0xb6, 0xc7, 0xa9, 0x25, 0xd5, 0x97, 0x76, 0xcc, 0x1e, 0x37, 0x40, 0x65, 0x33, 0x9f, 0x3c, 0x12, 0x83, 0x52, 0xbb, 0x81, 0x62, 0x50, 0x5f, 0x74, 0x60, 0xa6, 0x80, 0x6f, 0xca, 0x76, 0xd9, 0x1, 0x5b, 0xca, 0x19, 0x55, 0xc1, 0xce, 0xd8, 0x86, 0x3c, 0x74, 0x16, 0x75, 0xed, 0x1a, 0x3a, 0x90, 0x3a, 0x77, 0xb3, 0x63, 0xdb, 0xae, 0xba, 0xb6, 0x93, 0xa9, 0x91, 0x8a, 0xd0, 0x74, 0xa5, 0x8e, 0x13, 0xa5, 0x92, 0xf5, 0x7a, 0xd6, 0xae, 0xaa, 0x8e, 0xe5, 0x44, 0xe9, 0xfe, 0xe0, 0x60, 0xa1, 0x1f, 0x15, 0xc5, 0x40, 0x67, 0xaa, 0xa9, 0xc5, 0x59, 0x7d, 0xc6, 0xce, 0x55, 0xb0, 0x63, 0x1b, 0x28, 0xd4, 0x7e, 0x51, 0xe9, 0xe1, 0x8e, 0x42, 0x86, 0xef, 0xa9, 0xa9, 0x94, 0xb1, 0xbc, 0xc4, 0x4b, 0x19, 0xe3, 0xd8, 0xb9, 0x5d, 0x88, 0x91, 0xe4, 0x53, 0x6a, 0xff, 0x14, 0x6b, 0x1e, 0x8b, 0x1b, 0x53, 0x8e, 0xe4, 0x5a, 0xff, 0xfd, 0xc8, 0xf4, 0x10, 0x97, 0xc, 0xe4, 0xf1, 0x83, 0x7, 0x4c, 0xfd, 0x37, 0x1c, 0xfc, 0x97, 0x56, 0xae, 0xbb, 0xfc, 0x18, 0x1f, 0x35, 0x5c, 0xb9, 0xc3, 0x63, 0x67, 0xfa, 0xf7, 0x2a, 0x9d, 0x46, 0x2, 0xeb, 0x6a, 0xda, 0x14, 0xfd, 0x1a, 0x43, 0xa3, 0xdf, 0xed, 0x89, 0xfe, 0x69, 0xf6, 0x44, 0x4f, 0x8b, 0x65, 0xbc, 0xc6, 0x98, 0x13, 0xef, 0x6f, 0x50, 0xd4, 0x69, 0xed, 0xf3, 0xef, 0x37, 0x37, 0x70, 0x2a, 0xd1, 0xeb, 0x2b, 0xc0, 0xe1, 0x7b, 0x58, 0x1f, 0x99, 0x8c, 0xbc, 0x11, 0x6, 0xab, 0x7e, 0x30, 0xcc, 0x2d, 0x1, 0xbd, 0x83, 0xf2, 0xe2, 0x3e, 0x6a, 0x90, 0xfb, 0x28, 0x38, 0x74, 0xc0, 0x84, 0x9d, 0x8a, 0x97, 0xfb, 0xa, 0x78, 0xad, 0x30, 0x15, 0xbb, 0x8a, 0xab, 0x32, 0xcc, 0x8a, 0x4d, 0xe1, 0xd2, 0xa8, 0x58, 0xb1, 0x2b, 0x9a, 0x21, 0x23, 0x76, 0x54, 0xd0, 0x51, 0x29, 0x9a, 0xc1, 0x28, 0xee, 0xae, 0xf3, 0xfd, 0x4e, 0xe5, 0x84, 0xc2, 0x5d, 0x93, 0x1d, 0x7a, 0xb, 0x0, 0x9c, 0xfb, 0x69, 0x2e, 0x64, 0xf4, 0x9, 0xc4, 0x3f, 0x1d, 0xa, 0xb3, 0x4e, 0x59, 0x41, 0x6, 0x73, 0x70, 0xc2, 0x67, 0x3b, 0x4b, 0x47, 0xef, 0x77, 0x2a, 0xe0, 0xee, 0xa5, 0xea, 0x73, 0xe9, 0xc3, 0xb6, 0x96, 0xf4, 0x63, 0x68, 0xa6, 0x2a, 0x4b, 0x4c, 0x6b, 0xa9, 0x94, 0xdf, 0xd5, 0xec, 0xec, 0x77, 0x93, 0xbe, 0xa6, 0x49, 0xdf, 0xff, 0x7a, 0x43, 0xbc, 0xf7, 0xb3, 0x70, 0xb3, 0x6e, 0x9a, 0xd8, 0xaf, 0x30, 0xe6, 0x6b, 0x8, 0x7f, 0x76, 0xb4, 0x13, 0x25, 0x28, 0xbe, 0xab, 0xd9, 0x9a, 0x68, 0xb4, 0x19, 0xc6, 0xe, 0x79, 0x47, 0xa7, 0x59, 0xdc, 0xfd, 0xc, 0xd7, 0xfe, 0x8d, 0x56, 0x55, 0xbf, 0x99, 0x95, 0x9b, 0xd6, 0x47, 0xb4, 0x34, 0x40, 0x6, 0x56, 0x8a, 0x5c, 0x83, 0x57, 0x97, 0x5d, 0x35, 0x6e, 0x72, 0x9e, 0x8e, 0xb1, 0x73, 0x8, 0xa, 0xb6, 0xf5, 0xe5, 0xc8, 0xb8, 0x1d, 0xba, 0xc1, 0x56, 0x56, 0x4e, 0x6e, 0xfe, 0xe7, 0x6a, 0x22, 0x43, 0xf7, 0x25, 0x3, 0x9c, 0xdc, 0xfb, 0xdb, 0xa9, 0x29, 0xb, 0xef, 0xfb, 0x5e, 0x17, 0x3c, 0x6a, 0x5e, 0x54, 0x74, 0x5e, 0x92, 0x34, 0x6e, 0x2d, 0x44, 0x1, 0x56, 0xb2, 0x1b, 0x8c, 0x2a, 0x13, 0xbe, 0xc3, 0x10, 0xdf, 0x93, 0x72, 0x6e, 0x7f, 0xb, 0x93, 0xca, 0x7b, 0x1a, 0x44, 0x9a, 0xa7, 0xc9, 0x34, 0x8f, 0xfc, 0xd7, 0xd8, 0x28, 0xb6, 0x89, 0xb9, 0x3d, 0xa1, 0xe, 0xc2, 0xde, 0xda, 0x9b, 0x9b, 0xf7, 0x5d, 0xe8, 0x5f, 0x65, 0xc7, 0x78, 0x1f, 0xc4, 0x7c, 0xf, 0xe3, 0xc4, 0xa6, 0xe, 0xf5, 0x37, 0xb1, 0x4d, 0xec, 0xc4, 0xef, 0xef, 0x37, 0x8b, 0x77, 0xb1, 0x34, 0xfc, 0xd7, 0x18, 0x18, 0x6a, 0x83, 0x46, 0x7, 0xa6, 0x96, 0x19, 0xbf, 0x91, 0x56, 0xc3, 0x2d, 0xad, 0xc2, 0x12, 0x5a, 0x21, 0x78, 0x6e, 0x5a, 0xea, 0x6, 0x8a, 0x3d, 0xa2, 0x12, 0xbe, 0xd9, 0x54, 0x96, 0xd, 0xa0, 0x94, 0x73, 0xf6, 0x47, 0x4e, 0x55, 0x87, 0x1d, 0xee, 0xcd, 0x36, 0x3e, 0x1c, 0x5, 0x1e, 0xb3, 0x3, 0xba, 0x29, 0x4b, 0xbf, 0x46, 0xa4, 0xb2, 0xd0, 0xfb, 0xe8, 0xe1, 0x1a, 0x84, 0xc2, 0x8f, 0x3c, 0xe6, 0x88, 0x70, 0x16, 0x7a, 0x79, 0xb1, 0xbe, 0x88, 0x97, 0xad, 0x4c, 0xc4, 0x71, 0xa3, 0x21, 0x73, 0x4, 0x35, 0xb, 0xbd, 0x3f, 0x7e, 0xf2, 0xc9, 0x27, 0xde, 0x2e, 0x4b, 0xc4, 0x8f, 0x7f, 0xb7, 0x44, 0xfc, 0x67, 0x59, 0x22, 0xfe, 0x6f, 0xb3, 0x31, 0xec, 0x34, 0x1, 0x34, 0x4d, 0x9d, 0x82, 0xdf, 0xad, 0x2, 0x7f, 0xb7, 0xa, 0xec, 0xb0, 0xa, 0xa4, 0x10, 0x8c, 0xe6, 0x55, 0x9f, 0x56, 0xd4, 0x82, 0x20, 0x53, 0x44, 0x36, 0x99, 0xb4, 0x23, 0x4c, 0xe6, 0xec, 0x4e, 0xd2, 0xc8, 0x83, 0x0, 0x15, 0xed, 0xbf, 0xb5, 0xe1, 0xe1, 0x95, 0x4b, 0x76, 0x83, 0xcf, 0x89, 0x31, 0x20, 0xc5, 0xec, 0x14, 0x20, 0x19, 0x5f, 0xdf, 0xa3, 0xfc, 0xb5, 0x2e, 0x7f, 0xfd, 0x3f, 0xc9, 0xb0, 0xb1, 0xc3, 0xa2, 0xf0, 0xdf, 0x68, 0xa5, 0xd7, 0x19, 0x5, 0x48, 0x2a, 0x3c, 0x88, 0x33, 0xf9, 0x6c, 0x5d, 0x5c, 0x88, 0x50, 0xd8, 0xb6, 0x55, 0x65, 0x1d, 0xe3, 0xb9, 0xbd, 0x35, 0xc4, 0x5f, 0xe5, 0xcd, 0x70, 0xd4, 0x2d, 0xb1, 0x93, 0x15, 0xe6, 0x93, 0x30, 0xbe, 0xc, 0xec, 0xda, 0x37, 0x79, 0xab, 0xa3, 0x3c, 0x60, 0x71, 0x6d, 0x8d, 0xe7, 0x17, 0xa7, 0x91, 0xbb, 0xad, 0xdb, 0xdb, 0xe1, 0x69, 0x81, 0xbe, 0xe9, 0x45, 0x34, 0x44, 0x40, 0x6, 0xb4, 0x4e, 0x11, 0x36, 0x4f, 0xa2, 0x6, 0x23, 0x25, 0x3, 0x41, 0xeb, 0xbb, 0xe4, 0xee, 0x1b, 0xf2, 0x58, 0xc9, 0xb0, 0x62, 0x85, 0xcf, 0xa, 0xc2, 0x68, 0x71, 0xa7, 0x45, 0xe1, 0xef, 0x4a, 0xec, 0xdf, 0x95, 0xd8, 0xef, 0xa6, 0xc4, 0x6e, 0xf0, 0xc5, 0xd, 0xd4, 0x37, 0x77, 0x16, 0x75, 0xc, 0xac, 0xc9, 0x99, 0x4f, 0xdc, 0xd, 0xa9, 0xb1, 0xb9, 0x58, 0xe1, 0x36, 0x53, 0x63, 0x17, 0x70, 0x71, 0xd5, 0x3b, 0xea, 0x10, 0x20, 0x3a, 0x99, 0xf8, 0x1d, 0x95, 0x24, 0x5c, 0xba, 0x98, 0xfb, 0x5d, 0x5d, 0xd1, 0xc1, 0x78, 0x57, 0x6b, 0xda, 0x7f, 0xf9, 0x1d, 0xc0, 0x52, 0x9e, 0x21, 0xf5, 0xb2, 0xad, 0x7d, 0x27, 0xa0, 0xb9, 0xe6, 0xe1, 0x39, 0x7d, 0x37, 0x2e, 0x9, 0xa4, 0x51, 0x84, 0xe3, 0xf1, 0x91, 0xb6, 0xc6, 0x41, 0xb7, 0x65, 0xd5, 0x6d, 0x3e, 0x52, 0x72, 0xf, 0xd5, 0x5e, 0xc3, 0xc, 0x2b, 0x33, 0x6c, 0xa2, 0xdd, 0x5a, 0x47, 0xea, 0x79, 0x92, 0x1, 0xc7, 0x9e, 0x14, 0x79, 0x12, 0x57, 0x72, 0x2c, 0x41, 0xb8, 0xcb, 0x8e, 0xbb, 0xa5, 0x28, 0x44, 0xf, 0xbb, 0x2d, 0x2a, 0x6e, 0x7f, 0xd7, 0x15, 0xfe, 0xe7, 0xe8, 0xa, 0x3b, 0xd, 0x2a, 0x3b, 0xec, 0x1b, 0x7b, 0xac, 0xc3, 0xd2, 0xd2, 0xd0, 0x2, 0x77, 0xf0, 0xaa, 0x1d, 0xac, 0xc2, 0xdd, 0xba, 0x1d, 0xf5, 0x52, 0xef, 0xaf, 0xb4, 0xe3, 0x2c, 0x89, 0xb, 0x2d, 0x1b, 0xbc, 0xe5, 0x3f, 0xd5, 0x16, 0x73, 0x69, 0xbc, 0xe8, 0x93, 0xdd, 0xe9, 0x6e, 0x7d, 0x87, 0x6d, 0xa6, 0xe3, 0x71, 0x5f, 0xab, 0x17, 0xf5, 0x12, 0xf0, 0xaf, 0x33, 0xda, 0xec, 0x1a, 0x5e, 0x87, 0x9e, 0xf7, 0xde, 0xbe, 0x2b, 0xef, 0xa7, 0xbf, 0x95, 0x5a, 0xd3, 0x77, 0xbd, 0x8, 0xfe, 0x97, 0xe9, 0xbf, 0x77, 0x69, 0x87, 0x9d, 0xe8, 0xda, 0x85, 0xea, 0xdd, 0x88, 0x7c, 0x87, 0x16, 0x96, 0x35, 0xd, 0x57, 0x6d, 0xb5, 0x6c, 0x4b, 0xc1, 0xc8, 0x7e, 0x85, 0x43, 0xce, 0x1d, 0x96, 0xa1, 0xbb, 0xe, 0x3c, 0x67, 0xf7, 0xd6, 0xdb, 0x6, 0x86, 0x91, 0xe8, 0x3f, 0xd5, 0x1e, 0xd0, 0x35, 0x43, 0xc0, 0x76, 0xe2, 0x95, 0x82, 0x96, 0x4d, 0x60, 0xb8, 0xc3, 0xc8, 0xce, 0xb6, 0x63, 0xd3, 0x26, 0x77, 0xdd, 0x86, 0x6f, 0xc2, 0xd4, 0x8d, 0xed, 0xf6, 0x7d, 0xb2, 0x17, 0x7a, 0xb7, 0xf9, 0xdb, 0xf8, 0xf, 0x47, 0x47, 0x8f, 0x8a, 0xa2, 0x82, 0xbe, 0xe3, 0xd5, 0xe0, 0x55, 0xf9, 0x87, 0x9e, 0x6e, 0x2b, 0x6e, 0xa8, 0x8e, 0x55, 0xc6, 0x5e, 0xe2, 0x27, 0x2c, 0xb5, 0xe3, 0x8d, 0xd3, 0x70, 0x1a, 0x3c, 0x1, 0x59, 0x39, 0xa, 0x65, 0x34, 0x48, 0x8c, 0xb8, 0xf0, 0xbe, 0x37, 0xc5, 0xe5, 0x49, 0xe3, 0xa5, 0x17, 0xb0, 0x79, 0x14, 0x6b, 0xb5, 0x1d, 0x48, 0x4d, 0x83, 0x4f, 0x9f, 0x7c, 0xf6, 0xf0, 0xdb, 0x2f, 0x5f, 0x3c, 0x67, 0xb2, 0x6c, 0xc0, 0x5a, 0x4f, 0x13, 0x24, 0x7, 0x7, 0x49, 0x30, 0x9e, 0xdd, 0xde, 0xb6, 0x9a, 0x83, 0x2e, 0x10, 0x83, 0x4f, 0x85, 0xe6, 0x6b, 0xe, 0xb0, 0x80, 0xda, 0x26, 0x60, 0xb9, 0x8c, 0xca, 0x93, 0xd9, 0x59, 0x72, 0xee, 0xa7, 0x41, 0x38, 0x27, 0xc9, 0xea, 0xe0, 0x60, 0x46, 0x7f, 0x21, 0x65, 0x2b, 0x9e, 0xe0, 0x98, 0xd6, 0x5c, 0xcd, 0x94, 0x25, 0x12, 0x39, 0x49, 0xc0, 0x89, 0x12, 0x1, 0x88, 0x1f, 0x4c, 0x8b, 0xf4, 0x1a, 0x26, 0x96, 0x16, 0xc9, 0x86, 0x1e, 0xdf, 0xc3, 0xdf, 0xf2, 0xb8, 0x7c, 0xc0, 0x85, 0x1f, 0x1f, 0x64, 0x4f, 0x55, 0x12, 0xca, 0x78, 0xc5, 0x3c, 0xb2, 0xf2, 0xc9, 0x5c, 0xdb, 0xf7, 0xc4, 0xd0, 0xfb, 0xa2, 0x84, 0xa7, 0x2a, 0x28, 0x91, 0x24, 0x22, 0xfd, 0x93, 0x70, 0x32, 0x2a, 0x91, 0x7d, 0xcf, 0x8d, 0x94, 0x62, 0x9d, 0x1, 0x54, 0xc6, 0xcb, 0x47, 0xd0, 0x39, 0x8, 0x26, 0x46, 0x4e, 0x99, 0xac, 0x8b, 0xe5, 0x72, 0x2a, 0x23, 0x9d, 0xa9, 0xa7, 0x86, 0xb3, 0x79, 0x5e, 0xac, 0x6b, 0x79, 0x69, 0x99, 0x25, 0xaf, 0xa3, 0xfd, 0x91, 0x4d, 0xed, 0x91, 0x76, 0x54, 0x5c, 0x3e, 0xf5, 0xec, 0x1e, 0x2a, 0x9a, 0x94, 0x42, 0xa2, 0x17, 0xc, 0x96, 0x45, 0x9c, 0xfa, 0x8e, 0xea, 0x2c, 0xc6, 0x3b, 0xb2, 0xab, 0x6b, 0xbf, 0x89, 0xe3, 0x75, 0x83, 0xb0, 0x2b, 0x73, 0xe0, 0x27, 0x7c, 0xf, 0x9b, 0xe0, 0xe9, 0xa0, 0x86, 0x8, 0xfd, 0xd4, 0xe1, 0x78, 0x3a, 0xf8, 0xc7, 0x93, 0x67, 0xcf, 0xbf, 0xf8, 0xe6, 0xeb, 0xc8, 0xfb, 0x78, 0xf0, 0xf1, 0xe0, 0x4f, 0x1e, 0x80, 0xc7, 0x8b, 0x67, 0xf, 0xbf, 0x7e, 0xfe, 0xc5, 0xb, 0x48, 0xfc, 0xf9, 0xd3, 0x6f, 0x9f, 0x3d, 0xc4, 0x8f, 0xe8, 0xe3, 0xe1, 0x10, 0x72, 0x1e, 0x3d, 0x7c, 0xfc, 0xb7, 0x4f, 0x9f, 0x7d, 0xf3, 0xf4, 0x67, 0x57, 0x91, 0xd1, 0x83, 0xa1, 0x1, 0x5b, 0xd1, 0xcd, 0xd4, 0xb0, 0xd1, 0x7c, 0xcd, 0xaf, 0xa7, 0x45, 0xbc, 0x4e, 0xe9, 0xae, 0x2, 0x56, 0x18, 0xfe, 0x22, 0x20, 0xd6, 0xe1, 0xb1, 0xab, 0x62, 0x8e, 0x17, 0x31, 0xe6, 0x89, 0x30, 0x81, 0x5e, 0xee, 0x8b, 0x7c, 0xc0, 0x1e, 0x38, 0x4f, 0x5f, 0x3d, 0xa, 0x88, 0x60, 0x15, 0x7, 0x76, 0x63, 0x98, 0x58, 0x37, 0x95, 0x88, 0x33, 0x92, 0x8a, 0xab, 0x18, 0x38, 0x2a, 0x3, 0xa1, 0x5d, 0xf5, 0xb0, 0x58, 0xbd, 0x28, 0xc, 0x3a, 0x44, 0x84, 0x97, 0xbe, 0x88, 0xd7, 0x80, 0x1b, 0xc3, 0x44, 0x39, 0x2d, 0xb4, 0xd6, 0x93, 0x7, 0x16, 0xb0, 0xe0, 0x19, 0xc9, 0xca, 0x4f, 0xc5, 0x85, 0xd, 0xba, 0x6, 0x20, 0xc6, 0x4c, 0xfd, 0x40, 0x99, 0x35, 0x28, 0x98, 0xda, 0x1f, 0x2a, 0x5a, 0xc6, 0x93, 0xd7, 0xcf, 0x15, 0xf0, 0x68, 0x2, 0x80, 0x94, 0xa6, 0x91, 0x46, 0x27, 0x0, 0xad, 0x8a, 0x4, 0x93, 0xe4, 0x9, 0xd0, 0x28, 0x56, 0x3c, 0x57, 0x30, 0xcc, 0x1, 0x5b, 0xaf, 0x78, 0x4d, 0xa8, 0x4b, 0x83, 0x4e, 0xe9, 0x71, 0xc3, 0x1a, 0x78, 0x9, 0x2, 0x22, 0x2a, 0x63, 0x2e, 0xb2, 0xb2, 0x34, 0x26, 0xfd, 0xd1, 0x19, 0x1e, 0xef, 0xbe, 0xcc, 0x88, 0x44, 0x17, 0xde, 0xf9, 0x47, 0x1a, 0xba, 0xf4, 0x8a, 0x4b, 0x90, 0xb1, 0xe, 0x1b, 0x35, 0x4d, 0xea, 0xec, 0x14, 0x66, 0xe8, 0x68, 0xde, 0x80, 0xcd, 0xd4, 0x1c, 0x10, 0x97, 0xd5, 0x36, 0xab, 0x5d, 0x95, 0xa6, 0xc1, 0xd, 0x9c, 0xef, 0x41, 0x45, 0x1b, 0x12, 0xc0, 0x42, 0xfa, 0x75, 0x23, 0xa8, 0x62, 0x4a, 0xdd, 0xa7, 0x6d, 0x28, 0xa4, 0x17, 0xeb, 0x89, 0x26, 0x7, 0xc6, 0x1c, 0x94, 0x9b, 0x15, 0xbe, 0xaf, 0x62, 0xd0, 0xc7, 0x83, 0x3, 0x63, 0x94, 0x80, 0xdb, 0xe5, 0xba, 0xcf, 0xe0, 0xf8, 0x78, 0xc1, 0xd8, 0xc8, 0x5b, 0xc5, 0x6b, 0x4, 0xa1, 0x40, 0xca, 0x87, 0xb7, 0xb7, 0x46, 0x5e, 0xbc, 0x5a, 0xe1, 0x1d, 0x52, 0x81, 0x83, 0x15, 0x28, 0xcb, 0xc8, 0x24, 0x78, 0xd, 0x24, 0xee, 0x78, 0x1, 0xe3, 0x1a, 0x62, 0x76, 0x9c, 0xbe, 0xda, 0x94, 0xd5, 0xa7, 0xb4, 0xa6, 0x48, 0x73, 0xcc, 0x71, 0xa0, 0x28, 0x2a, 0xde, 0xce, 0x10, 0x34, 0xd4, 0xec, 0x49, 0x43, 0x46, 0x6, 0x10, 0x31, 0x88, 0xab, 0xa, 0xe, 0x7b, 0xbc, 0xce, 0xe2, 0x3e, 0x6c, 0x58, 0xa, 0x50, 0xc2, 0xf6, 0x47, 0xd8, 0x3c, 0xcf, 0x67, 0xc5, 0x3a, 0x1, 0xc1, 0x24, 0xd9, 0x94, 0xd2, 0x97, 0x66, 0x66, 0x1f, 0x83, 0x7c, 0xf7, 0x39, 0xe0, 0x93, 0xd4, 0xd8, 0x72, 0x8e, 0xd4, 0xe0, 0x85, 0x5e, 0xb4, 0x27, 0x79, 0xda, 0xb5, 0xd1, 0x1a, 0x3, 0xcd, 0xb0, 0x6b, 0x18, 0xa2, 0x4a, 0x98, 0xc1, 0x6, 0xd, 0xf8, 0x85, 0x30, 0x39, 0x30, 0x5b, 0xf2, 0x9d, 0xe8, 0x27, 0x8, 0xef, 0xdb, 0x68, 0x3, 0x13, 0x20, 0xe0, 0x5a, 0x98, 0x0, 0xe9, 0x1a, 0xe4, 0xd3, 0x21, 0x95, 0x47, 0xd6, 0xc7, 0x17, 0xa, 0xf5, 0x6a, 0x60, 0xd, 0x3, 0x53, 0x32, 0x37, 0xa, 0x48, 0x6c, 0x14, 0x70, 0x70, 0xb0, 0x9f, 0x38, 0x71, 0x80, 0xba, 0x79, 0xd6, 0x38, 0x60, 0xb4, 0xf3, 0xdc, 0xd6, 0xc4, 0x2e, 0xc0, 0x3d, 0x97, 0x53, 0xcc, 0xf2, 0xee, 0x1, 0x9, 0x31, 0xe4, 0x2e, 0x28, 0x18, 0xca, 0xe6, 0x3a, 0xb0, 0x80, 0xcc, 0xed, 0x3c, 0x91, 0xcd, 0x43, 0xaf, 0xb, 0xbb, 0x4f, 0x3d, 0xcc, 0xc3, 0x79, 0xb6, 0xec, 0x91, 0x37, 0x8f, 0xd7, 0xa4, 0x89, 0xb4, 0x5c, 0x60, 0xd6, 0xc2, 0x4a, 0x5f, 0x61, 0x8f, 0x12, 0x35, 0xbd, 0x13, 0x40, 0xd9, 0x2d, 0xf8, 0x4d, 0xc0, 0x31, 0x8f, 0x8c, 0xa9, 0x81, 0xb9, 0xc7, 0xe, 0x11, 0x52, 0x6c, 0x25, 0xb7, 0xc9, 0x75, 0xdc, 0xa0, 0xd7, 0x70, 0xd0, 0xf1, 0xb5, 0x2d, 0x89, 0xee, 0xa4, 0x85, 0xa1, 0xb9, 0x5c, 0x7e, 0xac, 0x51, 0xa1, 0x42, 0x3b, 0x1d, 0x4, 0x5f, 0x9e, 0xc, 0x4d, 0xe6, 0xed, 0xa9, 0x11, 0xec, 0x45, 0x4d, 0xb6, 0x41, 0x83, 0xb2, 0xc5, 0x6b, 0x28, 0xc2, 0x3d, 0x69, 0x93, 0x14, 0xc8, 0xea, 0xc0, 0xfa, 0xae, 0xa9, 0x1e, 0xff, 0x17, 0xce, 0xed, 0xcd, 0x22, 0x4b, 0x16, 0xb2, 0xb, 0x41, 0xc6, 0xd5, 0x18, 0x43, 0x9b, 0xa4, 0x36, 0xba, 0xc3, 0x95, 0xee, 0xec, 0xaf, 0x31, 0x3f, 0x71, 0x9a, 0xba, 0xe6, 0x37, 0x89, 0xe5, 0x9b, 0x62, 0x62, 0x9f, 0x44, 0x61, 0xc7, 0xd8, 0xc5, 0x10, 0xe3, 0x3c, 0x5d, 0xf2, 0x6f, 0x49, 0x5e, 0x54, 0xe3, 0x34, 0xea, 0xe3, 0xa8, 0x9a, 0xd, 0x38, 0x10, 0x10, 0x41, 0x58, 0x53, 0x8d, 0x27, 0x1e, 0x29, 0x6a, 0x70, 0x18, 0x62, 0x49, 0xba, 0x29, 0x57, 0x2c, 0x59, 0x2, 0xeb, 0xd4, 0x5b, 0x5c, 0x41, 0x8c, 0xd3, 0xe7, 0xd5, 0x43, 0x22, 0x28, 0x64, 0xec, 0xe2, 0xeb, 0x44, 0x93, 0xbf, 0x88, 0x1d, 0x50, 0x23, 0xd0, 0x85, 0x39, 0x95, 0xd6, 0xca, 0x62, 0xb7, 0x8a, 0xda, 0xb6, 0x56, 0x58, 0x33, 0xd4, 0xea, 0xa8, 0xab, 0xdf, 0xb2, 0xa2, 0xef, 0x64, 0xbc, 0xed, 0x2e, 0xa6, 0xad, 0xc6, 0x9b, 0xec, 0xdb, 0x1d, 0x58, 0x44, 0xfc, 0xd, 0x3d, 0x4f, 0x3f, 0x22, 0xea, 0x6, 0xec, 0xa9, 0xf5, 0x14, 0xe5, 0xac, 0x83, 0x1d, 0xe0, 0xba, 0x95, 0x7a, 0xd0, 0xb1, 0xff, 0xd1, 0x49, 0x9a, 0x5d, 0x2a, 0xbb, 0x10, 0xb1, 0xfc, 0x2a, 0x77, 0xef, 0xa3, 0x1e, 0xef, 0x7d, 0xe4, 0xed, 0x1d, 0x9d, 0x7e, 0x14, 0xd4, 0x9c, 0x40, 0xcd, 0xcd, 0xbd, 0xb, 0x6f, 0xe6, 0x3a, 0x46, 0x16, 0x53, 0xdc, 0x66, 0x7e, 0x26, 0xfe, 0x2e, 0x21, 0xe4, 0xb2, 0xc8, 0xd2, 0xbd, 0x61, 0x10, 0x6a, 0x44, 0x42, 0xf8, 0x26, 0xd9, 0xac, 0x91, 0x99, 0x11, 0xe4, 0x1e, 0x8, 0x16, 0x88, 0x73, 0x71, 0x95, 0x25, 0x5e, 0x14, 0x39, 0x17, 0x6c, 0xd2, 0x44, 0x5a, 0x83, 0x99, 0xe0, 0x2b, 0x42, 0xe3, 0x54, 0x7, 0xaa, 0x2f, 0x75, 0xbc, 0xd9, 0xac, 0x9, 0x14, 0x4d, 0xbe, 0xa6, 0x1, 0x32, 0x36, 0x6f, 0xc3, 0xf6, 0x13, 0xf9, 0xf4, 0xc8, 0x78, 0x36, 0x69, 0x94, 0x74, 0x53, 0x8a, 0xa4, 0x93, 0x1c, 0xec, 0x12, 0x62, 0x82, 0x30, 0xf1, 0xa5, 0xc3, 0x1e, 0x6c, 0xfc, 0xbe, 0x3, 0x7e, 0x3e, 0xa8, 0x1, 0xc7, 0x9, 0xe4, 0xc6, 0xa0, 0x89, 0xd1, 0x9a, 0x47, 0x16, 0x6b, 0x64, 0x1f, 0x21, 0x64, 0x3d, 0x80, 0x21, 0x81, 0x2e, 0xc7, 0xbf, 0x82, 0x64, 0xde, 0xb1, 0x12, 0xf3, 0xf7, 0x5c, 0x89, 0xb9, 0x5a, 0x9, 0x39, 0x44, 0x1b, 0xaf, 0x19, 0x98, 0xb1, 0x85, 0x8, 0x6c, 0x76, 0xd6, 0xae, 0x68, 0xe6, 0xb9, 0x71, 0xa2, 0x5, 0x5b, 0x82, 0x51, 0xfe, 0x9c, 0x34, 0x78, 0xa7, 0x5a, 0x13, 0xa0, 0x3e, 0x64, 0x34, 0x9f, 0x1, 0x9c, 0x20, 0xf8, 0x23, 0x4a, 0x35, 0x50, 0x6a, 0x82, 0xda, 0x65, 0x19, 0x40, 0xe2, 0x4b, 0x3e, 0xab, 0x42, 0xb1, 0xa9, 0x78, 0x16, 0xbf, 0x28, 0xf1, 0x1e, 0x3, 0x35, 0x9a, 0x90, 0x77, 0x70, 0x10, 0x4f, 0x1c, 0x62, 0x3d, 0x20, 0x12, 0x15, 0x7e, 0xe2, 0x59, 0xad, 0xbd, 0x74, 0xd4, 0xde, 0xef, 0xaa, 0xde, 0x46, 0xa2, 0x36, 0x7e, 0x8e, 0x3a, 0xe5, 0xf7, 0xd6, 0xd0, 0x9b, 0x63, 0x69, 0x37, 0x6e, 0xcb, 0x96, 0xed, 0xf5, 0x15, 0xa4, 0x4b, 0xb8, 0xa8, 0xd2, 0x0, 0x11, 0xbf, 0xed, 0xc7, 0x22, 0x7b, 0x1a, 0x75, 0x2e, 0x30, 0xbe, 0x69, 0x84, 0xc6, 0x1, 0xd0, 0xf5, 0x63, 0x5a, 0x6b, 0x7a, 0x7d, 0x37, 0x18, 0xc7, 0xd1, 0x74, 0x40, 0xf, 0x81, 0xf6, 0x75, 0x14, 0xd7, 0xe9, 0x0, 0x1f, 0x8, 0xd, 0xb6, 0xee, 0x85, 0x8a, 0x2c, 0x6d, 0x8e, 0xdc, 0x38, 0x1a, 0xc9, 0x49, 0xec, 0x54, 0xab, 0x88, 0x77, 0x57, 0xc5, 0x2b, 0xc1, 0x6, 0x1, 0x6b, 0x8, 0xfc, 0x6, 0x71, 0x6b, 0x4f, 0x1a, 0x84, 0xb5, 0x12, 0x2f, 0x57, 0xc, 0x34, 0x4c, 0x6b, 0xeb, 0xc9, 0xc5, 0xec, 0x8b, 0xa7, 0x4c, 0x41, 0x60, 0x1f, 0xb2, 0xd1, 0x50, 0x4a, 0xfd, 0x4d, 0xbd, 0x8f, 0x3d, 0x6e, 0xb2, 0xdb, 0x1b, 0x98, 0x9b, 0x71, 0x7b, 0xb, 0xbb, 0xd3, 0x5, 0x1c, 0xbb, 0x3b, 0x66, 0x71, 0xcf, 0x31, 0x73, 0x17, 0xd8, 0x38, 0x27, 0x79, 0x47, 0xe3, 0xae, 0xd9, 0x34, 0xda, 0x6e, 0x2e, 0x6f, 0x7b, 0x9, 0xf5, 0xec, 0x93, 0x35, 0x87, 0x13, 0x2f, 0xc1, 0xc2, 0xf7, 0x80, 0xe, 0x2, 0x9e, 0x3, 0x1a, 0x82, 0x68, 0xe9, 0xeb, 0xf8, 0x82, 0x2b, 0x7a, 0xa8, 0xe7, 0xd2, 0x97, 0x8d, 0x7b, 0x96, 0x4a, 0x83, 0x8, 0x23, 0xd0, 0xb3, 0xb1, 0x80, 0xbb, 0xd8, 0xa4, 0x4, 0xfd, 0xd8, 0x4, 0x8b, 0xb1, 0x49, 0xf1, 0xa8, 0x36, 0xa2, 0x5, 0x89, 0x6b, 0x17, 0xd9, 0x12, 0x5b, 0x61, 0xd3, 0xed, 0x58, 0xf0, 0x8, 0xf1, 0x60, 0x96, 0xb, 0xf2, 0x39, 0xae, 0x3f, 0xa3, 0x84, 0xd5, 0x3f, 0x6, 0x8f, 0x81, 0x98, 0x55, 0xeb, 0x4d, 0x52, 0x15, 0xeb, 0x68, 0x6a, 0x66, 0xec, 0x7c, 0x56, 0xd5, 0x68, 0x2d, 0xa5, 0x99, 0x6c, 0x6d, 0x61, 0x4d, 0x93, 0x71, 0x45, 0xbe, 0x49, 0x6d, 0xda, 0x8f, 0x57, 0x99, 0xd6, 0xb1, 0x48, 0x15, 0x57, 0xad, 0x62, 0x31, 0xf5, 0x1c, 0x72, 0xf8, 0x52, 0x8b, 0xcb, 0xa3, 0x54, 0xca, 0x71, 0x8b, 0x35, 0x9f, 0x79, 0xa8, 0xd6, 0x85, 0xde, 0x64, 0x92, 0x68, 0x8c, 0xa8, 0x35, 0xc2, 0x2c, 0x45, 0x63, 0x58, 0xf3, 0xd5, 0x32, 0x4e, 0xb8, 0x7f, 0x34, 0x38, 0xf4, 0x27, 0xd1, 0x1f, 0xcf, 0x7e, 0x7a, 0x59, 0x9e, 0xf7, 0x3e, 0x8, 0x8e, 0x98, 0xe7, 0x5, 0xa8, 0xff, 0x9d, 0xb5, 0x94, 0xc2, 0x13, 0x4f, 0x8c, 0xc7, 0xb, 0x6b, 0xdd, 0xb0, 0x50, 0x2c, 0x86, 0xfb, 0x47, 0x7f, 0x3c, 0x1a, 0x54, 0xbc, 0x44, 0x63, 0x34, 0x68, 0x7c, 0xcb, 0x66, 0x4a, 0x4d, 0x9c, 0xca, 0xf, 0xd4, 0x85, 0x64, 0x0, 0x6a, 0xb1, 0x7, 0x5, 0xa6, 0x6d, 0x79, 0x7a, 0x26, 0x48, 0x51, 0x43, 0xc1, 0x66, 0xf2, 0x31, 0x71, 0x87, 0xca, 0x4c, 0xd6, 0x6c, 0xb2, 0xa2, 0xb6, 0x7e, 0x1, 0xbb, 0xe, 0x2f, 0xb3, 0x32, 0x9b, 0xc2, 0xf8, 0x3, 0x54, 0x96, 0xb4, 0x24, 0x1f, 0x54, 0x0, 0x25, 0x42, 0xf9, 0x3e, 0x63, 0x73, 0xa9, 0x8f, 0xf, 0xb6, 0xfe, 0x8f, 0x7c, 0x55, 0x15, 0xc1, 0xf8, 0xff, 0x1, 0xe6, 0x77, 0x53, 0x89, 0x57, 0x48, 0x1, 0x0, 0x0, 0x0, 0x1f, 0x8b, 0x8, 0x0, 0x0, 0x0, 0x0, 0x0, 0x2, 0x3, 0x8d, 0x54, 0xc1, 0x72, 0xe3, 0x20, 0xc, 0x3d, 0xa7, 0x33, 0xfd, 0x7, 0x86, 0xbd, 0x2e, 0x71, 0x3b, 0xbd, 0xec, 0xec, 0x62, 0x2e, 0xfd, 0x83, 0xb6, 0x3f, 0x20, 0x63, 0x39, 0x26, 0x8b, 0x6d, 0xa, 0xb2, 0x9b, 0xfc, 0xfd, 0x2, 0xb6, 0x93, 0xb4, 0x9b, 0xce, 0x24, 0x7, 0x47, 0x42, 0xd2, 0xd3, 0x93, 0x90, 0x90, 0x2d, 0x75, 0x56, 0xdd, 0xdf, 0xdd, 0xdf, 0xc9, 0x16, 0xa1, 0x8e, 0x12, 0x63, 0x92, 0xc, 0x59, 0x54, 0xaf, 0x1d, 0x78, 0x62, 0x2f, 0x68, 0xe1, 0x28, 0x8b, 0xf9, 0x28, 0x5b, 0x3b, 0x24, 0x60, 0x2d, 0x91, 0x13, 0xf8, 0x3e, 0x9a, 0xa9, 0xe4, 0xcf, 0x43, 0x4f, 0xd8, 0x93, 0x78, 0x3b, 0x3a, 0xe4, 0x4c, 0xcf, 0x5a, 0xc9, 0x9, 0xf, 0x54, 0x24, 0xf8, 0x3f, 0x4c, 0xb7, 0xe0, 0x3, 0x52, 0x39, 0x52, 0x23, 0x7e, 0x71, 0xc5, 0xce, 0x38, 0x3d, 0x74, 0x58, 0xf2, 0xc9, 0xe0, 0x87, 0x1b, 0x3c, 0x5d, 0x44, 0x7f, 0x98, 0x9a, 0xda, 0xb2, 0xc6, 0xc9, 0x68, 0x14, 0x59, 0xf9, 0xc9, 0x4c, 0x6f, 0xc8, 0x80, 0x15, 0x41, 0x83, 0xc5, 0xf2, 0x91, 0xcf, 0x7c, 0xac, 0xe9, 0xff, 0x32, 0x8f, 0xb6, 0xe4, 0x81, 0x8e, 0x16, 0x43, 0x8b, 0x18, 0x81, 0x5a, 0x8f, 0x4d, 0xc9, 0xab, 0x61, 0xa0, 0x40, 0x1e, 0xdc, 0x56, 0x87, 0xb0, 0x26, 0x2e, 0xce, 0x95, 0x56, 0x43, 0x7d, 0xcc, 0xd2, 0x46, 0xf6, 0x30, 0x31, 0x6d, 0x21, 0x84, 0x92, 0x47, 0xb1, 0x2, 0x2f, 0x4c, 0x3f, 0x61, 0xa4, 0xcd, 0x16, 0xb5, 0xc6, 0x6, 0x46, 0x4b, 0x29, 0xeb, 0x26, 0x86, 0xd6, 0xe6, 0xe4, 0x9f, 0x48, 0x83, 0xe9, 0xd1, 0x8b, 0xc6, 0x8e, 0xa6, 0x5e, 0x3c, 0x3e, 0xfb, 0x2c, 0x20, 0x29, 0x35, 0x7a, 0xae, 0xb2, 0x9d, 0x2d, 0x7e, 0xd1, 0x13, 0xbe, 0xf8, 0x55, 0x1e, 0xfa, 0x7a, 0xad, 0xe2, 0x7, 0x57, 0xb2, 0x80, 0x13, 0x6a, 0x11, 0x61, 0xaf, 0xa5, 0xd0, 0x83, 0xb5, 0xe0, 0xce, 0x84, 0x57, 0x9d, 0x33, 0x53, 0xc7, 0x56, 0x4, 0x81, 0x7, 0xe8, 0x9c, 0x45, 0xf1, 0xc5, 0x2e, 0x96, 0x4e, 0xfe, 0xff, 0x93, 0xa3, 0xbd, 0xe0, 0xb5, 0xe2, 0xc6, 0xbf, 0xef, 0x2, 0xd2, 0x6d, 0x30, 0x15, 0xab, 0x99, 0x89, 0x17, 0x5c, 0xc5, 0xe1, 0x68, 0xcc, 0x2e, 0xd1, 0x97, 0x85, 0x35, 0x37, 0x86, 0x5, 0x87, 0x58, 0xb, 0xc2, 0x10, 0xbb, 0xfd, 0x9a, 0x64, 0xf6, 0x16, 0xe5, 0x5b, 0x40, 0x16, 0xb6, 0xa0, 0xc9, 0x4c, 0xc8, 0x2f, 0x20, 0x35, 0x50, 0x1c, 0x80, 0xe7, 0xf8, 0x3d, 0xc1, 0x5c, 0x5, 0xf9, 0xa6, 0x11, 0xc5, 0x68, 0xd5, 0x8d, 0xce, 0xe7, 0xc3, 0x8b, 0x9b, 0x3a, 0x89, 0xb2, 0x88, 0xed, 0x4b, 0x42, 0x92, 0xaf, 0xcd, 0x50, 0x9e, 0x9e, 0x64, 0xdd, 0xc8, 0xf6, 0xf1, 0xf3, 0x12, 0x46, 0x3d, 0x9f, 0x5f, 0x84, 0x39, 0xd8, 0xe1, 0x69, 0xa8, 0x92, 0x31, 0x85, 0x3d, 0xa9, 0x97, 0xb4, 0x9a, 0x3e, 0xf6, 0xcd, 0x19, 0x4d, 0xa3, 0xc7, 0xc0, 0x86, 0x86, 0xe9, 0x5c, 0x7c, 0xb4, 0x66, 0x90, 0x95, 0xd0, 0x46, 0x9a, 0x6e, 0xc7, 0x82, 0xd7, 0x91, 0x3, 0xd0, 0x76, 0xef, 0x76, 0x9c, 0x15, 0xf9, 0x45, 0x38, 0xfb, 0xe4, 0x8c, 0x69, 0x88, 0x7c, 0x22, 0x32, 0x5f, 0xc, 0xcb, 0xdb, 0x56, 0xf2, 0x48, 0x70, 0x67, 0x7a, 0x51, 0xd, 0x44, 0x43, 0xf7, 0xfb, 0xe9, 0xc1, 0x1d, 0xd2, 0xb4, 0xce, 0x81, 0x29, 0x34, 0x68, 0x6f, 0x1c, 0xcd, 0x9, 0xac, 0xa9, 0xb6, 0xfb, 0xc0, 0x19, 0xc5, 0x97, 0x62, 0x79, 0x20, 0xf6, 0x30, 0xc1, 0xec, 0x92, 0xc2, 0x66, 0x49, 0xa5, 0xfa, 0xe7, 0x55, 0x5d, 0x17, 0x54, 0xe6, 0x97, 0x44, 0xfd, 0x3, 0xd3, 0x6a, 0x6f, 0x20, 0xaf, 0x4, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0}; ================================================ FILE: app/http/websocket.c ================================================ /* * ---------------------------------------------------------------------------- * "THE BEER-WARE LICENSE" (Revision 42): * Israel Lot and Jeroen Domburg * wrote this file. As long as you retain this notice you can do whatever you * want with this stuff. If we meet some day, and you think this stuff is * worth it, you can buy us a beer in return. * ---------------------------------------------------------------------------- */ #include "c_types.h" #include "user_interface.h" #include "espconn.h" #include "mem.h" #include "osapi.h" #include "c_stdio.h" #include "websocket.h" void ICACHE_FLASH_ATTR ws_write_frame(ws_frame *frame,write_function w,void *arg){ uint8_t byte; //fin byte = 0x80 ; //set first bit byte |= frame->TYPE; //set op code //write first byte w(&byte,1,arg); byte=0; if(frame->SIZE < 126) { byte = frame->SIZE; w(&byte,1,arg); //transmit size } else if(frame->SIZE < 0xFFFF){ //can we fit it into an uint16? byte=126; w(&byte,1,arg); //transmit extended lenght indicator //send lower 2 bytes of the uint64 len byte = 0xFF & frame->SIZE >> 8; w(&byte,1,arg); byte = 0xFF & frame->SIZE; w(&byte,1,arg); } else{ byte=127; w(&byte,1,arg); //transmit extended lenght indicator //transmit the whole uint64 w((char *)&frame->SIZE,8,arg); } //transmit the data w(frame->DATA,frame->SIZE,arg); } void ICACHE_FLASH_ATTR ws_output_frame(ws_frame *frame,enum ws_frame_type type,char * payload,size_t payloadSize){ //is FIN? frame->FIN = 1; //we don't support continuation frames, yet frame->SIZE = payloadSize; frame->TYPE = type; frame->MASKED=0; //server shouldn't mask according to https://tools.ietf.org/html/draft-ietf-hybi-thewebsocketprotocol-17 frame->DATA = payload; } void ICACHE_FLASH_ATTR ws_parse_frame(ws_frame *frame,char * data,size_t dataLen){ uint8_t byte = data[0]; //is FIN? frame->FIN = byte & 0x80; //opcode frame->TYPE = byte & 0x0F; if( (frame->TYPE > 0x03 && frame->TYPE < 0x08) || frame->TYPE > 0x0B ) { NODE_DBG("\tInvalid frame type %02X",frame->TYPE); frame->TYPE=WS_INVALID; return; } //mask byte = data[1]; frame->MASKED = byte & 0x80; //frame size frame->SIZE = byte & 0x7F; int offset = 2; if(frame->SIZE == 126) { frame->SIZE=0; frame->SIZE = data[3]; //LSB frame->SIZE |= (uint64_t)data[2] << 8; //MSB offset=4; } else if(frame->SIZE == 127){ frame->SIZE=0; frame->SIZE |= (uint64_t)data[2] << 56; frame->SIZE |= (uint64_t)data[3] << 48; frame->SIZE |= (uint64_t)data[4] << 40; frame->SIZE |= (uint64_t)data[5] << 32; frame->SIZE |= (uint64_t)data[6] << 24; frame->SIZE |= (uint64_t)data[7] << 16; frame->SIZE |= (uint64_t)data[8] << 8; frame->SIZE |= (uint64_t)data[9] ; offset=10; } if(frame->MASKED){ //read mask key char mask[4]; mask[0]=data[offset]; mask[1]=data[offset+1]; mask[2]=data[offset+2]; mask[3]=data[offset+3]; offset+=4; //unmaks data uint64_t i; for(i=0;iSIZE;i++){ data[i+offset] ^= mask[i % 4]; } } frame->DATA = &data[offset]; } ws_frame * ICACHE_FLASH_ATTR ws_make_pong(ws_frame *ping){ ws_output_frame(ping,WS_PONG,ping->DATA,ping->SIZE); return ping; } ================================================ FILE: app/http/websocket.h ================================================ /* * ---------------------------------------------------------------------------- * "THE BEER-WARE LICENSE" (Revision 42): * Israel Lot and Jeroen Domburg * wrote this file. As long as you retain this notice you can do whatever you * want with this stuff. If we meet some day, and you think this stuff is * worth it, you can buy us a beer in return. * ---------------------------------------------------------------------------- */ #ifndef __WEBSOCKET_H #define __WEBSOCKET_H typedef void (*write_function)(const char *data,size_t len,void * arg); //callback function enum ws_frame_type{ WS_CONTINUATION=0x00, WS_TEXT=0x01, WS_BINARY=0x02, WS_PING=0x09, WS_PONG=0x0A, WS_CLOSE=0x08, WS_INVALID=0xFF }; typedef struct{ uint8_t FIN; uint8_t MASKED; enum ws_frame_type TYPE; uint64_t SIZE; char * DATA; } ws_frame; void ICACHE_FLASH_ATTR ws_parse_frame(ws_frame *frame,char * data,size_t dataLen); void ICACHE_FLASH_ATTR ws_output_frame(ws_frame *frame,enum ws_frame_type type,char * payload,size_t payloadSize); void ICACHE_FLASH_ATTR ws_write_frame(ws_frame *frame,write_function w,void *arg); #endif ================================================ FILE: app/http/ws_app.c ================================================ /* * ---------------------------------------------------------------------------- * "THE BEER-WARE LICENSE" (Revision 42): * Israel Lot and Jeroen Domburg * wrote this file. As long as you retain this notice you can do whatever you * want with this stuff. If we meet some day, and you think this stuff is * worth it, you can buy us a beer in return. * ---------------------------------------------------------------------------- */ #include "c_types.h" #include "user_interface.h" #include "espconn.h" #include "mem.h" #include "osapi.h" #include "cgi.h" #include "cgi_wifi.h" #include "cgi_relay.h" #include "user_config.h" #include "http.h" #include "http_process.h" #include "websocket.h" #include "http_websocket_server.h" #define HTTP_PORT 80 #define WS_APP_STREAM_START "stream start" #define WS_APP_STREAM_STOP "stream stop" struct ws_app_context { uint8_t stream_data; int packet_requested_size; http_connection *conn; uint8_t waiting_sent; char * packet; int packet_size; }; static void ICACHE_FLASH_ATTR ws_app_send_packet(struct ws_app_context *context){ NODE_DBG("Webscoket app send packet size %d, requested: %d",context->packet_size,context->packet_requested_size); if( (!context->waiting_sent) && context->stream_data==1){ //send packet if(context->packet_requested_size != context->packet_size ){ NODE_DBG("Webscoket app changing packet size %p",context); if(context->packet!=NULL) os_free(context->packet); //free previous packet context->packet=NULL; context->packet_size=0; } if(context->packet==NULL) { NODE_DBG("Webscoket allocating packet %p",context); context->packet = (char *)os_zalloc(context->packet_requested_size); context->packet_size=context->packet_requested_size; //fill with trash data int i; for(i=0; i < context->packet_size;i++) context->packet[i]=i%0xFF; } http_ws_push_bin(context->conn,context->packet,context->packet_size); context->waiting_sent=1; } } static int ICACHE_FLASH_ATTR ws_app_msg_sent(http_connection *c){ NODE_DBG("Webscoket app msg sent %p",c); struct ws_app_context *context = (struct ws_app_context*)c->reverse; if(context!=NULL){ NODE_DBG("\tcontext found %p",context); context->waiting_sent=0; if(context->stream_data==1){ //no requet to stop made, send next packet ws_app_send_packet(context); } } } static int ICACHE_FLASH_ATTR ws_app_client_disconnected(http_connection *c){ NODE_DBG("Webscoket app client disconnected %p",c); //clean up struct ws_app_context *context = (struct ws_app_context*)c->reverse; if(context!=NULL){ if(context->packet!=NULL) os_free(context->packet); context->packet=NULL; } os_free(context); } static int ICACHE_FLASH_ATTR ws_app_client_connected(http_connection *c){ NODE_DBG("Webscoket app client connected %p",c); //create config struct ws_app_context *context = (struct ws_app_context*)os_zalloc(sizeof(struct ws_app_context)); context->conn=c; c->reverse = context; //so we may find it on callbacks NODE_DBG("\tcontext %p",context); } static int ICACHE_FLASH_ATTR ws_app_msg_received(http_connection *c){ NODE_DBG("Webscoket app msg received %p",c); struct ws_app_context *context = (struct ws_app_context*)c->reverse; ws_frame *msg = (ws_frame *)c->cgi.argument; if(msg==NULL) return HTTP_WS_CGI_MORE; //just ignore and move on if(msg->SIZE <=0) return HTTP_WS_CGI_MORE; //just ignore and move on char * s = msg->DATA; char *last = s+msg->SIZE; //make a null terminated string char * str = (char *)os_zalloc(msg->SIZE + 1); os_memcpy(str,s,msg->SIZE); str[msg->SIZE]=0; NODE_DBG("\tmsg: %s",str); if(strstr(str,WS_APP_STREAM_START)==str){ //request to start stream NODE_DBG("\trequest stream start"); char * s= str + strlen(WS_APP_STREAM_START); int pSize = atoi(s); NODE_DBG("\trequest stream packet size %d",pSize); if(pSize>0 && pSize <= 1024) { context->packet_requested_size=pSize; context->stream_data =1; if(!context->waiting_sent) ws_app_send_packet(context); //send fisrt pkt } } else if(strstr(str,WS_APP_STREAM_STOP)==str){ NODE_DBG("\trequest stream stop"); context->stream_data=0; } os_free(str); return HTTP_WS_CGI_MORE; } void ICACHE_FLASH_ATTR init_ws_server(){ NODE_DBG("Webscoket app init"); //ws http_ws_server_init(ws_app_client_connected,ws_app_client_disconnected,ws_app_msg_received,ws_app_msg_sent); http_ws_server_start(); } ================================================ FILE: app/http/ws_app.h ================================================ #ifndef __WS_APP_H #define __WS_APP_H #endif ================================================ FILE: app/include/arch/cc.h ================================================ /* * 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 "c_types.h" #include "ets_sys.h" #include "osapi.h" #define EFAULT 14 //#define LWIP_PROVIDE_ERRNO #if (1) #define BYTE_ORDER LITTLE_ENDIAN #else #define BYTE_ORDER BIG_ENDIAN #endif typedef unsigned char u8_t; typedef signed char s8_t; typedef unsigned short u16_t; typedef signed short s16_t; typedef unsigned long u32_t; typedef signed long s32_t; typedef unsigned long mem_ptr_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 __attribute__((packed)) #define PACK_STRUCT_FIELD(x) x #define PACK_STRUCT_STRUCT __attribute__((packed)) #define PACK_STRUCT_BEGIN #define PACK_STRUCT_END //#define LWIP_DEBUG #ifdef LWIP_DEBUG #define LWIP_PLATFORM_DIAG(x) os_printf x #define LWIP_PLATFORM_ASSERT(x) ETS_ASSERT(x) #else #define LWIP_PLATFORM_DIAG(x) #define LWIP_PLATFORM_ASSERT(x) #endif #define SYS_ARCH_DECL_PROTECT(x) #define SYS_ARCH_PROTECT(x) #define SYS_ARCH_UNPROTECT(x) #define LWIP_PLATFORM_BYTESWAP 1 #define LWIP_PLATFORM_HTONS(_n) ((u16_t)((((_n) & 0xff) << 8) | (((_n) >> 8) & 0xff))) #define LWIP_PLATFORM_HTONL(_n) ((u32_t)( (((_n) & 0xff) << 24) | (((_n) & 0xff00) << 8) | (((_n) >> 8) & 0xff00) | (((_n) >> 24) & 0xff) )) #if LWIP_RAW extern u8_t memp_memory_RAW_PCB_base[]; #endif /* LWIP_RAW */ #if LWIP_UDP extern u8_t memp_memory_UDP_PCB_base[]; #endif /* LWIP_UDP */ #if LWIP_TCP extern u8_t memp_memory_TCP_PCB_base[]; extern u8_t memp_memory_TCP_PCB_LISTEN_base[]; extern u8_t memp_memory_TCP_SEG_base[] SHMEM_ATTR; #endif /* LWIP_TCP */ #if (!NO_SYS || (NO_SYS && !NO_SYS_NO_TIMERS)) /* LWIP_TIMERS */ extern u8_t memp_memory_SYS_TIMEOUT_base[]; #endif /* LWIP_TIMERS */ extern u8_t memp_memory_PBUF_base[]; extern u8_t memp_memory_PBUF_POOL_base[]; #endif /* __ARCH_CC_H__ */ ================================================ FILE: app/include/arch/perf.h ================================================ /* * 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__ */ ================================================ FILE: app/include/arch/sys_arch.h ================================================ ================================================ FILE: app/include/driver/gpio16.h ================================================ #ifndef __GPIO16_H__ #define __GPIO16_H__ void gpio16_output_conf(void); void gpio16_output_set(uint8 value); void gpio16_input_conf(void); uint8 gpio16_input_get(void); #endif ================================================ FILE: app/include/driver/i2c_master.h ================================================ #ifndef __I2C_MASTER_H__ #define __I2C_MASTER_H__ #define I2C_MASTER_SDA_MUX (pin_mux[sda]) #define I2C_MASTER_SCL_MUX (pin_mux[scl]) #define I2C_MASTER_SDA_GPIO (pinSDA) #define I2C_MASTER_SCL_GPIO (pinSCL) #define I2C_MASTER_SDA_FUNC (pin_func[sda]) #define I2C_MASTER_SCL_FUNC (pin_func[scl]) // #define I2C_MASTER_SDA_MUX PERIPHS_IO_MUX_GPIO2_U // #define I2C_MASTER_SCL_MUX PERIPHS_IO_MUX_MTDO_U // #define I2C_MASTER_SDA_GPIO 2 // #define I2C_MASTER_SCL_GPIO 15 // #define I2C_MASTER_SDA_FUNC FUNC_GPIO2 // #define I2C_MASTER_SCL_FUNC FUNC_GPIO15 // #define I2C_MASTER_SDA_MUX PERIPHS_IO_MUX_GPIO2_U // #define I2C_MASTER_SCL_MUX PERIPHS_IO_MUX_MTMS_U // #define I2C_MASTER_SDA_GPIO 2 // #define I2C_MASTER_SCL_GPIO 14 // #define I2C_MASTER_SDA_FUNC FUNC_GPIO2 // #define I2C_MASTER_SCL_FUNC FUNC_GPIO14 //#define I2C_MASTER_SDA_MUX PERIPHS_IO_MUX_GPIO2_U //#define I2C_MASTER_SCL_MUX PERIPHS_IO_MUX_GPIO0_U //#define I2C_MASTER_SDA_GPIO 2 //#define I2C_MASTER_SCL_GPIO 0 //#define I2C_MASTER_SDA_FUNC FUNC_GPIO2 //#define I2C_MASTER_SCL_FUNC FUNC_GPIO0 #if 0 #define I2C_MASTER_GPIO_SET(pin) \ gpio_output_set(1<. */ /* * Copyright (c) 2010 - 2011 Espressif System * */ #ifndef UART_REGISTER_H_ #define UART_REGISTER_H_ #define REG_UART_BASE(i) (0x60000000 + (i)*0xf00) //version value:32'h062000 #define UART_FIFO(i) (REG_UART_BASE(i) + 0x0) #define UART_RXFIFO_RD_BYTE 0x000000FF #define UART_RXFIFO_RD_BYTE_S 0 #define UART_INT_RAW(i) (REG_UART_BASE(i) + 0x4) #define UART_RXFIFO_TOUT_INT_RAW (BIT(8)) #define UART_BRK_DET_INT_RAW (BIT(7)) #define UART_CTS_CHG_INT_RAW (BIT(6)) #define UART_DSR_CHG_INT_RAW (BIT(5)) #define UART_RXFIFO_OVF_INT_RAW (BIT(4)) #define UART_FRM_ERR_INT_RAW (BIT(3)) #define UART_PARITY_ERR_INT_RAW (BIT(2)) #define UART_TXFIFO_EMPTY_INT_RAW (BIT(1)) #define UART_RXFIFO_FULL_INT_RAW (BIT(0)) #define UART_INT_ST(i) (REG_UART_BASE(i) + 0x8) #define UART_RXFIFO_TOUT_INT_ST (BIT(8)) #define UART_BRK_DET_INT_ST (BIT(7)) #define UART_CTS_CHG_INT_ST (BIT(6)) #define UART_DSR_CHG_INT_ST (BIT(5)) #define UART_RXFIFO_OVF_INT_ST (BIT(4)) #define UART_FRM_ERR_INT_ST (BIT(3)) #define UART_PARITY_ERR_INT_ST (BIT(2)) #define UART_TXFIFO_EMPTY_INT_ST (BIT(1)) #define UART_RXFIFO_FULL_INT_ST (BIT(0)) #define UART_INT_ENA(i) (REG_UART_BASE(i) + 0xC) #define UART_RXFIFO_TOUT_INT_ENA (BIT(8)) #define UART_BRK_DET_INT_ENA (BIT(7)) #define UART_CTS_CHG_INT_ENA (BIT(6)) #define UART_DSR_CHG_INT_ENA (BIT(5)) #define UART_RXFIFO_OVF_INT_ENA (BIT(4)) #define UART_FRM_ERR_INT_ENA (BIT(3)) #define UART_PARITY_ERR_INT_ENA (BIT(2)) #define UART_TXFIFO_EMPTY_INT_ENA (BIT(1)) #define UART_RXFIFO_FULL_INT_ENA (BIT(0)) #define UART_INT_CLR(i) (REG_UART_BASE(i) + 0x10) #define UART_RXFIFO_TOUT_INT_CLR (BIT(8)) #define UART_BRK_DET_INT_CLR (BIT(7)) #define UART_CTS_CHG_INT_CLR (BIT(6)) #define UART_DSR_CHG_INT_CLR (BIT(5)) #define UART_RXFIFO_OVF_INT_CLR (BIT(4)) #define UART_FRM_ERR_INT_CLR (BIT(3)) #define UART_PARITY_ERR_INT_CLR (BIT(2)) #define UART_TXFIFO_EMPTY_INT_CLR (BIT(1)) #define UART_RXFIFO_FULL_INT_CLR (BIT(0)) #define UART_CLKDIV(i) (REG_UART_BASE(i) + 0x14) #define UART_CLKDIV_CNT 0x000FFFFF #define UART_CLKDIV_S 0 #define UART_AUTOBAUD(i) (REG_UART_BASE(i) + 0x18) #define UART_GLITCH_FILT 0x000000FF #define UART_GLITCH_FILT_S 8 #define UART_AUTOBAUD_EN (BIT(0)) #define UART_STATUS(i) (REG_UART_BASE(i) + 0x1C) #define UART_TXD (BIT(31)) #define UART_RTSN (BIT(30)) #define UART_DTRN (BIT(29)) #define UART_TXFIFO_CNT 0x000000FF #define UART_TXFIFO_CNT_S 16 #define UART_RXD (BIT(15)) #define UART_CTSN (BIT(14)) #define UART_DSRN (BIT(13)) #define UART_RXFIFO_CNT 0x000000FF #define UART_RXFIFO_CNT_S 0 #define UART_CONF0(i) (REG_UART_BASE(i) + 0x20) #define UART_DTR_INV (BIT(24)) #define UART_RTS_INV (BIT(23)) #define UART_TXD_INV (BIT(22)) #define UART_DSR_INV (BIT(21)) #define UART_CTS_INV (BIT(20)) #define UART_RXD_INV (BIT(19)) #define UART_TXFIFO_RST (BIT(18)) #define UART_RXFIFO_RST (BIT(17)) #define UART_IRDA_EN (BIT(16)) #define UART_TX_FLOW_EN (BIT(15)) #define UART_LOOPBACK (BIT(14)) #define UART_IRDA_RX_INV (BIT(13)) #define UART_IRDA_TX_INV (BIT(12)) #define UART_IRDA_WCTL (BIT(11)) #define UART_IRDA_TX_EN (BIT(10)) #define UART_IRDA_DPLX (BIT(9)) #define UART_TXD_BRK (BIT(8)) #define UART_SW_DTR (BIT(7)) #define UART_SW_RTS (BIT(6)) #define UART_STOP_BIT_NUM 0x00000003 #define UART_STOP_BIT_NUM_S 4 #define UART_BIT_NUM 0x00000003 #define UART_BIT_NUM_S 2 #define UART_PARITY_EN (BIT(1)) #define UART_PARITY_EN_M 0x00000001 #define UART_PARITY_EN_S 1 #define UART_PARITY (BIT(0)) #define UART_PARITY_M 0x00000001 #define UART_PARITY_S 0 #define UART_CONF1(i) (REG_UART_BASE(i) + 0x24) #define UART_RX_TOUT_EN (BIT(31)) #define UART_RX_TOUT_THRHD 0x0000007F #define UART_RX_TOUT_THRHD_S 24 #define UART_RX_FLOW_EN (BIT(23)) #define UART_RX_FLOW_THRHD 0x0000007F #define UART_RX_FLOW_THRHD_S 16 #define UART_TXFIFO_EMPTY_THRHD 0x0000007F #define UART_TXFIFO_EMPTY_THRHD_S 8 #define UART_RXFIFO_FULL_THRHD 0x0000007F #define UART_RXFIFO_FULL_THRHD_S 0 #define UART_LOWPULSE(i) (REG_UART_BASE(i) + 0x28) #define UART_LOWPULSE_MIN_CNT 0x000FFFFF #define UART_LOWPULSE_MIN_CNT_S 0 #define UART_HIGHPULSE(i) (REG_UART_BASE(i) + 0x2C) #define UART_HIGHPULSE_MIN_CNT 0x000FFFFF #define UART_HIGHPULSE_MIN_CNT_S 0 #define UART_PULSE_NUM(i) (REG_UART_BASE(i) + 0x30) #define UART_PULSE_NUM_CNT 0x0003FF #define UART_PULSE_NUM_CNT_S 0 #define UART_DATE(i) (REG_UART_BASE(i) + 0x78) #define UART_ID(i) (REG_UART_BASE(i) + 0x7C) #endif // UART_REGISTER_H_INCLUDED ================================================ FILE: app/include/json/cJson.h ================================================ /* Copyright (c) 2009 Dave Gamble 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 cJSON__h #define cJSON__h #ifdef __cplusplus extern "C" { #endif /* cJSON Types: */ #define cJSON_False 0 #define cJSON_True 1 #define cJSON_NULL 2 #define cJSON_Number 3 #define cJSON_String 4 #define cJSON_Array 5 #define cJSON_Object 6 #define cJSON_IsReference 256 /* The cJSON structure: */ typedef struct cJSON { struct cJSON *next, *prev; /* next/prev allow you to walk array/object chains. Alternatively, use GetArraySize/GetArrayItem/GetObjectItem */ struct cJSON *child; /* An array or object item will have a child pointer pointing to a chain of the items in the array/object. */ int type; /* The type of the item, as above. */ char *valuestring; /* The item's string, if type==cJSON_String */ int valueint; /* The item's number, if type==cJSON_Number */ double valuedouble; /* The item's number, if type==cJSON_Number */ char *string; /* The item's name string, if this item is the child of, or is in the list of subitems of an object. */ } cJSON; /* Supply a block of JSON, and this returns a cJSON object you can interrogate. Call cJSON_Delete when finished. */ cJSON *cJSON_Parse(const char *value); /* Render a cJSON entity to text for transfer/storage. Free the char* when finished. */ char *cJSON_Print(cJSON *item); /* Render a cJSON entity to text for transfer/storage without any formatting. Free the char* when finished. */ char *cJSON_PrintUnformatted(cJSON *item); /* Delete a cJSON entity and all subentities. */ void cJSON_Delete(cJSON *c); /* Returns the number of items in an array (or object). */ int cJSON_GetArraySize(cJSON *array); /* Retrieve item number "item" from array "array". Returns NULL if unsuccessful. */ cJSON *cJSON_GetArrayItem(cJSON *array, int item); /* Get item "string" from object. Case insensitive. */ cJSON *cJSON_GetObjectItem(cJSON *object, const char *string); /* For analysing failed parses. This returns a pointer to the parse error. You'll probably need to look a few chars back to make sense of it. Defined when cJSON_Parse() returns 0. 0 when cJSON_Parse() succeeds. */ const char *cJSON_GetErrorPtr(void); /* These calls create a cJSON item of the appropriate type. */ cJSON *cJSON_CreateNull(void); cJSON *cJSON_CreateTrue(void); cJSON *cJSON_CreateFalse(void); cJSON *cJSON_CreateBool(int b); cJSON *cJSON_CreateNumber(double num); cJSON *cJSON_CreateString(const char *string); cJSON *cJSON_CreateArray(void); cJSON *cJSON_CreateObject(void); /* These utilities create an Array of count items. */ cJSON *cJSON_CreateIntArray(const int *numbers, int count); cJSON *cJSON_CreateFloatArray(const float *numbers, int count); cJSON *cJSON_CreateDoubleArray(const double *numbers, int count); cJSON *cJSON_CreateStringArray(const char **strings, int count); /* Append item to the specified array/object. */ void cJSON_AddItemToArray(cJSON *array, cJSON *item); void cJSON_AddItemToObject(cJSON *object, const char *string, cJSON *item); /* Append reference to item to the specified array/object. Use this when you want to add an existing cJSON to a new cJSON, but don't want to corrupt your existing cJSON. */ void cJSON_AddItemReferenceToArray(cJSON *array, cJSON *item); void cJSON_AddItemReferenceToObject(cJSON *object, const char *string, cJSON *item); /* Remove/Detatch items from Arrays/Objects. */ cJSON *cJSON_DetachItemFromArray(cJSON *array, int which); void cJSON_DeleteItemFromArray(cJSON *array, int which); cJSON *cJSON_DetachItemFromObject(cJSON *object, const char *string); void cJSON_DeleteItemFromObject(cJSON *object, const char *string); /* Update array items. */ void cJSON_ReplaceItemInArray(cJSON *array, int which, cJSON *newitem); void cJSON_ReplaceItemInObject(cJSON *object, const char *string, cJSON *newitem); /* Duplicate a cJSON item */ cJSON *cJSON_Duplicate(cJSON *item, int recurse); /* Duplicate will create a new, identical cJSON item to the one you pass, in new memory that will need to be released. With recurse!=0, it will duplicate any children connected to the item. The item->next and ->prev pointers are always zero on return from Duplicate. */ /* ParseWithOpts allows you to require (and check) that the JSON is null terminated, and to retrieve the pointer to the final byte parsed. */ cJSON *cJSON_ParseWithOpts(const char *value, const char **return_parse_end, int require_null_terminated); void cJSON_Minify(char *json); /* Macros for creating things quickly. */ #define cJSON_AddNullToObject(object,name) cJSON_AddItemToObject(object, name, cJSON_CreateNull()) #define cJSON_AddTrueToObject(object,name) cJSON_AddItemToObject(object, name, cJSON_CreateTrue()) #define cJSON_AddFalseToObject(object,name) cJSON_AddItemToObject(object, name, cJSON_CreateFalse()) #define cJSON_AddBoolToObject(object,name,b) cJSON_AddItemToObject(object, name, cJSON_CreateBool(b)) #define cJSON_AddNumberToObject(object,name,n) cJSON_AddItemToObject(object, name, cJSON_CreateNumber(n)) #define cJSON_AddStringToObject(object,name,s) cJSON_AddItemToObject(object, name, cJSON_CreateString(s)) /* When assigning an integer value, it needs to be propagated to valuedouble too. */ #define cJSON_SetIntValue(object,val) ((object)?(object)->valueint=(object)->valuedouble=(val):(val)) #ifdef __cplusplus } #endif #endif ================================================ FILE: app/include/lwip/api.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_API_H__ #define __LWIP_API_H__ #include "lwip/opt.h" #if LWIP_NETCONN /* don't build if not configured for use in lwipopts.h */ #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) */ /** TCP: when data passed to netconn_write doesn't fit into the send buffer, this temporarily stores whether to wake up the original application task if data couldn't be sent in the first try. */ #define NETCONN_FLAG_WRITE_DELAYED 0x01 /** 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 /* Helpers to process several netconn_types by the same code */ #define NETCONNTYPE_GROUP(t) (t&0xF0) #define NETCONNTYPE_DATAGRAM(t) (t&0xE0) /** Protocol family and type of the netconn */ enum netconn_type { NETCONN_INVALID = 0, /* NETCONN_TCP Group */ NETCONN_TCP = 0x10, /* NETCONN_UDP Group */ NETCONN_UDP = 0x20, NETCONN_UDPLITE = 0x21, NETCONN_UDPNOCHKSUM= 0x22, /* NETCONN_RAW Group */ NETCONN_RAW = 0x40 }; /** 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 /** Used for netconn_join_leave_group() */ enum netconn_igmp { NETCONN_JOIN, NETCONN_LEAVE }; #endif /* LWIP_IGMP */ /* 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; /** sem that is used to synchroneously execute functions in the core context */ sys_sem_t op_completed; /** 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_RCVTIMEO /** timeout 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 */ s16_t recv_avail; #endif /* LWIP_SO_RCVBUF */ /** 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 { \ SYS_ARCH_DECL_PROTECT(lev); \ SYS_ARCH_PROTECT(lev); \ if (!ERR_IS_FATAL((conn)->last_err)) { \ (conn)->last_err = err; \ } \ SYS_ARCH_UNPROTECT(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, ip_addr_t *addr, u16_t port); err_t netconn_connect(struct netconn *conn, 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, ip_addr_t *addr, u16_t port); err_t netconn_send(struct netconn *conn, struct netbuf *buf); err_t netconn_write(struct netconn *conn, const void *dataptr, size_t size, u8_t apiflags); 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 err_t netconn_join_leave_group(struct netconn *conn, ip_addr_t *multiaddr, ip_addr_t *netif_addr, enum netconn_igmp join_or_leave); #endif /* LWIP_IGMP */ #if LWIP_DNS err_t netconn_gethostbyname(const char *name, ip_addr_t *addr); #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_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*/ #ifdef __cplusplus } #endif #endif /* LWIP_NETCONN */ #endif /* __LWIP_API_H__ */ ================================================ FILE: app/include/lwip/api_msg.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_API_MSG_H__ #define __LWIP_API_MSG_H__ #include "lwip/opt.h" #if LWIP_NETCONN /* 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/sys.h" #include "lwip/igmp.h" #include "lwip/api.h" #ifdef __cplusplus extern "C" { #endif /* 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 do_send */ struct netbuf *b; /** used for do_newconn */ struct { u8_t proto; } n; /** used for do_bind and do_connect */ struct { ip_addr_t *ipaddr; u16_t port; } bc; /** used for do_getaddr */ struct { ip_addr_t *ipaddr; u16_t *port; u8_t local; } ad; /** used for do_write */ struct { const void *dataptr; size_t len; u8_t apiflags; } w; /** used for do_recv */ struct { u32_t len; } r; /** used for do_close (/shutdown) */ struct { u8_t shut; } sd; #if LWIP_IGMP /** used for do_join_leave_group */ struct { ip_addr_t *multiaddr; ip_addr_t *netif_addr; enum netconn_igmp join_or_leave; } jl; #endif /* LWIP_IGMP */ #if TCP_LISTEN_BACKLOG struct { u8_t backlog; } lb; #endif /* TCP_LISTEN_BACKLOG */ } msg; }; /** 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)(struct api_msg_msg *msg); /** arguments for this function */ struct api_msg_msg msg; }; #if LWIP_DNS /** As 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). 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 */ const char *name; /** Rhe resolved address is stored here */ ip_addr_t *addr; /** This semaphore is posted when the name is resolved, the application thread should wait on it. */ sys_sem_t *sem; /** Errors are given back here */ err_t *err; }; #endif /* LWIP_DNS */ void do_newconn ( struct api_msg_msg *msg); void do_delconn ( struct api_msg_msg *msg); void do_bind ( struct api_msg_msg *msg); void do_connect ( struct api_msg_msg *msg); void do_disconnect ( struct api_msg_msg *msg); void do_listen ( struct api_msg_msg *msg); void do_send ( struct api_msg_msg *msg); void do_recv ( struct api_msg_msg *msg); void do_write ( struct api_msg_msg *msg); void do_getaddr ( struct api_msg_msg *msg); void do_close ( struct api_msg_msg *msg); void do_shutdown ( struct api_msg_msg *msg); #if LWIP_IGMP void do_join_leave_group( struct api_msg_msg *msg); #endif /* LWIP_IGMP */ #if LWIP_DNS void 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 */ #endif /* __LWIP_API_MSG_H__ */ ================================================ FILE: app/include/lwip/app/dhcpserver.h ================================================ #ifndef __DHCPS_H__ #define __DHCPS_H__ #define USE_DNS typedef struct dhcps_state{ sint16_t state; } dhcps_state; // ����dhcpclient�Զ����һ��DHCP msg�ṹ�� typedef struct dhcps_msg { uint8_t op, htype, hlen, hops; uint8_t xid[4]; uint16_t secs, flags; uint8_t ciaddr[4]; uint8_t yiaddr[4]; uint8_t siaddr[4]; uint8_t giaddr[4]; uint8_t chaddr[16]; uint8_t sname[64]; uint8_t file[128]; uint8_t options[312]; }dhcps_msg; #ifndef LWIP_OPEN_SRC struct dhcps_lease { bool enable; struct ip_addr start_ip; struct ip_addr end_ip; }; enum dhcps_offer_option{ OFFER_START = 0x00, OFFER_ROUTER = 0x01, OFFER_END }; #endif struct dhcps_pool{ struct ip_addr ip; uint8 mac[6]; uint32 lease_timer; }; typedef struct _list_node{ void *pnode; struct _list_node *pnext; }list_node; extern uint32 dhcps_lease_time; #define DHCPS_LEASE_TIMER dhcps_lease_time //0x05A0 #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 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 #define dhcps_router_enabled(offer) ((offer & OFFER_ROUTER) != 0) void dhcps_start(struct ip_info *info); void dhcps_stop(void); #endif ================================================ FILE: app/include/lwip/app/espconn.h ================================================ #ifndef __ESPCONN_H__ #define __ESPCONN_H__ #include "lwip/dns.h" #include "os_type.h" #if 0 #define espconn_printf(fmt, args...) os_printf(fmt,## args) #else #define espconn_printf(fmt, args...) #endif typedef void *espconn_handle; typedef void (* espconn_connect_callback)(void *arg); typedef void (* espconn_reconnect_callback)(void *arg, sint8 err); /* Definitions for error constants. */ #define ESPCONN_OK 0 /* No error, everything OK. */ #define ESPCONN_MEM -1 /* Out of memory error. */ #define ESPCONN_TIMEOUT -3 /* Timeout. */ #define ESPCONN_RTE -4 /* Routing problem. */ #define ESPCONN_INPROGRESS -5 /* Operation in progress */ #define ESPCONN_MAXNUM -7 /* Total number exceeds the set maximum*/ #define ESPCONN_ABRT -8 /* Connection aborted. */ #define ESPCONN_RST -9 /* Connection reset. */ #define ESPCONN_CLSD -10 /* Connection closed. */ #define ESPCONN_CONN -11 /* Not connected. */ #define ESPCONN_ARG -12 /* Illegal argument. */ #define ESPCONN_IF -14 /* Low_level error */ #define ESPCONN_ISCONN -15 /* Already connected. */ #define ESPCONN_HANDSHAKE -28 /* ssl handshake failed */ #define ESPCONN_RESP_TIMEOUT -29 /* ssl handshake no response*/ #define ESPCONN_PROTO_MSG -61 /* ssl application invalid */ #define ESPCONN_SSL 0x01 #define ESPCONN_NORM 0x00 #define ESPCONN_STA 0x01 #define ESPCONN_AP 0x02 #define ESPCONN_AP_STA 0x03 #define STA_NETIF 0x00 #define AP_NETIF 0x01 /** Protocol family and type of the espconn */ enum espconn_type { ESPCONN_INVALID = 0, /* ESPCONN_TCP Group */ ESPCONN_TCP = 0x10, /* ESPCONN_UDP Group */ ESPCONN_UDP = 0x20, }; /** Current state of the espconn. Non-TCP espconn are always in state ESPCONN_NONE! */ enum espconn_state { ESPCONN_NONE, ESPCONN_WAIT, ESPCONN_LISTEN, ESPCONN_CONNECT, ESPCONN_WRITE, ESPCONN_READ, ESPCONN_CLOSE }; typedef struct _esp_tcp { int remote_port; int local_port; uint8 local_ip[4]; uint8 remote_ip[4]; espconn_connect_callback connect_callback; espconn_reconnect_callback reconnect_callback; espconn_connect_callback disconnect_callback; espconn_connect_callback write_finish_fn; } esp_tcp; typedef struct _esp_udp { int remote_port; int local_port; uint8 local_ip[4]; uint8 remote_ip[4]; } esp_udp; typedef struct _remot_info{ enum espconn_state state; int remote_port; uint8 remote_ip[4]; }remot_info; /** A callback prototype to inform about events for a espconn */ typedef void (* espconn_recv_callback)(void *arg, char *pdata, unsigned short len); typedef void (* espconn_sent_callback)(void *arg); /** A espconn descriptor */ struct espconn { /** type of the espconn (TCP, UDP) */ enum espconn_type type; /** current state of the espconn */ enum espconn_state state; union { esp_tcp *tcp; esp_udp *udp; } proto; /** A callback function that is informed about events for this espconn */ espconn_recv_callback recv_callback; espconn_sent_callback sent_callback; uint8 link_cnt; void *reverse; }; enum espconn_option{ ESPCONN_START = 0x00, ESPCONN_REUSEADDR = 0x01, ESPCONN_NODELAY = 0x02, ESPCONN_COPY = 0x04, ESPCONN_KEEPALIVE = 0x08, ESPCONN_END }; enum espconn_level{ ESPCONN_KEEPIDLE, ESPCONN_KEEPINTVL, ESPCONN_KEEPCNT }; struct espconn_packet{ uint16 sent_length; /* sent length successful*/ uint16 snd_buf_size; /* Available buffer size for sending */ uint16 snd_queuelen; /* Available buffer space for sending */ uint16 total_queuelen; /* total Available buffer space for sending */ uint32 packseqno; /* seqno to be sent */ uint32 packseq_nxt; /* seqno expected */ uint32 packnum; }; typedef struct _espconn_buf{ uint8 *payload; uint8 *punsent; uint16 unsent; uint16 len; uint16 tot_len; struct _espconn_buf *pnext; } espconn_buf; typedef struct _comon_pkt{ void *pcb; int remote_port; uint8 remote_ip[4]; uint32 local_port; uint32 local_ip; espconn_buf *pbuf; espconn_buf *ptail; uint8* ptrbuf; uint16 cntr; sint8 err; uint32 timeout; uint32 recv_check; uint8 pbuf_num; struct espconn_packet packet_info; bool write_flag; enum espconn_option espconn_opt; }comon_pkt; typedef struct _espconn_msg{ struct espconn *pespconn; comon_pkt pcommon; uint8 count_opt; sint16_t hs_status; //the status of the handshake void *preverse; void *pssl; struct _espconn_msg *pnext; //***********Code for WIFI_BLOCK from upper************** uint8 recv_hold_flag; uint16 recv_holded_buf_Len; }espconn_msg; #ifndef _MDNS_INFO #define _MDNS_INFO struct mdns_info { char *host_name; char *server_name; uint16 server_port; unsigned long ipAddr; char *txt_data[10]; }; #endif #define linkMax 15 #define espconn_delay_disabled(espconn) (((espconn)->pcommon.espconn_opt & ESPCONN_NODELAY) != 0) #define espconn_delay_enabled(espconn) (((espconn)->pcommon.espconn_opt & ESPCONN_NODELAY) == 0) #define espconn_reuse_disabled(espconn) (((espconn)->pcommon.espconn_opt & ESPCONN_REUSEADDR) != 0) #define espconn_copy_disabled(espconn) (((espconn)->pcommon.espconn_opt & ESPCONN_COPY) != 0) #define espconn_copy_enabled(espconn) (((espconn)->pcommon.espconn_opt & ESPCONN_COPY) == 0) #define espconn_keepalive_disabled(espconn) (((espconn)->pcommon.espconn_opt & ESPCONN_KEEPALIVE) != 0) #define espconn_keepalive_enabled(espconn) (((espconn)->pcommon.espconn_opt & ESPCONN_KEEPALIVE) == 0) #define espconn_TaskPrio 26 #define espconn_TaskQueueLen 15 enum espconn_sig { SIG_ESPCONN_NONE, SIG_ESPCONN_ERRER, SIG_ESPCONN_LISTEN, SIG_ESPCONN_CONNECT, SIG_ESPCONN_WRITE, SIG_ESPCONN_SEND, SIG_ESPCONN_READ, SIG_ESPCONN_CLOSE }; /****************************************************************************** * FunctionName : espconn_copy_partial * Description : reconnect with host * Parameters : arg -- Additional argument to pass to the callback function * Returns : none *******************************************************************************/ void espconn_copy_partial(struct espconn *pesp_dest, struct espconn *pesp_source); /****************************************************************************** * FunctionName : espconn_copy_partial * Description : insert the node to the active connection list * Parameters : arg -- Additional argument to pass to the callback function * Returns : none *******************************************************************************/ void espconn_list_creat(espconn_msg **phead, espconn_msg* pinsert); /****************************************************************************** * FunctionName : espconn_list_delete * Description : remove the node from the active connection list * Parameters : arg -- Additional argument to pass to the callback function * Returns : none *******************************************************************************/ void espconn_list_delete(espconn_msg **phead, espconn_msg* pdelete); /****************************************************************************** * FunctionName : espconn_find_connection * Description : Initialize the server: set up a listening PCB and bind it to * the defined port * Parameters : espconn -- the espconn used to build server * Returns : none *******************************************************************************/ bool espconn_find_connection(struct espconn *pespconn, espconn_msg **pnode); /****************************************************************************** * FunctionName : espconn_get_connection_info * Description : used to specify the function that should be called when disconnect * Parameters : espconn -- espconn to set the err callback * discon_cb -- err callback function to call when err * Returns : none *******************************************************************************/ sint8 espconn_get_connection_info(struct espconn *pespconn, remot_info **pcon_info, uint8 typeflags); /****************************************************************************** * FunctionName : espconn_get_packet_info * Description : get the packet info with host * Parameters : espconn -- the espconn used to disconnect the connection * infoarg -- the packet info * Returns : the errur code *******************************************************************************/ sint8 espconn_get_packet_info(struct espconn *espconn, struct espconn_packet* infoarg); /****************************************************************************** * FunctionName : espconn_connect * Description : The function given as the connect * Parameters : espconn -- the espconn used to listen the connection * Returns : none *******************************************************************************/ extern sint8 espconn_connect(struct espconn *espconn); /****************************************************************************** * FunctionName : espconn_disconnect * Description : disconnect with host * Parameters : espconn -- the espconn used to disconnect the connection * Returns : none *******************************************************************************/ extern sint8 espconn_disconnect(struct espconn *espconn); /****************************************************************************** * FunctionName : espconn_delete * Description : disconnect with host * Parameters : espconn -- the espconn used to disconnect the connection * Returns : none *******************************************************************************/ extern sint8 espconn_delete(struct espconn *espconn); /****************************************************************************** * FunctionName : espconn_accept * Description : The function given as the listen * Parameters : espconn -- the espconn used to listen the connection * Returns : none *******************************************************************************/ extern sint8 espconn_accept(struct espconn *espconn); /****************************************************************************** * FunctionName : espconn_create * Description : sent data for client or server * Parameters : espconn -- espconn to the data transmission * Returns : result *******************************************************************************/ extern sint8 espconn_create(struct espconn *espconn); /****************************************************************************** * FunctionName : espconn_tcp_get_wnd * Description : get the window size of simulatenously active TCP connections * Parameters : none * Returns : the number of TCP_MSS active TCP connections *******************************************************************************/ extern uint8 espconn_tcp_get_wnd(void); /****************************************************************************** * FunctionName : espconn_tcp_set_max_con * Description : set the window size simulatenously active TCP connections * Parameters : num -- the number of TCP_MSS * Returns : ESPCONN_ARG -- Illegal argument * ESPCONN_OK -- No error *******************************************************************************/ extern sint8 espconn_tcp_set_wnd(uint8 num); /****************************************************************************** * FunctionName : espconn_tcp_get_max_con * Description : get the number of simulatenously active TCP connections * Parameters : none * Returns : none *******************************************************************************/ extern uint8 espconn_tcp_get_max_con(void); /****************************************************************************** * FunctionName : espconn_tcp_set_max_con * Description : set the number of simulatenously active TCP connections * Parameters : num -- total number * Returns : none *******************************************************************************/ extern sint8 espconn_tcp_set_max_con(uint8 num); /****************************************************************************** * FunctionName : espconn_tcp_get_max_retran * Description : get the Maximum number of retransmissions of data active TCP connections * Parameters : none * Returns : the Maximum number of retransmissions *******************************************************************************/ extern uint8 espconn_tcp_get_max_retran(void); /****************************************************************************** * FunctionName : espconn_tcp_set_max_retran * Description : set the Maximum number of retransmissions of data active TCP connections * Parameters : num -- the Maximum number of retransmissions * Returns : result *******************************************************************************/ extern sint8 espconn_tcp_set_max_retran(uint8 num); /****************************************************************************** * FunctionName : espconn_tcp_get_max_syn * Description : get the Maximum number of retransmissions of SYN segments * Parameters : none * Returns : the Maximum number of retransmissions *******************************************************************************/ extern uint8 espconn_tcp_get_max_syn(void); /****************************************************************************** * FunctionName : espconn_tcp_set_max_syn * Description : set the Maximum number of retransmissions of SYN segments * Parameters : num -- the Maximum number of retransmissions * Returns : result *******************************************************************************/ extern sint8 espconn_tcp_set_max_syn(uint8 num); /****************************************************************************** * FunctionName : espconn_tcp_get_max_con_allow * Description : get the count of simulatenously active connections on the server * Parameters : espconn -- espconn to get the count * Returns : result *******************************************************************************/ extern sint8 espconn_tcp_get_max_con_allow(struct espconn *espconn); /****************************************************************************** * FunctionName : espconn_tcp_set_max_con_allow * Description : set the count of simulatenously active connections on the server * Parameters : espconn -- espconn to set the count * Returns : result *******************************************************************************/ extern sint8 espconn_tcp_set_max_con_allow(struct espconn *espconn, uint8 num); /****************************************************************************** * FunctionName : espconn_tcp_set_buf_count * Description : set the total number of espconn_buf on the unsent lists * Parameters : espconn -- espconn to set the count * num -- the total number of espconn_buf * Returns : result *******************************************************************************/ extern sint8 espconn_tcp_set_buf_count(struct espconn *espconn, uint8 num); /****************************************************************************** * FunctionName : espconn_regist_time * Description : used to specify the time that should be called when don't recv data * Parameters : espconn -- the espconn used to the connection * interval -- the timer when don't recv data * Returns : none *******************************************************************************/ extern sint8 espconn_regist_time(struct espconn *espconn, uint32 interval, uint8 type_flag); /****************************************************************************** * FunctionName : espconn_regist_sentcb * Description : Used to specify the function that should be called when data * has been successfully delivered to the remote host. * Parameters : struct espconn *espconn -- espconn to set the sent callback * espconn_sent_callback sent_cb -- sent callback function to * call for this espconn when data is successfully sent * Returns : none *******************************************************************************/ extern sint8 espconn_regist_sentcb(struct espconn *espconn, espconn_sent_callback sent_cb); /****************************************************************************** * FunctionName : espconn_regist_sentcb * Description : Used to specify the function that should be called when data * has been successfully delivered to the remote host. * Parameters : espconn -- espconn to set the sent callback * sent_cb -- sent callback function to call for this espconn * when data is successfully sent * Returns : none *******************************************************************************/ extern sint8 espconn_regist_write_finish(struct espconn *espconn, espconn_connect_callback write_finish_fn); /****************************************************************************** * FunctionName : espconn_sent * Description : sent data for client or server * Parameters : espconn -- espconn to set for client or server * psent -- data to send * length -- length of data to send * Returns : none *******************************************************************************/ extern sint8 espconn_sent(struct espconn *espconn, uint8 *psent, uint16 length); /****************************************************************************** * FunctionName : espconn_regist_connectcb * Description : used to specify the function that should be called when * connects to host. * Parameters : espconn -- espconn to set the connect callback * connect_cb -- connected callback function to call when connected * Returns : none *******************************************************************************/ extern sint8 espconn_regist_connectcb(struct espconn *espconn, espconn_connect_callback connect_cb); /****************************************************************************** * FunctionName : espconn_regist_recvcb * Description : used to specify the function that should be called when recv * data from host. * Parameters : espconn -- espconn to set the recv callback * recv_cb -- recv callback function to call when recv data * Returns : none *******************************************************************************/ extern sint8 espconn_regist_recvcb(struct espconn *espconn, espconn_recv_callback recv_cb); /****************************************************************************** * FunctionName : espconn_regist_reconcb * Description : used to specify the function that should be called when connection * because of err disconnect. * Parameters : espconn -- espconn to set the err callback * recon_cb -- err callback function to call when err * Returns : none *******************************************************************************/ extern sint8 espconn_regist_reconcb(struct espconn *espconn, espconn_reconnect_callback recon_cb); /****************************************************************************** * FunctionName : espconn_regist_disconcb * Description : used to specify the function that should be called when disconnect * Parameters : espconn -- espconn to set the err callback * discon_cb -- err callback function to call when err * Returns : none *******************************************************************************/ extern sint8 espconn_regist_disconcb(struct espconn *espconn, espconn_connect_callback discon_cb); /****************************************************************************** * FunctionName : espconn_port * Description : access port value for client so that we don't end up bouncing * all connections at the same time . * Parameters : none * Returns : access port value *******************************************************************************/ extern uint32 espconn_port(void); /****************************************************************************** * FunctionName : espconn_set_opt * Description : access port value for client so that we don't end up bouncing * all connections at the same time . * Parameters : none * Returns : access port value *******************************************************************************/ extern sint8 espconn_set_opt(struct espconn *espconn, uint8 opt); /****************************************************************************** * FunctionName : espconn_set_keepalive * Description : access level value for connection so that we set the value for * keep alive * Parameters : espconn -- the espconn used to set the connection * level -- the connection's level * value -- the value of time(s) * Returns : access port value *******************************************************************************/ extern sint8 espconn_set_keepalive(struct espconn *espconn, uint8 level, void* optarg); /****************************************************************************** * FunctionName : espconn_get_keepalive * Description : access level value for connection so that we get the value for * keep alive * Parameters : espconn -- the espconn used to get the connection * level -- the connection's level * Returns : access keep alive value *******************************************************************************/ extern sint8 espconn_get_keepalive(struct espconn *espconn, uint8 level, void *optarg); /****************************************************************************** * FunctionName : espconn_gethostbyname * Description : Resolve a hostname (string) into an IP address. * Parameters : pespconn -- espconn to resolve a hostname * hostname -- the hostname that is to be queried * addr -- pointer to a ip_addr_t where to store the address if * it is already cached in the dns_table (only valid if * ESPCONN_OK is returned!) * found -- a callback function to be called on success, failure * or timeout (only if ERR_INPROGRESS is returned!) * Returns : err_t return code * - ESPCONN_OK if hostname is a valid IP address string or the host * name is already in the local names table. * - ESPCONN_INPROGRESS enqueue a request to be sent to the DNS server * for resolution if no errors are present. * - ESPCONN_ARG: dns client not initialized or invalid hostname *******************************************************************************/ extern sint8 espconn_gethostbyname(struct espconn *pespconn, const char *name, ip_addr_t *addr, dns_found_callback found); /****************************************************************************** * FunctionName : espconn_igmp_join * Description : join a multicast group * Parameters : host_ip -- the ip address of udp server * multicast_ip -- multicast ip given by user * Returns : none *******************************************************************************/ extern sint8 espconn_igmp_join(ip_addr_t *host_ip, ip_addr_t *multicast_ip); /****************************************************************************** * FunctionName : espconn_igmp_leave * Description : leave a multicast group * Parameters : host_ip -- the ip address of udp server * multicast_ip -- multicast ip given by user * Returns : none *******************************************************************************/ extern sint8 espconn_igmp_leave(ip_addr_t *host_ip, ip_addr_t *multicast_ip); /****************************************************************************** * FunctionName : espconn_mdns_init * Description : register a device with mdns * Parameters : ipAddr -- the ip address of device * hostname -- the hostname of device * Returns : none *******************************************************************************/ extern void espconn_mdns_init(struct mdns_info *info); /****************************************************************************** * FunctionName : espconn_mdns_init * Description : close mdns socket * Parameters : void * Returns : none *******************************************************************************/ extern void espconn_mdns_close(void); /****************************************************************************** * FunctionName : mdns_server_register * Description : register a server and join a multicast group * Parameters : none * Returns : none *******************************************************************************/ extern void espconn_mdns_server_register(void); /****************************************************************************** * FunctionName : mdns_server_register * Description : unregister server and leave multicast group * Parameters : none * Returns : none *******************************************************************************/ extern void espconn_mdns_server_unregister(void); /****************************************************************************** * FunctionName : espconn_mdns_get_servername * Description : get server name * Parameters : none * Returns : server name *******************************************************************************/ extern char* espconn_mdns_get_servername(void); /****************************************************************************** * FunctionName : espconn_mdns_get_servername * Description : set server name * Parameters : server name * Returns : none *******************************************************************************/ extern void espconn_mdns_set_servername(const char *name); /****************************************************************************** * FunctionName : espconn_mdns_set_hostname * Description : set host name * Parameters : host name * Returns : none *******************************************************************************/ extern void espconn_mdns_set_hostname(char *name); /****************************************************************************** * FunctionName : espconn_mdns_init * Description : get host name * Parameters : void * Returns : hostname *******************************************************************************/ extern char* espconn_mdns_get_hostname(void); /****************************************************************************** * FunctionName : espconn_mdns_disable * Description : join a multicast group * Parameters : host_ip -- the ip address of udp server * multicast_ip -- multicast ip given by user * Returns : none *******************************************************************************/ extern void espconn_mdns_disable(void); /****************************************************************************** * FunctionName : espconn_mdns_enable * Description : enable mdns * Parameters : void * Returns : none *******************************************************************************/ extern void espconn_mdns_enable(void); /****************************************************************************** * FunctionName : espconn_dns_setserver * Description : Initialize one of the DNS servers. * Parameters : numdns -- the index of the DNS server to set must * be < DNS_MAX_SERVERS = 2 * dnsserver -- IP address of the DNS server to set * Returns : none *******************************************************************************/ extern void espconn_dns_setserver(u8_t numdns, ip_addr_t *dnsserver); #endif ================================================ FILE: app/include/lwip/app/espconn_tcp.h ================================================ #ifndef __ESPCONN_TCP_H__ #define __ESPCONN_TCP_H__ #ifndef ESPCONN_TCP_DEBUG #define ESPCONN_TCP_DEBUG LWIP_DBG_OFF #endif #include "lwip/app/espconn.h" #ifndef ESPCONN_TCP_TIMER #define ESPCONN_TCP_TIMER 40 #endif #define espconn_keepalive_enable(pcb) ((pcb)->so_options |= SOF_KEEPALIVE) #define espconn_keepalive_disable(pcb) ((pcb)->so_options &= ~SOF_KEEPALIVE) /****************************************************************************** * FunctionName : espconn_kill_oldest_pcb * Description : A oldest incoming connection has been killed. * Parameters : none * Returns : none *******************************************************************************/ extern void espconn_kill_oldest_pcb(void); /****************************************************************************** * FunctionName : espconn_tcp_disconnect * Description : A new incoming connection has been disconnected. * Parameters : espconn -- the espconn used to disconnect with host * Returns : none *******************************************************************************/ extern void espconn_tcp_disconnect(espconn_msg *pdiscon); /****************************************************************************** * FunctionName : espconn_tcp_client * Description : Initialize the client: set up a connect PCB and bind it to * the defined port * Parameters : espconn -- the espconn used to build client * Returns : none *******************************************************************************/ extern sint8 espconn_tcp_client(struct espconn* espconn); /****************************************************************************** * FunctionName : espconn_tcp_server * Description : Initialize the server: set up a listening PCB and bind it to * the defined port * Parameters : espconn -- the espconn used to build server * Returns : none *******************************************************************************/ extern sint8 espconn_tcp_server(struct espconn *espconn); #endif /* __CLIENT_TCP_H__ */ ================================================ FILE: app/include/lwip/app/espconn_udp.h ================================================ #ifndef __ESPCONN_UDP_H__ #define __ESPCONN_UDP_H__ #ifndef ESPCONN_UDP_DEBUG #define ESPCONN_UDP_DEBUG LWIP_DBG_OFF #endif #include "lwip/app/espconn.h" /****************************************************************************** * FunctionName : espconn_udp_client * Description : Initialize the client: set up a PCB and bind it to the port * Parameters : pespconn -- the espconn used to build client * Returns : none *******************************************************************************/ extern sint8 espconn_udp_client(struct espconn *pespconn); /****************************************************************************** * FunctionName : espconn_udp_disconnect * Description : A new incoming connection has been disconnected. * Parameters : espconn -- the espconn used to disconnect with host * Returns : none *******************************************************************************/ extern void espconn_udp_disconnect(espconn_msg *pdiscon); /****************************************************************************** * FunctionName : espconn_udp_server * Description : Initialize the server: set up a PCB and bind it to the port * Parameters : pespconn -- the espconn used to build server * Returns : none *******************************************************************************/ extern sint8 espconn_udp_server(struct espconn *espconn); /****************************************************************************** * FunctionName : espconn_udp_sent * Description : sent data for client or server * Parameters : void *arg -- client or server to send * uint8* psent -- Data to send * uint16 length -- Length of data to send * Returns : none *******************************************************************************/ extern err_t espconn_udp_sent(void *arg, uint8 *psent, uint16 length); /****************************************************************************** * FunctionName : espconn_udp_sendto * Description : sent data for UDP * Parameters : void *arg -- UDP to send * uint8* psent -- Data to send * uint16 length -- Length of data to send * Returns : return espconn error code. * - ESPCONN_OK. Successful. No error occured. * - ESPCONN_MEM. Out of memory. * - ESPCONN_RTE. Could not find route to destination address. * - More errors could be returned by lower protocol layers. *******************************************************************************/ extern err_t espconn_udp_sendto(void *arg, uint8 *psent, uint16 length); #endif /* __ESPCONN_UDP_H__ */ ================================================ FILE: app/include/lwip/app/ping.h ================================================ #ifndef __PING_H__ #define __PING_H__ #include "lwip/ip_addr.h" #include "lwip/icmp.h" /** * PING_USE_SOCKETS: Set to 1 to use sockets, otherwise the raw api is used */ #ifndef PING_USE_SOCKETS #define PING_USE_SOCKETS LWIP_SOCKET #endif /** * PING_DEBUG: Enable debugging for PING. */ #ifndef PING_DEBUG #define PING_DEBUG LWIP_DBG_OFF #endif /** ping receive timeout - in milliseconds */ #ifndef PING_RCV_TIMEO #define PING_RCV_TIMEO 1000 #endif /** ping delay - in milliseconds */ #ifndef PING_COARSE #define PING_COARSE 1000 #endif /** ping identifier - must fit on a u16_t */ #ifndef PING_ID #define PING_ID 0xAFAF #endif /** ping additional data size to include in the packet */ #ifndef PING_DATA_SIZE #define PING_DATA_SIZE 32 #endif /** ping result action - no default action */ #ifndef PING_RESULT #define PING_RESULT(ping_ok) #endif #define DEFAULT_PING_MAX_COUNT 4 #define PING_TIMEOUT_MS 1000 typedef void (* ping_recv_function)(void* arg, void *pdata); typedef void (* ping_sent_function)(void* arg, void *pdata); struct ping_option{ uint32 count; uint32 ip; uint32 coarse_time; ping_recv_function recv_function; ping_sent_function sent_function; void* reverse; }; struct ping_msg{ struct ping_option *ping_opt; struct raw_pcb *ping_pcb; uint32 ping_start; uint32 ping_sent; uint32 timeout_count; uint32 max_count; uint32 sent_count; uint32 coarse_time; }; struct ping_resp{ uint32 total_count; uint32 resp_time; uint32 seqno; uint32 timeout_count; uint32 bytes; uint32 total_bytes; uint32 total_time; sint8 ping_err; }; bool ping_start(struct ping_option *ping_opt); bool ping_regist_recv(struct ping_option *ping_opt, ping_recv_function ping_recv); bool ping_regist_sent(struct ping_option *ping_opt, ping_sent_function ping_sent); #endif /* __PING_H__ */ ================================================ FILE: app/include/lwip/arch.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_ARCH_H__ #define __LWIP_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_FIELD #define PACK_STRUCT_FIELD(x) x #endif /* PACK_STRUCT_FIELD */ #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 */ #define ENSROK 0 /* DNS server returned answer with no data */ #define ENSRNODATA 160 /* DNS server returned answer with no data */ #define ENSRFORMERR 161 /* DNS server claims query was misformatted */ #define ENSRSERVFAIL 162 /* DNS server returned general failure */ #define ENSRNOTFOUND 163 /* Domain name not found */ #define ENSRNOTIMP 164 /* DNS server does not implement requested operation */ #define ENSRREFUSED 165 /* DNS server refused query */ #define ENSRBADQUERY 166 /* Misformatted DNS query */ #define ENSRBADNAME 167 /* Misformatted domain name */ #define ENSRBADFAMILY 168 /* Unsupported address family */ #define ENSRBADRESP 169 /* Misformatted DNS reply */ #define ENSRCONNREFUSED 170 /* Could not contact DNS servers */ #define ENSRTIMEOUT 171 /* Timeout while contacting DNS servers */ #define ENSROF 172 /* End of file */ #define ENSRFILE 173 /* Error reading file */ #define ENSRNOMEM 174 /* Out of memory */ #define ENSRDESTRUCTION 175 /* Application terminated lookup */ #define ENSRQUERYDOMAINTOOLONG 176 /* Domain name is too long */ #define ENSRCNAMELOOP 177 /* Domain name is too long */ #ifndef errno extern int errno; #endif #endif /* LWIP_PROVIDE_ERRNO */ #ifdef __cplusplus } #endif #endif /* __LWIP_ARCH_H__ */ ================================================ FILE: app/include/lwip/autoip.h ================================================ /** * @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_AUTOIP_H__ #define __LWIP_AUTOIP_H__ #include "lwip/opt.h" #if 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 { ip_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 */ }; /** Init srand, has to be called before entering mainloop */ void autoip_init(void); /** Set a struct autoip allocated by the application to work with */ void autoip_set_struct(struct netif *netif, struct autoip *autoip); /** 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); #ifdef __cplusplus } #endif #endif /* LWIP_AUTOIP */ #endif /* __LWIP_AUTOIP_H__ */ ================================================ FILE: app/include/lwip/debug.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_DEBUG_H__ #define __LWIP_DEBUG_H__ #include "lwip/arch.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 #ifndef LWIP_NOASSERT #define LWIP_ASSERT(message, assertion) do { if(!(assertion)) \ LWIP_PLATFORM_ASSERT(message); } while(0) #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 #define LWIP_ERROR(message, expression, handler) do { if (!(expression)) { \ LWIP_PLATFORM_ASSERT(message); handler;}} while(0) #endif /* LWIP_ERROR */ #ifdef LWIP_DEBUG /** 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_DEBUG_H__ */ ================================================ FILE: app/include/lwip/def.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_DEF_H__ #define __LWIP_DEF_H__ /* arch.h might define NULL already */ #include "lwip/arch.h" #include "lwip/opt.h" #ifdef __cplusplus extern "C" { #endif #define LWIP_MAX(x , y) (((x) > (y)) ? (x) : (y)) #define LWIP_MIN(x , y) (((x) < (y)) ? (x) : (y)) #ifndef NULL #define NULL ((void *)0) #endif /** Get the absolute difference between 2 u32_t values (correcting overflows) * 'a' is expected to be 'higher' (without overflow) than 'b'. */ #define LWIP_U32_DIFF(a, b) (((a) >= (b)) ? ((a) - (b)) : (((a) + ((b) ^ 0xFFFFFFFF) + 1))) /* 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_DEF_H__ */ ================================================ FILE: app/include/lwip/dhcp.h ================================================ /** @file */ #ifndef __LWIP_DHCP_H__ #define __LWIP_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; /** our connection to the DHCP server */ struct udp_pcb *pcb; /** incoming msg */ struct dhcp_msg *msg_in; /** 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 */ ip_addr_t server_ip_addr; /* dhcp server address that offered this lease */ ip_addr_t offered_ip_addr; ip_addr_t offered_sn_mask; ip_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 66% of lease period) */ /* @todo: LWIP_DHCP_BOOTP_FILE configuration option? integrate with possible TFTP-client for booting? */ #define LWIP_DHCP_BOOTP_FILE 0 #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_FIELD(u8_t op); PACK_STRUCT_FIELD(u8_t htype); PACK_STRUCT_FIELD(u8_t hlen); PACK_STRUCT_FIELD(u8_t hops); PACK_STRUCT_FIELD(u32_t xid); PACK_STRUCT_FIELD(u16_t secs); PACK_STRUCT_FIELD(u16_t flags); PACK_STRUCT_FIELD(ip_addr_p_t ciaddr); PACK_STRUCT_FIELD(ip_addr_p_t yiaddr); PACK_STRUCT_FIELD(ip_addr_p_t siaddr); PACK_STRUCT_FIELD(ip_addr_p_t giaddr); PACK_STRUCT_FIELD(u8_t chaddr[DHCP_CHADDR_LEN]); PACK_STRUCT_FIELD(u8_t sname[DHCP_SNAME_LEN]); PACK_STRUCT_FIELD(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_FIELD(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, ip_addr_t *addr); #endif /** 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_OFF 0 #define DHCP_REQUESTING 1 #define DHCP_INIT 2 #define DHCP_REBOOTING 3 #define DHCP_REBINDING 4 #define DHCP_RENEWING 5 #define DHCP_SELECTING 6 #define DHCP_INFORMING 7 #define DHCP_CHECKING 8 #define DHCP_PERMANENT 9 #define DHCP_BOUND 10 /** not yet implemented #define DHCP_RELEASING 11 */ #define DHCP_BACKING_OFF 12 /** AUTOIP cooperatation 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_END 255 /**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 /** 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 #ifdef __cplusplus } #endif #endif /* LWIP_DHCP */ #endif /*__LWIP_DHCP_H__*/ ================================================ FILE: app/include/lwip/dns.h ================================================ /** * 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_DNS_H__ #define __LWIP_DNS_H__ #include "lwip/opt.h" #if LWIP_DNS /* don't build if not configured for use in lwipopts.h */ #ifdef __cplusplus extern "C" { #endif /** DNS timer period */ #define DNS_TMR_INTERVAL 1000 /** 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 */ /** 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 */ /* The size used for the next line is rather a hack, but it prevents including socket.h in all files that include memp.h, and that would possibly break portability (since socket.h defines some types and constants possibly already define by the OS). Calculation rule: sizeof(struct addrinfo) + sizeof(struct sockaddr_in) + DNS_MAX_NAME_LENGTH + 1 byte zero-termination */ #define NETDB_ELEM_SIZE (32 + 16 + DNS_MAX_NAME_LENGTH + 1) #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, ip_addr_t *ipaddr, void *callback_arg); void dns_init(void); void dns_tmr(void); void dns_setserver(u8_t numdns, 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); #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_DNS_H__ */ ================================================ FILE: app/include/lwip/err.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_ERR_H__ #define __LWIP_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_IS_FATAL(e) ((e) < ERR_WOULDBLOCK) #define ERR_ABRT -8 /* Connection aborted. */ #define ERR_RST -9 /* Connection reset. */ #define ERR_CLSD -10 /* Connection closed. */ #define ERR_CONN -11 /* Not connected. */ #define ERR_ARG -12 /* Illegal argument. */ #define ERR_USE -13 /* Address in use. */ #define ERR_IF -14 /* Low-level netif error */ #define ERR_ISCONN -15 /* Already connected. */ #ifdef LWIP_DEBUG extern const char *lwip_strerr(err_t err)ICACHE_FLASH_ATTR; #else #define lwip_strerr(x) "" #endif /* LWIP_DEBUG */ #ifdef __cplusplus } #endif #endif /* __LWIP_ERR_H__ */ ================================================ FILE: app/include/lwip/icmp.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_ICMP_H__ #define __LWIP_ICMP_H__ #include "lwip/opt.h" #include "lwip/pbuf.h" #include "lwip/ip_addr.h" #include "lwip/netif.h" #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 */ 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 splitted 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. * ICMPײṹ * ICMPײкܴԣ * ýṹͬICMPġ */ PACK_STRUCT_BEGIN struct icmp_echo_hdr { PACK_STRUCT_FIELD(u8_t type); PACK_STRUCT_FIELD(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 //ȡICMPײֶ #define ICMPH_TYPE(hdr) ((hdr)->type) #define ICMPH_CODE(hdr) ((hdr)->code) /** Combines type and code to an u16_t ICMPײֶдӦֵ*/ #define ICMPH_TYPE_SET(hdr, t) ((hdr)->type = (t)) #define ICMPH_CODE_SET(hdr, c) ((hdr)->code = (c)) #if LWIP_ICMP /* don't build if not configured for use in lwipopts.h */ void icmp_input(struct pbuf *p, struct netif *inp)ICACHE_FLASH_ATTR; void icmp_dest_unreach(struct pbuf *p, enum icmp_dur_type t)ICACHE_FLASH_ATTR; void icmp_time_exceeded(struct pbuf *p, enum icmp_te_type t)ICACHE_FLASH_ATTR; #endif /* LWIP_ICMP */ #ifdef __cplusplus } #endif #endif /* __LWIP_ICMP_H__ */ ================================================ FILE: app/include/lwip/igmp.h ================================================ /* * 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_IGMP_H__ #define __LWIP_IGMP_H__ #include "lwip/opt.h" #include "lwip/ip_addr.h" #include "lwip/netif.h" #include "lwip/pbuf.h" #if 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 */ ip_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)ICACHE_FLASH_ATTR; err_t igmp_start(struct netif *netif)ICACHE_FLASH_ATTR; err_t igmp_stop(struct netif *netif)ICACHE_FLASH_ATTR; void igmp_report_groups(struct netif *netif)ICACHE_FLASH_ATTR; struct igmp_group *igmp_lookfor_group(struct netif *ifp, ip_addr_t *addr)ICACHE_FLASH_ATTR; void igmp_input(struct pbuf *p, struct netif *inp, ip_addr_t *dest)ICACHE_FLASH_ATTR; err_t igmp_joingroup(ip_addr_t *ifaddr, ip_addr_t *groupaddr)ICACHE_FLASH_ATTR; err_t igmp_leavegroup(ip_addr_t *ifaddr, ip_addr_t *groupaddr)ICACHE_FLASH_ATTR; void igmp_tmr(void)ICACHE_FLASH_ATTR; #define LWIP_RAND() r_rand() #ifdef __cplusplus } #endif #endif /* LWIP_IGMP */ #endif /* __LWIP_IGMP_H__ */ ================================================ FILE: app/include/lwip/inet.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_INET_H__ #define __LWIP_INET_H__ #include "lwip/opt.h" #include "lwip/def.h" #include "lwip/ip_addr.h" #ifdef __cplusplus extern "C" { #endif /** For compatibility with BSD code */ struct in_addr { u32_t s_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 /* 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 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 #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) ipaddr_aton(cp, (ip_addr_t*)addr) #define inet_ntoa(addr) ipaddr_ntoa((ip_addr_t*)&(addr)) #define inet_ntoa_r(addr, buf, buflen) ipaddr_ntoa_r((ip_addr_t*)&(addr), buf, buflen) #ifdef __cplusplus } #endif #endif /* __LWIP_INET_H__ */ ================================================ FILE: app/include/lwip/inet_chksum.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_INET_CHKSUM_H__ #define __LWIP_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 */ #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(void *dataptr, u16_t len)ICACHE_FLASH_ATTR; u16_t inet_chksum_pbuf(struct pbuf *p)ICACHE_FLASH_ATTR; u16_t inet_chksum_pseudo(struct pbuf *p, ip_addr_t *src, ip_addr_t *dest, u8_t proto, u16_t proto_len)ICACHE_FLASH_ATTR; u16_t inet_chksum_pseudo_partial(struct pbuf *p, ip_addr_t *src, ip_addr_t *dest, u8_t proto, u16_t proto_len, u16_t chksum_len)ICACHE_FLASH_ATTR; #if LWIP_CHKSUM_COPY_ALGORITHM u16_t lwip_chksum_copy(void *dst, const void *src, u16_t len)ICACHE_FLASH_ATTR; #endif /* LWIP_CHKSUM_COPY_ALGORITHM */ #ifdef __cplusplus } #endif #endif /* __LWIP_INET_H__ */ ================================================ FILE: app/include/lwip/init.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_INIT_H__ #define __LWIP_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 4U /** 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 (CVS), this is set to 0 (LWIP_RC_DEVELOPMENT) */ #define LWIP_VERSION_RC 2U /** 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 CVS 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) ICACHE_FLASH_ATTR; //void lwip_init(void); #ifdef __cplusplus } #endif #endif /* __LWIP_INIT_H__ */ ================================================ FILE: app/include/lwip/ip.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_IP_H__ #define __LWIP_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" #ifdef __cplusplus extern "C" { #endif /** Currently, the function ip_output_if_opt() is only used with IGMP */ #define IP_OPTIONS_SEND LWIP_IGMP #define IP_HLEN 20 #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 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 #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. */ /*#define SOF_DEBUG (u8_t)0x01U Unimplemented: turn on debugging info recording */ #define SOF_ACCEPTCONN (u8_t)0x02U /* socket has had listen() */ #define SOF_REUSEADDR (u8_t)0x04U /* allow local address reuse */ #define SOF_KEEPALIVE (u8_t)0x08U /* keep connections alive */ /*#define SOF_DONTROUTE (u8_t)0x10U Unimplemented: just use interface addresses */ #define SOF_BROADCAST (u8_t)0x20U /* permit to send and to receive broadcast messages (see IP_SOF_BROADCAST option) */ /*#define SOF_USELOOPBACK (u8_t)0x40U Unimplemented: bypass hardware when possible */ #define SOF_LINGER (u8_t)0x80U /* linger on close if data present */ /*#define SOF_OOBINLINE (u16_t)0x0100U Unimplemented: leave received OOB data in line */ /*#define SOF_REUSEPORT (u16_t)0x0200U Unimplemented: allow local address & port reuse */ /* These flags are inherited (e.g. from a listen-pcb to a connection-pcb): */ #define SOF_INHERITED (SOF_REUSEADDR|SOF_KEEPALIVE|SOF_LINGER/*|SOF_DEBUG|SOF_DONTROUTE|SOF_OOBINLINE*/) #ifdef PACK_STRUCT_USE_INCLUDES # include "arch/bpstruct.h" #endif PACK_STRUCT_BEGIN struct ip_hdr { /* version / header length / type of service */ PACK_STRUCT_FIELD(u16_t _v_hl_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 0x8000 /* reserved fragment flag */ #define IP_DF 0x4000 /* dont fragment flag */ #define IP_MF 0x2000 /* more fragments flag */ #define IP_OFFMASK 0x1fff /* mask for fragmenting bits */ /* time to live */ PACK_STRUCT_FIELD(u8_t _ttl); /* protocol*/ PACK_STRUCT_FIELD(u8_t _proto); /* checksum */ PACK_STRUCT_FIELD(u16_t _chksum); /* source and destination IP addresses */ PACK_STRUCT_FIELD(ip_addr_p_t src); PACK_STRUCT_FIELD(ip_addr_p_t dest); } PACK_STRUCT_STRUCT; PACK_STRUCT_END #ifdef PACK_STRUCT_USE_INCLUDES # include "arch/epstruct.h" #endif #define IPH_V(hdr) (ntohs((hdr)->_v_hl_tos) >> 12) #define IPH_HL(hdr) ((ntohs((hdr)->_v_hl_tos) >> 8) & 0x0f) #define IPH_TOS(hdr) (ntohs((hdr)->_v_hl_tos) & 0xff) #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_VHLTOS_SET(hdr, v, hl, tos) (hdr)->_v_hl_tos = (htons(((v) << 12) | ((hl) << 8) | (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) /** The interface that provided the packet for the current callback invocation. */ extern struct netif *current_netif; /** Header of the input packet currently being processed. */ extern const struct ip_hdr *current_header; /** Source IP address of current_header */ extern ip_addr_t current_iphdr_src; /** Destination IP address of current_header */ extern ip_addr_t current_iphdr_dest; #define ip_init() /* Compatibility define, not init needed. */ struct netif *ip_route(ip_addr_t *dest)ICACHE_FLASH_ATTR; struct netif *ip_router(ip_addr_t *dest, ip_addr_t *source); err_t ip_input(struct pbuf *p, struct netif *inp)ICACHE_FLASH_ATTR; err_t ip_output(struct pbuf *p, ip_addr_t *src, ip_addr_t *dest, u8_t ttl, u8_t tos, u8_t proto)ICACHE_FLASH_ATTR; err_t ip_output_if(struct pbuf *p, ip_addr_t *src, ip_addr_t *dest, u8_t ttl, u8_t tos, u8_t proto, struct netif *netif)ICACHE_FLASH_ATTR; #if LWIP_NETIF_HWADDRHINT err_t ip_output_hinted(struct pbuf *p, ip_addr_t *src, ip_addr_t *dest, u8_t ttl, u8_t tos, u8_t proto, u8_t *addr_hint)ICACHE_FLASH_ATTR; #endif /* LWIP_NETIF_HWADDRHINT */ #if IP_OPTIONS_SEND err_t ip_output_if_opt(struct pbuf *p, ip_addr_t *src, ip_addr_t *dest, u8_t ttl, u8_t tos, u8_t proto, struct netif *netif, void *ip_options, u16_t optlen)ICACHE_FLASH_ATTR; #endif /* IP_OPTIONS_SEND */ /** 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_netif() (current_netif) /** Get the IP 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 ip_current_header() (current_header) /** Source IP address of current_header */ #define ip_current_src_addr() (¤t_iphdr_src) /** Destination IP address of current_header */ #define ip_current_dest_addr() (¤t_iphdr_dest) #if IP_DEBUG void ip_debug_print(struct pbuf *p)ICACHE_FLASH_ATTR; #else #define ip_debug_print(p) #endif /* IP_DEBUG */ #ifdef __cplusplus } #endif #endif /* __LWIP_IP_H__ */ ================================================ FILE: app/include/lwip/ip_addr.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_IP_ADDR_H__ #define __LWIP_IP_ADDR_H__ #include "lwip/opt.h" #include "lwip/def.h" #ifdef __cplusplus extern "C" { #endif /* This is the aligned version of ip_addr_t, used as local variable, on the stack, etc. */ struct ip_addr { u32_t addr; }; /* This is the packed version of ip_addr_t, used in network headers that are itself packed */ #ifdef PACK_STRUCT_USE_INCLUDES # include "arch/bpstruct.h" #endif PACK_STRUCT_BEGIN struct ip_addr_packed { PACK_STRUCT_FIELD(u32_t addr); } PACK_STRUCT_STRUCT; PACK_STRUCT_END #ifdef PACK_STRUCT_USE_INCLUDES # include "arch/epstruct.h" #endif /** ip_addr_t uses a struct for convenience only, so that the same defines can * operate both on ip_addr_t as well as on ip_addr_p_t. */ typedef struct ip_addr ip_addr_t; typedef struct ip_addr_packed ip_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 ip_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; extern const ip_addr_t ip_addr_any; extern const ip_addr_t ip_addr_broadcast; /** IP_ADDR_ can be used as a fixed IP address * for the wildcard and the broadcast address */ #define IP_ADDR_ANY ((ip_addr_t *)&ip_addr_any) #define IP_ADDR_BROADCAST ((ip_addr_t *)&ip_addr_broadcast) /** 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(ip_addr_t)) #endif /** Copy IP address - faster than ip_addr_set: no NULL check */ #define ip_addr_copy(dest, src) ((dest).addr = (src).addr) /** Safely copy one IP address to another (src may be NULL) */ #define ip_addr_set(dest, src) ((dest)->addr = \ ((src) == NULL ? 0 : \ (src)->addr)) /** Set complete address to zero */ #define ip_addr_set_zero(ipaddr) ((ipaddr)->addr = 0) /** Set address to IPADDR_ANY (no need for htonl()) */ #define ip_addr_set_any(ipaddr) ((ipaddr)->addr = IPADDR_ANY) /** Set address to loopback address */ #define ip_addr_set_loopback(ipaddr) ((ipaddr)->addr = PP_HTONL(IPADDR_LOOPBACK)) /** Safely copy one IP address to another and change byte order * from host- to network-order. */ #define ip_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 ip_addr_get_network(target, host, netmask) ((target)->addr = ((host)->addr) & ((netmask)->addr)) /** * 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 ip_addr_netcmp(addr1, addr2, mask) (((addr1)->addr & \ (mask)->addr) == \ ((addr2)->addr & \ (mask)->addr)) #define ip_addr_cmp(addr1, addr2) ((addr1)->addr == (addr2)->addr) #define ip_addr_isany(addr1) ((addr1) == NULL || (addr1)->addr == IPADDR_ANY) #define ip_addr_isbroadcast(ipaddr, netif) ip4_addr_isbroadcast((ipaddr)->addr, (netif)) u8_t ip4_addr_isbroadcast(u32_t addr, const struct netif *netif)ICACHE_FLASH_ATTR; #define ip_addr_netmask_valid(netmask) ip4_addr_netmask_valid((netmask)->addr) u8_t ip4_addr_netmask_valid(u32_t netmask)ICACHE_FLASH_ATTR; #define ip_addr_ismulticast(addr1) (((addr1)->addr & PP_HTONL(0xf0000000UL)) == PP_HTONL(0xe0000000UL)) #define ip_addr_islinklocal(addr1) (((addr1)->addr & PP_HTONL(0xffff0000UL)) == PP_HTONL(0xa9fe0000UL)) #define ip_addr_debug_print(debug, ipaddr) \ LWIP_DEBUGF(debug, ("%"U16_F".%"U16_F".%"U16_F".%"U16_F, \ 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)) /* Get one byte from the 4-byte address */ #define ip4_addr1(ipaddr) (((u8_t*)(ipaddr))[0]) #define ip4_addr2(ipaddr) (((u8_t*)(ipaddr))[1]) #define ip4_addr3(ipaddr) (((u8_t*)(ipaddr))[2]) #define ip4_addr4(ipaddr) (((u8_t*)(ipaddr))[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)) /** For backwards compatibility */ #define ip_ntoa(ipaddr) ipaddr_ntoa(ipaddr) u32_t ipaddr_addr(const char *cp)ICACHE_FLASH_ATTR; int ipaddr_aton(const char *cp, ip_addr_t *addr)ICACHE_FLASH_ATTR; /** returns ptr to static buffer; not reentrant! */ char *ipaddr_ntoa(const ip_addr_t *addr)ICACHE_FLASH_ATTR; char *ipaddr_ntoa_r(const ip_addr_t *addr, char *buf, int buflen)ICACHE_FLASH_ATTR; #define IP2STR(ipaddr) ip4_addr1_16(ipaddr), \ ip4_addr2_16(ipaddr), \ ip4_addr3_16(ipaddr), \ ip4_addr4_16(ipaddr) #define IPSTR "%d.%d.%d.%d" struct ip_info { struct ip_addr ip; struct ip_addr netmask; struct ip_addr gw; }; #ifdef __cplusplus } #endif #endif /* __LWIP_IP_ADDR_H__ */ ================================================ FILE: app/include/lwip/ip_frag.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: Jani Monoses * */ #ifndef __LWIP_IP_FRAG_H__ #define __LWIP_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" #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)ICACHE_FLASH_ATTR; void ip_reass_tmr(void)ICACHE_FLASH_ATTR; struct pbuf * ip_reass(struct pbuf *p)ICACHE_FLASH_ATTR; #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. */ struct pbuf_custom_ref { /** 'base class' */ struct pbuf_custom pc; /** pointer to the original pbuf that is referenced */ struct pbuf *original; }; #endif /* !IP_FRAG_USES_STATIC_BUF && !LWIP_NETIF_TX_SINGLE_PBUF */ err_t ip_frag(struct pbuf *p, struct netif *netif, ip_addr_t *dest)ICACHE_FLASH_ATTR; #endif /* IP_FRAG */ #ifdef __cplusplus } #endif #endif /* __LWIP_IP_FRAG_H__ */ ================================================ FILE: app/include/lwip/mdns.h ================================================ /** * lwip MDNS resolver header file. * * Created on: Jul 29, 2010 * Author: Daniel Toma * 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_DNS_H__ #define __LWIP_DNS_H__ #include "lwip/opt.h" #if LWIP_MDNS /* don't build if not configured for use in lwipopts.h */ /** DNS timer period */ #define DNS_TMR_INTERVAL 1000 /** mDNS Address offset flag*/ #define DNS_OFFSET_FLAG 0xC0 /* the offset flag in the DNS message */ #define DNS_DEFAULT_OFFSET 0x0C /* the offset is set at the beginning of the DNS message */ #define DNS_IP_ADDR_LEN 4 /** 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_SRV 33 /* Service record */ #define DNS_RRTYPE_OPT 41 /* EDNS0 OPT record */ #define DNS_RRTYPE_TSIG 250 /* Transaction Signature */ #define DNS_RRTYPE_ANY 255 /*Not a DNS type, but a DNS query type, meaning "all types"*/ /* 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 */ #define DNS_RRCLASS_FLUSH_IN 0x8001/* Flush bit and Internet*/ /** 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 a struct ip_addr 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 */ #ifndef _MDNS_INFO #define _MDNS_INFO struct mdns_info { char *host_name; char *server_name; uint16 server_port; unsigned long ipAddr; char *txt_data[10]; }; #endif //void mdns_enable(void); //void mdns_disable(void); //void mdns_init(struct mdns_info *info); //void mdns_close(void); //char* mdns_get_hostname(void); //void mdns_set_hostname(char *name); //void mdns_set_servername(const char *name); //char* mdns_get_servername(void); //void mdns_server_unregister(void); //void mdns_server_register(void) ; //void mdns_tmr(void); //void Delay(unsigned long ulSeconds); #endif /* LWIP_DNS */ #endif /* __LWIP_DNS_H__ */ ================================================ FILE: app/include/lwip/mem.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_MEM_H__ #define __LWIP_MEM_H__ #include "lwip/opt.h" //#include "mem_manager.h" #ifdef __cplusplus extern "C" { #endif #if MEM_LIBC_MALLOC #include /* for size_t */ typedef size_t mem_size_t; /* 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 vPortFree #endif #ifndef mem_malloc #define mem_malloc pvPortMalloc #endif #ifndef mem_calloc #define mem_calloc pvPortCalloc #endif #ifndef mem_realloc #define mem_realloc pvPortRealloc #endif #ifndef mem_zalloc #define mem_zalloc pvPortZalloc #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 #ifndef os_malloc #define os_malloc(s) mem_malloc((s)) #endif #ifndef os_realloc #define os_realloc(p, s) mem_realloc((p), (s)) #endif #ifndef os_zalloc #define os_zalloc(s) mem_zalloc((s)) #endif #ifndef os_free #define os_free(p) mem_free((p)) #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)ICACHE_FLASH_ATTR; void *mem_trim(void *mem, mem_size_t size)ICACHE_FLASH_ATTR; #endif /* MEM_USE_POOLS */ void *mem_malloc(mem_size_t size)ICACHE_FLASH_ATTR; void *mem_calloc(mem_size_t count, mem_size_t size)ICACHE_FLASH_ATTR; void mem_free(void *mem)ICACHE_FLASH_ATTR; #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 - 1) & ~(MEM_ALIGNMENT-1)) #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 - 1)) #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_MEM_H__ */ ================================================ FILE: app/include/lwip/memp.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_MEMP_H__ #define __LWIP_MEMP_H__ #include "lwip/opt.h" #ifdef __cplusplus extern "C" { #endif /* 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, attr) MEMP_##name, #include "lwip/memp_std.h" MEMP_MAX } memp_t; #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/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/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 */ #if MEMP_MEM_MALLOC || MEM_USE_POOLS extern const u32_t memp_sizes[MEMP_MAX]; #endif /* MEMP_MEM_MALLOC || MEM_USE_POOLS */ #if MEMP_MEM_MALLOC #include "mem.h" #define memp_init() #define memp_malloc(type) mem_malloc(memp_sizes[type]) #define memp_free(type, mem) mem_free(mem) #else /* MEMP_MEM_MALLOC */ #if MEM_USE_POOLS /** This structure is used to save the pool one element came from. */ struct memp_malloc_helper { memp_t poolnr; }; #endif /* MEM_USE_POOLS */ void memp_init(void)ICACHE_FLASH_ATTR; #if MEMP_OVERFLOW_CHECK void *memp_malloc_fn(memp_t type, const char* file, const int line)ICACHE_FLASH_ATTR; #define memp_malloc(t) memp_malloc_fn((t), __FILE__, __LINE__) #else void *memp_malloc(memp_t type)ICACHE_FLASH_ATTR; #endif void memp_free(memp_t type, void *mem)ICACHE_FLASH_ATTR; #endif /* MEMP_MEM_MALLOC */ #ifdef __cplusplus } #endif #endif /* __LWIP_MEMP_H__ */ ================================================ FILE: app/include/lwip/memp_std.h ================================================ /* * 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 + sizeof(struct memp_malloc_helper)), "MALLOC_"#size, attr) #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, attr) LWIP_MEMPOOL(name, num, (MEMP_ALIGN_SIZE(sizeof(struct pbuf)) + MEMP_ALIGN_SIZE(payload)), desc, attr) #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", DMEM_ATTR) #endif /* LWIP_RAW */ #if LWIP_UDP LWIP_MEMPOOL(UDP_PCB, MEMP_NUM_UDP_PCB, sizeof(struct udp_pcb), "UDP_PCB", DMEM_ATTR) #endif /* LWIP_UDP */ #if LWIP_TCP LWIP_MEMPOOL(TCP_PCB, MEMP_NUM_TCP_PCB, sizeof(struct tcp_pcb), "TCP_PCB", DMEM_ATTR) LWIP_MEMPOOL(TCP_PCB_LISTEN, MEMP_NUM_TCP_PCB_LISTEN, sizeof(struct tcp_pcb_listen), "TCP_PCB_LISTEN", DMEM_ATTR) LWIP_MEMPOOL(TCP_SEG, MEMP_NUM_TCP_SEG, sizeof(struct tcp_seg), "TCP_SEG", DMEM_ATTR) #endif /* LWIP_TCP */ #if IP_REASSEMBLY LWIP_MEMPOOL(REASSDATA, MEMP_NUM_REASSDATA, sizeof(struct ip_reassdata), "REASSDATA", DMEM_ATTR) #endif /* IP_REASSEMBLY */ #if IP_FRAG && !IP_FRAG_USES_STATIC_BUF && !LWIP_NETIF_TX_SINGLE_PBUF LWIP_MEMPOOL(FRAG_PBUF, MEMP_NUM_FRAG_PBUF, sizeof(struct pbuf_custom_ref),"FRAG_PBUF", DMEM_ATTR) #endif /* IP_FRAG && !IP_FRAG_USES_STATIC_BUF && !LWIP_NETIF_TX_SINGLE_PBUF */ #if LWIP_NETCONN LWIP_MEMPOOL(NETBUF, MEMP_NUM_NETBUF, sizeof(struct netbuf), "NETBUF") LWIP_MEMPOOL(NETCONN, MEMP_NUM_NETCONN, sizeof(struct netconn), "NETCONN") #endif /* LWIP_NETCONN */ #if NO_SYS==0 LWIP_MEMPOOL(TCPIP_MSG_API, MEMP_NUM_TCPIP_MSG_API, sizeof(struct tcpip_msg), "TCPIP_MSG_API") #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 ARP_QUEUEING LWIP_MEMPOOL(ARP_QUEUE, MEMP_NUM_ARP_QUEUE, sizeof(struct etharp_q_entry), "ARP_QUEUE", DMEM_ATTR) #endif /* ARP_QUEUEING */ #if LWIP_IGMP LWIP_MEMPOOL(IGMP_GROUP, MEMP_NUM_IGMP_GROUP, sizeof(struct igmp_group), "IGMP_GROUP", DMEM_ATTR) #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", DMEM_ATTR) #endif /* LWIP_TIMERS */ #if LWIP_SNMP LWIP_MEMPOOL(SNMP_ROOTNODE, MEMP_NUM_SNMP_ROOTNODE, sizeof(struct mib_list_rootnode), "SNMP_ROOTNODE") LWIP_MEMPOOL(SNMP_NODE, MEMP_NUM_SNMP_NODE, sizeof(struct mib_list_node), "SNMP_NODE") LWIP_MEMPOOL(SNMP_VARBIND, MEMP_NUM_SNMP_VARBIND, sizeof(struct snmp_varbind), "SNMP_VARBIND") LWIP_MEMPOOL(SNMP_VALUE, MEMP_NUM_SNMP_VALUE, SNMP_MAX_VALUE_SIZE, "SNMP_VALUE") #endif /* LWIP_SNMP */ #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 && PPPOE_SUPPORT LWIP_MEMPOOL(PPPOE_IF, MEMP_NUM_PPPOE_INTERFACES, sizeof(struct pppoe_softc), "PPPOE_IF") #endif /* PPP_SUPPORT && PPPOE_SUPPORT */ /* * 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", DMEM_ATTR) /* XXX: need to align to 4 byte as memp strcut is 4-byte long. otherwise will crash */ #define LWIP_MEM_ALIGN4_SIZE(size) (((size) + 4 - 1) & ~(4-1)) LWIP_PBUF_MEMPOOL(PBUF_POOL, PBUF_POOL_SIZE, LWIP_MEM_ALIGN4_SIZE(PBUF_POOL_BUFSIZE), "PBUF_POOL", DMEM_ATTR) /* * 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 ================================================ FILE: app/include/lwip/netbuf.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_NETBUF_H__ #define __LWIP_NETBUF_H__ #include "lwip/opt.h" #include "lwip/pbuf.h" #include "lwip/ip_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)ICACHE_FLASH_ATTR; void netbuf_delete (struct netbuf *buf)ICACHE_FLASH_ATTR; void * netbuf_alloc (struct netbuf *buf, u16_t size)ICACHE_FLASH_ATTR; void netbuf_free (struct netbuf *buf)ICACHE_FLASH_ATTR; err_t netbuf_ref (struct netbuf *buf, const void *dataptr, u16_t size)ICACHE_FLASH_ATTR; void netbuf_chain (struct netbuf *head, struct netbuf *tail)ICACHE_FLASH_ATTR; err_t netbuf_data (struct netbuf *buf, void **dataptr, u16_t *len)ICACHE_FLASH_ATTR; s8_t netbuf_next (struct netbuf *buf)ICACHE_FLASH_ATTR; void netbuf_first (struct netbuf *buf)ICACHE_FLASH_ATTR; #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)->addr), destaddr) #define netbuf_destport(buf) (((buf)->flags & NETBUF_FLAG_DESTADDR) ? (buf)->toport_chksum : 0) #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_NETBUF_H__ */ ================================================ FILE: app/include/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. * * Author: Simon Goldschmidt * */ #ifndef __LWIP_NETDB_H__ #define __LWIP_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_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 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_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 */ #if LWIP_DNS_API_DECLARE_H_ERRNO /* application accessable 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_NETDB_H__ */ ================================================ FILE: app/include/lwip/netif.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_NETIF_H__ #define __LWIP_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" #if LWIP_DHCP struct dhcp; #endif #if LWIP_AUTOIP struct autoip; #endif #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 */ #define NETIF_MAX_HWADDR_LEN 6U /** Whether the network interface is 'up'. This is * a software flag used to control whether this network * interface is enabled and processes traffic. * It is set by the startup code (for static IP configuration) or * by dhcp/autoip when an address has been assigned. */ #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 netif is one end of a point-to-point connection. * Set by the netif driver in its init function. */ #define NETIF_FLAG_POINTTOPOINT 0x04U /** If set, the interface is configured using DHCP. * Set by the DHCP code when starting or stopping DHCP. */ #define NETIF_FLAG_DHCP 0x08U /** 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 0x10U /** 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 0x20U /** 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 0x40U /** If set, the netif has IGMP capability. * Set by the netif driver in its init function. */ #define NETIF_FLAG_IGMP 0x80U /** 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); /** 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, ip_addr_t *ipaddr); /** 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); /** Function prototype for netif igmp_mac_filter functions */ typedef err_t (*netif_igmp_mac_filter_fn)(struct netif *netif, ip_addr_t *group, u8_t action); /*add DHCP event processing by LiuHan*/ typedef void (*dhcp_event_fn)(void); /** 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; /** IP address configuration in network byte order */ ip_addr_t ip_addr; ip_addr_t netmask; ip_addr_t gw; /** This function is called by the network device driver * to pass a packet up the TCP/IP stack. IPݰ*/ netif_input_fn input; /** 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. IPݰ*/ netif_output_fn output; /** 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_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 */ /** 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; struct udp_pcb *dhcps_pcb; //dhcps dhcp_event_fn dhcp_event; #endif /* LWIP_DHCP */ #if LWIP_AUTOIP /** the AutoIP client state information for this netif */ struct autoip *autoip; #endif #if LWIP_NETIF_HOSTNAME /* the hostname for this netif, NULL is a valid value */ char* hostname; #endif /* LWIP_NETIF_HOSTNAME */ /** maximum transfer unit (in bytes) ýӿݰȣ1500*/ 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 LWIP_SNMP /** link type (from "snmp_ifType" enum from snmp.h) */ u8_t link_type; /** (estimate) link speed */ u32_t link_speed; /** timestamp at last change made (up/down) */ u32_t ts; /** counters */ u32_t ifinoctets; u32_t ifinucastpkts; u32_t ifinnucastpkts; u32_t ifindiscards; u32_t ifoutoctets; u32_t ifoutucastpkts; u32_t ifoutnucastpkts; u32_t ifoutdiscards; #endif /* LWIP_SNMP */ #if LWIP_IGMP /** This function could be called to add or delete a entry in the multicast filter table of the ethernet MAC.*/ netif_igmp_mac_filter_fn igmp_mac_filter; #endif /* LWIP_IGMP */ #if LWIP_NETIF_HWADDRHINT u8_t *addr_hint; #endif /* LWIP_NETIF_HWADDRHINT */ #if ENABLE_LOOPBACK /* List of packets to be queued for ourselves. ָ͸Լݰpbuf*/ 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_SNMP #define NETIF_INIT_SNMP(netif, type, speed) \ /* use "snmp_ifType" enum from snmp.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)->ifinoctets = 0; \ (netif)->ifinucastpkts = 0; \ (netif)->ifinnucastpkts = 0; \ (netif)->ifindiscards = 0; \ (netif)->ifoutoctets = 0; \ (netif)->ifoutucastpkts = 0; \ (netif)->ifoutnucastpkts = 0; \ (netif)->ifoutdiscards = 0 #else /* LWIP_SNMP */ #define NETIF_INIT_SNMP(netif, type, speed) #endif /* LWIP_SNMP */ /** The list of network interfaces. */ extern struct netif *netif_list; /** The default network interface. */ extern struct netif *netif_default; void netif_init(void)ICACHE_FLASH_ATTR; struct netif *netif_add(struct netif *netif, ip_addr_t *ipaddr, ip_addr_t *netmask, ip_addr_t *gw, void *state, netif_init_fn init, netif_input_fn input)ICACHE_FLASH_ATTR; void netif_set_addr(struct netif *netif, ip_addr_t *ipaddr, ip_addr_t *netmask, ip_addr_t *gw)ICACHE_FLASH_ATTR; void netif_remove(struct netif * netif)ICACHE_FLASH_ATTR; /* 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(char *name)ICACHE_FLASH_ATTR; void netif_set_default(struct netif *netif)ICACHE_FLASH_ATTR; void netif_set_ipaddr(struct netif *netif, ip_addr_t *ipaddr)ICACHE_FLASH_ATTR; void netif_set_netmask(struct netif *netif, ip_addr_t *netmask)ICACHE_FLASH_ATTR; void netif_set_gw(struct netif *netif, ip_addr_t *gw)ICACHE_FLASH_ATTR; void netif_set_up(struct netif *netif)ICACHE_FLASH_ATTR; void netif_set_down(struct netif *netif)ICACHE_FLASH_ATTR; /** 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)ICACHE_FLASH_ATTR; #endif /* LWIP_NETIF_STATUS_CALLBACK */ void netif_set_link_up(struct netif *netif)ICACHE_FLASH_ATTR; void netif_set_link_down(struct netif *netif)ICACHE_FLASH_ATTR; /** 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)ICACHE_FLASH_ATTR; #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 ENABLE_LOOPBACK err_t netif_loop_output(struct netif *netif, struct pbuf *p, ip_addr_t *dest_ip)ICACHE_FLASH_ATTR; void netif_poll(struct netif *netif)ICACHE_FLASH_ATTR; #if !LWIP_NETIF_LOOPBACK_MULTITHREADING void netif_poll_all(void)ICACHE_FLASH_ATTR; #endif /* !LWIP_NETIF_LOOPBACK_MULTITHREADING */ #endif /* ENABLE_LOOPBACK */ #ifdef __cplusplus } #endif #endif /* __LWIP_NETIF_H__ */ ================================================ FILE: app/include/lwip/netifapi.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. * */ #ifndef __LWIP_NETIFAPI_H__ #define __LWIP_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" #ifdef __cplusplus extern "C" { #endif typedef void (*netifapi_void_fn)(struct netif *netif); typedef err_t (*netifapi_errt_fn)(struct netif *netif); struct netifapi_msg_msg { #if !LWIP_TCPIP_CORE_LOCKING sys_sem_t sem; #endif /* !LWIP_TCPIP_CORE_LOCKING */ err_t err; struct netif *netif; union { struct { ip_addr_t *ipaddr; ip_addr_t *netmask; ip_addr_t *gw; void *state; netif_init_fn init; netif_input_fn input; } add; struct { netifapi_void_fn voidfunc; netifapi_errt_fn errtfunc; } common; } msg; }; struct netifapi_msg { void (* function)(struct netifapi_msg_msg *msg); struct netifapi_msg_msg msg; }; /* API for application */ err_t netifapi_netif_add ( struct netif *netif, ip_addr_t *ipaddr, ip_addr_t *netmask, ip_addr_t *gw, void *state, netif_init_fn init, netif_input_fn input); err_t netifapi_netif_set_addr ( struct netif *netif, ip_addr_t *ipaddr, ip_addr_t *netmask, ip_addr_t *gw ); 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_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_NETIFAPI_H__ */ ================================================ FILE: app/include/lwip/opt.h ================================================ /** * @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_OPT_H__ #define __LWIP_OPT_H__ /* * Include user defined options first. Anything not defined in these files * will be set to standard values. Override anything you dont 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 1 #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 1 #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 /* ------------------------------------ ---------- 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_SEPARATE_POOLS: if defined to 1, each pool is placed in its own array. * This can be used to individually change the location of each pool. * Default is one big array for all pools */ #ifndef MEMP_SEPARATE_POOLS #define MEMP_SEPARATE_POOLS 0 #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 * inlude 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 simulatenously 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 simulateously 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 et 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 simulateously active timeouts. * (requires NO_SYS==0) */ #ifndef MEMP_NUM_SYS_TIMEOUT #define MEMP_NUM_SYS_TIMEOUT 3 #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_SNMP_NODE: the number of leafs in the SNMP tree. */ #ifndef MEMP_NUM_SNMP_NODE #define MEMP_NUM_SNMP_NODE 50 #endif /** * MEMP_NUM_SNMP_ROOTNODE: the number of branches in the SNMP tree. * Every branch has one leaf (MEMP_NUM_SNMP_NODE) at least! */ #ifndef MEMP_NUM_SNMP_ROOTNODE #define MEMP_NUM_SNMP_ROOTNODE 30 #endif /** * MEMP_NUM_SNMP_VARBIND: the number of concurrent requests (does not have to * be changed normally) - 2 of these are used per request (1 for input, * 1 for output) */ #ifndef MEMP_NUM_SNMP_VARBIND #define MEMP_NUM_SNMP_VARBIND 2 #endif /** * MEMP_NUM_SNMP_VALUE: the number of OID or values concurrently used * (does not have to be changed normally) - 3 of these are used per request * (1 for the value read and 2 for OIDs - input and output) */ #ifndef MEMP_NUM_SNMP_VALUE #define MEMP_NUM_SNMP_VALUE 3 #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_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 /** * PBUF_POOL_SIZE: the number of buffers in the pbuf pool. */ #ifndef PBUF_POOL_SIZE #define PBUF_POOL_SIZE 16 #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 /** * 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 /** * 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 ethernet packets with VLAN header. * 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. */ #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 /* -------------------------------- ---------- IP options ---------- -------------------------------- */ /** * 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_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_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 0 #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 /** * 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 /* ---------------------------------- ---------- 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 1 #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 /** * 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 /* ------------------------------------ ---------- AUTOIP options ---------- ------------------------------------ */ /** * LWIP_AUTOIP==1: Enable AUTOIP module. */ #ifndef LWIP_AUTOIP #define LWIP_AUTOIP 0 #endif /** * 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 options ---------- ---------------------------------- */ /** * LWIP_SNMP==1: Turn on SNMP module. UDP must be available for SNMP * transport. */ #ifndef LWIP_SNMP #define LWIP_SNMP 0 #endif /** * SNMP_CONCURRENT_REQUESTS: Number of concurrent requests the module will * allow. At least one request buffer is required. * Does not have to be changed unless external MIBs answer request asynchronously */ #ifndef SNMP_CONCURRENT_REQUESTS #define SNMP_CONCURRENT_REQUESTS 1 #endif /** * SNMP_TRAP_DESTINATIONS: Number of trap destinations. At least one trap * destination is required */ #ifndef SNMP_TRAP_DESTINATIONS #define SNMP_TRAP_DESTINATIONS 1 #endif /** * SNMP_PRIVATE_MIB: * When using a private MIB, you have to create a file 'private_mib.h' that contains * a 'struct mib_array_node mib_private' which contains your MIB. */ #ifndef SNMP_PRIVATE_MIB #define SNMP_PRIVATE_MIB 0 #endif /** * Only allow SNMP write actions that are 'safe' (e.g. disabeling netifs is not * a safe action and disabled when SNMP_SAFE_REQUESTS = 1). * Unsafe requests are disabled by default! */ #ifndef SNMP_SAFE_REQUESTS #define SNMP_SAFE_REQUESTS 1 #endif /** * The maximum length of strings used. This affects the size of * MEMP_SNMP_VALUE elements. */ #ifndef SNMP_MAX_OCTET_STRING_LEN #define SNMP_MAX_OCTET_STRING_LEN 127 #endif /** * The maximum depth of the SNMP tree. * With private MIBs enabled, this depends on your MIB! * This affects the size of MEMP_SNMP_VALUE elements. */ #ifndef SNMP_MAX_TREE_DEPTH #define SNMP_MAX_TREE_DEPTH 15 #endif /** * The size of the MEMP_SNMP_VALUE elements, normally calculated from * SNMP_MAX_OCTET_STRING_LEN and SNMP_MAX_TREE_DEPTH. */ #ifndef SNMP_MAX_VALUE_SIZE #define SNMP_MAX_VALUE_SIZE LWIP_MAX((SNMP_MAX_OCTET_STRING_LEN)+1, sizeof(s32_t)*(SNMP_MAX_TREE_DEPTH)) #endif /* ---------------------------------- ---------- IGMP options ---------- ---------------------------------- */ /** * LWIP_IGMP==1: Turn on IGMP module. */ #ifndef LWIP_IGMP #define LWIP_IGMP 0 #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 */ #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 /** DNS message max. size. Default value is RFC compliant. */ #ifndef DNS_MSG_SIZE #define DNS_MSG_SIZE 512 #endif /** 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). */ #ifndef TCP_SND_BUF #define TCP_SND_BUF 256 #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 ((TCP_SND_BUF)/2) #endif /** * TCP_SNDQUEUELOWAT: TCP writable bufs (pbuf count). This must be grater * 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 ((TCP_SND_QUEUELEN)/2) #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. */ #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 (TCP_WND / 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. */ //#ifndef LWIP_EVENT_API //#define LWIP_EVENT_API 0 //#define LWIP_CALLBACK_API 1 //#else //#define LWIP_EVENT_API 1 //#define LWIP_CALLBACK_API 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 #define PBUF_LINK_HLEN (14 + ETH_PAD_SIZE) #endif /** * PBUF_POOL_BUFSIZE: the size of each pbuf in the pbuf pool. The default is * designed to accomodate 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_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 acquistion) */ #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_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 1 #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) and loopif.c */ #ifndef LWIP_HAVE_LOOPIF #define LWIP_HAVE_LOOPIF 1 #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 /** * PPP_THREAD_NAME: The name assigned to the pppInputThread. */ #ifndef PPP_THREAD_NAME #define PPP_THREAD_NAME "pppInputThread" #endif /** * PPP_THREAD_STACKSIZE: The stack size used by the pppInputThread. * The stack size value itself is platform-dependent, but is passed to * sys_thread_new() when the thread is created. */ #ifndef PPP_THREAD_STACKSIZE #define PPP_THREAD_STACKSIZE 0 #endif /** * PPP_THREAD_PRIO: The priority assigned to the pppInputThread. * The priority value itself is platform-dependent, but is passed to * sys_thread_new() when the thread is created. */ #ifndef PPP_THREAD_PRIO #define PPP_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 0 #endif /** LWIP_TCPIP_TIMEOUT==1: Enable tcpip_timeout/tcpip_untimeout tod create * timers running in tcpip_thread from another thread. */ #ifndef LWIP_TCPIP_TIMEOUT #define LWIP_TCPIP_TIMEOUT 1 #endif /* ------------------------------------ ---------- Socket options ---------- ------------------------------------ */ /** * LWIP_SOCKET==1: Enable Socket API (require to use sockets.c) */ #ifndef LWIP_SOCKET #define LWIP_SOCKET 0 #endif /** * LWIP_COMPAT_SOCKETS==1: Enable BSD-style sockets functions names. * (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_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_RCVTIMEO==1: Enable SO_RCVTIMEO processing. */ #ifndef LWIP_SO_RCVTIMEO #define LWIP_SO_RCVTIMEO 0 #endif /** * LWIP_SO_RCVBUF==1: Enable SO_RCVBUF processing. */ #ifndef LWIP_SO_RCVBUF #define LWIP_SO_RCVBUF 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 /** * 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 /* ---------------------------------------- ---------- 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 #else #define LINK_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 #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 /** * PPPOS_SUPPORT==1: Enable PPP Over Serial */ #ifndef PPPOS_SUPPORT #define PPPOS_SUPPORT PPP_SUPPORT #endif #if PPP_SUPPORT /** * NUM_PPP: Max PPP sessions. */ #ifndef NUM_PPP #define NUM_PPP 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. CURRENTLY NOT SUPPORTED! DO NOT SET! */ #ifndef MSCHAP_SUPPORT #define MSCHAP_SUPPORT 0 #endif /** * CBCP_SUPPORT==1: Support CBCP. CURRENTLY NOT SUPPORTED! DO NOT SET! */ #ifndef CBCP_SUPPORT #define CBCP_SUPPORT 0 #endif /** * CCP_SUPPORT==1: Support CCP. CURRENTLY NOT SUPPORTED! DO NOT SET! */ #ifndef CCP_SUPPORT #define CCP_SUPPORT 0 #endif /** * VJ_SUPPORT==1: Support VJ header compression. */ #ifndef VJ_SUPPORT #define VJ_SUPPORT 0 #endif /** * MD5_SUPPORT==1: Support MD5 (see also CHAP). */ #ifndef MD5_SUPPORT #define MD5_SUPPORT 0 #endif /* * Timeouts */ #ifndef FSM_DEFTIMEOUT #define FSM_DEFTIMEOUT 6 /* Timeout time in seconds */ #endif #ifndef FSM_DEFMAXTERMREQS #define FSM_DEFMAXTERMREQS 2 /* Maximum Terminate-Request transmissions */ #endif #ifndef FSM_DEFMAXCONFREQS #define FSM_DEFMAXCONFREQS 10 /* Maximum Configure-Request transmissions */ #endif #ifndef FSM_DEFMAXNAKLOOPS #define FSM_DEFMAXNAKLOOPS 5 /* Maximum number of nak loops */ #endif #ifndef UPAP_DEFTIMEOUT #define UPAP_DEFTIMEOUT 6 /* Timeout (seconds) for retransmitting req */ #endif #ifndef UPAP_DEFREQTIME #define UPAP_DEFREQTIME 30 /* Time to wait for auth-req from peer */ #endif #ifndef CHAP_DEFTIMEOUT #define CHAP_DEFTIMEOUT 6 /* Timeout time in seconds */ #endif #ifndef CHAP_DEFTRANSMITS #define CHAP_DEFTRANSMITS 10 /* max # times to send challenge */ #endif /* Interval in seconds between keepalive echo requests, 0 to disable. */ #ifndef LCP_ECHOINTERVAL #define LCP_ECHOINTERVAL 0 #endif /* Number of unanswered echo requests before failure. */ #ifndef LCP_MAXECHOFAILS #define LCP_MAXECHOFAILS 3 #endif /* Max Xmit idle time (in jiffies) before resend flag char. */ #ifndef PPP_MAXIDLEFLAG #define PPP_MAXIDLEFLAG 100 #endif /* * Packet sizes * * Note - lcp shouldn't be allowed to negotiate stuff outside these * limits. See lcp.h in the pppd directory. * (XXX - these constants should simply be shared by lcp.c instead * of living in lcp.h) */ #define PPP_MTU 1500 /* Default MTU (size of Info field) */ #ifndef PPP_MAXMTU /* #define PPP_MAXMTU 65535 - (PPP_HDRLEN + PPP_FCSLEN) */ #define PPP_MAXMTU 1500 /* Largest MTU we allow */ #endif #define PPP_MINMTU 64 #define PPP_MRU 1500 /* default MRU = max length of info field */ #define PPP_MAXMRU 1500 /* Largest MRU we allow */ #ifndef PPP_DEFMRU #define PPP_DEFMRU 296 /* Try for this */ #endif #define PPP_MINMRU 128 /* No MRUs below this */ #ifndef MAXNAMELEN #define MAXNAMELEN 256 /* max length of hostname or name for auth */ #endif #ifndef MAXSECRETLEN #define MAXSECRETLEN 256 /* max length of password or secret */ #endif #endif /* PPP_SUPPORT */ /* -------------------------------------- ---------- Checksum options ---------- -------------------------------------- */ /** * 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_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 /** * 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 /* --------------------------------------- ---------- 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 /** * SNMP_MSG_DEBUG: Enable debugging for SNMP messages. */ #ifndef SNMP_MSG_DEBUG #define SNMP_MSG_DEBUG LWIP_DBG_OFF #endif /** * SNMP_MIB_DEBUG: Enable debugging for SNMP MIBs. */ #ifndef SNMP_MIB_DEBUG #define SNMP_MIB_DEBUG LWIP_DBG_OFF #endif /** * DNS_DEBUG: Enable debugging for DNS. */ #ifndef DNS_DEBUG #define DNS_DEBUG LWIP_DBG_OFF #endif #endif /* __LWIP_OPT_H__ */ ================================================ FILE: app/include/lwip/pbuf.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_PBUF_H__ #define __LWIP_PBUF_H__ #include "lwip/opt.h" #include "lwip/err.h" #ifdef __cplusplus extern "C" { #endif /** Currently, the pbuf_custom code is only needed for one specific configuration * of IP_FRAG */ #define LWIP_SUPPORT_CUSTOM_PBUF (IP_FRAG && !IP_FRAG_USES_STATIC_BUF && !LWIP_NETIF_TX_SINGLE_PBUF) #define PBUF_TRANSPORT_HLEN 20 #define PBUF_IP_HLEN 20 typedef enum { PBUF_TRANSPORT, PBUF_IP, PBUF_LINK, PBUF_RAW } pbuf_layer; typedef enum { PBUF_RAM, /* pbuf data is stored in RAM */ PBUF_ROM, /* pbuf data is stored in ROM */ PBUF_REF, /* pbuf comes from the pbuf pool */ PBUF_POOL, /* pbuf payload refers to RAM */ #ifdef EBUF_LWIP PBUF_ESF_RX /* pbuf payload is from WLAN */ #endif /* ESF_LWIP */ } 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 and pbuf_header handle such a a pbuf differently */ #define PBUF_FLAG_IS_CUSTOM 0x02U /** indicates this pbuf is UDP multicast to be looped back */ #define PBUF_FLAG_MCASTLOOP 0x04U 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; /* add a pointer for esf_buf */ void * eb; }; #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 */ /* 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)ICACHE_FLASH_ATTR; #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)ICACHE_FLASH_ATTR; #endif /* LWIP_SUPPORT_CUSTOM_PBUF */ void pbuf_realloc(struct pbuf *p, u16_t size)ICACHE_FLASH_ATTR; u8_t pbuf_header(struct pbuf *p, s16_t header_size)ICACHE_FLASH_ATTR; void pbuf_ref(struct pbuf *p)ICACHE_FLASH_ATTR; u8_t pbuf_free(struct pbuf *p)ICACHE_FLASH_ATTR; u8_t pbuf_clen(struct pbuf *p)ICACHE_FLASH_ATTR; void pbuf_cat(struct pbuf *head, struct pbuf *tail)ICACHE_FLASH_ATTR; void pbuf_chain(struct pbuf *head, struct pbuf *tail)ICACHE_FLASH_ATTR; struct pbuf *pbuf_dechain(struct pbuf *p)ICACHE_FLASH_ATTR; err_t pbuf_copy(struct pbuf *p_to, struct pbuf *p_from)ICACHE_FLASH_ATTR; u16_t pbuf_copy_partial(struct pbuf *p, void *dataptr, u16_t len, u16_t offset)ICACHE_FLASH_ATTR; err_t pbuf_take(struct pbuf *buf, const void *dataptr, u16_t len)ICACHE_FLASH_ATTR; struct pbuf *pbuf_coalesce(struct pbuf *p, pbuf_layer layer)ICACHE_FLASH_ATTR; #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)ICACHE_FLASH_ATTR; #endif /* LWIP_CHECKSUM_ON_COPY */ u8_t pbuf_get_at(struct pbuf* p, u16_t offset)ICACHE_FLASH_ATTR; u16_t pbuf_memcmp(struct pbuf* p, u16_t offset, const void* s2, u16_t n)ICACHE_FLASH_ATTR; u16_t pbuf_memfind(struct pbuf* p, const void* mem, u16_t mem_len, u16_t start_offset)ICACHE_FLASH_ATTR; u16_t pbuf_strstr(struct pbuf* p, const char* substr)ICACHE_FLASH_ATTR; #ifdef __cplusplus } #endif #endif /* __LWIP_PBUF_H__ */ ================================================ FILE: app/include/lwip/puck_def.h ================================================ /* * puck_def.h * * Created on: Jul 22, 2010 * Author: dtoma */ #ifndef PUCK_DEF_H_ #define PUCK_DEF_H_ #define INSTRUMENT_PORT 8760 #define INSTRUMENT_LENGTH 80 #define MDNS_NAME_LENGTH 68 //68 char* PUCK_SERVICE = NULL; //#define PUCK_SERVICE "_Escpressif._tcp.local" #define DNS_SD_SERVICE "_services._dns-sd._udp.local" #define SERVICE_DESCRIPTION "PUCK PROTOCOL" #define PUCK_SERVICE_LENGTH 30 #define UUID_LEN 16 #define DS_VERS_LEN 2 #define DS_SIZE_LEN 2 #define MAN_ID_LEN 4 #define MAN_MODEL_LEN 2 #define MAN_VERS_LEN 2 #define SER_NUM_LEN 4 #define NAME_LEN 64 #define PUCK_DATASHEET_SIZE 96 #define UUID_OFFSET 0 #define DS_VERS_OFFSET UUID_LEN + UUID_OFFSET #define DS_SIZE_OFFSET DS_VERS_LEN + DS_VERS_OFFSET #define MAN_ID_OFFSET DS_SIZE_LEN + DS_SIZE_OFFSET #define MAN_MODEL_OFFSET MAN_ID_LEN + MAN_ID_OFFSET #define MAN_VERS_OFFSET MAN_MODEL_LEN + MAN_MODEL_OFFSET #define SER_NUM_OFFSET MAN_VERS_LEN + MAN_VERS_OFFSET #define NAME_OFFSET SER_NUM_LEN + SER_NUM_OFFSET #endif /* __PUCK_DEF_H__ */ ================================================ FILE: app/include/lwip/raw.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_RAW_H__ #define __LWIP_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" #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, 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; }; /* The following functions is the application layer interface to the RAW code. */ struct raw_pcb * raw_new (u8_t proto)ICACHE_FLASH_ATTR; void raw_remove (struct raw_pcb *pcb)ICACHE_FLASH_ATTR; err_t raw_bind (struct raw_pcb *pcb, ip_addr_t *ipaddr)ICACHE_FLASH_ATTR; err_t raw_connect (struct raw_pcb *pcb, ip_addr_t *ipaddr)ICACHE_FLASH_ATTR; void raw_recv (struct raw_pcb *pcb, raw_recv_fn recv, void *recv_arg)ICACHE_FLASH_ATTR; err_t raw_sendto (struct raw_pcb *pcb, struct pbuf *p, ip_addr_t *ipaddr)ICACHE_FLASH_ATTR; err_t raw_send (struct raw_pcb *pcb, struct pbuf *p); /* The following functions are the lower layer interface to RAW. */ u8_t raw_input (struct pbuf *p, struct netif *inp)ICACHE_FLASH_ATTR; #define raw_init() /* Compatibility define, not init needed. */ #ifdef __cplusplus } #endif #endif /* LWIP_RAW */ #endif /* __LWIP_RAW_H__ */ ================================================ FILE: app/include/lwip/sio.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. */ /* * 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)ICACHE_FLASH_ATTR; #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)ICACHE_FLASH_ATTR; #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)ICACHE_FLASH_ATTR; #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)ICACHE_FLASH_ATTR; #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)ICACHE_FLASH_ATTR; #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)ICACHE_FLASH_ATTR; #endif #ifndef sio_read_abort /** * Aborts a blocking sio_read() call. * * @param fd serial device handle */ void sio_read_abort(sio_fd_t fd)ICACHE_FLASH_ATTR; #endif #ifdef __cplusplus } #endif #endif /* __SIO_H__ */ ================================================ FILE: app/include/lwip/snmp.h ================================================ /* * Copyright (c) 2001, 2002 Leon Woestenberg * Copyright (c) 2001, 2002 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_SNMP_H__ #define __LWIP_SNMP_H__ #include "lwip/opt.h" #ifdef __cplusplus extern "C" { #endif #include "lwip/ip_addr.h" struct udp_pcb; struct netif; /** * @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 }; #if LWIP_SNMP /* don't build if not configured for use in lwipopts.h */ /** SNMP "sysuptime" Interval */ #define SNMP_SYSUPTIME_INTERVAL 10 /** fixed maximum length for object identifier type */ #define LWIP_SNMP_OBJ_ID_LEN 32 /** internal object identifier representation */ struct snmp_obj_id { u8_t len; s32_t id[LWIP_SNMP_OBJ_ID_LEN]; }; /* system */ void snmp_set_sysdesr(u8_t* str, u8_t* len); void snmp_set_sysobjid(struct snmp_obj_id *oid); void snmp_get_sysobjid_ptr(struct snmp_obj_id **oid); void snmp_inc_sysuptime(void); void snmp_add_sysuptime(u32_t value); void snmp_get_sysuptime(u32_t *value); void snmp_set_syscontact(u8_t *ocstr, u8_t *ocstrlen); void snmp_set_sysname(u8_t *ocstr, u8_t *ocstrlen); void snmp_set_syslocation(u8_t *ocstr, u8_t *ocstrlen); /* network interface */ void snmp_add_ifinoctets(struct netif *ni, u32_t value); void snmp_inc_ifinucastpkts(struct netif *ni); void snmp_inc_ifinnucastpkts(struct netif *ni); void snmp_inc_ifindiscards(struct netif *ni); void snmp_add_ifoutoctets(struct netif *ni, u32_t value); void snmp_inc_ifoutucastpkts(struct netif *ni); void snmp_inc_ifoutnucastpkts(struct netif *ni); void snmp_inc_ifoutdiscards(struct netif *ni); void snmp_inc_iflist(void); void snmp_dec_iflist(void); /* ARP (for atTable and ipNetToMediaTable) */ void snmp_insert_arpidx_tree(struct netif *ni, ip_addr_t *ip); void snmp_delete_arpidx_tree(struct netif *ni, ip_addr_t *ip); /* IP */ void snmp_inc_ipinreceives(void); void snmp_inc_ipinhdrerrors(void); void snmp_inc_ipinaddrerrors(void); void snmp_inc_ipforwdatagrams(void); void snmp_inc_ipinunknownprotos(void); void snmp_inc_ipindiscards(void); void snmp_inc_ipindelivers(void); void snmp_inc_ipoutrequests(void); void snmp_inc_ipoutdiscards(void); void snmp_inc_ipoutnoroutes(void); void snmp_inc_ipreasmreqds(void); void snmp_inc_ipreasmoks(void); void snmp_inc_ipreasmfails(void); void snmp_inc_ipfragoks(void); void snmp_inc_ipfragfails(void); void snmp_inc_ipfragcreates(void); void snmp_inc_iproutingdiscards(void); void snmp_insert_ipaddridx_tree(struct netif *ni); void snmp_delete_ipaddridx_tree(struct netif *ni); void snmp_insert_iprteidx_tree(u8_t dflt, struct netif *ni); void snmp_delete_iprteidx_tree(u8_t dflt, struct netif *ni); /* ICMP */ void snmp_inc_icmpinmsgs(void); void snmp_inc_icmpinerrors(void); void snmp_inc_icmpindestunreachs(void); void snmp_inc_icmpintimeexcds(void); void snmp_inc_icmpinparmprobs(void); void snmp_inc_icmpinsrcquenchs(void); void snmp_inc_icmpinredirects(void); void snmp_inc_icmpinechos(void); void snmp_inc_icmpinechoreps(void); void snmp_inc_icmpintimestamps(void); void snmp_inc_icmpintimestampreps(void); void snmp_inc_icmpinaddrmasks(void); void snmp_inc_icmpinaddrmaskreps(void); void snmp_inc_icmpoutmsgs(void); void snmp_inc_icmpouterrors(void); void snmp_inc_icmpoutdestunreachs(void); void snmp_inc_icmpouttimeexcds(void); void snmp_inc_icmpoutparmprobs(void); void snmp_inc_icmpoutsrcquenchs(void); void snmp_inc_icmpoutredirects(void); void snmp_inc_icmpoutechos(void); void snmp_inc_icmpoutechoreps(void); void snmp_inc_icmpouttimestamps(void); void snmp_inc_icmpouttimestampreps(void); void snmp_inc_icmpoutaddrmasks(void); void snmp_inc_icmpoutaddrmaskreps(void); /* TCP */ void snmp_inc_tcpactiveopens(void); void snmp_inc_tcppassiveopens(void); void snmp_inc_tcpattemptfails(void); void snmp_inc_tcpestabresets(void); void snmp_inc_tcpinsegs(void); void snmp_inc_tcpoutsegs(void); void snmp_inc_tcpretranssegs(void); void snmp_inc_tcpinerrs(void); void snmp_inc_tcpoutrsts(void); /* UDP */ void snmp_inc_udpindatagrams(void); void snmp_inc_udpnoports(void); void snmp_inc_udpinerrors(void); void snmp_inc_udpoutdatagrams(void); void snmp_insert_udpidx_tree(struct udp_pcb *pcb); void snmp_delete_udpidx_tree(struct udp_pcb *pcb); /* SNMP */ void snmp_inc_snmpinpkts(void); void snmp_inc_snmpoutpkts(void); void snmp_inc_snmpinbadversions(void); void snmp_inc_snmpinbadcommunitynames(void); void snmp_inc_snmpinbadcommunityuses(void); void snmp_inc_snmpinasnparseerrs(void); void snmp_inc_snmpintoobigs(void); void snmp_inc_snmpinnosuchnames(void); void snmp_inc_snmpinbadvalues(void); void snmp_inc_snmpinreadonlys(void); void snmp_inc_snmpingenerrs(void); void snmp_add_snmpintotalreqvars(u8_t value); void snmp_add_snmpintotalsetvars(u8_t value); void snmp_inc_snmpingetrequests(void); void snmp_inc_snmpingetnexts(void); void snmp_inc_snmpinsetrequests(void); void snmp_inc_snmpingetresponses(void); void snmp_inc_snmpintraps(void); void snmp_inc_snmpouttoobigs(void); void snmp_inc_snmpoutnosuchnames(void); void snmp_inc_snmpoutbadvalues(void); void snmp_inc_snmpoutgenerrs(void); void snmp_inc_snmpoutgetrequests(void); void snmp_inc_snmpoutgetnexts(void); void snmp_inc_snmpoutsetrequests(void); void snmp_inc_snmpoutgetresponses(void); void snmp_inc_snmpouttraps(void); void snmp_get_snmpgrpid_ptr(struct snmp_obj_id **oid); void snmp_set_snmpenableauthentraps(u8_t *value); void snmp_get_snmpenableauthentraps(u8_t *value); /* LWIP_SNMP support not available */ /* define everything to be empty */ #else /* system */ #define snmp_set_sysdesr(str, len) #define snmp_set_sysobjid(oid); #define snmp_get_sysobjid_ptr(oid) #define snmp_inc_sysuptime() #define snmp_add_sysuptime(value) #define snmp_get_sysuptime(value) #define snmp_set_syscontact(ocstr, ocstrlen); #define snmp_set_sysname(ocstr, ocstrlen); #define snmp_set_syslocation(ocstr, ocstrlen); /* network interface */ #define snmp_add_ifinoctets(ni,value) #define snmp_inc_ifinucastpkts(ni) #define snmp_inc_ifinnucastpkts(ni) #define snmp_inc_ifindiscards(ni) #define snmp_add_ifoutoctets(ni,value) #define snmp_inc_ifoutucastpkts(ni) #define snmp_inc_ifoutnucastpkts(ni) #define snmp_inc_ifoutdiscards(ni) #define snmp_inc_iflist() #define snmp_dec_iflist() /* ARP */ #define snmp_insert_arpidx_tree(ni,ip) #define snmp_delete_arpidx_tree(ni,ip) /* IP */ #define snmp_inc_ipinreceives() #define snmp_inc_ipinhdrerrors() #define snmp_inc_ipinaddrerrors() #define snmp_inc_ipforwdatagrams() #define snmp_inc_ipinunknownprotos() #define snmp_inc_ipindiscards() #define snmp_inc_ipindelivers() #define snmp_inc_ipoutrequests() #define snmp_inc_ipoutdiscards() #define snmp_inc_ipoutnoroutes() #define snmp_inc_ipreasmreqds() #define snmp_inc_ipreasmoks() #define snmp_inc_ipreasmfails() #define snmp_inc_ipfragoks() #define snmp_inc_ipfragfails() #define snmp_inc_ipfragcreates() #define snmp_inc_iproutingdiscards() #define snmp_insert_ipaddridx_tree(ni) #define snmp_delete_ipaddridx_tree(ni) #define snmp_insert_iprteidx_tree(dflt, ni) #define snmp_delete_iprteidx_tree(dflt, ni) /* ICMP */ #define snmp_inc_icmpinmsgs() #define snmp_inc_icmpinerrors() #define snmp_inc_icmpindestunreachs() #define snmp_inc_icmpintimeexcds() #define snmp_inc_icmpinparmprobs() #define snmp_inc_icmpinsrcquenchs() #define snmp_inc_icmpinredirects() #define snmp_inc_icmpinechos() #define snmp_inc_icmpinechoreps() #define snmp_inc_icmpintimestamps() #define snmp_inc_icmpintimestampreps() #define snmp_inc_icmpinaddrmasks() #define snmp_inc_icmpinaddrmaskreps() #define snmp_inc_icmpoutmsgs() #define snmp_inc_icmpouterrors() #define snmp_inc_icmpoutdestunreachs() #define snmp_inc_icmpouttimeexcds() #define snmp_inc_icmpoutparmprobs() #define snmp_inc_icmpoutsrcquenchs() #define snmp_inc_icmpoutredirects() #define snmp_inc_icmpoutechos() #define snmp_inc_icmpoutechoreps() #define snmp_inc_icmpouttimestamps() #define snmp_inc_icmpouttimestampreps() #define snmp_inc_icmpoutaddrmasks() #define snmp_inc_icmpoutaddrmaskreps() /* TCP */ #define snmp_inc_tcpactiveopens() #define snmp_inc_tcppassiveopens() #define snmp_inc_tcpattemptfails() #define snmp_inc_tcpestabresets() #define snmp_inc_tcpinsegs() #define snmp_inc_tcpoutsegs() #define snmp_inc_tcpretranssegs() #define snmp_inc_tcpinerrs() #define snmp_inc_tcpoutrsts() /* UDP */ #define snmp_inc_udpindatagrams() #define snmp_inc_udpnoports() #define snmp_inc_udpinerrors() #define snmp_inc_udpoutdatagrams() #define snmp_insert_udpidx_tree(pcb) #define snmp_delete_udpidx_tree(pcb) /* SNMP */ #define snmp_inc_snmpinpkts() #define snmp_inc_snmpoutpkts() #define snmp_inc_snmpinbadversions() #define snmp_inc_snmpinbadcommunitynames() #define snmp_inc_snmpinbadcommunityuses() #define snmp_inc_snmpinasnparseerrs() #define snmp_inc_snmpintoobigs() #define snmp_inc_snmpinnosuchnames() #define snmp_inc_snmpinbadvalues() #define snmp_inc_snmpinreadonlys() #define snmp_inc_snmpingenerrs() #define snmp_add_snmpintotalreqvars(value) #define snmp_add_snmpintotalsetvars(value) #define snmp_inc_snmpingetrequests() #define snmp_inc_snmpingetnexts() #define snmp_inc_snmpinsetrequests() #define snmp_inc_snmpingetresponses() #define snmp_inc_snmpintraps() #define snmp_inc_snmpouttoobigs() #define snmp_inc_snmpoutnosuchnames() #define snmp_inc_snmpoutbadvalues() #define snmp_inc_snmpoutgenerrs() #define snmp_inc_snmpoutgetrequests() #define snmp_inc_snmpoutgetnexts() #define snmp_inc_snmpoutsetrequests() #define snmp_inc_snmpoutgetresponses() #define snmp_inc_snmpouttraps() #define snmp_get_snmpgrpid_ptr(oid) #define snmp_set_snmpenableauthentraps(value) #define snmp_get_snmpenableauthentraps(value) #endif /* LWIP_SNMP */ #ifdef __cplusplus } #endif #endif /* __LWIP_SNMP_H__ */ ================================================ FILE: app/include/lwip/snmp_asn1.h ================================================ /** * @file * Abstract Syntax Notation One (ISO 8824, 8825) codec. */ /* * Copyright (c) 2006 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. * * Author: Christiaan Simons */ #ifndef __LWIP_SNMP_ASN1_H__ #define __LWIP_SNMP_ASN1_H__ #include "lwip/opt.h" #include "lwip/err.h" #include "lwip/pbuf.h" #include "lwip/snmp.h" #if LWIP_SNMP #ifdef __cplusplus extern "C" { #endif #define SNMP_ASN1_UNIV (0) /* (!0x80 | !0x40) */ #define SNMP_ASN1_APPLIC (0x40) /* (!0x80 | 0x40) */ #define SNMP_ASN1_CONTXT (0x80) /* ( 0x80 | !0x40) */ #define SNMP_ASN1_CONSTR (0x20) /* ( 0x20) */ #define SNMP_ASN1_PRIMIT (0) /* (!0x20) */ /* universal tags */ #define SNMP_ASN1_INTEG 2 #define SNMP_ASN1_OC_STR 4 #define SNMP_ASN1_NUL 5 #define SNMP_ASN1_OBJ_ID 6 #define SNMP_ASN1_SEQ 16 /* application specific (SNMP) tags */ #define SNMP_ASN1_IPADDR 0 /* octet string size(4) */ #define SNMP_ASN1_COUNTER 1 /* u32_t */ #define SNMP_ASN1_GAUGE 2 /* u32_t */ #define SNMP_ASN1_TIMETICKS 3 /* u32_t */ #define SNMP_ASN1_OPAQUE 4 /* octet string */ /* context specific (SNMP) tags */ #define SNMP_ASN1_PDU_GET_REQ 0 #define SNMP_ASN1_PDU_GET_NEXT_REQ 1 #define SNMP_ASN1_PDU_GET_RESP 2 #define SNMP_ASN1_PDU_SET_REQ 3 #define SNMP_ASN1_PDU_TRAP 4 err_t snmp_asn1_dec_type(struct pbuf *p, u16_t ofs, u8_t *type); err_t snmp_asn1_dec_length(struct pbuf *p, u16_t ofs, u8_t *octets_used, u16_t *length); err_t snmp_asn1_dec_u32t(struct pbuf *p, u16_t ofs, u16_t len, u32_t *value); err_t snmp_asn1_dec_s32t(struct pbuf *p, u16_t ofs, u16_t len, s32_t *value); err_t snmp_asn1_dec_oid(struct pbuf *p, u16_t ofs, u16_t len, struct snmp_obj_id *oid); err_t snmp_asn1_dec_raw(struct pbuf *p, u16_t ofs, u16_t len, u16_t raw_len, u8_t *raw); void snmp_asn1_enc_length_cnt(u16_t length, u8_t *octets_needed); void snmp_asn1_enc_u32t_cnt(u32_t value, u16_t *octets_needed); void snmp_asn1_enc_s32t_cnt(s32_t value, u16_t *octets_needed); void snmp_asn1_enc_oid_cnt(u8_t ident_len, s32_t *ident, u16_t *octets_needed); err_t snmp_asn1_enc_type(struct pbuf *p, u16_t ofs, u8_t type); err_t snmp_asn1_enc_length(struct pbuf *p, u16_t ofs, u16_t length); err_t snmp_asn1_enc_u32t(struct pbuf *p, u16_t ofs, u16_t octets_needed, u32_t value); err_t snmp_asn1_enc_s32t(struct pbuf *p, u16_t ofs, u16_t octets_needed, s32_t value); err_t snmp_asn1_enc_oid(struct pbuf *p, u16_t ofs, u8_t ident_len, s32_t *ident); err_t snmp_asn1_enc_raw(struct pbuf *p, u16_t ofs, u16_t raw_len, u8_t *raw); #ifdef __cplusplus } #endif #endif /* LWIP_SNMP */ #endif /* __LWIP_SNMP_ASN1_H__ */ ================================================ FILE: app/include/lwip/snmp_msg.h ================================================ /** * @file * SNMP Agent message handling structures. */ /* * Copyright (c) 2006 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. * * Author: Christiaan Simons */ #ifndef __LWIP_SNMP_MSG_H__ #define __LWIP_SNMP_MSG_H__ #include "lwip/opt.h" #include "lwip/snmp.h" #include "lwip/snmp_structs.h" #include "lwip/ip_addr.h" #include "lwip/err.h" #if LWIP_SNMP #if SNMP_PRIVATE_MIB /* When using a private MIB, you have to create a file 'private_mib.h' that contains * a 'struct mib_array_node mib_private' which contains your MIB. */ #include "private_mib.h" #endif #ifdef __cplusplus extern "C" { #endif /* The listen port of the SNMP agent. Clients have to make their requests to this port. Most standard clients won't work if you change this! */ #ifndef SNMP_IN_PORT #define SNMP_IN_PORT 161 #endif /* The remote port the SNMP agent sends traps to. Most standard trap sinks won't work if you change this! */ #ifndef SNMP_TRAP_PORT #define SNMP_TRAP_PORT 162 #endif #define SNMP_ES_NOERROR 0 #define SNMP_ES_TOOBIG 1 #define SNMP_ES_NOSUCHNAME 2 #define SNMP_ES_BADVALUE 3 #define SNMP_ES_READONLY 4 #define SNMP_ES_GENERROR 5 #define SNMP_GENTRAP_COLDSTART 0 #define SNMP_GENTRAP_WARMSTART 1 #define SNMP_GENTRAP_AUTHFAIL 4 #define SNMP_GENTRAP_ENTERPRISESPC 6 struct snmp_varbind { /* next pointer, NULL for last in list */ struct snmp_varbind *next; /* previous pointer, NULL for first in list */ struct snmp_varbind *prev; /* object identifier length (in s32_t) */ u8_t ident_len; /* object identifier array */ s32_t *ident; /* object value ASN1 type */ u8_t value_type; /* object value length (in u8_t) */ u8_t value_len; /* object value */ void *value; /* encoding varbind seq length length */ u8_t seqlenlen; /* encoding object identifier length length */ u8_t olenlen; /* encoding object value length length */ u8_t vlenlen; /* encoding varbind seq length */ u16_t seqlen; /* encoding object identifier length */ u16_t olen; /* encoding object value length */ u16_t vlen; }; struct snmp_varbind_root { struct snmp_varbind *head; struct snmp_varbind *tail; /* number of variable bindings in list */ u8_t count; /* encoding varbind-list seq length length */ u8_t seqlenlen; /* encoding varbind-list seq length */ u16_t seqlen; }; /** output response message header length fields */ struct snmp_resp_header_lengths { /* encoding error-index length length */ u8_t erridxlenlen; /* encoding error-status length length */ u8_t errstatlenlen; /* encoding request id length length */ u8_t ridlenlen; /* encoding pdu length length */ u8_t pdulenlen; /* encoding community length length */ u8_t comlenlen; /* encoding version length length */ u8_t verlenlen; /* encoding sequence length length */ u8_t seqlenlen; /* encoding error-index length */ u16_t erridxlen; /* encoding error-status length */ u16_t errstatlen; /* encoding request id length */ u16_t ridlen; /* encoding pdu length */ u16_t pdulen; /* encoding community length */ u16_t comlen; /* encoding version length */ u16_t verlen; /* encoding sequence length */ u16_t seqlen; }; /** output response message header length fields */ struct snmp_trap_header_lengths { /* encoding timestamp length length */ u8_t tslenlen; /* encoding specific-trap length length */ u8_t strplenlen; /* encoding generic-trap length length */ u8_t gtrplenlen; /* encoding agent-addr length length */ u8_t aaddrlenlen; /* encoding enterprise-id length length */ u8_t eidlenlen; /* encoding pdu length length */ u8_t pdulenlen; /* encoding community length length */ u8_t comlenlen; /* encoding version length length */ u8_t verlenlen; /* encoding sequence length length */ u8_t seqlenlen; /* encoding timestamp length */ u16_t tslen; /* encoding specific-trap length */ u16_t strplen; /* encoding generic-trap length */ u16_t gtrplen; /* encoding agent-addr length */ u16_t aaddrlen; /* encoding enterprise-id length */ u16_t eidlen; /* encoding pdu length */ u16_t pdulen; /* encoding community length */ u16_t comlen; /* encoding version length */ u16_t verlen; /* encoding sequence length */ u16_t seqlen; }; /* Accepting new SNMP messages. */ #define SNMP_MSG_EMPTY 0 /* Search for matching object for variable binding. */ #define SNMP_MSG_SEARCH_OBJ 1 /* Perform SNMP operation on in-memory object. Pass-through states, for symmetry only. */ #define SNMP_MSG_INTERNAL_GET_OBJDEF 2 #define SNMP_MSG_INTERNAL_GET_VALUE 3 #define SNMP_MSG_INTERNAL_SET_TEST 4 #define SNMP_MSG_INTERNAL_GET_OBJDEF_S 5 #define SNMP_MSG_INTERNAL_SET_VALUE 6 /* Perform SNMP operation on object located externally. In theory this could be used for building a proxy agent. Practical use is for an enterprise spc. app. gateway. */ #define SNMP_MSG_EXTERNAL_GET_OBJDEF 7 #define SNMP_MSG_EXTERNAL_GET_VALUE 8 #define SNMP_MSG_EXTERNAL_SET_TEST 9 #define SNMP_MSG_EXTERNAL_GET_OBJDEF_S 10 #define SNMP_MSG_EXTERNAL_SET_VALUE 11 #define SNMP_COMMUNITY_STR_LEN 64 struct snmp_msg_pstat { /* lwIP local port (161) binding */ struct udp_pcb *pcb; /* source IP address */ ip_addr_t sip; /* source UDP port */ u16_t sp; /* request type */ u8_t rt; /* request ID */ s32_t rid; /* error status */ s32_t error_status; /* error index */ s32_t error_index; /* community name (zero terminated) */ u8_t community[SNMP_COMMUNITY_STR_LEN + 1]; /* community string length (exclusive zero term) */ u8_t com_strlen; /* one out of MSG_EMPTY, MSG_DEMUX, MSG_INTERNAL, MSG_EXTERNAL_x */ u8_t state; /* saved arguments for MSG_EXTERNAL_x */ struct mib_external_node *ext_mib_node; struct snmp_name_ptr ext_name_ptr; struct obj_def ext_object_def; struct snmp_obj_id ext_oid; /* index into input variable binding list */ u8_t vb_idx; /* ptr into input variable binding list */ struct snmp_varbind *vb_ptr; /* list of variable bindings from input */ struct snmp_varbind_root invb; /* list of variable bindings to output */ struct snmp_varbind_root outvb; /* output response lengths used in ASN encoding */ struct snmp_resp_header_lengths rhl; }; struct snmp_msg_trap { /* lwIP local port (161) binding */ struct udp_pcb *pcb; /* destination IP address in network order */ ip_addr_t dip; /* source enterprise ID (sysObjectID) */ struct snmp_obj_id *enterprise; /* source IP address, raw network order format */ u8_t sip_raw[4]; /* generic trap code */ u32_t gen_trap; /* specific trap code */ u32_t spc_trap; /* timestamp */ u32_t ts; /* list of variable bindings to output */ struct snmp_varbind_root outvb; /* output trap lengths used in ASN encoding */ struct snmp_trap_header_lengths thl; }; /** Agent Version constant, 0 = v1 oddity */ extern const s32_t snmp_version; /** Agent default "public" community string */ extern const char snmp_publiccommunity[7]; extern struct snmp_msg_trap trap_msg; /** Agent setup, start listening to port 161. */ void snmp_init(void); void snmp_trap_dst_enable(u8_t dst_idx, u8_t enable); void snmp_trap_dst_ip_set(u8_t dst_idx, ip_addr_t *dst); /** Varbind-list functions. */ struct snmp_varbind* snmp_varbind_alloc(struct snmp_obj_id *oid, u8_t type, u8_t len); void snmp_varbind_free(struct snmp_varbind *vb); void snmp_varbind_list_free(struct snmp_varbind_root *root); void snmp_varbind_tail_add(struct snmp_varbind_root *root, struct snmp_varbind *vb); struct snmp_varbind* snmp_varbind_tail_remove(struct snmp_varbind_root *root); /** Handle an internal (recv) or external (private response) event. */ void snmp_msg_event(u8_t request_id); err_t snmp_send_response(struct snmp_msg_pstat *m_stat); err_t snmp_send_trap(s8_t generic_trap, struct snmp_obj_id *eoid, s32_t specific_trap); void snmp_coldstart_trap(void); void snmp_authfail_trap(void); #ifdef __cplusplus } #endif #endif /* LWIP_SNMP */ #endif /* __LWIP_SNMP_MSG_H__ */ ================================================ FILE: app/include/lwip/snmp_structs.h ================================================ /** * @file * Generic MIB tree structures. * * @todo namespace prefixes */ /* * Copyright (c) 2006 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. * * Author: Christiaan Simons */ #ifndef __LWIP_SNMP_STRUCTS_H__ #define __LWIP_SNMP_STRUCTS_H__ #include "lwip/opt.h" #if LWIP_SNMP /* don't build if not configured for use in lwipopts.h */ #include "lwip/snmp.h" #if SNMP_PRIVATE_MIB /* When using a private MIB, you have to create a file 'private_mib.h' that contains * a 'struct mib_array_node mib_private' which contains your MIB. */ #include "private_mib.h" #endif #ifdef __cplusplus extern "C" { #endif /* MIB object instance */ #define MIB_OBJECT_NONE 0 #define MIB_OBJECT_SCALAR 1 #define MIB_OBJECT_TAB 2 /* MIB access types */ #define MIB_ACCESS_READ 1 #define MIB_ACCESS_WRITE 2 /* MIB object access */ #define MIB_OBJECT_READ_ONLY MIB_ACCESS_READ #define MIB_OBJECT_READ_WRITE (MIB_ACCESS_READ | MIB_ACCESS_WRITE) #define MIB_OBJECT_WRITE_ONLY MIB_ACCESS_WRITE #define MIB_OBJECT_NOT_ACCESSIBLE 0 /** object definition returned by (get_object_def)() */ struct obj_def { /* MIB_OBJECT_NONE (0), MIB_OBJECT_SCALAR (1), MIB_OBJECT_TAB (2) */ u8_t instance; /* 0 read-only, 1 read-write, 2 write-only, 3 not-accessible */ u8_t access; /* ASN type for this object */ u8_t asn_type; /* value length (host length) */ u16_t v_len; /* length of instance part of supplied object identifier */ u8_t id_inst_len; /* instance part of supplied object identifier */ s32_t *id_inst_ptr; }; struct snmp_name_ptr { u8_t ident_len; s32_t *ident; }; /** MIB const scalar (.0) node */ #define MIB_NODE_SC 0x01 /** MIB const array node */ #define MIB_NODE_AR 0x02 /** MIB array node (mem_malloced from RAM) */ #define MIB_NODE_RA 0x03 /** MIB list root node (mem_malloced from RAM) */ #define MIB_NODE_LR 0x04 /** MIB node for external objects */ #define MIB_NODE_EX 0x05 /** node "base class" layout, the mandatory fields for a node */ struct mib_node { /** returns struct obj_def for the given object identifier */ void (*get_object_def)(u8_t ident_len, s32_t *ident, struct obj_def *od); /** returns object value for the given object identifier, @note the caller must allocate at least len bytes for the value */ void (*get_value)(struct obj_def *od, u16_t len, void *value); /** tests length and/or range BEFORE setting */ u8_t (*set_test)(struct obj_def *od, u16_t len, void *value); /** sets object value, only to be called when set_test() */ void (*set_value)(struct obj_def *od, u16_t len, void *value); /** One out of MIB_NODE_AR, MIB_NODE_LR or MIB_NODE_EX */ u8_t node_type; /* array or max list length */ u16_t maxlength; }; /** derived node for scalars .0 index */ typedef struct mib_node mib_scalar_node; /** derived node, points to a fixed size const array of sub-identifiers plus a 'child' pointer */ struct mib_array_node { /* inherited "base class" members */ void (*get_object_def)(u8_t ident_len, s32_t *ident, struct obj_def *od); void (*get_value)(struct obj_def *od, u16_t len, void *value); u8_t (*set_test)(struct obj_def *od, u16_t len, void *value); void (*set_value)(struct obj_def *od, u16_t len, void *value); u8_t node_type; u16_t maxlength; /* additional struct members */ const s32_t *objid; struct mib_node* const *nptr; }; /** derived node, points to a fixed size mem_malloced array of sub-identifiers plus a 'child' pointer */ struct mib_ram_array_node { /* inherited "base class" members */ void (*get_object_def)(u8_t ident_len, s32_t *ident, struct obj_def *od); void (*get_value)(struct obj_def *od, u16_t len, void *value); u8_t (*set_test)(struct obj_def *od, u16_t len, void *value); void (*set_value)(struct obj_def *od, u16_t len, void *value); u8_t node_type; u16_t maxlength; /* aditional struct members */ s32_t *objid; struct mib_node **nptr; }; struct mib_list_node { struct mib_list_node *prev; struct mib_list_node *next; s32_t objid; struct mib_node *nptr; }; /** derived node, points to a doubly linked list of sub-identifiers plus a 'child' pointer */ struct mib_list_rootnode { /* inherited "base class" members */ void (*get_object_def)(u8_t ident_len, s32_t *ident, struct obj_def *od); void (*get_value)(struct obj_def *od, u16_t len, void *value); u8_t (*set_test)(struct obj_def *od, u16_t len, void *value); void (*set_value)(struct obj_def *od, u16_t len, void *value); u8_t node_type; u16_t maxlength; /* additional struct members */ struct mib_list_node *head; struct mib_list_node *tail; /* counts list nodes in list */ u16_t count; }; /** derived node, has access functions for mib object in external memory or device using 'tree_level' and 'idx', with a range 0 .. (level_length() - 1) */ struct mib_external_node { /* inherited "base class" members */ void (*get_object_def)(u8_t ident_len, s32_t *ident, struct obj_def *od); void (*get_value)(struct obj_def *od, u16_t len, void *value); u8_t (*set_test)(struct obj_def *od, u16_t len, void *value); void (*set_value)(struct obj_def *od, u16_t len, void *value); u8_t node_type; u16_t maxlength; /* additional struct members */ /** points to an external (in memory) record of some sort of addressing information, passed to and interpreted by the funtions below */ void* addr_inf; /** tree levels under this node */ u8_t tree_levels; /** number of objects at this level */ u16_t (*level_length)(void* addr_inf, u8_t level); /** compares object sub identifier with external id return zero when equal, nonzero when unequal */ s32_t (*ident_cmp)(void* addr_inf, u8_t level, u16_t idx, s32_t sub_id); void (*get_objid)(void* addr_inf, u8_t level, u16_t idx, s32_t *sub_id); /** async Questions */ void (*get_object_def_q)(void* addr_inf, u8_t rid, u8_t ident_len, s32_t *ident); void (*get_value_q)(u8_t rid, struct obj_def *od); void (*set_test_q)(u8_t rid, struct obj_def *od); void (*set_value_q)(u8_t rid, struct obj_def *od, u16_t len, void *value); /** async Answers */ void (*get_object_def_a)(u8_t rid, u8_t ident_len, s32_t *ident, struct obj_def *od); void (*get_value_a)(u8_t rid, struct obj_def *od, u16_t len, void *value); u8_t (*set_test_a)(u8_t rid, struct obj_def *od, u16_t len, void *value); void (*set_value_a)(u8_t rid, struct obj_def *od, u16_t len, void *value); /** async Panic Close (agent returns error reply, e.g. used for external transaction cleanup) */ void (*get_object_def_pc)(u8_t rid, u8_t ident_len, s32_t *ident); void (*get_value_pc)(u8_t rid, struct obj_def *od); void (*set_test_pc)(u8_t rid, struct obj_def *od); void (*set_value_pc)(u8_t rid, struct obj_def *od); }; /** export MIB tree from mib2.c */ extern const struct mib_array_node internet; /** dummy function pointers for non-leaf MIB nodes from mib2.c */ void noleafs_get_object_def(u8_t ident_len, s32_t *ident, struct obj_def *od); void noleafs_get_value(struct obj_def *od, u16_t len, void *value); u8_t noleafs_set_test(struct obj_def *od, u16_t len, void *value); void noleafs_set_value(struct obj_def *od, u16_t len, void *value); void snmp_oidtoip(s32_t *ident, ip_addr_t *ip); void snmp_iptooid(ip_addr_t *ip, s32_t *ident); void snmp_ifindextonetif(s32_t ifindex, struct netif **netif); void snmp_netiftoifindex(struct netif *netif, s32_t *ifidx); struct mib_list_node* snmp_mib_ln_alloc(s32_t id); void snmp_mib_ln_free(struct mib_list_node *ln); struct mib_list_rootnode* snmp_mib_lrn_alloc(void); void snmp_mib_lrn_free(struct mib_list_rootnode *lrn); s8_t snmp_mib_node_insert(struct mib_list_rootnode *rn, s32_t objid, struct mib_list_node **insn); s8_t snmp_mib_node_find(struct mib_list_rootnode *rn, s32_t objid, struct mib_list_node **fn); struct mib_list_rootnode *snmp_mib_node_delete(struct mib_list_rootnode *rn, struct mib_list_node *n); struct mib_node* snmp_search_tree(struct mib_node *node, u8_t ident_len, s32_t *ident, struct snmp_name_ptr *np); struct mib_node* snmp_expand_tree(struct mib_node *node, u8_t ident_len, s32_t *ident, struct snmp_obj_id *oidret); u8_t snmp_iso_prefix_tst(u8_t ident_len, s32_t *ident); u8_t snmp_iso_prefix_expand(u8_t ident_len, s32_t *ident, struct snmp_obj_id *oidret); #ifdef __cplusplus } #endif #endif /* LWIP_SNMP */ #endif /* __LWIP_SNMP_STRUCTS_H__ */ ================================================ FILE: app/include/lwip/sntp.h ================================================ #ifndef LWIP_SNTP_H #define LWIP_SNTP_H #include "lwip/opt.h" #include "lwip/ip_addr.h" #ifdef __cplusplus extern "C" { #endif /** The maximum number of SNTP servers that can be set */ #ifndef SNTP_MAX_SERVERS #define SNTP_MAX_SERVERS 3 #endif /** Set this to 1 to implement the callback function called by dhcp when * NTP servers are received. */ #ifndef SNTP_GET_SERVERS_FROM_DHCP #define SNTP_GET_SERVERS_FROM_DHCP 0//LWIP_DHCP_GET_NTP_SRV #endif /* Set this to 1 to support DNS names (or IP address strings) to set sntp servers */ #ifndef SNTP_SERVER_DNS #define SNTP_SERVER_DNS 1 #endif /** One server address/name can be defined as default if SNTP_SERVER_DNS == 1: * #define SNTP_SERVER_ADDRESS "pool.ntp.org" */ uint32 sntp_get_current_timestamp(); char* sntp_get_real_time(long t); void sntp_init(void); void sntp_stop(void); sint8 sntp_get_timezone(void); bool sntp_set_timezone(sint8 timezone); void sntp_setserver(u8_t idx, ip_addr_t *addr); ip_addr_t sntp_getserver(u8_t idx); #if SNTP_SERVER_DNS void sntp_setservername(u8_t idx, char *server); char *sntp_getservername(u8_t idx); #endif /* SNTP_SERVER_DNS */ #if SNTP_GET_SERVERS_FROM_DHCP void sntp_servermode_dhcp(int set_servers_from_dhcp); #else /* SNTP_GET_SERVERS_FROM_DHCP */ #define sntp_servermode_dhcp(x) #endif /* SNTP_GET_SERVERS_FROM_DHCP */ #ifdef __cplusplus } #endif #endif /* LWIP_SNTP_H */ ================================================ FILE: app/include/lwip/sockets.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_SOCKETS_H__ #define __LWIP_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/inet.h" #ifdef __cplusplus extern "C" { #endif /* members are in network byte order */ struct sockaddr_in { u8_t sin_len; u8_t sin_family; u16_t sin_port; struct in_addr sin_addr; char sin_zero[8]; }; struct sockaddr { u8_t sa_len; u8_t sa_family; char sa_data[14]; }; #ifndef socklen_t # define socklen_t u32_t #endif /* 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_DEBUG 0x0001 /* Unimplemented: turn on debugging info recording */ #define SO_ACCEPTCONN 0x0002 /* socket has had listen() */ #define SO_REUSEADDR 0x0004 /* Allow local address reuse */ #define SO_KEEPALIVE 0x0008 /* keep connections alive */ #define SO_DONTROUTE 0x0010 /* Unimplemented: just use interface addresses */ #define SO_BROADCAST 0x0020 /* permit to send and to receive broadcast messages (see IP_SOF_BROADCAST option) */ #define SO_USELOOPBACK 0x0040 /* Unimplemented: bypass hardware when possible */ #define SO_LINGER 0x0080 /* linger on close if data present */ #define SO_OOBINLINE 0x0100 /* Unimplemented: leave received OOB data in line */ #define SO_REUSEPORT 0x0200 /* Unimplemented: allow local address & port reuse */ #define SO_DONTLINGER ((int)(~SO_LINGER)) /* * Additional options, not kept in so_options. */ #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 /* Unimplemented: 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 */ }; /* * 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 #define PF_INET AF_INET #define PF_UNSPEC AF_UNSPEC #define IPPROTO_IP 0 #define IPPROTO_TCP 6 #define IPPROTO_UDP 17 #define IPPROTO_UDPLITE 136 /* 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_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_IGMP /* * Options and types for UDP multicast traffic handling */ #define IP_ADD_MEMBERSHIP 3 #define IP_DROP_MEMBERSHIP 4 #define IP_MULTICAST_TTL 5 #define IP_MULTICAST_IF 6 #define IP_MULTICAST_LOOP 7 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 FD_SET(n, p) ((p)->fd_bits[(n)/8] |= (1 << ((n) & 7))) #define FD_CLR(n, p) ((p)->fd_bits[(n)/8] &= ~(1 << ((n) & 7))) #define FD_ISSET(n,p) ((p)->fd_bits[(n)/8] & (1 << ((n) & 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; #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 */ void lwip_socket_init(void); 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_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_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 #define accept(a,b,c) lwip_accept(a,b,c) #define bind(a,b,c) lwip_bind(a,b,c) #define shutdown(a,b) lwip_shutdown(a,b) #define closesocket(s) lwip_close(s) #define connect(a,b,c) lwip_connect(a,b,c) #define getsockname(a,b,c) lwip_getsockname(a,b,c) #define getpeername(a,b,c) lwip_getpeername(a,b,c) #define setsockopt(a,b,c,d,e) lwip_setsockopt(a,b,c,d,e) #define getsockopt(a,b,c,d,e) lwip_getsockopt(a,b,c,d,e) #define listen(a,b) lwip_listen(a,b) #define recv(a,b,c,d) lwip_recv(a,b,c,d) #define recvfrom(a,b,c,d,e,f) lwip_recvfrom(a,b,c,d,e,f) #define send(a,b,c,d) lwip_send(a,b,c,d) #define sendto(a,b,c,d,e,f) lwip_sendto(a,b,c,d,e,f) #define socket(a,b,c) lwip_socket(a,b,c) #define select(a,b,c,d,e) lwip_select(a,b,c,d,e) #define ioctlsocket(a,b,c) lwip_ioctl(a,b,c) #if LWIP_POSIX_SOCKETS_IO_NAMES #define read(a,b,c) lwip_read(a,b,c) #define write(a,b,c) lwip_write(a,b,c) #define close(s) lwip_close(s) #endif /* LWIP_POSIX_SOCKETS_IO_NAMES */ #endif /* LWIP_COMPAT_SOCKETS */ #ifdef __cplusplus } #endif #endif /* LWIP_SOCKET */ #endif /* __LWIP_SOCKETS_H__ */ ================================================ FILE: app/include/lwip/stats.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_STATS_H__ #define __LWIP_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 */ mem_size_t avail; mem_size_t used; mem_size_t max; STAT_COUNTER err; 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_ { #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 }; extern struct stats_ lwip_stats; void stats_init(void)ICACHE_FLASH_ATTR; #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) #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) #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) #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) #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 /* Display of statistics */ #if LWIP_STATS_DISPLAY void stats_display(void)ICACHE_FLASH_ATTR; void stats_display_proto(struct stats_proto *proto, char *name)ICACHE_FLASH_ATTR; void stats_display_igmp(struct stats_igmp *igmp)ICACHE_FLASH_ATTR; void stats_display_mem(struct stats_mem *mem, char *name)ICACHE_FLASH_ATTR; void stats_display_memp(struct stats_mem *mem, int index)ICACHE_FLASH_ATTR; void stats_display_sys(struct stats_sys *sys)ICACHE_FLASH_ATTR; #else /* LWIP_STATS_DISPLAY */ #define stats_display() #define stats_display_proto(proto, name) #define stats_display_igmp(igmp) #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_STATS_H__ */ ================================================ FILE: app/include/lwip/sys.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_SYS_H__ #define __LWIP_SYS_H__ #include "lwip/opt.h" #include "eagle_soc.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_mutex_new(mu) ERR_OK #define sys_mutex_lock(mu) #define sys_mutex_unlock(mu) #define sys_mutex_free(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_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 */ #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 sempahore 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 /* Time functions. */ #ifndef sys_msleep void sys_msleep(u32_t ms); /* only has a (close to) 1 jiffy resolution. */ #endif /* Mailbox functions. */ /** Create a new mbox of specified size * @param mbox pointer to the mbox to create * @param size (miminum) 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 * @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 timout 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 * @param timeout maximum time (in milliseconds) to wait for a message * @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 /** The only thread function: * Creates a new thread * @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 anthing else. */ void sys_init(void)ICACHE_FLASH_ATTR; #ifndef sys_jiffies /** Ticks/jiffies since power up. */ u32_t sys_jiffies(void)ICACHE_FLASH_ATTR; #endif /** Returns the current time in milliseconds, * may be the same as sys_jiffies or at least based on it. */ static inline u32_t sys_now(void) ICACHE_FLASH_ATTR; static inline u32_t sys_now(void) { return NOW()/(TIMER_CLK_FREQ/1000); } /* 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)ICACHE_FLASH_ATTR; void sys_arch_unprotect(sys_prot_t pval)ICACHE_FLASH_ATTR; #else #define SYS_ARCH_DECL_PROTECT(lev) #define SYS_ARCH_PROTECT(lev) lev = ets_intr_lock() //fix by ives at 2014.3.24 #define SYS_ARCH_UNPROTECT(lev) lev = ets_intr_unlock() #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_SYS_H__ */ ================================================ FILE: app/include/lwip/tcp.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_TCP_H__ #define __LWIP_TCP_H__ #include "lwip/opt.h" #if LWIP_TCP /* don't build if not configured for use in lwipopts.h */ #include "lwip/sys.h" #include "lwip/mem.h" #include "lwip/pbuf.h" #include "lwip/ip.h" #include "lwip/icmp.h" #include "lwip/err.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); 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 abortsthe 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 */ \ enum tcp_state state; /* TCP state */ \ u8_t prio; \ void *callback_arg; \ /* the accept callback for listen- and normal pcbs, if LWIP_CALLBACK_API */ \ DEF_ACCEPT_CALLBACK \ /* 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; u8_t flags; #define TF_ACK_DELAY ((u8_t)0x01U) /* Delayed ACK. */ #define TF_ACK_NOW ((u8_t)0x02U) /* Immediate ACK. */ #define TF_INFR ((u8_t)0x04U) /* In fast recovery. */ #define TF_TIMESTAMP ((u8_t)0x08U) /* Timestamp option enabled */ #define TF_RXCLOSED ((u8_t)0x10U) /* rx closed by tcp_shutdown */ #define TF_FIN ((u8_t)0x20U) /* Connection was closed locally (FIN segment enqueued). */ #define TF_NODELAY ((u8_t)0x40U) /* Disable Nagle algorithm */ #define TF_NAGLEMEMERR ((u8_t)0x80U) /* nagle enabled, memerr, try to output to prevent delayed ACK to happen */ /* the rest of the fields are in host byte order as we have to do some math with them */ /* receiver variables */ u32_t rcv_nxt; /* next seqno expected */ u16_t rcv_wnd; /* receiver window available */ u16_t rcv_ann_wnd; /* receiver window to announce */ u32_t rcv_ann_right_edge; /* announced right edge of window */ /* Timers */ u32_t tmr; u8_t polltmr, pollinterval; /* 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 */ u32_t lastack; /* Highest acknowledged seqno. */ u8_t dupacks; /* congestion avoidance/control variables */ u16_t cwnd; u16_t ssthresh; /* sender variables */ u32_t snd_nxt; /* next new seqno to be sent */ u16_t snd_wnd; /* sender window */ 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. */ u16_t acked; u16_t snd_buf; /* Available buffer space for sending (in bytes). */ #define TCP_SNDQUEUELEN_OVERFLOW (0xffff-3) u16_t snd_queuelen; /* Available buffer space for sending (in tcp_segs). */ #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 */ u32_t persist_cnt; /* Persist timer back-off */ u8_t persist_backoff; /* KEEPALIVE counter */ u8_t keep_cnt_sent; }; 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)ICACHE_FLASH_ATTR; void tcp_arg (struct tcp_pcb *pcb, void *arg) ICACHE_FLASH_ATTR; void tcp_accept (struct tcp_pcb *pcb, tcp_accept_fn accept) ICACHE_FLASH_ATTR; void tcp_recv (struct tcp_pcb *pcb, tcp_recv_fn recv) ICACHE_FLASH_ATTR; void tcp_sent (struct tcp_pcb *pcb, tcp_sent_fn sent)ICACHE_FLASH_ATTR; void tcp_poll (struct tcp_pcb *pcb, tcp_poll_fn poll, u8_t interval)ICACHE_FLASH_ATTR; void tcp_err (struct tcp_pcb *pcb, tcp_err_fn err)ICACHE_FLASH_ATTR; #define tcp_mss(pcb) (((pcb)->flags & TF_TIMESTAMP) ? ((pcb)->mss - 12) : (pcb)->mss) #define tcp_sndbuf(pcb) ((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 &= ~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) #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)ICACHE_FLASH_ATTR; err_t tcp_bind (struct tcp_pcb *pcb, ip_addr_t *ipaddr, u16_t port)ICACHE_FLASH_ATTR; err_t tcp_connect (struct tcp_pcb *pcb, ip_addr_t *ipaddr, u16_t port, tcp_connected_fn connected)ICACHE_FLASH_ATTR; struct tcp_pcb * tcp_listen_with_backlog(struct tcp_pcb *pcb, u8_t backlog)ICACHE_FLASH_ATTR; #define tcp_listen(pcb) tcp_listen_with_backlog(pcb, TCP_DEFAULT_LISTEN_BACKLOG) void tcp_abort (struct tcp_pcb *pcb)ICACHE_FLASH_ATTR; err_t tcp_close (struct tcp_pcb *pcb)ICACHE_FLASH_ATTR; err_t tcp_shutdown(struct tcp_pcb *pcb, int shut_rx, int shut_tx)ICACHE_FLASH_ATTR; /* 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)ICACHE_FLASH_ATTR; void tcp_setprio (struct tcp_pcb *pcb, u8_t prio)ICACHE_FLASH_ATTR; #define TCP_PRIO_MIN 1 #define TCP_PRIO_NORMAL 64 #define TCP_PRIO_MAX 127 extern err_t tcp_output(struct tcp_pcb *pcb); const char* tcp_debug_state_str(enum tcp_state s)ICACHE_FLASH_ATTR; #ifdef __cplusplus } #endif #endif /* LWIP_TCP */ #endif /* __LWIP_TCP_H__ */ ================================================ FILE: app/include/lwip/tcp_impl.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_TCP_IMPL_H__ #define __LWIP_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/sys.h" #include "lwip/mem.h" #include "lwip/pbuf.h" #include "lwip/ip.h" #include "lwip/icmp.h" #include "lwip/err.h" #ifdef __cplusplus extern "C" { #endif /* Functions for interfacing with TCP: */ /* Lower layer interface to TCP: */ #define tcp_init() /* Compatibility define, no init needed. */ void tcp_tmr (void)ICACHE_FLASH_ATTR; /* 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)ICACHE_FLASH_ATTR; void tcp_fasttmr (void)ICACHE_FLASH_ATTR; /* Only used by IP to pass a TCP segment to TCP: */ void tcp_input (struct pbuf *p, struct netif *inp)ICACHE_FLASH_ATTR; /* Used within the TCP code only: */ struct tcp_pcb * tcp_alloc (u8_t prio)ICACHE_FLASH_ATTR; void tcp_abandon (struct tcp_pcb *pcb, int reset)ICACHE_FLASH_ATTR; err_t tcp_send_empty_ack(struct tcp_pcb *pcb)ICACHE_FLASH_ATTR; void tcp_rexmit (struct tcp_pcb *pcb)ICACHE_FLASH_ATTR; void tcp_rexmit_rto (struct tcp_pcb *pcb)ICACHE_FLASH_ATTR; void tcp_rexmit_fast (struct tcp_pcb *pcb)ICACHE_FLASH_ATTR; u32_t tcp_update_rcv_ann_wnd(struct tcp_pcb *pcb)ICACHE_FLASH_ATTR; /** * 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))) \ ) ? 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)((a)-(b)) < 0) #define TCP_SEQ_LEQ(a,b) ((s32_t)((a)-(b)) <= 0) #define TCP_SEQ_GT(a,b) ((s32_t)((a)-(b)) > 0) #define TCP_SEQ_GEQ(a,b) ((s32_t)((a)-(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 125 /* 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 120000UL /* Default KEEPALIVE timer in milliseconds */ #endif #ifndef TCP_KEEPINTVL_DEFAULT #define TCP_KEEPINTVL_DEFAULT 10000UL /* 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_OFFSET(phdr) (ntohs((phdr)->_hdrlen_rsvd_flags) >> 8) #define TCPH_HDRLEN(phdr) (ntohs((phdr)->_hdrlen_rsvd_flags) >> 12) #define TCPH_FLAGS(phdr) (ntohs((phdr)->_hdrlen_rsvd_flags) & TCP_FLAGS) #define TCPH_OFFSET_SET(phdr, offset) (phdr)->_hdrlen_rsvd_flags = htons(((offset) << 8) | TCPH_FLAGS(phdr)) #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((u16_t)(~(u16_t)(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 = htons(ntohs((phdr)->_hdrlen_rsvd_flags) | (TCPH_FLAGS(phdr) & ~(flags)) ) #define TCP_TCPLEN(seg) ((seg)->len + ((TCPH_FLAGS((seg)->tcphdr) & (TCP_FIN | TCP_SYN)) != 0)) /** 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 sucessfully 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 segements on a queue */ struct pbuf *p; /* buffer containing data + TCP header */ void *dataptr; /* pointer to the TCP data in the pbuf */ 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' */ struct tcp_hdr *tcphdr; /* the TCP header */ }; #define LWIP_TCP_OPT_LENGTH(flags) \ (flags & TF_SEG_OPTS_MSS ? 4 : 0) + \ (flags & TF_SEG_OPTS_TS ? 12 : 0) /** This returns a TCP header option for MSS in an u32_t */ #define TCP_BUILD_MSS_OPTION(x) (x) = PP_HTONL(((u32_t)2 << 24) | \ ((u32_t)4 << 16) | \ (((u32_t)TCP_MSS / 256) << 8) | \ (TCP_MSS & 255)) /* Global variables: */ extern struct tcp_pcb *tcp_input_pcb; extern u32_t tcp_ticks; /* 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. */ extern struct tcp_pcb *tcp_tmp_pcb; /* Only used for temporary storage. */ /* 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 {\ 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 { \ 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 { \ 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 */ /* Internal functions: */ struct tcp_pcb *tcp_pcb_copy(struct tcp_pcb *pcb)ICACHE_FLASH_ATTR; void tcp_pcb_purge(struct tcp_pcb *pcb)ICACHE_FLASH_ATTR; void tcp_pcb_remove(struct tcp_pcb **pcblist, struct tcp_pcb *pcb)ICACHE_FLASH_ATTR; void tcp_segs_free(struct tcp_seg *seg)ICACHE_FLASH_ATTR; void tcp_seg_free(struct tcp_seg *seg)ICACHE_FLASH_ATTR; struct tcp_seg *tcp_seg_copy(struct tcp_seg *seg)ICACHE_FLASH_ATTR; #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)ICACHE_FLASH_ATTR; err_t tcp_enqueue_flags(struct tcp_pcb *pcb, u8_t flags)ICACHE_FLASH_ATTR; void tcp_rexmit_seg(struct tcp_pcb *pcb, struct tcp_seg *seg)ICACHE_FLASH_ATTR; void tcp_rst(u32_t seqno, u32_t ackno, ip_addr_t *local_ip, ip_addr_t *remote_ip, u16_t local_port, u16_t remote_port)ICACHE_FLASH_ATTR; u32_t tcp_next_iss(void)ICACHE_FLASH_ATTR; void tcp_keepalive(struct tcp_pcb *pcb)ICACHE_FLASH_ATTR; void tcp_zero_window_probe(struct tcp_pcb *pcb)ICACHE_FLASH_ATTR; #if TCP_CALCULATE_EFF_SEND_MSS u16_t tcp_eff_send_mss(u16_t sendmss, ip_addr_t *addr)ICACHE_FLASH_ATTR; #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)ICACHE_FLASH_ATTR; #endif /* LWIP_CALLBACK_API */ #if TCP_DEBUG || TCP_INPUT_DEBUG || TCP_OUTPUT_DEBUG void tcp_debug_print(struct tcp_hdr *tcphdr)ICACHE_FLASH_ATTR; void tcp_debug_print_flags(u8_t flags)ICACHE_FLASH_ATTR; void tcp_debug_print_state(enum tcp_state s)ICACHE_FLASH_ATTR; void tcp_debug_print_pcbs(void)ICACHE_FLASH_ATTR; s16_t tcp_pcbs_sane(void)ICACHE_FLASH_ATTR; #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)ICACHE_FLASH_ATTR; #ifdef __cplusplus } #endif #endif /* LWIP_TCP */ #endif /* __LWIP_TCP_H__ */ ================================================ FILE: app/include/lwip/tcpip.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_TCPIP_H__ #define __LWIP_TCPIP_H__ #include "lwip/opt.h" #if !NO_SYS /* don't build if not configured for use in lwipopts.h */ #include "lwip/api_msg.h" #include "lwip/netifapi.h" #include "lwip/pbuf.h" #include "lwip/api.h" #include "lwip/sys.h" #include "lwip/timers.h" #include "lwip/netif.h" #ifdef __cplusplus extern "C" { #endif /** 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) #define TCPIP_APIMSG(m) tcpip_apimsg_lock(m) #define TCPIP_APIMSG_ACK(m) #define TCPIP_NETIFAPI(m) tcpip_netifapi_lock(m) #define TCPIP_NETIFAPI_ACK(m) #else /* LWIP_TCPIP_CORE_LOCKING */ #define LOCK_TCPIP_CORE() #define UNLOCK_TCPIP_CORE() #define TCPIP_APIMSG(m) tcpip_apimsg(m) #define TCPIP_APIMSG_ACK(m) sys_sem_signal(&m->conn->op_completed) #define TCPIP_NETIFAPI(m) tcpip_netifapi(m) #define TCPIP_NETIFAPI_ACK(m) sys_sem_signal(&m->sem) #endif /* LWIP_TCPIP_CORE_LOCKING */ /** 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); void tcpip_init(tcpip_init_done_fn tcpip_init_done, void *arg); #if LWIP_NETCONN err_t tcpip_apimsg(struct api_msg *apimsg); #if LWIP_TCPIP_CORE_LOCKING err_t tcpip_apimsg_lock(struct api_msg *apimsg); #endif /* LWIP_TCPIP_CORE_LOCKING */ #endif /* LWIP_NETCONN */ err_t tcpip_input(struct pbuf *p, struct netif *inp); #if LWIP_NETIF_API err_t tcpip_netifapi(struct netifapi_msg *netifapimsg); #if LWIP_TCPIP_CORE_LOCKING err_t tcpip_netifapi_lock(struct netifapi_msg *netifapimsg); #endif /* LWIP_TCPIP_CORE_LOCKING */ #endif /* LWIP_NETIF_API */ 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) /* 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 */ enum tcpip_msg_type { #if LWIP_NETCONN TCPIP_MSG_API, #endif /* LWIP_NETCONN */ TCPIP_MSG_INPKT, #if LWIP_NETIF_API TCPIP_MSG_NETIFAPI, #endif /* LWIP_NETIF_API */ #if LWIP_TCPIP_TIMEOUT TCPIP_MSG_TIMEOUT, TCPIP_MSG_UNTIMEOUT, #endif /* LWIP_TCPIP_TIMEOUT */ TCPIP_MSG_CALLBACK }; struct tcpip_msg { enum tcpip_msg_type type; sys_sem_t *sem; union { #if LWIP_NETCONN struct api_msg *apimsg; #endif /* LWIP_NETCONN */ #if LWIP_NETIF_API struct netifapi_msg *netifapimsg; #endif /* LWIP_NETIF_API */ struct { struct pbuf *p; struct netif *netif; } 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_TCPIP_H__ */ ================================================ FILE: app/include/lwip/timers.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 * Simon Goldschmidt * */ #ifndef __LWIP_TIMERS_H__ #define __LWIP_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" #include "lwip/sys.h" #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)ICACHE_FLASH_ATTR; #if LWIP_DEBUG_TIMERNAMES void sys_timeout_debug(u32_t msecs, sys_timeout_handler handler, void *arg, const char* handler_name)ICACHE_FLASH_ATTR; #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)ICACHE_FLASH_ATTR; #endif /* LWIP_DEBUG_TIMERNAMES */ void sys_untimeout(sys_timeout_handler handler, void *arg)ICACHE_FLASH_ATTR; #if NO_SYS void sys_check_timeouts(void)ICACHE_FLASH_ATTR; void sys_restart_timeouts(void)ICACHE_FLASH_ATTR; #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_TIMERS_H__ */ ================================================ FILE: app/include/lwip/udp.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_UDP_H__ #define __LWIP_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" #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' points into the pbuf 'p' so freeing this pbuf * makes '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, 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_IGMP /** outgoing network interface for multicast packets */ ip_addr_t multicast_ip; #endif /* LWIP_IGMP */ #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 exernal 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)ICACHE_FLASH_ATTR; void udp_remove (struct udp_pcb *pcb)ICACHE_FLASH_ATTR; err_t udp_bind (struct udp_pcb *pcb, ip_addr_t *ipaddr, u16_t port)ICACHE_FLASH_ATTR; err_t udp_connect (struct udp_pcb *pcb, ip_addr_t *ipaddr, u16_t port)ICACHE_FLASH_ATTR; void udp_disconnect (struct udp_pcb *pcb)ICACHE_FLASH_ATTR; void udp_recv (struct udp_pcb *pcb, udp_recv_fn recv, void *recv_arg)ICACHE_FLASH_ATTR; err_t udp_sendto_if (struct udp_pcb *pcb, struct pbuf *p, ip_addr_t *dst_ip, u16_t dst_port, struct netif *netif)ICACHE_FLASH_ATTR; err_t udp_sendto (struct udp_pcb *pcb, struct pbuf *p, ip_addr_t *dst_ip, u16_t dst_port)ICACHE_FLASH_ATTR; err_t udp_send (struct udp_pcb *pcb, struct pbuf *p)ICACHE_FLASH_ATTR; #if LWIP_CHECKSUM_ON_COPY err_t udp_sendto_if_chksum(struct udp_pcb *pcb, struct pbuf *p, ip_addr_t *dst_ip, u16_t dst_port, struct netif *netif, u8_t have_chksum, u16_t chksum)ICACHE_FLASH_ATTR; err_t udp_sendto_chksum(struct udp_pcb *pcb, struct pbuf *p, ip_addr_t *dst_ip, u16_t dst_port, u8_t have_chksum, u16_t chksum)ICACHE_FLASH_ATTR; err_t udp_send_chksum(struct udp_pcb *pcb, struct pbuf *p, u8_t have_chksum, u16_t chksum)ICACHE_FLASH_ATTR; #endif /* LWIP_CHECKSUM_ON_COPY */ #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)ICACHE_FLASH_ATTR; #define udp_init() /* Compatibility define, not init needed. */ #if UDP_DEBUG void udp_debug_print(struct udp_hdr *udphdr)ICACHE_FLASH_ATTR; #else #define udp_debug_print(udphdr) #endif #ifdef __cplusplus } #endif #endif /* LWIP_UDP */ #endif /* __LWIP_UDP_H__ */ ================================================ FILE: app/include/lwipopts.h ================================================ /** * @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 __LWIPOPTS_H__ #define __LWIPOPTS_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 1 #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) os_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) os_memcpy(dst,src,len) #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 1 #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 1 #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 4 #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 16000 #endif /** * MEMP_SEPARATE_POOLS: if defined to 1, each pool is placed in its own array. * This can be used to individually change the location of each pool. * Default is one big array for all pools */ #ifndef MEMP_SEPARATE_POOLS #define MEMP_SEPARATE_POOLS 1 #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 1 #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 * inlude 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 10 #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 simulatenously active TCP connections. * (requires the LWIP_TCP option) */ #ifndef MEMP_NUM_TCP_PCB #define MEMP_NUM_TCP_PCB (*(volatile uint32*)0x600011FC) #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 2 #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 simultaneously IP packets queued for * reassembly (whole packets, not fragments!) */ #ifndef MEMP_NUM_REASSDATA #define MEMP_NUM_REASSDATA 0 #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 0 #endif /** * MEMP_NUM_ARP_QUEUE: the number of simulateously 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 10 #endif /** * MEMP_NUM_IGMP_GROUP: The number of multicast groups whose network interfaces * can be members et 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 simulateously active timeouts. * (requires NO_SYS==0) */ #ifndef MEMP_NUM_SYS_TIMEOUT #define MEMP_NUM_SYS_TIMEOUT 8 #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 0 #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 0 #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 4 #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 4 #endif /** * MEMP_NUM_SNMP_NODE: the number of leafs in the SNMP tree. */ #ifndef MEMP_NUM_SNMP_NODE #define MEMP_NUM_SNMP_NODE 0 #endif /** * MEMP_NUM_SNMP_ROOTNODE: the number of branches in the SNMP tree. * Every branch has one leaf (MEMP_NUM_SNMP_NODE) at least! */ #ifndef MEMP_NUM_SNMP_ROOTNODE #define MEMP_NUM_SNMP_ROOTNODE 0 #endif /** * MEMP_NUM_SNMP_VARBIND: the number of concurrent requests (does not have to * be changed normally) - 2 of these are used per request (1 for input, * 1 for output) */ #ifndef MEMP_NUM_SNMP_VARBIND #define MEMP_NUM_SNMP_VARBIND 0 #endif /** * MEMP_NUM_SNMP_VALUE: the number of OID or values concurrently used * (does not have to be changed normally) - 3 of these are used per request * (1 for the value read and 2 for OIDs - input and output) */ #ifndef MEMP_NUM_SNMP_VALUE #define MEMP_NUM_SNMP_VALUE 0 #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 0 #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 0 #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 0 #endif /** * PBUF_POOL_SIZE: the number of buffers in the pbuf pool. */ #ifndef PBUF_POOL_SIZE #define PBUF_POOL_SIZE 10 #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 /** * 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 1 #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 1 #endif /** * ETHARP_SUPPORT_VLAN==1: support receiving ethernet packets with VLAN header. * 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. */ #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 /* -------------------------------- ---------- IP options ---------- -------------------------------- */ /** * 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_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_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 0 #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 0 #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 1 #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 /* ---------------------------------- ---------- 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 1 #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 1 #endif /** * 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 /** * DHCP_MAXRTX: Maximum number of retries of current request. */ #ifndef DHCP_MAXRTX #define DHCP_MAXRTX (*(volatile uint32*)0x600011E0) #endif /* ------------------------------------ ---------- AUTOIP options ---------- ------------------------------------ */ /** * LWIP_AUTOIP==1: Enable AUTOIP module. */ #ifndef LWIP_AUTOIP #define LWIP_AUTOIP 0 #endif /** * 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 options ---------- ---------------------------------- */ /** * LWIP_SNMP==1: Turn on SNMP module. UDP must be available for SNMP * transport. */ #ifndef LWIP_SNMP #define LWIP_SNMP 0 #endif /** * SNMP_CONCURRENT_REQUESTS: Number of concurrent requests the module will * allow. At least one request buffer is required. */ #ifndef SNMP_CONCURRENT_REQUESTS #define SNMP_CONCURRENT_REQUESTS 0 #endif /** * SNMP_TRAP_DESTINATIONS: Number of trap destinations. At least one trap * destination is required */ #ifndef SNMP_TRAP_DESTINATIONS #define SNMP_TRAP_DESTINATIONS 0 #endif /** * SNMP_PRIVATE_MIB: */ #ifndef SNMP_PRIVATE_MIB #define SNMP_PRIVATE_MIB 0 #endif /** * Only allow SNMP write actions that are 'safe' (e.g. disabeling netifs is not * a safe action and disabled when SNMP_SAFE_REQUESTS = 1). * Unsafe requests are disabled by default! */ #ifndef SNMP_SAFE_REQUESTS #define SNMP_SAFE_REQUESTS 0 #endif /** * The maximum length of strings used. This affects the size of * MEMP_SNMP_VALUE elements. */ #ifndef SNMP_MAX_OCTET_STRING_LEN #define SNMP_MAX_OCTET_STRING_LEN 127 #endif /** * The maximum depth of the SNMP tree. * With private MIBs enabled, this depends on your MIB! * This affects the size of MEMP_SNMP_VALUE elements. */ #ifndef SNMP_MAX_TREE_DEPTH #define SNMP_MAX_TREE_DEPTH 15 #endif /** * The size of the MEMP_SNMP_VALUE elements, normally calculated from * SNMP_MAX_OCTET_STRING_LEN and SNMP_MAX_TREE_DEPTH. */ #ifndef SNMP_MAX_VALUE_SIZE #define SNMP_MAX_VALUE_SIZE LWIP_MAX((SNMP_MAX_OCTET_STRING_LEN)+1, sizeof(s32_t)*(SNMP_MAX_TREE_DEPTH)) #endif /* ---------------------------------- ---------- IGMP options ---------- ---------------------------------- */ /** * LWIP_IGMP==1: Turn on IGMP module. */ #ifndef LWIP_IGMP #define LWIP_IGMP 1 #endif /* ---------------------------------- ---------- MDNS options ---------- ---------------------------------- */ /** * LWIP_MDNS==1: Turn on MDNS module. */ #ifndef LWIP_MDNS #define LWIP_MDNS 1 #endif /* /* ---------------------------------- ---------- DNS options ----------- ---------------------------------- */ /** * LWIP_DNS==1: Turn on DNS module. UDP must be available for DNS * transport. */ #ifndef LWIP_DNS #define LWIP_DNS 1 #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 */ #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 /** DNS message max. size. Default value is RFC compliant. */ #ifndef DNS_MSG_SIZE #define DNS_MSG_SIZE 512 #endif /** 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 (*(volatile uint32*)0x600011F0) #endif /** * TCP_MAXRTX: Maximum number of retransmissions of data segments. */ #ifndef TCP_MAXRTX #define TCP_MAXRTX (*(volatile uint32*)0x600011E8) #endif /** * TCP_SYNMAXRTX: Maximum number of retransmissions of SYN segments. */ #ifndef TCP_SYNMAXRTX #define TCP_SYNMAXRTX (*(volatile uint32*)0x600011E4) #endif /** * TCP_MAXRTO: Maximum retransmission timeout of data segments. */ #ifndef TCP_MAXRTO #define TCP_MAXRTO 10 #endif /** * TCP_MINRTO: Minimum retransmission timeout of data segments. */ #ifndef TCP_MINRTO #define TCP_MINRTO 2 #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 1 #endif #if 1 /** * 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 1460 #endif #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). */ #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 ((TCP_SND_BUF)/2) #endif /** * TCP_SNDQUEUELOWAT: TCP writable bufs (pbuf count). This must be grater * 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_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. */ #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 (TCP_WND / 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. */ #ifndef LWIP_EVENT_API #define LWIP_EVENT_API 0 #define LWIP_CALLBACK_API 1 #else #define LWIP_EVENT_API 1 #define LWIP_CALLBACK_API 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 #define PBUF_LINK_HLEN (14 + ETH_PAD_SIZE) #endif /** * PBUF_POOL_BUFSIZE: the size of each pbuf in the pbuf pool. The default is * designed to accomodate 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_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 1 #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 acquistion) */ #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_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 1 #endif /* LWIP_NETIF_TX_SINGLE_PBUF */ /* ------------------------------------ ---------- LOOPIF options ---------- ------------------------------------ */ /** * LWIP_HAVE_LOOPIF==1: Support loop interface (127.0.0.1) and loopif.c */ #ifndef LWIP_HAVE_LOOPIF #define LWIP_HAVE_LOOPIF 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 /** * PPP_THREAD_NAME: The name assigned to the pppInputThread. */ #ifndef PPP_THREAD_NAME #define PPP_THREAD_NAME "pppInputThread" #endif /** * PPP_THREAD_STACKSIZE: The stack size used by the pppInputThread. * The stack size value itself is platform-dependent, but is passed to * sys_thread_new() when the thread is created. */ #ifndef PPP_THREAD_STACKSIZE #define PPP_THREAD_STACKSIZE 0 #endif /** * PPP_THREAD_PRIO: The priority assigned to the pppInputThread. * The priority value itself is platform-dependent, but is passed to * sys_thread_new() when the thread is created. */ #ifndef PPP_THREAD_PRIO #define PPP_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 0 #endif /** LWIP_TCPIP_TIMEOUT==1: Enable tcpip_timeout/tcpip_untimeout tod create * timers running in tcpip_thread from another thread. */ #ifndef LWIP_TCPIP_TIMEOUT #define LWIP_TCPIP_TIMEOUT 1 #endif /* ------------------------------------ ---------- Socket options ---------- ------------------------------------ */ /** * LWIP_SOCKET==1: Enable Socket API (require to use sockets.c) */ #ifndef LWIP_SOCKET #define LWIP_SOCKET 0 #endif /** * LWIP_COMPAT_SOCKETS==1: Enable BSD-style sockets functions names. * (only used if you use sockets.c) */ #ifndef LWIP_COMPAT_SOCKETS #define LWIP_COMPAT_SOCKETS 0 #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 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 1 #endif /** * LWIP_SO_RCVTIMEO==1: Enable SO_RCVTIMEO processing. */ #ifndef LWIP_SO_RCVTIMEO #define LWIP_SO_RCVTIMEO 0 #endif /** * LWIP_SO_RCVBUF==1: Enable SO_RCVBUF processing. */ #ifndef LWIP_SO_RCVBUF #define LWIP_SO_RCVBUF 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 /** * 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 /* ---------------------------------------- ---------- Statistics options ---------- ---------------------------------------- */ /** * LWIP_STATS==1: Enable statistics collection in lwip_stats. */ #ifndef LWIP_STATS #define LWIP_STATS 0 #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 #else #define ETHARP_STATS 0 #define LINK_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 #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 /** * PPPOS_SUPPORT==1: Enable PPP Over Serial */ #ifndef PPPOS_SUPPORT #define PPPOS_SUPPORT PPP_SUPPORT #endif #if PPP_SUPPORT /** * NUM_PPP: Max PPP sessions. */ #ifndef NUM_PPP #define NUM_PPP 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. CURRENTLY NOT SUPPORTED! DO NOT SET! */ #ifndef MSCHAP_SUPPORT #define MSCHAP_SUPPORT 0 #endif /** * CBCP_SUPPORT==1: Support CBCP. CURRENTLY NOT SUPPORTED! DO NOT SET! */ #ifndef CBCP_SUPPORT #define CBCP_SUPPORT 0 #endif /** * CCP_SUPPORT==1: Support CCP. CURRENTLY NOT SUPPORTED! DO NOT SET! */ #ifndef CCP_SUPPORT #define CCP_SUPPORT 0 #endif /** * VJ_SUPPORT==1: Support VJ header compression. */ #ifndef VJ_SUPPORT #define VJ_SUPPORT 0 #endif /** * MD5_SUPPORT==1: Support MD5 (see also CHAP). */ #ifndef MD5_SUPPORT #define MD5_SUPPORT 0 #endif /* * Timeouts */ #ifndef FSM_DEFTIMEOUT #define FSM_DEFTIMEOUT 6 /* Timeout time in seconds */ #endif #ifndef FSM_DEFMAXTERMREQS #define FSM_DEFMAXTERMREQS 2 /* Maximum Terminate-Request transmissions */ #endif #ifndef FSM_DEFMAXCONFREQS #define FSM_DEFMAXCONFREQS 10 /* Maximum Configure-Request transmissions */ #endif #ifndef FSM_DEFMAXNAKLOOPS #define FSM_DEFMAXNAKLOOPS 5 /* Maximum number of nak loops */ #endif #ifndef UPAP_DEFTIMEOUT #define UPAP_DEFTIMEOUT 6 /* Timeout (seconds) for retransmitting req */ #endif #ifndef UPAP_DEFREQTIME #define UPAP_DEFREQTIME 30 /* Time to wait for auth-req from peer */ #endif #ifndef CHAP_DEFTIMEOUT #define CHAP_DEFTIMEOUT 6 /* Timeout time in seconds */ #endif #ifndef CHAP_DEFTRANSMITS #define CHAP_DEFTRANSMITS 10 /* max # times to send challenge */ #endif /* Interval in seconds between keepalive echo requests, 0 to disable. */ #ifndef LCP_ECHOINTERVAL #define LCP_ECHOINTERVAL 0 #endif /* Number of unanswered echo requests before failure. */ #ifndef LCP_MAXECHOFAILS #define LCP_MAXECHOFAILS 3 #endif /* Max Xmit idle time (in jiffies) before resend flag char. */ #ifndef PPP_MAXIDLEFLAG #define PPP_MAXIDLEFLAG 100 #endif /* * Packet sizes * * Note - lcp shouldn't be allowed to negotiate stuff outside these * limits. See lcp.h in the pppd directory. * (XXX - these constants should simply be shared by lcp.c instead * of living in lcp.h) */ #define PPP_MTU 1500 /* Default MTU (size of Info field) */ #ifndef PPP_MAXMTU /* #define PPP_MAXMTU 65535 - (PPP_HDRLEN + PPP_FCSLEN) */ #define PPP_MAXMTU 1500 /* Largest MTU we allow */ #endif #define PPP_MINMTU 64 #define PPP_MRU 1500 /* default MRU = max length of info field */ #define PPP_MAXMRU 1500 /* Largest MRU we allow */ #ifndef PPP_DEFMRU #define PPP_DEFMRU 296 /* Try for this */ #endif #define PPP_MINMRU 128 /* No MRUs below this */ #ifndef MAXNAMELEN #define MAXNAMELEN 256 /* max length of hostname or name for auth */ #endif #ifndef MAXSECRETLEN #define MAXSECRETLEN 256 /* max length of password or secret */ #endif #endif /* PPP_SUPPORT */ /* -------------------------------------- ---------- Checksum options ---------- -------------------------------------- */ /** * 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_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 /** * 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 /* --------------------------------------- ---------- 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_OFF #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 /** * SNMP_MSG_DEBUG: Enable debugging for SNMP messages. */ #ifndef SNMP_MSG_DEBUG #define SNMP_MSG_DEBUG LWIP_DBG_OFF #endif /** * SNMP_MIB_DEBUG: Enable debugging for SNMP MIBs. */ #ifndef SNMP_MIB_DEBUG #define SNMP_MIB_DEBUG LWIP_DBG_OFF #endif /** * DNS_DEBUG: Enable debugging for DNS. */ #ifndef DNS_DEBUG #define DNS_DEBUG LWIP_DBG_OFF #endif #endif /* __LWIP_OPT_H__ */ ================================================ FILE: app/include/mem_manager.h ================================================ #ifndef __MEM_MANAGER_H__ #define __MEM_MANAGER_H__ #include "c_types.h" /*------------------------------------------------*/ #define MPU_WRAPPERS_INCLUDED_FROM_API_FILE #ifndef IOT_SIP_MODE //#define configTOTAL_HEAP_SIZE ( ( size_t ) ( 0x3fffc000 - (uint32)&_heap_start ) )//fix 16000 to 24000 on 14.2.26 #else #define configTOTAL_HEAP_SIZE ( ( size_t ) ( 8000 ) ) #endif #define portBYTE_ALIGNMENT 8 #define pdFALSE 0 #define pdTRUE 1 #undef MPU_WRAPPERS_INCLUDED_FROM_API_FILE #if portBYTE_ALIGNMENT == 8 #define portBYTE_ALIGNMENT_MASK ( 0x0007 ) #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 #define configUSE_MALLOC_FAILED_HOOK 1 #define portPOINTER_SIZE_TYPE unsigned int #define heapMINIMUM_BLOCK_SIZE ( ( size_t ) ( heapSTRUCT_SIZE * 2 ) ) //#define configADJUSTED_HEAP_SIZE ( configTOTAL_HEAP_SIZE - portBYTE_ALIGNMENT ) //static unsigned char ucHeap[ configTOTAL_HEAP_SIZE ]; static unsigned char *ucHeap; 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. } xBlockLink; static const unsigned short heapSTRUCT_SIZE = ( sizeof( xBlockLink ) + portBYTE_ALIGNMENT - ( sizeof( xBlockLink ) % portBYTE_ALIGNMENT ) ); //static const size_t xTotalHeapSize = ( ( size_t ) configADJUSTED_HEAP_SIZE ) & ( ( size_t ) ~portBYTE_ALIGNMENT_MASK ); static xBlockLink xStart, *pxEnd = NULL; //static size_t xFreeBytesRemaining = ( ( size_t ) configADJUSTED_HEAP_SIZE ) & ( ( size_t ) ~portBYTE_ALIGNMENT_MASK ); /*-----------------------------------------------------------*/ static void prvInsertBlockIntoFreeList( xBlockLink *pxBlockToInsert ) ;//ICACHE_FLASH_ATTR; static void prvHeapInit( void ) ;//ICACHE_FLASH_ATTR; void vApplicationMallocFailedHook( void ) ;//ICACHE_FLASH_ATTR; void *pvPortMalloc( size_t xWantedSize ) ;//ICACHE_FLASH_ATTR; void vPortFree( void *pv ) ;//ICACHE_FLASH_ATTR; size_t xPortGetFreeHeapSize( void ) ;//ICACHE_FLASH_ATTR; void vPortInitialiseBlocks( void ) ;//ICACHE_FLASH_ATTR; /*-----------------------------------------------------------*/ #endif ================================================ FILE: app/include/netif/etharp.h ================================================ /* * 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 __NETIF_ETHARP_H__ #define __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/ip_addr.h" #include "lwip/netif.h" #include "lwip/ip.h" #ifdef __cplusplus extern "C" { #endif #ifndef ETHARP_HWADDR_LEN #define ETHARP_HWADDR_LEN 6 #endif #ifdef PACK_STRUCT_USE_INCLUDES # include "arch/bpstruct.h" #endif PACK_STRUCT_BEGIN struct eth_addr { PACK_STRUCT_FIELD(u8_t addr[ETHARP_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_FIELD(u8_t padding[ETH_PAD_SIZE]); #endif PACK_STRUCT_FIELD(struct eth_addr dest); PACK_STRUCT_FIELD(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 tpid); PACK_STRUCT_FIELD(u16_t prio_vid); } 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 */ #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_FIELD(u8_t hwlen); PACK_STRUCT_FIELD(u8_t protolen); PACK_STRUCT_FIELD(u16_t opcode); PACK_STRUCT_FIELD(struct eth_addr shwaddr); PACK_STRUCT_FIELD(struct ip_addr2 sipaddr); PACK_STRUCT_FIELD(struct eth_addr dhwaddr); PACK_STRUCT_FIELD(struct ip_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_MINSIZE 46 #define SIZEOF_ETHARP_PACKET (SIZEOF_ETH_HDR + SIZEOF_ETHARP_HDR) #define SIZEOF_ETHARP_WITHPAD (SIZEOF_ETH_HDR + SIZEOF_ETHARP_MINSIZE) /** 5 seconds period */ #define ARP_TMR_INTERVAL 5000 #define ETHTYPE_ARP 0x0806 #define ETHTYPE_IP 0x0800 #define ETHTYPE_VLAN 0x8100 #define ETHTYPE_PPPOEDISC 0x8863 /* PPP Over Ethernet Discovery Stage */ #define ETHTYPE_PPPOE 0x8864 /* PPP Over Ethernet Session Stage */ #define ETHTYPE_PAE 0x888e /** 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(src, dst) SMEMCPY(src, dst, ETHARP_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(src, dst) SMEMCPY(src, dst, ETHARP_HWADDR_LEN) #endif #if LWIP_ARP /* don't build if not configured for use in lwipopts.h */ /** ARP message types (opcodes) */ #define ARP_REQUEST 1 #define ARP_REPLY 2 /** 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 #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, not init needed. */ void etharp_tmr(void)ICACHE_FLASH_ATTR; s8_t etharp_find_addr(struct netif *netif, ip_addr_t *ipaddr, struct eth_addr **eth_ret, ip_addr_t **ip_ret)ICACHE_FLASH_ATTR; err_t etharp_output(struct netif *netif, struct pbuf *q, ip_addr_t *ipaddr)ICACHE_FLASH_ATTR; err_t etharp_query(struct netif *netif, ip_addr_t *ipaddr, struct pbuf *q)ICACHE_FLASH_ATTR; err_t etharp_request(struct netif *netif, ip_addr_t *ipaddr)ICACHE_FLASH_ATTR; /** 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)->ip_addr) void etharp_cleanup_netif(struct netif *netif); #if ETHARP_SUPPORT_STATIC_ENTRIES err_t etharp_add_static_entry(ip_addr_t *ipaddr, struct eth_addr *ethaddr)ICACHE_FLASH_ATTR; err_t etharp_remove_static_entry(ip_addr_t *ipaddr)ICACHE_FLASH_ATTR; #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 ip_addr_t *ipsrc_addr, const struct eth_addr *hwdst_addr, const ip_addr_t *ipdst_addr, const u16_t opcode)ICACHE_FLASH_ATTR; #endif /* LWIP_AUTOIP */ #endif /* LWIP_ARP */ err_t ethernet_input(struct pbuf *p, struct netif *netif)ICACHE_FLASH_ATTR; #define eth_addr_cmp(addr1, addr2) (memcmp((addr1)->addr, (addr2)->addr, ETHARP_HWADDR_LEN) == 0) extern const struct eth_addr ethbroadcast, ethzero; #endif /* LWIP_ARP || LWIP_ETHERNET */ #if 0 /** Ethernet header */ #ifndef ETHARP_HWADDR_LEN #define ETHARP_HWADDR_LEN 6 #endif struct eth_addr { PACK_STRUCT_FIELD(u8_t addr[ETHARP_HWADDR_LEN]); } PACK_STRUCT_STRUCT; struct eth_hdr { #if ETH_PAD_SIZE PACK_STRUCT_FIELD(u8_t padding[ETH_PAD_SIZE]); #endif PACK_STRUCT_FIELD(struct eth_addr dest); PACK_STRUCT_FIELD(struct eth_addr src); PACK_STRUCT_FIELD(u16_t type); } PACK_STRUCT_STRUCT; #ifdef PACK_STRUCT_USE_INCLUDES # include "arch/epstruct.h" #endif #define SIZEOF_ETH_HDR (14 + ETH_PAD_SIZE) #endif #ifdef __cplusplus } #endif #endif /* __NETIF_ARP_H__ */ ================================================ FILE: app/include/netif/if_llc.h ================================================ /* $NetBSD: if_llc.h,v 1.12 1999/11/19 20:41:19 thorpej Exp $ */ /*- * 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. * 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. * * @(#)if_llc.h 8.1 (Berkeley) 6/10/93 * $FreeBSD$ */ #ifndef _NET_IF_LLC_H_ #define _NET_IF_LLC_H_ /* * IEEE 802.2 Link Level Control headers, for use in conjunction with * 802.{3,4,5} media access control methods. * * Headers here do not use bit fields due to shortcommings in many * compilers. */ struct llc { uint8_t llc_dsap; uint8_t llc_ssap; union { struct { uint8_t control; uint8_t format_id; uint8_t class; uint8_t window_x2; } __packed type_u; struct { uint8_t num_snd_x2; uint8_t num_rcv_x2; } __packed type_i; struct { uint8_t control; uint8_t num_rcv_x2; } __packed type_s; struct { uint8_t control; /* * We cannot put the following fields in a structure because * the structure rounding might cause padding. */ uint8_t frmr_rej_pdu0; uint8_t frmr_rej_pdu1; uint8_t frmr_control; uint8_t frmr_control_ext; uint8_t frmr_cause; } __packed type_frmr; struct { uint8_t control; uint8_t org_code[3]; uint16_t ether_type; } __packed type_snap; struct { uint8_t control; uint8_t control_ext; } __packed type_raw; } __packed llc_un; } __packed; struct frmrinfo { uint8_t frmr_rej_pdu0; uint8_t frmr_rej_pdu1; uint8_t frmr_control; uint8_t frmr_control_ext; uint8_t frmr_cause; } __packed; #define llc_control llc_un.type_u.control #define llc_control_ext llc_un.type_raw.control_ext #define llc_fid llc_un.type_u.format_id #define llc_class llc_un.type_u.class #define llc_window llc_un.type_u.window_x2 #define llc_frmrinfo llc_un.type_frmr.frmr_rej_pdu0 #define llc_frmr_pdu0 llc_un.type_frmr.frmr_rej_pdu0 #define llc_frmr_pdu1 llc_un.type_frmr.frmr_rej_pdu1 #define llc_frmr_control llc_un.type_frmr.frmr_control #define llc_frmr_control_ext llc_un.type_frmr.frmr_control_ext #define llc_frmr_cause llc_un.type_frmr.frmr_cause #define llc_snap llc_un.type_snap /* * Don't use sizeof(struct llc_un) for LLC header sizes */ #define LLC_ISFRAMELEN 4 #define LLC_UFRAMELEN 3 #define LLC_FRMRLEN 7 #define LLC_SNAPFRAMELEN 8 #ifdef CTASSERT CTASSERT(sizeof (struct llc) == LLC_SNAPFRAMELEN); #endif /* * Unnumbered LLC format commands */ #define LLC_UI 0x3 #define LLC_UI_P 0x13 #define LLC_DISC 0x43 #define LLC_DISC_P 0x53 #define LLC_UA 0x63 #define LLC_UA_P 0x73 #define LLC_TEST 0xe3 #define LLC_TEST_P 0xf3 #define LLC_FRMR 0x87 #define LLC_FRMR_P 0x97 #define LLC_DM 0x0f #define LLC_DM_P 0x1f #define LLC_XID 0xaf #define LLC_XID_P 0xbf #define LLC_SABME 0x6f #define LLC_SABME_P 0x7f /* * Supervisory LLC commands */ #define LLC_RR 0x01 #define LLC_RNR 0x05 #define LLC_REJ 0x09 /* * Info format - dummy only */ #define LLC_INFO 0x00 /* * ISO PDTR 10178 contains among others */ #define LLC_8021D_LSAP 0x42 #define LLC_X25_LSAP 0x7e #define LLC_SNAP_LSAP 0xaa #define LLC_ISO_LSAP 0xfe #define RFC1042_LEN 6 #define RFC1042 {0xAA, 0xAA, 0x03, 0x00, 0x00, 0x00} #define ETHERNET_TUNNEL {0xAA, 0xAA, 0x03, 0x00, 0x00, 0xF8} /* * copied from sys/net/ethernet.h */ #define ETHERTYPE_AARP 0x80F3 /* AppleTalk AARP */ #define ETHERTYPE_IPX 0x8137 /* Novell (old) NetWare IPX (ECONFIG E option) */ #endif /* _NET_IF_LLC_H_ */ ================================================ FILE: app/include/netif/ppp_oe.h ================================================ /***************************************************************************** * ppp_oe.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. */ #ifndef PPP_OE_H #define PPP_OE_H #include "lwip/opt.h" #if PPPOE_SUPPORT > 0 #include "netif/etharp.h" #ifdef PACK_STRUCT_USE_INCLUDES # include "arch/bpstruct.h" #endif PACK_STRUCT_BEGIN struct pppoehdr { PACK_STRUCT_FIELD(u8_t vertype); PACK_STRUCT_FIELD(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 #define PPPOE_STATE_CLOSING 4 /* 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 ETHERMTU #define ETHERMTU 1500 #endif /* two byte PPP protocol discriminator, then IP data */ #define PPPOE_MAXMTU (ETHERMTU-PPPOE_HEADERLEN-2) #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 */ int sc_pd; /* ppp unit number */ void (*sc_linkStatusCB)(int pd, int up); int sc_state; /* discovery phase or session connected */ struct eth_addr sc_dest; /* hardware address of concentrator */ u16_t sc_session; /* PPPoE session id */ #ifdef PPPOE_TODO char *sc_service_name; /* if != NULL: requested name of service */ char *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 */ size_t sc_ac_cookie_len; /* length of cookie data */ #ifdef PPPOE_SERVER u8_t *sc_hunique; /* content of host unique we must echo back */ size_t sc_hunique_len; /* length of host unique */ #endif int sc_padi_retried; /* number of PADI retries already done */ int sc_padr_retried; /* number of PADR retries already done */ }; #define pppoe_init() /* compatibility define, no initialization needed */ err_t pppoe_create(struct netif *ethif, int pd, void (*linkStatusCB)(int pd, int up), struct pppoe_softc **scptr); err_t pppoe_destroy(struct netif *ifp); int pppoe_connect(struct pppoe_softc *sc); void pppoe_disconnect(struct pppoe_softc *sc); void pppoe_disc_input(struct netif *netif, struct pbuf *p); void pppoe_data_input(struct netif *netif, struct pbuf *p); err_t pppoe_xmit(struct pppoe_softc *sc, struct pbuf *pb); /** used in ppp.c */ #define PPPOE_HDRLEN (sizeof(struct eth_hdr) + PPPOE_HEADERLEN) #endif /* PPPOE_SUPPORT */ #endif /* PPP_OE_H */ ================================================ FILE: app/include/netif/wlan_lwip_if.h ================================================ /* * Copyright (c) 2010-2011 Espressif System * */ #ifndef _WLAN_LWIP_IF_H_ #define _WLAN_LWIP_IF_H_ #define LWIP_IF0_PRIO 28 #define LWIP_IF1_PRIO 29 enum { SIG_LWIP_RX = 0, }; struct netif * eagle_lwip_if_alloc(struct ieee80211_conn *conn, const uint8 *macaddr, struct ip_info *info); struct netif * eagle_lwip_getif(uint8 index); #ifndef IOT_SIP_MODE sint8 ieee80211_output_pbuf(struct netif *ifp, struct pbuf* pb); #else sint8 ieee80211_output_pbuf(struct ieee80211_conn *conn, esf_buf *eb); #endif #endif /* _WLAN_LWIP_IF_H_ */ ================================================ FILE: app/include/pp/esf_buf.h ================================================ /* * copyright (c) 2008 - 2012 Espressif System * * esf buffer data structure */ #ifndef _ESF_BUF_H_ #define _ESF_BUF_H_ #define EP_OFFSET 36 /* see comments in pbuf.h */ #endif /* _ESF_BUF_H_ */ ================================================ FILE: app/include/serial_number.h ================================================ #ifndef __SERIAL_NUMBER_H #define __SERIAL_NUMBER_H #define SERIAL_NUMBER "865732" #endif ================================================ FILE: app/include/ssl/app/espconn_secure.h ================================================ #ifndef __ESPCONN_ENCRY_H__ #define __ESPCONN_ENCRY_H__ #include "espconn/espconn.h" /****************************************************************************** * FunctionName : espconn_encry_connect * Description : The function given as connection * Parameters : espconn -- the espconn used to connect with the host * Returns : none *******************************************************************************/ sint8 espconn_secure_connect(struct espconn *espconn); /****************************************************************************** * FunctionName : espconn_encry_disconnect * Description : The function given as the disconnection * Parameters : espconn -- the espconn used to disconnect with the host * Returns : none *******************************************************************************/ extern sint8 espconn_secure_disconnect(struct espconn *espconn); /****************************************************************************** * FunctionName : espconn_encry_sent * Description : sent data for client or server * Parameters : espconn -- espconn to set for client or server * psent -- data to send * length -- length of data to send * Returns : none *******************************************************************************/ extern sint8 espconn_secure_sent(struct espconn *espconn, uint8 *psent, uint16 length); /****************************************************************************** * FunctionName : espconn_secure_accept * Description : The function given as the listen * Parameters : espconn -- the espconn used to listen the connection * Returns : none *******************************************************************************/ extern sint8 espconn_secure_accept(struct espconn *espconn); #endif ================================================ FILE: app/include/ssl/app/espconn_ssl.h ================================================ #ifndef ESPCONN_SSL_CLIENT_H #define ESPCONN_SSL_CLIENT_H #include "ssl/ssl_ssl.h" #include "ssl/ssl_tls1.h" #include "lwip/app/espconn.h" typedef struct _ssl_msg { SSL_CTX *ssl_ctx; SSL *ssl; bool quiet; char *private_key_file; uint8_t session_id[SSL_SESSION_ID_SIZE]; u16_t pkt_length; } ssl_msg; /****************************************************************************** * FunctionName : sslserver_start * Description : Initialize the server: set up a listen PCB and bind it to * the defined port * Parameters : espconn -- the espconn used to build client * Returns : none *******************************************************************************/ extern sint8 espconn_ssl_server(struct espconn *espconn); /****************************************************************************** * FunctionName : espconn_ssl_client * Description : Initialize the client: set up a connect PCB and bind it to * the defined port * Parameters : espconn -- the espconn used to build client * Returns : none *******************************************************************************/ extern sint8 espconn_ssl_client(struct espconn *espconn); /****************************************************************************** * FunctionName : espconn_ssl_write * Description : sent data for client or server * Parameters : void *arg -- client or server to send * uint8* psent -- Data to send * uint16 length -- Length of data to send * Returns : none *******************************************************************************/ extern void espconn_ssl_sent(void *arg, uint8 *psent, uint16 length); /****************************************************************************** * FunctionName : espconn_ssl_disconnect * Description : A new incoming connection has been disconnected. * Parameters : espconn -- the espconn used to disconnect with host * Returns : none *******************************************************************************/ extern void espconn_ssl_disconnect(espconn_msg *pdis); #endif ================================================ FILE: app/include/ssl/cert.h ================================================ unsigned char default_certificate[] = { 0x30, 0x82, 0x01, 0x82, 0x30, 0x81, 0xec, 0x02, 0x09, 0x00, 0x88, 0xf2, 0x5f, 0x46, 0x12, 0x2e, 0x3d, 0x3a, 0x30, 0x0d, 0x06, 0x09, 0x2a, 0x86, 0x48, 0x86, 0xf7, 0x0d, 0x01, 0x01, 0x05, 0x05, 0x00, 0x30, 0x1c, 0x31, 0x1a, 0x30, 0x18, 0x06, 0x03, 0x55, 0x04, 0x0a, 0x13, 0x11, 0x77, 0x77, 0x77, 0x2e, 0x65, 0x73, 0x70, 0x72, 0x65, 0x73, 0x73, 0x69, 0x66, 0x2e, 0x63, 0x6f, 0x6d, 0x30, 0x1e, 0x17, 0x0d, 0x31, 0x34, 0x30, 0x36, 0x32, 0x34, 0x31, 0x30, 0x32, 0x32, 0x33, 0x33, 0x5a, 0x17, 0x0d, 0x32, 0x38, 0x30, 0x33, 0x30, 0x32, 0x31, 0x30, 0x32, 0x32, 0x33, 0x33, 0x5a, 0x30, 0x34, 0x31, 0x12, 0x30, 0x10, 0x06, 0x03, 0x55, 0x04, 0x0a, 0x13, 0x09, 0x65, 0x73, 0x70, 0x72, 0x65, 0x73, 0x73, 0x69, 0x66, 0x31, 0x1e, 0x30, 0x1c, 0x06, 0x03, 0x55, 0x04, 0x03, 0x13, 0x15, 0x65, 0x73, 0x70, 0x72, 0x65, 0x73, 0x73, 0x69, 0x66, 0x20, 0x49, 0x6f, 0x54, 0x20, 0x70, 0x72, 0x6f, 0x6a, 0x65, 0x63, 0x74, 0x30, 0x5c, 0x30, 0x0d, 0x06, 0x09, 0x2a, 0x86, 0x48, 0x86, 0xf7, 0x0d, 0x01, 0x01, 0x01, 0x05, 0x00, 0x03, 0x4b, 0x00, 0x30, 0x48, 0x02, 0x41, 0x00, 0xb9, 0x83, 0x30, 0xca, 0xfb, 0xec, 0x11, 0x9e, 0x94, 0xb7, 0x89, 0xf2, 0x84, 0x2c, 0xda, 0xe1, 0x9a, 0x53, 0x3a, 0x1b, 0x6e, 0xc9, 0x85, 0x81, 0xf9, 0xa3, 0x41, 0xdb, 0xe2, 0x82, 0x3b, 0xfa, 0x80, 0x22, 0x3b, 0x81, 0x6d, 0x25, 0x73, 0x7e, 0xf6, 0x49, 0xcc, 0x69, 0x3c, 0x6c, 0xd8, 0x05, 0xfb, 0x92, 0x02, 0xcf, 0x19, 0x2a, 0x10, 0x7d, 0x69, 0x7a, 0xd8, 0x9d, 0xd3, 0xcf, 0x6c, 0xef, 0x02, 0x03, 0x01, 0x00, 0x01, 0x30, 0x0d, 0x06, 0x09, 0x2a, 0x86, 0x48, 0x86, 0xf7, 0x0d, 0x01, 0x01, 0x05, 0x05, 0x00, 0x03, 0x81, 0x81, 0x00, 0x2d, 0x63, 0x58, 0x21, 0xe3, 0x8b, 0x37, 0x0d, 0x28, 0x68, 0x11, 0x0e, 0x4d, 0xdd, 0xf3, 0xea, 0xdb, 0xec, 0xd7, 0x09, 0x47, 0x2c, 0xa1, 0xd8, 0xd1, 0x71, 0x83, 0x11, 0xb4, 0x17, 0xbc, 0x83, 0xea, 0x5a, 0xd6, 0x73, 0x02, 0x25, 0x87, 0x01, 0x76, 0xfc, 0x59, 0x1a, 0xcf, 0xd9, 0x49, 0xc9, 0xf9, 0x1f, 0x5c, 0x3b, 0x24, 0x6a, 0x5c, 0xa5, 0xca, 0xe6, 0x5d, 0x34, 0x5b, 0x5f, 0xcf, 0x56, 0x9c, 0x71, 0xd2, 0x6b, 0xdd, 0x1f, 0x15, 0xae, 0x4d, 0xf1, 0xca, 0x35, 0xc8, 0xdd, 0x93, 0x1b, 0x58, 0x1e, 0x94, 0x08, 0xcf, 0xa0, 0x20, 0xb9, 0x75, 0xa5, 0x4c, 0x77, 0xf5, 0x7f, 0xed, 0xd5, 0xcd, 0x53, 0xaa, 0x87, 0xa6, 0x3c, 0xf5, 0x72, 0xd8, 0xd2, 0xb0, 0xf7, 0x11, 0xb0, 0x0e, 0xe9, 0x41, 0xd6, 0x8e, 0xd9, 0x07, 0xf8, 0xed, 0xf8, 0x67, 0x7f, 0x28, 0x18, 0xf0, 0x1b, 0x29, 0x11 }; unsigned int default_certificate_len = 390; ================================================ FILE: app/include/ssl/private_key.h ================================================ unsigned char default_private_key[] = { 0x30, 0x82, 0x01, 0x3a, 0x02, 0x01, 0x00, 0x02, 0x41, 0x00, 0xb9, 0x83, 0x30, 0xca, 0xfb, 0xec, 0x11, 0x9e, 0x94, 0xb7, 0x89, 0xf2, 0x84, 0x2c, 0xda, 0xe1, 0x9a, 0x53, 0x3a, 0x1b, 0x6e, 0xc9, 0x85, 0x81, 0xf9, 0xa3, 0x41, 0xdb, 0xe2, 0x82, 0x3b, 0xfa, 0x80, 0x22, 0x3b, 0x81, 0x6d, 0x25, 0x73, 0x7e, 0xf6, 0x49, 0xcc, 0x69, 0x3c, 0x6c, 0xd8, 0x05, 0xfb, 0x92, 0x02, 0xcf, 0x19, 0x2a, 0x10, 0x7d, 0x69, 0x7a, 0xd8, 0x9d, 0xd3, 0xcf, 0x6c, 0xef, 0x02, 0x03, 0x01, 0x00, 0x01, 0x02, 0x40, 0x1d, 0x13, 0x92, 0xf2, 0x3d, 0xca, 0x22, 0x78, 0xd8, 0x96, 0x6b, 0xe8, 0xb7, 0x0e, 0xd0, 0xbf, 0xcb, 0x90, 0x7f, 0xeb, 0x0c, 0xd2, 0x49, 0x3a, 0xb6, 0x06, 0x00, 0xac, 0x96, 0x34, 0x13, 0x72, 0x4b, 0x8c, 0xd2, 0xb9, 0x35, 0xf5, 0x64, 0x18, 0xb2, 0x47, 0x5b, 0x9f, 0xbb, 0xf2, 0x5b, 0x2f, 0x66, 0x78, 0x2d, 0x0a, 0x76, 0x44, 0xc5, 0x4f, 0xdb, 0x7d, 0x13, 0xcf, 0xa5, 0x08, 0xdc, 0x01, 0x02, 0x21, 0x00, 0xdf, 0x9a, 0x89, 0xd0, 0xef, 0x23, 0xcf, 0x12, 0xac, 0x8a, 0x63, 0x1a, 0x8c, 0xc0, 0x3f, 0xf4, 0x38, 0x52, 0x3c, 0x9f, 0x19, 0x0a, 0x37, 0xd2, 0xcb, 0x5d, 0xeb, 0xb6, 0x2a, 0x33, 0xb0, 0x91, 0x02, 0x21, 0x00, 0xd4, 0x63, 0xd9, 0x6a, 0x18, 0x5b, 0xe8, 0xa8, 0x57, 0x4d, 0xd1, 0x9a, 0xa8, 0xd7, 0xe1, 0x65, 0x75, 0xb3, 0xb9, 0x5c, 0x94, 0x14, 0xca, 0x98, 0x41, 0x47, 0x9c, 0x0a, 0x22, 0x38, 0x05, 0x7f, 0x02, 0x20, 0x6a, 0xce, 0xfd, 0xef, 0xe0, 0x9b, 0x61, 0x49, 0x91, 0x43, 0x95, 0x6d, 0x54, 0x38, 0x6d, 0x14, 0x32, 0x67, 0x0d, 0xf0, 0x0d, 0x5c, 0xf5, 0x27, 0x6a, 0xdf, 0x55, 0x3d, 0xb1, 0xd0, 0xf9, 0x11, 0x02, 0x21, 0x00, 0xba, 0x94, 0xa0, 0xf9, 0xb0, 0x3e, 0x85, 0x8b, 0xe5, 0x6e, 0x4a, 0x95, 0x88, 0x80, 0x65, 0xd5, 0x00, 0xea, 0x8b, 0x0b, 0x46, 0x57, 0x61, 0x87, 0x11, 0xc9, 0xfb, 0xcd, 0x77, 0x34, 0x29, 0xb7, 0x02, 0x20, 0x06, 0x8d, 0x41, 0x11, 0x47, 0x93, 0xcb, 0xad, 0xda, 0x5d, 0xe1, 0x9d, 0x49, 0x8d, 0xe0, 0xab, 0x48, 0xe6, 0x18, 0x28, 0x4a, 0x94, 0xae, 0xf9, 0xad, 0xc5, 0x5b, 0x0b, 0x15, 0xc6, 0x73, 0x17 }; unsigned int default_private_key_len = 318; ================================================ FILE: app/include/ssl/ssl_bigint.h ================================================ /* * Copyright (c) 2007, Cameron Rich * * 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 axTLS project 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. */ #ifndef BIGINT_HEADER #define BIGINT_HEADER #include "ssl/ssl_crypto.h" BI_CTX *bi_initialize(void); void bi_terminate(BI_CTX *ctx); void bi_permanent(bigint *bi); void bi_depermanent(bigint *bi); void bi_clear_cache(BI_CTX *ctx); void bi_free(BI_CTX *ctx, bigint *bi); bigint *bi_copy(bigint *bi); bigint *bi_clone(BI_CTX *ctx, const bigint *bi); void bi_export(BI_CTX *ctx, bigint *bi, uint8_t *data, int size); bigint *bi_import(BI_CTX *ctx, const uint8_t *data, int len); bigint *int_to_bi(BI_CTX *ctx, comp i); /* the functions that actually do something interesting */ bigint *bi_add(BI_CTX *ctx, bigint *bia, bigint *bib); bigint *bi_subtract(BI_CTX *ctx, bigint *bia, bigint *bib, int *is_negative); bigint *bi_divide(BI_CTX *ctx, bigint *bia, bigint *bim, int is_mod); bigint *bi_multiply(BI_CTX *ctx, bigint *bia, bigint *bib); bigint *bi_mod_power(BI_CTX *ctx, bigint *bi, bigint *biexp); bigint *bi_mod_power2(BI_CTX *ctx, bigint *bi, bigint *bim, bigint *biexp); int bi_compare(bigint *bia, bigint *bib); void bi_set_mod(BI_CTX *ctx, bigint *bim, int mod_offset); void bi_free_mod(BI_CTX *ctx, int mod_offset); #ifdef CONFIG_SSL_FULL_MODE void bi_print(const char *label, bigint *bi); bigint *bi_str_import(BI_CTX *ctx, const char *data); #endif /** * @def bi_mod * Find the residue of B. bi_set_mod() must be called before hand. */ #define bi_mod(A, B) bi_divide(A, B, ctx->bi_mod[ctx->mod_offset], 1) /** * bi_residue() is technically the same as bi_mod(), but it uses the * appropriate reduction technique (which is bi_mod() when doing classical * reduction). */ #if defined(CONFIG_BIGINT_MONTGOMERY) #define bi_residue(A, B) bi_mont(A, B) bigint *bi_mont(BI_CTX *ctx, bigint *bixy); #elif defined(CONFIG_BIGINT_BARRETT) #define bi_residue(A, B) bi_barrett(A, B) bigint *bi_barrett(BI_CTX *ctx, bigint *bi); #else /* if defined(CONFIG_BIGINT_CLASSICAL) */ #define bi_residue(A, B) bi_mod(A, B) #endif #ifdef CONFIG_BIGINT_SQUARE bigint *bi_square(BI_CTX *ctx, bigint *bi); #else #define bi_square(A, B) bi_multiply(A, bi_copy(B), B) #endif #ifdef CONFIG_BIGINT_CRT bigint *bi_crt(BI_CTX *ctx, bigint *bi, bigint *dP, bigint *dQ, bigint *p, bigint *q, bigint *qInv); #endif #endif ================================================ FILE: app/include/ssl/ssl_bigint_impl.h ================================================ /* * Copyright (c) 2007, Cameron Rich * * 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 axTLS project 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. */ #ifndef BIGINT_IMPL_HEADER #define BIGINT_IMPL_HEADER /* Maintain a number of precomputed variables when doing reduction */ #define BIGINT_M_OFFSET 0 /**< Normal modulo offset. */ #ifdef CONFIG_BIGINT_CRT #define BIGINT_P_OFFSET 1 /**< p modulo offset. */ #define BIGINT_Q_OFFSET 2 /**< q module offset. */ #define BIGINT_NUM_MODS 3 /**< The number of modulus constants used. */ #else #define BIGINT_NUM_MODS 1 #endif /* Architecture specific functions for big ints */ #if defined(CONFIG_INTEGER_8BIT) #define COMP_RADIX 256U /**< Max component + 1 */ #define COMP_MAX 0xFFFFU/**< (Max dbl comp -1) */ #define COMP_BIT_SIZE 8 /**< Number of bits in a component. */ #define COMP_BYTE_SIZE 1 /**< Number of bytes in a component. */ #define COMP_NUM_NIBBLES 2 /**< Used For diagnostics only. */ typedef uint8_t comp; /**< A single precision component. */ typedef uint16_t long_comp; /**< A double precision component. */ typedef int16_t slong_comp; /**< A signed double precision component. */ #elif defined(CONFIG_INTEGER_16BIT) #define COMP_RADIX 65536U /**< Max component + 1 */ #define COMP_MAX 0xFFFFFFFFU/**< (Max dbl comp -1) */ #define COMP_BIT_SIZE 16 /**< Number of bits in a component. */ #define COMP_BYTE_SIZE 2 /**< Number of bytes in a component. */ #define COMP_NUM_NIBBLES 4 /**< Used For diagnostics only. */ typedef uint16_t comp; /**< A single precision component. */ typedef uint32_t long_comp; /**< A double precision component. */ typedef int32_t slong_comp; /**< A signed double precision component. */ #else /* regular 32 bit */ #ifdef WIN32 #define COMP_RADIX 4294967296i64 #define COMP_MAX 0xFFFFFFFFFFFFFFFFui64 #else #define COMP_RADIX 4294967296ULL /**< Max component + 1 */ #define COMP_MAX 0xFFFFFFFFFFFFFFFFULL/**< (Max dbl comp -1) */ #endif #define COMP_BIT_SIZE 32 /**< Number of bits in a component. */ #define COMP_BYTE_SIZE 4 /**< Number of bytes in a component. */ #define COMP_NUM_NIBBLES 8 /**< Used For diagnostics only. */ typedef uint32_t comp; /**< A single precision component. */ typedef uint64_t long_comp; /**< A double precision component. */ typedef sint64_t slong_comp; /**< A signed double precision component. */ #endif /** * @struct _bigint * @brief A big integer basic object */ struct _bigint { struct _bigint* next; /**< The next bigint in the cache. */ short size; /**< The number of components in this bigint. */ short max_comps; /**< The heapsize allocated for this bigint */ int refs; /**< An internal reference count. */ comp* comps; /**< A ptr to the actual component data */ }; typedef struct _bigint bigint; /**< An alias for _bigint */ /** * Maintains the state of the cache, and a number of variables used in * reduction. */ typedef struct /**< A big integer "session" context. */ { bigint *active_list; /**< Bigints currently used. */ bigint *free_list; /**< Bigints not used. */ bigint *bi_radix; /**< The radix used. */ bigint *bi_mod[BIGINT_NUM_MODS]; /**< modulus */ #if defined(CONFIG_BIGINT_MONTGOMERY) bigint *bi_RR_mod_m[BIGINT_NUM_MODS]; /**< R^2 mod m */ bigint *bi_R_mod_m[BIGINT_NUM_MODS]; /**< R mod m */ comp N0_dash[BIGINT_NUM_MODS]; #elif defined(CONFIG_BIGINT_BARRETT) bigint *bi_mu[BIGINT_NUM_MODS]; /**< Storage for mu */ #endif bigint *bi_normalised_mod[BIGINT_NUM_MODS]; /**< Normalised mod storage. */ bigint **g; /**< Used by sliding-window. */ int window; /**< The size of the sliding window */ int active_count; /**< Number of active bigints. */ int free_count; /**< Number of free bigints. */ #ifdef CONFIG_BIGINT_MONTGOMERY uint8_t use_classical; /**< Use classical reduction. */ #endif uint8_t mod_offset; /**< The mod offset we are using */ } BI_CTX; #ifndef WIN32 #define max(a,b) ((a)>(b)?(a):(b)) /**< Find the maximum of 2 numbers. */ #define min(a,b) ((a)<(b)?(a):(b)) /**< Find the minimum of 2 numbers. */ #endif #define PERMANENT 0x7FFF55AA /**< A magic number for permanents. */ #endif ================================================ FILE: app/include/ssl/ssl_cert.h ================================================ unsigned char default_certificate[] = { 0x30, 0x82, 0x01, 0xd7, 0x30, 0x82, 0x01, 0x40, 0x02, 0x09, 0x00, 0xab, 0x08, 0x18, 0xa7, 0x03, 0x07, 0x27, 0xfd, 0x30, 0x0d, 0x06, 0x09, 0x2a, 0x86, 0x48, 0x86, 0xf7, 0x0d, 0x01, 0x01, 0x05, 0x05, 0x00, 0x30, 0x34, 0x31, 0x32, 0x30, 0x30, 0x06, 0x03, 0x55, 0x04, 0x0a, 0x13, 0x29, 0x61, 0x78, 0x54, 0x4c, 0x53, 0x20, 0x50, 0x72, 0x6f, 0x6a, 0x65, 0x63, 0x74, 0x20, 0x44, 0x6f, 0x64, 0x67, 0x79, 0x20, 0x43, 0x65, 0x72, 0x74, 0x69, 0x66, 0x69, 0x63, 0x61, 0x74, 0x65, 0x20, 0x41, 0x75, 0x74, 0x68, 0x6f, 0x72, 0x69, 0x74, 0x79, 0x30, 0x1e, 0x17, 0x0d, 0x31, 0x30, 0x31, 0x32, 0x32, 0x36, 0x32, 0x32, 0x33, 0x33, 0x33, 0x39, 0x5a, 0x17, 0x0d, 0x32, 0x34, 0x30, 0x39, 0x30, 0x33, 0x32, 0x32, 0x33, 0x33, 0x33, 0x39, 0x5a, 0x30, 0x2c, 0x31, 0x16, 0x30, 0x14, 0x06, 0x03, 0x55, 0x04, 0x0a, 0x13, 0x0d, 0x61, 0x78, 0x54, 0x4c, 0x53, 0x20, 0x50, 0x72, 0x6f, 0x6a, 0x65, 0x63, 0x74, 0x31, 0x12, 0x30, 0x10, 0x06, 0x03, 0x55, 0x04, 0x03, 0x13, 0x09, 0x31, 0x32, 0x37, 0x2e, 0x30, 0x2e, 0x30, 0x2e, 0x31, 0x30, 0x81, 0x9f, 0x30, 0x0d, 0x06, 0x09, 0x2a, 0x86, 0x48, 0x86, 0xf7, 0x0d, 0x01, 0x01, 0x01, 0x05, 0x00, 0x03, 0x81, 0x8d, 0x00, 0x30, 0x81, 0x89, 0x02, 0x81, 0x81, 0x00, 0xcd, 0xfd, 0x89, 0x48, 0xbe, 0x36, 0xb9, 0x95, 0x76, 0xd4, 0x13, 0x30, 0x0e, 0xbf, 0xb2, 0xed, 0x67, 0x0a, 0xc0, 0x16, 0x3f, 0x51, 0x09, 0x9d, 0x29, 0x2f, 0xb2, 0x6d, 0x3f, 0x3e, 0x6c, 0x2f, 0x90, 0x80, 0xa1, 0x71, 0xdf, 0xbe, 0x38, 0xc5, 0xcb, 0xa9, 0x9a, 0x40, 0x14, 0x90, 0x0a, 0xf9, 0xb7, 0x07, 0x0b, 0xe1, 0xda, 0xe7, 0x09, 0xbf, 0x0d, 0x57, 0x41, 0x86, 0x60, 0xa1, 0xc1, 0x27, 0x91, 0x5b, 0x0a, 0x98, 0x46, 0x1b, 0xf6, 0xa2, 0x84, 0xf8, 0x65, 0xc7, 0xce, 0x2d, 0x96, 0x17, 0xaa, 0x91, 0xf8, 0x61, 0x04, 0x50, 0x70, 0xeb, 0xb4, 0x43, 0xb7, 0xdc, 0x9a, 0xcc, 0x31, 0x01, 0x14, 0xd4, 0xcd, 0xcc, 0xc2, 0x37, 0x6d, 0x69, 0x82, 0xd6, 0xc6, 0xc4, 0xbe, 0xf2, 0x34, 0xa5, 0xc9, 0xa6, 0x19, 0x53, 0x32, 0x7a, 0x86, 0x0e, 0x91, 0x82, 0x0f, 0xa1, 0x42, 0x54, 0xaa, 0x01, 0x02, 0x03, 0x01, 0x00, 0x01, 0x30, 0x0d, 0x06, 0x09, 0x2a, 0x86, 0x48, 0x86, 0xf7, 0x0d, 0x01, 0x01, 0x05, 0x05, 0x00, 0x03, 0x81, 0x81, 0x00, 0x40, 0xb4, 0x94, 0x9a, 0xa8, 0x89, 0x72, 0x1d, 0x07, 0xe5, 0xb3, 0x6b, 0x88, 0x21, 0xc2, 0x38, 0x36, 0x9e, 0x7a, 0x8c, 0x49, 0x48, 0x68, 0x0c, 0x06, 0xe8, 0xdb, 0x1f, 0x4e, 0x05, 0xe6, 0x31, 0xe3, 0xfd, 0xe6, 0x0d, 0x6b, 0xd8, 0x13, 0x17, 0xe0, 0x2d, 0x0d, 0xb8, 0x7e, 0xcb, 0x20, 0x6c, 0xa8, 0x73, 0xa7, 0xfd, 0xe3, 0xa7, 0xfa, 0xf3, 0x02, 0x60, 0x78, 0x1f, 0x13, 0x40, 0x45, 0xee, 0x75, 0xf5, 0x10, 0xfd, 0x8f, 0x68, 0x74, 0xd4, 0xac, 0xae, 0x04, 0x09, 0x55, 0x2c, 0xdb, 0xd8, 0x07, 0x07, 0x65, 0x69, 0x27, 0x6e, 0xbf, 0x5e, 0x61, 0x40, 0x56, 0x8b, 0xd7, 0x33, 0x3b, 0xff, 0x6e, 0x53, 0x7e, 0x9d, 0x3f, 0xc0, 0x40, 0x3a, 0xab, 0xa0, 0x50, 0x4e, 0x80, 0x47, 0x46, 0x0d, 0x1e, 0xdb, 0x4c, 0xf1, 0x1b, 0x5d, 0x3c, 0x2a, 0x54, 0xa7, 0x4d, 0xfa, 0x7b, 0x72, 0x66, 0xc5 }; unsigned int default_certificate_len = 475; ================================================ FILE: app/include/ssl/ssl_config.h ================================================ /* * Automatically generated header file: don't edit */ #define HAVE_DOT_CONFIG 1 #undef CONFIG_PLATFORM_LINUX #define CONFIG_PLATFORM_CYGWIN 1 #undef CONFIG_PLATFORM_WIN32 /* * General Configuration */ #define PREFIX "/usr/local" #define CONFIG_DEBUG 1 #undef CONFIG_STRIP_UNWANTED_SECTIONS #undef CONFIG_VISUAL_STUDIO_7_0 #undef CONFIG_VISUAL_STUDIO_8_0 #undef CONFIG_VISUAL_STUDIO_10_0 #define CONFIG_VISUAL_STUDIO_7_0_BASE "" #define CONFIG_VISUAL_STUDIO_8_0_BASE "" #define CONFIG_VISUAL_STUDIO_10_0_BASE "" #define CONFIG_EXTRA_CFLAGS_OPTIONS "" #define CONFIG_EXTRA_LDFLAGS_OPTIONS "" /* * SSL Library */ #undef CONFIG_SSL_SERVER_ONLY #undef CONFIG_SSL_CERT_VERIFICATION #undef CONFIG_SSL_ENABLE_CLIENT #define CONFIG_SSL_FULL_MODE 1 #undef CONFIG_SSL_SKELETON_MODE #undef CONFIG_SSL_PROT_LOW #define CONFIG_SSL_PROT_MEDIUM 1 #undef CONFIG_SSL_PROT_HIGH #define CONFIG_SSL_USE_DEFAULT_KEY #define CONFIG_SSL_PRIVATE_KEY_LOCATION "" #define CONFIG_SSL_PRIVATE_KEY_PASSWORD "" #define CONFIG_SSL_X509_CERT_LOCATION "" #undef CONFIG_SSL_GENERATE_X509_CERT #define CONFIG_SSL_X509_COMMON_NAME "" #define CONFIG_SSL_X509_ORGANIZATION_NAME "" #define CONFIG_SSL_X509_ORGANIZATION_UNIT_NAME "" #undef CONFIG_SSL_ENABLE_V23_HANDSHAKE #define CONFIG_SSL_HAS_PEM 1 #undef CONFIG_SSL_USE_PKCS12 #define CONFIG_SSL_EXPIRY_TIME 24 #define CONFIG_X509_MAX_CA_CERTS 150 #define CONFIG_SSL_MAX_CERTS 3 #undef CONFIG_SSL_CTX_MUTEXING //#define CONFIG_USE_DEV_URANDOM 1 #undef CONFIG_WIN32_USE_CRYPTO_LIB #undef CONFIG_OPENSSL_COMPATIBLE #undef CONFIG_PERFORMANCE_TESTING #define CONFIG_SSL_TEST 1 #undef CONFIG_AXTLSWRAP #define CONFIG_AXHTTPD 1 /* * Axhttpd Configuration */ #undef CONFIG_HTTP_STATIC_BUILD #define CONFIG_HTTP_PORT 80 #define CONFIG_HTTP_HTTPS_PORT 443 #define CONFIG_HTTP_SESSION_CACHE_SIZE 5 #define CONFIG_HTTP_WEBROOT "../www" #define CONFIG_HTTP_TIMEOUT 300 /* * CGI */ #undef CONFIG_HTTP_HAS_CGI #define CONFIG_HTTP_CGI_EXTENSIONS ".lua,.lp,.php" #define CONFIG_HTTP_ENABLE_LUA 1 #define CONFIG_HTTP_LUA_PREFIX "/usr" #undef CONFIG_HTTP_BUILD_LUA #define CONFIG_HTTP_CGI_LAUNCHER "/usr/bin/cgi" #define CONFIG_HTTP_DIRECTORIES 1 #define CONFIG_HTTP_HAS_AUTHORIZATION 1 #undef CONFIG_HTTP_HAS_IPV6 #undef CONFIG_HTTP_ENABLE_DIFFERENT_USER #define CONFIG_HTTP_USER "" #define CONFIG_HTTP_VERBOSE 0 #undef CONFIG_HTTP_IS_DAEMON /* * Language Bindings */ #undef CONFIG_BINDINGS #undef CONFIG_CSHARP_BINDINGS #undef CONFIG_VBNET_BINDINGS #define CONFIG_DOT_NET_FRAMEWORK_BASE "" #undef CONFIG_JAVA_BINDINGS #define CONFIG_JAVA_HOME "" #undef CONFIG_PERL_BINDINGS #define CONFIG_PERL_CORE "" #define CONFIG_PERL_LIB "" #undef CONFIG_LUA_BINDINGS #define CONFIG_LUA_CORE "" /* * Samples */ #define CONFIG_SAMPLES 1 #define CONFIG_C_SAMPLES 1 #undef CONFIG_CSHARP_SAMPLES #undef CONFIG_VBNET_SAMPLES #undef CONFIG_JAVA_SAMPLES #undef CONFIG_PERL_SAMPLES #undef CONFIG_LUA_SAMPLES /* * BigInt Options */ #undef CONFIG_BIGINT_CLASSICAL #undef CONFIG_BIGINT_MONTGOMERY #define CONFIG_BIGINT_BARRETT 1 #define CONFIG_BIGINT_CRT 1 #undef CONFIG_BIGINT_KARATSUBA #define MUL_KARATSUBA_THRESH #define SQU_KARATSUBA_THRESH #define CONFIG_BIGINT_SLIDING_WINDOW 1 #define CONFIG_BIGINT_SQUARE 1 #define CONFIG_BIGINT_CHECK_ON 1 #define CONFIG_INTEGER_32BIT 1 #undef CONFIG_INTEGER_16BIT #undef CONFIG_INTEGER_8BIT ================================================ FILE: app/include/ssl/ssl_crypto.h ================================================ /* * Copyright (c) 2007, Cameron Rich * * 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 axTLS project 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. */ /** * @file crypto.h */ #ifndef HEADER_CRYPTO_H #define HEADER_CRYPTO_H #ifdef __cplusplus extern "C" { #endif #include "ssl/ssl_config.h" #include "ssl/ssl_bigint_impl.h" #include "ssl/ssl_bigint.h" #ifndef STDCALL #define STDCALL #endif #ifndef EXP_FUNC #define EXP_FUNC #endif /* enable features based on a 'super-set' capbaility. */ #if defined(CONFIG_SSL_FULL_MODE) #define CONFIG_SSL_ENABLE_CLIENT #define CONFIG_SSL_CERT_VERIFICATION #elif defined(CONFIG_SSL_ENABLE_CLIENT) #define CONFIG_SSL_CERT_VERIFICATION #endif /************************************************************************** * AES declarations **************************************************************************/ #define AES_MAXROUNDS 14 #define AES_BLOCKSIZE 16 #define AES_IV_SIZE 16 typedef struct aes_key_st { uint16_t rounds; uint16_t key_size; uint32_t ks[(AES_MAXROUNDS+1)*8]; uint8_t iv[AES_IV_SIZE]; } AES_CTX; typedef enum { AES_MODE_128, AES_MODE_256 } AES_MODE; void AES_set_key(AES_CTX *ctx, const uint8_t *key, const uint8_t *iv, AES_MODE mode); void AES_cbc_encrypt(AES_CTX *ctx, const uint8_t *msg, uint8_t *out, int length); void AES_cbc_decrypt(AES_CTX *ks, const uint8_t *in, uint8_t *out, int length); void AES_convert_key(AES_CTX *ctx); /************************************************************************** * RC4 declarations **************************************************************************/ typedef struct { uint8_t x, y, m[256]; } RC4_CTX; void RC4_setup(RC4_CTX *s, const uint8_t *key, int length); void RC4_crypt(RC4_CTX *s, const uint8_t *msg, uint8_t *data, int length); /************************************************************************** * SHA1 declarations **************************************************************************/ #define SHA1_SIZE 20 /* * This structure will hold context information for the SHA-1 * hashing operation */ typedef struct { uint32_t Intermediate_Hash[SHA1_SIZE/4]; /* Message Digest */ uint32_t Length_Low; /* Message length in bits */ uint32_t Length_High; /* Message length in bits */ uint16_t Message_Block_Index; /* Index into message block array */ uint8_t Message_Block[64]; /* 512-bit message blocks */ } SHA1_CTX; void SHA1_Init(SHA1_CTX *); void SHA1_Update(SHA1_CTX *, const uint8_t * msg, int len); void SHA1_Final(uint8_t *digest, SHA1_CTX *); /************************************************************************** * MD2 declarations **************************************************************************/ #define MD2_SIZE 16 typedef struct { unsigned char cksum[16]; /* checksum of the data block */ unsigned char state[48]; /* intermediate digest state */ unsigned char buffer[16]; /* data block being processed */ int left; /* amount of data in buffer */ } MD2_CTX; EXP_FUNC void STDCALL MD2_Init(MD2_CTX *ctx); EXP_FUNC void STDCALL MD2_Update(MD2_CTX *ctx, const uint8_t *input, int ilen); EXP_FUNC void STDCALL MD2_Final(uint8_t *digest, MD2_CTX *ctx); /************************************************************************** * MD5 declarations **************************************************************************/ #define MD5_SIZE 16 typedef struct { uint32_t state[4]; /* state (ABCD) */ uint32_t count[2]; /* number of bits, modulo 2^64 (lsb first) */ uint8_t buffer[64]; /* input buffer */ } MD5_CTX; EXP_FUNC void STDCALL MD5_Init(MD5_CTX *); EXP_FUNC void STDCALL MD5_Update(MD5_CTX *, const uint8_t *msg, int len); EXP_FUNC void STDCALL MD5_Final(uint8_t *digest, MD5_CTX *); /************************************************************************** * HMAC declarations **************************************************************************/ void ssl_hmac_md5(const uint8_t *msg, int length, const uint8_t *key, int key_len, uint8_t *digest);// fix hmac_md5 to ssl_hmac_md5, discriminate ieee80211 void ssl_hmac_sha1(const uint8_t *msg, int length, const uint8_t *key, int key_len, uint8_t *digest);// fix hmac_md5 to ssl_hmac_sha1, discriminate ieee80211 /************************************************************************** * RSA declarations **************************************************************************/ typedef struct { bigint *m; /* modulus */ bigint *e; /* public exponent */ bigint *d; /* private exponent */ #ifdef CONFIG_BIGINT_CRT bigint *p; /* p as in m = pq */ bigint *q; /* q as in m = pq */ bigint *dP; /* d mod (p-1) */ bigint *dQ; /* d mod (q-1) */ bigint *qInv; /* q^-1 mod p */ #endif int num_octets; BI_CTX *bi_ctx; } RSA_CTX; void RSA_priv_key_new(RSA_CTX **rsa_ctx, const uint8_t *modulus, int mod_len, const uint8_t *pub_exp, int pub_len, const uint8_t *priv_exp, int priv_len #ifdef CONFIG_BIGINT_CRT , const uint8_t *p, int p_len, const uint8_t *q, int q_len, const uint8_t *dP, int dP_len, const uint8_t *dQ, int dQ_len, const uint8_t *qInv, int qInv_len #endif ); void RSA_pub_key_new(RSA_CTX **rsa_ctx, const uint8_t *modulus, int mod_len, const uint8_t *pub_exp, int pub_len); void RSA_free(RSA_CTX *ctx); int RSA_decrypt(const RSA_CTX *ctx, const uint8_t *in_data, uint8_t *out_data, int is_decryption); bigint *RSA_private(const RSA_CTX *c, bigint *bi_msg); #if defined(CONFIG_SSL_CERT_VERIFICATION) || defined(CONFIG_SSL_GENERATE_X509_CERT) bigint *RSA_sign_verify(BI_CTX *ctx, const uint8_t *sig, int sig_len, bigint *modulus, bigint *pub_exp); bigint *RSA_public(const RSA_CTX * c, bigint *bi_msg); int RSA_encrypt(const RSA_CTX *ctx, const uint8_t *in_data, uint16_t in_len, uint8_t *out_data, int is_signing); void RSA_print(const RSA_CTX *ctx); #endif /************************************************************************** * RNG declarations **************************************************************************/ EXP_FUNC void STDCALL RNG_initialize(void); EXP_FUNC void STDCALL RNG_custom_init(const uint8_t *seed_buf, int size); EXP_FUNC void STDCALL RNG_terminate(void); EXP_FUNC void STDCALL get_random(int num_rand_bytes, uint8_t *rand_data); void get_random_NZ(int num_rand_bytes, uint8_t *rand_data); #ifdef __cplusplus } #endif #endif ================================================ FILE: app/include/ssl/ssl_crypto_misc.h ================================================ /* * Copyright (c) 2007, Cameron Rich * * 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 axTLS project 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. */ /** * @file crypto_misc.h */ #ifndef HEADER_CRYPTO_MISC_H #define HEADER_CRYPTO_MISC_H #ifdef __cplusplus extern "C" { #endif #include "ssl/ssl_crypto.h" #include "ssl/ssl_bigint.h" /************************************************************************** * X509 declarations **************************************************************************/ #define X509_OK 0 #define X509_NOT_OK -1 #define X509_VFY_ERROR_NO_TRUSTED_CERT -2 #define X509_VFY_ERROR_BAD_SIGNATURE -3 #define X509_VFY_ERROR_NOT_YET_VALID -4 #define X509_VFY_ERROR_EXPIRED -5 #define X509_VFY_ERROR_SELF_SIGNED -6 #define X509_VFY_ERROR_INVALID_CHAIN -7 #define X509_VFY_ERROR_UNSUPPORTED_DIGEST -8 #define X509_INVALID_PRIV_KEY -9 /* * The Distinguished Name */ #define X509_NUM_DN_TYPES 3 #define X509_COMMON_NAME 0 #define X509_ORGANIZATION 1 #define X509_ORGANIZATIONAL_UNIT 2 struct _x509_ctx { char *ca_cert_dn[X509_NUM_DN_TYPES]; char *cert_dn[X509_NUM_DN_TYPES]; char **subject_alt_dnsnames; time_t not_before; time_t not_after; uint8_t *signature; uint16_t sig_len; uint8_t sig_type; RSA_CTX *rsa_ctx; bigint *digest; struct _x509_ctx *next; }; typedef struct _x509_ctx X509_CTX; #ifdef CONFIG_SSL_CERT_VERIFICATION typedef struct { X509_CTX *cert[CONFIG_X509_MAX_CA_CERTS]; } CA_CERT_CTX; #endif int x509_new(const uint8_t *cert, int *len, X509_CTX **ctx); void x509_free(X509_CTX *x509_ctx); #ifdef CONFIG_SSL_CERT_VERIFICATION int x509_verify(const CA_CERT_CTX *ca_cert_ctx, const X509_CTX *cert); #endif #ifdef CONFIG_SSL_FULL_MODE void x509_print(const X509_CTX *cert, CA_CERT_CTX *ca_cert_ctx); const char * x509_display_error(int error); #endif /************************************************************************** * ASN1 declarations **************************************************************************/ #define ASN1_INTEGER 0x02 #define ASN1_BIT_STRING 0x03 #define ASN1_OCTET_STRING 0x04 #define ASN1_NULL 0x05 #define ASN1_PRINTABLE_STR2 0x0C #define ASN1_OID 0x06 #define ASN1_PRINTABLE_STR2 0x0C #define ASN1_PRINTABLE_STR 0x13 #define ASN1_TELETEX_STR 0x14 #define ASN1_IA5_STR 0x16 #define ASN1_UTC_TIME 0x17 #define ASN1_UNICODE_STR 0x1e #define ASN1_SEQUENCE 0x30 #define ASN1_CONTEXT_DNSNAME 0x82 #define ASN1_SET 0x31 #define ASN1_V3_DATA 0xa3 #define ASN1_IMPLICIT_TAG 0x80 #define ASN1_CONTEXT_DNSNAME 0x82 #define ASN1_EXPLICIT_TAG 0xa0 #define ASN1_V3_DATA 0xa3 #define SIG_TYPE_MD2 0x02 #define SIG_TYPE_MD5 0x04 #define SIG_TYPE_SHA1 0x05 int get_asn1_length(const uint8_t *buf, int *offset); int asn1_get_private_key(const uint8_t *buf, int len, RSA_CTX **rsa_ctx); int asn1_next_obj(const uint8_t *buf, int *offset, int obj_type); int asn1_skip_obj(const uint8_t *buf, int *offset, int obj_type); int asn1_get_int(const uint8_t *buf, int *offset, uint8_t **object); int asn1_version(const uint8_t *cert, int *offset, X509_CTX *x509_ctx); int asn1_validity(const uint8_t *cert, int *offset, X509_CTX *x509_ctx); int asn1_name(const uint8_t *cert, int *offset, char *dn[]); int asn1_public_key(const uint8_t *cert, int *offset, X509_CTX *x509_ctx); #ifdef CONFIG_SSL_CERT_VERIFICATION int asn1_signature(const uint8_t *cert, int *offset, X509_CTX *x509_ctx); int asn1_find_subjectaltname(const uint8_t* cert, int offset); int asn1_compare_dn(char * const dn1[], char * const dn2[]); #endif /* CONFIG_SSL_CERT_VERIFICATION */ int asn1_signature_type(const uint8_t *cert, int *offset, X509_CTX *x509_ctx); /************************************************************************** * MISC declarations **************************************************************************/ #define SALT_SIZE 8 extern const char * const unsupported_str; typedef void (*crypt_func)(void *, const uint8_t *, uint8_t *, int); typedef void (*hmac_func)(const uint8_t *msg, int length, const uint8_t *key, int key_len, uint8_t *digest); int get_file(const char *filename, uint8_t **buf); #if defined(CONFIG_SSL_FULL_MODE) || defined(WIN32) || defined(CONFIG_DEBUG) EXP_FUNC void STDCALL print_blob(const char *format, const uint8_t *data, int size, ...); #else #define print_blob(...) #endif EXP_FUNC int STDCALL base64_decode(const char *in, int len, uint8_t *out, int *outlen); #ifdef __cplusplus } #endif #endif ================================================ FILE: app/include/ssl/ssl_os_int.h ================================================ /* * Copyright (c) 2012, Cameron Rich * * 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 axTLS project 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. */ /** * @file os_int.h * * Ensure a consistent bit size */ #ifndef HEADER_OS_INT_H #define HEADER_OS_INT_H #ifdef __cplusplus extern "C" { #endif #if defined(WIN32) typedef UINT8 uint8_t; typedef INT8 int8_t; typedef UINT16 uint16_t; typedef INT16 int16_t; typedef UINT32 uint32_t; typedef INT32 int32_t; typedef UINT64 uint64_t; typedef INT64 int64_t; #else /* Not Win32 */ #ifdef CONFIG_PLATFORM_SOLARIS #include #else //#include #endif /* Not Solaris */ #endif /* Not Win32 */ #ifdef __cplusplus } #endif #endif ================================================ FILE: app/include/ssl/ssl_os_port.h ================================================ /* * Copyright (c) 2007, Cameron Rich * * 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 axTLS project 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. */ /** * @file os_port.h * * Some stuff to minimise the differences between windows and linux/unix */ #ifndef HEADER_OS_PORT_H #define HEADER_OS_PORT_H #ifdef __cplusplus extern "C" { #endif //#include "../crypto/os_int.h" #include "c_types.h" #include "osapi.h" #include #if 0 #define ssl_printf(fmt, args...) os_printf(fmt,## args) #else #define ssl_printf(fmt, args...) #endif #define STDCALL #define EXP_FUNC struct timeval { long tv_sec; /* seconds */ long tv_usec; /* and microseconds */ }; /* Mutexing definitions */ #define SSL_CTX_MUTEX_INIT(A) #define SSL_CTX_MUTEX_DESTROY(A) #define SSL_CTX_LOCK(A) #define SSL_CTX_UNLOCK(A) #ifdef __cplusplus } #endif #endif ================================================ FILE: app/include/ssl/ssl_private_key.h ================================================ unsigned char default_private_key[] = { 0x30, 0x82, 0x02, 0x5d, 0x02, 0x01, 0x00, 0x02, 0x81, 0x81, 0x00, 0xcd, 0xfd, 0x89, 0x48, 0xbe, 0x36, 0xb9, 0x95, 0x76, 0xd4, 0x13, 0x30, 0x0e, 0xbf, 0xb2, 0xed, 0x67, 0x0a, 0xc0, 0x16, 0x3f, 0x51, 0x09, 0x9d, 0x29, 0x2f, 0xb2, 0x6d, 0x3f, 0x3e, 0x6c, 0x2f, 0x90, 0x80, 0xa1, 0x71, 0xdf, 0xbe, 0x38, 0xc5, 0xcb, 0xa9, 0x9a, 0x40, 0x14, 0x90, 0x0a, 0xf9, 0xb7, 0x07, 0x0b, 0xe1, 0xda, 0xe7, 0x09, 0xbf, 0x0d, 0x57, 0x41, 0x86, 0x60, 0xa1, 0xc1, 0x27, 0x91, 0x5b, 0x0a, 0x98, 0x46, 0x1b, 0xf6, 0xa2, 0x84, 0xf8, 0x65, 0xc7, 0xce, 0x2d, 0x96, 0x17, 0xaa, 0x91, 0xf8, 0x61, 0x04, 0x50, 0x70, 0xeb, 0xb4, 0x43, 0xb7, 0xdc, 0x9a, 0xcc, 0x31, 0x01, 0x14, 0xd4, 0xcd, 0xcc, 0xc2, 0x37, 0x6d, 0x69, 0x82, 0xd6, 0xc6, 0xc4, 0xbe, 0xf2, 0x34, 0xa5, 0xc9, 0xa6, 0x19, 0x53, 0x32, 0x7a, 0x86, 0x0e, 0x91, 0x82, 0x0f, 0xa1, 0x42, 0x54, 0xaa, 0x01, 0x02, 0x03, 0x01, 0x00, 0x01, 0x02, 0x81, 0x81, 0x00, 0x95, 0xaa, 0x6e, 0x11, 0xf5, 0x6a, 0x8b, 0xa2, 0xc6, 0x48, 0xc6, 0x7c, 0x37, 0x6b, 0x1f, 0x55, 0x10, 0x76, 0x26, 0x24, 0xc3, 0xf2, 0x5c, 0x5a, 0xdd, 0x2e, 0xf3, 0xa4, 0x1e, 0xbc, 0x7b, 0x1c, 0x80, 0x10, 0x85, 0xbc, 0xd8, 0x45, 0x3c, 0xb8, 0xb2, 0x06, 0x53, 0xb5, 0xd5, 0x7a, 0xe7, 0x0e, 0x92, 0xe6, 0x42, 0xc2, 0xe2, 0x2a, 0xd5, 0xd1, 0x03, 0x9f, 0x6f, 0x53, 0x74, 0x68, 0x72, 0x8e, 0xbf, 0x03, 0xbb, 0xab, 0xbd, 0xa1, 0xf9, 0x81, 0x7d, 0x12, 0xd4, 0x9d, 0xb6, 0xae, 0x4c, 0xad, 0xca, 0xa8, 0xc9, 0x80, 0x8d, 0x0d, 0xd5, 0xd0, 0xa1, 0xbf, 0xec, 0x60, 0x48, 0x49, 0xed, 0x97, 0x0f, 0x5e, 0xed, 0xfc, 0x39, 0x15, 0x96, 0x9e, 0x5d, 0xe2, 0xb4, 0x5d, 0x2e, 0x04, 0xdc, 0x08, 0xa2, 0x65, 0x29, 0x2d, 0x37, 0xfb, 0x62, 0x90, 0x1b, 0x7b, 0xe5, 0x3a, 0x58, 0x05, 0x55, 0xc1, 0x02, 0x41, 0x00, 0xfc, 0x69, 0x28, 0xc9, 0xa8, 0xc4, 0x5c, 0xe3, 0xd0, 0x5e, 0xaa, 0xda, 0xde, 0x87, 0x74, 0xdb, 0xcb, 0x40, 0x78, 0x8e, 0x1d, 0x12, 0x96, 0x16, 0x61, 0x3f, 0xb3, 0x3e, 0xa3, 0x0d, 0xdc, 0x49, 0xa5, 0x25, 0x87, 0xc5, 0x97, 0x85, 0x9d, 0xbb, 0xb4, 0xf0, 0x44, 0xfd, 0x6c, 0xe8, 0xd2, 0x8c, 0xec, 0x33, 0x81, 0x46, 0x1e, 0x10, 0x12, 0x33, 0x16, 0x95, 0x00, 0x4f, 0x75, 0xb4, 0xe5, 0x79, 0x02, 0x41, 0x00, 0xd0, 0xeb, 0x65, 0x07, 0x10, 0x3b, 0xd9, 0x03, 0xeb, 0xdc, 0x6f, 0x4b, 0x8f, 0xc3, 0x87, 0xce, 0x76, 0xd6, 0xc5, 0x14, 0x21, 0x4e, 0xe7, 0x4f, 0x1b, 0xe8, 0x05, 0xf8, 0x84, 0x1a, 0xe0, 0xc5, 0xd6, 0xe3, 0x08, 0xb3, 0x54, 0x57, 0x02, 0x1f, 0xd4, 0xd9, 0xfb, 0xff, 0x40, 0xb1, 0x56, 0x1c, 0x60, 0xf7, 0xac, 0x91, 0xf3, 0xd3, 0xc6, 0x7f, 0x84, 0xfd, 0x84, 0x9d, 0xea, 0x26, 0xee, 0xc9, 0x02, 0x41, 0x00, 0xa6, 0xcf, 0x1c, 0x6c, 0x81, 0x03, 0x1c, 0x5c, 0x56, 0x05, 0x6a, 0x26, 0x70, 0xef, 0xd6, 0x13, 0xb7, 0x74, 0x28, 0xf7, 0xca, 0x50, 0xd1, 0x2d, 0x83, 0x21, 0x64, 0xe4, 0xdd, 0x3f, 0x38, 0xb8, 0xd6, 0xd2, 0x41, 0xb3, 0x1c, 0x9a, 0xea, 0x0d, 0xf5, 0xda, 0xdf, 0xcd, 0x17, 0x9f, 0x9a, 0x1e, 0x15, 0xaf, 0x48, 0x1c, 0xbd, 0x9b, 0x63, 0x5b, 0xad, 0xed, 0xd4, 0xa1, 0xae, 0xa9, 0x59, 0x09, 0x02, 0x40, 0x4e, 0x08, 0xce, 0xa8, 0x8f, 0xc0, 0xba, 0xf3, 0x83, 0x02, 0xc8, 0x33, 0x62, 0x14, 0x77, 0xc2, 0x7f, 0x93, 0x02, 0xf3, 0xdc, 0xe9, 0x1a, 0xee, 0xea, 0x8e, 0x84, 0xc4, 0x69, 0x9b, 0x9c, 0x7f, 0x69, 0x1f, 0x4e, 0x1d, 0xa5, 0x90, 0x06, 0x44, 0x1b, 0x7d, 0xfc, 0x69, 0x40, 0x21, 0xbc, 0xf7, 0x46, 0xa4, 0xdc, 0x39, 0x7b, 0xe8, 0x8b, 0x49, 0x10, 0x44, 0x9d, 0x67, 0x5a, 0x91, 0x86, 0x39, 0x02, 0x40, 0x41, 0x2c, 0x4e, 0xfe, 0xd9, 0x90, 0x89, 0x00, 0x5c, 0x94, 0x0a, 0x4a, 0x7e, 0x1b, 0x1a, 0x80, 0x06, 0x01, 0x37, 0xda, 0x50, 0x61, 0x9d, 0x9c, 0xfe, 0x25, 0x7f, 0xd8, 0xd4, 0xc4, 0x9e, 0x81, 0xf2, 0x0c, 0x1e, 0x38, 0x21, 0x1e, 0x90, 0x3f, 0xd4, 0xba, 0x6c, 0x53, 0xcb, 0xf0, 0x77, 0x79, 0x9b, 0xf1, 0xfa, 0x3f, 0x81, 0xdc, 0xf3, 0x21, 0x02, 0x6d, 0xb7, 0x95, 0xc3, 0x2e, 0xce, 0xd5 }; unsigned int default_private_key_len = 609; ================================================ FILE: app/include/ssl/ssl_ssl.h ================================================ /* * Copyright (c) 2007, Cameron Rich * * 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 axTLS project 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. */ /** * @mainpage axTLS API * * @image html axolotl.jpg * * The axTLS library has features such as: * - The TLSv1 SSL client/server protocol * - No requirement to use any openssl libraries. * - A choice between AES block (128/256 bit) and RC4 (128 bit) stream ciphers. * - RSA encryption/decryption with variable sized keys (up to 4096 bits). * - Certificate chaining and peer authentication. * - Session resumption, session renegotiation. * - ASN.1, X.509, PKCS#8, PKCS#12 keys/certificates with DER/PEM encoding. * - Highly configurable compile time options. * - Portable across many platforms (written in ANSI C), and has language * bindings in C, C#, VB.NET, Java, Perl and Lua. * - Partial openssl API compatibility (via a wrapper). * - A very small footprint (around 50-60kB for the library in 'server-only' * mode). * - No dependencies on sockets - can use serial connections for example. * - A very simple API - ~ 20 functions/methods. * * A list of these functions/methods are described below. * * @ref c_api * * @ref bigint_api * * @ref csharp_api * * @ref java_api */ #ifndef HEADER_SSL_H #define HEADER_SSL_H #ifdef __cplusplus extern "C" { #endif //#include typedef long time_t; /* need to predefine before ssl_lib.h gets to it */ #define SSL_SESSION_ID_SIZE 32 #include "ssl/ssl_tls1.h" /* The optional parameters that can be given to the client/server SSL engine */ #define SSL_CLIENT_AUTHENTICATION 0x00010000 #define SSL_SERVER_VERIFY_LATER 0x00020000 #define SSL_NO_DEFAULT_KEY 0x00040000 #define SSL_DISPLAY_STATES 0x00080000 #define SSL_DISPLAY_BYTES 0x00100000 #define SSL_DISPLAY_CERTS 0x00200000 #define SSL_DISPLAY_RSA 0x00400000 #define SSL_CONNECT_IN_PARTS 0x00800000 /* errors that can be generated */ #define SSL_OK 0 #define SSL_NOT_OK -1 #define SSL_ERROR_DEAD -2 #define SSL_CLOSE_NOTIFY -3 #define SSL_ERROR_CONN_LOST -256 #define SSL_ERROR_SOCK_SETUP_FAILURE -258 #define SSL_ERROR_INVALID_HANDSHAKE -260 #define SSL_ERROR_INVALID_PROT_MSG -261 #define SSL_ERROR_INVALID_HMAC -262 #define SSL_ERROR_INVALID_VERSION -263 #define SSL_ERROR_INVALID_SESSION -265 #define SSL_ERROR_NO_CIPHER -266 #define SSL_ERROR_BAD_CERTIFICATE -268 #define SSL_ERROR_INVALID_KEY -269 #define SSL_ERROR_FINISHED_INVALID -271 #define SSL_ERROR_NO_CERT_DEFINED -272 #define SSL_ERROR_NO_CLIENT_RENOG -273 #define SSL_ERROR_NOT_SUPPORTED -274 #define SSL_X509_OFFSET -512 #define SSL_X509_ERROR(A) (SSL_X509_OFFSET+A) /* alert types that are recognized */ #define SSL_ALERT_TYPE_WARNING 1 #define SLL_ALERT_TYPE_FATAL 2 /* these are all the alerts that are recognized */ #define SSL_ALERT_CLOSE_NOTIFY 0 #define SSL_ALERT_UNEXPECTED_MESSAGE 10 #define SSL_ALERT_BAD_RECORD_MAC 20 #define SSL_ALERT_HANDSHAKE_FAILURE 40 #define SSL_ALERT_BAD_CERTIFICATE 42 #define SSL_ALERT_ILLEGAL_PARAMETER 47 #define SSL_ALERT_DECODE_ERROR 50 #define SSL_ALERT_DECRYPT_ERROR 51 #define SSL_ALERT_INVALID_VERSION 70 #define SSL_ALERT_NO_RENEGOTIATION 100 /* The ciphers that are supported */ #define SSL_AES128_SHA 0x2f #define SSL_AES256_SHA 0x35 #define SSL_RC4_128_SHA 0x05 #define SSL_RC4_128_MD5 0x04 /* build mode ids' */ #define SSL_BUILD_SKELETON_MODE 0x01 #define SSL_BUILD_SERVER_ONLY 0x02 #define SSL_BUILD_ENABLE_VERIFICATION 0x03 #define SSL_BUILD_ENABLE_CLIENT 0x04 #define SSL_BUILD_FULL_MODE 0x05 /* offsets to retrieve configuration information */ #define SSL_BUILD_MODE 0 #define SSL_MAX_CERT_CFG_OFFSET 1 #define SSL_MAX_CA_CERT_CFG_OFFSET 2 #define SSL_HAS_PEM 3 /* default session sizes */ #define SSL_DEFAULT_SVR_SESS 1 //modify 5->1 by lhan #define SSL_DEFAULT_CLNT_SESS 1 /* X.509/X.520 distinguished name types */ #define SSL_X509_CERT_COMMON_NAME 0 #define SSL_X509_CERT_ORGANIZATION 1 #define SSL_X509_CERT_ORGANIZATIONAL_NAME 2 #define SSL_X509_CA_CERT_COMMON_NAME 3 #define SSL_X509_CA_CERT_ORGANIZATION 4 #define SSL_X509_CA_CERT_ORGANIZATIONAL_NAME 5 /* SSL object loader types */ #define SSL_OBJ_X509_CERT 1 #define SSL_OBJ_X509_CACERT 2 #define SSL_OBJ_RSA_KEY 3 #define SSL_OBJ_PKCS8 4 #define SSL_OBJ_PKCS12 5 /** * @defgroup c_api Standard C API * @brief The standard interface in C. * @{ */ /** * @brief Establish a new client/server context. * * This function is called before any client/server SSL connections are made. * * Each new connection will use the this context's private key and * certificate chain. If a different certificate chain is required, then a * different context needs to be be used. * * There are two threading models supported - a single thread with one * SSL_CTX can support any number of SSL connections - and multiple threads can * support one SSL_CTX object each (the default). But if a single SSL_CTX * object uses many SSL objects in individual threads, then the * CONFIG_SSL_CTX_MUTEXING option needs to be configured. * * @param options [in] Any particular options. At present the options * supported are: * - SSL_SERVER_VERIFY_LATER (client only): Don't stop a handshake if the server * authentication fails. The certificate can be authenticated later with a * call to ssl_verify_cert(). * - SSL_CLIENT_AUTHENTICATION (server only): Enforce client authentication * i.e. each handshake will include a "certificate request" message from the * server. Only available if verification has been enabled. * - SSL_DISPLAY_BYTES (full mode build only): Display the byte sequences * during the handshake. * - SSL_DISPLAY_STATES (full mode build only): Display the state changes * during the handshake. * - SSL_DISPLAY_CERTS (full mode build only): Display the certificates that * are passed during a handshake. * - SSL_DISPLAY_RSA (full mode build only): Display the RSA key details that * are passed during a handshake. * - SSL_CONNECT_IN_PARTS (client only): To use a non-blocking version of * ssl_client_new(). * @param num_sessions [in] The number of sessions to be used for session * caching. If this value is 0, then there is no session caching. This option * is not used in skeleton mode. * @return A client/server context. */ EXP_FUNC SSL_CTX * STDCALL ssl_ctx_new(uint32_t options, int num_sessions); /** * @brief Remove a client/server context. * * Frees any used resources used by this context. Each connection will be * sent a "Close Notify" alert (if possible). * @param ssl_ctx [in] The client/server context. */ EXP_FUNC void STDCALL ssl_ctx_free(SSL_CTX *ssl_ctx); /** * @brief (server only) Establish a new SSL connection to an SSL client. * * It is up to the application to establish the logical connection (whether it * is a socket, serial connection etc). * @param ssl_ctx [in] The server context. * @param client_fd [in] The client's file descriptor. * @return An SSL object reference. */ //EXP_FUNC SSL * STDCALL ssl_server_new(SSL_CTX *ssl_ctx, int client_fd); EXP_FUNC SSL *STDCALL sslserver_new(SSL_CTX *ssl_ctx, struct tcp_pcb* client_pcb); /** * @brief (client only) Establish a new SSL connection to an SSL server. * * It is up to the application to establish the initial logical connection * (whether it is a socket, serial connection etc). * * This is a normally a blocking call - it will finish when the handshake is * complete (or has failed). To use in non-blocking mode, set * SSL_CONNECT_IN_PARTS in ssl_ctx_new(). * @param ssl_ctx [in] The client context. * @param client_fd [in] The client's file descriptor. * @param session_id [in] A 32 byte session id for session resumption. This * can be null if no session resumption is being used or required. This option * is not used in skeleton mode. * @param sess_id_size The size of the session id (max 32) * @return An SSL object reference. Use ssl_handshake_status() to check * if a handshake succeeded. */ //EXP_FUNC SSL * STDCALL ssl_client_new(SSL_CTX *ssl_ctx, int client_fd, const uint8_t *session_id, uint8_t sess_id_size); EXP_FUNC SSL *STDCALL SSLClient_new(SSL_CTX *ssl_ctx, struct tcp_pcb *SslClient_pcb, const uint8_t *session_id, uint8_t sess_id_size); /** * @brief Free any used resources on this connection. * A "Close Notify" message is sent on this connection (if possible). It is up * to the application to close the socket or file descriptor. * @param ssl [in] The ssl object reference. */ EXP_FUNC void STDCALL ssl_free(SSL *ssl); /** * @brief Read the SSL data stream. * If the socket is non-blocking and data is blocked then SSO_OK will be * returned. * @param ssl [in] An SSL object reference. * @param in_data [out] If the read was successful, a pointer to the read * buffer will be here. Do NOT ever free this memory as this buffer is used in * sucessive calls. If the call was unsuccessful, this value will be null. * @return The number of decrypted bytes: * - if > 0, then the handshaking is complete and we are returning the number * of decrypted bytes. * - SSL_OK if the handshaking stage is successful (but not yet complete). * - < 0 if an error. * @see ssl.h for the error code list. * @note Use in_data before doing any successive ssl calls. */ EXP_FUNC int STDCALL ssl_read(SSL *ssl, uint8_t **in_data); /** * @brief Write to the SSL data stream. * if the socket is non-blocking and data is blocked then a check is made * to ensure that all data is sent (i.e. blocked mode is forced). * @param ssl [in] An SSL obect reference. * @param out_data [in] The data to be written * @param out_len [in] The number of bytes to be written. * @return The number of bytes sent, or if < 0 if an error. * @see ssl.h for the error code list. */ EXP_FUNC int STDCALL ssl_write(SSL *ssl, const uint8_t *out_data, int out_len); /** * @brief Find an ssl object based on a file descriptor. * * Goes through the list of SSL objects maintained in a client/server context * to look for a file descriptor match. * @param ssl_ctx [in] The client/server context. * @param client_fd [in] The file descriptor. * @return A reference to the SSL object. Returns null if the object could not * be found. */ EXP_FUNC SSL * STDCALL ssl_find(SSL_CTX *ssl_ctx, int client_fd); /** * @brief Get the session id for a handshake. * * This will be a 32 byte sequence and is available after the first * handshaking messages are sent. * @param ssl [in] An SSL object reference. * @return The session id as a 32 byte sequence. * @note A SSLv23 handshake may have only 16 valid bytes. */ EXP_FUNC const uint8_t * STDCALL ssl_get_session_id(const SSL *ssl); /** * @brief Get the session id size for a handshake. * * This will normally be 32 but could be 0 (no session id) or something else. * @param ssl [in] An SSL object reference. * @return The size of the session id. */ EXP_FUNC uint8_t STDCALL ssl_get_session_id_size(const SSL *ssl); /** * @brief Return the cipher id (in the SSL form). * @param ssl [in] An SSL object reference. * @return The cipher id. This will be one of the following: * - SSL_AES128_SHA (0x2f) * - SSL_AES256_SHA (0x35) * - SSL_RC4_128_SHA (0x05) * - SSL_RC4_128_MD5 (0x04) */ EXP_FUNC uint8_t STDCALL ssl_get_cipher_id(const SSL *ssl); /** * @brief Return the status of the handshake. * @param ssl [in] An SSL object reference. * @return SSL_OK if the handshake is complete and ok. * @see ssl.h for the error code list. */ EXP_FUNC int STDCALL ssl_handshake_status(const SSL *ssl); /** * @brief Retrieve various parameters about the axTLS engine. * @param offset [in] The configuration offset. It will be one of the following: * - SSL_BUILD_MODE The build mode. This will be one of the following: * - SSL_BUILD_SERVER_ONLY (basic server mode) * - SSL_BUILD_ENABLE_VERIFICATION (server can do client authentication) * - SSL_BUILD_ENABLE_CLIENT (client/server capabilties) * - SSL_BUILD_FULL_MODE (client/server with diagnostics) * - SSL_BUILD_SKELETON_MODE (skeleton mode) * - SSL_MAX_CERT_CFG_OFFSET The maximum number of certificates allowed. * - SSL_MAX_CA_CERT_CFG_OFFSET The maximum number of CA certificates allowed. * - SSL_HAS_PEM 1 if supported * @return The value of the requested parameter. */ EXP_FUNC int STDCALL ssl_get_config(int offset); /** * @brief Display why the handshake failed. * * This call is only useful in a 'full mode' build. The output is to stdout. * @param error_code [in] An error code. * @see ssl.h for the error code list. */ //EXP_FUNC void STDCALL ssl_display_error(int error_code); /** * @brief Authenticate a received certificate. * * This call is usually made by a client after a handshake is complete and the * context is in SSL_SERVER_VERIFY_LATER mode. * @param ssl [in] An SSL object reference. * @return SSL_OK if the certificate is verified. */ EXP_FUNC int STDCALL ssl_verify_cert(const SSL *ssl); /** * @brief Retrieve an X.509 distinguished name component. * * When a handshake is complete and a certificate has been exchanged, then the * details of the remote certificate can be retrieved. * * This will usually be used by a client to check that the server's common * name matches the URL. * * @param ssl [in] An SSL object reference. * @param component [in] one of: * - SSL_X509_CERT_COMMON_NAME * - SSL_X509_CERT_ORGANIZATION * - SSL_X509_CERT_ORGANIZATIONAL_NAME * - SSL_X509_CA_CERT_COMMON_NAME * - SSL_X509_CA_CERT_ORGANIZATION * - SSL_X509_CA_CERT_ORGANIZATIONAL_NAME * @return The appropriate string (or null if not defined) * @note Verification build mode must be enabled. */ EXP_FUNC const char * STDCALL ssl_get_cert_dn(const SSL *ssl, int component); /** * @brief Retrieve a Subject Alternative DNSName * * When a handshake is complete and a certificate has been exchanged, then the * details of the remote certificate can be retrieved. * * This will usually be used by a client to check that the server's DNS * name matches the URL. * * @param ssl [in] An SSL object reference. * @param dnsindex [in] The index of the DNS name to retrieve. * @return The appropriate string (or null if not defined) * @note Verification build mode must be enabled. */ EXP_FUNC const char * STDCALL ssl_get_cert_subject_alt_dnsname(const SSL *ssl, int dnsindex); /** * @brief Force the client to perform its handshake again. * * For a client this involves sending another "client hello" message. * For the server is means sending a "hello request" message. * * This is a blocking call on the client (until the handshake completes). * * @param ssl [in] An SSL object reference. * @return SSL_OK if renegotiation instantiation was ok */ EXP_FUNC int STDCALL ssl_renegotiate(SSL *ssl); /** * @brief Process a file that is in binary DER or ASCII PEM format. * * These are temporary objects that are used to load private keys, * certificates etc into memory. * @param ssl_ctx [in] The client/server context. * @param obj_type [in] The format of the file. Can be one of: * - SSL_OBJ_X509_CERT (no password required) * - SSL_OBJ_X509_CACERT (no password required) * - SSL_OBJ_RSA_KEY (AES128/AES256 PEM encryption supported) * - SSL_OBJ_PKCS8 (RC4-128 encrypted data supported) * - SSL_OBJ_PKCS12 (RC4-128 encrypted data supported) * * PEM files are automatically detected (if supported). The object type is * also detected, and so is not relevant for these types of files. * @param filename [in] The location of a file in DER/PEM format. * @param password [in] The password used. Can be null if not required. * @return SSL_OK if all ok * @note Not available in skeleton build mode. */ EXP_FUNC int STDCALL ssl_obj_load(SSL_CTX *ssl_ctx, int obj_type, const char *filename, const char *password); /** * @brief Process binary data. * * These are temporary objects that are used to load private keys, * certificates etc into memory. * @param ssl_ctx [in] The client/server context. * @param obj_type [in] The format of the memory data. * @param data [in] The binary data to be loaded. * @param len [in] The amount of data to be loaded. * @param password [in] The password used. Can be null if not required. * @return SSL_OK if all ok * @see ssl_obj_load for more details on obj_type. */ EXP_FUNC int STDCALL ssl_obj_memory_load(SSL_CTX *ssl_ctx, int obj_type, const uint8_t *data, int len, const char *password); #ifdef CONFIG_SSL_GENERATE_X509_CERT /** * @brief Create an X.509 certificate. * * This certificate is a self-signed v1 cert with a fixed start/stop validity * times. It is signed with an internal private key in ssl_ctx. * * @param ssl_ctx [in] The client/server context. * @param options [in] Not used yet. * @param dn [in] An array of distinguished name strings. The array is defined * by: * - SSL_X509_CERT_COMMON_NAME (0) * - If SSL_X509_CERT_COMMON_NAME is empty or not defined, then the * hostname will be used. * - SSL_X509_CERT_ORGANIZATION (1) * - If SSL_X509_CERT_ORGANIZATION is empty or not defined, then $USERNAME * will be used. * - SSL_X509_CERT_ORGANIZATIONAL_NAME (2) * - SSL_X509_CERT_ORGANIZATIONAL_NAME is optional. * @param cert_data [out] The certificate as a sequence of bytes. * @return < 0 if an error, or the size of the certificate in bytes. * @note cert_data must be freed when there is no more need for it. */ EXP_FUNC int STDCALL ssl_x509_create(SSL_CTX *ssl_ctx, uint32_t options, const char * dn[], uint8_t **cert_data); #endif /** * @brief Return the axTLS library version as a string. */ EXP_FUNC const char * STDCALL ssl_version(void); /** @} */ #ifdef __cplusplus } #endif #endif ================================================ FILE: app/include/ssl/ssl_tls1.h ================================================ /* * Copyright (c) 2007, Cameron Rich * * 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 axTLS project 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. */ /** * @file tls1.h * * @brief The definitions for the TLS library. */ #ifndef HEADER_SSL_LIB_H #define HEADER_SSL_LIB_H #ifdef __cplusplus extern "C" { #endif #include "c_types.h" #include "ssl/ssl_version.h" #include "ssl/ssl_config.h" //#include "../crypto/os_int.h" #include "ssl/ssl_crypto.h" #include "ssl/ssl_crypto_misc.h" #include "lwip/tcp.h" #define SSL_PROTOCOL_MIN_VERSION 0x31 /* TLS v1.0 */ #define SSL_PROTOCOL_MINOR_VERSION 0x02 /* TLS v1.1 */ #define SSL_PROTOCOL_VERSION_MAX 0x32 /* TLS v1.1 */ #define SSL_PROTOCOL_VERSION1_1 0x32 /* TLS v1.1 */ #define SSL_RANDOM_SIZE 32 #define SSL_SECRET_SIZE 48 #define SSL_FINISHED_HASH_SIZE 12 #define SSL_RECORD_SIZE 5 #define SSL_SERVER_READ 0 #define SSL_SERVER_WRITE 1 #define SSL_CLIENT_READ 2 #define SSL_CLIENT_WRITE 3 #define SSL_HS_HDR_SIZE 4 /* the flags we use while establishing a connection */ #define SSL_NEED_RECORD 0x0001 #define SSL_TX_ENCRYPTED 0x0002 #define SSL_RX_ENCRYPTED 0x0004 #define SSL_SESSION_RESUME 0x0008 #define SSL_IS_CLIENT 0x0010 #define SSL_HAS_CERT_REQ 0x0020 #define SSL_SENT_CLOSE_NOTIFY 0x0040 /* some macros to muck around with flag bits */ #define SET_SSL_FLAG(A) (ssl->flag |= A) #define CLR_SSL_FLAG(A) (ssl->flag &= ~A) #define IS_SET_SSL_FLAG(A) (ssl->flag & A) #define MAX_KEY_BYTE_SIZE 512 /* for a 4096 bit key */ #define RT_MAX_PLAIN_LENGTH 4096 #define RT_EXTRA 1024 #define BM_RECORD_OFFSET 5 #ifdef CONFIG_SSL_SKELETON_MODE #define NUM_PROTOCOLS 1 #else #define NUM_PROTOCOLS 4 #endif #define PARANOIA_CHECK(A, B) if (A < B) { \ ret = SSL_ERROR_INVALID_HANDSHAKE; goto error; } /* protocol types */ enum { PT_CHANGE_CIPHER_SPEC = 20, PT_ALERT_PROTOCOL, PT_HANDSHAKE_PROTOCOL, PT_APP_PROTOCOL_DATA }; /* handshaking types */ enum { HS_HELLO_REQUEST, HS_CLIENT_HELLO, HS_SERVER_HELLO, HS_CERTIFICATE = 11, HS_SERVER_KEY_XCHG, HS_CERT_REQ, HS_SERVER_HELLO_DONE, HS_CERT_VERIFY, HS_CLIENT_KEY_XCHG, HS_FINISHED = 20 }; typedef struct { uint8_t cipher; uint8_t key_size; uint8_t iv_size; uint8_t key_block_size; uint8_t padding_size; uint8_t digest_size; hmac_func hmac; crypt_func encrypt; crypt_func decrypt; } cipher_info_t; struct _SSLObjLoader { uint8_t *buf; int len; }; typedef struct _SSLObjLoader SSLObjLoader; typedef struct { time_t conn_time; uint8_t session_id[SSL_SESSION_ID_SIZE]; uint8_t master_secret[SSL_SECRET_SIZE]; } SSL_SESSION; typedef struct { uint8_t *buf; int size; } SSL_CERT; typedef struct { MD5_CTX md5_ctx; SHA1_CTX sha1_ctx; uint8_t final_finish_mac[SSL_FINISHED_HASH_SIZE]; uint8_t *key_block; uint8_t master_secret[SSL_SECRET_SIZE]; uint8_t client_random[SSL_RANDOM_SIZE]; /* client's random sequence */ uint8_t server_random[SSL_RANDOM_SIZE]; /* server's random sequence */ uint16_t bm_proc_index; } DISPOSABLE_CTX; struct _SSL { uint32_t flag; uint16_t need_bytes; uint16_t got_bytes; uint8_t record_type; uint8_t cipher; uint8_t sess_id_size; uint8_t version; uint8_t client_version; sint16_t next_state; sint16_t hs_status; DISPOSABLE_CTX *dc; /* temporary data which we'll get rid of soon */ //int client_fd; struct tcp_pcb *SslClient_pcb;//add by ives 12.12.2013 struct pbuf *ssl_pbuf;//add by ives 12.12.2013 const cipher_info_t *cipher_info; void *encrypt_ctx; void *decrypt_ctx; uint8_t bm_all_data[RT_MAX_PLAIN_LENGTH+RT_EXTRA]; uint8_t *bm_data; uint16_t bm_index; uint16_t bm_read_index; struct _SSL *next; /* doubly linked list */ struct _SSL *prev; struct _SSL_CTX *ssl_ctx; /* back reference to a clnt/svr ctx */ #ifndef CONFIG_SSL_SKELETON_MODE uint16_t session_index; SSL_SESSION *session; #endif #ifdef CONFIG_SSL_CERT_VERIFICATION X509_CTX *x509_ctx; #endif uint8_t session_id[SSL_SESSION_ID_SIZE]; uint8_t client_mac[SHA1_SIZE]; /* for HMAC verification */ uint8_t server_mac[SHA1_SIZE]; /* for HMAC verification */ uint8_t read_sequence[8]; /* 64 bit sequence number */ uint8_t write_sequence[8]; /* 64 bit sequence number */ uint8_t hmac_header[SSL_RECORD_SIZE]; /* rx hmac */ }; typedef struct _SSL SSL; struct _SSL_CTX { uint32_t options; uint8_t chain_length; RSA_CTX *rsa_ctx; #ifdef CONFIG_SSL_CERT_VERIFICATION CA_CERT_CTX *ca_cert_ctx; #endif SSL *head; SSL *tail; SSL_CERT certs[CONFIG_SSL_MAX_CERTS]; #ifndef CONFIG_SSL_SKELETON_MODE uint16_t num_sessions; SSL_SESSION **ssl_sessions; #endif #ifdef CONFIG_SSL_CTX_MUTEXING SSL_CTX_MUTEX_TYPE mutex; #endif #ifdef CONFIG_OPENSSL_COMPATIBLE void *bonus_attr; #endif }; typedef struct _SSL_CTX SSL_CTX; /* backwards compatibility */ typedef struct _SSL_CTX SSLCTX; extern const uint8_t ssl_prot_prefs[NUM_PROTOCOLS]; SSL *ssl_new(SSL_CTX *ssl_ctx, int client_fd); SSL *ssl_new_context(SSL_CTX *ssl_ctx, struct tcp_pcb *SslClient_pcb); void disposable_new(SSL *ssl); void disposable_free(SSL *ssl); int send_packet(SSL *ssl, uint8_t protocol, const uint8_t *in, int length); int do_svr_handshake(SSL *ssl, int handshake_type, uint8_t *buf, int hs_len); int do_clnt_handshake(SSL *ssl, int handshake_type, uint8_t *buf, int hs_len); int process_finished(SSL *ssl, uint8_t *buf, int hs_len); int process_sslv23_client_hello(SSL *ssl); int send_alert(SSL *ssl, int error_code); int send_finished(SSL *ssl); int send_certificate(SSL *ssl); int basic_read(SSL *ssl, uint8_t **in_data); int send_change_cipher_spec(SSL *ssl); void finished_digest(SSL *ssl, const char *label, uint8_t *digest); void generate_master_secret(SSL *ssl, const uint8_t *premaster_secret); void add_packet(SSL *ssl, const uint8_t *pkt, int len); int add_cert(SSL_CTX *ssl_ctx, const uint8_t *buf, int len); int add_private_key(SSL_CTX *ssl_ctx, SSLObjLoader *ssl_obj); void ssl_obj_free(SSLObjLoader *ssl_obj); int pkcs8_decode(SSL_CTX *ssl_ctx, SSLObjLoader *ssl_obj, const char *password); int pkcs12_decode(SSL_CTX *ssl_ctx, SSLObjLoader *ssl_obj, const char *password); int load_key_certs(SSL_CTX *ssl_ctx); #ifdef CONFIG_SSL_CERT_VERIFICATION int add_cert_auth(SSL_CTX *ssl_ctx, const uint8_t *buf, int len); void remove_ca_certs(CA_CERT_CTX *ca_cert_ctx); #endif #ifdef CONFIG_SSL_ENABLE_CLIENT int do_client_connect(SSL *ssl); #endif #ifdef CONFIG_SSL_FULL_MODE //void DISPLAY_STATE(SSL *ssl, int is_send, uint8_t state, int not_ok); //void DISPLAY_BYTES(SSL *ssl, const char *format, // const uint8_t *data, int size, ...); //void DISPLAY_CERT(SSL *ssl, const X509_CTX *x509_ctx); //void DISPLAY_RSA(SSL *ssl, const RSA_CTX *rsa_ctx); //void DISPLAY_ALERT(SSL *ssl, int alert); #else #define DISPLAY_STATE(A,B,C,D) #define DISPLAY_CERT(A,B) #define DISPLAY_RSA(A,B) #define DISPLAY_ALERT(A, B) #ifdef WIN32 void DISPLAY_BYTES(SSL *ssl, const char *format,/* win32 has no variadic macros */ const uint8_t *data, int size, ...); #else #define DISPLAY_BYTES(A,B,C,D,...) #endif #endif #ifdef CONFIG_SSL_CERT_VERIFICATION int process_certificate(SSL *ssl, X509_CTX **x509_ctx); #endif SSL_SESSION *ssl_session_update(int max_sessions, SSL_SESSION *ssl_sessions[], SSL *ssl, const uint8_t *session_id); void kill_ssl_session(SSL_SESSION **ssl_sessions, SSL *ssl); #ifdef __cplusplus } #endif #endif ================================================ FILE: app/include/ssl/ssl_version.h ================================================ #define AXTLS_VERSION "1.4.9" ================================================ FILE: app/include/user_config.h ================================================ #ifndef __USER_CONFIG_H__ #define __USER_CONFIG_H__ #define INTERFACE_DOMAIN "smart.relay.com" #define FLASH_512K // #define FLASH_1M // #define FLASH_2M // #define FLASH_4M //#define FLASH_AUTOSIZE #define DEVELOP_VERSION //#define FULL_VERSION_FOR_USER #define USE_OPTIMIZE_PRINTF #ifdef DEVELOP_VERSION #define NODE_DEBUG #endif /* DEVELOP_VERSION */ #define DEBUG_UART 0 //debug on uart 0 or 1 //#define NODE_ERROR #ifdef NODE_DEBUG #define NODE_DBG(...) os_printf("\r\n");os_printf( __VA_ARGS__ ) #else #define NODE_DBG #endif /* NODE_DEBUG */ #ifdef NODE_ERROR #define NODE_ERR c_printf #else #define NODE_ERR #endif /* NODE_ERROR */ #define ICACHE_STORE_TYPEDEF_ATTR __attribute__((aligned(4),packed)) #define ICACHE_STORE_ATTR __attribute__((aligned(4))) #define ICACHE_RAM_ATTR __attribute__((section(".iram0.text"))) // #define ICACHE_RODATA_ATTR __attribute__((section(".rodata2.text"))) #define GPIO_INTERRUPT_ENABLE //#define BUILD_WOFS 1 #define BUILD_SPIFFS 1 #define PRINTF_LONG_SUPPORT #endif /* __USER_CONFIG_H__ */ ================================================ FILE: app/include/xtensa/cacheasm.h ================================================ /* * 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-2002, 2006 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_CACHEASM_H #define XTENSA_CACHEASM_H #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) * loopokay 1 (default) 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=1, maxofs=240 // 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. .ifne (\loopokay & XCHAL_HAVE_LOOPS) 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 .Lstart_cachex\@: .set .Li, 0 ; .rept .Lperloop \cainst \ab, .Li*\linesize .set .Li, .Li+1 ; .endr 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 * * 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 // 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: floopnez \asize, cacheh\@ \cainst \addr, 0 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 /* * NOTE: in some early version of a test chip silicon (SiChip1), * 'ihi' didn't work, so software had to replace it with * the much more draconian 'iii' * (which would just invalidate more than it should, * which should be okay other than the performance hit * because cache locking did not exist in that version, * unless user somehow relies on something being cached). * * #if ... targeting this ancient, now non-existent, test chip silicon ... * iii \ar, \offset * #endif */ 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 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 #if XCHAL_DCACHE_SIZE > 0 // This previous sequence errs on the conservative side (too much so); a DSYNC should be sufficient: //memw // synchronize data cache changes relative to subsequent memory accesses //isync // be conservative and ISYNC as well (just to be sure) dsync #endif .endm /* * Opt into cache coherence. * * Parameters are: * ar,at two scratch address registers (both clobbered) */ .macro cache_coherence_on ar at #if XCHAL_HAVE_EXTERN_REGS && XCHAL_DCACHE_IS_COHERENT movi \ar, 1 movi \at, XER_CCON wer \ar, \at extw # endif .endm /* * Opt out of cache coherence. * NOTE: this is generally preceded by emptying the cache; * see xthal_cache_coherence_optout() in hal/coherence.c for details. * * Parameters are: * ar,at two scratch address registers (both clobbered) */ .macro cache_coherence_off ar at #if XCHAL_HAVE_EXTERN_REGS && XCHAL_DCACHE_IS_COHERENT extw movi \at, 0 movi \ar, XER_CCON wer \at, \ar extw #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 #if 0 /* * This is a work-around for a bug in SiChip1. * To enable the work-around, uncomment this and replace 'dii' * with 'dii_s1' everywhere, eg. in the dcache_invalidate_all * macro below. */ .macro dii_s1 ar, offset dii \ar, \offset or \ar, \ar, \ar or \ar, \ar, \ar or \ar, \ar, \ar or \ar, \ar, \ar .endm #endif /* * 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 #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 #if XCHAL_DCACHE_SIZE > 0 && XCHAL_DCACHE_IS_WRITEBACK // Data cache region writeback: cache_hit_region dhwb, XCHAL_DCACHE_LINEWIDTH, \astart, \asize, \ac dcache_sync \ac // 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, 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 dcache_sync \aa // 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 #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 #if XCHAL_DCACHE_SIZE > 0 // Data cache region writeback and invalidate: cache_hit_region dhwbi, XCHAL_DCACHE_LINEWIDTH, \astart, \asize, \ac dcache_sync \ac // 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, 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 dcache_sync \aa #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 dcache_sync \aa // End of data cache unlock #endif .endm #endif /*XTENSA_CACHEASM_H*/ ================================================ FILE: app/include/xtensa/cacheattrasm.h ================================================ /* * 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*/ ================================================ FILE: app/include/xtensa/config/core-isa.h ================================================ /* * 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=7011; Build=0x2b6f6; Copyright (c) 1999-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_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 0 /* windowed registers option */ #define XCHAL_NUM_AREGS 16 /* num of physical addr regs */ #define XCHAL_NUM_AREGS_LOG2 4 /* 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 0 /* zero-overhead loops */ #define XCHAL_HAVE_NSA 1 /* NSA/NSAU instructions */ #define XCHAL_HAVE_MINMAX 0 /* MIN/MAX instructions */ #define XCHAL_HAVE_SEXT 0 /* SEXT instruction */ #define XCHAL_HAVE_CLAMPS 0 /* CLAMPS instruction */ #define XCHAL_HAVE_MUL16 1 /* MUL16S/MUL16U instructions */ #define XCHAL_HAVE_MUL32 1 /* MULL instruction */ #define XCHAL_HAVE_MUL32_HIGH 0 /* MULUH/MULSH instructions */ #define XCHAL_HAVE_DIV32 0 /* QUOS/QUOU/REMS/REMU instructions */ #define XCHAL_HAVE_L32R 1 /* L32R instruction */ #define XCHAL_HAVE_ABSOLUTE_LITERALS 1 /* 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 0 /* (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 0 /* L32AI/S32RI instructions */ #define XCHAL_HAVE_S32C1I 0 /* 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 0 /* 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_MP_INTERRUPTS 0 /* interrupt distributor port */ #define XCHAL_HAVE_MP_RUNSTALL 0 /* core RunStall control port */ #define XCHAL_HAVE_THREADPTR 0 /* THREADPTR register */ #define XCHAL_HAVE_BOOLEANS 0 /* boolean registers */ #define XCHAL_HAVE_CP 0 /* CPENABLE reg (coprocessor) */ #define XCHAL_CP_MAXCFG 0 /* max allowed cp id plus one */ #define XCHAL_HAVE_MAC16 0 /* MAC16 package */ #define XCHAL_HAVE_VECTORFPU2005 0 /* vector floating-point pkg */ #define XCHAL_HAVE_FP 0 /* floating point pkg */ #define XCHAL_HAVE_DFP 0 /* double precision FP pkg */ #define XCHAL_HAVE_DFP_accel 0 /* double precision FP acceleration pkg */ #define XCHAL_HAVE_VECTRA1 0 /* Vectra I pkg */ #define XCHAL_HAVE_VECTRALX 0 /* Vectra LX pkg */ #define XCHAL_HAVE_HIFIPRO 0 /* HiFiPro Audio Engine pkg */ #define XCHAL_HAVE_HIFI2 0 /* HiFi2 Audio Engine pkg */ #define XCHAL_HAVE_CONNXD2 0 /* ConnX D2 pkg */ /*---------------------------------------------------------------------- MISC ----------------------------------------------------------------------*/ #define XCHAL_NUM_WRITEBUFFER_ENTRIES 1 /* size of write buffer */ #define XCHAL_INST_FETCH_WIDTH 4 /* instr-fetch width in bytes */ #define XCHAL_DATA_WIDTH 4 /* data width in bytes */ /* In T1050, applies to selected core load and store instructions (see ISA): */ #define XCHAL_UNALIGNED_LOAD_EXCEPTION 1 /* unaligned loads cause exc. */ #define XCHAL_UNALIGNED_STORE_EXCEPTION 1 /* unaligned stores cause exc.*/ #define XCHAL_UNALIGNED_LOAD_HW 0 /* unaligned loads work in hw */ #define XCHAL_UNALIGNED_STORE_HW 0 /* unaligned stores work in hw*/ #define XCHAL_SW_VERSION 800001 /* sw version of this header */ #define XCHAL_CORE_ID "lx106" /* alphanum core name (CoreID) set in the Xtensa Processor Generator */ #define XCHAL_BUILD_UNIQUE_ID 0x0002B6F6 /* 22-bit sw build ID */ /* * These definitions describe the hardware targeted by this software. */ #define XCHAL_HW_CONFIGID0 0xC28CDAFA /* ConfigID hi 32 bits*/ #define XCHAL_HW_CONFIGID1 0x1082B6F6 /* ConfigID lo 32 bits*/ #define XCHAL_HW_VERSION_NAME "LX3.0.1" /* full version name */ #define XCHAL_HW_VERSION_MAJOR 2300 /* major ver# of targeted hw */ #define XCHAL_HW_VERSION_MINOR 1 /* minor ver# of targeted hw */ #define XCHAL_HW_VERSION 230001 /* major*100+minor */ #define XCHAL_HW_REL_LX3 1 #define XCHAL_HW_REL_LX3_0 1 #define XCHAL_HW_REL_LX3_0_1 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 2300 /* major v of earliest tgt hw */ #define XCHAL_HW_MIN_VERSION_MINOR 1 /* minor v of earliest tgt hw */ #define XCHAL_HW_MIN_VERSION 230001 /* earliest targeted hw */ #define XCHAL_HW_MAX_VERSION_MAJOR 2300 /* major v of latest tgt hw */ #define XCHAL_HW_MAX_VERSION_MINOR 1 /* minor v of latest tgt hw */ #define XCHAL_HW_MAX_VERSION 230001 /* 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 */ /**************************************************************************** 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 */ /* 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 /* 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 0x40200000 #define XCHAL_INSTROM0_PADDR 0x40200000 #define XCHAL_INSTROM0_SIZE 1048576 #define XCHAL_INSTROM0_ECC_PARITY 0 /* Instruction RAM 0: */ #define XCHAL_INSTRAM0_VADDR 0x40000000 #define XCHAL_INSTRAM0_PADDR 0x40000000 #define XCHAL_INSTRAM0_SIZE 1048576 #define XCHAL_INSTRAM0_ECC_PARITY 0 /* Instruction RAM 1: */ #define XCHAL_INSTRAM1_VADDR 0x40100000 #define XCHAL_INSTRAM1_PADDR 0x40100000 #define XCHAL_INSTRAM1_SIZE 1048576 #define XCHAL_INSTRAM1_ECC_PARITY 0 /* Data ROM 0: */ #define XCHAL_DATAROM0_VADDR 0x3FF40000 #define XCHAL_DATAROM0_PADDR 0x3FF40000 #define XCHAL_DATAROM0_SIZE 262144 #define XCHAL_DATAROM0_ECC_PARITY 0 /* Data RAM 0: */ #define XCHAL_DATARAM0_VADDR 0x3FFC0000 #define XCHAL_DATARAM0_PADDR 0x3FFC0000 #define XCHAL_DATARAM0_SIZE 262144 #define XCHAL_DATARAM0_ECC_PARITY 0 /* Data RAM 1: */ #define XCHAL_DATARAM1_VADDR 0x3FF80000 #define XCHAL_DATARAM1_PADDR 0x3FF80000 #define XCHAL_DATARAM1_SIZE 262144 #define XCHAL_DATARAM1_ECC_PARITY 0 /* XLMI Port 0: */ #define XCHAL_XLMI0_VADDR 0x3FF00000 #define XCHAL_XLMI0_PADDR 0x3FF00000 #define XCHAL_XLMI0_SIZE 262144 #define XCHAL_XLMI0_ECC_PARITY 0 /*---------------------------------------------------------------------- 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 1 /* number of CCOMPAREn regs */ #define XCHAL_NUM_INTERRUPTS 15 /* number of interrupts */ #define XCHAL_NUM_INTERRUPTS_LOG2 4 /* ceil(log2(NUM_INTERRUPTS)) */ #define XCHAL_NUM_EXTINTERRUPTS 13 /* num of external interrupts */ #define XCHAL_NUM_INTLEVELS 2 /* number of interrupt levels (not including level zero) */ #define XCHAL_EXCM_LEVEL 1 /* 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 0x00003FFF #define XCHAL_INTLEVEL2_MASK 0x00000000 #define XCHAL_INTLEVEL3_MASK 0x00004000 #define XCHAL_INTLEVEL4_MASK 0x00000000 #define XCHAL_INTLEVEL5_MASK 0x00000000 #define XCHAL_INTLEVEL6_MASK 0x00000000 #define XCHAL_INTLEVEL7_MASK 0x00000000 /* Masks of interrupts at each range 1..n of interrupt levels: */ #define XCHAL_INTLEVEL1_ANDBELOW_MASK 0x00003FFF #define XCHAL_INTLEVEL2_ANDBELOW_MASK 0x00003FFF #define XCHAL_INTLEVEL3_ANDBELOW_MASK 0x00007FFF #define XCHAL_INTLEVEL4_ANDBELOW_MASK 0x00007FFF #define XCHAL_INTLEVEL5_ANDBELOW_MASK 0x00007FFF #define XCHAL_INTLEVEL6_ANDBELOW_MASK 0x00007FFF #define XCHAL_INTLEVEL7_ANDBELOW_MASK 0x00007FFF /* 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 1 #define XCHAL_INT12_LEVEL 1 #define XCHAL_INT13_LEVEL 1 #define XCHAL_INT14_LEVEL 3 #define XCHAL_DEBUGLEVEL 2 /* debug interrupt level */ #define XCHAL_HAVE_DEBUG_EXTERN_INT 1 /* OCD external db interrupt */ #define XCHAL_NMILEVEL 3 /* 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_EDGE #define XCHAL_INT9_TYPE XTHAL_INTTYPE_EXTERN_EDGE #define XCHAL_INT10_TYPE XTHAL_INTTYPE_EXTERN_EDGE #define XCHAL_INT11_TYPE XTHAL_INTTYPE_EXTERN_EDGE #define XCHAL_INT12_TYPE XTHAL_INTTYPE_EXTERN_EDGE #define XCHAL_INT13_TYPE XTHAL_INTTYPE_EXTERN_EDGE #define XCHAL_INT14_TYPE XTHAL_INTTYPE_NMI /* Masks of interrupts for each type of interrupt: */ #define XCHAL_INTTYPE_MASK_UNCONFIGURED 0xFFFF8000 #define XCHAL_INTTYPE_MASK_SOFTWARE 0x00000080 #define XCHAL_INTTYPE_MASK_EXTERN_EDGE 0x00003F00 #define XCHAL_INTTYPE_MASK_EXTERN_LEVEL 0x0000003F #define XCHAL_INTTYPE_MASK_TIMER 0x00000040 #define XCHAL_INTTYPE_MASK_NMI 0x00004000 #define XCHAL_INTTYPE_MASK_WRITE_ERROR 0x00000000 /* Interrupt numbers assigned to specific interrupt sources: */ #define XCHAL_TIMER0_INTERRUPT 6 /* CCOMPARE0 */ #define XCHAL_TIMER1_INTERRUPT XTHAL_TIMER_UNCONFIGURED #define XCHAL_TIMER2_INTERRUPT XTHAL_TIMER_UNCONFIGURED #define XCHAL_TIMER3_INTERRUPT XTHAL_TIMER_UNCONFIGURED #define XCHAL_NMI_INTERRUPT 14 /* non-maskable interrupt */ /* Interrupt numbers for levels at which only one interrupt is configured: */ #define XCHAL_INTLEVEL3_NUM 14 /* (There are many interrupts each at level(s) 1.) */ /* * External interrupt vectors/levels. * 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 interrupt 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 11 /* (intlevel 1) */ #define XCHAL_EXTINT10_NUM 12 /* (intlevel 1) */ #define XCHAL_EXTINT11_NUM 13 /* (intlevel 1) */ #define XCHAL_EXTINT12_NUM 14 /* (intlevel 3) */ /*---------------------------------------------------------------------- EXCEPTIONS and VECTORS ----------------------------------------------------------------------*/ #define XCHAL_XEA_VERSION 2 /* Xtensa Exception Architecture number: 1 == XEA1 (old) 2 == XEA2 (new) 0 == XEAX (extern) */ #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_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 0x40000080 #define XCHAL_RESET_VECTOR1_PADDR 0x40000080 #define XCHAL_RESET_VECTOR_VADDR 0x50000000 #define XCHAL_RESET_VECTOR_PADDR 0x50000000 #define XCHAL_USER_VECOFS 0x00000050 #define XCHAL_USER_VECTOR_VADDR 0x40000050 #define XCHAL_USER_VECTOR_PADDR 0x40000050 #define XCHAL_KERNEL_VECOFS 0x00000030 #define XCHAL_KERNEL_VECTOR_VADDR 0x40000030 #define XCHAL_KERNEL_VECTOR_PADDR 0x40000030 #define XCHAL_DOUBLEEXC_VECOFS 0x00000070 #define XCHAL_DOUBLEEXC_VECTOR_VADDR 0x40000070 #define XCHAL_DOUBLEEXC_VECTOR_PADDR 0x40000070 #define XCHAL_INTLEVEL2_VECOFS 0x00000010 #define XCHAL_INTLEVEL2_VECTOR_VADDR 0x40000010 #define XCHAL_INTLEVEL2_VECTOR_PADDR 0x40000010 #define XCHAL_DEBUG_VECOFS XCHAL_INTLEVEL2_VECOFS #define XCHAL_DEBUG_VECTOR_VADDR XCHAL_INTLEVEL2_VECTOR_VADDR #define XCHAL_DEBUG_VECTOR_PADDR XCHAL_INTLEVEL2_VECTOR_PADDR #define XCHAL_NMI_VECOFS 0x00000020 #define XCHAL_NMI_VECTOR_VADDR 0x40000020 #define XCHAL_NMI_VECTOR_PADDR 0x40000020 #define XCHAL_INTLEVEL3_VECOFS XCHAL_NMI_VECOFS #define XCHAL_INTLEVEL3_VECTOR_VADDR XCHAL_NMI_VECTOR_VADDR #define XCHAL_INTLEVEL3_VECTOR_PADDR XCHAL_NMI_VECTOR_PADDR /*---------------------------------------------------------------------- DEBUG ----------------------------------------------------------------------*/ #define XCHAL_HAVE_OCD 1 /* OnChipDebug option */ #define XCHAL_NUM_IBREAK 1 /* number of IBREAKn regs */ #define XCHAL_NUM_DBREAK 1 /* number of DBREAKn regs */ #define XCHAL_HAVE_OCD_DIR_ARRAY 0 /* faster OCD option */ /*---------------------------------------------------------------------- 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 */ ================================================ FILE: app/include/xtensa/config/core-matmap.h ================================================ /* * 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=7011; Build=0x2b6f6; Copyright (c) 1999-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_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_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 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_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_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_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_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_WRITETHRU 2 /* cache enabled (write-through) mode */ #define XCHAL_CA_WRITEBACK 2 /* cache enabled (write-back) mode */ #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*/ ================================================ FILE: app/include/xtensa/config/core.h ================================================ /* * 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-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_CORE_H #define XTENSA_CONFIG_CORE_H /* CONFIGURATION INDEPENDENT DEFINITIONS: */ #ifdef __XTENSA__ #include #else #include "../hal.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 */ #define XCHAL_EXCCAUSE_FLOATING_POINT 40 /* Floating Point Exception */ /*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. */ #define XCHAL_CACHE_PREFCTL_DEFAULT 0x44 /* 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_D_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 /*---------------------------------------------------------------------- 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 .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))) #endif /*XTENSA_CONFIG_CORE_H*/ ================================================ FILE: app/include/xtensa/config/defs.h ================================================ /* Definitions for Xtensa instructions, types, and protos. */ /* Customer ID=7011; Build=0x2b6f6; 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 #endif /* __XTENSA__ */ #endif /* !_XTENSA_BASE_HEADER */ ================================================ FILE: app/include/xtensa/config/specreg.h ================================================ /* * Xtensa Special Register symbolic names */ /* $Id: //depot/rel/Boreal/Xtensa/SWConfig/hal/specreg.h.tpp#2 $ */ /* Customer ID=7011; Build=0x2b6f6; 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 SAR 3 #define LITBASE 5 #define IBREAKENABLE 96 #define DDR 104 #define IBREAKA_0 128 #define DBREAKA_0 144 #define DBREAKC_0 160 #define EPC_1 177 #define EPC_2 178 #define EPC_3 179 #define DEPC 192 #define EPS_2 194 #define EPS_3 195 #define EXCSAVE_1 209 #define EXCSAVE_2 210 #define EXCSAVE_3 211 #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 /* Special cases (bases of special register series): */ #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 */ ================================================ FILE: app/include/xtensa/config/system.h ================================================ /* * 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=7011; Build=0x2b6f6; Copyright (c) 2000-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. */ #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_ABI XTHAL_ABI_CALL0 /* (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 0*/ /* set if windowed ABI selected */ /*#define XSHAL_CALL0_ABI 1*/ /* 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 /* Alternatives: */ /*#define XSHAL_NEWLIB 1*/ /* set if newlib C library selected */ /*#define XSHAL_UCLIBC 0*/ /* set if uCLibC C library selected */ #define XSHAL_USE_FLOATING_POINT 1 /*---------------------------------------------------------------------- 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 0x50000300 #define XSHAL_ROM_AVAIL_VSIZE 0x00FFFD00 /* System RAM: */ #define XSHAL_RAM_VADDR 0x60000000 #define XSHAL_RAM_PADDR 0x60000000 #define XSHAL_RAM_VSIZE 0x04000000 #define XSHAL_RAM_PSIZE 0x04000000 #define XSHAL_RAM_SIZE XSHAL_RAM_PSIZE /* Largest available area (free of vectors): */ #define XSHAL_RAM_AVAIL_VADDR 0x60000000 #define XSHAL_RAM_AVAIL_VSIZE 0x04000000 /* * 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 0x04000000 /* 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 /*---------------------------------------------------------------------- * 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 0 #define XSHAL_RESET_VECTOR_VADDR 0x50000000 #define XSHAL_RESET_VECTOR_PADDR 0x50000000 /* * 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 1 #define XSHAL_USER_VECTOR_SIZE 0x0000001C #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 0x0000001C #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 0x00000010 #define XSHAL_DOUBLEEXC_VECTOR_ISROM 0 #define XSHAL_INTLEVEL2_VECTOR_SIZE 0x0000000C #define XSHAL_INTLEVEL2_VECTOR_ISROM 0 #define XSHAL_DEBUG_VECTOR_SIZE XSHAL_INTLEVEL2_VECTOR_SIZE #define XSHAL_DEBUG_VECTOR_ISROM XSHAL_INTLEVEL2_VECTOR_ISROM #define XSHAL_NMI_VECTOR_SIZE 0x0000000C #define XSHAL_NMI_VECTOR_ISROM 0 #define XSHAL_INTLEVEL3_VECTOR_SIZE XSHAL_NMI_VECTOR_SIZE #endif /*XTENSA_CONFIG_SYSTEM_H*/ ================================================ FILE: app/include/xtensa/config/tie-asm.h ================================================ /* * 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=7011; Build=0x2b6f6; Copyright (c) 1999-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_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) */ /* 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 */ /* 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) */ /* Misc */ #define XTHAL_SAS_ALL 0xFFFF /* include all default NCP contents */ /* Macro to save all non-coprocessor (extra) custom TIE and optional state * (not including zero-overhead loop registers). * Save area ptr (clobbered): ptr (1 byte aligned) * Scratch regs (clobbered): at1..at4 (only first XCHAL_NCP_NUM_ATMPS needed) */ .macro xchal_ncp_store ptr at1 at2 at3 at4 continue=0 ofs=-1 select=XTHAL_SAS_ALL xchal_sa_start \continue, \ofs .endm // xchal_ncp_store /* Macro to save all non-coprocessor (extra) custom TIE and optional state * (not including zero-overhead loop registers). * Save area ptr (clobbered): ptr (1 byte aligned) * Scratch regs (clobbered): at1..at4 (only first XCHAL_NCP_NUM_ATMPS needed) */ .macro xchal_ncp_load ptr at1 at2 at3 at4 continue=0 ofs=-1 select=XTHAL_SAS_ALL xchal_sa_start \continue, \ofs .endm // xchal_ncp_load #define XCHAL_NCP_NUM_ATMPS 0 #define XCHAL_SA_NUM_ATMPS 0 #endif /*_XTENSA_CORE_TIE_ASM_H*/ ================================================ FILE: app/include/xtensa/config/tie.h ================================================ /* * 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=7011; Build=0x2b6f6; Copyright (c) 1999-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_CORE_TIE_H #define _XTENSA_CORE_TIE_H #define XCHAL_CP_NUM 0 /* number of coprocessors */ #define XCHAL_CP_MAX 0 /* max CP ID + 1 (0 if none) */ #define XCHAL_CP_MASK 0x00 /* bitmask of all CPs by ID */ #define XCHAL_CP_PORT_MASK 0x00 /* bitmask of only port CPs */ /* Save area for non-coprocessor optional and custom (TIE) state: */ #define XCHAL_NCP_SA_SIZE 0 #define XCHAL_NCP_SA_ALIGN 1 /* Total save area for optional and custom state (NCP + CPn): */ #define XCHAL_TOTAL_SA_SIZE 0 /* with 16-byte align padding */ #define XCHAL_TOTAL_SA_ALIGN 1 /* 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 0 #define XCHAL_NCP_SA_LIST(s) /* empty */ #define XCHAL_CP0_SA_NUM 0 #define XCHAL_CP0_SA_LIST(s) /* empty */ #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 #endif /*_XTENSA_CORE_TIE_H*/ ================================================ FILE: app/include/xtensa/coreasm.h ================================================ /* * 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/Boreal/Xtensa/OS/include/xtensa/coreasm.h#2 $ */ /* * Copyright (c) 2000-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. */ #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 /* * 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 /*---------------------------------------------------------------------- * 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 #endif /*XTENSA_COREASM_H*/ ================================================ FILE: app/include/xtensa/corebits.h ================================================ /* * 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/Boreal/Xtensa/OS/include/xtensa/corebits.h#2 $ */ /* * Copyright (c) 2005-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. */ #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 */ /*#define EXCCAUSE_FLOATING_POINT 40*/ /* Floating Point Exception (not implemented) */ /* 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)<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)) * * * 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.] * * Notes: * Tornado 2.0 supported in T1020.3+, T1030.1+, and T1040.{0,1} only. * Tornado 2.0.2 supported in T1040.2+, T1050, and 6.0. * Compile-time HAL port of NucleusPlus supported by T1040.2 and later. */ /* 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 ); extern void xthal_icache_line_invalidate(void *addr); extern void xthal_dcache_line_invalidate(void *addr); /* write dirty data back */ extern void xthal_dcache_region_writeback( void *addr, unsigned size ); extern void xthal_dcache_line_writeback(void *addr); /* write dirty data back and invalidate */ extern void xthal_dcache_region_writeback_inv( void *addr, unsigned size ); 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 ); /* 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 ); /* prefetch */ #define XTHAL_PREFETCH_ENABLE -1 #define XTHAL_PREFETCH_DISABLE 0 extern int xthal_set_cache_prefetch( int ); extern int xthal_get_cache_prefetch( void ); /*---------------------------------------------------------------------- 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; #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_MAX_INTTYPES 7 /* 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_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.0 * And the character column contents are: * = supported by release(s) * "." = unsupported by release(s) * "?" = support unknown */ /* FOMGIWACE 234578 */ /* For instruction fetch: */ #define XTHAL_FAM_EXCEPTION 0x001 /* ........E 234578 exception */ /*efine XTHAL_FAM_ISOLATE*/ /*0x012*/ /* .---I.-C- ...... isolate */ #define XTHAL_FAM_BYPASS 0x000 /* .----.--- 234578 bypass */ /*efine XTHAL_FAM_NACACHED*/ /*0x002*/ /* .----.-C- ...... cached no-allocate (frozen) */ #define XTHAL_FAM_CACHED 0x006 /* .----.AC- 234578 cached */ /* For data load: */ #define XTHAL_LAM_EXCEPTION 0x001 /* ........E 234578 exception */ #define XTHAL_LAM_ISOLATE 0x012 /* .---I.-C- 234578 isolate */ #define XTHAL_LAM_BYPASS 0x000 /* .O---.--- 2..... bypass speculative */ #define XTHAL_LAM_BYPASSG 0x020 /* .O-G-.--- .34578 bypass guarded */ #define XTHAL_LAM_CACHED_NOALLOC 0x002 /* .O---.-C- 234578 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- 234578 cached speculative */ #define XTHAL_LAM_COHCACHED 0x046 /* .-M--.AC- ....*8 cached speculative MP-coherent */ /* For data store: */ #define XTHAL_SAM_EXCEPTION 0x001 /* ........E 234578 exception */ #define XTHAL_SAM_ISOLATE 0x032 /* .--GI--C- 234578 isolate */ #define XTHAL_SAM_BYPASS 0x028 /* -O-G-W--- 234578 bypass */ #define XTHAL_SAM_WRITETHRU 0x02A /* -O-G-W-C- 234578 writethrough */ /*efine XTHAL_SAM_WRITETHRU_ALLOC*/ /*0x02E*/ /* -O-G-WAC- ...... writethrough allocate */ #define XTHAL_SAM_WRITEBACK 0x026 /* F-MG--AC- ...578 writeback */ #define XTHAL_SAM_COHWRITEBACK 0x066 /* F-MG--AC- ....*8 writeback MP-coherent */ #define XTHAL_SAM_WRITEBACK_NOALLOC 0x022 /* ?--G---C- .....8 writeback no-allocate */ #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; /* 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 ); extern void xthal_icache_line_lock(void *addr); extern void xthal_dcache_line_lock(void *addr); /* 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 ); extern void xthal_icache_line_unlock(void *addr); extern void xthal_dcache_line_unlock(void *addr); /*---------------------------------------------------------------------- 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 ); #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*/ ================================================ FILE: app/include/xtensa/sim.h ================================================ /* 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_*/ ================================================ FILE: app/include/xtensa/simcall-errno.h ================================================ /* 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 */ ================================================ FILE: app/include/xtensa/simcall-fcntl.h ================================================ /* 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 */ ================================================ FILE: app/include/xtensa/simcall.h ================================================ /* * 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 */ /* * 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 */ ================================================ FILE: app/include/xtensa/specreg.h ================================================ /* * Xtensa Special Register symbolic names */ /* $Id: //depot/rel/Boreal/Xtensa/OS/include/xtensa/specreg.h#2 $ */ /* * Copyright (c) 2005-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_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 CACHEATTR 98 #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 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 */ ================================================ FILE: app/include/xtensa/tie/xt_MUL32.h ================================================ /* Definitions for the 32-bit Integer Multiply Option. */ /* * Customer ID=7011; Build=0x2b6f6; 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 */ ================================================ FILE: app/include/xtensa/tie/xt_core.h ================================================ /* Definitions for the xt_core TIE package */ /* * Customer ID=7011; Build=0x2b6f6; Copyright (c) 2004 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_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_176(void); extern void _TIE_xt_core_WSR_176(unsigned art); extern unsigned _TIE_xt_core_RSR_208(void); 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 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 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_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_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_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 int _TIE_xt_core_RSR_PRID(void); #define XT_ILL _TIE_xt_core_ILL #define XT_NOP _TIE_xt_core_NOP #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_176 _TIE_xt_core_RSR_176 #define XT_WSR_176 _TIE_xt_core_WSR_176 #define XT_RSR_208 _TIE_xt_core_RSR_208 #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_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_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_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_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_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_PRID _TIE_xt_core_RSR_PRID #endif /* __XCC__ */ #endif /* __XTENSA__ */ #endif /* !_XTENSA_xt_core_HEADER */ ================================================ FILE: app/include/xtensa/tie/xt_debug.h ================================================ /* Definitions for the xt_debug TIE package */ /* * Customer ID=7011; Build=0x2b6f6; Copyright (c) 2004 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_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_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*/); #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_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_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 #endif /* __XCC__ */ #endif /* __XTENSA__ */ #endif /* !_XTENSA_xt_debug_HEADER */ ================================================ FILE: app/include/xtensa/tie/xt_density.h ================================================ /* Definitions for the xt_density TIE package */ /* * Customer ID=7011; Build=0x2b6f6; Copyright (c) 2004 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 */ ================================================ FILE: app/include/xtensa/tie/xt_exceptions.h ================================================ /* Definitions for the xt_exceptions TIE package */ /* * Customer ID=7011; Build=0x2b6f6; Copyright (c) 2004 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); extern void _TIE_xt_exceptions_SIMCALL(void); #define XT_EXCW _TIE_xt_exceptions_EXCW #define XT_SYSCALL _TIE_xt_exceptions_SYSCALL #define XT_SIMCALL _TIE_xt_exceptions_SIMCALL #endif /* __XCC__ */ #endif /* __XTENSA__ */ #endif /* !_XTENSA_xt_exceptions_HEADER */ ================================================ FILE: app/include/xtensa/tie/xt_externalregisters.h ================================================ /* Definitions for the xt_externalregisters TIE package */ /* * Customer ID=7011; Build=0x2b6f6; Copyright (c) 2004 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__ /* * 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_externalregisters_RER(void); extern void _TIE_xt_externalregisters_WER(void); #define XT_RER _TIE_xt_externalregisters_RER #define XT_WER _TIE_xt_externalregisters_WER #endif /* __XCC__ */ #endif /* __XTENSA__ */ #endif /* !_XTENSA_xt_externalregisters_HEADER */ ================================================ FILE: app/include/xtensa/tie/xt_interrupt.h ================================================ /* Definitions for the xt_interrupt TIE package */ /* * Customer ID=7011; Build=0x2b6f6; Copyright (c) 2004 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 */ ================================================ FILE: app/include/xtensa/tie/xt_misc.h ================================================ /* Definitions for the xt_misc TIE package */ /* * Customer ID=7011; Build=0x2b6f6; Copyright (c) 2004 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_NSA(int s); extern unsigned _TIE_xt_misc_NSAU(unsigned s); #define XT_NSA _TIE_xt_misc_NSA #define XT_NSAU _TIE_xt_misc_NSAU #endif /* __XCC__ */ #endif /* __XTENSA__ */ #endif /* !_XTENSA_xt_misc_HEADER */ ================================================ FILE: app/include/xtensa/tie/xt_mmu.h ================================================ /* Definitions for the xt_mmu TIE package */ /* * Customer ID=7011; Build=0x2b6f6; Copyright (c) 2004 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 */ ================================================ FILE: app/include/xtensa/tie/xt_mul.h ================================================ /* Definitions for the xt_mul TIE package */ /* * Customer ID=7011; Build=0x2b6f6; Copyright (c) 2004 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); #define XT_MUL16S _TIE_xt_mul_MUL16S #define XT_MUL16U _TIE_xt_mul_MUL16U #define XT_MULL _TIE_xt_mul_MULL #endif /* __XCC__ */ #endif /* __XTENSA__ */ #endif /* !_XTENSA_xt_mul_HEADER */ ================================================ FILE: app/include/xtensa/tie/xt_timer.h ================================================ /* Definitions for the xt_timer TIE package */ /* * Customer ID=7011; Build=0x2b6f6; Copyright (c) 2004 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*/); #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 #endif /* __XCC__ */ #endif /* __XTENSA__ */ #endif /* !_XTENSA_xt_timer_HEADER */ ================================================ FILE: app/include/xtensa/tie/xt_trace.h ================================================ /* Definitions for the xt_trace TIE package */ /* * Customer ID=7011; Build=0x2b6f6; Copyright (c) 2004 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 */ ================================================ FILE: app/include/xtensa/xtensa-libdb-macros.h ================================================ /* * xtensa-libdb-macros.h */ /* $Id: //depot/rel/Boreal/Xtensa/Software/libdb/xtensa-libdb-macros.h#2 $ */ /* 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..0x006F RESERVED for use by Tensilica */ #define XTENSA_DBREGN_DF(n) (0x0070+(n)) /* double floating point registers df0..df15 */ /* 0x0080..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_DF(tn) (((tn) & 0xFFF0)==0x0070) /* is df0..df15 */ #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_DF_INDEX(tn) ((tn) & 0x0F) /* 0..15 for df0..df15 */ #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 */ ================================================ FILE: app/include/xtensa/xtensa-xer.h ================================================ /* 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 ================================================ FILE: app/include/xtensa/xtruntime-frames.h ================================================ /* xtruntime-frames.h - exception stack frames for single-threaded run-time */ /* $Id: //depot/rel/Boreal/Xtensa/OS/include/xtensa/xtruntime-frames.h#2 $ */ /* * Copyright (c) 2002-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. */ #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: .space (size)*(n) #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_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(char,1,UEXC_,ureg, (XCHAL_CPEXTRA_SA_SIZE_TOR2+3)&-4)*/ /* not used, and doesn't take alignment into account */ 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_ */ ================================================ FILE: app/include/xtensa/xtruntime.h ================================================ /* * xtruntime.h -- general C definitions for single-threaded run-time * * Copyright (c) 2002-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 XTRUNTIME_H #define XTRUNTIME_H #include #include #ifndef XTSTR #define _XTSTR(x) # x #define XTSTR(x) _XTSTR(x) #endif #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 ); /* 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 */ #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 */ ================================================ FILE: app/json/Makefile ================================================ ############################################################# # Required variables for each makefile # Discard this section from all parent makefiles # Expected variables (with automatic defaults): # CSRCS (all "C" files in the dir) # SUBDIRS (all subdirs with a Makefile) # GEN_LIBS - list of libs to be generated () # GEN_IMAGES - list of images to be generated () # COMPONENTS_xxx - a list of libs/objs in the form # subdir/lib to be extracted and rolled up into # a generated lib/image xxx.a () # ifndef PDIR GEN_LIBS = libjson.a endif ############################################################# # Configuration i.e. compile options etc. # Target specific stuff (defines etc.) goes in here! # Generally values applying to a tree are captured in the # makefile at its root level - these are then overridden # for a subtree within the makefile rooted therein # #DEFINES += ############################################################# # Recursion Magic - Don't touch this!! # # Each subtree potentially has an include directory # corresponding to the common APIs applicable to modules # rooted at that subtree. Accordingly, the INCLUDE PATH # of a module can only contain the include directories up # its parent path, and not its siblings # # Required for each makefile to inherit from the parent # INCLUDES := $(INCLUDES) -I $(PDIR)include INCLUDES += -I ./ INCLUDES += -I ../libc PDIR := ../$(PDIR) sinclude $(PDIR)Makefile ================================================ FILE: app/json/cJson.c ================================================ /* Copyright (c) 2009 Dave Gamble 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. */ /* cJSON */ /* JSON parser in C. */ #include #include #include #include #include "user_interface.h" #include "mem.h" #include "json/cJson.h" static const char *ep; #ifndef cJSON_malloc #define cJSON_malloc os_malloc #endif #ifndef cJSON_free #define cJSON_free os_free #endif #ifndef cJSON_strchr #define cJSON_strchr os_strchr #endif #ifndef sprintf #define sprintf os_sprintf #endif const char *ICACHE_FLASH_ATTR cJSON_GetErrorPtr(void) { return ep; } static int ICACHE_FLASH_ATTR cJSON_strcasecmp(const char *s1, const char *s2) { if (!s1) { return (s1 == s2) ? 0 : 1; } if (!s2) { return 1; } for (; tolower(*s1) == tolower(*s2); ++s1, ++s2) if (*s1 == 0) { return 0; } return tolower(*(const unsigned char *)s1) - tolower(*(const unsigned char *)s2); } static char *ICACHE_FLASH_ATTR cJSON_strdup(const char *str) { size_t len; char *copy; len = strlen(str) + 1; if (!(copy = (char *)cJSON_malloc(len))) { return 0; } memcpy(copy, str, len); return copy; } /* Internal constructor. */ static cJSON *ICACHE_FLASH_ATTR cJSON_New_Item(void) { cJSON *node = (cJSON *)cJSON_malloc(sizeof(cJSON)); if (node) { memset(node, 0, sizeof(cJSON)); } return node; } /* Delete a cJSON structure. */ void ICACHE_FLASH_ATTR cJSON_Delete(cJSON *c) { cJSON *next; while (c) { next = c->next; if (!(c->type & cJSON_IsReference) && c->child) { cJSON_Delete(c->child); } if (!(c->type & cJSON_IsReference) && c->valuestring) { cJSON_free(c->valuestring); } if (c->string) { cJSON_free(c->string); } cJSON_free(c); c = next; } } /* Parse the input text to generate a number, and populate the result into item. */ static const char *ICACHE_FLASH_ATTR parse_number(cJSON *item, const char *num) { double n = 0, sign = 1, scale = 0; int subscale = 0, signsubscale = 1; if (*num == '-') { sign = -1, num++; /* Has sign? */ } if (*num == '0') { num++; /* is zero */ } if (*num >= '1' && *num <= '9') do { n = (n * 10.0) + (*num++ -'0'); } while (*num >= '0' && *num <= '9'); /* Number? */ if (*num == '.' && num[1] >= '0' && num[1] <= '9') { num++; /* Fractional part? */ do { n = (n * 10.0) + (*num++ -'0'), scale--; } while (*num >= '0' && *num <= '9'); } if (*num == 'e' || *num == 'E') { /* Exponent? */ num++; if (*num == '+') { num++; } else if (*num == '-') { signsubscale = -1, num++; /* With sign? */ } while (*num >= '0' && *num <= '9') { subscale = (subscale * 10) + (*num++ - '0'); /* Number? */ } } // n = sign * n * pow(10.0, (scale + subscale * signsubscale)); /* number = +/- number.fraction * 10^+/- exponent */ item->valuedouble = n; item->valueint = (int)n; item->type = cJSON_Number; return num; } /* Render the number nicely from the given item into a string. */ static char *ICACHE_FLASH_ATTR print_number(cJSON *item) { char *str; double d = item->valuedouble; if (fabs(((double)item->valueint) - d) <= DBL_EPSILON && d <= INT_MAX && d >= INT_MIN) { str = (char *)cJSON_malloc(21); /* 2^64+1 can be represented in 21 chars. */ if (str) { sprintf(str, "%d", item->valueint); } } else { str = (char *)cJSON_malloc(64); /* This is a nice tradeoff. */ if (str) { //if (fabs(floor(d) - d) <= DBL_EPSILON && fabs(d) < 1.0e60) { sprintf(str, "%f", d); } } return str; } static unsigned ICACHE_FLASH_ATTR parse_hex4(const char *str) { unsigned h = 0; if (*str >= '0' && *str <= '9') { h += (*str) - '0'; } else if (*str >= 'A' && *str <= 'F') { h += 10 + (*str) - 'A'; } else if (*str >= 'a' && *str <= 'f') { h += 10 + (*str) - 'a'; } else { return 0; } h = h << 4; str++; if (*str >= '0' && *str <= '9') { h += (*str) - '0'; } else if (*str >= 'A' && *str <= 'F') { h += 10 + (*str) - 'A'; } else if (*str >= 'a' && *str <= 'f') { h += 10 + (*str) - 'a'; } else { return 0; } h = h << 4; str++; if (*str >= '0' && *str <= '9') { h += (*str) - '0'; } else if (*str >= 'A' && *str <= 'F') { h += 10 + (*str) - 'A'; } else if (*str >= 'a' && *str <= 'f') { h += 10 + (*str) - 'a'; } else { return 0; } h = h << 4; str++; if (*str >= '0' && *str <= '9') { h += (*str) - '0'; } else if (*str >= 'A' && *str <= 'F') { h += 10 + (*str) - 'A'; } else if (*str >= 'a' && *str <= 'f') { h += 10 + (*str) - 'a'; } else { return 0; } return h; } /* Parse the input text into an unescaped cstring, and populate item. */ static const unsigned char firstByteMark[7] = { 0x00, 0x00, 0xC0, 0xE0, 0xF0, 0xF8, 0xFC }; static const char *ICACHE_FLASH_ATTR parse_string(cJSON *item, const char *str) { const char *ptr = str + 1; char *ptr2; char *out; int len = 0; unsigned uc, uc2; if (*str != '\"') { ep = str; /* not a string! */ return 0; } while (*ptr != '\"' && *ptr && ++len) if (*ptr++ == '\\') { ptr++; /* Skip escaped quotes. */ } out = (char *)cJSON_malloc(len + 1); /* This is how long we need for the string, roughly. */ if (!out) { return 0; } ptr = str + 1; ptr2 = out; while (*ptr != '\"' && *ptr) { if (*ptr != '\\') { *ptr2++ = *ptr++; } else { ptr++; switch (*ptr) { case 'b': *ptr2++ = '\b'; break; case 'f': *ptr2++ = '\f'; break; case 'n': *ptr2++ = '\n'; break; case 'r': *ptr2++ = '\r'; break; case 't': *ptr2++ = '\t'; break; case 'u': /* transcode utf16 to utf8. */ uc = parse_hex4(ptr + 1); ptr += 4; /* get the unicode char. */ if ((uc >= 0xDC00 && uc <= 0xDFFF) || uc == 0) { break; /* check for invalid. */ } if (uc >= 0xD800 && uc <= 0xDBFF) { /* UTF16 surrogate pairs. */ if (ptr[1] != '\\' || ptr[2] != 'u') { break; /* missing second-half of surrogate. */ } uc2 = parse_hex4(ptr + 3); ptr += 6; if (uc2 < 0xDC00 || uc2 > 0xDFFF) { break; /* invalid second-half of surrogate. */ } uc = 0x10000 + (((uc & 0x3FF) << 10) | (uc2 & 0x3FF)); } len = 4; if (uc < 0x80) { len = 1; } else if (uc < 0x800) { len = 2; } else if (uc < 0x10000) { len = 3; } ptr2 += len; switch (len) { case 4: *--ptr2 = ((uc | 0x80) & 0xBF); uc >>= 6; case 3: *--ptr2 = ((uc | 0x80) & 0xBF); uc >>= 6; case 2: *--ptr2 = ((uc | 0x80) & 0xBF); uc >>= 6; case 1: *--ptr2 = (uc | firstByteMark[len]); } ptr2 += len; break; default: *ptr2++ = *ptr; break; } ptr++; } } *ptr2 = 0; if (*ptr == '\"') { ptr++; } item->valuestring = out; item->type = cJSON_String; return ptr; } /* Render the cstring provided to an escaped version that can be printed. */ static char *ICACHE_FLASH_ATTR print_string_ptr(const char *str) { const char *ptr; char *ptr2, *out; int len = 0; unsigned char token; if (!str) { return cJSON_strdup(""); } ptr = str; while ((token = *ptr) && ++len) { if (cJSON_strchr("\"\\\b\f\n\r\t", token)) { len++; } else if (token < 32) { len += 5; } ptr++; } out = (char *)cJSON_malloc(len + 3); if (!out) { return 0; } ptr2 = out; ptr = str; *ptr2++ = '\"'; while (*ptr) { if ((unsigned char)*ptr > 31 && *ptr != '\"' && *ptr != '\\') { *ptr2++ = *ptr++; } else { *ptr2++ = '\\'; switch (token = *ptr++) { case '\\': *ptr2++ = '\\'; break; case '\"': *ptr2++ = '\"'; break; case '\b': *ptr2++ = 'b'; break; case '\f': *ptr2++ = 'f'; break; case '\n': *ptr2++ = 'n'; break; case '\r': *ptr2++ = 'r'; break; case '\t': *ptr2++ = 't'; break; default: sprintf(ptr2, "u%04x", token); ptr2 += 5; break; /* escape and print */ } } } *ptr2++ = '\"'; *ptr2++ = 0; return out; } /* Invote print_string_ptr (which is useful) on an item. */ static char *ICACHE_FLASH_ATTR print_string(cJSON *item) { return print_string_ptr(item->valuestring); } /* Predeclare these prototypes. */ static const char *parse_value(cJSON *item, const char *value); static char *print_value(cJSON *item, int depth, int fmt); static const char *parse_array(cJSON *item, const char *value); static char *print_array(cJSON *item, int depth, int fmt); static const char *parse_object(cJSON *item, const char *value); static char *print_object(cJSON *item, int depth, int fmt); /* Utility to jump whitespace and cr/lf */ static const char *ICACHE_FLASH_ATTR skip(const char *in) { while (in && *in && (unsigned char)*in <= 32) { in++; } return in; } /* Parse an object - create a new root, and populate. */ cJSON *ICACHE_FLASH_ATTR cJSON_ParseWithOpts(const char *value, const char **return_parse_end, int require_null_terminated) { const char *end = 0; cJSON *c = cJSON_New_Item(); ep = 0; if (!c) { return 0; /* memory fail */ } end = parse_value(c, skip(value)); if (!end) { cJSON_Delete(c); /* parse failure. ep is set. */ return 0; } /* if we require null-terminated JSON without appended garbage, skip and then check for a null terminator */ if (require_null_terminated) { end = skip(end); if (*end) { cJSON_Delete(c); ep = end; return 0; } } if (return_parse_end) { *return_parse_end = end; } return c; } /* Default options for cJSON_Parse */ cJSON *ICACHE_FLASH_ATTR cJSON_Parse(const char *value) { return cJSON_ParseWithOpts(value, 0, 0); } /* Render a cJSON item/entity/structure to text. */ char *ICACHE_FLASH_ATTR cJSON_Print(cJSON *item) { return print_value(item, 0, 1); } char *ICACHE_FLASH_ATTR cJSON_PrintUnformatted(cJSON *item) { return print_value(item, 0, 0); } /* Parser core - when encountering text, process appropriately. */ static const char *ICACHE_FLASH_ATTR parse_value(cJSON *item, const char *value) { if (!value) { return 0; /* Fail on null. */ } if (!strncmp(value, "null", 4)) { item->type = cJSON_NULL; return value + 4; } if (!strncmp(value, "false", 5)) { item->type = cJSON_False; return value + 5; } if (!strncmp(value, "true", 4)) { item->type = cJSON_True; item->valueint = 1; return value + 4; } if (*value == '\"') { return parse_string(item, value); } if (*value == '-' || (*value >= '0' && *value <= '9')) { return parse_number(item, value); } if (*value == '[') { return parse_array(item, value); } if (*value == '{') { return parse_object(item, value); } ep = value; return 0; /* failure. */ } /* Render a value to text. */ static char *ICACHE_FLASH_ATTR print_value(cJSON *item, int depth, int fmt) { char *out = 0; if (!item) { return 0; } switch ((item->type) & 255) { case cJSON_NULL: out = cJSON_strdup("null"); break; case cJSON_False: out = cJSON_strdup("false"); break; case cJSON_True: out = cJSON_strdup("true"); break; case cJSON_Number: out = print_number(item); break; case cJSON_String: out = print_string(item); break; case cJSON_Array: out = print_array(item, depth, fmt); break; case cJSON_Object: out = print_object(item, depth, fmt); break; } return out; } /* Build an array from input text. */ static const char *ICACHE_FLASH_ATTR parse_array(cJSON *item, const char *value) { cJSON *child; if (*value != '[') { ep = value; /* not an array! */ return 0; } item->type = cJSON_Array; value = skip(value + 1); if (*value == ']') { return value + 1; /* empty array. */ } item->child = child = cJSON_New_Item(); if (!item->child) { return 0; /* memory fail */ } value = skip(parse_value(child, skip(value))); /* skip any spacing, get the value. */ if (!value) { return 0; } while (*value == ',') { cJSON *new_item; if (!(new_item = cJSON_New_Item())) { return 0; /* memory fail */ } child->next = new_item; new_item->prev = child; child = new_item; value = skip(parse_value(child, skip(value + 1))); if (!value) { return 0; /* memory fail */ } } if (*value == ']') { return value + 1; /* end of array */ } ep = value; return 0; /* malformed. */ } /* Render an array to text */ static char *ICACHE_FLASH_ATTR print_array(cJSON *item, int depth, int fmt) { char **entries; char *out = 0, *ptr, *ret; int len = 5; cJSON *child = item->child; int numentries = 0, i = 0, fail = 0; /* How many entries in the array? */ while (child) { numentries++, child = child->next; } /* Explicitly handle numentries==0 */ if (!numentries) { out = (char *)cJSON_malloc(3); if (out) { strcpy(out, "[]"); } return out; } /* Allocate an array to hold the values for each */ entries = (char **)cJSON_malloc(numentries * sizeof(char *)); if (!entries) { return 0; } memset(entries, 0, numentries * sizeof(char *)); /* Retrieve all the results: */ child = item->child; while (child && !fail) { ret = print_value(child, depth + 1, fmt); entries[i++] = ret; if (ret) { len += strlen(ret) + 2 + (fmt ? 1 : 0); } else { fail = 1; } child = child->next; } /* If we didn't fail, try to malloc the output string */ if (!fail) { out = (char *)cJSON_malloc(len); } /* If that fails, we fail. */ if (!out) { fail = 1; } /* Handle failure. */ if (fail) { for (i = 0; i < numentries; i++) if (entries[i]) { cJSON_free(entries[i]); } cJSON_free(entries); return 0; } /* Compose the output array. */ *out = '['; ptr = out + 1; *ptr = 0; for (i = 0; i < numentries; i++) { strcpy(ptr, entries[i]); ptr += strlen(entries[i]); if (i != numentries - 1) { *ptr++ = ','; if (fmt) { *ptr++ = ' '; }*ptr = 0; } cJSON_free(entries[i]); } cJSON_free(entries); *ptr++ = ']'; *ptr++ = 0; return out; } /* Build an object from the text. */ static const char *ICACHE_FLASH_ATTR parse_object(cJSON *item, const char *value) { cJSON *child; if (*value != '{') { ep = value; /* not an object! */ return 0; } item->type = cJSON_Object; value = skip(value + 1); if (*value == '}') { return value + 1; /* empty array. */ } item->child = child = cJSON_New_Item(); if (!item->child) { return 0; } value = skip(parse_string(child, skip(value))); if (!value) { return 0; } child->string = child->valuestring; child->valuestring = 0; if (*value != ':') { ep = value; /* fail! */ return 0; } value = skip(parse_value(child, skip(value + 1))); /* skip any spacing, get the value. */ if (!value) { return 0; } while (*value == ',') { cJSON *new_item; if (!(new_item = cJSON_New_Item())) { return 0; /* memory fail */ } child->next = new_item; new_item->prev = child; child = new_item; value = skip(parse_string(child, skip(value + 1))); if (!value) { return 0; } child->string = child->valuestring; child->valuestring = 0; if (*value != ':') { ep = value; /* fail! */ return 0; } value = skip(parse_value(child, skip(value + 1))); /* skip any spacing, get the value. */ if (!value) { return 0; } } if (*value == '}') { return value + 1; /* end of array */ } ep = value; return 0; /* malformed. */ } /* Render an object to text. */ static char *ICACHE_FLASH_ATTR print_object(cJSON *item, int depth, int fmt) { char **entries = 0, **names = 0; char *out = 0, *ptr, *ret, *str; int len = 7, i = 0, j; cJSON *child = item->child; int numentries = 0, fail = 0; /* Count the number of entries. */ while (child) { numentries++, child = child->next; } /* Explicitly handle empty object case */ if (!numentries) { out = (char *)cJSON_malloc(fmt ? depth + 4 : 3); if (!out) { return 0; } ptr = out; *ptr++ = '{'; if (fmt) { *ptr++ = '\n'; for (i = 0; i < depth - 1; i++) { *ptr++ = '\t'; } } *ptr++ = '}'; *ptr++ = 0; return out; } /* Allocate space for the names and the objects */ entries = (char **)cJSON_malloc(numentries * sizeof(char *)); if (!entries) { return 0; } names = (char **)cJSON_malloc(numentries * sizeof(char *)); if (!names) { cJSON_free(entries); return 0; } memset(entries, 0, sizeof(char *)*numentries); memset(names, 0, sizeof(char *)*numentries); /* Collect all the results into our arrays: */ child = item->child; depth++; if (fmt) { len += depth; } while (child) { names[i] = str = print_string_ptr(child->string); entries[i++] = ret = print_value(child, depth, fmt); if (str && ret) { len += strlen(ret) + strlen(str) + 2 + (fmt ? 2 + depth : 0); } else { fail = 1; } child = child->next; } /* Try to allocate the output string */ if (!fail) { out = (char *)cJSON_malloc(len); } if (!out) { fail = 1; } /* Handle failure */ if (fail) { for (i = 0; i < numentries; i++) { if (names[i]) { cJSON_free(names[i]); } if (entries[i]) { cJSON_free(entries[i]); } } cJSON_free(names); cJSON_free(entries); return 0; } /* Compose the output: */ *out = '{'; ptr = out + 1; if (fmt) { *ptr++ = '\n'; }*ptr = 0; for (i = 0; i < numentries; i++) { if (fmt) for (j = 0; j < depth; j++) { *ptr++ = '\t'; } strcpy(ptr, names[i]); ptr += strlen(names[i]); *ptr++ = ':'; if (fmt) { *ptr++ = '\t'; } strcpy(ptr, entries[i]); ptr += strlen(entries[i]); if (i != numentries - 1) { *ptr++ = ','; } if (fmt) { *ptr++ = '\n'; }*ptr = 0; cJSON_free(names[i]); cJSON_free(entries[i]); } cJSON_free(names); cJSON_free(entries); if (fmt) for (i = 0; i < depth - 1; i++) { *ptr++ = '\t'; } *ptr++ = '}'; *ptr++ = 0; return out; } /* Get Array size/item / object item. */ int ICACHE_FLASH_ATTR cJSON_GetArraySize(cJSON *array) { cJSON *c = array->child; int i = 0; while (c) { i++, c = c->next; } return i; } cJSON *ICACHE_FLASH_ATTR cJSON_GetArrayItem(cJSON *array, int item) { cJSON *c = array->child; while (c && item > 0) { item--, c = c->next; } return c; } cJSON *ICACHE_FLASH_ATTR cJSON_GetObjectItem(cJSON *object, const char *string) { cJSON *c = object->child; while (c && cJSON_strcasecmp(c->string, string)) { c = c->next; } return c; } /* Utility for array list handling. */ static void ICACHE_FLASH_ATTR suffix_object(cJSON *prev, cJSON *item) { prev->next = item; item->prev = prev; } /* Utility for handling references. */ static cJSON *ICACHE_FLASH_ATTR create_reference(cJSON *item) { cJSON *ref = cJSON_New_Item(); if (!ref) { return 0; } memcpy(ref, item, sizeof(cJSON)); ref->string = 0; ref->type |= cJSON_IsReference; ref->next = ref->prev = 0; return ref; } /* Add item to array/object. */ void ICACHE_FLASH_ATTR cJSON_AddItemToArray(cJSON *array, cJSON *item) { cJSON *c = array->child; if (!item) { return; } if (!c) { array->child = item; } else { while (c && c->next) { c = c->next; } suffix_object(c, item); } } void ICACHE_FLASH_ATTR cJSON_AddItemToObject(cJSON *object, const char *string, cJSON *item) { if (!item) { return; } if (item->string) { cJSON_free(item->string); } item->string = cJSON_strdup(string); cJSON_AddItemToArray(object, item); } void ICACHE_FLASH_ATTR cJSON_AddItemReferenceToArray(cJSON *array, cJSON *item) { cJSON_AddItemToArray(array, create_reference(item)); } void ICACHE_FLASH_ATTR cJSON_AddItemReferenceToObject(cJSON *object, const char *string, cJSON *item) { cJSON_AddItemToObject(object, string, create_reference(item)); } cJSON *ICACHE_FLASH_ATTR cJSON_DetachItemFromArray(cJSON *array, int which) { cJSON *c = array->child; while (c && which > 0) { c = c->next, which--; } if (!c) { return 0; } if (c->prev) { c->prev->next = c->next; } if (c->next) { c->next->prev = c->prev; } if (c == array->child) { array->child = c->next; } c->prev = c->next = 0; return c; } void ICACHE_FLASH_ATTR cJSON_DeleteItemFromArray(cJSON *array, int which) { cJSON_Delete(cJSON_DetachItemFromArray(array, which)); } cJSON *ICACHE_FLASH_ATTR cJSON_DetachItemFromObject(cJSON *object, const char *string) { int i = 0; cJSON *c = object->child; while (c && cJSON_strcasecmp(c->string, string)) { i++, c = c->next; } if (c) { return cJSON_DetachItemFromArray(object, i); } return 0; } void ICACHE_FLASH_ATTR cJSON_DeleteItemFromObject(cJSON *object, const char *string) { cJSON_Delete(cJSON_DetachItemFromObject(object, string)); } /* Replace array/object items with new ones. */ void ICACHE_FLASH_ATTR cJSON_ReplaceItemInArray(cJSON *array, int which, cJSON *newitem) { cJSON *c = array->child; while (c && which > 0) { c = c->next, which--; } if (!c) { return; } newitem->next = c->next; newitem->prev = c->prev; if (newitem->next) { newitem->next->prev = newitem; } if (c == array->child) { array->child = newitem; } else { newitem->prev->next = newitem; } c->next = c->prev = 0; cJSON_Delete(c); } void ICACHE_FLASH_ATTR cJSON_ReplaceItemInObject(cJSON *object, const char *string, cJSON *newitem) { int i = 0; cJSON *c = object->child; while (c && cJSON_strcasecmp(c->string, string)) { i++, c = c->next; } if (c) { newitem->string = cJSON_strdup(string); cJSON_ReplaceItemInArray(object, i, newitem); } } /* Create basic types: */ cJSON *ICACHE_FLASH_ATTR cJSON_CreateNull(void) { cJSON *item = cJSON_New_Item(); if (item) { item->type = cJSON_NULL; } return item; } cJSON *ICACHE_FLASH_ATTR cJSON_CreateTrue(void) { cJSON *item = cJSON_New_Item(); if (item) { item->type = cJSON_True; } return item; } cJSON *ICACHE_FLASH_ATTR cJSON_CreateFalse(void) { cJSON *item = cJSON_New_Item(); if (item) { item->type = cJSON_False; } return item; } cJSON *ICACHE_FLASH_ATTR cJSON_CreateBool(int b) { cJSON *item = cJSON_New_Item(); if (item) { item->type = b ? cJSON_True : cJSON_False; } return item; } cJSON *ICACHE_FLASH_ATTR cJSON_CreateNumber(double num) { cJSON *item = cJSON_New_Item(); if (item) { item->type = cJSON_Number; item->valuedouble = num; item->valueint = (int)num; } return item; } cJSON *ICACHE_FLASH_ATTR cJSON_CreateString(const char *string) { cJSON *item = cJSON_New_Item(); if (item) { item->type = cJSON_String; item->valuestring = cJSON_strdup(string); } return item; } cJSON *ICACHE_FLASH_ATTR cJSON_CreateArray(void) { cJSON *item = cJSON_New_Item(); if (item) { item->type = cJSON_Array; } return item; } cJSON *ICACHE_FLASH_ATTR cJSON_CreateObject(void) { cJSON *item = cJSON_New_Item(); if (item) { item->type = cJSON_Object; } return item; } /* Create Arrays: */ cJSON *ICACHE_FLASH_ATTR cJSON_CreateIntArray(const int *numbers, int count) { int i; cJSON *n = 0, *p = 0, *a = cJSON_CreateArray(); for (i = 0; a && i < count; i++) { n = cJSON_CreateNumber(numbers[i]); if (!i) { a->child = n; } else { suffix_object(p, n); } p = n; } return a; } cJSON *ICACHE_FLASH_ATTR cJSON_CreateFloatArray(const float *numbers, int count) { int i; cJSON *n = 0, *p = 0, *a = cJSON_CreateArray(); for (i = 0; a && i < count; i++) { n = cJSON_CreateNumber(numbers[i]); if (!i) { a->child = n; } else { suffix_object(p, n); } p = n; } return a; } cJSON *ICACHE_FLASH_ATTR cJSON_CreateDoubleArray(const double *numbers, int count) { int i; cJSON *n = 0, *p = 0, *a = cJSON_CreateArray(); for (i = 0; a && i < count; i++) { n = cJSON_CreateNumber(numbers[i]); if (!i) { a->child = n; } else { suffix_object(p, n); } p = n; } return a; } cJSON *ICACHE_FLASH_ATTR cJSON_CreateStringArray(const char **strings, int count) { int i; cJSON *n = 0, *p = 0, *a = cJSON_CreateArray(); for (i = 0; a && i < count; i++) { n = cJSON_CreateString(strings[i]); if (!i) { a->child = n; } else { suffix_object(p, n); } p = n; } return a; } /* Duplication */ cJSON *ICACHE_FLASH_ATTR cJSON_Duplicate(cJSON *item, int recurse) { cJSON *newitem, *cptr, *nptr = 0, *newchild; /* Bail on bad ptr */ if (!item) { return 0; } /* Create new item */ newitem = cJSON_New_Item(); if (!newitem) { return 0; } /* Copy over all vars */ newitem->type = item->type & (~cJSON_IsReference), newitem->valueint = item->valueint, newitem->valuedouble = item->valuedouble; if (item->valuestring) { newitem->valuestring = cJSON_strdup(item->valuestring); if (!newitem->valuestring) { cJSON_Delete(newitem); return 0; } } if (item->string) { newitem->string = cJSON_strdup(item->string); if (!newitem->string) { cJSON_Delete(newitem); return 0; } } /* If non-recursive, then we're done! */ if (!recurse) { return newitem; } /* Walk the ->next chain for the child. */ cptr = item->child; while (cptr) { newchild = cJSON_Duplicate(cptr, 1); /* Duplicate (with recurse) each item in the ->next chain */ if (!newchild) { cJSON_Delete(newitem); return 0; } if (nptr) { nptr->next = newchild, newchild->prev = nptr; /* If newitem->child already set, then crosswire ->prev and ->next and move on */ nptr = newchild; } else { newitem->child = newchild; /* Set newitem->child and move to it */ nptr = newchild; } cptr = cptr->next; } return newitem; } void ICACHE_FLASH_ATTR cJSON_Minify(char *json) { char *into = json; while (*json) { if (*json == ' ') { json++; } else if (*json == '\t') { json++; // Whitespace characters. } else if (*json == '\r') { json++; } else if (*json == '\n') { json++; } else if (*json == '/' && json[1] == '/') while (*json && *json != '\n') { json++; // double-slash comments, to end of line. } else if (*json == '/' && json[1] == '*') { while (*json && !(*json == '*' && json[1] == '/')) { json++; // multiline comments. } json += 2; } else if (*json == '\"') { *into++ = *json++; // string literals, which are \" sensitive. while (*json && *json != '\"') { if (*json == '\\') { *into++ = *json++; }*into++ = *json++; }*into++ = *json++; } else { *into++ = *json++; // All other characters. } } *into = 0; // and null-terminate. } ================================================ FILE: app/libc/Makefile ================================================ ############################################################# # Required variables for each makefile # Discard this section from all parent makefiles # Expected variables (with automatic defaults): # CSRCS (all "C" files in the dir) # SUBDIRS (all subdirs with a Makefile) # GEN_LIBS - list of libs to be generated () # GEN_IMAGES - list of images to be generated () # COMPONENTS_xxx - a list of libs/objs in the form # subdir/lib to be extracted and rolled up into # a generated lib/image xxx.a () # ifndef PDIR GEN_LIBS = liblibc.a endif ############################################################# # Configuration i.e. compile options etc. # Target specific stuff (defines etc.) goes in here! # Generally values applying to a tree are captured in the # makefile at its root level - these are then overridden # for a subtree within the makefile rooted therein # #DEFINES += ############################################################# # Recursion Magic - Don't touch this!! # # Each subtree potentially has an include directory # corresponding to the common APIs applicable to modules # rooted at that subtree. Accordingly, the INCLUDE PATH # of a module can only contain the include directories up # its parent path, and not its siblings # # Required for each makefile to inherit from the parent # INCLUDES := $(INCLUDES) -I $(PDIR)include INCLUDES += -I ./ INCLUDES += -I ../wofs PDIR := ../$(PDIR) sinclude $(PDIR)Makefile ================================================ FILE: app/libc/c_ctype.c ================================================ #include "c_ctype.h" #include "c_types.h" // int isalnum(int c){} // int isalpha(int c){} // int iscntrl(int c){} // int isdigit(int c){} // // int isgraph(int c){} // int islower(int c){} // int isprint(int c){} // int ispunct(int c){} // int isspace(int c){} // int isupper(int c){} // int isxdigit(int c){} // int tolower(int c){} // int toupper(int c){} ================================================ FILE: app/libc/c_ctype.h ================================================ #ifndef _C_CTYPE_H_ #define _C_CTYPE_H_ #if 0 int isalnum(int); int isalpha(int); int iscntrl(int); int isdigit(int); // int isgraph(int); int islower(int); int isprint(int); int ispunct(int); int isspace(int); int isupper(int); int isxdigit(int); int tolower(int); int toupper(int); #if !defined(__STRICT_ANSI__) || defined(__cplusplus) || __STDC_VERSION__ >= 199901L // int isblank(int); #endif #ifndef __STRICT_ANSI__ // int isascii(int); // int toascii(int); #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 /* For C++ backward-compatibility only. */ // extern char _ctype_[]; #endif #endif /* _C_CTYPE_H_ */ ================================================ FILE: app/libc/c_errno.h ================================================ #ifndef __c_errno_h #define __c_errno_h #include // #ifndef errno // extern int errno; // #endif // #define EDOM 1 // #define ERANGE 2 // #define EILSEQ 4 // #define ESIGNUM 3 // #define EINVAL 5 // #define ENOMEM 6 #endif /* end of c_errno.h */ ================================================ FILE: app/libc/c_fcntl.h ================================================ #ifndef __c_fcntl_h #define __c_fcntl_h #include #endif /* end of c_fcntl.h */ ================================================ FILE: app/libc/c_limits.h ================================================ #ifndef __c_limits_h #define __c_limits_h #include #if 0 #define CHAR_BIT 8 /* max number of bits for smallest object that is not a bit-field (byte) */ #define SCHAR_MIN (-128) /* mimimum value for an object of type signed char */ #define SCHAR_MAX 127 /* maximum value for an object of type signed char */ #define UCHAR_MAX 255 /* maximum value for an object of type unsigned char */ #ifdef __FEATURE_SIGNED_CHAR #define CHAR_MIN (-128) /* minimum value for an object of type char */ #define CHAR_MAX 127 /* maximum value for an object of type char */ #else #define CHAR_MIN 0 /* minimum value for an object of type char */ #define CHAR_MAX 255 /* maximum value for an object of type char */ #endif #define SHRT_MIN (-0x8000) /* minimum value for an object of type short int */ #define SHRT_MAX 0x7fff /* maximum value for an object of type short int */ #define USHRT_MAX 65535 /* maximum value for an object of type unsigned short int */ #define INT_MIN (~0x7fffffff) /* -2147483648 and 0x80000000 are unsigned */ /* minimum value for an object of type int */ #define INT_MAX 0x7fffffff /* maximum value for an object of type int */ #define UINT_MAX 0xffffffffU /* maximum value for an object of type unsigned int */ #define LONG_MIN (~0x7fffffffL) /* minimum value for an object of type long int */ #define LONG_MAX 0x7fffffffL /* maximum value for an object of type long int */ #define ULONG_MAX 0xffffffffUL /* maximum value for an object of type unsigned long int */ #if !defined(__STRICT_ANSI__) || (defined(__STDC_VERSION__) && 199901L <= __STDC_VERSION__) #define LLONG_MIN (~0x7fffffffffffffffLL) /* minimum value for an object of type long long int */ #define LLONG_MAX 0x7fffffffffffffffLL /* maximum value for an object of type long long int */ #define ULLONG_MAX 0xffffffffffffffffULL /* maximum value for an object of type unsigned long int */ #endif #endif #endif /* end of c_limits.h */ ================================================ FILE: app/libc/c_locale.h ================================================ /* c_locale.h Values appropriate for the formatting of monetary and other numberic quantities. */ #ifndef _C_LOCALE_H_ #define _C_LOCALE_H_ #include #if 0 #ifndef NULL #define NULL 0 #endif #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 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 *setlocale(int category, const char *locale); struct lconv *localeconv(void); #endif // struct _reent; // char *_setlocale_r(struct _reent *, int category, const char *locale); // struct lconv *_localeconv_r(struct _reent *); #endif #endif /* _C_LOCALE_H_ */ ================================================ FILE: app/libc/c_math.c ================================================ #include "c_math.h" #include "c_types.h" double floor(double x) { return (double) (x < 0.f ? (((int) x) - 1) : ((int) x)); } double pow(double x, double y) { #define MAXEXP 2031 /* (MAX_EXP * 16) - 1 */ #define MINEXP -2047 /* (MIN_EXP * 16) - 1 */ #define HUGE MAXFLOAT double a1[] = { 1.0, 0.95760328069857365, 0.91700404320467123, 0.87812608018664974, 0.84089641525371454, 0.80524516597462716, 0.77110541270397041, 0.73841307296974966, 0.70710678118654752, 0.67712777346844637, 0.64841977732550483, 0.62092890603674203, 0.59460355750136054, 0.56939431737834583, 0.54525386633262883, 0.52213689121370692, 0.50000000000000000 }; double a2[] = { 0.24114209503420288E-17, 0.92291566937243079E-18, -0.15241915231122319E-17, -0.35421849765286817E-17, -0.31286215245415074E-17, -0.44654376565694490E-17, 0.29306999570789681E-17, 0.11260851040933474E-17 }; double p1 = 0.833333333333332114e-1; double p2 = 0.125000000005037992e-1; double p3 = 0.223214212859242590e-2; double p4 = 0.434457756721631196e-3; double q1 = 0.693147180559945296e0; double q2 = 0.240226506959095371e0; double q3 = 0.555041086640855953e-1; double q4 = 0.961812905951724170e-2; double q5 = 0.133335413135857847e-2; double q6 = 0.154002904409897646e-3; double q7 = 0.149288526805956082e-4; double k = 0.442695040888963407; double frexp(), g, ldexp(), r, u1, u2, v, w, w1, w2, y1, y2, z; int iw1, m, p; if (y == 0.0) return (1.0); if (x <= 0.0) { if (x == 0.0) { if (y > 0.0) return (x); //cmemsg(FP_POWO, &y); //return(HUGE); } else { //cmemsg(FP_POWN, &x); x = -x; } } g = frexp(x, &m); p = 0; if (g <= a1[8]) p = 8; if (g <= a1[p + 4]) p += 4; if (g <= a1[p + 2]) p += 2; p++; z = ((g - a1[p]) - a2[p / 2]) / (g + a1[p]); z += z; v = z * z; r = (((p4 * v + p3) * v + p2) * v + p1) * v * z; r += k * r; u2 = (r + z * k) + z; u1 = 0.0625 * (double)(16 * m - p); y1 = 0.0625 * (double)((int)(16.0 * y)); y2 = y - y1; w = u2 * y + u1 * y2; w1 = 0.0625 * (double)((int)(16.0 * w)); w2 = w - w1; w = w1 + u1 * y1; w1 = 0.0625 * (double)((int)(16.0 * w)); w2 += (w - w1); w = 0.0625 * (double)((int)(16.0 * w2)); iw1 = 16.0 * (w1 + w); w2 -= w; while (w2 > 0.0) { iw1++; w2 -= 0.0625; } if (iw1 > MAXEXP) { //cmemsg(FP_POWO, &y); return (HUGE); } if (iw1 < MINEXP) { //cmemsg(FP_POWU, &y); return (0.0); } m = iw1 / 16; if (iw1 >= 0) m++; p = 16 * m - iw1; z = ((((((q7 * w2 + q6) * w2 + q5) * w2 + q4) * w2 + q3) * w2 + q2) * w2 + q1) * w2; z = a1[p] + a1[p] * z; return (ldexp(z, m)); } #if 0 #ifndef __math_68881 double atan(double x) { return x; } double cos(double x) { return x; } double sin(double x) { return x; } double tan(double x) { return x; } double tanh(double x) { return x; } double frexp(double x, int *y) { return x; } double modf(double x, double *y) { return x; } double ceil(double x) { return x; } double fabs(double x) { return x; } double floor(double x) { return x; } #endif /* ! defined (__math_68881) */ /* Non reentrant ANSI C functions. */ #ifndef _REENT_ONLY #ifndef __math_68881 double acos(double x) { return x; } double asin(double x) { return x; } double atan2(double x, double y) { return x; } double cosh(double x) { return x; } double sinh(double x) { return x; } double exp(double x) { return x; } double ldexp(double x, int y) { return x; } double log(double x) { return x; } double log10(double x) { return x; } double pow(double x, double y) { return x; } double sqrt(double x) { return x; } double fmod(double x, double y) { return x; } #endif /* ! defined (__math_68881) */ #endif /* ! defined (_REENT_ONLY) */ #endif ================================================ FILE: app/libc/c_math.h ================================================ #ifndef _C_MATH_H_ #define _C_MATH_H_ #include double floor(double); double pow(double, double); #if 0 #ifndef HUGE_VAL #define HUGE_VAL (1.0e99) #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 /* Reentrant ANSI C functions. */ #ifndef __math_68881 // double atan(double); // double cos(double); // double sin(double); // double tan(double); // double tanh(double); // double frexp(double, int *); // double modf(double, double *); // double ceil(double); // double fabs(double); // double floor(double); #endif /* ! defined (__math_68881) */ /* Non reentrant ANSI C functions. */ #ifndef _REENT_ONLY #ifndef __math_68881 // double acos(double); // double asin(double); // double atan2(double, double); // double cosh(double); // double sinh(double); // double exp(double); // double ldexp(double, int); // double log(double); // double log10(double); // double pow(double, double); // double sqrt(double); // double fmod(double, double); #endif /* ! defined (__math_68881) */ #endif /* ! defined (_REENT_ONLY) */ #endif #endif /* _MATH_H_ */ ================================================ FILE: app/libc/c_signal.h ================================================ #ifndef _C_SIGNAL_H_ #define _C_SIGNAL_H_ #include #endif /* _C_SIGNAL_H_ */ ================================================ FILE: app/libc/c_stdarg.h ================================================ #ifndef __c_stdarg_h #define __c_stdarg_h #if defined(__GNUC__) #include #else typedef char * va_list; #define _INTSIZEOF(n) ((sizeof(n) + sizeof(int) - 1) & ~(sizeof(int) - 1)) #define va_start(ap,v) (ap = (va_list)&v + _INTSIZEOF(v)) #define va_arg(ap,t) (*(t *)((ap += _INTSIZEOF(t)) - _INTSIZEOF(t))) #define va_end(ap) (ap = (va_list)0) #endif #endif /* end of c_stdarg.h */ ================================================ FILE: app/libc/c_stddef.h ================================================ #ifndef __c_stddef_h #define __c_stddef_h typedef signed int ptrdiff_t; #if !defined(offsetof) #define offsetof(s, m) (size_t)&(((s *)0)->m) #endif #if !defined(__size_t) #define __size_t 1 typedef unsigned int size_t; /* others (e.g. ) also define */ /* the unsigned integral type of the result of the sizeof operator. */ #endif #undef NULL /* others (e.g. ) also define */ #define NULL 0 /* null pointer constant. */ #endif /* end of c_stddef.h */ ================================================ FILE: app/libc/c_stdint.h ================================================ #ifndef __c_stdint_h #define __c_stdint_h #include "c_types.h" #if 0 /* * Depending on compiler version __int64 or __INT64_TYPE__ should be defined. */ #ifndef __int64 #ifdef __INT64_TYPE__ #define __int64 __INT64_TYPE__ #else #define __int64 long long #endif /* On some architectures neither of these may be defined - if so, fall through and error out if used. */ #endif #ifndef __STDINT_DECLS #define __STDINT_DECLS #undef __CLIBNS #ifdef __cplusplus namespace std { #define __CLIBNS std:: extern "C" { #else #define __CLIBNS #endif /* __cplusplus */ /* * 'signed' is redundant below, except for 'signed char' and if * the typedef is used to declare a bitfield. * '__int64' is used instead of 'long long' so that this header * can be used in --strict mode. */ /* 7.18.1.1 */ /* exact-width signed integer types */ typedef signed char int8_t; typedef signed short int int16_t; typedef signed int int32_t; typedef signed __int64 int64_t; /* exact-width unsigned integer types */ typedef unsigned char uint8_t; typedef unsigned short int uint16_t; typedef unsigned int uint32_t; typedef unsigned __int64 uint64_t; /* 7.18.1.2 */ /* smallest type of at least n bits */ /* minimum-width signed integer types */ typedef signed char int_least8_t; typedef signed short int int_least16_t; typedef signed int int_least32_t; typedef signed __int64 int_least64_t; /* minimum-width unsigned integer types */ typedef unsigned char uint_least8_t; typedef unsigned short int uint_least16_t; typedef unsigned int uint_least32_t; typedef unsigned __int64 uint_least64_t; /* 7.18.1.3 */ /* fastest minimum-width signed integer types */ typedef signed int int_fast8_t; typedef signed int int_fast16_t; typedef signed int int_fast32_t; typedef signed __int64 int_fast64_t; /* fastest minimum-width unsigned integer types */ typedef unsigned int uint_fast8_t; typedef unsigned int uint_fast16_t; typedef unsigned int uint_fast32_t; typedef unsigned __int64 uint_fast64_t; /* 7.18.1.4 integer types capable of holding object pointers */ typedef signed int intptr_t; typedef unsigned int uintptr_t; /* 7.18.1.5 greatest-width integer types */ typedef signed __int64 intmax_t; typedef unsigned __int64 uintmax_t; #if !defined(__cplusplus) || defined(__STDC_LIMIT_MACROS) /* 7.18.2.1 */ /* minimum values of exact-width signed integer types */ #define INT8_MIN -128 #define INT16_MIN -32768 #define INT32_MIN (~0x7fffffff) /* -2147483648 is unsigned */ #define INT64_MIN __ESCAPE__(~0x7fffffffffffffffll) /* -9223372036854775808 is unsigned */ /* maximum values of exact-width signed integer types */ #define INT8_MAX 127 #define INT16_MAX 32767 #define INT32_MAX 2147483647 #define INT64_MAX __ESCAPE__(9223372036854775807ll) /* maximum values of exact-width unsigned integer types */ #define UINT8_MAX 255 #define UINT16_MAX 65535 #define UINT32_MAX 4294967295u #define UINT64_MAX __ESCAPE__(18446744073709551615ull) /* 7.18.2.2 */ /* minimum values of minimum-width signed integer types */ #define INT_LEAST8_MIN -128 #define INT_LEAST16_MIN -32768 #define INT_LEAST32_MIN (~0x7fffffff) #define INT_LEAST64_MIN __ESCAPE__(~0x7fffffffffffffffll) /* maximum values of minimum-width signed integer types */ #define INT_LEAST8_MAX 127 #define INT_LEAST16_MAX 32767 #define INT_LEAST32_MAX 2147483647 #define INT_LEAST64_MAX __ESCAPE__(9223372036854775807ll) /* maximum values of minimum-width unsigned integer types */ #define UINT_LEAST8_MAX 255 #define UINT_LEAST16_MAX 65535 #define UINT_LEAST32_MAX 4294967295u #define UINT_LEAST64_MAX __ESCAPE__(18446744073709551615ull) /* 7.18.2.3 */ /* minimum values of fastest minimum-width signed integer types */ #define INT_FAST8_MIN (~0x7fffffff) #define INT_FAST16_MIN (~0x7fffffff) #define INT_FAST32_MIN (~0x7fffffff) #define INT_FAST64_MIN __ESCAPE__(~0x7fffffffffffffffll) /* maximum values of fastest minimum-width signed integer types */ #define INT_FAST8_MAX 2147483647 #define INT_FAST16_MAX 2147483647 #define INT_FAST32_MAX 2147483647 #define INT_FAST64_MAX __ESCAPE__(9223372036854775807ll) /* maximum values of fastest minimum-width unsigned integer types */ #define UINT_FAST8_MAX 4294967295u #define UINT_FAST16_MAX 4294967295u #define UINT_FAST32_MAX 4294967295u #define UINT_FAST64_MAX __ESCAPE__(18446744073709551615ull) /* 7.18.2.4 */ /* minimum value of pointer-holding signed integer type */ #define INTPTR_MIN (~0x7fffffff) /* maximum value of pointer-holding signed integer type */ #define INTPTR_MAX 2147483647 /* maximum value of pointer-holding unsigned integer type */ #define UINTPTR_MAX 4294967295u /* 7.18.2.5 */ /* minimum value of greatest-width signed integer type */ #define INTMAX_MIN __ESCAPE__(~0x7fffffffffffffffll) /* maximum value of greatest-width signed integer type */ #define INTMAX_MAX __ESCAPE__(9223372036854775807ll) /* maximum value of greatest-width unsigned integer type */ #define UINTMAX_MAX __ESCAPE__(18446744073709551615ull) /* 7.18.3 */ /* limits of ptrdiff_t */ #define PTRDIFF_MIN (~0x7fffffff) #define PTRDIFF_MAX 2147483647 /* limits of sig_atomic_t */ #define SIG_ATOMIC_MIN (~0x7fffffff) #define SIG_ATOMIC_MAX 2147483647 /* limit of size_t */ #define SIZE_MAX 4294967295u /* limits of wchar_t */ /* NB we have to undef and redef because they're defined in both * stdint.h and wchar.h */ #undef WCHAR_MIN #undef WCHAR_MAX #if defined(__WCHAR32) || (defined(__ARM_SIZEOF_WCHAR_T) && __ARM_SIZEOF_WCHAR_T == 4) #define WCHAR_MIN 0 #define WCHAR_MAX 0xffffffffU #else #define WCHAR_MIN 0 #define WCHAR_MAX 65535 #endif /* limits of wint_t */ #define WINT_MIN (~0x7fffffff) #define WINT_MAX 2147483647 #endif /* __STDC_LIMIT_MACROS */ #if !defined(__cplusplus) || defined(__STDC_CONSTANT_MACROS) /* 7.18.4.1 macros for minimum-width integer constants */ #define INT8_C(x) (x) #define INT16_C(x) (x) #define INT32_C(x) (x) #define INT64_C(x) __ESCAPE__(x ## ll) #define UINT8_C(x) (x ## u) #define UINT16_C(x) (x ## u) #define UINT32_C(x) (x ## u) #define UINT64_C(x) __ESCAPE__(x ## ull) /* 7.18.4.2 macros for greatest-width integer constants */ #define INTMAX_C(x) __ESCAPE__(x ## ll) #define UINTMAX_C(x) __ESCAPE__(x ## ull) #endif /* __STDC_CONSTANT_MACROS */ #ifdef __cplusplus } /* extern "C" */ } /* namespace std */ #endif /* __cplusplus */ #endif /* __STDINT_DECLS */ #ifdef __cplusplus #ifndef __STDINT_NO_EXPORTS using ::std::int8_t; using ::std::int16_t; using ::std::int32_t; using ::std::int64_t; using ::std::uint8_t; using ::std::uint16_t; using ::std::uint32_t; using ::std::uint64_t; using ::std::int_least8_t; using ::std::int_least16_t; using ::std::int_least32_t; using ::std::int_least64_t; using ::std::uint_least8_t; using ::std::uint_least16_t; using ::std::uint_least32_t; using ::std::uint_least64_t; using ::std::int_fast8_t; using ::std::int_fast16_t; using ::std::int_fast32_t; using ::std::int_fast64_t; using ::std::uint_fast8_t; using ::std::uint_fast16_t; using ::std::uint_fast32_t; using ::std::uint_fast64_t; using ::std::intptr_t; using ::std::uintptr_t; using ::std::intmax_t; using ::std::uintmax_t; #endif #endif /* __cplusplus */ #endif #endif /* __c_stdint_h */ /* end of c_stdint.h */ ================================================ FILE: app/libc/c_stdio.c ================================================ #include "c_stdio.h" #include "c_types.h" // #include "driver/uart.h" int c_stdin = 999; int c_stdout = 1000; int c_stderr = 1001; /* File: printf.c Copyright (c) 2004,2012 Kustaa Nyholm / SpareTimeLabs 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 Kustaa Nyholm or SpareTimeLabs 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. ---------------------------------------------------------------------- This library is realy just two files: 'printf.h' and 'printf.c'. They provide a simple and small (+200 loc) printf functionality to be used in embedded systems. I've found them so usefull in debugging that I do not bother with a debugger at all. They are distributed in source form, so to use them, just compile them into your project. Two printf variants are provided: printf and sprintf. The formats supported by this implementation are: 'd' 'u' 'c' 's' 'x' 'X'. Zero padding and field width are also supported. If the library is compiled with 'PRINTF_SUPPORT_LONG' defined then the long specifier is also supported. Note that this will pull in some long math routines (pun intended!) and thus make your executable noticably longer. The memory foot print of course depends on the target cpu, compiler and compiler options, but a rough guestimate (based on a H8S target) is about 1.4 kB for code and some twenty 'int's and 'char's, say 60 bytes of stack space. Not too bad. Your milage may vary. By hacking the source code you can get rid of some hunred bytes, I'm sure, but personally I feel the balance of functionality and flexibility versus code size is close to optimal for many embedded systems. To use the printf you need to supply your own character output function, something like : void putc ( void* p, char c) { while (!SERIAL_PORT_EMPTY) ; SERIAL_PORT_TX_REGISTER = c; } Before you can call printf you need to initialize it to use your character output function with something like: init_printf(NULL,putc); Notice the 'NULL' in 'init_printf' and the parameter 'void* p' in 'putc', the NULL (or any pointer) you pass into the 'init_printf' will eventually be passed to your 'putc' routine. This allows you to pass some storage space (or anything realy) to the character output function, if necessary. This is not often needed but it was implemented like that because it made implementing the sprintf function so neat (look at the source code). The code is re-entrant, except for the 'init_printf' function, so it is safe to call it from interupts too, although this may result in mixed output. If you rely on re-entrancy, take care that your 'putc' function is re-entrant! The printf and sprintf functions are actually macros that translate to 'tfp_printf' and 'tfp_sprintf'. This makes it possible to use them along with 'stdio.h' printf's in a single source file. You just need to undef the names before you include the 'stdio.h'. Note that these are not function like macros, so if you have variables or struct members with these names, things will explode in your face. Without variadic macros this is the best we can do to wrap these fucnction. If it is a problem just give up the macros and use the functions directly or rename them. For further details see source code. regs Kusti, 23.10.2004 */ /* Add lightweight %g support by vowstar, NodeMCU Team, 26.1.2015 */ typedef void (*putcf) (void *, char); #ifdef PRINTF_LONG_SUPPORT static int uli2a(unsigned long int num, unsigned int base, int uc, char *bf) { int n = 0; unsigned long int d = 1; int len = 1; while (num / d >= base) { d *= base; len ++; } while (d != 0) { int dgt = num / d; num %= d; d /= base; if (n || dgt > 0 || d == 0) { *bf++ = dgt + (dgt < 10 ? '0' : (uc ? 'A' : 'a') - 10); ++n; } } *bf = 0; return len; } static int li2a (long num, char *bf) { int len = 0; if (num < 0) { num = -num; *bf++ = '-'; len ++; } len += uli2a(num, 10, 0, bf); return len; } #endif static int ui2a(unsigned int num, unsigned int base, int uc, char *bf) { int n = 0; unsigned int d = 1; int len = 1; while (num / d >= base) { d *= base; len ++; } while (d != 0) { int dgt = num / d; num %= d; d /= base; if (n || dgt > 0 || d == 0) { *bf++ = dgt + (dgt < 10 ? '0' : (uc ? 'A' : 'a') - 10); ++n; } } *bf = 0; return len; } static int i2a (int num, char *bf) { int len = 0; if (num < 0) { num = -num; *bf++ = '-'; len ++; } len += ui2a(num, 10, 0, bf); return len; } // Converts a floating point number to string. static int d2a(double num, char *bf) { int len = 0; double ipart = 0; double fpart = 0; double absnum = num; // Add sign if (absnum < 0) { absnum = -absnum; *bf++ = '-'; // len must add 1 when return // but can't add at here } // Extract integer part ipart = (int)absnum; // Extract floating part fpart = absnum - (double)ipart; // convert integer part to string #ifdef PRINTF_LONG_SUPPORT len += li2a(ipart, bf); #else len += i2a(ipart, bf); #endif #ifndef EPSILON #define EPSILON ((double)(0.00000001)) #endif if (fpart < EPSILON) { // fpart is zero } else { bf += len; // add dot *bf ++ = '.'; len += 1; // add zero after dot while (fpart < 0.1) { fpart *= 10; *bf ++ = '0'; len += 1; } while ((fpart < (double)1.0 / EPSILON) && ((fpart - (int)fpart) > EPSILON)) { fpart = fpart * 10; } #ifdef PRINTF_LONG_SUPPORT len += li2a((int)fpart, bf); #else len += i2a((int)fpart, bf); #endif } #undef EPSILON if (num < 0) { len ++; } return len; } int a2d(char ch) { if (ch >= '0' && ch <= '9') return ch - '0'; else if (ch >= 'a' && ch <= 'f') return ch - 'a' + 10; else if (ch >= 'A' && ch <= 'F') return ch - 'A' + 10; else return -1; } char a2i(char ch, char **src, int base, int *nump) { char *p = *src; int num = 0; int digit; while ((digit = a2d(ch)) >= 0) { if (digit > base) break; num = num * base + digit; ch = *p++; } *src = p; *nump = num; return ch; } static void putchw(void *putp, putcf putf, int n, char z, char *bf) { char fc = z ? '0' : ' '; char ch; char *p = bf; while (*p++ && n > 0) n--; while (n-- > 0) putf(putp, fc); while ((ch = *bf++)) putf(putp, ch); } void c_format(void *putp, putcf putf, char *fmt, va_list va) { char bf[12]; char ch; while ((ch = *(fmt++))) { if (ch != '%') putf(putp, ch); else { char lz = 0; #ifdef PRINTF_LONG_SUPPORT char lng = 0; #endif int w = 0; ch = *(fmt++); if (ch == '0') { ch = *(fmt++); lz = 1; } if (ch >= '0' && ch <= '9') { ch = a2i(ch, &fmt, 10, &w); } #ifdef PRINTF_LONG_SUPPORT if (ch == 'l') { ch = *(fmt++); lng = 1; } #endif switch (ch) { case 0: goto abort; case 'u' : { #ifdef PRINTF_LONG_SUPPORT if (lng) uli2a(va_arg(va, unsigned long int), 10, 0, bf); else #endif ui2a(va_arg(va, unsigned int), 10, 0, bf); putchw(putp, putf, w, lz, bf); break; } case 'o' : { #ifdef PRINTF_LONG_SUPPORT if (lng) uli2a(va_arg(va, unsigned long int), 8, 0, bf); else #endif ui2a(va_arg(va, unsigned int), 8, 0, bf); putchw(putp, putf, w, lz, bf); break; } case 'd' : case 'i': { #ifdef PRINTF_LONG_SUPPORT if (lng) li2a(va_arg(va, unsigned long int), bf); else #endif i2a(va_arg(va, int), bf); putchw(putp, putf, w, lz, bf); break; } case 'x': case 'X' : #ifdef PRINTF_LONG_SUPPORT if (lng) uli2a(va_arg(va, unsigned long int), 16, (ch == 'X'), bf); else #endif ui2a(va_arg(va, unsigned int), 16, (ch == 'X'), bf); putchw(putp, putf, w, lz, bf); break; case 'e': case 'E': case 'f': case 'g': case 'G': { d2a(va_arg(va, double), bf); putchw(putp, putf, w, lz, bf); break; } case 'c' : putf(putp, (char)(va_arg(va, int))); break; case 's' : putchw(putp, putf, w, 0, va_arg(va, char *)); break; case '%' : putf(putp, ch); default: break; } } } abort:; } static void putcp(void *p, char c) { *(*((char **)p))++ = c; } void c_sprintf(char *s, char *fmt, ...) { va_list va; va_start(va, fmt); c_format(&s, putcp, fmt, va); putcp(&s, 0); va_end(va); } void nprintf(const char *s,size_t size) { char str[2]; str[1]=0; int i; for(i=0;i0?x:0-x; // } // void c_exit(int e){ // } // make sure there is enough memory before real malloc, otherwise malloc will panic and reset // void *c_malloc(size_t __size){ // if(__size>system_get_free_heap_size()){ // NODE_ERR("malloc: not enough memory\n"); // return NULL; // } // return (void *)os_malloc(__size); // } // void *c_zalloc(size_t __size){ // if(__size>system_get_free_heap_size()){ // NODE_ERR("zalloc: not enough memory\n"); // return NULL; // } // return (void *)os_zalloc(__size); // } // void c_free(void *p){ // // NODE_ERR("free1: %d\n", system_get_free_heap_size()); // os_free(p); // // NODE_ERR("-free1: %d\n", system_get_free_heap_size()); // } // int c_rand(void){ // } // void c_srand(unsigned int __seed){ // } // int c_atoi(const char *__nptr){ // } #include <_ansi.h> //#include #include //#include "mprec.h" double c_strtod(const char *string, char **endPtr) { int maxExponent = 511; /* Largest possible base 10 exponent. Any * exponent larger than this will already * produce underflow or overflow, so there's * no need to worry about additional digits. */ double powersOf10[] = { /* Table giving binary powers of 10. Entry */ 10., /* is 10^2^i. Used to convert decimal */ 100., /* exponents into floating-point numbers. */ 1.0e4, 1.0e8, 1.0e16, 1.0e32, 1.0e64, 1.0e128, 1.0e256 }; int sign, expSign = FALSE; double fraction, dblExp, *d; register const char *p; register int c; int exp = 0; /* Exponent read from "EX" field. */ int fracExp = 0; /* Exponent that derives from the fractional * part. Under normal circumstatnces, it is * the negative of the number of digits in F. * However, if I is very long, the last digits * of I get dropped (otherwise a long I with a * large negative exponent could cause an * unnecessary overflow on I alone). In this * case, fracExp is incremented one for each * dropped digit. */ int mantSize; /* Number of digits in mantissa. */ int decPt; /* Number of mantissa digits BEFORE decimal * point. */ const char *pExp; /* Temporarily holds location of exponent * in string. */ /* * Strip off leading blanks and check for a sign. */ p = string; while (isspace((unsigned char)(*p))) { p += 1; } if (*p == '-') { sign = TRUE; p += 1; } else { if (*p == '+') { p += 1; } sign = FALSE; } /* * Count the number of digits in the mantissa (including the decimal * point), and also locate the decimal point. */ decPt = -1; for (mantSize = 0; ; mantSize += 1) { c = *p; if (!isdigit(c)) { if ((c != '.') || (decPt >= 0)) { break; } decPt = mantSize; } p += 1; } /* * Now suck up the digits in the mantissa. Use two integers to * collect 9 digits each (this is faster than using floating-point). * If the mantissa has more than 18 digits, ignore the extras, since * they can't affect the value anyway. */ pExp = p; p -= mantSize; if (decPt < 0) { decPt = mantSize; } else { mantSize -= 1; /* One of the digits was the point. */ } if (mantSize > 18) { fracExp = decPt - 18; mantSize = 18; } else { fracExp = decPt - mantSize; } if (mantSize == 0) { fraction = 0.0; p = string; goto done; } else { int frac1, frac2; frac1 = 0; for ( ; mantSize > 9; mantSize -= 1) { c = *p; p += 1; if (c == '.') { c = *p; p += 1; } frac1 = 10*frac1 + (c - '0'); } frac2 = 0; for (; mantSize > 0; mantSize -= 1) { c = *p; p += 1; if (c == '.') { c = *p; p += 1; } frac2 = 10*frac2 + (c - '0'); } fraction = (1.0e9 * frac1) + frac2; } /* * Skim off the exponent. */ p = pExp; if ((*p == 'E') || (*p == 'e')) { p += 1; if (*p == '-') { expSign = TRUE; p += 1; } else { if (*p == '+') { p += 1; } expSign = FALSE; } if (!isdigit((unsigned char)(*p))) { p = pExp; goto done; } while (isdigit((unsigned char)(*p))) { exp = exp * 10 + (*p - '0'); p += 1; } } if (expSign) { exp = fracExp - exp; } else { exp = fracExp + exp; } /* * Generate a floating-point number that represents the exponent. * Do this by processing the exponent one bit at a time to combine * many powers of 2 of 10. Then combine the exponent with the * fraction. */ if (exp < 0) { expSign = TRUE; exp = -exp; } else { expSign = FALSE; } if (exp > maxExponent) { exp = maxExponent; // errno = ERANGE; } dblExp = 1.0; for (d = powersOf10; exp != 0; exp >>= 1, d += 1) { if (exp & 01) { dblExp *= *d; } } if (expSign) { fraction /= dblExp; } else { fraction *= dblExp; } done: if (endPtr != NULL) { *endPtr = (char *) p; } if (sign) { return -fraction; } return fraction; } // long c_strtol(const char *__n, char **__end_PTR, int __base){ // } // unsigned long c_strtoul(const char *__n, char **__end_PTR, int __base){ // } // long long c_strtoll(const char *__n, char **__end_PTR, int __base){ // } ================================================ FILE: app/libc/c_stdlib.h ================================================ /* * c_stdlib.h * * Definitions for common types, variables, and functions. */ #ifndef _C_STDLIB_H_ #define _C_STDLIB_H_ #include "c_stddef.h" #include "mem.h" #define EXIT_FAILURE 1 #define EXIT_SUCCESS 0 #define __INT_MAX__ 2147483647 #undef __RAND_MAX #if __INT_MAX__ == 32767 #define __RAND_MAX 32767 #else #define __RAND_MAX 0x7fffffff #endif #define RAND_MAX __RAND_MAX #ifndef mem_realloc #define mem_realloc pvPortRealloc #endif #ifndef os_realloc #define os_realloc(p, s) mem_realloc((p), (s)) #endif // #define c_free os_free // #define c_malloc os_malloc // #define c_zalloc os_zalloc #define c_realloc os_realloc #define c_abs abs #define c_atoi atoi //#define c_strtod strtod #define c_strtol strtol #define c_strtoul strtoul // int c_abs(int); // void c_exit(int); // c_getenv() get env "LUA_INIT" string for lua initialization. const char *c_getenv(const char *__string); // int c_rand(void); // void c_srand(unsigned int __seed); // int c_atoi(const char *__nptr); double c_strtod(const char *__n, char **__end_PTR); // // long c_strtol(const char *__n, char **__end_PTR, int __base); // unsigned long c_strtoul(const char *__n, char **__end_PTR, int __base); // // long long c_strtoll(const char *__n, char **__end_PTR, int __base); #endif /* _C_STDLIB_H_ */ ================================================ FILE: app/libc/c_string.c ================================================ #include "c_string.h" char* itoa(int i, char b[]) // Convert Integer to ASCII!! { char const digit[] = "0123456789"; char* p = b; if(i<0){ *p++ = '-'; i *= -1; } int shifter = i; do{ //Move to where representation ends ++p; shifter = shifter/10; }while(shifter); *p = '\0'; do{ //Move back, inserting digits as u go *--p = digit[i%10]; i = i/10; }while(i); return b; } char * os_strcati(char *dest,int i){ char * p = dest; while(*p!='\0') p++; itoa(i,p); p++; *p='\0'; return dest; } // #define _tolower(__c) ((unsigned char)(__c) - 'A' + 'a') // #define _toupper(__c) ((unsigned char)(__c) - 'a' + 'A') // int tolower(int c){ // if(isupper(c)) // return _tolower(c); // else // return c; // } int os_strcasecmp(const char *s1, const char *s2) { while (tolower(*s1++) == tolower(*s2++)) { if (*s1 == '\0') { return 0; } } return *(unsigned char *)s1 - *(unsigned char *)(s2 - 1); } // const char *c_strstr(const char * __s1, const char * __s2){ // } // char *c_strncat(char * s1, const char * s2, size_t n){ // } // size_t c_strcspn(const char * s1, const char * s2){ // } // const char *c_strpbrk(const char * s1, const char * s2){ // } // int c_strcoll(const char * s1, const char * s2){ // } ================================================ FILE: app/libc/c_string.h ================================================ /* * c_string.h * * Definitions for memory and string functions. */ #ifndef _C_STRING_H_ #define _C_STRING_H_ #include "c_stddef.h" #include "osapi.h" #ifndef NULL #define NULL 0 #endif #define c_memcmp os_memcmp #define c_memcpy os_memcpy #define c_memset os_memset #define c_strcat os_strcat #define c_strchr os_strchr #define c_strcmp os_strcmp #define c_strcpy os_strcpy #define c_strlen os_strlen #define c_strncmp os_strncmp #define c_strncpy os_strncpy // #define c_strstr os_strstr #define c_strncasecmp c_strcmp #define c_strstr strstr #define c_strncat strncat #define c_strcspn strcspn #define c_strpbrk strpbrk #define c_strcoll strcoll #define c_strrchr strrchr char* itoa(int i, char b[]); // Convert Integer to ASCII!! char * os_strcati(char *dest,int i); int os_strcasecmp(const char *s1, const char *s2); // const char *c_strstr(const char * __s1, const char * __s2); // char *c_strncat(char * __restrict /*s1*/, const char * __restrict /*s2*/, size_t n); // size_t c_strcspn(const char * s1, const char * s2); // const char *c_strpbrk(const char * /*s1*/, const char * /*s2*/); // int c_strcoll(const char * /*s1*/, const char * /*s2*/); #endif /* _C_STRING_H_ */ ================================================ FILE: app/lwip/Makefile ================================================ ############################################################# # Required variables for each makefile # Discard this section from all parent makefiles # Expected variables (with automatic defaults): # CSRCS (all "C" files in the dir) # SUBDIRS (all subdirs with a Makefile) # GEN_LIBS - list of libs to be generated () # GEN_IMAGES - list of images to be generated () # COMPONENTS_xxx - a list of libs/objs in the form # subdir/lib to be extracted and rolled up into # a generated lib/image xxx.a () # ifndef PDIR UP_EXTRACT_DIR = .. GEN_LIBS = liblwip.a COMPONENTS_liblwip = api/liblwipapi.a \ app/liblwipapp.a \ core/liblwipcore.a \ core/ipv4/liblwipipv4.a \ netif/liblwipnetif.a endif ############################################################# # Configuration i.e. compile options etc. # Target specific stuff (defines etc.) goes in here! # Generally values applying to a tree are captured in the # makefile at its root level - these are then overridden # for a subtree within the makefile rooted therein # #DEFINES += ############################################################# # Recursion Magic - Don't touch this!! # # Each subtree potentially has an include directory # corresponding to the common APIs applicable to modules # rooted at that subtree. Accordingly, the INCLUDE PATH # of a module can only contain the include directories up # its parent path, and not its siblings # # Required for each makefile to inherit from the parent # INCLUDES := $(INCLUDES) -I $(PDIR)include INCLUDES += -I ./ PDIR := ../$(PDIR) sinclude $(PDIR)Makefile ================================================ FILE: app/lwip/api/Makefile ================================================ ############################################################# # Required variables for each makefile # Discard this section from all parent makefiles # Expected variables (with automatic defaults): # CSRCS (all "C" files in the dir) # SUBDIRS (all subdirs with a Makefile) # GEN_LIBS - list of libs to be generated () # GEN_IMAGES - list of images to be generated () # COMPONENTS_xxx - a list of libs/objs in the form # subdir/lib to be extracted and rolled up into # a generated lib/image xxx.a () # ifndef PDIR GEN_LIBS = liblwipapi.a endif ############################################################# # Configuration i.e. compile options etc. # Target specific stuff (defines etc.) goes in here! # Generally values applying to a tree are captured in the # makefile at its root level - these are then overridden # for a subtree within the makefile rooted therein # #DEFINES += ############################################################# # Recursion Magic - Don't touch this!! # # Each subtree potentially has an include directory # corresponding to the common APIs applicable to modules # rooted at that subtree. Accordingly, the INCLUDE PATH # of a module can only contain the include directories up # its parent path, and not its siblings # # Required for each makefile to inherit from the parent # INCLUDES := $(INCLUDES) -I $(PDIR)include INCLUDES += -I ./ PDIR := ../$(PDIR) sinclude $(PDIR)Makefile ================================================ FILE: app/lwip/api/api_lib.c ================================================ /** * @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/tcpip.h" #include "lwip/memp.h" #include "lwip/ip.h" #include "lwip/raw.h" #include "lwip/udp.h" #include "lwip/tcp.h" #include /** * 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; struct api_msg msg; conn = netconn_alloc(t, callback); if (conn != NULL) { msg.function = do_newconn; msg.msg.msg.n.proto = proto; msg.msg.conn = conn; if (TCPIP_APIMSG(&msg) != ERR_OK) { LWIP_ASSERT("freeing conn without freeing pcb", conn->pcb.tcp == NULL); LWIP_ASSERT("conn has no op_completed", sys_sem_valid(&conn->op_completed)); 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 */ sys_sem_free(&conn->op_completed); 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) { struct api_msg msg; /* No ASSERT here because possible to get a (conn == NULL) if we got an accept error */ if (conn == NULL) { return ERR_OK; } msg.function = do_delconn; msg.msg.conn = conn; tcpip_apimsg(&msg); netconn_free(conn); /* don't care for return value of do_delconn since it only calls void functions */ 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) { struct api_msg 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;); msg.function = do_getaddr; msg.msg.conn = conn; msg.msg.msg.ad.ipaddr = addr; msg.msg.msg.ad.port = port; msg.msg.msg.ad.local = local; err = TCPIP_APIMSG(&msg); NETCONN_SET_SAFE_ERR(conn, err); 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, ip_addr_t *addr, u16_t port) { struct api_msg msg; err_t err; LWIP_ERROR("netconn_bind: invalid conn", (conn != NULL), return ERR_ARG;); msg.function = do_bind; msg.msg.conn = conn; msg.msg.msg.bc.ipaddr = addr; msg.msg.msg.bc.port = port; err = TCPIP_APIMSG(&msg); NETCONN_SET_SAFE_ERR(conn, err); 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, ip_addr_t *addr, u16_t port) { struct api_msg msg; err_t err; LWIP_ERROR("netconn_connect: invalid conn", (conn != NULL), return ERR_ARG;); msg.function = do_connect; msg.msg.conn = conn; msg.msg.msg.bc.ipaddr = addr; msg.msg.msg.bc.port = port; /* This is the only function which need to not block tcpip_thread */ err = tcpip_apimsg(&msg); NETCONN_SET_SAFE_ERR(conn, err); 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) { struct api_msg msg; err_t err; LWIP_ERROR("netconn_disconnect: invalid conn", (conn != NULL), return ERR_ARG;); msg.function = do_disconnect; msg.msg.conn = conn; err = TCPIP_APIMSG(&msg); NETCONN_SET_SAFE_ERR(conn, err); 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 struct api_msg 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;); msg.function = do_listen; msg.msg.conn = conn; #if TCP_LISTEN_BACKLOG msg.msg.msg.lb.backlog = backlog; #endif /* TCP_LISTEN_BACKLOG */ err = TCPIP_APIMSG(&msg); NETCONN_SET_SAFE_ERR(conn, err); 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 struct api_msg 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) { NETCONN_SET_SAFE_ERR(conn, ERR_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 closed */ NETCONN_SET_SAFE_ERR(conn, ERR_CLSD); return ERR_CLSD; } #if TCP_LISTEN_BACKLOG /* Let the stack know that we have accepted the connection. */ msg.function = do_recv; msg.msg.conn = conn; /* don't care for the return value of do_recv */ TCPIP_APIMSG(&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 struct api_msg 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;); LWIP_ERROR("netconn_accept: 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) { NETCONN_SET_SAFE_ERR(conn, ERR_TIMEOUT); return ERR_TIMEOUT; } #else sys_arch_mbox_fetch(&conn->recvmbox, &buf, 0); #endif /* LWIP_SO_RCVTIMEO*/ #if LWIP_TCP if (conn->type == NETCONN_TCP) { 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). */ msg.function = do_recv; msg.msg.conn = conn; if (buf != NULL) { msg.msg.msg.r.len = ((struct pbuf *)buf)->tot_len; } else { msg.msg.msg.r.len = 1; } /* don't care for the return value of do_recv */ TCPIP_APIMSG(&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); /* Avoid to lose any previous error code */ NETCONN_SET_SAFE_ERR(conn, ERR_CLSD); 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) { 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) && 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;); LWIP_ERROR("netconn_accept: invalid recvmbox", sys_mbox_valid(&conn->recvmbox), return ERR_CONN;); #if LWIP_TCP if (conn->type == NETCONN_TCP) { struct pbuf *p = NULL; /* This is not a listening netconn, since recvmbox is set */ buf = (struct netbuf *)memp_malloc(MEMP_NETBUF); if (buf == NULL) { NETCONN_SET_SAFE_ERR(conn, ERR_MEM); 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_any(&buf->addr); *new_buf = buf; /* don't set conn->last_err: it's only ERR_OK, anyway */ return ERR_OK; } else #endif /* LWIP_TCP */ { #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) && (conn->type == NETCONN_TCP) && (netconn_get_noautorecved(conn))) { struct api_msg 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). */ msg.function = do_recv; msg.msg.conn = conn; msg.msg.msg.r.len = length; /* don't care for the return value of do_recv */ TCPIP_APIMSG(&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, 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) { struct api_msg 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)); msg.function = do_send; msg.msg.conn = conn; msg.msg.msg.b = buf; err = TCPIP_APIMSG(&msg); NETCONN_SET_SAFE_ERR(conn, err); 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 dat can be written at once * @return ERR_OK if data was sent, any other err_t on error */ err_t netconn_write(struct netconn *conn, const void *dataptr, size_t size, u8_t apiflags) { struct api_msg msg; err_t err; LWIP_ERROR("netconn_write: invalid conn", (conn != NULL), return ERR_ARG;); LWIP_ERROR("netconn_write: invalid conn->type", (conn->type == NETCONN_TCP), return ERR_VAL;); if (size == 0) { return ERR_OK; } /* @todo: for non-blocking write, check if 'size' would ever fit into snd_queue or snd_buf */ msg.function = do_write; msg.msg.conn = conn; msg.msg.msg.w.dataptr = dataptr; msg.msg.msg.w.apiflags = apiflags; msg.msg.msg.w.len = size; /* 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. */ err = TCPIP_APIMSG(&msg); NETCONN_SET_SAFE_ERR(conn, err); return err; } /** * Close ot 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) { struct api_msg msg; err_t err; LWIP_ERROR("netconn_close: invalid conn", (conn != NULL), return ERR_ARG;); msg.function = do_close; msg.msg.conn = conn; /* shutting down both ends is the same as closing */ msg.msg.msg.sd.shut = how; /* because of the LWIP_TCPIP_CORE_LOCKING implementation of do_close, don't use TCPIP_APIMSG here */ err = tcpip_apimsg(&msg); NETCONN_SET_SAFE_ERR(conn, err); 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 /** * 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, ip_addr_t *multiaddr, ip_addr_t *netif_addr, enum netconn_igmp join_or_leave) { struct api_msg msg; err_t err; LWIP_ERROR("netconn_join_leave_group: invalid conn", (conn != NULL), return ERR_ARG;); msg.function = do_join_leave_group; msg.msg.conn = conn; msg.msg.msg.jl.multiaddr = multiaddr; msg.msg.msg.jl.netif_addr = netif_addr; msg.msg.msg.jl.join_or_leave = join_or_leave; err = TCPIP_APIMSG(&msg); NETCONN_SET_SAFE_ERR(conn, err); return err; } #endif /* LWIP_IGMP */ #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 */ err_t netconn_gethostbyname(const char *name, ip_addr_t *addr) { struct dns_api_msg msg; err_t err; sys_sem_t sem; LWIP_ERROR("netconn_gethostbyname: invalid name", (name != NULL), return ERR_ARG;); LWIP_ERROR("netconn_gethostbyname: invalid addr", (addr != NULL), return ERR_ARG;); err = sys_sem_new(&sem, 0); if (err != ERR_OK) { return err; } msg.name = name; msg.addr = addr; msg.err = &err; msg.sem = &sem; tcpip_callback(do_gethostbyname, &msg); sys_sem_wait(&sem); sys_sem_free(&sem); return err; } #endif /* LWIP_DNS*/ #endif /* LWIP_NETCONN */ ================================================ FILE: app/lwip/api/api_msg.c ================================================ /** * @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/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/tcpip.h" #include "lwip/igmp.h" #include "lwip/dns.h" #include #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 static err_t do_writemore(struct netconn *conn); static void do_close_internal(struct netconn *conn); #endif #if LWIP_RAW /** * Receive callback function for RAW netconns. * Doesn't 'eat' the packet, only references 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, 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, 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 { const struct ip_hdr* iphdr = ip_current_header(); /* get the UDP header - always in the first pbuf, ensured by udp_input */ const struct udp_hdr* udphdr = (void*)(((char*)iphdr) + IPH_LEN(iphdr)); #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; LWIP_ASSERT("recv_tcp: recv for wrong pcb!", conn->pcb.tcp == pcb); if (conn == NULL) { return ERR_VAL; } 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! */ 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) { do_writemore(conn); } else if (conn->state == NETCONN_CLOSE) { do_close_internal(conn); } /* @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->state == NETCONN_WRITE) { do_writemore(conn); } else if (conn->state == NETCONN_CLOSE) { do_close_internal(conn); } if (conn) { /* 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; SYS_ARCH_DECL_PROTECT(lev); conn = (struct netconn *)arg; LWIP_ASSERT("conn != NULL", (conn != NULL)); conn->pcb.tcp = NULL; /* no check since this is always fatal! */ SYS_ARCH_PROTECT(lev); conn->last_err = err; SYS_ARCH_UNPROTECT(lev); /* reset conn->state now before waking up other threads */ old_state = conn->state; conn->state = NETCONN_NONE; /* 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 do_writemore/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) { /* set error return code */ LWIP_ASSERT("conn->current_msg != NULL", conn->current_msg != NULL); conn->current_msg->err = err; conn->current_msg = NULL; /* wake up the waiting task */ sys_sem_signal(&conn->op_completed); } } 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, 4); 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! */ 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 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) { msg->err = ERR_MEM; break; } 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) { msg->err = ERR_MEM; break; } #if LWIP_UDPLITE if (msg->conn->type==NETCONN_UDPLITE) { udp_setflags(msg->conn->pcb.udp, UDP_FLAGS_UDPLITE); } #endif /* LWIP_UDPLITE */ if (msg->conn->type==NETCONN_UDPNOCHKSUM) { 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) { msg->err = ERR_MEM; break; } setup_tcp(msg->conn); break; #endif /* LWIP_TCP */ default: /* Unsupported netconn type, e.g. protocol disabled */ msg->err = ERR_VAL; break; } } /** * 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 do_newconn(struct api_msg_msg *msg) { 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 (DEFAULT_RAW_RECVMBOX_SIZE == DEFAULT_UDP_RECVMBOX_SIZE) && \ (DEFAULT_RAW_RECVMBOX_SIZE == DEFAULT_TCP_RECVMBOX_SIZE) size = DEFAULT_RAW_RECVMBOX_SIZE; #else 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); break; } #endif if (sys_sem_new(&conn->op_completed, 0) != ERR_OK) { memp_free(MEMP_NETCONN, conn); return NULL; } if (sys_mbox_new(&conn->recvmbox, size) != ERR_OK) { sys_sem_free(&conn->op_completed); memp_free(MEMP_NETCONN, conn); return NULL; } #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_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 */ conn->flags = 0; return conn; } /** * 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 */ sys_sem_free(&conn->op_completed); sys_sem_set_invalid(&conn->op_completed); 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 (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 */ static void do_close_internal(struct netconn *conn) { err_t err; u8_t shut, shut_rx, shut_tx, close; LWIP_ASSERT("invalid conn", (conn != NULL)); LWIP_ASSERT("this is for tcp netconns only", (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); 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 */ close = shut == NETCONN_SHUT_RDWR; /* Set back some callback pointers */ if (close) { tcp_arg(conn->pcb.tcp, NULL); } if (conn->pcb.tcp->state == LISTEN) { tcp_accept(conn->pcb.tcp, NULL); } else { /* some callbacks have to be reset if tcp_close is not successful */ if (shut_rx) { tcp_recv(conn->pcb.tcp, NULL); tcp_accept(conn->pcb.tcp, NULL); } if (shut_tx) { tcp_sent(conn->pcb.tcp, NULL); } if (close) { tcp_poll(conn->pcb.tcp, NULL, 4); tcp_err(conn->pcb.tcp, NULL); } } /* Try to close the connection */ if (shut == NETCONN_SHUT_RDWR) { err = tcp_close(conn->pcb.tcp); } else { err = tcp_shutdown(conn->pcb.tcp, shut & NETCONN_SHUT_RD, shut & NETCONN_SHUT_WR); } if (err == ERR_OK) { /* Closing succeeded */ conn->current_msg->err = ERR_OK; conn->current_msg = NULL; conn->state = NETCONN_NONE; /* 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! */ if (close) { 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); } /* wake up the application task */ sys_sem_signal(&conn->op_completed); } else { /* Closing failed, restore some of the callbacks */ /* Closing of listen pcb will never fail! */ LWIP_ASSERT("Closing a listen pcb may not fail!", (conn->pcb.tcp->state != LISTEN)); tcp_sent(conn->pcb.tcp, sent_tcp); tcp_poll(conn->pcb.tcp, poll_tcp, 4); tcp_err(conn->pcb.tcp, err_tcp); tcp_arg(conn->pcb.tcp, 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 */ } #endif /* LWIP_TCP */ /** * Delete the pcb inside a netconn. * Called from netconn_delete. * * @param msg the api_msg_msg pointing to the connection */ void do_delconn(struct api_msg_msg *msg) { /* @todo TCP: abort running write/connect? */ if ((msg->conn->state != NETCONN_NONE) && (msg->conn->state != NETCONN_LISTEN) && (msg->conn->state != NETCONN_CONNECT)) { /* this only happens for TCP netconns */ LWIP_ASSERT("msg->conn->type == NETCONN_TCP", msg->conn->type == NETCONN_TCP); msg->err = ERR_INPROGRESS; } else { LWIP_ASSERT("blocking connect in progress", (msg->conn->state != NETCONN_CONNECT) || IN_NONBLOCKING_CONNECT(msg->conn)); /* 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; do_close_internal(msg->conn); /* API_EVENT is called inside 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(&msg->conn->op_completed)) { sys_sem_signal(&msg->conn->op_completed); } } /** * 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 do_bind(struct api_msg_msg *msg) { 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) { switch (NETCONNTYPE_GROUP(msg->conn->type)) { #if LWIP_RAW case NETCONN_RAW: msg->err = raw_bind(msg->conn->pcb.raw, msg->msg.bc.ipaddr); break; #endif /* LWIP_RAW */ #if LWIP_UDP case NETCONN_UDP: msg->err = udp_bind(msg->conn->pcb.udp, msg->msg.bc.ipaddr, msg->msg.bc.port); break; #endif /* LWIP_UDP */ #if LWIP_TCP case NETCONN_TCP: msg->err = tcp_bind(msg->conn->pcb.tcp, msg->msg.bc.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/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 do_connected(void *arg, struct tcp_pcb *pcb, err_t err) { struct netconn *conn; int was_blocking; 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; } if ((conn->type == NETCONN_TCP) && (err == ERR_OK)) { setup_tcp(conn); } was_blocking = !IN_NONBLOCKING_CONNECT(conn); SET_NONBLOCKING_CONNECT(conn, 0); conn->current_msg = NULL; conn->state = NETCONN_NONE; if (!was_blocking) { SYS_ARCH_DECL_PROTECT(lev); SYS_ARCH_PROTECT(lev); if (conn->last_err == ERR_INPROGRESS) { conn->last_err = ERR_OK; } SYS_ARCH_UNPROTECT(lev); } API_EVENT(conn, NETCONN_EVT_SENDPLUS, 0); if (was_blocking) { sys_sem_signal(&conn->op_completed); } 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 do_connect(struct api_msg_msg *msg) { 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, msg->msg.bc.ipaddr); break; #endif /* LWIP_RAW */ #if LWIP_UDP case NETCONN_UDP: msg->err = udp_connect(msg->conn->pcb.udp, 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_NONE) { msg->err = ERR_ISCONN; } else { setup_tcp(msg->conn); msg->err = tcp_connect(msg->conn->pcb.tcp, msg->msg.bc.ipaddr, msg->msg.bc.port, 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 do_connected (or err_tcp()), * when the connection is established! */ return; } } } break; #endif /* LWIP_TCP */ default: LWIP_ERROR("Invalid netconn type", 0, do{ msg->err = ERR_VAL; }while(0)); break; } } sys_sem_signal(&msg->conn->op_completed); } /** * Connect 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 do_disconnect(struct api_msg_msg *msg) { #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 do_listen(struct api_msg_msg *msg) { 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 (msg->conn->type == NETCONN_TCP) { if (msg->conn->state == NETCONN_NONE) { #if TCP_LISTEN_BACKLOG struct tcp_pcb* lpcb = tcp_listen_with_backlog(msg->conn->pcb.tcp, msg->msg.lb.backlog); #else /* TCP_LISTEN_BACKLOG */ struct tcp_pcb* 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; } } } } } } 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 do_send(struct api_msg_msg *msg) { 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)) { 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(&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 do_recv(struct api_msg_msg *msg) { msg->err = ERR_OK; if (msg->conn->pcb.tcp != NULL) { if (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 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 * @return ERR_OK * ERR_MEM if LWIP_TCPIP_CORE_LOCKING=1 and sending hasn't yet finished */ static err_t do_writemore(struct netconn *conn) { err_t err = ERR_OK; void *dataptr; u16_t len, available; u8_t write_finished = 0; size_t diff; u8_t dontblock = netconn_is_nonblocking(conn) || (conn->current_msg->msg.w.apiflags & NETCONN_DONTBLOCK); u8_t apiflags = conn->current_msg->msg.w.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); dataptr = (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; #if LWIP_TCPIP_CORE_LOCKING conn->flags |= NETCONN_FLAG_WRITE_DELAYED; #endif 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 LWIP_TCPIP_CORE_LOCKING conn->flags |= NETCONN_FLAG_WRITE_DELAYED; #endif apiflags |= TCP_WRITE_FLAG_MORE; } if (dontblock && (len < conn->current_msg->msg.w.len)) { /* failed to send all data at once -> nonblocking write not possible */ err = ERR_MEM; } if (err == ERR_OK) { LWIP_ASSERT("do_writemore: invalid length!", ((conn->write_offset + len) <= conn->current_msg->msg.w.len)); err = tcp_write(conn->pcb.tcp, dataptr, len, apiflags); } if (dontblock && (err == ERR_MEM)) { /* nonblocking write failed */ write_finished = 1; err = ERR_WOULDBLOCK; /* let poll_tcp check writable space to mark the pcb writable again */ conn->flags |= NETCONN_FLAG_CHECK_WRITESPACE; /* let select mark this pcb as non-writable. */ API_EVENT(conn, NETCONN_EVT_SENDMINUS, len); } else { /* if OK or memory error, check available space */ if (((err == ERR_OK) || (err == ERR_MEM)) && ((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) { conn->write_offset += len; if (conn->write_offset == conn->current_msg->msg.w.len) { /* everything was written */ write_finished = 1; conn->write_offset = 0; } tcp_output(conn->pcb.tcp); } else if (err == ERR_MEM) { /* 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 */ tcp_output(conn->pcb.tcp); #if LWIP_TCPIP_CORE_LOCKING conn->flags |= NETCONN_FLAG_WRITE_DELAYED; #endif } else { /* On errors != ERR_MEM, we don't try writing any more but return the error to the application thread. */ write_finished = 1; } } if (write_finished) { /* everything was written: set back connection state and back to application task */ conn->current_msg->err = err; conn->current_msg = NULL; conn->state = NETCONN_NONE; #if LWIP_TCPIP_CORE_LOCKING if ((conn->flags & NETCONN_FLAG_WRITE_DELAYED) != 0) #endif { sys_sem_signal(&conn->op_completed); } } #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 do_write(struct api_msg_msg *msg) { if (ERR_IS_FATAL(msg->conn->last_err)) { msg->err = msg->conn->last_err; } else { if (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 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 msg->conn->flags &= ~NETCONN_FLAG_WRITE_DELAYED; if (do_writemore(msg->conn) != ERR_OK) { LWIP_ASSERT("state!", msg->conn->state == NETCONN_WRITE); UNLOCK_TCPIP_CORE(); sys_arch_sem_wait(&msg->conn->op_completed, 0); LOCK_TCPIP_CORE(); LWIP_ASSERT("state!", msg->conn->state == NETCONN_NONE); } #else /* LWIP_TCPIP_CORE_LOCKING */ do_writemore(msg->conn); #endif /* LWIP_TCPIP_CORE_LOCKING */ /* for both cases: if do_writemore was called, don't ACK the APIMSG since 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 do_getaddr(struct api_msg_msg *msg) { if (msg->conn->pcb.ip != NULL) { *(msg->msg.ad.ipaddr) = (msg->msg.ad.local ? msg->conn->pcb.ip->local_ip : 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) { *(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) { *(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 { *(msg->msg.ad.port) = msg->conn->pcb.udp->remote_port; } } break; #endif /* LWIP_UDP */ #if LWIP_TCP case NETCONN_TCP: *(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 a TCP pcb contained in a netconn * Called from netconn_close * * @param msg the api_msg_msg pointing to the connection */ void do_close(struct api_msg_msg *msg) { #if LWIP_TCP /* @todo: abort running write/connect? */ if ((msg->conn->state != NETCONN_NONE) && (msg->conn->state != NETCONN_LISTEN)) { /* this only happens for TCP netconns */ LWIP_ASSERT("msg->conn->type == NETCONN_TCP", msg->conn->type == NETCONN_TCP); msg->err = ERR_INPROGRESS; } else if ((msg->conn->pcb.tcp != NULL) && (msg->conn->type == NETCONN_TCP)) { if ((msg->msg.sd.shut != NETCONN_SHUT_RDWR) && (msg->conn->state == NETCONN_LISTEN)) { /* LISTEN doesn't support half shutdown */ msg->err = ERR_CONN; } 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; do_close_internal(msg->conn); /* for tcp netconns, do_close_internal ACKs the message */ return; } } else #endif /* LWIP_TCP */ { msg->err = ERR_VAL; } sys_sem_signal(&msg->conn->op_completed); } #if LWIP_IGMP /** * Join multicast groups for UDP netconns. * Called from netconn_join_leave_group * * @param msg the api_msg_msg pointing to the connection */ void do_join_leave_group(struct api_msg_msg *msg) { 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 (msg->msg.jl.join_or_leave == NETCONN_JOIN) { msg->err = igmp_joingroup(msg->msg.jl.netif_addr, msg->msg.jl.multiaddr); } else { msg->err = igmp_leavegroup(msg->msg.jl.netif_addr, msg->msg.jl.multiaddr); } #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 */ #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 do_dns_found(const char *name, ip_addr_t *ipaddr, void *arg) { struct dns_api_msg *msg = (struct dns_api_msg*)arg; LWIP_ASSERT("DNS response for wrong host name", strcmp(msg->name, name) == 0); LWIP_UNUSED_ARG(name); if (ipaddr == NULL) { /* timeout or memory error */ *msg->err = ERR_VAL; } else { /* address was resolved */ *msg->err = ERR_OK; *msg->addr = *ipaddr; } /* wake up the application task waiting in netconn_gethostbyname */ sys_sem_signal(msg->sem); } /** * Execute a DNS query * Called from netconn_gethostbyname * * @param arg the dns_api_msg pointing to the query */ void do_gethostbyname(void *arg) { struct dns_api_msg *msg = (struct dns_api_msg*)arg; *msg->err = dns_gethostbyname(msg->name, msg->addr, do_dns_found, msg); if (*msg->err != ERR_INPROGRESS) { /* on error or immediate success, wake up the application * task waiting in netconn_gethostbyname */ sys_sem_signal(msg->sem); } } #endif /* LWIP_DNS */ #endif /* LWIP_NETCONN */ ================================================ FILE: app/lwip/api/err.c ================================================ /** * @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 */ "Connection aborted.", /* ERR_ABRT -8 */ "Connection reset.", /* ERR_RST -9 */ "Connection closed.", /* ERR_CLSD -10 */ "Not connected.", /* ERR_CONN -11 */ "Illegal argument.", /* ERR_ARG -12 */ "Address in use.", /* ERR_USE -13 */ "Low-level netif error.", /* ERR_IF -14 */ "Already connected.", /* ERR_ISCONN -15 */ }; /** * 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 */ ================================================ FILE: app/lwip/api/netbuf.c ================================================ /** * @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 /** * Create (allocate) and initialize a new netbuf. * The netbuf doesn't yet contain a packet buffer! * һµnetbufռ䣬κݿռ * @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_any(&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_any(&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(). * ͷһnetbufռ * @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. *ΪnetbufṹsizeСݿռ * @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 *ͷnetbufṹָpbuf * @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; } buf->p->payload = (void*)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 retreived, * 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 */ ================================================ FILE: app/lwip/api/netdb.c ================================================ /** * @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 /** helper struct for gethostbyname_r to access the char* buffer */ struct gethostbyname_r_helper { ip_addr_t *addrs; 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]; /* 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; s_hostent.h_name = (char*)name; 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", s_hostent.h_aliases)); if (s_hostent.h_aliases != NULL) { u8_t idx; for ( idx=0; s_hostent.h_aliases[idx]; idx++) { LWIP_DEBUGF(DNS_DEBUG, ("hostent.h_aliases[%i]-> == %p\n", idx, s_hostent.h_aliases[idx])); LWIP_DEBUGF(DNS_DEBUG, ("hostent.h_aliases[%i]-> == %s\n", idx, s_hostent.h_aliases[idx])); } } 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", 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, ip_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 == 0)) { /* 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 = ENSRNOTFOUND; return -1; } /* copy the hostname into buf */ MEMCPY(hostname, name, namelen); hostname[namelen] = 0; /* fill hostent */ h->addrs = &(h->addr); h->aliases = NULL; ret->h_name = (char*)hostname; ret->h_aliases = &(h->aliases); ret->h_addrtype = AF_INET; ret->h_length = sizeof(ip_addr_t); ret->h_addr_list = (char**)&(h->addrs); /* 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 */ 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_in *sa = NULL; int port_nr = 0; size_t total_size; size_t namelen = 0; if (res == NULL) { return EAI_FAIL; } *res = NULL; if ((nodename == NULL) && (servname == NULL)) { return EAI_NONAME; } if (servname != NULL) { /* service name specified: convert to port number * @todo?: currently, only ASCII integers (port numbers) are supported! */ port_nr = atoi(servname); if ((port_nr <= 0) || (port_nr > 0xffff)) { return EAI_SERVICE; } } if (nodename != NULL) { /* service location specified, try to resolve */ err = netconn_gethostbyname(nodename, &addr); if (err != ERR_OK) { return EAI_FAIL; } } else { /* service location specified, use loopback address */ ip_addr_set_loopback(&addr); } total_size = sizeof(struct addrinfo) + sizeof(struct sockaddr_in); if (nodename != NULL) { namelen = strlen(nodename); LWIP_ASSERT("namelen is too long", (namelen + 1) <= (mem_size_t)-1); 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) { goto memerr; } memset(ai, 0, total_size); sa = (struct sockaddr_in*)((u8_t*)ai + sizeof(struct addrinfo)); /* set up sockaddr */ inet_addr_from_ipaddr(&sa->sin_addr, &addr); sa->sin_family = AF_INET; sa->sin_len = sizeof(struct sockaddr_in); sa->sin_port = htons((u16_t)port_nr); /* set up addrinfo */ ai->ai_family = AF_INET; 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_in)); MEMCPY(ai->ai_canonname, nodename, namelen); ai->ai_canonname[namelen] = 0; } ai->ai_addrlen = sizeof(struct sockaddr_in); ai->ai_addr = (struct sockaddr*)sa; *res = ai; return 0; memerr: if (ai != NULL) { memp_free(MEMP_NETDB, ai); } return EAI_MEMORY; } #endif /* LWIP_DNS && LWIP_SOCKET */ ================================================ FILE: app/lwip/api/netifapi.c ================================================ /** * @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/tcpip.h" /** * Call netif_add() inside the tcpip_thread context. */ void do_netifapi_netif_add(struct netifapi_msg_msg *msg) { if (!netif_add( msg->netif, msg->msg.add.ipaddr, msg->msg.add.netmask, msg->msg.add.gw, msg->msg.add.state, msg->msg.add.init, msg->msg.add.input)) { msg->err = ERR_IF; } else { msg->err = ERR_OK; } TCPIP_NETIFAPI_ACK(msg); } /** * Call netif_set_addr() inside the tcpip_thread context. */ void do_netifapi_netif_set_addr(struct netifapi_msg_msg *msg) { netif_set_addr( msg->netif, msg->msg.add.ipaddr, msg->msg.add.netmask, msg->msg.add.gw); msg->err = ERR_OK; TCPIP_NETIFAPI_ACK(msg); } /** * Call the "errtfunc" (or the "voidfunc" if "errtfunc" is NULL) inside the * tcpip_thread context. */ void do_netifapi_netif_common(struct netifapi_msg_msg *msg) { if (msg->msg.common.errtfunc != NULL) { msg->err = msg->msg.common.errtfunc(msg->netif); } else { msg->err = ERR_OK; msg->msg.common.voidfunc(msg->netif); } TCPIP_NETIFAPI_ACK(msg); } /** * 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, ip_addr_t *ipaddr, ip_addr_t *netmask, ip_addr_t *gw, void *state, netif_init_fn init, netif_input_fn input) { struct netifapi_msg msg; msg.function = do_netifapi_netif_add; msg.msg.netif = netif; msg.msg.msg.add.ipaddr = ipaddr; msg.msg.msg.add.netmask = netmask; msg.msg.msg.add.gw = gw; msg.msg.msg.add.state = state; msg.msg.msg.add.init = init; msg.msg.msg.add.input = input; TCPIP_NETIFAPI(&msg); return msg.msg.err; } /** * 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, ip_addr_t *ipaddr, ip_addr_t *netmask, ip_addr_t *gw) { struct netifapi_msg msg; msg.function = do_netifapi_netif_set_addr; msg.msg.netif = netif; msg.msg.msg.add.ipaddr = ipaddr; msg.msg.msg.add.netmask = netmask; msg.msg.msg.add.gw = gw; TCPIP_NETIFAPI(&msg); return msg.msg.err; } /** * 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) { struct netifapi_msg msg; msg.function = do_netifapi_netif_common; msg.msg.netif = netif; msg.msg.msg.common.voidfunc = voidfunc; msg.msg.msg.common.errtfunc = errtfunc; TCPIP_NETIFAPI(&msg); return msg.msg.err; } #endif /* LWIP_NETIF_API */ ================================================ FILE: app/lwip/api/sockets.c ================================================ /** * @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/tcpip.h" #include "lwip/pbuf.h" #if LWIP_CHECKSUM_ON_COPY #include "lwip/inet_chksum.h" #endif #include #define NUM_SOCKETS MEMP_NUM_NETCONN /** 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 */ int err; /** counter of how many threads are waiting for this socket using select */ int select_waiting; }; /** 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 */ sys_sem_t sem; }; /** 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 struct for which to change options */ struct lwip_sock *sock; #ifdef LWIP_DEBUG /** socket index for which to change options */ int s; #endif /* LWIP_DEBUG */ /** 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 */ void *optval; /** size of *optval */ socklen_t *optlen; /** if an error occures, it is temporarily stored here */ err_t err; }; /** The global array of available sockets */ static struct lwip_sock sockets[NUM_SOCKETS]; /** 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 chagned 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 */ static const int err_to_errno_table[] = { 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. */ ECONNABORTED, /* ERR_ABRT -8 Connection aborted. */ ECONNRESET, /* ERR_RST -9 Connection reset. */ ESHUTDOWN, /* ERR_CLSD -10 Connection closed. */ ENOTCONN, /* ERR_CONN -11 Not connected. */ EIO, /* ERR_ARG -12 Illegal argument. */ EADDRINUSE, /* ERR_USE -13 Address in use. */ -1, /* ERR_IF -14 Low-level netif error */ -1, /* ERR_ISCONN -15 Already connected. */ }; #define ERR_TO_ERRNO_TABLE_SIZE \ (sizeof(err_to_errno_table)/sizeof(err_to_errno_table[0])) #define err_to_errno(err) \ ((unsigned)(-(err)) < ERR_TO_ERRNO_TABLE_SIZE ? \ err_to_errno_table[-(err)] : EIO) #ifdef ERRNO #ifndef set_errno #define set_errno(err) errno = (err) #endif #else /* ERRNO */ #define set_errno(err) #endif /* ERRNO */ #define sock_set_errno(sk, e) do { \ sk->err = (e); \ set_errno(sk->err); \ } while (0) /* Forward delcaration of some functions */ static void event_callback(struct netconn *conn, enum netconn_evt evt, u16_t len); static void lwip_getsockopt_internal(void *arg); static void lwip_setsockopt_internal(void *arg); /** * Initialize this module. This function has to be called before any other * functions in this module! */ void lwip_socket_init(void) { } /** * 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; if ((s < 0) || (s >= NUM_SOCKETS)) { LWIP_DEBUGF(SOCKETS_DEBUG, ("get_socket(%d): invalid\n", s)); set_errno(EBADF); return NULL; } sock = &sockets[s]; if (!sock->conn) { LWIP_DEBUGF(SOCKETS_DEBUG, ("get_socket(%d): not active\n", s)); 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) { 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); /* 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 = (newconn->type == NETCONN_TCP ? (accepted != 0) : 1); sockets[i].errevent = 0; sockets[i].err = 0; sockets[i].select_waiting = 0; return i; } SYS_ARCH_UNPROTECT(lev); } 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); lastdata = sock->lastdata; sock->lastdata = NULL; sock->lastoffset = 0; sock->err = 0; /* Protect socket array */ SYS_ARCH_PROTECT(lev); sock->conn = NULL; SYS_ARCH_UNPROTECT(lev); /* don't use 'sock' after this line, as another task might have allocated it */ if (lastdata != NULL) { if (is_tcp) { pbuf_free((struct pbuf *)lastdata); } else { 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; int newsock; struct sockaddr_in sin; 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)); 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); /* 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); sock_set_errno(sock, err_to_errno(err)); return -1; } /* Note that POSIX only requires us to check addr is non-NULL. addrlen must * not be NULL if addr is valid. */ if (NULL != addr) { LWIP_ASSERT("addr valid but addrlen NULL", addrlen != NULL); memset(&sin, 0, sizeof(sin)); sin.sin_len = sizeof(sin); sin.sin_family = AF_INET; sin.sin_port = htons(port); inet_addr_from_ipaddr(&sin.sin_addr, &naddr); if (*addrlen > sizeof(sin)) *addrlen = sizeof(sin); MEMCPY(addr, &sin, *addrlen); } newsock = alloc_socket(newconn, 1); if (newsock == -1) { netconn_delete(newconn); sock_set_errno(sock, ENFILE); return -1; } LWIP_ASSERT("invalid socket index", (newsock >= 0) && (newsock < NUM_SOCKETS)); LWIP_ASSERT("newconn->callback == event_callback", newconn->callback == event_callback); nsock = &sockets[newsock]; /* 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); LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_accept(%d) returning new sock=%d addr=", s, newsock)); ip_addr_debug_print(SOCKETS_DEBUG, &naddr); LWIP_DEBUGF(SOCKETS_DEBUG, (" port=%"U16_F"\n", port)); 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; const struct sockaddr_in *name_in; sock = get_socket(s); if (!sock) { return -1; } /* check size, familiy and alignment of 'name' */ LWIP_ERROR("lwip_bind: invalid address", ((namelen == sizeof(struct sockaddr_in)) && ((name->sa_family) == AF_INET) && ((((mem_ptr_t)name) % 4) == 0)), sock_set_errno(sock, err_to_errno(ERR_ARG)); return -1;); name_in = (const struct sockaddr_in *)(void*)name; inet_addr_to_ipaddr(&local_addr, &name_in->sin_addr); local_port = name_in->sin_port; LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_bind(%d, addr=", s)); ip_addr_debug_print(SOCKETS_DEBUG, &local_addr); LWIP_DEBUGF(SOCKETS_DEBUG, (" port=%"U16_F")\n", ntohs(local_port))); err = netconn_bind(sock->conn, &local_addr, ntohs(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; LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_close(%d)\n", s)); sock = get_socket(s); if (!sock) { return -1; } if(sock->conn != NULL) { is_tcp = netconn_type(sock->conn) == NETCONN_TCP; } else { LWIP_ASSERT("sock->lastdata == NULL", sock->lastdata == NULL); } netconn_delete(sock->conn); free_socket(sock, is_tcp); set_errno(0); return 0; } int lwip_connect(int s, const struct sockaddr *name, socklen_t namelen) { struct lwip_sock *sock; err_t err; const struct sockaddr_in *name_in; sock = get_socket(s); if (!sock) { return -1; } /* check size, familiy and alignment of 'name' */ LWIP_ERROR("lwip_connect: invalid address", ((namelen == sizeof(struct sockaddr_in)) && ((name->sa_family) == AF_INET) && ((((mem_ptr_t)name) % 4) == 0)), sock_set_errno(sock, err_to_errno(ERR_ARG)); return -1;); name_in = (const struct sockaddr_in *)(void*)name; if (name_in->sin_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; inet_addr_to_ipaddr(&remote_addr, &name_in->sin_addr); remote_port = name_in->sin_port; LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_connect(%d, addr=", s)); ip_addr_debug_print(SOCKETS_DEBUG, &remote_addr); LWIP_DEBUGF(SOCKETS_DEBUG, (" port=%"U16_F")\n", ntohs(remote_port))); err = netconn_connect(sock->conn, &remote_addr, ntohs(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)); 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; ip_addr_t *addr; u16_t port; 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 (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); /* 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 (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 (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) { ip_addr_t fromaddr; if (from && fromlen) { struct sockaddr_in sin; if (netconn_type(sock->conn) == NETCONN_TCP) { addr = &fromaddr; netconn_getaddr(sock->conn, addr, &port, 0); } else { addr = netbuf_fromaddr((struct netbuf *)buf); port = netbuf_fromport((struct netbuf *)buf); } memset(&sin, 0, sizeof(sin)); sin.sin_len = sizeof(sin); sin.sin_family = AF_INET; sin.sin_port = htons(port); inet_addr_from_ipaddr(&sin.sin_addr, addr); if (*fromlen > sizeof(sin)) { *fromlen = sizeof(sin); } MEMCPY(from, &sin, *fromlen); LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_recvfrom(%d): addr=", s)); ip_addr_debug_print(SOCKETS_DEBUG, addr); LWIP_DEBUGF(SOCKETS_DEBUG, (" port=%"U16_F" len=%d\n", port, off)); } else { #if SOCKETS_DEBUG if (netconn_type(sock->conn) == NETCONN_TCP) { addr = &fromaddr; netconn_getaddr(sock->conn, addr, &port, 0); } else { addr = netbuf_fromaddr((struct netbuf *)buf); port = netbuf_fromport((struct netbuf *)buf); } LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_recvfrom(%d): addr=", s)); ip_addr_debug_print(SOCKETS_DEBUG, addr); LWIP_DEBUGF(SOCKETS_DEBUG, (" port=%"U16_F" len=%d\n", port, off)); #endif /* SOCKETS_DEBUG */ } } /* 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 ((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 (netconn_type(sock->conn) == NETCONN_TCP) { pbuf_free((struct pbuf *)buf); } else { netbuf_delete((struct netbuf *)buf); } } } } while (!done); if (off > 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; 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 (sock->conn->type != 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) */ } if ((flags & MSG_DONTWAIT) || netconn_is_nonblocking(sock->conn)) { if ((size > TCP_SND_BUF) || ((size / TCP_MSS) > TCP_SND_QUEUELEN)) { /* too much data to ever send nonblocking! */ sock_set_errno(sock, EMSGSIZE); return -1; } } write_flags = NETCONN_COPY | ((flags & MSG_MORE) ? NETCONN_MORE : 0) | ((flags & MSG_DONTWAIT) ? NETCONN_DONTBLOCK : 0); err = netconn_write(sock->conn, data, size, write_flags); LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_send(%d) err=%d size=%"SZT_F"\n", s, err, size)); sock_set_errno(sock, err_to_errno(err)); return (err == ERR_OK ? (int)size : -1); } 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; const struct sockaddr_in *to_in; u16_t remote_port; #if !LWIP_TCPIP_CORE_LOCKING struct netbuf buf; #endif sock = get_socket(s); if (!sock) { return -1; } if (sock->conn->type == 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 */ } /* @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)) || ((tolen == sizeof(struct sockaddr_in)) && ((to->sa_family) == AF_INET) && ((((mem_ptr_t)to) % 4) == 0))), sock_set_errno(sock, err_to_errno(ERR_ARG)); return -1;); to_in = (const struct sockaddr_in *)(void*)to; #if LWIP_TCPIP_CORE_LOCKING /* Should only be consider like a sample or a simple way to experiment this option (no check of "to" field...) */ { struct pbuf* p; ip_addr_t *remote_addr; #if LWIP_NETIF_TX_SINGLE_PBUF p = pbuf_alloc(PBUF_TRANSPORT, short_size, PBUF_RAM); if (p != NULL) { #if LWIP_CHECKSUM_ON_COPY u16_t chksum = 0; if (sock->conn->type != NETCONN_RAW) { chksum = LWIP_CHKSUM_COPY(p->payload, data, short_size); } else #endif /* LWIP_CHECKSUM_ON_COPY */ MEMCPY(p->payload, data, size); #else /* LWIP_NETIF_TX_SINGLE_PBUF */ p = pbuf_alloc(PBUF_TRANSPORT, short_size, PBUF_REF); if (p != NULL) { p->payload = (void*)data; #endif /* LWIP_NETIF_TX_SINGLE_PBUF */ if (to_in != NULL) { inet_addr_to_ipaddr_p(remote_addr, &to_in->sin_addr); remote_port = ntohs(to_in->sin_port); } else { remote_addr = IP_ADDR_ANY; remote_port = 0; } LOCK_TCPIP_CORE(); if (sock->conn->type == NETCONN_RAW) { err = sock->conn->last_err = raw_sendto(sock->conn->pcb.raw, p, remote_addr); } else { #if LWIP_UDP #if LWIP_CHECKSUM_ON_COPY && LWIP_NETIF_TX_SINGLE_PBUF err = sock->conn->last_err = udp_sendto_chksum(sock->conn->pcb.udp, p, remote_addr, remote_port, 1, chksum); #else /* LWIP_CHECKSUM_ON_COPY && LWIP_NETIF_TX_SINGLE_PBUF */ err = sock->conn->last_err = udp_sendto(sock->conn->pcb.udp, p, remote_addr, remote_port); #endif /* LWIP_CHECKSUM_ON_COPY && LWIP_NETIF_TX_SINGLE_PBUF */ #else /* LWIP_UDP */ err = ERR_ARG; #endif /* LWIP_UDP */ } UNLOCK_TCPIP_CORE(); pbuf_free(p); } else { err = ERR_MEM; } } #else /* LWIP_TCPIP_CORE_LOCKING */ /* initialize a buffer */ buf.p = buf.ptr = NULL; #if LWIP_CHECKSUM_ON_COPY buf.flags = 0; #endif /* LWIP_CHECKSUM_ON_COPY */ if (to) { inet_addr_to_ipaddr(&buf.addr, &to_in->sin_addr); remote_port = ntohs(to_in->sin_port); netbuf_fromport(&buf) = remote_port; } else { remote_port = 0; ip_addr_set_any(&buf.addr); netbuf_fromport(&buf) = 0; } LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_sendto(%d, data=%p, short_size=%d"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 (sock->conn->type != NETCONN_RAW) { u16_t chksum = LWIP_CHKSUM_COPY(buf.p->payload, data, short_size); netbuf_set_chksum(&buf, chksum); err = ERR_OK; } else #endif /* LWIP_CHECKSUM_ON_COPY */ { err = netbuf_take(&buf, data, short_size); } } #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); #endif /* LWIP_TCPIP_CORE_LOCKING */ 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; LWIP_UNUSED_ARG(domain); /* create a netconn */ switch (type) { case SOCK_RAW: conn = netconn_new_with_proto_and_callback(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( (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(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); } /** * 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. * * exceptset is not used for now!!! * * @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 = 0; i < maxfdp1; i++) { void* lastdata = NULL; s16_t rcvevent = 0; u16_t sendevent = 0; u16_t errevent = 0; /* First get the socket's status (protected)... */ SYS_ARCH_PROTECT(lev); sock = tryget_socket(i); if (sock != NULL) { lastdata = sock->lastdata; rcvevent = sock->rcvevent; sendevent = sock->sendevent; 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++; } } /* 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; } /** * Processing exceptset is not yet implemented. */ 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; err_t err; int i; 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; err = sys_sem_new(&select_cb.sem, 0); if (err != ERR_OK) { /* failed to create semaphore */ set_errno(ENOMEM); return -1; } /* 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 even_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 */ for(i = 0; i < maxfdp1; i++) { if ((readset && FD_ISSET(i, readset)) || (writeset && FD_ISSET(i, writeset)) || (exceptset && FD_ISSET(i, exceptset))) { struct lwip_sock *sock = tryget_socket(i); LWIP_ASSERT("sock != NULL", sock != NULL); SYS_ARCH_PROTECT(lev); sock->select_waiting++; LWIP_ASSERT("sock->select_waiting > 0", sock->select_waiting > 0); SYS_ARCH_UNPROTECT(lev); } } /* Call lwip_selscan again: there could have been events between the last scan (whithout 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_cb.sem, msectimeout); } /* Increase select_waiting for each socket we are interested in */ for(i = 0; i < maxfdp1; i++) { if ((readset && FD_ISSET(i, readset)) || (writeset && FD_ISSET(i, writeset)) || (exceptset && FD_ISSET(i, exceptset))) { struct lwip_sock *sock = tryget_socket(i); LWIP_ASSERT("sock != NULL", sock != NULL); SYS_ARCH_PROTECT(lev); sock->select_waiting--; LWIP_ASSERT("sock->select_waiting >= 0", sock->select_waiting >= 0); 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 even_callback that the list has changed. */ select_cb_ctr++; SYS_ARCH_UNPROTECT(lev); sys_sem_free(&select_cb.sem); 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) { 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, invalidagin the semaphore. */ sys_sem_signal(&scb->sem); } } /* unlock interrupts with each step */ last_select_cb_ctr = select_cb_ctr; 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) { 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 (netconn_type(sock->conn) != NETCONN_TCP) { sock_set_errno(sock, EOPNOTSUPP); return EOPNOTSUPP; } } else { sock_set_errno(sock, ENOTCONN); return ENOTCONN; } 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 EINVAL; } err = netconn_shutdown(sock->conn, shut_rx, shut_tx); sock_set_errno(sock, err_to_errno(err)); return (err == ERR_OK ? 0 : -1); } static int lwip_getaddrname(int s, struct sockaddr *name, socklen_t *namelen, u8_t local) { struct lwip_sock *sock; struct sockaddr_in sin; ip_addr_t naddr; sock = get_socket(s); if (!sock) { return -1; } memset(&sin, 0, sizeof(sin)); sin.sin_len = sizeof(sin); sin.sin_family = AF_INET; /* get the IP address and port */ netconn_getaddr(sock->conn, &naddr, &sin.sin_port, local); LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_getaddrname(%d, addr=", s)); ip_addr_debug_print(SOCKETS_DEBUG, &naddr); LWIP_DEBUGF(SOCKETS_DEBUG, (" port=%"U16_F")\n", sin.sin_port)); sin.sin_port = htons(sin.sin_port); inet_addr_from_ipaddr(&sin.sin_addr, &naddr); if (*namelen > sizeof(sin)) { *namelen = sizeof(sin); } MEMCPY(name, &sin, *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) { err_t err = ERR_OK; struct lwip_sock *sock = get_socket(s); struct lwip_setgetsockopt_data data; if (!sock) { return -1; } if ((NULL == optval) || (NULL == optlen)) { sock_set_errno(sock, EFAULT); return -1; } /* Do length and type checks for the various options first, to keep it readable. */ switch (level) { /* Level: SOL_SOCKET */ case SOL_SOCKET: switch (optname) { case SO_ACCEPTCONN: case SO_BROADCAST: /* UNIMPL case SO_DEBUG: */ /* UNIMPL case SO_DONTROUTE: */ case SO_ERROR: case SO_KEEPALIVE: /* UNIMPL case SO_CONTIMEO: */ /* UNIMPL case SO_SNDTIMEO: */ #if LWIP_SO_RCVTIMEO case SO_RCVTIMEO: #endif /* LWIP_SO_RCVTIMEO */ #if LWIP_SO_RCVBUF case SO_RCVBUF: #endif /* LWIP_SO_RCVBUF */ /* UNIMPL case SO_OOBINLINE: */ /* UNIMPL case SO_SNDBUF: */ /* UNIMPL case SO_RCVLOWAT: */ /* UNIMPL case SO_SNDLOWAT: */ #if SO_REUSE case SO_REUSEADDR: case SO_REUSEPORT: #endif /* SO_REUSE */ case SO_TYPE: /* UNIMPL case SO_USELOOPBACK: */ if (*optlen < sizeof(int)) { err = EINVAL; } break; case SO_NO_CHECK: if (*optlen < sizeof(int)) { err = EINVAL; } #if LWIP_UDP if ((sock->conn->type != NETCONN_UDP) || ((udp_flags(sock->conn->pcb.udp) & UDP_FLAGS_UDPLITE) != 0)) { /* this flag is only available for UDP, not for UDP lite */ err = EAFNOSUPPORT; } #endif /* LWIP_UDP */ break; default: LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_getsockopt(%d, SOL_SOCKET, UNIMPL: optname=0x%x, ..)\n", s, optname)); err = ENOPROTOOPT; } /* switch (optname) */ break; /* Level: IPPROTO_IP */ case IPPROTO_IP: switch (optname) { /* UNIMPL case IP_HDRINCL: */ /* UNIMPL case IP_RCVDSTADDR: */ /* UNIMPL case IP_RCVIF: */ case IP_TTL: case IP_TOS: if (*optlen < sizeof(int)) { err = EINVAL; } break; #if LWIP_IGMP case IP_MULTICAST_TTL: if (*optlen < sizeof(u8_t)) { err = EINVAL; } break; case IP_MULTICAST_IF: if (*optlen < sizeof(struct in_addr)) { err = EINVAL; } break; case IP_MULTICAST_LOOP: if (*optlen < sizeof(u8_t)) { err = EINVAL; } if (NETCONNTYPE_GROUP(sock->conn->type) != NETCONN_UDP) { err = EAFNOSUPPORT; } break; #endif /* LWIP_IGMP */ default: LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_getsockopt(%d, IPPROTO_IP, UNIMPL: optname=0x%x, ..)\n", s, optname)); err = ENOPROTOOPT; } /* switch (optname) */ break; #if LWIP_TCP /* Level: IPPROTO_TCP */ case IPPROTO_TCP: if (*optlen < sizeof(int)) { err = EINVAL; break; } /* If this is no TCP socket, ignore any options. */ if (sock->conn->type != NETCONN_TCP) return 0; switch (optname) { case TCP_NODELAY: case TCP_KEEPALIVE: #if LWIP_TCP_KEEPALIVE case TCP_KEEPIDLE: case TCP_KEEPINTVL: case TCP_KEEPCNT: #endif /* LWIP_TCP_KEEPALIVE */ break; default: LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_getsockopt(%d, IPPROTO_TCP, UNIMPL: optname=0x%x, ..)\n", s, optname)); err = ENOPROTOOPT; } /* switch (optname) */ break; #endif /* LWIP_TCP */ #if LWIP_UDP && LWIP_UDPLITE /* Level: IPPROTO_UDPLITE */ case IPPROTO_UDPLITE: if (*optlen < sizeof(int)) { err = EINVAL; break; } /* If this is no UDP lite socket, ignore any options. */ if (sock->conn->type != NETCONN_UDPLITE) { return 0; } switch (optname) { case UDPLITE_SEND_CSCOV: case UDPLITE_RECV_CSCOV: break; default: LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_getsockopt(%d, IPPROTO_UDPLITE, UNIMPL: optname=0x%x, ..)\n", s, optname)); err = ENOPROTOOPT; } /* switch (optname) */ break; #endif /* LWIP_UDP && LWIP_UDPLITE*/ /* UNDEFINED LEVEL */ default: LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_getsockopt(%d, level=0x%x, UNIMPL: optname=0x%x, ..)\n", s, level, optname)); err = ENOPROTOOPT; } /* switch */ if (err != ERR_OK) { sock_set_errno(sock, err); return -1; } /* Now do the actual option processing */ data.sock = sock; #ifdef LWIP_DEBUG data.s = s; #endif /* LWIP_DEBUG */ data.level = level; data.optname = optname; data.optval = optval; data.optlen = optlen; data.err = err; tcpip_callback(lwip_getsockopt_internal, &data); sys_arch_sem_wait(&sock->conn->op_completed, 0); /* maybe lwip_getsockopt_internal has changed err */ err = data.err; sock_set_errno(sock, err); return err ? -1 : 0; } static void lwip_getsockopt_internal(void *arg) { struct lwip_sock *sock; #ifdef LWIP_DEBUG int s; #endif /* LWIP_DEBUG */ int level, optname; void *optval; struct lwip_setgetsockopt_data *data; LWIP_ASSERT("arg != NULL", arg != NULL); data = (struct lwip_setgetsockopt_data*)arg; sock = data->sock; #ifdef LWIP_DEBUG s = data->s; #endif /* LWIP_DEBUG */ level = data->level; optname = data->optname; optval = data->optval; switch (level) { /* Level: SOL_SOCKET */ case SOL_SOCKET: switch (optname) { /* The option flags */ case SO_ACCEPTCONN: case SO_BROADCAST: /* UNIMPL case SO_DEBUG: */ /* UNIMPL case SO_DONTROUTE: */ case SO_KEEPALIVE: /* UNIMPL case SO_OOBINCLUDE: */ #if SO_REUSE case SO_REUSEADDR: case SO_REUSEPORT: #endif /* SO_REUSE */ /*case SO_USELOOPBACK: UNIMPL */ *(int*)optval = sock->conn->pcb.ip->so_options & 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: switch (NETCONNTYPE_GROUP(sock->conn->type)) { 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 = sock->conn->type; LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_getsockopt(%d, SOL_SOCKET, SO_TYPE): unrecognized socket type %d\n", s, *(int *)optval)); } /* switch (sock->conn->type) */ LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_getsockopt(%d, SOL_SOCKET, SO_TYPE) = %d\n", s, *(int *)optval)); break; case SO_ERROR: /* only overwrite ERR_OK or tempoary errors */ if ((sock->err == 0) || (sock->err == EINPROGRESS)) { sock_set_errno(sock, err_to_errno(sock->conn->last_err)); } *(int *)optval = 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_RCVTIMEO case SO_RCVTIMEO: *(int *)optval = netconn_get_recvtimeout(sock->conn); break; #endif /* LWIP_SO_RCVTIMEO */ #if LWIP_SO_RCVBUF case SO_RCVBUF: *(int *)optval = netconn_get_recvbufsize(sock->conn); break; #endif /* LWIP_SO_RCVBUF */ #if LWIP_UDP case SO_NO_CHECK: *(int*)optval = (udp_flags(sock->conn->pcb.udp) & UDP_FLAGS_NOCHKSUM) ? 1 : 0; break; #endif /* LWIP_UDP*/ default: LWIP_ASSERT("unhandled optname", 0); break; } /* switch (optname) */ break; /* Level: IPPROTO_IP */ case IPPROTO_IP: switch (optname) { case IP_TTL: *(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: *(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_IGMP case IP_MULTICAST_TTL: *(u8_t*)optval = sock->conn->pcb.ip->ttl; LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_getsockopt(%d, IPPROTO_IP, IP_MULTICAST_TTL) = %d\n", s, *(int *)optval)); break; case IP_MULTICAST_IF: inet_addr_from_ipaddr((struct in_addr*)optval, &sock->conn->pcb.udp->multicast_ip); 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: 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_IGMP */ default: LWIP_ASSERT("unhandled optname", 0); break; } /* switch (optname) */ break; #if LWIP_TCP /* Level: IPPROTO_TCP */ case IPPROTO_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_IP, 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_IP, 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_IP, 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_IP, TCP_KEEPCNT) = %d\n", s, *(int *)optval)); break; #endif /* LWIP_TCP_KEEPALIVE */ default: LWIP_ASSERT("unhandled optname", 0); break; } /* switch (optname) */ break; #endif /* LWIP_TCP */ #if LWIP_UDP && LWIP_UDPLITE /* Level: IPPROTO_UDPLITE */ case IPPROTO_UDPLITE: 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_ASSERT("unhandled optname", 0); break; } /* switch (optname) */ break; #endif /* LWIP_UDP */ default: LWIP_ASSERT("unhandled level", 0); break; } /* switch (level) */ sys_sem_signal(&sock->conn->op_completed); } int lwip_setsockopt(int s, int level, int optname, const void *optval, socklen_t optlen) { struct lwip_sock *sock = get_socket(s); err_t err = ERR_OK; struct lwip_setgetsockopt_data data; if (!sock) { return -1; } if (NULL == optval) { sock_set_errno(sock, EFAULT); return -1; } /* Do length and type checks for the various options first, to keep it readable. */ switch (level) { /* Level: SOL_SOCKET */ case SOL_SOCKET: switch (optname) { case SO_BROADCAST: /* UNIMPL case SO_DEBUG: */ /* UNIMPL case SO_DONTROUTE: */ case SO_KEEPALIVE: /* UNIMPL case case SO_CONTIMEO: */ /* UNIMPL case case SO_SNDTIMEO: */ #if LWIP_SO_RCVTIMEO case SO_RCVTIMEO: #endif /* LWIP_SO_RCVTIMEO */ #if LWIP_SO_RCVBUF case SO_RCVBUF: #endif /* LWIP_SO_RCVBUF */ /* UNIMPL case SO_OOBINLINE: */ /* UNIMPL case SO_SNDBUF: */ /* UNIMPL case SO_RCVLOWAT: */ /* UNIMPL case SO_SNDLOWAT: */ #if SO_REUSE case SO_REUSEADDR: case SO_REUSEPORT: #endif /* SO_REUSE */ /* UNIMPL case SO_USELOOPBACK: */ if (optlen < sizeof(int)) { err = EINVAL; } break; case SO_NO_CHECK: if (optlen < sizeof(int)) { err = EINVAL; } #if LWIP_UDP if ((sock->conn->type != NETCONN_UDP) || ((udp_flags(sock->conn->pcb.udp) & UDP_FLAGS_UDPLITE) != 0)) { /* this flag is only available for UDP, not for UDP lite */ err = EAFNOSUPPORT; } #endif /* LWIP_UDP */ break; default: LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_setsockopt(%d, SOL_SOCKET, UNIMPL: optname=0x%x, ..)\n", s, optname)); err = ENOPROTOOPT; } /* switch (optname) */ break; /* Level: IPPROTO_IP */ case IPPROTO_IP: switch (optname) { /* UNIMPL case IP_HDRINCL: */ /* UNIMPL case IP_RCVDSTADDR: */ /* UNIMPL case IP_RCVIF: */ case IP_TTL: case IP_TOS: if (optlen < sizeof(int)) { err = EINVAL; } break; #if LWIP_IGMP case IP_MULTICAST_TTL: if (optlen < sizeof(u8_t)) { err = EINVAL; } if (NETCONNTYPE_GROUP(sock->conn->type) != NETCONN_UDP) { err = EAFNOSUPPORT; } break; case IP_MULTICAST_IF: if (optlen < sizeof(struct in_addr)) { err = EINVAL; } if (NETCONNTYPE_GROUP(sock->conn->type) != NETCONN_UDP) { err = EAFNOSUPPORT; } break; case IP_MULTICAST_LOOP: if (optlen < sizeof(u8_t)) { err = EINVAL; } if (NETCONNTYPE_GROUP(sock->conn->type) != NETCONN_UDP) { err = EAFNOSUPPORT; } break; case IP_ADD_MEMBERSHIP: case IP_DROP_MEMBERSHIP: if (optlen < sizeof(struct ip_mreq)) { err = EINVAL; } if (NETCONNTYPE_GROUP(sock->conn->type) != NETCONN_UDP) { err = EAFNOSUPPORT; } break; #endif /* LWIP_IGMP */ default: LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_setsockopt(%d, IPPROTO_IP, UNIMPL: optname=0x%x, ..)\n", s, optname)); err = ENOPROTOOPT; } /* switch (optname) */ break; #if LWIP_TCP /* Level: IPPROTO_TCP */ case IPPROTO_TCP: if (optlen < sizeof(int)) { err = EINVAL; break; } /* If this is no TCP socket, ignore any options. */ if (sock->conn->type != NETCONN_TCP) return 0; switch (optname) { case TCP_NODELAY: case TCP_KEEPALIVE: #if LWIP_TCP_KEEPALIVE case TCP_KEEPIDLE: case TCP_KEEPINTVL: case TCP_KEEPCNT: #endif /* LWIP_TCP_KEEPALIVE */ break; default: LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_setsockopt(%d, IPPROTO_TCP, UNIMPL: optname=0x%x, ..)\n", s, optname)); err = ENOPROTOOPT; } /* switch (optname) */ break; #endif /* LWIP_TCP */ #if LWIP_UDP && LWIP_UDPLITE /* Level: IPPROTO_UDPLITE */ case IPPROTO_UDPLITE: if (optlen < sizeof(int)) { err = EINVAL; break; } /* If this is no UDP lite socket, ignore any options. */ if (sock->conn->type != NETCONN_UDPLITE) return 0; switch (optname) { case UDPLITE_SEND_CSCOV: case UDPLITE_RECV_CSCOV: break; default: LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_setsockopt(%d, IPPROTO_UDPLITE, UNIMPL: optname=0x%x, ..)\n", s, optname)); err = ENOPROTOOPT; } /* switch (optname) */ break; #endif /* LWIP_UDP && LWIP_UDPLITE */ /* UNDEFINED LEVEL */ default: LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_setsockopt(%d, level=0x%x, UNIMPL: optname=0x%x, ..)\n", s, level, optname)); err = ENOPROTOOPT; } /* switch (level) */ if (err != ERR_OK) { sock_set_errno(sock, err); return -1; } /* Now do the actual option processing */ data.sock = sock; #ifdef LWIP_DEBUG data.s = s; #endif /* LWIP_DEBUG */ data.level = level; data.optname = optname; data.optval = (void*)optval; data.optlen = &optlen; data.err = err; tcpip_callback(lwip_setsockopt_internal, &data); sys_arch_sem_wait(&sock->conn->op_completed, 0); /* maybe lwip_setsockopt_internal has changed err */ err = data.err; sock_set_errno(sock, err); return err ? -1 : 0; } static void lwip_setsockopt_internal(void *arg) { struct lwip_sock *sock; #ifdef LWIP_DEBUG int s; #endif /* LWIP_DEBUG */ int level, optname; const void *optval; struct lwip_setgetsockopt_data *data; LWIP_ASSERT("arg != NULL", arg != NULL); data = (struct lwip_setgetsockopt_data*)arg; sock = data->sock; #ifdef LWIP_DEBUG s = data->s; #endif /* LWIP_DEBUG */ level = data->level; optname = data->optname; optval = data->optval; switch (level) { /* Level: SOL_SOCKET */ case SOL_SOCKET: switch (optname) { /* The option flags */ case SO_BROADCAST: /* UNIMPL case SO_DEBUG: */ /* UNIMPL case SO_DONTROUTE: */ case SO_KEEPALIVE: /* UNIMPL case SO_OOBINCLUDE: */ #if SO_REUSE case SO_REUSEADDR: case SO_REUSEPORT: #endif /* SO_REUSE */ /* UNIMPL case SO_USELOOPBACK: */ if (*(int*)optval) { sock->conn->pcb.ip->so_options |= optname; } else { sock->conn->pcb.ip->so_options &= ~optname; } LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_setsockopt(%d, SOL_SOCKET, optname=0x%x, ..) -> %s\n", s, optname, (*(int*)optval?"on":"off"))); break; #if LWIP_SO_RCVTIMEO case SO_RCVTIMEO: netconn_set_recvtimeout(sock->conn, *(int*)optval); break; #endif /* LWIP_SO_RCVTIMEO */ #if LWIP_SO_RCVBUF case SO_RCVBUF: netconn_set_recvbufsize(sock->conn, *(int*)optval); break; #endif /* LWIP_SO_RCVBUF */ #if LWIP_UDP case SO_NO_CHECK: if (*(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_ASSERT("unhandled optname", 0); break; } /* switch (optname) */ break; /* Level: IPPROTO_IP */ case IPPROTO_IP: switch (optname) { case IP_TTL: sock->conn->pcb.ip->ttl = (u8_t)(*(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: sock->conn->pcb.ip->tos = (u8_t)(*(int*)optval); LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_setsockopt(%d, IPPROTO_IP, IP_TOS, ..)-> %d\n", s, sock->conn->pcb.ip->tos)); break; #if LWIP_IGMP case IP_MULTICAST_TTL: sock->conn->pcb.udp->ttl = (u8_t)(*(u8_t*)optval); break; case IP_MULTICAST_IF: inet_addr_to_ipaddr(&sock->conn->pcb.udp->multicast_ip, (struct in_addr*)optval); break; case IP_MULTICAST_LOOP: if (*(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; case IP_ADD_MEMBERSHIP: case IP_DROP_MEMBERSHIP: { /* If this is a TCP or a RAW socket, ignore these options. */ struct ip_mreq *imr = (struct ip_mreq *)optval; ip_addr_t if_addr; ip_addr_t multi_addr; inet_addr_to_ipaddr(&if_addr, &imr->imr_interface); inet_addr_to_ipaddr(&multi_addr, &imr->imr_multiaddr); if(optname == IP_ADD_MEMBERSHIP){ data->err = igmp_joingroup(&if_addr, &multi_addr); } else { data->err = igmp_leavegroup(&if_addr, &multi_addr); } if(data->err != ERR_OK) { data->err = EADDRNOTAVAIL; } } break; #endif /* LWIP_IGMP */ default: LWIP_ASSERT("unhandled optname", 0); break; } /* switch (optname) */ break; #if LWIP_TCP /* Level: IPPROTO_TCP */ case IPPROTO_TCP: switch (optname) { case TCP_NODELAY: if (*(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, (*(int *)optval)?"on":"off") ); break; case TCP_KEEPALIVE: sock->conn->pcb.tcp->keep_idle = (u32_t)(*(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)(*(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)(*(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)(*(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_ASSERT("unhandled optname", 0); break; } /* switch (optname) */ break; #endif /* LWIP_TCP*/ #if LWIP_UDP && LWIP_UDPLITE /* Level: IPPROTO_UDPLITE */ case IPPROTO_UDPLITE: switch (optname) { case UDPLITE_SEND_CSCOV: if ((*(int*)optval != 0) && ((*(int*)optval < 8)) || (*(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)*(int*)optval; } LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_setsockopt(%d, IPPROTO_UDPLITE, UDPLITE_SEND_CSCOV) -> %d\n", s, (*(int*)optval)) ); break; case UDPLITE_RECV_CSCOV: if ((*(int*)optval != 0) && ((*(int*)optval < 8)) || (*(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)*(int*)optval; } LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_setsockopt(%d, IPPROTO_UDPLITE, UDPLITE_RECV_CSCOV) -> %d\n", s, (*(int*)optval)) ); break; default: LWIP_ASSERT("unhandled optname", 0); break; } /* switch (optname) */ break; #endif /* LWIP_UDP */ default: LWIP_ASSERT("unhandled level", 0); break; } /* switch (level) */ sys_sem_signal(&sock->conn->op_completed); } 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; s16_t recv_avail; #endif /* LWIP_SO_RCVBUF */ if (!sock) { return -1; } switch (cmd) { #if LWIP_SO_RCVBUF case FIONREAD: if (!argp) { sock_set_errno(sock, EINVAL); return -1; } SYS_ARCH_GET(sock->conn->recv_avail, recv_avail); if (recv_avail < 0) { recv_avail = 0; } *((u16_t*)argp) = (u16_t)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 (netconn_type(sock->conn) != NETCONN_TCP) { p = ((struct netbuf *)p)->p; } buflen = p->tot_len; buflen -= sock->lastoffset; *((u16_t*)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; #endif /* LWIP_SO_RCVBUF */ case 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: 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; } /* switch (cmd) */ } /** 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 || !sock->conn) { return -1; } switch (cmd) { case F_GETFL: ret = netconn_is_nonblocking(sock->conn) ? O_NONBLOCK : 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; } break; default: LWIP_DEBUGF(SOCKETS_DEBUG, ("lwip_fcntl(%d, UNIMPL: %d, %d)\n", s, cmd, val)); break; } return ret; } #endif /* LWIP_SOCKET */ ================================================ FILE: app/lwip/api/tcpip.c ================================================ /** * @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/sys.h" #include "lwip/memp.h" #include "lwip/mem.h" #include "lwip/pbuf.h" #include "lwip/tcpip.h" #include "lwip/init.h" #include "netif/etharp.h" #include "netif/ppp_oe.h" /* global variables */ 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(); switch (msg->type) { #if LWIP_NETCONN case TCPIP_MSG_API://API LWIP_DEBUGF(TCPIP_DEBUG, ("tcpip_thread: API message %p\n", (void *)msg)); msg->msg.apimsg->function(&(msg->msg.apimsg->msg)); break; #endif /* LWIP_NETCONN */ #if !LWIP_TCPIP_CORE_LOCKING_INPUT case TCPIP_MSG_INPKT://ײݰ LWIP_DEBUGF(TCPIP_DEBUG, ("tcpip_thread: PACKET %p\n", (void *)msg)); #if LWIP_ETHERNET if (msg->msg.inp.netif->flags & (NETIF_FLAG_ETHARP | NETIF_FLAG_ETHERNET)) {//֧ARP ethernet_input(msg->msg.inp.p, msg->msg.inp.netif);//ARP } else #endif /* LWIP_ETHERNET */ { ip_input(msg->msg.inp.p, msg->msg.inp.netif);//IP } memp_free(MEMP_TCPIP_MSG_INPKT, msg); break; #endif /* LWIP_TCPIP_CORE_LOCKING_INPUT */ #if LWIP_NETIF_API case TCPIP_MSG_NETIFAPI: LWIP_DEBUGF(TCPIP_DEBUG, ("tcpip_thread: Netif API message %p\n", (void *)msg)); msg->msg.netifapimsg->function(&(msg->msg.netifapimsg->msg)); break; #endif /* LWIP_NETIF_API */ 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; #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 */ 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, 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_TCPIP_CORE_LOCKING_INPUT err_t ret; LWIP_DEBUGF(TCPIP_DEBUG, ("tcpip_input: PACKET %p/%p\n", (void *)p, (void *)inp)); LOCK_TCPIP_CORE(); #if LWIP_ETHERNET if (inp->flags & (NETIF_FLAG_ETHARP | NETIF_FLAG_ETHERNET)) { ret = ethernet_input(p, inp); } else #endif /* LWIP_ETHERNET */ { ret = ip_input(p, inp); } UNLOCK_TCPIP_CORE(); return ret; #else /* LWIP_TCPIP_CORE_LOCKING_INPUT */ struct tcpip_msg *msg; if (sys_mbox_valid(&mbox)) { 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; if (sys_mbox_trypost(&mbox, msg) != ERR_OK) { memp_free(MEMP_TCPIP_MSG_INPKT, msg); return ERR_MEM; } return ERR_OK; } return ERR_VAL; #endif /* LWIP_TCPIP_CORE_LOCKING_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(&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(&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(&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_NETCONN /** * 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 */ err_t tcpip_apimsg(struct api_msg *apimsg) { struct tcpip_msg msg; #ifdef LWIP_DEBUG /* catch functions that don't set err */ apimsg->msg.err = ERR_VAL; #endif if (sys_mbox_valid(&mbox)) {//ںЧ msg.type = TCPIP_MSG_API; msg.msg.apimsg = apimsg; sys_mbox_post(&mbox, &msg);//ͶϢ sys_arch_sem_wait(&apimsg->msg.conn->op_completed, 0);//ȴϢ return apimsg->msg.err; } return ERR_VAL; } #if LWIP_TCPIP_CORE_LOCKING /** * Call the lower part of a netconn_* function * This function has exclusive access to lwIP core code by locking it * before the function is called. * * @param apimsg a struct containing the function to call and its parameters * @return ERR_OK (only for compatibility fo tcpip_apimsg()) */ err_t tcpip_apimsg_lock(struct api_msg *apimsg) { #ifdef LWIP_DEBUG /* catch functions that don't set err */ apimsg->msg.err = ERR_VAL; #endif LOCK_TCPIP_CORE(); apimsg->function(&(apimsg->msg)); UNLOCK_TCPIP_CORE(); return apimsg->msg.err; } #endif /* LWIP_TCPIP_CORE_LOCKING */ #endif /* LWIP_NETCONN */ #if LWIP_NETIF_API #if !LWIP_TCPIP_CORE_LOCKING /** * Much like tcpip_apimsg, but calls the lower part of a netifapi_* * function. * * @param netifapimsg a struct containing the function to call and its parameters * @return error code given back by the function that was called */ err_t tcpip_netifapi(struct netifapi_msg* netifapimsg) { struct tcpip_msg msg; if (sys_mbox_valid(&mbox)) { err_t err = sys_sem_new(&netifapimsg->msg.sem, 0); if (err != ERR_OK) { netifapimsg->msg.err = err; return err; } msg.type = TCPIP_MSG_NETIFAPI; msg.msg.netifapimsg = netifapimsg; sys_mbox_post(&mbox, &msg); sys_sem_wait(&netifapimsg->msg.sem); sys_sem_free(&netifapimsg->msg.sem); return netifapimsg->msg.err; } return ERR_VAL; } #else /* !LWIP_TCPIP_CORE_LOCKING */ /** * Call the lower part of a netifapi_* function * This function has exclusive access to lwIP core code by locking it * before the function is called. * * @param netifapimsg a struct containing the function to call and its parameters * @return ERR_OK (only for compatibility fo tcpip_netifapi()) */ err_t tcpip_netifapi_lock(struct netifapi_msg* netifapimsg) { LOCK_TCPIP_CORE(); netifapimsg->function(&(netifapimsg->msg)); UNLOCK_TCPIP_CORE(); return netifapimsg->msg.err; } #endif /* !LWIP_TCPIP_CORE_LOCKING */ #endif /* LWIP_NETIF_API */ /** * 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 */ sys_thread_new(TCPIP_THREAD_NAME, tcpip_thread, NULL, TCPIP_THREAD_STACKSIZE, TCPIP_THREAD_PRIO);//ں˽ } /** * 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 */ err_t mem_free_callback(void *m) { return tcpip_callback_with_block(mem_free, m, 0); } #endif /* !NO_SYS */ ================================================ FILE: app/lwip/app/Makefile ================================================ ############################################################# # Required variables for each makefile # Discard this section from all parent makefiles # Expected variables (with automatic defaults): # CSRCS (all "C" files in the dir) # SUBDIRS (all subdirs with a Makefile) # GEN_LIBS - list of libs to be generated () # GEN_IMAGES - list of images to be generated () # COMPONENTS_xxx - a list of libs/objs in the form # subdir/lib to be extracted and rolled up into # a generated lib/image xxx.a () # ifndef PDIR GEN_LIBS = liblwipapp.a endif ############################################################# # Configuration i.e. compile options etc. # Target specific stuff (defines etc.) goes in here! # Generally values applying to a tree are captured in the # makefile at its root level - these are then overridden # for a subtree within the makefile rooted therein # #DEFINES += ############################################################# # Recursion Magic - Don't touch this!! # # Each subtree potentially has an include directory # corresponding to the common APIs applicable to modules # rooted at that subtree. Accordingly, the INCLUDE PATH # of a module can only contain the include directories up # its parent path, and not its siblings # # Required for each makefile to inherit from the parent # INCLUDES := $(INCLUDES) -I $(PDIR)include INCLUDES += -I ./ PDIR := ../$(PDIR) sinclude $(PDIR)Makefile ================================================ FILE: app/lwip/app/dhcpserver.c ================================================ #include "lwip/inet.h" #include "lwip/err.h" #include "lwip/pbuf.h" #include "lwip/udp.h" #include "lwip/mem.h" //#include "crypto/common.h" #include "osapi.h" #include "lwip/app/dhcpserver.h" #ifndef LWIP_OPEN_SRC #include "net80211/ieee80211_var.h" #endif #include "user_interface.h" #ifdef MEMLEAK_DEBUG static const char mem_debug_file[] ICACHE_RODATA_ATTR = __FILE__; #endif //////////////////////////////////////////////////////////////////////////////////// //static const uint8_t xid[4] = {0xad, 0xde, 0x12, 0x23}; //static u8_t old_xid[4] = {0}; static const uint32 magic_cookie ICACHE_RODATA_ATTR = 0x63538263; static struct udp_pcb *pcb_dhcps = NULL; static struct ip_addr broadcast_dhcps; static struct ip_addr server_address; static struct ip_addr client_address;//added static struct ip_addr client_address_plus; static struct dhcps_lease dhcps_lease; //static bool dhcps_lease_flag = true; static list_node *plist = NULL; static uint8 offer = 0xFF; static bool renew = false; #define DHCPS_LEASE_TIME_DEF (120) uint32 dhcps_lease_time = DHCPS_LEASE_TIME_DEF; //minute /****************************************************************************** * 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 ICACHE_FLASH_ATTR 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 ICACHE_FLASH_ATTR 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; } else { while (plist != NULL) { if (plist->pnext == pdelete){ plist->pnext = pdelete->pnext; } plist = plist->pnext; } } } } /////////////////////////////////////////////////////////////////////////////////// /* * ��DHCP msg��Ϣ�ṹ���������� * * @param optptr -- DHCP msg��Ϣλ�� * @param type -- Ҫ��ӵ�����option * * @return uint8_t* ����DHCP msgƫ�Ƶ�ַ */ /////////////////////////////////////////////////////////////////////////////////// static uint8_t* ICACHE_FLASH_ATTR add_msg_type(uint8_t *optptr, uint8_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 uint8_t* ICACHE_FLASH_ATTR add_offer_options(uint8_t *optptr) { struct ip_addr ipadd; ipadd.addr = *( (uint32_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; os_bzero(&if_ip, sizeof(struct ip_info)); wifi_get_ip_info(SOFTAP_IF, &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 uint8_t* ICACHE_FLASH_ATTR add_end(uint8_t *optptr) { *optptr++ = DHCP_OPTION_END; return optptr; } /////////////////////////////////////////////////////////////////////////////////// /////////////////////////////////////////////////////////////////////////////////// static void ICACHE_FLASH_ATTR create_msg(struct dhcps_msg *m) { struct ip_addr 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); os_memcpy((char *) m->yiaddr, (char *) &client.addr, sizeof(m->yiaddr)); os_memset((char *) m->ciaddr, 0, sizeof(m->ciaddr)); os_memset((char *) m->siaddr, 0, sizeof(m->siaddr)); os_memset((char *) m->giaddr, 0, sizeof(m->giaddr)); os_memset((char *) m->sname, 0, sizeof(m->sname)); os_memset((char *) m->file, 0, sizeof(m->file)); os_memset((char *) m->options, 0, sizeof(m->options)); os_memcpy((char *) m->options, &magic_cookie, sizeof(magic_cookie)); } /////////////////////////////////////////////////////////////////////////////////// /* * ����һ��OFFER * * @param -- m ָ����Ҫ���͵�DHCP msg���� */ /////////////////////////////////////////////////////////////////////////////////// static void ICACHE_FLASH_ATTR send_offer(struct dhcps_msg *m) { uint8_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 os_printf("udhcp: send_offer>>p->ref = %d\n", p->ref); #endif if(p != NULL){ #if DHCPS_DEBUG os_printf("dhcps: send_offer>>pbuf_alloc succeed\n"); os_printf("dhcps: send_offer>>p->tot_len = %d\n", p->tot_len); os_printf("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 os_printf("%02x ",data[i]); if((i+1)%16 == 0){ os_printf("\n"); } #endif } q = q->next; } }else{ #if DHCPS_DEBUG os_printf("dhcps: send_offer>>pbuf_alloc failed\n"); #endif return; } SendOffer_err_t = udp_sendto( pcb_dhcps, p, &broadcast_dhcps, DHCPS_CLIENT_PORT ); #if DHCPS_DEBUG os_printf("dhcps: send_offer>>udp_sendto result %x\n",SendOffer_err_t); #endif if(p->ref != 0){ #if DHCPS_DEBUG os_printf("udhcp: send_offer>>free pbuf\n"); #endif pbuf_free(p); } } /////////////////////////////////////////////////////////////////////////////////// /* * ����һ��NAK��Ϣ * * @param m ָ����Ҫ���͵�DHCP msg���� */ /////////////////////////////////////////////////////////////////////////////////// static void ICACHE_FLASH_ATTR 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 os_printf("udhcp: send_nak>>p->ref = %d\n", p->ref); #endif if(p != NULL){ #if DHCPS_DEBUG os_printf("dhcps: send_nak>>pbuf_alloc succeed\n"); os_printf("dhcps: send_nak>>p->tot_len = %d\n", p->tot_len); os_printf("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 os_printf("%02x ",data[i]); if((i+1)%16 == 0){ os_printf("\n"); } #endif } q = q->next; } }else{ #if DHCPS_DEBUG os_printf("dhcps: send_nak>>pbuf_alloc failed\n"); #endif return; } SendNak_err_t = udp_sendto( pcb_dhcps, p, &broadcast_dhcps, DHCPS_CLIENT_PORT ); #if DHCPS_DEBUG os_printf("dhcps: send_nak>>udp_sendto result %x\n",SendNak_err_t); #endif if(p->ref != 0){ #if DHCPS_DEBUG os_printf("udhcp: send_nak>>free pbuf\n"); #endif pbuf_free(p); } } /////////////////////////////////////////////////////////////////////////////////// /* * ����һ��ACK��DHCP�ͻ��� * * @param m ָ����Ҫ���͵�DHCP msg���� */ /////////////////////////////////////////////////////////////////////////////////// static void ICACHE_FLASH_ATTR 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 os_printf("udhcp: send_ack>>p->ref = %d\n", p->ref); #endif if(p != NULL){ #if DHCPS_DEBUG os_printf("dhcps: send_ack>>pbuf_alloc succeed\n"); os_printf("dhcps: send_ack>>p->tot_len = %d\n", p->tot_len); os_printf("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 os_printf("%02x ",data[i]); if((i+1)%16 == 0){ os_printf("\n"); } #endif } q = q->next; } }else{ #if DHCPS_DEBUG os_printf("dhcps: send_ack>>pbuf_alloc failed\n"); #endif return; } SendAck_err_t = udp_sendto( pcb_dhcps, p, &broadcast_dhcps, DHCPS_CLIENT_PORT ); #if DHCPS_DEBUG os_printf("dhcps: send_ack>>udp_sendto result %x\n",SendAck_err_t); #endif if(p->ref != 0){ #if DHCPS_DEBUG os_printf("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 uint8_t ICACHE_FLASH_ATTR parse_options(uint8_t *optptr, sint16_t len) { struct ip_addr 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 os_printf("dhcps: (sint16_t)*optptr = %d\n", (sint16_t)*optptr); #endif switch ((sint16_t) *optptr) { case DHCP_OPTION_MSG_TYPE: //53 type = *(optptr + 2); break; case DHCP_OPTION_REQ_IPADDR://50 if( os_memcmp( (char *) &client.addr, (char *) optptr+2,4)==0 ) { #if DHCPS_DEBUG os_printf("dhcps: DHCP_OPTION_REQ_IPADDR = 0 ok\n"); #endif s.state = DHCPS_STATE_ACK; }else { #if DHCPS_DEBUG os_printf("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 os_printf("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 os_printf("dhcps: DHCPD_STATE_NAK\n"); #endif } break; case DHCPDECLINE://4 s.state = DHCPS_STATE_IDLE; #if DHCPS_DEBUG os_printf("dhcps: DHCPD_STATE_IDLE\n"); #endif break; case DHCPRELEASE://7 s.state = DHCPS_STATE_RELEASE; #if DHCPS_DEBUG os_printf("dhcps: DHCPD_STATE_IDLE\n"); #endif break; } #if DHCPS_DEBUG os_printf("dhcps: return s.state = %d\n", s.state); #endif return s.state; } /////////////////////////////////////////////////////////////////////////////////// /////////////////////////////////////////////////////////////////////////////////// static sint16_t ICACHE_FLASH_ATTR parse_msg(struct dhcps_msg *m, u16_t len) { if(os_memcmp((char *)m->options, &magic_cookie, sizeof(magic_cookie)) == 0){ #if DHCPS_DEBUG os_printf("dhcps: len = %d\n", len); #endif /* * ��¼��ǰ��xid���ﴦ���? * �˺�ΪDHCP�ͻ����������û�ͳһ��ȡIPʱ�� */ // if((old_xid[0] == 0) && // (old_xid[1] == 0) && // (old_xid[2] == 0) && // (old_xid[3] == 0)){ // /* // * old_xidδ��¼�κ����? // * �϶��ǵ�һ��ʹ�� // */ // os_memcpy((char *)old_xid, (char *)m->xid, sizeof(m->xid)); // }else{ // /* // * ���δ����DHCP msg��Я���xid���ϴμ�¼�IJ�ͬ�� // * �϶�Ϊ��ͬ��DHCP�ͻ��˷��ͣ���ʱ����Ҫ����Ŀͻ���IP // * ���� 192.168.4.100(0x6404A8C0) <--> 192.168.4.200(0xC804A8C0) // * // */ // if(os_memcmp((char *)old_xid, (char *)m->xid, sizeof(m->xid)) != 0){ /* * ��¼���ε�xid�ţ�ͬʱ�����IP���� */ struct ip_addr addr_tmp; // os_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; struct ip_addr 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 (os_memcmp(pdhcps_pool->mac, m->chaddr, sizeof(pdhcps_pool->mac)) == 0){ // os_printf("the same device request ip\n"); if (os_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 *)os_zalloc(sizeof(struct dhcps_pool)); pdhcps_pool->ip.addr = client_address.addr; os_memcpy(pdhcps_pool->mac, m->chaddr, sizeof(pdhcps_pool->mac)); pdhcps_pool->lease_timer = DHCPS_LEASE_TIMER; pnode = (list_node *)os_zalloc(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) || (ip_addr_isany(&client_address))){ os_printf("client_address_plus.addr %x %d\n", client_address_plus.addr, system_get_free_heap_size()); if(pnode != NULL) { node_remove_from_list(&plist,pnode); os_free(pnode); pnode = NULL; } if (pdhcps_pool != NULL) { os_free(pdhcps_pool); pdhcps_pool = NULL; } // client_address_plus.addr = dhcps_lease.start_ip.addr; return 4; } sint16_t ret = parse_options(&m->options[4], len);; if(ret == DHCPS_STATE_RELEASE) { if(pnode != NULL) { node_remove_from_list(&plist,pnode); os_free(pnode); pnode = NULL; } if (pdhcps_pool != NULL) { os_free(pdhcps_pool); pdhcps_pool = NULL; } os_memset(&client_address,0x0,sizeof(client_address)); } if (wifi_softap_set_station_info(m->chaddr, &client_address) == false) { return 0; } // } #if DHCPS_DEBUG os_printf("dhcps: xid changed\n"); os_printf("dhcps: client_address.addr = %x\n", client_address.addr); #endif // } // } return ret; } return 0; } /////////////////////////////////////////////////////////////////////////////////// /* * DHCP ��������ݰ���մ���ص�����˺�����LWIP UDPģ������ʱ������ * ��Ҫ����udp_recv()������LWIP����ע��. * * @param arg * @param pcb ���յ�UDP��Ŀ��ƿ�? * @param p ���յ���UDP�е��������? * @param addr ���ʹ�UDP���Դ�����IP��ַ * @param port ���ʹ�UDP���Դ�����UDPͨ���˿ں� */ /////////////////////////////////////////////////////////////////////////////////// static void ICACHE_FLASH_ATTR handle_dhcp(void *arg, struct udp_pcb *pcb, struct pbuf *p, struct ip_addr *addr, uint16_t port) { struct dhcps_msg *pmsg_dhcps = NULL; sint16_t tlen = 0; u16_t i = 0; u16_t dhcps_msg_cnt = 0; u8_t *p_dhcps_msg = NULL; u8_t *data = NULL; #if DHCPS_DEBUG os_printf("dhcps: handle_dhcp-> receive a packet\n"); #endif if (p==NULL) return; pmsg_dhcps = (struct dhcps_msg *)os_zalloc(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 os_printf("dhcps: handle_dhcp-> p->tot_len = %d\n", tlen); os_printf("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 os_printf("%02x ",data[i]); if((i+1)%16 == 0){ os_printf("\n"); } #endif } if(p->next != NULL) { #if DHCPS_DEBUG os_printf("dhcps: handle_dhcp-> p->next != NULL\n"); os_printf("dhcps: handle_dhcp-> p->next->tot_len = %d\n",p->next->tot_len); os_printf("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 os_printf("%02x ",data[i]); if((i+1)%16 == 0){ os_printf("\n"); } #endif } } /* * DHCP �ͻ���������Ϣ���� */ #if DHCPS_DEBUG os_printf("dhcps: handle_dhcp-> parse_msg(p)\n"); #endif switch(parse_msg(pmsg_dhcps, tlen - 240)) { case DHCPS_STATE_OFFER://1 #if DHCPS_DEBUG os_printf("dhcps: handle_dhcp-> DHCPD_STATE_OFFER\n"); #endif send_offer(pmsg_dhcps); break; case DHCPS_STATE_ACK://3 #if DHCPS_DEBUG os_printf("dhcps: handle_dhcp-> DHCPD_STATE_ACK\n"); #endif send_ack(pmsg_dhcps); break; case DHCPS_STATE_NAK://4 #if DHCPS_DEBUG os_printf("dhcps: handle_dhcp-> DHCPD_STATE_NAK\n"); #endif send_nak(pmsg_dhcps); break; default : break; } #if DHCPS_DEBUG os_printf("dhcps: handle_dhcp-> pbuf_free(p)\n"); #endif pbuf_free(p); os_free(pmsg_dhcps); pmsg_dhcps = NULL; } /////////////////////////////////////////////////////////////////////////////////// static void ICACHE_FLASH_ATTR wifi_softap_init_dhcps_lease(uint32 ip) { uint32 softap_ip = 0,local_ip = 0; uint32 start_ip = 0; uint32 end_ip = 0; // if (dhcps_lease_flag) { 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 ++; os_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); } // 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 ICACHE_FLASH_ATTR dhcps_start(struct ip_info *info) { struct netif * apnetif = (struct netif *)eagle_lwip_getif(0x01); if(apnetif->dhcps_pcb != NULL) { udp_remove(apnetif->dhcps_pcb); } pcb_dhcps = udp_new(); if (pcb_dhcps == NULL || info ==NULL) { os_printf("dhcps_start(): could not obtain pcb\n"); } apnetif->dhcps_pcb = pcb_dhcps; IP4_ADDR(&broadcast_dhcps, 255, 255, 255, 255); server_address = info->ip; 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 os_printf("dhcps:dhcps_start->udp_recv function Set a receive callback handle_dhcp for UDP_PCB pcb_dhcps\n"); #endif } void ICACHE_FLASH_ATTR dhcps_stop(void) { struct netif * apnetif = (struct netif *)eagle_lwip_getif(0x01); udp_disconnect(pcb_dhcps); // dhcps_lease_flag = true; if(apnetif->dhcps_pcb != NULL) { udp_remove(apnetif->dhcps_pcb); apnetif->dhcps_pcb = NULL; } //udp_remove(pcb_dhcps); 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); os_free(pback_node->pnode); pback_node->pnode = NULL; os_free(pback_node); pback_node = NULL; } } /****************************************************************************** * FunctionName : wifi_softap_set_dhcps_lease * Description : set the lease information of DHCP server * Parameters : please -- Additional argument to set the lease information, * Little-Endian. * Returns : true or false *******************************************************************************/ bool ICACHE_FLASH_ATTR wifi_softap_set_dhcps_lease(struct dhcps_lease *please) { struct ip_info info; uint32 softap_ip = 0; uint32 start_ip = 0; uint32 end_ip = 0; uint8 opmode = wifi_get_opmode(); if (opmode == STATION_MODE || opmode == NULL_MODE) { return false; } if (please == NULL || wifi_softap_dhcps_status() == DHCP_STARTED) return false; if(please->enable) { os_bzero(&info, sizeof(struct ip_info)); wifi_get_ip_info(SOFTAP_IF, &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; os_bzero(&dhcps_lease, 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 ICACHE_FLASH_ATTR wifi_softap_get_dhcps_lease(struct dhcps_lease *please) { uint8 opmode = wifi_get_opmode(); if (opmode == STATION_MODE || opmode == NULL_MODE) { return false; } if (NULL == please) return false; // if (dhcps_lease_flag){ if (dhcps_lease.enable == FALSE){ if (wifi_softap_dhcps_status() == DHCP_STOPPED) return false; } else { // os_bzero(please, sizeof(dhcps_lease)); // if (wifi_softap_dhcps_status() == DHCP_STOPPED){ // please->start_ip.addr = htonl(dhcps_lease.start_ip.addr); // please->end_ip.addr = htonl(dhcps_lease.end_ip.addr); // } } // if (wifi_softap_dhcps_status() == DHCP_STARTED){ // os_bzero(please, sizeof(dhcps_lease)); // please->start_ip.addr = dhcps_lease.start_ip.addr; // please->end_ip.addr = dhcps_lease.end_ip.addr; // } please->start_ip.addr = dhcps_lease.start_ip.addr; please->end_ip.addr = dhcps_lease.end_ip.addr; return true; } static void ICACHE_FLASH_ATTR 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; os_free(minp->pnode); minp->pnode = NULL; os_free(minp); minp = NULL; } void ICACHE_FLASH_ATTR dhcps_coarse_tmr(void) { uint8 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); os_free(pback_node->pnode); pback_node->pnode = NULL; os_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 ICACHE_FLASH_ATTR wifi_softap_set_dhcps_offer_option(uint8 level, void* optarg) { bool offer_flag = true; uint8 option = 0; if (optarg == NULL && wifi_softap_dhcps_status() == false) return false; if (level <= OFFER_START || level >= OFFER_END) return false; switch (level){ case OFFER_ROUTER: offer = (*(uint8 *)optarg) & 0x01; offer_flag = true; break; default : offer_flag = false; break; } return offer_flag; } bool ICACHE_FLASH_ATTR wifi_softap_set_dhcps_lease_time(uint32 minute) { uint8 opmode = wifi_get_opmode(); if (opmode == STATION_MODE || opmode == NULL_MODE) { return false; } if (wifi_softap_dhcps_status() == DHCP_STARTED) { return false; } if(minute == 0) { return false; } dhcps_lease_time = minute; return true; } bool ICACHE_FLASH_ATTR wifi_softap_reset_dhcps_lease_time(void) { uint8 opmode = wifi_get_opmode(); if (opmode == STATION_MODE || opmode == NULL_MODE) { return false; } if (wifi_softap_dhcps_status() == DHCP_STARTED) { return false; } dhcps_lease_time = DHCPS_LEASE_TIME_DEF; return true; } uint32 ICACHE_FLASH_ATTR wifi_softap_get_dhcps_lease_time(void) // minute { return dhcps_lease_time; } ================================================ FILE: app/lwip/app/espconn.c ================================================ /****************************************************************************** * Copyright 2013-2014 Espressif Systems (Wuxi) * * FileName: espconn.c * * Description: espconn interface for user * * Modification history: * 2014/3/31, v1.0 create this file. *******************************************************************************/ #include "lwip/netif.h" #include "lwip/inet.h" #include "netif/etharp.h" #include "lwip/tcp.h" #include "lwip/ip.h" #include "lwip/init.h" #include "ets_sys.h" #include "os_type.h" //#include "os.h" #include "lwip/mem.h" #include "lwip/app/espconn_tcp.h" #include "lwip/app/espconn_udp.h" #include "lwip/app/espconn.h" #include "user_interface.h" #ifdef MEMLEAK_DEBUG static const char mem_debug_file[] ICACHE_RODATA_ATTR = __FILE__; #endif espconn_msg *plink_active = NULL; espconn_msg *pserver_list = NULL; remot_info premot[linkMax]; struct espconn_packet pktinfo[2]; static uint8 espconn_tcp_get_buf_count(espconn_buf *pesp_buf); /****************************************************************************** * FunctionName : espconn_copy_partial * Description : reconnect with host * Parameters : arg -- Additional argument to pass to the callback function * Returns : none *******************************************************************************/ void ICACHE_FLASH_ATTR espconn_copy_partial(struct espconn *pesp_dest, struct espconn *pesp_source) { pesp_dest->type = pesp_source->type; pesp_dest->state = pesp_source->state; if (pesp_source->type == ESPCONN_TCP){ pesp_dest->proto.tcp->remote_port = pesp_source->proto.tcp->remote_port; pesp_dest->proto.tcp->local_port = pesp_source->proto.tcp->local_port; os_memcpy(pesp_dest->proto.tcp->remote_ip, pesp_source->proto.tcp->remote_ip, 4); os_memcpy(pesp_dest->proto.tcp->local_ip, pesp_source->proto.tcp->local_ip, 4); pesp_dest->proto.tcp->connect_callback = pesp_source->proto.tcp->connect_callback; pesp_dest->proto.tcp->reconnect_callback = pesp_source->proto.tcp->reconnect_callback; pesp_dest->proto.tcp->disconnect_callback = pesp_source->proto.tcp->disconnect_callback; } else { pesp_dest->proto.udp->remote_port = pesp_source->proto.udp->remote_port; pesp_dest->proto.udp->local_port = pesp_source->proto.udp->local_port; os_memcpy(pesp_dest->proto.udp->remote_ip, pesp_source->proto.udp->remote_ip, 4); os_memcpy(pesp_dest->proto.udp->local_ip, pesp_source->proto.udp->local_ip, 4); } pesp_dest->recv_callback = pesp_source->recv_callback; pesp_dest->sent_callback = pesp_source->sent_callback; pesp_dest->link_cnt = pesp_source->link_cnt; pesp_dest->reverse = pesp_source->reverse; } /****************************************************************************** * FunctionName : espconn_copy_partial * Description : insert the node to the active connection list * Parameters : arg -- Additional argument to pass to the callback function * Returns : none *******************************************************************************/ void ICACHE_FLASH_ATTR espconn_list_creat(espconn_msg **phead, espconn_msg* pinsert) { espconn_msg *plist = NULL; // espconn_msg *ptest = NULL; if (*phead == NULL) *phead = pinsert; else { plist = *phead; while (plist->pnext != NULL) { plist = plist->pnext; } plist->pnext = pinsert; } pinsert->pnext = NULL; /* ptest = *phead; while(ptest != NULL){ os_printf("espconn_list_creat %p\n", ptest); ptest = ptest->pnext; }*/ } /****************************************************************************** * FunctionName : espconn_list_delete * Description : remove the node from the active connection list * Parameters : arg -- Additional argument to pass to the callback function * Returns : none *******************************************************************************/ void ICACHE_FLASH_ATTR espconn_list_delete(espconn_msg **phead, espconn_msg* pdelete) { espconn_msg *plist = NULL; // espconn_msg *ptest = NULL; plist = *phead; if (plist == NULL){ *phead = NULL; } else { if (plist == pdelete){ *phead = plist->pnext; } else { while (plist != NULL) { if (plist->pnext == pdelete){ plist->pnext = pdelete->pnext; } plist = plist->pnext; } } } /* ptest = *phead; while(ptest != NULL){ os_printf("espconn_list_delete %p\n", ptest); ptest = ptest->pnext; }*/ } /****************************************************************************** * FunctionName : espconn_pbuf_create * Description : insert the node to the active connection list * Parameters : arg -- Additional argument to pass to the callback function * Returns : none *******************************************************************************/ void ICACHE_FLASH_ATTR espconn_pbuf_create(espconn_buf **phead, espconn_buf* pinsert) { espconn_buf *plist = NULL; if (*phead == NULL) *phead = pinsert; else { plist = *phead; while (plist->pnext != NULL) { plist = plist->pnext; } plist->pnext = pinsert; } pinsert->pnext = NULL; } /****************************************************************************** * FunctionName : espconn_pbuf_delete * Description : remove the node from the active connection list * Parameters : arg -- Additional argument to pass to the callback function * Returns : none *******************************************************************************/ void ICACHE_FLASH_ATTR espconn_pbuf_delete(espconn_buf **phead, espconn_buf* pdelete) { espconn_buf *plist = NULL; plist = *phead; if (plist == NULL){ *phead = NULL; } else { if (plist == pdelete){ *phead = plist->pnext; } else { while (plist != NULL) { if (plist->pnext == pdelete){ plist->pnext = pdelete->pnext; } plist = plist->pnext; } } } } /****************************************************************************** * FunctionName : espconn_find_connection * Description : Initialize the server: set up a listening PCB and bind it to * the defined port * Parameters : espconn -- the espconn used to build server * Returns : true or false *******************************************************************************/ bool ICACHE_FLASH_ATTR espconn_find_connection(struct espconn *pespconn, espconn_msg **pnode) { espconn_msg *plist = NULL; struct ip_addr ip_remot; struct ip_addr ip_list; if (pespconn == NULL) return false; /*find the active connection node*/ for (plist = plink_active; plist != NULL; plist = plist->pnext){ if (pespconn == plist->pespconn) { *pnode = plist; return true; } } /*find the active server node*/ for (plist = pserver_list; plist != NULL; plist = plist->pnext){ if (pespconn == plist->pespconn) { if (pespconn->proto.tcp == NULL) return false; IP4_ADDR(&ip_remot, pespconn->proto.tcp->remote_ip[0], pespconn->proto.tcp->remote_ip[1], pespconn->proto.tcp->remote_ip[2], pespconn->proto.tcp->remote_ip[3]); if ((ip_remot.addr == IPADDR_ANY) || (pespconn->proto.tcp->remote_port == 0)) return false; /*find the active connection node*/ for (plist = plink_active; plist != NULL; plist = plist->pnext){ IP4_ADDR(&ip_list, plist->pcommon.remote_ip[0], plist->pcommon.remote_ip[1], plist->pcommon.remote_ip[2], plist->pcommon.remote_ip[3]); if ((ip_list.addr == ip_remot.addr) && (pespconn->proto.tcp->remote_port == plist->pcommon.remote_port)) { *pnode = plist; return true; } } return false; } } return false; } /****************************************************************************** * FunctionName : espconn_get_acticve_num * Description : get the count of simulatenously active connections * Parameters : type -- the type * Returns : the count of simulatenously active connections *******************************************************************************/ static uint8 ICACHE_FLASH_ATTR espconn_get_acticve_num(uint8 type) { espconn_msg *plist = NULL; uint8 num_tcp_active = 0; for (plist = plink_active; plist != NULL; plist = plist->pnext) { if (plist->pespconn != NULL && plist->pespconn->type == type) { num_tcp_active++; } } return num_tcp_active; } /****************************************************************************** * FunctionName : espconn_connect * Description : The function given as the connect * Parameters : espconn -- the espconn used to listen the connection * Returns : none *******************************************************************************/ sint8 ICACHE_FLASH_ATTR espconn_connect(struct espconn *espconn) { struct ip_addr ipaddr; struct ip_info ipinfo; uint8 connect_status = 0; sint8 value = ESPCONN_OK; espconn_msg *plist = NULL; remot_info *pinfo = NULL; if (espconn == NULL) { return ESPCONN_ARG; } else if (espconn ->type != ESPCONN_TCP) return ESPCONN_ARG; /*Check the active node count whether is the limit or not*/ if (espconn_get_acticve_num(ESPCONN_TCP) >= espconn_tcp_get_max_con()) return ESPCONN_ISCONN; /*Check the IP address whether is zero or not in different mode*/ if (wifi_get_opmode() == ESPCONN_STA){ wifi_get_ip_info(STA_NETIF,&ipinfo); if (ipinfo.ip.addr == 0){ return ESPCONN_RTE; } } else if(wifi_get_opmode() == ESPCONN_AP){ wifi_get_ip_info(AP_NETIF,&ipinfo); if (ipinfo.ip.addr == 0){ return ESPCONN_RTE; } } else if(wifi_get_opmode() == ESPCONN_AP_STA){ IP4_ADDR(&ipaddr, espconn->proto.tcp->remote_ip[0], espconn->proto.tcp->remote_ip[1], espconn->proto.tcp->remote_ip[2], espconn->proto.tcp->remote_ip[3]); ipaddr.addr <<= 8; wifi_get_ip_info(AP_NETIF,&ipinfo); ipinfo.ip.addr <<= 8; espconn_printf("softap_addr = %x, remote_addr = %x\n", ipinfo.ip.addr, ipaddr.addr); if (ipaddr.addr != ipinfo.ip.addr){ connect_status = wifi_station_get_connect_status(); if (connect_status == STATION_GOT_IP){ wifi_get_ip_info(STA_NETIF,&ipinfo); if (ipinfo.ip.addr == 0) return ESPCONN_RTE; } else if (connect_status == STATION_IDLE){ return ESPCONN_RTE; } else { return connect_status; } } } /*check the active node information whether is the same as the entity or not*/ for (plist = plink_active; plist != NULL; plist = plist->pnext){ if (plist->pespconn && plist->pespconn->type == ESPCONN_TCP){ if (espconn->proto.tcp->local_port == plist->pespconn->proto.tcp->local_port){ return ESPCONN_ISCONN; } } } value = espconn_tcp_client(espconn); return value; } /****************************************************************************** * FunctionName : espconn_create * Description : sent data for client or server * Parameters : espconn -- espconn to the data transmission * Returns : result *******************************************************************************/ sint8 ICACHE_FLASH_ATTR espconn_create(struct espconn *espconn) { sint8 value = ESPCONN_OK; espconn_msg *plist = NULL; if (espconn == NULL) { return ESPCONN_ARG; } else if (espconn ->type != ESPCONN_UDP){ return ESPCONN_ARG; } /*check the active node information whether is the same as the entity or not*/ for (plist = plink_active; plist != NULL; plist = plist->pnext){ if (plist->pespconn && plist->pespconn->type == ESPCONN_UDP){ if (espconn->proto.udp->local_port == plist->pespconn->proto.udp->local_port){ return ESPCONN_ISCONN; } } } value = espconn_udp_server(espconn); return value; } /****************************************************************************** * FunctionName : espconn_sent * Description : sent data for client or server * Parameters : espconn -- espconn to set for client or server * psent -- data to send * length -- length of data to send * Returns : none *******************************************************************************/ sint8 ICACHE_FLASH_ATTR espconn_sent(struct espconn *espconn, uint8 *psent, uint16 length) { espconn_msg *pnode = NULL; bool value = false; err_t error = ESPCONN_OK; if (espconn == NULL || psent == NULL || length == 0) { return ESPCONN_ARG; } /*Find the node depend on the espconn message*/ value = espconn_find_connection(espconn, &pnode); if (value){ espconn ->state = ESPCONN_WRITE; switch (espconn ->type) { case ESPCONN_TCP: /* calling sent function frequently,make sure last packet has been backup or sent fully*/ if (pnode->pcommon.write_flag){ espconn_buf *pbuf = NULL; /*If total number of espconn_buf on the unsent lists exceeds the set maximum, return an error */ if (espconn_copy_enabled(pnode)){ if (espconn_tcp_get_buf_count(pnode->pcommon.pbuf) >= pnode ->pcommon.pbuf_num) return ESPCONN_MAXNUM; } else { struct tcp_pcb *pcb = pnode->pcommon.pcb; if (pcb->snd_queuelen >= TCP_SND_QUEUELEN) return ESPCONN_MAXNUM; } pbuf = (espconn_buf*) os_zalloc(sizeof(espconn_buf)); if (pbuf == NULL) return ESPCONN_MEM; else { /*Backup the application packet information for send more data*/ pbuf->payload = psent; pbuf->punsent = pbuf->payload; pbuf->unsent = length; pbuf->len = length; /*insert the espconn_pbuf to the list*/ espconn_pbuf_create(&pnode->pcommon.pbuf, pbuf); if (pnode->pcommon.ptail == NULL) pnode->pcommon.ptail = pbuf; } /*when set the data copy option. change the flag for next packet*/ if (espconn_copy_disabled(pnode)) pnode->pcommon.write_flag = false; error = espconn_tcp_write(pnode); // if (error != ESPCONN_OK){ // /*send the application packet fail, // * ensure that each allocated is deleted*/ // espconn_pbuf_delete(&pnode->pcommon.pbuf, pbuf); // os_free(pbuf); // pbuf = NULL; // } return error; } else return ESPCONN_ARG; break; case ESPCONN_UDP: return espconn_udp_sent(pnode, psent, length); break; default : break; } } return ESPCONN_ARG; } /****************************************************************************** * FunctionName : espconn_sendto * Description : send data for UDP * Parameters : espconn -- espconn to set for UDP * psent -- data to send * length -- length of data to send * Returns : error *******************************************************************************/ sint16 ICACHE_FLASH_ATTR espconn_sendto(struct espconn *espconn, uint8 *psent, uint16 length) { espconn_msg *pnode = NULL; bool value = false; err_t error = ESPCONN_OK; if (espconn == NULL || psent == NULL || length == 0) { return ESPCONN_ARG; } /*Find the node depend on the espconn message*/ value = espconn_find_connection(espconn, &pnode); if (value && espconn->type == ESPCONN_UDP) return espconn_udp_sendto(pnode, psent, length); else return ESPCONN_ARG; } /****************************************************************************** * FunctionName : espconn_send * Description : sent data for client or server * Parameters : espconn -- espconn to set for client or server * psent -- data to send * length -- length of data to send * Returns : none *******************************************************************************/ sint8 espconn_send(struct espconn *espconn, uint8 *psent, uint16 length) __attribute__((alias("espconn_sent"))); /****************************************************************************** * FunctionName : espconn_tcp_get_wnd * Description : get the window size of simulatenously active TCP connections * Parameters : none * Returns : the number of TCP_MSS active TCP connections *******************************************************************************/ uint8 ICACHE_FLASH_ATTR espconn_tcp_get_wnd(void) { uint8 tcp_num = 0; tcp_num = (TCP_WND / TCP_MSS); return tcp_num; } /****************************************************************************** * FunctionName : espconn_tcp_set_max_con * Description : set the window size simulatenously active TCP connections * Parameters : num -- the number of TCP_MSS * Returns : ESPCONN_ARG -- Illegal argument * ESPCONN_OK -- No error *******************************************************************************/ sint8 ICACHE_FLASH_ATTR espconn_tcp_set_wnd(uint8 num) { if (num == 0 || num > linkMax) return ESPCONN_ARG; TCP_WND = (num * TCP_MSS); return ESPCONN_OK; } /****************************************************************************** * FunctionName : espconn_tcp_get_mss * Description : get the mss size of simulatenously active TCP connections * Parameters : none * Returns : the size of TCP_MSS active TCP connections *******************************************************************************/ uint16 ICACHE_FLASH_ATTR espconn_tcp_get_mss(void) { uint16 tcp_num = 0; tcp_num = TCP_MSS; return tcp_num; } /****************************************************************************** * FunctionName : espconn_tcp_get_max_con * Description : get the number of simulatenously active TCP connections * Parameters : espconn -- espconn to set the connect callback * Returns : none *******************************************************************************/ uint8 ICACHE_FLASH_ATTR espconn_tcp_get_max_con(void) { uint8 tcp_num = 0; tcp_num = MEMP_NUM_TCP_PCB; return tcp_num; } /****************************************************************************** * FunctionName : espconn_tcp_set_max_con * Description : set the number of simulatenously active TCP connections * Parameters : espconn -- espconn to set the connect callback * Returns : none *******************************************************************************/ sint8 ICACHE_FLASH_ATTR espconn_tcp_set_max_con(uint8 num) { if (num == 0 || num > linkMax) return ESPCONN_ARG; MEMP_NUM_TCP_PCB = num; return ESPCONN_OK; } /****************************************************************************** * FunctionName : espconn_tcp_get_max_retran * Description : get the Maximum number of retransmissions of data active TCP connections * Parameters : none * Returns : the Maximum number of retransmissions *******************************************************************************/ uint8 ICACHE_FLASH_ATTR espconn_tcp_get_max_retran(void) { uint8 tcp_num = 0; tcp_num = TCP_MAXRTX; return tcp_num; } /****************************************************************************** * FunctionName : espconn_tcp_set_max_retran * Description : set the Maximum number of retransmissions of data active TCP connections * Parameters : num -- the Maximum number of retransmissions * Returns : result *******************************************************************************/ sint8 ICACHE_FLASH_ATTR espconn_tcp_set_max_retran(uint8 num) { if (num == 0 || num > 12) return ESPCONN_ARG; TCP_MAXRTX = num; return ESPCONN_OK; } /****************************************************************************** * FunctionName : espconn_tcp_get_max_syn * Description : get the Maximum number of retransmissions of SYN segments * Parameters : none * Returns : the Maximum number of retransmissions *******************************************************************************/ uint8 ICACHE_FLASH_ATTR espconn_tcp_get_max_syn(void) { uint8 tcp_num = 0; tcp_num = TCP_SYNMAXRTX; return tcp_num; } /****************************************************************************** * FunctionName : espconn_tcp_set_max_syn * Description : set the Maximum number of retransmissions of SYN segments * Parameters : num -- the Maximum number of retransmissions * Returns : result *******************************************************************************/ sint8 ICACHE_FLASH_ATTR espconn_tcp_set_max_syn(uint8 num) { if (num == 0 || num > 12) return ESPCONN_ARG; TCP_SYNMAXRTX = num; return ESPCONN_OK; } /****************************************************************************** * FunctionName : espconn_tcp_get_max_con_allow * Description : get the count of simulatenously active connections on the server * Parameters : espconn -- espconn to get the count * Returns : result *******************************************************************************/ sint8 ICACHE_FLASH_ATTR espconn_tcp_get_max_con_allow(struct espconn *espconn) { espconn_msg *pget_msg = NULL; if ((espconn == NULL) || (espconn->type == ESPCONN_UDP)) return ESPCONN_ARG; pget_msg = pserver_list; while (pget_msg != NULL){ if (pget_msg->pespconn == espconn){ return pget_msg->count_opt; } pget_msg = pget_msg->pnext; } return ESPCONN_ARG; } /****************************************************************************** * FunctionName : espconn_tcp_set_max_con_allow * Description : set the count of simulatenously active connections on the server * Parameters : espconn -- espconn to set the count * Returns : result *******************************************************************************/ sint8 ICACHE_FLASH_ATTR espconn_tcp_set_max_con_allow(struct espconn *espconn, uint8 num) { espconn_msg *pset_msg = NULL; if ((espconn == NULL) || (num > MEMP_NUM_TCP_PCB) || (espconn->type == ESPCONN_UDP)) return ESPCONN_ARG; pset_msg = pserver_list; while (pset_msg != NULL){ if (pset_msg->pespconn == espconn){ pset_msg->count_opt = num; return ESPCONN_OK; } pset_msg = pset_msg->pnext; } return ESPCONN_ARG; } /****************************************************************************** * FunctionName : espconn_tcp_set_buf_count * Description : set the total number of espconn_buf on the unsent lists for one * activate connection * Parameters : espconn -- espconn to set the count * num -- the total number of espconn_buf * Returns : result *******************************************************************************/ sint8 ICACHE_FLASH_ATTR espconn_tcp_set_buf_count(struct espconn *espconn, uint8 num) { espconn_msg *plist = NULL; if (espconn == NULL || (num > TCP_SND_QUEUELEN)) return ESPCONN_ARG; /*find the node from the active connection list*/ for (plist = plink_active; plist != NULL; plist = plist->pnext){ if (plist->pespconn && plist->pespconn == espconn && espconn->type == ESPCONN_TCP){ plist->pcommon.pbuf_num = num; return ESPCONN_OK; } } if (plist == NULL) return ESPCONN_ARG; } /****************************************************************************** * FunctionName : espconn_tcp_get_buf_count * Description : get the count of the current node which has espconn_buf * Parameters : pesp_buf -- the list head of espconn_buf type * Returns : the count of the current node which has espconn_buf *******************************************************************************/ static uint8 ICACHE_FLASH_ATTR espconn_tcp_get_buf_count(espconn_buf *pesp_buf) { espconn_buf *pbuf_list = pesp_buf; uint8 pbuf_num = 0; /*polling the list get the count of the current node*/ while (pbuf_list != NULL){ pbuf_list = pbuf_list->pnext; pbuf_num ++; } return pbuf_num; } /****************************************************************************** * FunctionName : espconn_regist_sentcb * Description : Used to specify the function that should be called when data * has been successfully delivered to the remote host. * Parameters : espconn -- espconn to set the sent callback * sent_cb -- sent callback function to call for this espconn * when data is successfully sent * Returns : none *******************************************************************************/ sint8 ICACHE_FLASH_ATTR espconn_regist_sentcb(struct espconn *espconn, espconn_sent_callback sent_cb) { if (espconn == NULL) { return ESPCONN_ARG; } espconn ->sent_callback = sent_cb; return ESPCONN_OK; } /****************************************************************************** * FunctionName : espconn_regist_sentcb * Description : Used to specify the function that should be called when data * has been successfully delivered to the remote host. * Parameters : espconn -- espconn to set the sent callback * sent_cb -- sent callback function to call for this espconn * when data is successfully sent * Returns : none *******************************************************************************/ sint8 ICACHE_FLASH_ATTR espconn_regist_write_finish(struct espconn *espconn, espconn_connect_callback write_finish_fn) { if (espconn == NULL || espconn ->proto.tcp == NULL || espconn->type == ESPCONN_UDP) { return ESPCONN_ARG; } espconn ->proto.tcp->write_finish_fn = write_finish_fn; return ESPCONN_OK; } /****************************************************************************** * FunctionName : espconn_regist_connectcb * Description : used to specify the function that should be called when * connects to host. * Parameters : espconn -- espconn to set the connect callback * connect_cb -- connected callback function to call when connected * Returns : none *******************************************************************************/ sint8 ICACHE_FLASH_ATTR espconn_regist_connectcb(struct espconn *espconn, espconn_connect_callback connect_cb) { if (espconn == NULL) { return ESPCONN_ARG; } espconn->proto.tcp->connect_callback = connect_cb; return ESPCONN_OK; } /****************************************************************************** * FunctionName : espconn_regist_recvcb * Description : used to specify the function that should be called when recv * data from host. * Parameters : espconn -- espconn to set the recv callback * recv_cb -- recv callback function to call when recv data * Returns : none *******************************************************************************/ sint8 ICACHE_FLASH_ATTR espconn_regist_recvcb(struct espconn *espconn, espconn_recv_callback recv_cb) { if (espconn == NULL) { return ESPCONN_ARG; } espconn ->recv_callback = recv_cb; return ESPCONN_OK; } /****************************************************************************** * FunctionName : espconn_regist_reconcb * Description : used to specify the function that should be called when connection * because of err disconnect. * Parameters : espconn -- espconn to set the err callback * recon_cb -- err callback function to call when err * Returns : none *******************************************************************************/ sint8 ICACHE_FLASH_ATTR espconn_regist_reconcb(struct espconn *espconn, espconn_reconnect_callback recon_cb) { if (espconn == NULL) { return ESPCONN_ARG; } espconn ->proto.tcp->reconnect_callback = recon_cb; return ESPCONN_OK; } /****************************************************************************** * FunctionName : espconn_regist_disconcb * Description : used to specify the function that should be called when disconnect * Parameters : espconn -- espconn to set the err callback * discon_cb -- err callback function to call when err * Returns : none *******************************************************************************/ sint8 ICACHE_FLASH_ATTR espconn_regist_disconcb(struct espconn *espconn, espconn_connect_callback discon_cb) { if (espconn == NULL) { return ESPCONN_ARG; } espconn ->proto.tcp->disconnect_callback = discon_cb; return ESPCONN_OK; } /****************************************************************************** * FunctionName : espconn_get_connection_info * Description : used to specify the function that should be called when disconnect * Parameters : espconn -- espconn to set the err callback * discon_cb -- err callback function to call when err * Returns : none *******************************************************************************/ sint8 ICACHE_FLASH_ATTR espconn_get_connection_info(struct espconn *pespconn, remot_info **pcon_info, uint8 typeflags) { espconn_msg *plist = NULL; if (pespconn == NULL) return ESPCONN_ARG; os_memset(premot, 0, sizeof(premot)); pespconn->link_cnt = 0; plist = plink_active; switch (pespconn->type){ case ESPCONN_TCP: while(plist != NULL){ if (plist->preverse == pespconn){ premot[pespconn->link_cnt].state = plist->pespconn->state; premot[pespconn->link_cnt].remote_port = plist->pcommon.remote_port; os_memcpy(premot[pespconn->link_cnt].remote_ip, plist->pcommon.remote_ip, 4); pespconn->link_cnt ++; } plist = plist->pnext; } break; case ESPCONN_UDP: while(plist != NULL){ if (plist->pespconn && plist->pespconn->type == ESPCONN_UDP){ premot[pespconn->link_cnt].state = plist->pespconn->state; premot[pespconn->link_cnt].remote_port = plist->pcommon.remote_port; os_memcpy(premot[pespconn->link_cnt].remote_ip, plist->pcommon.remote_ip, 4); pespconn->link_cnt ++; } plist = plist->pnext; } break; default: break; } *pcon_info = premot; return ESPCONN_OK; } /****************************************************************************** * FunctionName : espconn_accept * Description : The function given as the listen * Parameters : espconn -- the espconn used to listen the connection * Returns : *******************************************************************************/ sint8 ICACHE_FLASH_ATTR espconn_accept(struct espconn *espconn) { sint8 value = ESPCONN_OK; espconn_msg *plist = NULL; if (espconn == NULL) { return ESPCONN_ARG; } else if (espconn ->type != ESPCONN_TCP) return ESPCONN_ARG; /*check the active node information whether is the same as the entity or not*/ for (plist = plink_active; plist != NULL; plist = plist->pnext){ if (plist->pespconn && plist->pespconn->type == ESPCONN_TCP){ if (espconn->proto.tcp->local_port == plist->pespconn->proto.tcp->local_port){ return ESPCONN_ISCONN; } } } value = espconn_tcp_server(espconn); return value; } /****************************************************************************** * FunctionName : espconn_regist_time * Description : used to specify the time that should be called when don't recv data * Parameters : espconn -- the espconn used to the connection * interval -- the timer when don't recv data * Returns : none *******************************************************************************/ sint8 ICACHE_FLASH_ATTR espconn_regist_time(struct espconn *espconn, uint32 interval, uint8 type_flag) { espconn_msg *pnode = NULL; espconn_msg *ptime_msg = NULL; bool value = false; if ((espconn == NULL) || (type_flag > 0x01)) return ESPCONN_ARG; if (type_flag == 0x01){ /*set the timeout time for one active connection of the server*/ value = espconn_find_connection(espconn, &pnode); if (value){ pnode->pcommon.timeout = interval; return ESPCONN_OK; } else return ESPCONN_ARG; } else { /*set the timeout time for all active connection of the server*/ ptime_msg = pserver_list; while (ptime_msg != NULL){ if (ptime_msg->pespconn == espconn){ ptime_msg->pcommon.timeout = interval; return ESPCONN_OK; } ptime_msg = ptime_msg->pnext; } } return ESPCONN_ARG; } /****************************************************************************** * FunctionName : espconn_disconnect * Description : disconnect with host * Parameters : espconn -- the espconn used to disconnect the connection * Returns : none *******************************************************************************/ sint8 ICACHE_FLASH_ATTR espconn_disconnect(struct espconn *espconn) { espconn_msg *pnode = NULL; bool value = false; if (espconn == NULL) { return ESPCONN_ARG;; } else if (espconn ->type != ESPCONN_TCP) return ESPCONN_ARG; /*Find the node depend on the espconn message*/ value = espconn_find_connection(espconn, &pnode); if (value){ /*protect for redisconnection*/ if (espconn->state == ESPCONN_CLOSE) return ESPCONN_INPROGRESS; espconn_tcp_disconnect(pnode); return ESPCONN_OK; } else return ESPCONN_ARG; } /****************************************************************************** * FunctionName : espconn_get_packet_info * Description : get the packet info with host * Parameters : espconn -- the espconn used to disconnect the connection * infoarg -- the packet info * Returns : the errur code *******************************************************************************/ sint8 ICACHE_FLASH_ATTR espconn_get_packet_info(struct espconn *espconn, struct espconn_packet* infoarg) { espconn_msg *pnode = NULL; err_t err; bool value = false; if (espconn == NULL || infoarg == NULL) { return ESPCONN_ARG;; } else if (espconn->type != ESPCONN_TCP) return ESPCONN_ARG; /*Find the node depend on the espconn message*/ value = espconn_find_connection(espconn, &pnode); if (value) { struct tcp_pcb *pcb = pnode->pcommon.pcb; if (pcb == NULL) return ESPCONN_ARG; pnode->pcommon.packet_info.packseq_nxt = pcb->rcv_nxt; pnode->pcommon.packet_info.packseqno = pcb->snd_nxt; pnode->pcommon.packet_info.snd_buf_size = pcb->snd_buf; pnode->pcommon.packet_info.total_queuelen = TCP_SND_QUEUELEN; pnode->pcommon.packet_info.snd_queuelen = pnode->pcommon.packet_info.total_queuelen - pcb->snd_queuelen; os_memcpy(infoarg,(void*)&pnode->pcommon.packet_info, sizeof(struct espconn_packet)); return ESPCONN_OK; } else { switch (espconn->state){ case ESPCONN_CLOSE: os_memcpy(infoarg,(void*)&pktinfo[0], sizeof(struct espconn_packet)); err = ESPCONN_OK; break; case ESPCONN_NONE: os_memcpy(infoarg,(void*)&pktinfo[1], sizeof(struct espconn_packet)); err = ESPCONN_OK; break; default: err = ESPCONN_ARG; break; } return err; } } /****************************************************************************** * FunctionName : espconn_set_opt * Description : set the option for connections so that we don't end up bouncing * all connections at the same time . * Parameters : espconn -- the espconn used to set the connection * opt -- the option for set * Returns : the result *******************************************************************************/ sint8 ICACHE_FLASH_ATTR espconn_set_opt(struct espconn *espconn, uint8 opt) { espconn_msg *pnode = NULL; struct tcp_pcb *tpcb; bool value = false; if (espconn == NULL) { return ESPCONN_ARG;; } else if (espconn->type != ESPCONN_TCP) return ESPCONN_ARG; /*Find the node depend on the espconn message*/ value = espconn_find_connection(espconn, &pnode); if (value) { pnode->pcommon.espconn_opt |= opt; tpcb = pnode->pcommon.pcb; if (espconn_delay_disabled(pnode)) tcp_nagle_disable(tpcb); if (espconn_keepalive_disabled(pnode)) espconn_keepalive_enable(tpcb); return ESPCONN_OK; } else return ESPCONN_ARG; } /****************************************************************************** * FunctionName : espconn_clear_opt * Description : clear the option for connections so that we don't end up bouncing * all connections at the same time . * Parameters : espconn -- the espconn used to set the connection * opt -- the option for clear * Returns : the result *******************************************************************************/ sint8 ICACHE_FLASH_ATTR espconn_clear_opt(struct espconn *espconn, uint8 opt) { espconn_msg *pnode = NULL; struct tcp_pcb *tpcb; bool value = false; if (espconn == NULL) { return ESPCONN_ARG;; } else if (espconn->type != ESPCONN_TCP) return ESPCONN_ARG; /*Find the node depend on the espconn message*/ value = espconn_find_connection(espconn, &pnode); if (value) { pnode->pcommon.espconn_opt &= ~opt; tpcb = pnode->pcommon.pcb; if (espconn_keepalive_enabled(pnode)) espconn_keepalive_disable(tpcb); if (espconn_delay_enabled(pnode)) tcp_nagle_enable(tpcb); return ESPCONN_OK; } else return ESPCONN_ARG; } /****************************************************************************** * FunctionName : espconn_set_keepalive * Description : access level value for connection so that we set the value for * keep alive * Parameters : espconn -- the espconn used to set the connection * level -- the connection's level * value -- the value of time(s) * Returns : access port value *******************************************************************************/ sint8 ICACHE_FLASH_ATTR espconn_set_keepalive(struct espconn *espconn, uint8 level, void* optarg) { espconn_msg *pnode = NULL; bool value = false; sint8 ret = ESPCONN_OK; if (espconn == NULL || optarg == NULL) { return ESPCONN_ARG;; } else if (espconn->type != ESPCONN_TCP) return ESPCONN_ARG; /*Find the node depend on the espconn message*/ value = espconn_find_connection(espconn, &pnode); if (value && espconn_keepalive_disabled(pnode)) { struct tcp_pcb *pcb = pnode->pcommon.pcb; switch (level){ case ESPCONN_KEEPIDLE: pcb->keep_idle = 1000 * (u32_t)(*(int*)optarg); ret = ESPCONN_OK; break; case ESPCONN_KEEPINTVL: pcb->keep_intvl = 1000 * (u32_t)(*(int*)optarg); ret = ESPCONN_OK; break; case ESPCONN_KEEPCNT: pcb->keep_cnt = (u32_t)(*(int*)optarg); ret = ESPCONN_OK; break; default: ret = ESPCONN_ARG; break; } return ret; } else return ESPCONN_ARG; } /****************************************************************************** * FunctionName : espconn_get_keepalive * Description : access level value for connection so that we get the value for * keep alive * Parameters : espconn -- the espconn used to get the connection * level -- the connection's level * Returns : access keep alive value *******************************************************************************/ sint8 ICACHE_FLASH_ATTR espconn_get_keepalive(struct espconn *espconn, uint8 level, void *optarg) { espconn_msg *pnode = NULL; bool value = false; sint8 ret = ESPCONN_OK; if (espconn == NULL || optarg == NULL) { return ESPCONN_ARG;; } else if (espconn->type != ESPCONN_TCP) return ESPCONN_ARG; /*Find the node depend on the espconn message*/ value = espconn_find_connection(espconn, &pnode); if (value && espconn_keepalive_disabled(pnode)) { struct tcp_pcb *pcb = pnode->pcommon.pcb; switch (level) { case ESPCONN_KEEPIDLE: *(int*)optarg = (int)(pcb->keep_idle/1000); ret = ESPCONN_OK; break; case ESPCONN_KEEPINTVL: *(int*)optarg = (int)(pcb->keep_intvl/1000); ret = ESPCONN_OK; break; case ESPCONN_KEEPCNT: *(int*)optarg = (int)(pcb->keep_cnt); ret = ESPCONN_OK; break; default: ret = ESPCONN_ARG; break; } return ret; } else return ESPCONN_ARG; } /****************************************************************************** * FunctionName : espconn_delete * Description : disconnect with host * Parameters : espconn -- the espconn used to disconnect the connection * Returns : none *******************************************************************************/ sint8 ICACHE_FLASH_ATTR espconn_delete(struct espconn *espconn) { espconn_msg *pnode = NULL; bool value = false; if (espconn == NULL) { return ESPCONN_ARG; } else if (espconn ->type != ESPCONN_UDP) return espconn_tcp_delete(espconn); /*Find the node depend on the espconn message*/ value = espconn_find_connection(espconn, &pnode); if (value){ espconn_udp_disconnect(pnode); return ESPCONN_OK; } else return ESPCONN_ARG; } /****************************************************************************** * FunctionName : espconn_port * Description : access port value for client so that we don't end up bouncing * all connections at the same time . * Parameters : none * Returns : access port value *******************************************************************************/ uint32 ICACHE_FLASH_ATTR espconn_port(void) { uint32 port = 0; static uint32 randnum = 0; do { port = system_get_time(); if (port < 0) { port = os_random() - port; } port %= 0xc350; if (port < 0x400) { port += 0x400; } } while (port == randnum); randnum = port; return port; } /****************************************************************************** * FunctionName : espconn_gethostbyname * Description : Resolve a hostname (string) into an IP address. * Parameters : pespconn -- espconn to resolve a hostname * hostname -- the hostname that is to be queried * addr -- pointer to a ip_addr_t where to store the address if * it is already cached in the dns_table (only valid if * ESPCONN_OK is returned!) * found -- a callback function to be called on success, failure * or timeout (only if ERR_INPROGRESS is returned!) * Returns : err_t return code * - ESPCONN_OK if hostname is a valid IP address string or the host * name is already in the local names table. * - ESPCONN_INPROGRESS enqueue a request to be sent to the DNS server * for resolution if no errors are present. * - ESPCONN_ARG: dns client not initialized or invalid hostname *******************************************************************************/ err_t ICACHE_FLASH_ATTR espconn_gethostbyname(struct espconn *pespconn, const char *hostname, ip_addr_t *addr, dns_found_callback found) { return dns_gethostbyname(hostname, addr, found, pespconn); } /****************************************************************************** * FunctionName : espconn_dns_setserver * Description : Initialize one of the DNS servers. * Parameters : numdns -- the index of the DNS server to set must * be < DNS_MAX_SERVERS = 2 * dnsserver -- IP address of the DNS server to set * Returns : none *******************************************************************************/ void ICACHE_FLASH_ATTR espconn_dns_setserver(u8_t numdns, ip_addr_t *dnsserver) { dns_setserver(numdns,dnsserver); } ================================================ FILE: app/lwip/app/espconn_mdns.c ================================================ /****************************************************************************** * Copyright 2013-2014 Espressif Systems (Wuxi) * * FileName: espconn_mdns.c * * Description: udp proto interface * * Modification history: * 2014/3/31, v1.0 create this file. *******************************************************************************/ #include "ets_sys.h" #include "os_type.h" #include "lwip/mdns.h" /****************************************************************************** * FunctionName : espconn_mdns_enable * Description : join a multicast group * Parameters : host_ip -- the ip address of udp server * multicast_ip -- multicast ip given by user * Returns : none *******************************************************************************/ void ICACHE_FLASH_ATTR espconn_mdns_enable(void) { mdns_enable(); } /****************************************************************************** * FunctionName : espconn_mdns_disable * Description : join a multicast group * Parameters : host_ip -- the ip address of udp server * multicast_ip -- multicast ip given by user * Returns : none *******************************************************************************/ void ICACHE_FLASH_ATTR espconn_mdns_disable(void) { mdns_disable(); } /****************************************************************************** * FunctionName : espconn_mdns_set_hostname * Description : join a multicast group * Parameters : host_ip -- the ip address of udp server * multicast_ip -- multicast ip given by user * Returns : none *******************************************************************************/ void ICACHE_FLASH_ATTR espconn_mdns_set_hostname(char *name) { mdns_set_hostname(name); } /****************************************************************************** * FunctionName : espconn_mdns_init * Description : join a multicast group * Parameters : host_ip -- the ip address of udp server * multicast_ip -- multicast ip given by user * Returns : none *******************************************************************************/ char* ICACHE_FLASH_ATTR espconn_mdns_get_hostname(void) { return (char *)mdns_get_hostname(); } /****************************************************************************** * FunctionName : espconn_mdns_get_servername * Description : join a multicast group * Parameters : info -- the info of mdns * Returns : none *******************************************************************************/ void ICACHE_FLASH_ATTR espconn_mdns_set_servername(const char *name) { mdns_set_servername(name); } /****************************************************************************** * FunctionName : espconn_mdns_get_servername * Description : join a multicast group * Parameters : info -- the info of mdns * Returns : none *******************************************************************************/ char* ICACHE_FLASH_ATTR espconn_mdns_get_servername(void) { return (char *)mdns_get_servername(); } /****************************************************************************** * FunctionName : mdns_server_register * Description : join a multicast group * Parameters : info -- the info of mdns * Returns : none *******************************************************************************/ void ICACHE_FLASH_ATTR espconn_mdns_server_register(void) { mdns_server_register(); } /****************************************************************************** * FunctionName : mdns_server_register * Description : join a multicast group * Parameters : info -- the info of mdns * Returns : none *******************************************************************************/ void ICACHE_FLASH_ATTR espconn_mdns_server_unregister(void) { mdns_server_unregister(); } /****************************************************************************** * FunctionName : espconn_mdns_init * Description : join a multicast group * Parameters : host_ip -- the ip address of udp server * multicast_ip -- multicast ip given by user * Returns : none *******************************************************************************/ void ICACHE_FLASH_ATTR espconn_mdns_close(void) { mdns_close(); } /****************************************************************************** * FunctionName : espconn_mdns_init * Description : join a multicast group * Parameters : host_ip -- the ip address of udp server * multicast_ip -- multicast ip given by user * Returns : none *******************************************************************************/ void ICACHE_FLASH_ATTR espconn_mdns_init(struct mdns_info *info) { mdns_init(info); } ================================================ FILE: app/lwip/app/espconn_tcp.c ================================================ /****************************************************************************** * Copyright 2013-2014 Espressif Systems (Wuxi) * * FileName: espconn_tcp.c * * Description: tcp proto interface * * Modification history: * 2014/3/31, v1.0 create this file. *******************************************************************************/ #include "lwip/netif.h" #include "lwip/inet.h" #include "netif/etharp.h" #include "lwip/tcp.h" #include "lwip/ip.h" #include "lwip/init.h" #include "lwip/tcp_impl.h" #include "lwip/memp.h" #include "ets_sys.h" #include "os_type.h" //#include "os.h" #include "lwip/mem.h" #include "lwip/app/espconn_tcp.h" #ifdef MEMLEAK_DEBUG static const char mem_debug_file[] ICACHE_RODATA_ATTR = __FILE__; #endif extern espconn_msg *plink_active; extern espconn_msg *pserver_list; extern struct espconn_packet pktinfo[2]; extern struct tcp_pcb ** const tcp_pcb_lists[]; os_event_t espconn_TaskQueue[espconn_TaskQueueLen]; static err_t espconn_client_recv(void *arg, struct tcp_pcb *pcb, struct pbuf *p, err_t err); static void espconn_client_close(void *arg, struct tcp_pcb *pcb); static err_t espconn_server_recv(void *arg, struct tcp_pcb *pcb, struct pbuf *p, err_t err); static void espconn_server_close(void *arg, struct tcp_pcb *pcb); ///////////////////////////////common function///////////////////////////////// /****************************************************************************** * FunctionName : espconn_kill_oldest * Description : kill the oldest TCP block * Parameters : none * Returns : none *******************************************************************************/ static void ICACHE_FLASH_ATTR espconn_kill_oldest(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) { tcp_abort(inactive); } /* 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_1 || pcb->state == FIN_WAIT_2){ if ((u32_t) (tcp_ticks - pcb->tmr) >= inactivity) { inactivity = tcp_ticks - pcb->tmr; inactive = pcb; } } } /*Purges the PCB, removes it from a PCB list and frees the memory*/ if (inactive != NULL) { tcp_pcb_remove(&tcp_active_pcbs, inactive); memp_free(MEMP_TCP_PCB, inactive); } /* 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; } } } /*Purges the PCB, removes it from a PCB list and frees the memory*/ if (inactive != NULL) { tcp_pcb_remove(&tcp_active_pcbs, inactive); memp_free(MEMP_TCP_PCB, inactive); } } /****************************************************************************** * FunctionName : espconn_kill_oldest_pcb * Description : find the oldest TCP block by state * Parameters : none * Returns : none *******************************************************************************/ void ICACHE_FLASH_ATTR espconn_kill_oldest_pcb(void) { struct tcp_pcb *cpcb = NULL; uint8 i = 0; uint8 num_tcp_fin = 0; for(i = 2; i < 4; i ++){ for (cpcb = *tcp_pcb_lists[i]; cpcb != NULL; cpcb = cpcb->next) { if (cpcb->state == TIME_WAIT){ num_tcp_fin ++; if (num_tcp_fin == MEMP_NUM_TCP_PCB) break; } if (cpcb->state == FIN_WAIT_1 || cpcb->state == FIN_WAIT_2 || cpcb->state == LAST_ACK){ num_tcp_fin++; if (num_tcp_fin == MEMP_NUM_TCP_PCB) break; } } if (num_tcp_fin == MEMP_NUM_TCP_PCB){ num_tcp_fin = 0; espconn_kill_oldest(); } else if (cpcb == NULL){ num_tcp_fin = 0; } } } /****************************************************************************** * FunctionName : espconn_kill_pcb * Description : kill all the TCP block by port * Parameters : none * Returns : none *******************************************************************************/ void ICACHE_FLASH_ATTR espconn_kill_pcb(u16_t port) { struct tcp_pcb *cpcb = NULL; uint8 i = 0; struct tcp_pcb *inactive = NULL; struct tcp_pcb *prev = NULL; u8_t pcb_remove; /* Check if the address already is in use (on all lists) */ for (i = 1; i < 4; i++) { cpcb = *tcp_pcb_lists[i]; while(cpcb != NULL){ pcb_remove = 0; if (cpcb->local_port == port) { ++pcb_remove; } /* If the PCB should be removed, do it. */ if (pcb_remove) { /* Remove PCB from tcp_pcb_lists list. */ inactive = cpcb; cpcb = inactive->next; tcp_pcb_remove(tcp_pcb_lists[i], inactive); memp_free(MEMP_TCP_PCB, inactive); } else { cpcb = cpcb->next; } } } } /****************************************************************************** * FunctionName : espconn_find_current_pcb * Description : find the TCP block which option * Parameters : pcurrent_msg -- the node in the list which active * Returns : TCP block point *******************************************************************************/ struct tcp_pcb *ICACHE_FLASH_ATTR espconn_find_current_pcb(espconn_msg *pcurrent_msg) { uint16 local_port = pcurrent_msg->pcommon.local_port; uint32 local_ip = pcurrent_msg->pcommon.local_ip; uint16 remote_port = pcurrent_msg->pcommon.remote_port; uint32 remote_ip = *((uint32*)&pcurrent_msg->pcommon.remote_ip); struct tcp_pcb *find_pcb = NULL; if (pcurrent_msg ->preverse == NULL){/*Find the server's TCP block*/ if (local_ip == 0|| local_port == 0) return pcurrent_msg->pcommon.pcb; for (find_pcb = tcp_active_pcbs; find_pcb != NULL; find_pcb = find_pcb->next){ if ((find_pcb->remote_port == remote_port) && (find_pcb->remote_ip.addr == remote_ip) && (find_pcb->local_port == local_port) && (find_pcb->local_ip.addr == local_ip)) return find_pcb; } for (find_pcb = tcp_tw_pcbs; find_pcb != NULL; find_pcb = find_pcb->next){ if ((find_pcb->remote_port == remote_port) && (find_pcb->remote_ip.addr == remote_ip) && (find_pcb->local_port == local_port) && (find_pcb->local_ip.addr == local_ip)) return find_pcb; } } else {/*Find the client's TCP block*/ if (remote_ip == 0|| remote_port == 0) return pcurrent_msg->pcommon.pcb; for (find_pcb = tcp_active_pcbs; find_pcb != NULL; find_pcb = find_pcb->next){ if ((find_pcb->remote_port == remote_port) && (find_pcb->remote_ip.addr == remote_ip)) return find_pcb; } for (find_pcb = tcp_tw_pcbs; find_pcb != NULL; find_pcb = find_pcb->next){ if ((find_pcb->remote_port == remote_port) && (find_pcb->remote_ip.addr == remote_ip)) return find_pcb; } } return NULL; } /****************************************************************************** * FunctionName : espconn_tcp_reconnect * Description : reconnect with host * Parameters : arg -- Additional argument to pass to the callback function * Returns : none *******************************************************************************/ static void ICACHE_FLASH_ATTR espconn_tcp_reconnect(void *arg) { espconn_msg *precon_cb = arg; sint8 re_err = 0; espconn_buf *perr_buf = NULL; espconn_buf *perr_back = NULL; espconn_kill_oldest_pcb(); if (precon_cb != NULL) { struct espconn *espconn = precon_cb->preverse; re_err = precon_cb->pcommon.err; if (precon_cb->pespconn != NULL){ if (espconn != NULL){/*Process the server's message block*/ if (precon_cb->pespconn->proto.tcp != NULL){ espconn_copy_partial(espconn, precon_cb->pespconn); espconn_printf("server: %d.%d.%d.%d : %d reconnection\n", espconn->proto.tcp->remote_ip[0], espconn->proto.tcp->remote_ip[1],espconn->proto.tcp->remote_ip[2], espconn->proto.tcp->remote_ip[3],espconn->proto.tcp->remote_port); os_free(precon_cb->pespconn->proto.tcp); precon_cb->pespconn->proto.tcp = NULL; } os_free(precon_cb->pespconn); precon_cb->pespconn = NULL; } else {/*Process the client's message block*/ espconn = precon_cb->pespconn; espconn_printf("client: %d.%d.%d.%d : %d reconnection\n", espconn->proto.tcp->local_ip[0], espconn->proto.tcp->local_ip[1],espconn->proto.tcp->local_ip[2], espconn->proto.tcp->local_ip[3],espconn->proto.tcp->local_port); } } /*to prevent memory leaks, ensure that each allocated is deleted*/ perr_buf = precon_cb->pcommon.pbuf; while (perr_buf != NULL){ perr_back = perr_buf; perr_buf = perr_back->pnext; espconn_pbuf_delete(&precon_cb->pcommon.pbuf,perr_back); os_free(perr_back); perr_back = NULL; } os_bzero(&pktinfo[1], sizeof(struct espconn_packet)); os_memcpy(&pktinfo[1], (void*)&precon_cb->pcommon.packet_info, sizeof(struct espconn_packet)); os_free(precon_cb); precon_cb = NULL; if (espconn && espconn->proto.tcp && espconn->proto.tcp->reconnect_callback != NULL) { espconn->proto.tcp->reconnect_callback(espconn, re_err); } } else { espconn_printf("espconn_tcp_reconnect err\n"); } } /****************************************************************************** * FunctionName : espconn_tcp_disconnect * Description : disconnect with host * Parameters : arg -- Additional argument to pass to the callback function * Returns : none *******************************************************************************/ static void ICACHE_FLASH_ATTR espconn_tcp_disconnect_successful(void *arg) { espconn_msg *pdiscon_cb = arg; sint8 dis_err = 0; espconn_buf *pdis_buf = NULL; espconn_buf *pdis_back = NULL; espconn_kill_oldest_pcb(); if (pdiscon_cb != NULL) { struct espconn *espconn = pdiscon_cb->preverse; dis_err = pdiscon_cb->pcommon.err; if (pdiscon_cb->pespconn != NULL){ struct tcp_pcb *pcb = NULL; if (espconn != NULL){/*Process the server's message block*/ if (pdiscon_cb->pespconn->proto.tcp != NULL && espconn->proto.tcp){ espconn_copy_partial(espconn, pdiscon_cb->pespconn); espconn_printf("server: %d.%d.%d.%d : %d disconnect\n", espconn->proto.tcp->remote_ip[0], espconn->proto.tcp->remote_ip[1],espconn->proto.tcp->remote_ip[2], espconn->proto.tcp->remote_ip[3],espconn->proto.tcp->remote_port); os_free(pdiscon_cb->pespconn->proto.tcp); pdiscon_cb->pespconn->proto.tcp = NULL; } os_free(pdiscon_cb->pespconn); pdiscon_cb->pespconn = NULL; } else {/*Process the client's message block*/ espconn = pdiscon_cb->pespconn; espconn_printf("client: %d.%d.%d.%d : %d disconnect\n", espconn->proto.tcp->local_ip[0], espconn->proto.tcp->local_ip[1],espconn->proto.tcp->local_ip[2], espconn->proto.tcp->local_ip[3],espconn->proto.tcp->local_port); } /*process the current TCP block*/ pcb = espconn_find_current_pcb(pdiscon_cb); if (pcb != NULL){ if (espconn_reuse_disabled(pdiscon_cb)) { struct tcp_pcb *cpcb = NULL; struct tcp_pcb *prev = NULL; u8_t pcb_remove; espconn_printf("espconn_tcp_disconnect_successful %d, %d\n", pcb->state, pcb->local_port); cpcb = tcp_tw_pcbs; while (cpcb != NULL) { pcb_remove = 0; if (cpcb->local_port == pcb->local_port) { ++pcb_remove; } /* If the PCB should be removed, do it. */ if (pcb_remove) { struct tcp_pcb *backup_pcb = NULL; tcp_pcb_purge(cpcb); /* Remove PCB from tcp_tw_pcbs list. */ if (prev != NULL) { LWIP_ASSERT("espconn_tcp_delete: middle cpcb != tcp_tw_pcbs",cpcb != tcp_tw_pcbs); prev->next = cpcb->next; } else { /* This PCB was the first. */ LWIP_ASSERT("espconn_tcp_delete: first cpcb == tcp_tw_pcbs",tcp_tw_pcbs == cpcb); tcp_tw_pcbs = cpcb->next; } backup_pcb = cpcb; cpcb = cpcb->next; memp_free(MEMP_TCP_PCB, backup_pcb); } else { prev = cpcb; cpcb = cpcb->next; } } } else { tcp_arg(pcb, NULL); tcp_err(pcb, NULL); } } } /*to prevent memory leaks, ensure that each allocated is deleted*/ pdis_buf = pdiscon_cb->pcommon.pbuf; while (pdis_buf != NULL) { pdis_back = pdis_buf; pdis_buf = pdis_back->pnext; espconn_pbuf_delete(&pdiscon_cb->pcommon.pbuf, pdis_back); os_free(pdis_back); pdis_back = NULL; } os_bzero(&pktinfo[0], sizeof(struct espconn_packet)); os_memcpy(&pktinfo[0], (void*)&pdiscon_cb->pcommon.packet_info, sizeof(struct espconn_packet)); os_free(pdiscon_cb); pdiscon_cb = NULL; if (espconn->proto.tcp && espconn->proto.tcp->disconnect_callback != NULL) { espconn->proto.tcp->disconnect_callback(espconn); } } else { espconn_printf("espconn_tcp_disconnect err\n"); } } /****************************************************************************** * FunctionName : espconn_Task * Description : espconn processing task * Parameters : events -- contain the espconn processing data * Returns : none *******************************************************************************/ static void ICACHE_FLASH_ATTR espconn_Task(os_event_t *events) { espconn_msg *task_msg = NULL; struct espconn *pespconn = NULL; task_msg = (espconn_msg *) events->par; switch (events->sig) { case SIG_ESPCONN_WRITE: { pespconn = task_msg->pespconn; if (pespconn == NULL) { return; } if (pespconn->proto.tcp->write_finish_fn != NULL) { pespconn->proto.tcp->write_finish_fn(pespconn); } } break; case SIG_ESPCONN_ERRER: /*remove the node from the client's active connection list*/ espconn_list_delete(&plink_active, task_msg); espconn_tcp_reconnect(task_msg); break; case SIG_ESPCONN_CLOSE: /*remove the node from the client's active connection list*/ espconn_list_delete(&plink_active, task_msg); espconn_tcp_disconnect_successful(task_msg); break; default: break; } } /****************************************************************************** * FunctionName : espconn_tcp_sent * Description : sent data for client or server * Parameters : void *arg -- client or server to send * uint8* psent -- Data to send * uint16 length -- Length of data to send * Returns : return espconn error code. * - ESPCONN_OK. Successful. No error occured. * - ESPCONN_MEM. Out of memory. * - ESPCONN_RTE. Could not find route to destination address. * - More errors could be returned by lower protocol layers. *******************************************************************************/ err_t ICACHE_FLASH_ATTR espconn_tcp_sent(void *arg, uint8 *psent, uint16 length) { espconn_msg *ptcp_sent = arg; struct tcp_pcb *pcb = NULL; err_t err = 0; u16_t len = 0; u8_t data_to_send = false; espconn_printf("espconn_tcp_sent ptcp_sent %p psent %p length %d\n", ptcp_sent, psent, length); /*Check the parameters*/ if (ptcp_sent == NULL || psent == NULL || length == 0) { return ESPCONN_ARG; } /*Set the packet length depend on the sender buffer space*/ pcb = ptcp_sent->pcommon.pcb; if (tcp_sndbuf(pcb) < length) { len = tcp_sndbuf(pcb); } else { len = length; LWIP_ASSERT("length did not fit into uint16!", (len == length)); } if (len > (2*pcb->mss)) { len = 2*pcb->mss; } /*Write data for sending, but does not send it immediately*/ do { espconn_printf("espconn_tcp_sent writing %d bytes %p\n", len, pcb); if (espconn_copy_disabled(ptcp_sent)) err = tcp_write(pcb, psent, len, 1); else err = tcp_write(pcb, psent, len, 0); if (err == ERR_MEM) { len /= 2; } } while (err == ERR_MEM && len > 1); /*Find out what we can send and send it, offset the buffer point for next send*/ if (err == ERR_OK) { ptcp_sent->pcommon.ptail->punsent = psent + len; ptcp_sent->pcommon.ptail->unsent = length - len; err = tcp_output(pcb); /*If enable the copy option, change the flag for next write*/ if (espconn_copy_disabled(ptcp_sent)){ if (ptcp_sent->pcommon.ptail->unsent == 0) { ptcp_sent->pcommon.write_flag = true; ets_post(espconn_TaskPrio, SIG_ESPCONN_WRITE, (uint32_t)ptcp_sent); } } espconn_printf("espconn_tcp_sent %d\n", err); } return err; } /****************************************************************************** * FunctionName : espconn_close * Description : The connection has been successfully closed. * Parameters : arg -- Additional argument to pass to the callback function * Returns : none *******************************************************************************/ void ICACHE_FLASH_ATTR espconn_tcp_disconnect(espconn_msg *pdiscon) { if (pdiscon != NULL){ /*disconnect with the host by send the FIN frame*/ if (pdiscon->preverse != NULL) espconn_server_close(pdiscon, pdiscon->pcommon.pcb); else espconn_client_close(pdiscon, pdiscon->pcommon.pcb); } else{ espconn_printf("espconn_tcp_disconnect err.\n"); } } ///////////////////////////////client function///////////////////////////////// /****************************************************************************** * FunctionName : espconn_client_close * Description : The connection shall be actively closed. * Parameters : pcb -- Additional argument to pass to the callback function * pcb -- the pcb to close * Returns : none *******************************************************************************/ static void ICACHE_FLASH_ATTR espconn_client_close(void *arg, struct tcp_pcb *pcb) { err_t err; espconn_msg *pclose = arg; pclose->pcommon.pcb = pcb; /*avoid recalling the disconnect function*/ tcp_recv(pcb, NULL); err = tcp_close(pcb); if (err != ERR_OK) { /* closing failed, try again later */ tcp_recv(pcb, espconn_client_recv); } else { /* closing succeeded */ tcp_sent(pcb, NULL); tcp_err(pcb, NULL); /*switch the state of espconn for application process*/ pclose->pespconn->state = ESPCONN_CLOSE; ets_post(espconn_TaskPrio, SIG_ESPCONN_CLOSE, (uint32_t)pclose); } } //***********Code for WIFI_BLOCK from upper************** sint8 ICACHE_FLASH_ATTR espconn_recv_hold(struct espconn *pespconn) { //1st, according to espconn code, have to find out the escpconn_msg by pespconn; espconn_msg *pnode = NULL; bool value = false; if (pespconn == NULL) { return ESPCONN_ARG; } value = espconn_find_connection(pespconn, &pnode); if(value != true) { os_printf("RecvHold, By pespconn,find conn_msg fail\n"); return ESPCONN_ARG; } //2nd, the actual operation if(pnode->recv_hold_flag == 0) { pnode->recv_hold_flag = 1; pnode->recv_holded_buf_Len = 0; } return ESPCONN_OK; } sint8 ICACHE_FLASH_ATTR espconn_recv_unhold(struct espconn *pespconn) { //1st, according to espconn code, have to find out the escpconn_msg by pespconn; espconn_msg *pnode = NULL; bool value = false; if (pespconn == NULL) { return ESPCONN_ARG; } value = espconn_find_connection(pespconn, &pnode); if(value != true) { os_printf("RecvHold, By pespconn,find conn_msg fail\n"); return ESPCONN_ARG; } //2nd, the actual operation if(pnode->recv_hold_flag == 1) { if(pespconn->type == ESPCONN_TCP) { tcp_recved(pnode->pcommon.pcb, pnode->recv_holded_buf_Len); } pnode->recv_holded_buf_Len = 0; pnode->recv_hold_flag = 0; } return ESPCONN_OK; } //***********Code for WIFI_BLOCK from upper************** /****************************************************************************** * FunctionName : espconn_client_recv * Description : Data has been received on this pcb. * Parameters : arg -- Additional argument to pass to the callback function * pcb -- The connection pcb which received data * p -- The received data (or NULL when the connection has been closed!) * err -- An error code if there has been an error receiving * Returns : ERR_ABRT: if you have called tcp_abort from within the function! *******************************************************************************/ static err_t ICACHE_FLASH_ATTR espconn_client_recv(void *arg, struct tcp_pcb *pcb, struct pbuf *p, err_t err) { espconn_msg *precv_cb = arg; tcp_arg(pcb, arg); if (p != NULL) { /*To update and advertise a larger window*/ if(precv_cb->recv_hold_flag == 0) tcp_recved(pcb, p->tot_len); else precv_cb->recv_holded_buf_Len += p->tot_len; } if (err == ERR_OK && p != NULL) { char *pdata = NULL; u16_t length = 0; /*Copy the contents of a packet buffer to an application buffer. *to prevent memory leaks, ensure that each allocated is deleted*/ pdata = (char *)os_zalloc(p ->tot_len + 1); length = pbuf_copy_partial(p, pdata, p ->tot_len, 0); pbuf_free(p); if (length != 0) { /*switch the state of espconn for application process*/ precv_cb->pespconn ->state = ESPCONN_READ; precv_cb->pcommon.pcb = pcb; if (precv_cb->pespconn->recv_callback != NULL) { precv_cb->pespconn->recv_callback(precv_cb->pespconn, pdata, length); } /*switch the state of espconn for next packet copy*/ if (pcb->state == ESTABLISHED) precv_cb->pespconn ->state = ESPCONN_CONNECT; } /*to prevent memory leaks, ensure that each allocated is deleted*/ os_free(pdata); pdata = NULL; } if (err == ERR_OK && p == NULL) { espconn_client_close(precv_cb, pcb); } return ERR_OK; } /****************************************************************************** * FunctionName : espconn_tcp_write * Description : write the packet which in the active connection's list. * Parameters : arg -- the node pointer which reverse the packet * Returns : ESPCONN_MEM: memory error * ESPCONN_OK:have enough space for write packet *******************************************************************************/ err_t ICACHE_FLASH_ATTR espconn_tcp_write(void *arg) { espconn_msg *pwrite = arg; err_t err = ERR_OK; struct tcp_pcb *pcb = pwrite->pcommon.pcb; /*for one active connection,limit the sender buffer space*/ if (tcp_nagle_disabled(pcb) && (pcb->snd_queuelen >= TCP_SND_QUEUELEN)) return ESPCONN_MEM; while (tcp_sndbuf(pcb) != 0){ if (pwrite->pcommon.ptail != NULL) { /*Find the node whether in the list's tail or not*/ if (pwrite->pcommon.ptail->unsent == 0) { pwrite->pcommon.ptail = pwrite->pcommon.ptail->pnext; continue; } /*Send the packet for the active connection*/ err = espconn_tcp_sent(pwrite, pwrite->pcommon.ptail->punsent,pwrite->pcommon.ptail->unsent); if (err != ERR_OK) break; } else break; } return err; } /****************************************************************************** * FunctionName : espconn_tcp_reconnect * Description : reconnect with host * Parameters : arg -- Additional argument to pass to the callback function * Returns : none *******************************************************************************/ static void ICACHE_FLASH_ATTR espconn_tcp_finish(void *arg) { espconn_msg *pfinish = arg; espconn_buf *premove = NULL; uint16 len = 0; espconn_tcp_write(pfinish); while (pfinish->pcommon.pbuf != NULL){ premove = pfinish->pcommon.pbuf; pfinish->pcommon.pbuf->tot_len += len; /*application packet has been sent and acknowledged by the remote host, * to prevent memory leaks, ensure that each allocated is deleted*/ if (premove->tot_len >= premove->len){ espconn_pbuf_delete(&pfinish->pcommon.pbuf,premove); len = premove->tot_len - premove->len; pfinish->pcommon.packet_info.sent_length = premove->len; os_free(premove); premove = NULL; pfinish->pespconn->state = ESPCONN_CONNECT; if (pfinish->pespconn->sent_callback != NULL) { pfinish->pespconn->sent_callback(pfinish->pespconn); } pfinish->pcommon.packet_info.sent_length = len; } else break; } } /****************************************************************************** * FunctionName : espconn_client_sent * Description : Data has been sent and acknowledged by the remote host. * This means that more data can be sent. * Parameters : arg -- Additional argument to pass to the callback function * pcb -- The connection pcb for which data has been acknowledged * len -- The amount of bytes acknowledged * Returns : ERR_OK: try to send some data by calling tcp_output * ERR_ABRT: if you have called tcp_abort from within the function! *******************************************************************************/ static err_t ICACHE_FLASH_ATTR espconn_client_sent(void *arg, struct tcp_pcb *pcb, u16_t len) { espconn_msg *psent_cb = arg; psent_cb->pcommon.pcb = pcb; psent_cb->pcommon.pbuf->tot_len += len; psent_cb->pcommon.packet_info.sent_length = len; /*Send more data for one active connection*/ espconn_tcp_finish(psent_cb); return ERR_OK; } /****************************************************************************** * FunctionName : espconn_client_err * Description : The pcb had an error and is already deallocated. * The argument might still be valid (if != NULL). * Parameters : arg -- Additional argument to pass to the callback function * err -- Error code to indicate why the pcb has been closed * Returns : none *******************************************************************************/ static void ICACHE_FLASH_ATTR espconn_client_err(void *arg, err_t err) { espconn_msg *perr_cb = arg; struct tcp_pcb *pcb = NULL; LWIP_UNUSED_ARG(err); if (perr_cb != NULL) { pcb = perr_cb->pcommon.pcb; perr_cb->pespconn->state = ESPCONN_CLOSE; espconn_printf("espconn_client_err %d %d %d\n", pcb->state, pcb->nrtx, err); // /*remove the node from the client's active connection list*/ // espconn_list_delete(&plink_active, perr_cb); /*Set the error code depend on the error type and control block state*/ if (err == ERR_ABRT) { switch (pcb->state) { case SYN_SENT: if (pcb->nrtx == TCP_SYNMAXRTX) { perr_cb->pcommon.err = ESPCONN_CONN; } else { perr_cb->pcommon.err = err; } break; case ESTABLISHED: if (pcb->nrtx == TCP_MAXRTX) { perr_cb->pcommon.err = ESPCONN_TIMEOUT; } else { perr_cb->pcommon.err = err; } break; case FIN_WAIT_1: if (pcb->nrtx == TCP_MAXRTX) { perr_cb->pcommon.err = ESPCONN_CLSD; } else { perr_cb->pcommon.err = err; } break; case FIN_WAIT_2: perr_cb->pcommon.err = ESPCONN_CLSD; break; case CLOSED: perr_cb->pcommon.err = ESPCONN_CONN; break; } } else { perr_cb->pcommon.err = err; } /*post the singer to the task for processing the connection*/ ets_post(espconn_TaskPrio, SIG_ESPCONN_ERRER, (uint32_t)perr_cb); } } /****************************************************************************** * FunctionName : espconn_client_connect * Description : A new incoming connection has been connected. * Parameters : arg -- Additional argument to pass to the callback function * tpcb -- The connection pcb which is connected * err -- An unused error code, always ERR_OK currently * Returns : connection result *******************************************************************************/ static err_t ICACHE_FLASH_ATTR espconn_client_connect(void *arg, struct tcp_pcb *tpcb, err_t err) { espconn_msg *pcon = arg; espconn_printf("espconn_client_connect pcon %p tpcb %p\n", pcon, tpcb); if (err == ERR_OK){ /*Reserve the remote information for current active connection*/ pcon->pespconn->state = ESPCONN_CONNECT; pcon->pcommon.err = err; pcon->pcommon.pcb = tpcb; pcon->pcommon.local_port = tpcb->local_port; pcon->pcommon.local_ip = tpcb->local_ip.addr; pcon->pcommon.remote_port = tpcb->remote_port; pcon->pcommon.remote_ip[0] = ip4_addr1_16(&tpcb->remote_ip); pcon->pcommon.remote_ip[1] = ip4_addr2_16(&tpcb->remote_ip); pcon->pcommon.remote_ip[2] = ip4_addr3_16(&tpcb->remote_ip); pcon->pcommon.remote_ip[3] = ip4_addr4_16(&tpcb->remote_ip); pcon->pcommon.write_flag = true; tcp_arg(tpcb, (void *) pcon); /*Set the specify function that should be called * when TCP data has been successfully delivered, * when active connection receives data*/ tcp_sent(tpcb, espconn_client_sent); tcp_recv(tpcb, espconn_client_recv); /*Disable Nagle algorithm default*/ tcp_nagle_disable(tpcb); /*Default set the total number of espconn_buf on the unsent lists for one*/ espconn_tcp_set_buf_count(pcon->pespconn, 1); if (pcon->pespconn->proto.tcp->connect_callback != NULL) { pcon->pespconn->proto.tcp->connect_callback(pcon->pespconn); } /*Enable keep alive option*/ if (espconn_keepalive_disabled(pcon)) espconn_keepalive_enable(tpcb); } else{ os_printf("err in host connected (%s)\n",lwip_strerr(err)); } return err; } /****************************************************************************** * FunctionName : espconn_tcp_client * Description : Initialize the client: set up a connect PCB and bind it to * the defined port * Parameters : espconn -- the espconn used to build client * Returns : none *******************************************************************************/ sint8 ICACHE_FLASH_ATTR espconn_tcp_client(struct espconn *espconn) { struct tcp_pcb *pcb = NULL; struct ip_addr ipaddr; espconn_msg *pclient = NULL; /*Creates a new client control message*/ pclient = (espconn_msg *)os_zalloc(sizeof(espconn_msg)); if (pclient == NULL){ return ESPCONN_MEM; } /*Set an IP address given for Little-endian.*/ IP4_ADDR(&ipaddr, espconn->proto.tcp->remote_ip[0], espconn->proto.tcp->remote_ip[1], espconn->proto.tcp->remote_ip[2], espconn->proto.tcp->remote_ip[3]); /*Creates a new TCP protocol control block*/ pcb = tcp_new(); if (pcb == NULL) { /*to prevent memory leaks, ensure that each allocated is deleted*/ os_free(pclient); pclient = NULL; return ESPCONN_MEM; } else { /*insert the node to the active connection list*/ espconn_list_creat(&plink_active, pclient); tcp_arg(pcb, (void *)pclient); tcp_err(pcb, espconn_client_err); pclient->preverse = NULL; pclient->pespconn = espconn; pclient->pespconn->state = ESPCONN_WAIT; pclient->pcommon.pcb = pcb; tcp_bind(pcb, IP_ADDR_ANY, pclient->pespconn->proto.tcp->local_port); #if 0 pclient->pcommon.err = tcp_bind(pcb, IP_ADDR_ANY, pclient->pespconn->proto.tcp->local_port); if (pclient->pcommon.err != ERR_OK){ /*remove the node from the client's active connection list*/ espconn_list_delete(&plink_active, pclient); memp_free(MEMP_TCP_PCB, pcb); os_free(pclient); pclient = NULL; return ERR_USE; } #endif /*Establish the connection*/ pclient->pcommon.err = tcp_connect(pcb, &ipaddr, pclient->pespconn->proto.tcp->remote_port, espconn_client_connect); if (pclient->pcommon.err == ERR_RTE){ /*remove the node from the client's active connection list*/ espconn_list_delete(&plink_active, pclient); espconn_kill_pcb(pcb->local_port); os_free(pclient); pclient = NULL; return ESPCONN_RTE; } return pclient->pcommon.err; } } ///////////////////////////////server function///////////////////////////////// /****************************************************************************** * FunctionName : espconn_server_close * Description : The connection shall be actively closed. * Parameters : arg -- Additional argument to pass to the callback function * pcb -- the pcb to close * Returns : none *******************************************************************************/ static void ICACHE_FLASH_ATTR espconn_server_close(void *arg, struct tcp_pcb *pcb) { err_t err; espconn_msg *psclose = arg; psclose->pcommon.pcb = pcb; /*avoid recalling the disconnect function*/ tcp_recv(pcb, NULL); err = tcp_close(pcb); if (err != ERR_OK) { /* closing failed, try again later */ tcp_recv(pcb, espconn_server_recv); } else { /* closing succeeded */ tcp_poll(pcb, NULL, 0); tcp_sent(pcb, NULL); tcp_err(pcb, NULL); /*switch the state of espconn for application process*/ psclose->pespconn->state = ESPCONN_CLOSE; ets_post(espconn_TaskPrio, SIG_ESPCONN_CLOSE, (uint32_t)psclose); } } /****************************************************************************** * FunctionName : espconn_server_recv * Description : Data has been received on this pcb. * Parameters : arg -- Additional argument to pass to the callback function * pcb -- The connection pcb which received data * p -- The received data (or NULL when the connection has been closed!) * err -- An error code if there has been an error receiving * Returns : ERR_ABRT: if you have called tcp_abort from within the function! *******************************************************************************/ static err_t ICACHE_FLASH_ATTR espconn_server_recv(void *arg, struct tcp_pcb *pcb, struct pbuf *p, err_t err) { espconn_msg *precv_cb = arg; tcp_arg(pcb, arg); espconn_printf("server has application data received: %d\n", system_get_free_heap_size()); if (p != NULL) { /*To update and advertise a larger window*/ if(precv_cb->recv_hold_flag == 0) tcp_recved(pcb, p->tot_len); else precv_cb->recv_holded_buf_Len += p->tot_len; } if (err == ERR_OK && p != NULL) { u8_t *data_ptr = NULL; u32_t data_cntr = 0; /*clear the count for connection timeout*/ precv_cb->pcommon.recv_check = 0; /*Copy the contents of a packet buffer to an application buffer. *to prevent memory leaks, ensure that each allocated is deleted*/ data_ptr = (u8_t *)os_zalloc(p ->tot_len + 1); data_cntr = pbuf_copy_partial(p, data_ptr, p ->tot_len, 0); pbuf_free(p); if (data_cntr != 0) { /*switch the state of espconn for application process*/ precv_cb->pespconn ->state = ESPCONN_READ; precv_cb->pcommon.pcb = pcb; if (precv_cb->pespconn->recv_callback != NULL) { precv_cb->pespconn->recv_callback(precv_cb->pespconn, data_ptr, data_cntr); } /*switch the state of espconn for next packet copy*/ if (pcb->state == ESTABLISHED) precv_cb->pespconn ->state = ESPCONN_CONNECT; } /*to prevent memory leaks, ensure that each allocated is deleted*/ os_free(data_ptr); data_ptr = NULL; espconn_printf("server's application data has been processed: %d\n", system_get_free_heap_size()); } else { if (p != NULL) { pbuf_free(p); } espconn_server_close(precv_cb, pcb); } return ERR_OK; } /****************************************************************************** * FunctionName : espconn_server_sent * Description : Data has been sent and acknowledged by the remote host. * This means that more data can be sent. * Parameters : arg -- Additional argument to pass to the callback function * pcb -- The connection pcb for which data has been acknowledged * len -- The amount of bytes acknowledged * Returns : ERR_OK: try to send some data by calling tcp_output * ERR_ABRT: if you have called tcp_abort from within the function! *******************************************************************************/ static err_t ICACHE_FLASH_ATTR espconn_server_sent(void *arg, struct tcp_pcb *pcb, u16_t len) { espconn_msg *psent_cb = arg; psent_cb->pcommon.pcb = pcb; psent_cb->pcommon.recv_check = 0; psent_cb->pcommon.pbuf->tot_len += len; psent_cb->pcommon.packet_info.sent_length = len; /*Send more data for one active connection*/ espconn_tcp_finish(psent_cb); return ERR_OK; } /****************************************************************************** * FunctionName : espconn_server_poll * Description : The poll function is called every 3nd second. * If there has been no data sent (which resets the retries) in 3 seconds, close. * If the last portion of a file has not been sent in 3 seconds, close. * * This could be increased, but we don't want to waste resources for bad connections. * Parameters : arg -- Additional argument to pass to the callback function * pcb -- The connection pcb for which data has been acknowledged * Returns : ERR_OK: try to send some data by calling tcp_output * ERR_ABRT: if you have called tcp_abort from within the function! *******************************************************************************/ static err_t ICACHE_FLASH_ATTR espconn_server_poll(void *arg, struct tcp_pcb *pcb) { espconn_msg *pspoll_cb = arg; /*exception calling abandon the connection for send a RST frame*/ if (arg == NULL) { tcp_abandon(pcb, 0); tcp_poll(pcb, NULL, 0); return ERR_OK; } espconn_printf("espconn_server_poll %d %d\n", pspoll_cb->pcommon.recv_check, pcb->state); pspoll_cb->pcommon.pcb = pcb; if (pcb->state == ESTABLISHED) { pspoll_cb->pcommon.recv_check++; if (pspoll_cb->pcommon.timeout != 0){/*no data sent in one active connection's set timeout, close.*/ if (pspoll_cb->pcommon.recv_check >= pspoll_cb->pcommon.timeout) { pspoll_cb->pcommon.recv_check = 0; espconn_server_close(pspoll_cb, pcb); } } else { espconn_msg *ptime_msg = pserver_list; while (ptime_msg != NULL) { if (ptime_msg->pespconn == pspoll_cb->preverse){ if (ptime_msg->pcommon.timeout != 0){/*no data sent in server's set timeout, close.*/ if (pspoll_cb->pcommon.recv_check >= ptime_msg->pcommon.timeout){ pspoll_cb->pcommon.recv_check = 0; espconn_server_close(pspoll_cb, pcb); } } else {/*don't close for ever*/ pspoll_cb->pcommon.recv_check = 0; } break; } ptime_msg = ptime_msg->pnext; } } } else { espconn_server_close(pspoll_cb, pcb); } return ERR_OK; } /****************************************************************************** * FunctionName : esponn_server_err * Description : The pcb had an error and is already deallocated. * The argument might still be valid (if != NULL). * Parameters : arg -- Additional argument to pass to the callback function * err -- Error code to indicate why the pcb has been closed * Returns : none *******************************************************************************/ static void ICACHE_FLASH_ATTR esponn_server_err(void *arg, err_t err) { espconn_msg *pserr_cb = arg; struct tcp_pcb *pcb = NULL; if (pserr_cb != NULL) { pcb = pserr_cb->pcommon.pcb; pserr_cb->pespconn->state = ESPCONN_CLOSE; // /*remove the node from the server's active connection list*/ // espconn_list_delete(&plink_active, pserr_cb); /*Set the error code depend on the error type and control block state*/ if (err == ERR_ABRT) { switch (pcb->state) { case SYN_RCVD: if (pcb->nrtx == TCP_SYNMAXRTX) { pserr_cb->pcommon.err = ESPCONN_CONN; } else { pserr_cb->pcommon.err = err; } break; case ESTABLISHED: if (pcb->nrtx == TCP_MAXRTX) { pserr_cb->pcommon.err = ESPCONN_TIMEOUT; } else { pserr_cb->pcommon.err = err; } break; case CLOSE_WAIT: if (pcb->nrtx == TCP_MAXRTX) { pserr_cb->pcommon.err = ESPCONN_CLSD; } else { pserr_cb->pcommon.err = err; } break; case LAST_ACK: pserr_cb->pcommon.err = ESPCONN_CLSD; break; case CLOSED: pserr_cb->pcommon.err = ESPCONN_CONN; break; default : break; } } else { pserr_cb->pcommon.err = err; } /*post the singer to the task for processing the connection*/ ets_post(espconn_TaskPrio, SIG_ESPCONN_ERRER, (uint32_t)pserr_cb); } } /****************************************************************************** * FunctionName : espconn_tcp_accept * Description : A new incoming connection has been accepted. * Parameters : arg -- Additional argument to pass to the callback function * pcb -- The connection pcb which is accepted * err -- An unused error code, always ERR_OK currently * Returns : acception result *******************************************************************************/ static err_t ICACHE_FLASH_ATTR espconn_tcp_accept(void *arg, struct tcp_pcb *pcb, err_t err) { struct espconn *espconn = arg; espconn_msg *paccept = NULL; remot_info *pinfo = NULL; LWIP_UNUSED_ARG(err); if (!espconn || !espconn->proto.tcp) { return ERR_ARG; } tcp_arg(pcb, paccept); tcp_err(pcb, esponn_server_err); /*Ensure the active connection is less than the count of active connections on the server*/ espconn_get_connection_info(espconn, &pinfo , 0); espconn_printf("espconn_tcp_accept link_cnt: %d\n", espconn->link_cnt); if (espconn->link_cnt == espconn_tcp_get_max_con_allow(espconn)) return ERR_ISCONN; /*Creates a new active connect control message*/ paccept = (espconn_msg *)os_zalloc(sizeof(espconn_msg)); tcp_arg(pcb, paccept); if (paccept == NULL) return ERR_MEM; /*Insert the node to the active connection list*/ espconn_list_creat(&plink_active, paccept); paccept->preverse = espconn; paccept->pespconn = (struct espconn *)os_zalloc(sizeof(struct espconn)); if (paccept->pespconn == NULL) return ERR_MEM; paccept->pespconn->proto.tcp = (esp_tcp *)os_zalloc(sizeof(esp_tcp)); if (paccept->pespconn->proto.tcp == NULL) return ERR_MEM; /*Reserve the remote information for current active connection*/ paccept->pcommon.pcb = pcb; paccept->pcommon.remote_port = pcb->remote_port; paccept->pcommon.remote_ip[0] = ip4_addr1_16(&pcb->remote_ip); paccept->pcommon.remote_ip[1] = ip4_addr2_16(&pcb->remote_ip); paccept->pcommon.remote_ip[2] = ip4_addr3_16(&pcb->remote_ip); paccept->pcommon.remote_ip[3] = ip4_addr4_16(&pcb->remote_ip); paccept->pcommon.write_flag = true; os_memcpy(espconn->proto.tcp->remote_ip, paccept->pcommon.remote_ip, 4); espconn->proto.tcp->remote_port = pcb->remote_port; espconn->state = ESPCONN_CONNECT; espconn_copy_partial(paccept->pespconn, espconn); /*Set the specify function that should be called * when TCP data has been successfully delivered, * when active connection receives data, * or periodically from active connection*/ tcp_sent(pcb, espconn_server_sent); tcp_recv(pcb, espconn_server_recv); tcp_poll(pcb, espconn_server_poll, 8); /* every 1 seconds */ /*Disable Nagle algorithm default*/ tcp_nagle_disable(pcb); /*Default set the total number of espconn_buf on the unsent lists for one*/ espconn_tcp_set_buf_count(paccept->pespconn, 1); if (paccept->pespconn->proto.tcp->connect_callback != NULL) { paccept->pespconn->proto.tcp->connect_callback(paccept->pespconn); } /*Enable keep alive option*/ if (espconn_keepalive_disabled(paccept)) espconn_keepalive_enable(pcb); return ERR_OK; } /****************************************************************************** * FunctionName : espconn_tcp_server * Description : Initialize the server: set up a listening PCB and bind it to * the defined port * Parameters : espconn -- the espconn used to build server * Returns : none *******************************************************************************/ sint8 ICACHE_FLASH_ATTR espconn_tcp_server(struct espconn *espconn) { struct tcp_pcb *pcb = NULL; espconn_msg *pserver = NULL; /*Creates a new server control message*/ pserver = (espconn_msg *)os_zalloc(sizeof(espconn_msg)); if (pserver == NULL){ return ESPCONN_MEM; } /*Creates a new TCP protocol control block*/ pcb = tcp_new(); if (pcb == NULL) { /*to prevent memory leaks, ensure that each allocated is deleted*/ os_free(pserver); pserver = NULL; return ESPCONN_MEM; } else { struct tcp_pcb *lpcb = NULL; /*Binds the connection to a local port number and any IP address*/ tcp_bind(pcb, IP_ADDR_ANY, espconn->proto.tcp->local_port); lpcb = pcb; /*malloc and set the state of the connection to be LISTEN*/ pcb = tcp_listen(pcb); if (pcb != NULL) { /*insert the node to the active connection list*/ espconn_list_creat(&pserver_list, pserver); pserver->preverse = pcb; pserver->pespconn = espconn; pserver->count_opt = MEMP_NUM_TCP_PCB; pserver->pcommon.timeout = 0x0a; espconn ->state = ESPCONN_LISTEN; /*set the specify argument that should be passed callback function*/ tcp_arg(pcb, (void *)espconn); /*accept callback function to call for this control block*/ tcp_accept(pcb, espconn_tcp_accept); return ESPCONN_OK; } else { /*to prevent memory leaks, ensure that each allocated is deleted*/ memp_free(MEMP_TCP_PCB,lpcb); os_free(pserver); pserver = NULL; return ESPCONN_MEM; } } } /****************************************************************************** * FunctionName : espconn_tcp_delete * Description : delete the server: delete a listening PCB and free it * Parameters : pdeletecon -- the espconn used to delete a server * Returns : none *******************************************************************************/ sint8 ICACHE_FLASH_ATTR espconn_tcp_delete(struct espconn *pdeletecon) { err_t err; remot_info *pinfo = NULL; espconn_msg *pdelete_msg = NULL; struct tcp_pcb *pcb = NULL; if (pdeletecon == NULL) return ESPCONN_ARG; espconn_get_connection_info(pdeletecon, &pinfo , 0); /*make sure all the active connection have been disconnect*/ if (pdeletecon->link_cnt != 0) return ESPCONN_INPROGRESS; else { espconn_printf("espconn_tcp_delete %p\n",pdeletecon); pdelete_msg = pserver_list; while (pdelete_msg != NULL){ if (pdelete_msg->pespconn == pdeletecon){ /*remove the node from the client's active connection list*/ espconn_list_delete(&pserver_list, pdelete_msg); pcb = pdelete_msg->preverse; os_printf("espconn_tcp_delete %d, %d\n",pcb->state, pcb->local_port); espconn_kill_pcb(pcb->local_port); err = tcp_close(pcb); os_free(pdelete_msg); pdelete_msg = NULL; break; } pdelete_msg = pdelete_msg->pnext; } if (err == ERR_OK) return err; else return ESPCONN_ARG; } } /****************************************************************************** * FunctionName : espconn_init * Description : used to init the function that should be used when * Parameters : none * Returns : none *******************************************************************************/ void ICACHE_FLASH_ATTR espconn_init(void) { ets_task(espconn_Task, espconn_TaskPrio, espconn_TaskQueue, espconn_TaskQueueLen); } ================================================ FILE: app/lwip/app/espconn_udp.c ================================================ /****************************************************************************** * Copyright 2013-2014 Espressif Systems (Wuxi) * * FileName: espconn_udp.c * * Description: udp proto interface * * Modification history: * 2014/3/31, v1.0 create this file. *******************************************************************************/ #include "ets_sys.h" #include "os_type.h" //#include "os.h" #include "lwip/inet.h" #include "lwip/err.h" #include "lwip/pbuf.h" #include "lwip/mem.h" #include "lwip/tcp_impl.h" #include "lwip/udp.h" #include "lwip/app/espconn_udp.h" #ifdef MEMLEAK_DEBUG static const char mem_debug_file[] ICACHE_RODATA_ATTR = __FILE__; #endif extern espconn_msg *plink_active; extern uint8 default_interface; enum send_opt{ ESPCONN_SENDTO, ESPCONN_SEND }; static void ICACHE_FLASH_ATTR espconn_data_sentcb(struct espconn *pespconn) { if (pespconn == NULL) { return; } if (pespconn->sent_callback != NULL) { pespconn->sent_callback(pespconn); } } static void ICACHE_FLASH_ATTR espconn_data_sent(void *arg, enum send_opt opt) { espconn_msg *psent = arg; if (psent == NULL) { return; } if (psent->pcommon.cntr == 0) { psent->pespconn->state = ESPCONN_CONNECT; // sys_timeout(10, espconn_data_sentcb, psent->pespconn); espconn_data_sentcb(psent->pespconn); } else { if (opt == ESPCONN_SEND){ espconn_udp_sent(arg, psent->pcommon.ptrbuf, psent->pcommon.cntr); } else { espconn_udp_sendto(arg, psent->pcommon.ptrbuf, psent->pcommon.cntr); } } } /****************************************************************************** * FunctionName : espconn_udp_sent * Description : sent data for client or server * Parameters : void *arg -- client or server to send * uint8* psent -- Data to send * uint16 length -- Length of data to send * Returns : return espconn error code. * - ESPCONN_OK. Successful. No error occured. * - ESPCONN_MEM. Out of memory. * - ESPCONN_RTE. Could not find route to destination address. * - More errors could be returned by lower protocol layers. *******************************************************************************/ err_t ICACHE_FLASH_ATTR espconn_udp_sent(void *arg, uint8 *psent, uint16 length) { espconn_msg *pudp_sent = arg; struct udp_pcb *upcb = pudp_sent->pcommon.pcb; struct pbuf *p, *q ,*p_temp; u8_t *data = NULL; u16_t cnt = 0; u16_t datalen = 0; u16_t i = 0; err_t err; LWIP_DEBUGF(ESPCONN_UDP_DEBUG, ("espconn_udp_sent %d %d %p\n", __LINE__, length, upcb)); if (pudp_sent == NULL || upcb == NULL || psent == NULL || length == 0) { return ESPCONN_ARG; } if (1470 < length) { datalen = 1470; } else { datalen = length; } p = pbuf_alloc(PBUF_TRANSPORT, datalen, PBUF_RAM); LWIP_DEBUGF(ESPCONN_UDP_DEBUG, ("espconn_udp_sent %d %p\n", __LINE__, p)); if (p != NULL) { q = p; while (q != NULL) { data = (u8_t *)q->payload; LWIP_DEBUGF(ESPCONN_UDP_DEBUG, ("espconn_udp_sent %d %p\n", __LINE__, data)); for (i = 0; i < q->len; i++) { data[i] = ((u8_t *) psent)[cnt++]; } q = q->next; } } else { return ESPCONN_MEM; } upcb->remote_port = pudp_sent->pespconn->proto.udp->remote_port; IP4_ADDR(&upcb->remote_ip, pudp_sent->pespconn->proto.udp->remote_ip[0], pudp_sent->pespconn->proto.udp->remote_ip[1], pudp_sent->pespconn->proto.udp->remote_ip[2], pudp_sent->pespconn->proto.udp->remote_ip[3]); LWIP_DEBUGF(ESPCONN_UDP_DEBUG, ("espconn_udp_sent %d %x %d\n", __LINE__, upcb->remote_ip, upcb->remote_port)); struct netif *sta_netif = (struct netif *)eagle_lwip_getif(0x00); struct netif *ap_netif = (struct netif *)eagle_lwip_getif(0x01); if(wifi_get_opmode() == ESPCONN_AP_STA && default_interface == ESPCONN_AP_STA && sta_netif != NULL && ap_netif != NULL) { if(netif_is_up(sta_netif) && netif_is_up(ap_netif) && \ ip_addr_isbroadcast(&upcb->remote_ip, sta_netif) && \ ip_addr_isbroadcast(&upcb->remote_ip, ap_netif)) { p_temp = pbuf_alloc(PBUF_TRANSPORT, datalen, PBUF_RAM); if (pbuf_copy (p_temp,p) != ERR_OK) { LWIP_DEBUGF(ESPCONN_UDP_DEBUG, ("espconn_udp_sent: copying to new pbuf failed\n")); return ESPCONN_ARG; } netif_set_default(sta_netif); err = udp_send(upcb, p_temp); pbuf_free(p_temp); netif_set_default(ap_netif); } } err = udp_send(upcb, p); LWIP_DEBUGF(ESPCONN_UDP_DEBUG, ("espconn_udp_sent %d %d\n", __LINE__, err)); if (p->ref != 0) { LWIP_DEBUGF(ESPCONN_UDP_DEBUG, ("espconn_udp_sent %d %p\n", __LINE__, p)); pbuf_free(p); pudp_sent->pcommon.ptrbuf = psent + datalen; pudp_sent->pcommon.cntr = length - datalen; espconn_data_sent(pudp_sent, ESPCONN_SEND); if (err > 0) return ESPCONN_IF; return err; } else { pbuf_free(p); return ESPCONN_RTE; } } /****************************************************************************** * FunctionName : espconn_udp_sendto * Description : sent data for UDP * Parameters : void *arg -- UDP to send * uint8* psent -- Data to send * uint16 length -- Length of data to send * Returns : return espconn error code. * - ESPCONN_OK. Successful. No error occured. * - ESPCONN_MEM. Out of memory. * - ESPCONN_RTE. Could not find route to destination address. * - More errors could be returned by lower protocol layers. *******************************************************************************/ err_t ICACHE_FLASH_ATTR espconn_udp_sendto(void *arg, uint8 *psent, uint16 length) { espconn_msg *pudp_sent = arg; struct udp_pcb *upcb = pudp_sent->pcommon.pcb; struct espconn *pespconn = pudp_sent->pespconn; struct pbuf *p, *q ,*p_temp; struct ip_addr dst_ip; u16_t dst_port; u8_t *data = NULL; u16_t cnt = 0; u16_t datalen = 0; u16_t i = 0; err_t err; LWIP_DEBUGF(ESPCONN_UDP_DEBUG, ("espconn_udp_sent %d %d %p\n", __LINE__, length, upcb)); if (pudp_sent == NULL || upcb == NULL || psent == NULL || length == 0) { return ESPCONN_ARG; } if (1470 < length) { datalen = 1470; } else { datalen = length; } p = pbuf_alloc(PBUF_TRANSPORT, datalen, PBUF_RAM); LWIP_DEBUGF(ESPCONN_UDP_DEBUG, ("espconn_udp_sent %d %p\n", __LINE__, p)); if (p != NULL) { q = p; while (q != NULL) { data = (u8_t *)q->payload; LWIP_DEBUGF(ESPCONN_UDP_DEBUG, ("espconn_udp_sent %d %p\n", __LINE__, data)); for (i = 0; i < q->len; i++) { data[i] = ((u8_t *) psent)[cnt++]; } q = q->next; } } else { return ESPCONN_MEM; } dst_port = pespconn->proto.udp->remote_port; IP4_ADDR(&dst_ip, pespconn->proto.udp->remote_ip[0], pespconn->proto.udp->remote_ip[1], pespconn->proto.udp->remote_ip[2], pespconn->proto.udp->remote_ip[3]); LWIP_DEBUGF(ESPCONN_UDP_DEBUG, ("espconn_udp_sent %d %x %d\n", __LINE__, upcb->remote_ip, upcb->remote_port)); struct netif *sta_netif = (struct netif *)eagle_lwip_getif(0x00); struct netif *ap_netif = (struct netif *)eagle_lwip_getif(0x01); if(wifi_get_opmode() == ESPCONN_AP_STA && default_interface == ESPCONN_AP_STA && sta_netif != NULL && ap_netif != NULL) { if(netif_is_up(sta_netif) && netif_is_up(ap_netif) && \ ip_addr_isbroadcast(&upcb->remote_ip, sta_netif) && \ ip_addr_isbroadcast(&upcb->remote_ip, ap_netif)) { p_temp = pbuf_alloc(PBUF_TRANSPORT, datalen, PBUF_RAM); if (pbuf_copy (p_temp,p) != ERR_OK) { LWIP_DEBUGF(ESPCONN_UDP_DEBUG, ("espconn_udp_sendto: copying to new pbuf failed\n")); return ESPCONN_ARG; } netif_set_default(sta_netif); err = udp_sendto(upcb, p_temp, &dst_ip, dst_port); pbuf_free(p_temp); netif_set_default(ap_netif); } } err = udp_sendto(upcb, p, &dst_ip, dst_port); if (p->ref != 0) { pbuf_free(p); pudp_sent->pcommon.ptrbuf = psent + datalen; pudp_sent->pcommon.cntr = length - datalen; if (err == ERR_OK) espconn_data_sent(pudp_sent, ESPCONN_SENDTO); if (err > 0) return ESPCONN_IF; return err; } else { pbuf_free(p); return ESPCONN_RTE; } } /****************************************************************************** * FunctionName : espconn_udp_server_recv * Description : This callback will be called when receiving a datagram. * Parameters : arg -- user supplied argument * upcb -- the udp_pcb which received data * p -- the packet buffer that was received * addr -- the remote IP address from which the packet was received * port -- the remote port from which the packet was received * Returns : none *******************************************************************************/ static void ICACHE_FLASH_ATTR espconn_udp_recv(void *arg, struct udp_pcb *upcb, struct pbuf *p, struct ip_addr *addr, u16_t port) { espconn_msg *precv = arg; struct pbuf *q = NULL; u8_t *pdata = NULL; u16_t length = 0; struct ip_info ipconfig; LWIP_DEBUGF(ESPCONN_UDP_DEBUG, ("espconn_udp_server_recv %d %p\n", __LINE__, upcb)); precv->pcommon.remote_ip[0] = ip4_addr1_16(addr); precv->pcommon.remote_ip[1] = ip4_addr2_16(addr); precv->pcommon.remote_ip[2] = ip4_addr3_16(addr); precv->pcommon.remote_ip[3] = ip4_addr4_16(addr); precv->pcommon.remote_port = port; precv->pcommon.pcb = upcb; if (wifi_get_opmode() != 1) { wifi_get_ip_info(1, &ipconfig); if (!ip_addr_netcmp((struct ip_addr *)precv->pespconn->proto.udp->remote_ip, &ipconfig.ip, &ipconfig.netmask)) { wifi_get_ip_info(0, &ipconfig); } } else { wifi_get_ip_info(0, &ipconfig); } precv->pespconn->proto.udp->local_ip[0] = ip4_addr1_16(&ipconfig.ip); precv->pespconn->proto.udp->local_ip[1] = ip4_addr2_16(&ipconfig.ip); precv->pespconn->proto.udp->local_ip[2] = ip4_addr3_16(&ipconfig.ip); precv->pespconn->proto.udp->local_ip[3] = ip4_addr4_16(&ipconfig.ip); precv->pespconn->proto.udp->remote_ip[0] = precv->pcommon.remote_ip[0]; precv->pespconn->proto.udp->remote_ip[1] = precv->pcommon.remote_ip[1]; precv->pespconn->proto.udp->remote_ip[2] = precv->pcommon.remote_ip[2]; precv->pespconn->proto.udp->remote_ip[3] = precv->pcommon.remote_ip[3]; precv->pespconn->proto.udp->remote_port = port; if (p != NULL) { pdata = (u8_t *)os_zalloc(p ->tot_len + 1); length = pbuf_copy_partial(p, pdata, p ->tot_len, 0); precv->pcommon.pcb = upcb; pbuf_free(p); if (length != 0) { if (precv->pespconn->recv_callback != NULL) { precv->pespconn->recv_callback(precv->pespconn, pdata, length); } } os_free(pdata); } else { return; } } /****************************************************************************** * FunctionName : espconn_udp_disconnect * Description : A new incoming connection has been disconnected. * Parameters : espconn -- the espconn used to disconnect with host * Returns : none *******************************************************************************/ void ICACHE_FLASH_ATTR espconn_udp_disconnect(espconn_msg *pdiscon) { if (pdiscon == NULL) { return; } struct udp_pcb *upcb = pdiscon->pcommon.pcb; udp_disconnect(upcb); udp_remove(upcb); espconn_list_delete(&plink_active, pdiscon); os_free(pdiscon); pdiscon = NULL; } /****************************************************************************** * FunctionName : espconn_udp_server * Description : Initialize the server: set up a PCB and bind it to the port * Parameters : pespconn -- the espconn used to build server * Returns : none *******************************************************************************/ sint8 ICACHE_FLASH_ATTR espconn_udp_server(struct espconn *pespconn) { struct udp_pcb *upcb = NULL; espconn_msg *pserver = NULL; upcb = udp_new(); if (upcb == NULL) { return ESPCONN_MEM; } else { pserver = (espconn_msg *)os_zalloc(sizeof(espconn_msg)); if (pserver == NULL) { udp_remove(upcb); return ESPCONN_MEM; } pserver->pcommon.pcb = upcb; pserver->pespconn = pespconn; espconn_list_creat(&plink_active, pserver); udp_bind(upcb, IP_ADDR_ANY, pserver->pespconn->proto.udp->local_port); udp_recv(upcb, espconn_udp_recv, (void *)pserver); return ESPCONN_OK; } } /****************************************************************************** * FunctionName : espconn_igmp_leave * Description : leave a multicast group * Parameters : host_ip -- the ip address of udp server * multicast_ip -- multicast ip given by user * Returns : none *******************************************************************************/ sint8 ICACHE_FLASH_ATTR espconn_igmp_leave(ip_addr_t *host_ip, ip_addr_t *multicast_ip) { if (igmp_leavegroup(host_ip, multicast_ip) != ERR_OK) { LWIP_DEBUGF(ESPCONN_UDP_DEBUG, ("udp_leave_multigrup failed!\n")); return -1; }; return ESPCONN_OK; } /****************************************************************************** * FunctionName : espconn_igmp_join * Description : join a multicast group * Parameters : host_ip -- the ip address of udp server * multicast_ip -- multicast ip given by user * Returns : none *******************************************************************************/ sint8 ICACHE_FLASH_ATTR espconn_igmp_join(ip_addr_t *host_ip, ip_addr_t *multicast_ip) { if (igmp_joingroup(host_ip, multicast_ip) != ERR_OK) { LWIP_DEBUGF(ESPCONN_UDP_DEBUG, ("udp_join_multigrup failed!\n")); return -1; }; /* join to any IP address at the port */ return ESPCONN_OK; } ================================================ FILE: app/lwip/app/netio.c ================================================ /** * @file * MetIO Server * */ /* * 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_TCP #include "lwip/tcp.h" #ifdef MEMLEAK_DEBUG static const char mem_debug_file[] ICACHE_RODATA_ATTR = __FILE__; #endif /* * This implements a netio server. * The client sends a command word (4 bytes) then a data length word (4 bytes). * If the command is "receive", the server is to consume "data length" bytes into * a circular buffer until the first byte is non-zero, then it is to consume * another command/data pair. * If the command is "send", the server is to send "data length" bytes from a circular * buffer with the first byte being zero, until "some time" (6 seconds in the * current netio126.zip download) has passed and then send one final buffer with * the first byte being non-zero. Then it is to consume another command/data pair. */ /* See http://www.nwlab.net/art/netio/netio.html to get the netio tool */ /* implementation options */ #define NETIO_BUF_SIZE (4 * 1024) #define NETIO_USE_STATIC_BUF 0 /* NetIO server state definition */ #define NETIO_STATE_WAIT_FOR_CMD 0 #define NETIO_STATE_RECV_DATA 1 #define NETIO_STATE_SEND_DATA 2 #define NETIO_STATE_SEND_DATA_LAST 3 #define NETIO_STATE_DONE 4 struct netio_state { u32_t state; u32_t cmd; u32_t data_len; u32_t cntr; u8_t * buf_ptr; u32_t buf_pos; u32_t first_byte; u32_t time_stamp; }; /* NetIO command protocol definition */ #define NETIO_CMD_QUIT 0 #define NETIO_CMD_C2S 1 #define NETIO_CMD_S2C 2 #define NETIO_CMD_RES 3 static err_t netio_recv(void *arg, struct tcp_pcb *pcb, struct pbuf *p, err_t err); static void ICACHE_FLASH_ATTR netio_close(void *arg, struct tcp_pcb *pcb) { err_t err; struct netio_state *ns = arg; ns->state = NETIO_STATE_DONE; tcp_recv(pcb, NULL); err = tcp_close(pcb); if (err != ERR_OK) { /* closing failed, try again later */ tcp_recv(pcb, netio_recv); } else { /* closing succeeded */ #if NETIO_USE_STATIC_BUF != 1 if(ns->buf_ptr != NULL){ mem_free(ns->buf_ptr); } #endif tcp_arg(pcb, NULL); tcp_poll(pcb, NULL, 0); tcp_sent(pcb, NULL); if (arg != NULL) { mem_free(arg); } } } static err_t ICACHE_FLASH_ATTR netio_recv(void *arg, struct tcp_pcb *pcb, struct pbuf *p, err_t err) { struct netio_state *ns = arg; u8_t * data_ptr; u32_t data_cntr; struct pbuf *q = p; u16_t len; if (p != NULL) { tcp_recved(pcb, p->tot_len); } if (err == ERR_OK && q != NULL) { while (q != NULL) { data_cntr = q->len; data_ptr = q->payload; while (data_cntr--) { if (ns->state == NETIO_STATE_DONE){ netio_close(ns, pcb); break; } else if (ns->state == NETIO_STATE_WAIT_FOR_CMD) { if (ns->cntr < 4) { /* build up the CMD field */ ns->cmd <<= 8; ns->cmd |= *data_ptr++; ns->cntr++; } else if (ns->cntr < 8) { /* build up the DATA field */ ns->data_len <<= 8; ns->data_len |= *data_ptr++; ns->cntr++; if (ns->cntr == 8) { /* now we have full command and data words */ ns->cntr = 0; ns->buf_pos = 0; ns->buf_ptr[0] = 0; if (ns->cmd == NETIO_CMD_C2S) { ns->state = NETIO_STATE_RECV_DATA; } else if (ns->cmd == NETIO_CMD_S2C) { ns->state = NETIO_STATE_SEND_DATA; /* start timer */ ns->time_stamp = sys_now(); /* send first round of data */ len = tcp_sndbuf(pcb); len = LWIP_MIN(len, ns->data_len - ns->cntr); len = LWIP_MIN(len, NETIO_BUF_SIZE - ns->buf_pos); do { err = tcp_write(pcb, ns->buf_ptr + ns->buf_pos, len, TCP_WRITE_FLAG_COPY); if (err == ERR_MEM) { len /= 2; } } while ((err == ERR_MEM) && (len > 1)); ns->buf_pos += len; ns->cntr += len; } else { /* unrecognized command, punt */ ns->cntr = 0; ns->buf_pos = 0; ns->buf_ptr[0] = 0; netio_close(ns, pcb); break; } } } else { /* in trouble... shouldn't be in this state! */ } } else if (ns->state == NETIO_STATE_RECV_DATA) { if(ns->cntr == 0){ /* save the first byte of this new round of data * this will not match ns->buf_ptr[0] in the case that * NETIO_BUF_SIZE is less than ns->data_len. */ ns->first_byte = *data_ptr; } ns->buf_ptr[ns->buf_pos++] = *data_ptr++; ns->cntr++; if (ns->buf_pos == NETIO_BUF_SIZE) { /* circularize the buffer */ ns->buf_pos = 0; } if(ns->cntr == ns->data_len){ ns->cntr = 0; if (ns->first_byte != 0) { /* if this last round did not start with 0, * go look for another command */ ns->state = NETIO_STATE_WAIT_FOR_CMD; ns->data_len = 0; ns->cmd = 0; /* TODO LWIP_DEBUGF( print out some throughput calculation results... ); */ } else { /* stay here and wait on more data */ } } } else if (ns->state == NETIO_STATE_SEND_DATA || ns->state == NETIO_STATE_SEND_DATA_LAST) { /* I don't think this should happen... */ } else { /* done / quit */ netio_close(ns, pcb); break; } /* end of ns->state condition */ } /* end of while data still in this pbuf */ q = q->next; } pbuf_free(p); } else { /* error or closed by other side */ if (p != NULL) { pbuf_free(p); } /* close the connection */ netio_close(ns, pcb); } return ERR_OK; } static err_t ICACHE_FLASH_ATTR netio_sent(void *arg, struct tcp_pcb *pcb, u16_t len) { struct netio_state *ns = arg; err_t err = ERR_OK; if (ns->cntr >= ns->data_len && ns->state == NETIO_STATE_SEND_DATA) { /* done with this round of sending */ ns->buf_pos = 0; ns->cntr = 0; /* check if timer expired */ if (sys_now() - ns->time_stamp > 600) { ns->buf_ptr[0] = 1; ns->state = NETIO_STATE_SEND_DATA_LAST; } else { ns->buf_ptr[0] = 0; } } if(ns->state == NETIO_STATE_SEND_DATA_LAST || ns->state == NETIO_STATE_SEND_DATA){ len = tcp_sndbuf(pcb); len = LWIP_MIN(len, ns->data_len - ns->cntr); len = LWIP_MIN(len, NETIO_BUF_SIZE - ns->buf_pos); if(ns->cntr < ns->data_len){ do { err = tcp_write(pcb, ns->buf_ptr + ns->buf_pos, len, TCP_WRITE_FLAG_COPY); if (err == ERR_MEM) { len /= 2; } } while ((err == ERR_MEM) && (len > 1)); ns->buf_pos += len; if(ns->buf_pos >= NETIO_BUF_SIZE){ ns->buf_pos = 0; } ns->cntr += len; } } if(ns->cntr >= ns->data_len && ns->state == NETIO_STATE_SEND_DATA_LAST){ /* we have buffered up all our data to send this last round, go look for a command */ ns->state = NETIO_STATE_WAIT_FOR_CMD; ns->cntr = 0; /* TODO LWIP_DEBUGF( print out some throughput calculation results... ); */ } return ERR_OK; } static err_t ICACHE_FLASH_ATTR netio_poll(void *arg, struct tcp_pcb *pcb) { struct netio_state * ns = arg; if(ns->state == NETIO_STATE_SEND_DATA){ } else if(ns->state == NETIO_STATE_DONE){ netio_close(ns, pcb); } return ERR_OK; } #if NETIO_USE_STATIC_BUF == 1 static u8_t netio_buf[NETIO_BUF_SIZE]; #endif static err_t ICACHE_FLASH_ATTR netio_accept(void *arg, struct tcp_pcb *pcb, err_t err) { struct netio_state * ns; LWIP_UNUSED_ARG(err); ns = (struct netio_state *)mem_malloc(sizeof(struct netio_state)); if(ns == NULL){ return ERR_MEM; } ns->state = NETIO_STATE_WAIT_FOR_CMD; ns->data_len = 0; ns->cmd = 0; ns->cntr = 0; ns->buf_pos = 0; #if NETIO_USE_STATIC_BUF == 1 ns->buf_ptr = netio_buf; #else ns->buf_ptr = (u8_t *)mem_malloc(NETIO_BUF_SIZE); if(ns->buf_ptr == NULL){ mem_free(ns); return ERR_MEM; } #endif ns->buf_ptr[0] = 0; tcp_arg(pcb, ns); tcp_sent(pcb, netio_sent); tcp_recv(pcb, netio_recv); tcp_poll(pcb, netio_poll, 4); /* every 2 seconds */ return ERR_OK; } void ICACHE_FLASH_ATTR netio_init(void) { struct tcp_pcb *pcb; pcb = tcp_new(); tcp_bind(pcb, IP_ADDR_ANY, 18767); pcb = tcp_listen(pcb); tcp_accept(pcb, netio_accept); } #endif /* LWIP_TCP */ ================================================ FILE: app/lwip/app/ping.c ================================================ /** * @file * Ping sender 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. * */ /** * This is an example of a "ping" sender (with raw API and socket API). * It can be used as a start point to maintain opened a network connection, or * like a network "watchdog" for your device. * */ /* * copyright (c) 2010 - 2011 Espressif System */ #include "lwip/opt.h" #if LWIP_RAW /* don't build if not configured for use in lwipopts.h */ #include "lwip/mem.h" #include "lwip/raw.h" #include "lwip/icmp.h" #include "lwip/netif.h" #include "lwip/sys.h" #include "lwip/timers.h" #include "lwip/inet_chksum.h" #include "os_type.h" #include "osapi.h" #include "lwip/app/ping.h" #if PING_USE_SOCKETS #include "lwip/sockets.h" #include "lwip/inet.h" #endif /* PING_USE_SOCKETS */ #ifdef MEMLEAK_DEBUG static const char mem_debug_file[] ICACHE_RODATA_ATTR = __FILE__; #endif /* ping variables */ static u16_t ping_seq_num = 0; static u32_t ping_time; static void ICACHE_FLASH_ATTR ping_timeout(void* arg) { struct ping_msg *pingmsg = (struct ping_msg *)arg; pingmsg->timeout_count ++; if (pingmsg->ping_opt->recv_function == NULL){ os_printf("ping timeout\n"); } else { struct ping_resp pingresp; os_bzero(&pingresp, sizeof(struct ping_resp)); pingresp.ping_err = -1; pingmsg->ping_opt->recv_function(pingmsg->ping_opt, (void*)&pingresp); } } /** Prepare a echo ICMP request */ static void ICACHE_FLASH_ATTR ping_prepare_echo( struct icmp_echo_hdr *iecho, u16_t len) { size_t i = 0; size_t data_len = len - sizeof(struct icmp_echo_hdr); ICMPH_TYPE_SET(iecho, ICMP_ECHO); ICMPH_CODE_SET(iecho, 0); iecho->chksum = 0; iecho->id = PING_ID; ++ ping_seq_num; if (ping_seq_num == 0x7fff) ping_seq_num = 0; iecho->seqno = htons(ping_seq_num); /* fill the additional data buffer with some data */ for(i = 0; i < data_len; i++) { ((char*)iecho)[sizeof(struct icmp_echo_hdr) + i] = (char)i; } iecho->chksum = inet_chksum(iecho, len); } static void ICACHE_FLASH_ATTR ping_prepare_er(struct icmp_echo_hdr *iecho, u16_t len) { ICMPH_TYPE_SET(iecho, ICMP_ER); ICMPH_CODE_SET(iecho, 0); iecho->chksum = 0; iecho->chksum = inet_chksum(iecho, len); } /* Ping using the raw ip */ static u8_t ICACHE_FLASH_ATTR ping_recv(void *arg, struct raw_pcb *pcb, struct pbuf *p, ip_addr_t *addr) { struct icmp_echo_hdr *iecho = NULL; static u16_t seqno = 0; struct ping_msg *pingmsg = (struct ping_msg*)arg; LWIP_UNUSED_ARG(arg); LWIP_UNUSED_ARG(pcb); LWIP_UNUSED_ARG(addr); LWIP_ASSERT("p != NULL", p != NULL); if (pbuf_header( p, -PBUF_IP_HLEN)==0) { iecho = (struct icmp_echo_hdr *)p->payload; if ((iecho->id == PING_ID) && (iecho->seqno == htons(ping_seq_num)) && iecho->type == ICMP_ER) { LWIP_DEBUGF( PING_DEBUG, ("ping: recv ")); ip_addr_debug_print(PING_DEBUG, addr); LWIP_DEBUGF( PING_DEBUG, (" %"U32_F" ms\n", (sys_now()-ping_time))); if (iecho->seqno != seqno){ /* do some ping result processing */ { struct ip_hdr *iphdr = NULL; char ipaddrstr[16]; ip_addr_t source_ip; sys_untimeout(ping_timeout, pingmsg); os_bzero(&source_ip, sizeof(ip_addr_t)); os_bzero(ipaddrstr, sizeof(ipaddrstr)); uint32 delay = system_relative_time(pingmsg->ping_sent); delay /= PING_COARSE; iphdr = (struct ip_hdr*)((u8*)iecho - PBUF_IP_HLEN); source_ip.addr = iphdr->src.addr; ipaddr_ntoa_r(&source_ip,ipaddrstr, sizeof(ipaddrstr)); if (pingmsg->ping_opt->recv_function == NULL){ os_printf("recv %s: byte = %d, time = %d ms, seq = %d\n",ipaddrstr, PING_DATA_SIZE, delay, ntohs(iecho->seqno)); } else { struct ping_resp pingresp; os_bzero(&pingresp, sizeof(struct ping_resp)); pingresp.bytes = PING_DATA_SIZE; pingresp.resp_time = delay; pingresp.seqno = ntohs(iecho->seqno); pingresp.ping_err = 0; pingmsg->ping_opt->recv_function(pingmsg->ping_opt,(void*) &pingresp); } } seqno = iecho->seqno; } PING_RESULT(1); pbuf_free(p); return 1; /* eat the packet */ } // } else if(iecho->type == ICMP_ECHO){ // struct pbuf *q = NULL; // os_printf("receive ping request:seq=%d\n", ntohs(iecho->seqno)); // q = pbuf_alloc(PBUF_IP, (u16_t)p->tot_len, PBUF_RAM); // if (q!=NULL) { // pbuf_copy(q, p); // iecho = (struct icmp_echo_hdr *)q->payload; // ping_prepare_er(iecho, q->tot_len); // raw_sendto(pcb, q, addr); // pbuf_free(q); // } // pbuf_free(p); // return 1; // } } return 0; /* don't eat the packet */ } static void ICACHE_FLASH_ATTR ping_send(struct raw_pcb *raw, ip_addr_t *addr) { struct pbuf *p = NULL; struct icmp_echo_hdr *iecho = NULL; size_t ping_size = sizeof(struct icmp_echo_hdr) + PING_DATA_SIZE; LWIP_DEBUGF( PING_DEBUG, ("ping: send ")); ip_addr_debug_print(PING_DEBUG, addr); LWIP_DEBUGF( PING_DEBUG, ("\n")); LWIP_ASSERT("ping_size <= 0xffff", ping_size <= 0xffff); p = pbuf_alloc(PBUF_IP, (u16_t)ping_size, PBUF_RAM); if (!p) { return; } if ((p->len == p->tot_len) && (p->next == NULL)) { iecho = (struct icmp_echo_hdr *)p->payload; ping_prepare_echo(iecho, (u16_t)ping_size); raw_sendto(raw, p, addr); ping_time = sys_now(); } pbuf_free(p); } static void ICACHE_FLASH_ATTR ping_coarse_tmr(void *arg) { struct ping_msg *pingmsg = (struct ping_msg*)arg; struct ping_option *ping_opt= NULL; struct ping_resp pingresp; ip_addr_t ping_target; LWIP_ASSERT("ping_timeout: no pcb given!", pingmsg != NULL); ping_target.addr = pingmsg->ping_opt->ip; ping_opt = pingmsg->ping_opt; if (--pingmsg->sent_count != 0){ pingmsg ->ping_sent = system_get_time(); ping_send(pingmsg->ping_pcb, &ping_target); sys_timeout(PING_TIMEOUT_MS, ping_timeout, pingmsg); sys_timeout(pingmsg->coarse_time, ping_coarse_tmr, pingmsg); } else { uint32 delay = system_relative_time(pingmsg->ping_start); delay /= PING_COARSE; // ping_seq_num = 0; if (ping_opt->sent_function == NULL){ os_printf("ping %d, timeout %d, total payload %d bytes, %d ms\n", pingmsg->max_count, pingmsg->timeout_count, PING_DATA_SIZE*(pingmsg->max_count - pingmsg->timeout_count),delay); } else { os_bzero(&pingresp, sizeof(struct ping_resp)); pingresp.total_count = pingmsg->max_count; pingresp.timeout_count = pingmsg->timeout_count; pingresp.total_bytes = PING_DATA_SIZE*(pingmsg->max_count - pingmsg->timeout_count); pingresp.total_time = delay; pingresp.ping_err = 0; } sys_untimeout(ping_coarse_tmr, pingmsg); raw_remove(pingmsg->ping_pcb); os_free(pingmsg); if (ping_opt->sent_function != NULL) ping_opt->sent_function(ping_opt,(uint8*)&pingresp); } } static bool ICACHE_FLASH_ATTR ping_raw_init(struct ping_msg *pingmsg) { if (pingmsg == NULL) return false; ip_addr_t ping_target; pingmsg->ping_pcb = raw_new(IP_PROTO_ICMP); LWIP_ASSERT("ping_pcb != NULL", pingmsg->ping_pcb != NULL); raw_recv(pingmsg->ping_pcb, ping_recv, pingmsg); raw_bind(pingmsg->ping_pcb, IP_ADDR_ANY); ping_target.addr = pingmsg->ping_opt->ip; pingmsg ->ping_sent = system_get_time(); ping_send(pingmsg->ping_pcb, &ping_target); sys_timeout(PING_TIMEOUT_MS, ping_timeout, pingmsg); sys_timeout(pingmsg->coarse_time, ping_coarse_tmr, pingmsg); return true; } bool ICACHE_FLASH_ATTR ping_start(struct ping_option *ping_opt) { struct ping_msg *pingmsg = NULL; pingmsg = (struct ping_msg *)os_zalloc(sizeof(struct ping_msg)); if (pingmsg == NULL || ping_opt == NULL) return false; pingmsg->ping_opt = ping_opt; if (ping_opt->count != 0) pingmsg->max_count = ping_opt->count; else pingmsg->max_count = DEFAULT_PING_MAX_COUNT; if (ping_opt->coarse_time != 0) pingmsg->coarse_time = ping_opt->coarse_time * PING_COARSE; else pingmsg->coarse_time = PING_COARSE; pingmsg->ping_start = system_get_time(); pingmsg->sent_count = pingmsg->max_count; return ping_raw_init(pingmsg); } bool ICACHE_FLASH_ATTR ping_regist_recv(struct ping_option *ping_opt, ping_recv_function ping_recv) { if (ping_opt == NULL) return false; ping_opt ->recv_function = ping_recv; return true; } bool ICACHE_FLASH_ATTR ping_regist_sent(struct ping_option *ping_opt, ping_sent_function ping_sent) { if (ping_opt == NULL) return false; ping_opt ->sent_function = ping_sent; return true; } #endif /* LWIP_RAW */ ================================================ FILE: app/lwip/core/Makefile ================================================ ############################################################# # Required variables for each makefile # Discard this section from all parent makefiles # Expected variables (with automatic defaults): # CSRCS (all "C" files in the dir) # SUBDIRS (all subdirs with a Makefile) # GEN_LIBS - list of libs to be generated () # GEN_IMAGES - list of images to be generated () # COMPONENTS_xxx - a list of libs/objs in the form # subdir/lib to be extracted and rolled up into # a generated lib/image xxx.a () # ifndef PDIR GEN_LIBS = liblwipcore.a endif ############################################################# # Configuration i.e. compile options etc. # Target specific stuff (defines etc.) goes in here! # Generally values applying to a tree are captured in the # makefile at its root level - these are then overridden # for a subtree within the makefile rooted therein # #DEFINES += ############################################################# # Recursion Magic - Don't touch this!! # # Each subtree potentially has an include directory # corresponding to the common APIs applicable to modules # rooted at that subtree. Accordingly, the INCLUDE PATH # of a module can only contain the include directories up # its parent path, and not its siblings # # Required for each makefile to inherit from the parent # INCLUDES := $(INCLUDES) -I $(PDIR)include INCLUDES += -I ./ PDIR := ../$(PDIR) sinclude $(PDIR)Makefile ================================================ FILE: app/lwip/core/def.c ================================================ /** * @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) */ ================================================ FILE: app/lwip/core/dhcp.c ================================================ /** * @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 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. * * 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_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/sys.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 = __FILE__; #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 #define DHCP_OPTION_IDX_MAX (DHCP_OPTION_IDX_DNS_SERVER + DNS_MAX_SERVERS) /** 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]; #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) (os_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)) /* 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, 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); /* always add the DHCP options trailer to end and pad */ static void dhcp_option_trailer(struct dhcp *dhcp); /** * 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 ICACHE_FLASH_ATTR 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)); /* Set the interface down since the address must no longer be used, as per RFC2131 */ netif_set_down(netif); /* remove IP address from interface */ netif_set_ipaddr(netif, IP_ADDR_ANY); netif_set_gw(netif, IP_ADDR_ANY); netif_set_netmask(netif, IP_ADDR_ANY); /* Change to a defined state */ dhcp_set_state(dhcp, DHCP_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 ICACHE_FLASH_ATTR 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_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")); } 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 ICACHE_FLASH_ATTR 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)) { ip4_addr_set_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(&dhcp->server_ip_addr))); /* remember offered address */ ip_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 ICACHE_FLASH_ATTR dhcp_select(struct netif *netif) { struct dhcp *dhcp = netif->dhcp; err_t result; u16_t msecs; 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_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(&dhcp->server_ip_addr))); dhcp_option(dhcp, DHCP_OPTION_PARAMETER_REQUEST_LIST, 12/*num options*/); dhcp_option_byte(dhcp, DHCP_OPTION_SUBNET_MASK); dhcp_option_byte(dhcp, DHCP_OPTION_ROUTER); dhcp_option_byte(dhcp, DHCP_OPTION_BROADCAST); dhcp_option_byte(dhcp, DHCP_OPTION_DNS_SERVER); dhcp_option_byte(dhcp, DHCP_OPTION_DOMAIN_NAME); dhcp_option_byte(dhcp, DHCP_OPTION_NB_TINS); dhcp_option_byte(dhcp, DHCP_OPTION_NB_TINT); dhcp_option_byte(dhcp, DHCP_OPTION_NB_TIS); dhcp_option_byte(dhcp, DHCP_OPTION_PRD); dhcp_option_byte(dhcp, DHCP_OPTION_STATIC_ROUTER); dhcp_option_byte(dhcp, DHCP_OPTION_CLASSLESS_STATIC_ROUTER); dhcp_option_byte(dhcp, DHCP_OPTION_VSN); #if LWIP_NETIF_HOSTNAME if (netif->hostname != NULL) { const char *p = (const char*)netif->hostname; u8_t namelen = (u8_t)os_strlen(p); if (namelen > 0) { LWIP_ASSERT("DHCP: hostname is too long!", namelen < 255); dhcp_option(dhcp, DHCP_OPTION_HOSTNAME, namelen); while (*p) { dhcp_option_byte(dhcp, *p++); } } } #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(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_select: REQUESTING\n")); } else { LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_LEVEL_WARNING, ("dhcp_select: could not allocate DHCP request\n")); } 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 ICACHE_FLASH_ATTR dhcp_coarse_tmr() { 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 */ if (netif->dhcp != NULL) { /* timer is active (non zero), and triggers (zeroes) now? */ if (netif->dhcp->t2_timeout-- == 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 (netif->dhcp->t1_timeout-- == 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 ICACHE_FLASH_ATTR dhcp_fine_tmr() { struct netif *netif = netif_list; /* loop through netif's */ while (netif != NULL) { /* only act on DHCP configured interfaces */ if (netif->dhcp != NULL) { /*add DHCP retries processing by LiuHan*/ if (DHCP_MAXRTX != 0) { if (netif->dhcp->tries >= DHCP_MAXRTX){ os_printf("DHCP timeout\n"); if (netif->dhcp_event != NULL) netif->dhcp_event(); break; } } /* 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 ICACHE_FLASH_ATTR 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_BACKING_OFF) || (dhcp->state == DHCP_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_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_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 */ } /* did not get response to renew request? */ else if (dhcp->state == DHCP_RENEWING) { LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE, ("dhcp_timeout(): RENEWING, DHCP request timed out\n")); /* just retry renewal */ /* note that the rebind timer will eventually time-out if renew does not work */ dhcp_renew(netif); /* did not get response to rebind request? */ } else if (dhcp->state == DHCP_REBINDING) { LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE, ("dhcp_timeout(): REBINDING, DHCP request timed out\n")); if (dhcp->tries <= 8) { dhcp_rebind(netif); } else { LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE, ("dhcp_timeout(): RELEASING, DISCOVERING\n")); dhcp_release(netif); dhcp_discover(netif); } } else if (dhcp->state == DHCP_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 ICACHE_FLASH_ATTR 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_REQUESTING) || (dhcp->state == DHCP_BOUND) || (dhcp->state == DHCP_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_RENEWING, not DHCP_BOUND */ dhcp_renew(netif); } } /** * The rebind period has timed out. * * @param netif the netif under DHCP control */ static void ICACHE_FLASH_ATTR 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_REQUESTING) || (dhcp->state == DHCP_BOUND) || (dhcp->state == DHCP_RENEWING)) { /* 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_REBINDING, not DHCP_BOUND */ dhcp_rebind(netif); } } /** * Handle a DHCP ACK packet * * @param netif the netif under DHCP control */ static void ICACHE_FLASH_ATTR dhcp_handle_ack(struct netif *netif) { struct dhcp *dhcp = netif->dhcp; #if LWIP_DNS u8_t n; #endif /* LWIP_DNS */ /* clear options we might not get from the ACK */ ip_addr_set_zero(&dhcp->offered_sn_mask); ip_addr_set_zero(&dhcp->offered_gw_addr); #if LWIP_DHCP_BOOTP_FILE ip_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 */ dhcp->offered_t2_rebind = dhcp->offered_t0_lease; } /* (y)our internet address */ ip_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_DNS /* DNS servers */ n = 0; while(dhcp_option_given(dhcp, DHCP_OPTION_IDX_DNS_SERVER + n) && (n < DNS_MAX_SERVERS)) { ip_addr_t dns_addr; ip4_addr_set_u32(&dns_addr, htonl(dhcp_get_option_value(dhcp, DHCP_OPTION_IDX_DNS_SERVER + n))); dns_setserver(n, &dns_addr); n++; } #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 ICACHE_FLASH_ATTR 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 */ os_memset(dhcp, 0, sizeof(struct dhcp)); /* dhcp_set_state(&dhcp, DHCP_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 ICACHE_FLASH_ATTR 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 ICACHE_FLASH_ATTR dhcp_start(struct netif *netif) { struct dhcp *dhcp; err_t result = ERR_OK; LWIP_ERROR("netif != NULL", (netif != NULL), 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)); /* Remove the flag that says this netif is handled by DHCP, it is set when we succeeded starting. */ netif->flags &= ~NETIF_FLAG_DHCP; /* 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")); if (dhcp->pcb != NULL) { udp_remove(dhcp->pcb); } LWIP_ASSERT("pbuf p_out wasn't freed", dhcp->p_out == NULL); LWIP_ASSERT("reply wasn't freed", dhcp->msg_in == NULL ); } /* clear data structure */ os_memset(dhcp, 0, sizeof(struct dhcp)); /* dhcp_set_state(&dhcp, DHCP_OFF); */ /* allocate UDP PCB */ dhcp->pcb = udp_new(); if (dhcp->pcb == NULL) { LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE, ("dhcp_start(): could not obtain pcb\n")); return ERR_MEM; } dhcp->pcb->so_options |= SOF_BROADCAST; /* set up local and remote port for the pcb */ udp_bind(dhcp->pcb, IP_ADDR_ANY, DHCP_CLIENT_PORT); udp_connect(dhcp->pcb, IP_ADDR_ANY, DHCP_SERVER_PORT); /* set up the recv callback and argument */ udp_recv(dhcp->pcb, dhcp_recv, netif); LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE, ("dhcp_start(): starting DHCP configuration\n")); /* (re)start the DHCP negotiation */ result = dhcp_discover(netif); if (result != ERR_OK) { /* free resources allocated above */ dhcp_stop(netif); return ERR_MEM; } /* Set the flag that says this netif is handled by DHCP. */ netif->flags |= NETIF_FLAG_DHCP; 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 ICACHE_FLASH_ATTR dhcp_inform(struct netif *netif) { struct dhcp dhcp; err_t result = ERR_OK; struct udp_pcb *pcb; LWIP_ERROR("netif != NULL", (netif != NULL), return;); os_memset(&dhcp, 0, sizeof(struct dhcp)); dhcp_set_state(&dhcp, DHCP_INFORM); if ((netif->dhcp != NULL) && (netif->dhcp->pcb != NULL)) { /* re-use existing pcb */ pcb = netif->dhcp->pcb; } else { pcb = udp_new(); if (pcb == NULL) { LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_LEVEL_SERIOUS, ("dhcp_inform(): could not obtain pcb")); return; } dhcp.pcb = pcb; dhcp.pcb->so_options |= SOF_BROADCAST; udp_bind(dhcp.pcb, IP_ADDR_ANY, DHCP_CLIENT_PORT); LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE, ("dhcp_inform(): created new udp pcb\n")); } /* 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(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")); } if (dhcp.pcb != NULL) { /* otherwise, the existing pcb was used */ udp_remove(dhcp.pcb); } } /** Handle a possible change in the network configuration. * * This enters the REBOOTING state to verify that the currently bound * address is still valid. */ void ICACHE_FLASH_ATTR dhcp_network_changed(struct netif *netif) { struct dhcp *dhcp = netif->dhcp; if (!dhcp) return; switch (dhcp->state) { case DHCP_REBINDING: case DHCP_RENEWING: case DHCP_BOUND: case DHCP_REBOOTING: netif_set_down(netif); dhcp->tries = 0; dhcp_reboot(netif); break; case DHCP_OFF: /* stay off */ break; default: dhcp->tries = 0; #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 */ 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 ICACHE_FLASH_ATTR dhcp_arp_reply(struct netif *netif, ip_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_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 (ip_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 ICACHE_FLASH_ATTR 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_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(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_decline: BACKING OFF\n")); } else { LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_LEVEL_SERIOUS, ("dhcp_decline: could not allocate DHCP request\n")); } 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 ICACHE_FLASH_ATTR dhcp_discover(struct netif *netif) { struct dhcp *dhcp = netif->dhcp; err_t result = ERR_OK; u16_t msecs; LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE, ("dhcp_discover()\n")); ip_addr_set_any(&dhcp->offered_ip_addr); dhcp_set_state(dhcp, DHCP_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)); #if LWIP_NETIF_HOSTNAME if (netif->hostname != NULL) { const char *p = (const char*)netif->hostname; u8_t namelen = (u8_t)os_strlen(p); if (namelen > 0) { LWIP_ASSERT("DHCP: hostname is too long!", namelen < 255); dhcp_option(dhcp, DHCP_OPTION_HOSTNAME, namelen); while (*p) { dhcp_option_byte(dhcp, *p++); } } } #endif /* LWIP_NETIF_HOSTNAME */ dhcp_option(dhcp, DHCP_OPTION_PARAMETER_REQUEST_LIST, 12/*num options*/); dhcp_option_byte(dhcp, DHCP_OPTION_SUBNET_MASK); dhcp_option_byte(dhcp, DHCP_OPTION_ROUTER); dhcp_option_byte(dhcp, DHCP_OPTION_BROADCAST); dhcp_option_byte(dhcp, DHCP_OPTION_DNS_SERVER); dhcp_option_byte(dhcp, DHCP_OPTION_DOMAIN_NAME); dhcp_option_byte(dhcp, DHCP_OPTION_NB_TINS); dhcp_option_byte(dhcp, DHCP_OPTION_NB_TINT); dhcp_option_byte(dhcp, DHCP_OPTION_NB_TIS); dhcp_option_byte(dhcp, DHCP_OPTION_PRD); dhcp_option_byte(dhcp, DHCP_OPTION_STATIC_ROUTER); dhcp_option_byte(dhcp, DHCP_OPTION_CLASSLESS_STATIC_ROUTER); dhcp_option_byte(dhcp, DHCP_OPTION_VSN); 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(dhcp->pcb, dhcp->p_out, IP_ADDR_BROADCAST, DHCP_SERVER_PORT, netif); 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")); } 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 ICACHE_FLASH_ATTR dhcp_bind(struct netif *netif) { u32_t timeout; struct dhcp *dhcp; ip_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)); /* 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)); } /* 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)); } /* If we have sub 1 minute lease, t2 and t1 will kick in at the same time. modify by ives at 2014.4.22*/ if ((dhcp->t1_timeout >= dhcp->t2_timeout) && (dhcp->t2_timeout > 0)) { dhcp->t1_timeout = 0; } if (dhcp->subnet_mask_given) { /* copy offered network mask */ ip_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(0xff000000)); } else if (first_octet >= 192) { ip4_addr_set_u32(&sn_mask, PP_HTONL(0xffffff00)); } else { ip4_addr_set_u32(&sn_mask, PP_HTONL(0xffff0000)); } } ip_addr_copy(gw_addr, dhcp->offered_gw_addr); /* gateway address not given? */ if (ip_addr_isany(&gw_addr)) { /* copy network address */ ip_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(0x00000001)); } #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 */ // wjg:back up old ip/netmask/gw ip_addr_t ip, mask, gw; ip = netif->ip_addr; mask = netif->netmask; gw = netif->gw; LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_STATE, ("dhcp_bind(): IP: 0x%08"X32_F"\n", ip4_addr_get_u32(&dhcp->offered_ip_addr))); netif_set_ipaddr(netif, &dhcp->offered_ip_addr); LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_STATE, ("dhcp_bind(): SN: 0x%08"X32_F"\n", ip4_addr_get_u32(&sn_mask))); netif_set_netmask(netif, &sn_mask); LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_STATE, ("dhcp_bind(): GW: 0x%08"X32_F"\n", ip4_addr_get_u32(&gw_addr))); netif_set_gw(netif, &gw_addr); /* bring the interface up */ netif_set_up(netif); // wjg: use old ip/mask/gw to check whether ip/mask/gw changed system_station_got_ip_set(&ip, &mask, &gw); /* netif is now bound to DHCP leased address */ dhcp_set_state(dhcp, DHCP_BOUND); } /** * Renew an existing DHCP lease at the involved DHCP server. * * @param netif network interface which must renew its lease */ err_t ICACHE_FLASH_ATTR 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_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 if (netif->hostname != NULL) { const char *p = (const char*)netif->hostname; u8_t namelen = (u8_t)os_strlen(p); if (namelen > 0) { LWIP_ASSERT("DHCP: hostname is too long!", namelen < 255); dhcp_option(dhcp, DHCP_OPTION_HOSTNAME, namelen); while (*p) { dhcp_option_byte(dhcp, *p++); } } } #endif /* LWIP_NETIF_HOSTNAME */ #if 0 dhcp_option(dhcp, DHCP_OPTION_REQUESTED_IP, 4); dhcp_option_long(dhcp, ntohl(dhcp->offered_ip_addr.addr)); #endif #if 0 dhcp_option(dhcp, DHCP_OPTION_SERVER_ID, 4); dhcp_option_long(dhcp, ntohl(dhcp->server_ip_addr.addr)); #endif /* 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")); } 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 ICACHE_FLASH_ATTR 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_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 if (netif->hostname != NULL) { const char *p = (const char*)netif->hostname; u8_t namelen = (u8_t)os_strlen(p); if (namelen > 0) { LWIP_ASSERT("DHCP: hostname is too long!", namelen < 255); dhcp_option(dhcp, DHCP_OPTION_HOSTNAME, namelen); while (*p) { dhcp_option_byte(dhcp, *p++); } } } #endif /* LWIP_NETIF_HOSTNAME */ #if 0 dhcp_option(dhcp, DHCP_OPTION_REQUESTED_IP, 4); dhcp_option_long(dhcp, ntohl(dhcp->offered_ip_addr.addr)); dhcp_option(dhcp, DHCP_OPTION_SERVER_ID, 4); dhcp_option_long(dhcp, ntohl(dhcp->server_ip_addr.addr)); #endif 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")); } 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 ICACHE_FLASH_ATTR 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_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")); } 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 ICACHE_FLASH_ATTR dhcp_release(struct netif *netif) { struct dhcp *dhcp = netif->dhcp; err_t result; u16_t msecs; LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE, ("dhcp_release()\n")); if (dhcp == NULL) { return ERR_ARG; } /* idle DHCP client */ dhcp_set_state(dhcp, DHCP_OFF); /* clean old DHCP offer */ ip_addr_set_zero(&dhcp->server_ip_addr); ip_addr_set_zero(&dhcp->offered_ip_addr); ip_addr_set_zero(&dhcp->offered_sn_mask); ip_addr_set_zero(&dhcp->offered_gw_addr); #if LWIP_DHCP_BOOTP_FILE ip_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; /* create and initialize the DHCP message header */ result = dhcp_create_msg(netif, dhcp, DHCP_RELEASE); if (result == ERR_OK) { 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_release: RELEASED, DHCP_OFF\n")); } else { LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_LEVEL_SERIOUS, ("dhcp_release: could not allocate DHCP request\n")); } 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_release(): set request timeout %"U16_F" msecs\n", msecs)); /* bring the interface down */ netif_set_down(netif); /* remove IP address from interface */ netif_set_ipaddr(netif, IP_ADDR_ANY); netif_set_gw(netif, IP_ADDR_ANY); netif_set_netmask(netif, IP_ADDR_ANY); return result; } /** * Remove the DHCP client from the interface. * * @param netif The network interface to stop DHCP on */ void ICACHE_FLASH_ATTR dhcp_stop(struct netif *netif) { struct dhcp *dhcp; LWIP_ERROR("dhcp_stop: netif != NULL", (netif != NULL), return;); dhcp = netif->dhcp; /* Remove the flag that says this netif is handled by DHCP. */ netif->flags &= ~NETIF_FLAG_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 */ if (dhcp->pcb != NULL) { udp_remove(dhcp->pcb); dhcp->pcb = NULL; } LWIP_ASSERT("reply wasn't freed", dhcp->msg_in == NULL); dhcp_set_state(dhcp, DHCP_OFF); } } /* * Set the DHCP state of a DHCP client. * * If the state changed, reset the number of tries. */ static void ICACHE_FLASH_ATTR 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 ICACHE_FLASH_ATTR 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 ICACHE_FLASH_ATTR 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 ICACHE_FLASH_ATTR 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 ICACHE_FLASH_ATTR 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)); } /** * 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 conitguous piece of memory, and * use that further on. * */ static err_t ICACHE_FLASH_ATTR 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_ASSERT("len == 4", len == 4); decode_idx = DHCP_OPTION_IDX_SUBNET_MASK; break; case(DHCP_OPTION_ROUTER): decode_len = 4; /* only copy the first given router */ LWIP_ASSERT("len >= decode_len", len >= decode_len); decode_idx = DHCP_OPTION_IDX_ROUTER; break; case(DHCP_OPTION_DNS_SERVER): /* special case: there might be more than one server */ LWIP_ASSERT("len % 4 == 0", len % 4 == 0); /* limit number of DNS servers */ decode_len = LWIP_MIN(len, 4 * DNS_MAX_SERVERS); LWIP_ASSERT("len >= decode_len", len >= decode_len); decode_idx = DHCP_OPTION_IDX_DNS_SERVER; break; case(DHCP_OPTION_LEASE_TIME): LWIP_ASSERT("len == 4", len == 4); decode_idx = DHCP_OPTION_IDX_LEASE_TIME; break; case(DHCP_OPTION_OVERLOAD): LWIP_ASSERT("len == 1", len == 1); decode_idx = DHCP_OPTION_IDX_OVERLOAD; break; case(DHCP_OPTION_MESSAGE_TYPE): LWIP_ASSERT("len == 1", len == 1); decode_idx = DHCP_OPTION_IDX_MSG_TYPE; break; case(DHCP_OPTION_SERVER_ID): LWIP_ASSERT("len == 4", len == 4); decode_idx = DHCP_OPTION_IDX_SERVER_ID; break; case(DHCP_OPTION_T1): LWIP_ASSERT("len == 4", len == 4); decode_idx = DHCP_OPTION_IDX_T1; break; case(DHCP_OPTION_T2): LWIP_ASSERT("len == 4", len == 4); 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); LWIP_ASSERT("option already decoded", !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_ASSERT("decode_len % 4 == 0", decode_len % 4 == 0); 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_ASSERT("invalid decode_len", decode_len == 1); 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) { //modify by ives at 2014.4.22 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 ICACHE_FLASH_ATTR dhcp_recv(void *arg, struct udp_pcb *pcb, struct pbuf *p, ip_addr_t *addr, u16_t port) { struct netif *netif = (struct netif *)arg; struct dhcp *dhcp = netif->dhcp; struct dhcp_msg *reply_msg = (struct dhcp_msg *)p->payload; u8_t msg_type; u8_t i; 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(addr), ip4_addr2_16(addr), ip4_addr3_16(addr), ip4_addr4_16(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++) { 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_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_REBOOTING) || (dhcp->state == DHCP_REBINDING) || (dhcp->state == DHCP_RENEWING)) { dhcp_bind(netif); } } /* received a DHCP_NAK in appropriate state? */ else if ((msg_type == DHCP_NAK) && ((dhcp->state == DHCP_REBOOTING) || (dhcp->state == DHCP_REQUESTING) || (dhcp->state == DHCP_REBINDING) || (dhcp->state == DHCP_RENEWING ))) { LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE, ("DHCP_NAK received\n")); dhcp_handle_nak(netif); } /* received a DHCP_OFFER in DHCP_SELECTING state? */ else if ((msg_type == DHCP_OFFER) && (dhcp->state == DHCP_SELECTING)) { LWIP_DEBUGF(DHCP_DEBUG | LWIP_DBG_TRACE, ("DHCP_OFFER received in DHCP_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 ICACHE_FLASH_ATTR 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 */ static u32_t xid = 0xABCD0000; #else static u32_t xid; static u8_t xid_initialised = 0; 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 modify by ives at 2014.4.22*/ if (message_type != DHCP_REQUEST) { /* reuse transaction identifier in retransmissions */ if (dhcp->tries == 0) { xid++; } 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; ip_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_REQUEST) && /* DHCP_BOUND not used for sending! */ ((dhcp->state==DHCP_RENEWING) || dhcp->state==DHCP_REBINDING))) { ip_addr_copy(dhcp->msg_out->ciaddr, netif->ip_addr); } ip_addr_set_zero(&dhcp->msg_out->yiaddr); ip_addr_set_zero(&dhcp->msg_out->siaddr); ip_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 ICACHE_FLASH_ATTR 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 ICACHE_FLASH_ATTR 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)) { /* LWIP_DEBUGF(DHCP_DEBUG,("dhcp_option_trailer:dhcp->options_out_len=%"U16_F", DHCP_OPTIONS_LEN=%"U16_F, dhcp->options_out_len, DHCP_OPTIONS_LEN)); */ LWIP_ASSERT("dhcp_option_trailer: dhcp->options_out_len < DHCP_OPTIONS_LEN\n", dhcp->options_out_len < DHCP_OPTIONS_LEN); /* add a fill/padding byte */ dhcp->msg_out->options[dhcp->options_out_len++] = 0; } } #endif /* LWIP_DHCP */ ================================================ FILE: app/lwip/core/dns.c ================================================ /** * @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 * 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 = __FILE__; #endif /** DNS server IP address */ #ifndef DNS_SERVER_ADDRESS #define DNS_SERVER_ADDRESS(ipaddr) (ip4_addr_set_u32(ipaddr, 0xDEDE43D0)) /* resolver1.opendns.com(208.67.222.222) */ #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 /* 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_FIELD(u8_t flags1); PACK_STRUCT_FIELD(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 /** DNS table entry */ struct dns_table_entry { u8_t state; u8_t numdns; u8_t tmr; u8_t retries; u8_t seqno; u8_t err; u32_t ttl; char name[DNS_MAX_NAME_LENGTH]; ip_addr_t ipaddr; /* pointer to callback on DNS query done */ dns_found_callback found; void *arg; }; #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(); #endif /* DNS_LOCAL_HOSTLIST */ /* forward declarations */ static void dns_recv(void *s, struct udp_pcb *pcb, struct pbuf *p, ip_addr_t *addr, u16_t port); static void dns_check_entries(void); /*----------------------------------------------------------------------------- * Globales *----------------------------------------------------------------------------*/ /* DNS variables */ static struct udp_pcb *dns_pcb; static u8_t dns_seqno; static struct dns_table_entry dns_table[DNS_TABLE_SIZE]; static ip_addr_t dns_servers[DNS_MAX_SERVERS]; /** Contiguous buffer for processing responses */ //static u8_t dns_payload_buffer[LWIP_MEM_ALIGN_BUFFER(DNS_MSG_SIZE)]; static u8_t* dns_payload; static u8_t dns_random; /** * Initialize the resolver: set up the UDP pcb and configure the default server * (DNS_SERVER_ADDRESS). */ void ICACHE_FLASH_ATTR dns_init() { ip_addr_t dnsserver; // dns_payload = (u8_t *)LWIP_MEM_ALIGN(dns_payload_buffer); /* initialize default DNS server address */ DNS_SERVER_ADDRESS(&dnsserver); LWIP_DEBUGF(DNS_DEBUG, ("dns_init: initializing\n")); /* if dns client not yet initialized... */ if (dns_pcb == NULL) { dns_pcb = udp_new(); if (dns_pcb != 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_pcb, IP_ADDR_ANY, 0); udp_recv(dns_pcb, dns_recv, NULL); /* initialize default DNS primary server */ dns_setserver(0, &dnsserver); } } #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 ICACHE_FLASH_ATTR dns_setserver(u8_t numdns, ip_addr_t *dnsserver) { if ((numdns < DNS_MAX_SERVERS) && (dns_pcb != NULL) && (dnsserver != NULL) && !ip_addr_isany(dnsserver)) { dns_servers[numdns] = (*dnsserver); } } /** * 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 ICACHE_FLASH_ATTR 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 ICACHE_FLASH_ATTR dns_tmr(void) { if (dns_pcb != NULL) { LWIP_DEBUGF(DNS_DEBUG, ("dns_tmr: dns_check_entries\n")); dns_check_entries(); } } #if DNS_LOCAL_HOSTLIST static void ICACHE_FLASH_ATTR dns_init_local() { #if DNS_LOCAL_HOSTLIST_IS_DYNAMIC && defined(DNS_LOCAL_HOSTLIST_INIT) int 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 = os_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) { entry->name = (char*)entry + sizeof(struct local_hostlist_entry); MEMCPY((char*)entry->name, init_entry->name, namelen); ((char*)entry->name)[namelen] = 0; 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 * @return The first IP address for the hostname in the local host-list or * IPADDR_NONE if not found. */ static u32_t ICACHE_FLASH_ATTR dns_lookup_local(const char *hostname) { #if DNS_LOCAL_HOSTLIST_IS_DYNAMIC struct local_hostlist_entry *entry = local_hostlist_dynamic; while(entry != NULL) { if(strcmp(entry->name, hostname) == 0) { return ip4_addr_get_u32(&entry->addr); } entry = entry->next; } #else /* DNS_LOCAL_HOSTLIST_IS_DYNAMIC */ int i; for (i = 0; i < sizeof(local_hostlist_static) / sizeof(struct local_hostlist_entry); i++) { if(strcmp(local_hostlist_static[i].name, hostname) == 0) { return ip4_addr_get_u32(&local_hostlist_static[i].addr); } } #endif /* DNS_LOCAL_HOSTLIST_IS_DYNAMIC */ return IPADDR_NONE; } #if DNS_LOCAL_HOSTLIST_IS_DYNAMIC /** Remove all entries from the local host-list for a specific hostname * and/or IP addess * * @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 ICACHE_FLASH_ATTR 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) || !strcmp(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 ICACHE_FLASH_ATTR dns_local_addhost(const char *hostname, const ip_addr_t *addr) { struct local_hostlist_entry *entry; size_t namelen; LWIP_ASSERT("invalid host name (NULL)", hostname != NULL); namelen = os_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((char*)entry->name, hostname, namelen); ((char*)entry->name)[namelen] = 0; 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 * @return 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. */ static u32_t ICACHE_FLASH_ATTR dns_lookup(const char *name) { u8_t i; #if DNS_LOCAL_HOSTLIST || defined(DNS_LOOKUP_LOCAL_EXTERN) u32_t addr; #endif /* DNS_LOCAL_HOSTLIST || defined(DNS_LOOKUP_LOCAL_EXTERN) */ #if DNS_LOCAL_HOSTLIST if ((addr = dns_lookup_local(name)) != IPADDR_NONE) { return addr; } #endif /* DNS_LOCAL_HOSTLIST */ #ifdef DNS_LOOKUP_LOCAL_EXTERN if((addr = DNS_LOOKUP_LOCAL_EXTERN(name)) != IPADDR_NONE) { return addr; } #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) && (strcmp(name, dns_table[i].name) == 0)) { LWIP_DEBUGF(DNS_DEBUG, ("dns_lookup: \"%s\": found = ", name)); ip_addr_debug_print(DNS_DEBUG, &(dns_table[i].ipaddr)); LWIP_DEBUGF(DNS_DEBUG, ("\n")); return ip4_addr_get_u32(&dns_table[i].ipaddr); } } return IPADDR_NONE; } #if DNS_DOES_NAME_CHECK /** * 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 response encoded hostname in the DNS response * @return 0: names equal; 1: names differ */ static u8_t ICACHE_FLASH_ATTR dns_compare_name(unsigned char *query, unsigned char *response) { unsigned char n; do { n = *response++; /** @see RFC 1035 - 4.1.4. Message compression */ if ((n & 0xc0) == 0xc0) { /* Compressed name */ break; } else { /* Not compressed name */ while (n > 0) { if ((*query) != (*response)) { return 1; } ++response; ++query; --n; }; ++query; } } while (*response != 0); return 0; } #endif /* DNS_DOES_NAME_CHECK */ /** * Walk through a compact encoded DNS name and return the end of the name. * * @param query encoded DNS name in the DNS server response * @return end of the name */ static unsigned char * ICACHE_FLASH_ATTR dns_parse_name(unsigned char *query) { unsigned char n; do { n = *query++; /** @see RFC 1035 - 4.1.4. Message compression */ if ((n & 0xc0) == 0xc0) { /* Compressed name */ break; } else { /* Not compressed name */ while (n > 0) { ++query; --n; }; } } while (*query != 0); return query + 1; } /** * Send a DNS query packet. * * @param numdns index of the DNS server in the dns_servers table * @param name hostname to query * @param id index of the hostname in dns_table, used as transaction ID in the * DNS query packet * @return ERR_OK if packet is sent; an err_t indicating the problem otherwise */ static err_t ICACHE_FLASH_ATTR dns_send(u8_t numdns, const char* name, u8_t id) { err_t err; struct dns_hdr *hdr; struct dns_query qry; struct pbuf *p; char *query, *nptr; const char *pHostname; u8_t n; dns_random = os_random()%250; LWIP_DEBUGF(DNS_DEBUG, ("dns_send: dns_servers[%"U16_F"] \"%s\": request\n", (u16_t)(numdns), name)); LWIP_ASSERT("dns server out of array", numdns < DNS_MAX_SERVERS); LWIP_ASSERT("dns server has no IP address set", !ip_addr_isany(&dns_servers[numdns])); /* if here, we have either a new query or a retry on a previous query to process */ p = pbuf_alloc(PBUF_TRANSPORT, SIZEOF_DNS_HDR + DNS_MAX_NAME_LENGTH + SIZEOF_DNS_QUERY, PBUF_RAM); if (p != NULL) { LWIP_ASSERT("pbuf must be in one piece", p->next == NULL); /* fill dns header */ hdr = (struct dns_hdr*)p->payload; os_memset(hdr, 0, SIZEOF_DNS_HDR); hdr->id = htons(id + dns_random); hdr->flags1 = DNS_FLAG1_RD; hdr->numquestions = PP_HTONS(1); query = (char*)hdr + SIZEOF_DNS_HDR; pHostname = name; --pHostname; /* convert hostname into suitable query format. */ do { ++pHostname; nptr = query; ++query; for(n = 0; *pHostname != '.' && *pHostname != 0; ++pHostname) { *query = *pHostname; ++query; ++n; } *nptr = n; } while(*pHostname != 0); *query++='\0'; /* fill dns query */ qry.type = PP_HTONS(DNS_RRTYPE_A); qry.cls = PP_HTONS(DNS_RRCLASS_IN); SMEMCPY(query, &qry, SIZEOF_DNS_QUERY); /* resize pbuf to the exact dns query */ pbuf_realloc(p, (u16_t)((query + SIZEOF_DNS_QUERY) - ((char*)(p->payload)))); /* connect to the server for faster receiving */ udp_connect(dns_pcb, &dns_servers[numdns], DNS_SERVER_PORT); /* send dns packet */ err = udp_sendto(dns_pcb, p, &dns_servers[numdns], DNS_SERVER_PORT); /* free pbuf */ pbuf_free(p); } else { err = ERR_MEM; } return err; } /** * dns_check_entry() - see if pEntry 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 ICACHE_FLASH_ATTR dns_check_entry(u8_t i) { err_t err; struct dns_table_entry *pEntry = &dns_table[i]; LWIP_ASSERT("array index out of bounds", i < DNS_TABLE_SIZE); switch(pEntry->state) { case DNS_STATE_NEW: { /* initialize new entry */ pEntry->state = DNS_STATE_ASKING; pEntry->numdns = 0; pEntry->tmr = 1; pEntry->retries = 0; /* send DNS packet for this entry */ err = dns_send(pEntry->numdns, pEntry->name, 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 (--pEntry->tmr == 0) { if (++pEntry->retries == DNS_MAX_RETRIES) { if ((pEntry->numdns+1numdns+1])) { /* change of server */ pEntry->numdns++; pEntry->tmr = 1; pEntry->retries = 0; break; } else { LWIP_DEBUGF(DNS_DEBUG, ("dns_check_entry: \"%s\": timeout\n", pEntry->name)); /* call specified callback function if provided */ if (pEntry->found) (*pEntry->found)(pEntry->name, NULL, pEntry->arg); /* flush this entry */ pEntry->state = DNS_STATE_UNUSED; pEntry->found = NULL; break; } } /* wait longer for the next retry */ pEntry->tmr = pEntry->retries; /* send DNS packet for this entry */ err = dns_send(pEntry->numdns, pEntry->name, 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 (--pEntry->ttl == 0) { LWIP_DEBUGF(DNS_DEBUG, ("dns_check_entry: \"%s\": flush\n", pEntry->name)); /* flush this entry */ pEntry->state = DNS_STATE_UNUSED; pEntry->found = NULL; } 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 ICACHE_FLASH_ATTR 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 ICACHE_FLASH_ATTR dns_recv(void *arg, struct udp_pcb *pcb, struct pbuf *p, ip_addr_t *addr, u16_t port) { u16_t i; char *pHostname; struct dns_hdr *hdr; struct dns_answer ans; struct dns_table_entry *pEntry; u16_t nquestions, nanswers; u8_t* dns_payload_buffer = (u8_t* )os_zalloc(LWIP_MEM_ALIGN_BUFFER(DNS_MSG_SIZE)); dns_payload = (u8_t *)LWIP_MEM_ALIGN(dns_payload_buffer); LWIP_UNUSED_ARG(arg); LWIP_UNUSED_ARG(pcb); LWIP_UNUSED_ARG(addr); LWIP_UNUSED_ARG(port); /* is the dns message too big ? */ if (p->tot_len > DNS_MSG_SIZE) { LWIP_DEBUGF(DNS_DEBUG, ("dns_recv: pbuf too big\n")); /* free pbuf and return */ goto memerr; } /* is the dns message big enough ? */ if (p->tot_len < (SIZEOF_DNS_HDR + SIZEOF_DNS_QUERY + SIZEOF_DNS_ANSWER)) { 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, dns_payload, p->tot_len, 0) == p->tot_len) { /* The ID in the DNS header should be our entry into the name table. */ hdr = (struct dns_hdr*)dns_payload; i = htons(hdr->id); i = i - dns_random; if (i < DNS_TABLE_SIZE) { pEntry = &dns_table[i]; if(pEntry->state == DNS_STATE_ASKING) { /* This entry is now completed. */ pEntry->state = DNS_STATE_DONE; pEntry->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) || (pEntry->err != 0) || (nquestions != 1)) { LWIP_DEBUGF(DNS_DEBUG, ("dns_recv: \"%s\": error in flags\n", pEntry->name)); /* call callback to indicate error, clean up memory and return */ goto responseerr; } #if DNS_DOES_NAME_CHECK /* Check if the name in the "question" part match with the name in the entry. */ if (dns_compare_name((unsigned char *)(pEntry->name), (unsigned char *)dns_payload + SIZEOF_DNS_HDR) != 0) { LWIP_DEBUGF(DNS_DEBUG, ("dns_recv: \"%s\": response not match to query\n", pEntry->name)); /* call callback to indicate error, clean up memory and return */ goto responseerr; } #endif /* DNS_DOES_NAME_CHECK */ /* Skip the name in the "question" part */ pHostname = (char *) dns_parse_name((unsigned char *)dns_payload + SIZEOF_DNS_HDR) + SIZEOF_DNS_QUERY; while (nanswers > 0) { /* skip answer resource record's host name */ pHostname = (char *) dns_parse_name((unsigned char *)pHostname); /* Check for IP address type and Internet class. Others are discarded. */ SMEMCPY(&ans, pHostname, SIZEOF_DNS_ANSWER); if((ans.type == PP_HTONS(DNS_RRTYPE_A)) && (ans.cls == PP_HTONS(DNS_RRCLASS_IN)) && (ans.len == PP_HTONS(sizeof(ip_addr_t))) ) { /* read the answer resource record's TTL, and maximize it if needed */ pEntry->ttl = ntohl(ans.ttl); if (pEntry->ttl > DNS_MAX_TTL) { pEntry->ttl = DNS_MAX_TTL; } /* read the IP address after answer resource record's header */ SMEMCPY(&(pEntry->ipaddr), (pHostname+SIZEOF_DNS_ANSWER), sizeof(ip_addr_t)); LWIP_DEBUGF(DNS_DEBUG, ("dns_recv: \"%s\": response = ", pEntry->name)); ip_addr_debug_print(DNS_DEBUG, (&(pEntry->ipaddr))); LWIP_DEBUGF(DNS_DEBUG, ("\n")); /* call specified callback function if provided */ if (pEntry->found) { (*pEntry->found)(pEntry->name, &pEntry->ipaddr, pEntry->arg); } /* deallocate memory and return */ goto memerr; } else { pHostname = pHostname + SIZEOF_DNS_ANSWER + htons(ans.len); } --nanswers; } LWIP_DEBUGF(DNS_DEBUG, ("dns_recv: \"%s\": error in response\n", pEntry->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 */ if (pEntry->found) { (*pEntry->found)(pEntry->name, NULL, pEntry->arg); } /* flush this entry */ pEntry->state = DNS_STATE_UNUSED; pEntry->found = NULL; memerr: /* free pbuf */ pbuf_free(p); os_free(dns_payload_buffer); 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 found a callback founction 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 ICACHE_FLASH_ATTR dns_enqueue(const char *name, dns_found_callback found, void *callback_arg) { u8_t i; u8_t lseq, lseqi; struct dns_table_entry *pEntry = NULL; size_t namelen; /* search an unused entry, or the oldest one */ lseq = lseqi = 0; for (i = 0; i < DNS_TABLE_SIZE; ++i) { pEntry = &dns_table[i]; /* is it an unused entry ? */ if (pEntry->state == DNS_STATE_UNUSED) break; /* check if this is the oldest completed entry */ if (pEntry->state == DNS_STATE_DONE) { if ((dns_seqno - pEntry->seqno) > lseq) { lseq = dns_seqno - pEntry->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't 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; pEntry = &dns_table[i]; } } /* use this entry */ LWIP_DEBUGF(DNS_DEBUG, ("dns_enqueue: \"%s\": use DNS entry %"U16_F"\n", name, (u16_t)(i))); /* fill the entry */ pEntry->state = DNS_STATE_NEW; pEntry->seqno = dns_seqno++; pEntry->found = found; pEntry->arg = callback_arg; namelen = LWIP_MIN(os_strlen(name), DNS_MAX_NAME_LENGTH-1); MEMCPY(pEntry->name, name, namelen); pEntry->name[namelen] = 0; /* 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 ICACHE_FLASH_ATTR dns_gethostbyname(const char *hostname, ip_addr_t *addr, dns_found_callback found, void *callback_arg) { u32_t ipaddr; /* not initialized or no valid server yet, or invalid addr pointer * or invalid hostname or invalid hostname length */ if ((dns_pcb == NULL) || (addr == NULL) || (!hostname) || (!hostname[0]) || (os_strlen(hostname) >= DNS_MAX_NAME_LENGTH)) { return ERR_ARG; } #if LWIP_HAVE_LOOPIF if (strcmp(hostname, "localhost")==0) { ip_addr_set_loopback(addr); return ERR_OK; } #endif /* LWIP_HAVE_LOOPIF */ /* host name already in octet notation? set ip addr and return ERR_OK */ ipaddr = ipaddr_addr(hostname); if (ipaddr == IPADDR_NONE) { /* already have this address cached? */ // ipaddr = dns_lookup(hostname); } if (ipaddr != IPADDR_NONE) { ip4_addr_set_u32(addr, ipaddr); return ERR_OK; } /* queue query with specified callback */ return dns_enqueue(hostname, found, callback_arg); } #endif /* LWIP_DNS */ ================================================ FILE: app/lwip/core/init.c ================================================ /** * @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/tcp_impl.h" #include "lwip/snmp_msg.h" #include "lwip/autoip.h" #include "lwip/igmp.h" #include "lwip/dns.h" #include "lwip/timers.h" #include "netif/etharp.h" /* 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_ARP && ARP_QUEUEING) #error "If you want to use ARP Queueing, you have to define LWIP_ARP=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_SNMP) #error "If you want to use SNMP, 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_IGMP) #error "If you want to use IGMP, you have to define LWIP_UDP=1 in your lwipopts.h" #endif #if (!LWIP_UDP && LWIP_SNMP) #error "If you want to use SNMP, 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 (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_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" //#endif #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 //#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 #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_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_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_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 #if (!LWIP_NETCONN && LWIP_SOCKET) #error "If you want to use Socket API, you have to define LWIP_NETCONN=1 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_SNMP && (SNMP_CONCURRENT_REQUESTS<=0)) #error "If you want to use SNMP, you have to define SNMP_CONCURRENT_REQUESTS>=1 in your lwipopts.h" #endif #if (LWIP_SNMP && (SNMP_TRAP_DESTINATIONS<=0)) #error "If you want to use SNMP, you have to define SNMP_TRAP_DESTINATIONS>=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 /* 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)) #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 #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 (TCP_QUEUE_OOSEQ && !LWIP_TCP) #error "TCP_QUEUE_OOSEQ requires LWIP_TCP" #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 #error "PPP_SUPPORT needs either PPPOS_SUPPORT or PPPOE_SUPPORT 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 && !defined(LWIP_RAND) #error "When using IGMP, 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 /* 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 MEMP_NUM_API_MSG #error "MEMP_NUM_API_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 #ifdef LWIP_DEBUG static void ICACHE_FLASH_ATTR lwip_sanity_check(void) { /* Warnings */ #if LWIP_NETCONN if (MEMP_NUM_NETCONN > (MEMP_NUM_TCP_PCB+MEMP_NUM_TCP_PCB_LISTEN+MEMP_NUM_UDP_PCB+MEMP_NUM_RAW_PCB)) LWIP_PLATFORM_DIAG(("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\n")); #endif /* LWIP_NETCONN */ #if LWIP_TCP if (MEMP_NUM_TCP_SEG < TCP_SND_QUEUELEN) LWIP_PLATFORM_DIAG(("lwip_sanity_check: WARNING: MEMP_NUM_TCP_SEG should be at least as big as TCP_SND_QUEUELEN\n")); if (TCP_SND_BUF < 2 * TCP_MSS) LWIP_PLATFORM_DIAG(("lwip_sanity_check: WARNING: TCP_SND_BUF must be at least as much as (2 * TCP_MSS) for things to work smoothly\n")); if (TCP_SND_QUEUELEN < (2 * (TCP_SND_BUF/TCP_MSS))) LWIP_PLATFORM_DIAG(("lwip_sanity_check: WARNING: TCP_SND_QUEUELEN must be at least as much as (2 * TCP_SND_BUF/TCP_MSS) for things to work\n")); if (TCP_SNDLOWAT >= TCP_SND_BUF) LWIP_PLATFORM_DIAG(("lwip_sanity_check: WARNING: TCP_SNDLOWAT must be less than TCP_SND_BUF.\n")); if (TCP_SNDQUEUELOWAT >= TCP_SND_QUEUELEN) LWIP_PLATFORM_DIAG(("lwip_sanity_check: WARNING: TCP_SNDQUEUELOWAT must be less than TCP_SND_QUEUELEN.\n")); if (TCP_WND > (PBUF_POOL_SIZE*PBUF_POOL_BUFSIZE)) LWIP_PLATFORM_DIAG(("lwip_sanity_check: WARNING: TCP_WND is larger than space provided by PBUF_POOL_SIZE*PBUF_POOL_BUFSIZE\n")); if (TCP_WND < TCP_MSS) LWIP_PLATFORM_DIAG(("lwip_sanity_check: WARNING: TCP_WND is smaller than MSS\n")); #endif /* LWIP_TCP */ #if LWIP_SOCKET /* Check that the SO_* socket options and SOF_* lwIP-internal flags match */ if (SO_ACCEPTCONN != SOF_ACCEPTCONN) LWIP_PLATFORM_DIAG(("lwip_sanity_check: WARNING: SO_ACCEPTCONN != SOF_ACCEPTCONN\n")); if (SO_REUSEADDR != SOF_REUSEADDR) LWIP_PLATFORM_DIAG(("lwip_sanity_check: WARNING: SO_REUSEADDR != SOF_REUSEADDR\n")); if (SO_KEEPALIVE != SOF_KEEPALIVE) LWIP_PLATFORM_DIAG(("lwip_sanity_check: WARNING: SO_KEEPALIVE != SOF_KEEPALIVE\n")); if (SO_BROADCAST != SOF_BROADCAST) LWIP_PLATFORM_DIAG(("lwip_sanity_check: WARNING: SO_BROADCAST != SOF_BROADCAST\n")); if (SO_LINGER != SOF_LINGER) LWIP_PLATFORM_DIAG(("lwip_sanity_check: WARNING: SO_LINGER != SOF_LINGER\n")); #endif /* LWIP_SOCKET */ } #else /* LWIP_DEBUG */ #define lwip_sanity_check() #endif /* LWIP_DEBUG */ /** * Perform Sanity check of user-configurable values, and initialize all modules. */ void lwip_init(void) { MEMP_NUM_TCP_PCB = 5; TCP_WND = (4 * TCP_MSS); TCP_MAXRTX = 12; TCP_SYNMAXRTX = 6; /* Sanity check user-configurable values */ lwip_sanity_check(); /* Modules initialization */ stats_init(); #if !NO_SYS sys_init(); #endif /* !NO_SYS */ #if 0 mem_init(&_bss_end); #endif memp_init(); pbuf_init(); netif_init(); #if LWIP_SOCKET lwip_socket_init(); #endif /* LWIP_SOCKET */ ip_init(); #if LWIP_ARP etharp_init(); #endif /* LWIP_ARP */ #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_SNMP snmp_init(); #endif /* LWIP_SNMP */ #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 LWIP_TIMERS sys_timeouts_init(); #endif /* LWIP_TIMERS */ } ================================================ FILE: app/lwip/core/ipv4/Makefile ================================================ ############################################################# # Required variables for each makefile # Discard this section from all parent makefiles # Expected variables (with automatic defaults): # CSRCS (all "C" files in the dir) # SUBDIRS (all subdirs with a Makefile) # GEN_LIBS - list of libs to be generated () # GEN_IMAGES - list of images to be generated () # COMPONENTS_xxx - a list of libs/objs in the form # subdir/lib to be extracted and rolled up into # a generated lib/image xxx.a () # ifndef PDIR GEN_LIBS = liblwipipv4.a endif ############################################################# # Configuration i.e. compile options etc. # Target specific stuff (defines etc.) goes in here! # Generally values applying to a tree are captured in the # makefile at its root level - these are then overridden # for a subtree within the makefile rooted therein # #DEFINES += ############################################################# # Recursion Magic - Don't touch this!! # # Each subtree potentially has an include directory # corresponding to the common APIs applicable to modules # rooted at that subtree. Accordingly, the INCLUDE PATH # of a module can only contain the include directories up # its parent path, and not its siblings # # Required for each makefile to inherit from the parent # INCLUDES := $(INCLUDES) -I $(PDIR)include INCLUDES += -I ./ PDIR := ../$(PDIR) sinclude $(PDIR)Makefile ================================================ FILE: app/lwip/core/ipv4/autoip.c ================================================ /** * @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_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 /* 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, ip_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); /** * Initialize this module */ void autoip_init(void) { LWIP_DEBUGF(AUTOIP_DEBUG | LWIP_DBG_TRACE, ("autoip_init()\n")); } /** 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 */ os_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, ip_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, IP_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; ip_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_ipaddr(netif, &autoip->llipaddr); netif_set_netmask(netif, &sn_mask); netif_set_gw(netif, &gw_addr); /* bring the interface up */ netif_set_up(netif); 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; if(netif_is_up(netif)) { netif_set_down(netif); } /* Set IP-Address, Netmask and Gateway to 0 to make sure that * ARP Packets are formed correctly */ ip_addr_set_zero(&netif->ip_addr); ip_addr_set_zero(&netif->netmask); ip_addr_set_zero(&netif->gw); 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; } os_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; ip_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 * choosen 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 * accquiring 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) { netif_set_down(netif); autoip_start_probing(netif); } } /** * Stop AutoIP client * * @param netif network interface on which stop the AutoIP client */ err_t autoip_stop(struct netif *netif) { netif->autoip->state = AUTOIP_STATE_OFF; netif_set_down(netif); return ERR_OK; } /** * Has to be called in loop every AUTOIP_TMR_INTERVAL milliseconds */ void autoip_tmr() { 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_up. 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; } } /* 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 */ ip_addr_t sipaddr, dipaddr; struct eth_addr netifaddr; ETHADDR16_COPY(netifaddr.addr, netif->hwaddr); /* Copy struct ip_addr2 to aligned ip_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 ((ip_addr_cmp(&sipaddr, &netif->autoip->llipaddr)) || (ip_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 (ip_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); } } } } #endif /* LWIP_AUTOIP */ ================================================ FILE: app/lwip/core/ipv4/icmp.c ================================================ /** * @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_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 "lwipopts.h" #include "lwip/stats.h" #include "lwip/snmp.h" #include /** 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 ip 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; struct ip_hdr *iphdr; s16_t hlen; ICMP_STATS_INC(icmp.recv); snmp_inc_icmpinmsgs(); iphdr = (struct ip_hdr *)p->payload; hlen = IPH_HL(iphdr) * 4; if (pbuf_header(p, -hlen) || (p->tot_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). */ break; case ICMP_ECHO: #if !LWIP_MULTICAST_PING || !LWIP_BROADCAST_PING { int accepted = 1; #if !LWIP_MULTICAST_PING /* multicast destination address? */ if (ip_addr_ismulticast(¤t_iphdr_dest)) { accepted = 0; } #endif /* LWIP_MULTICAST_PING */ #if !LWIP_BROADCAST_PING /* broadcast destination address? */ if (ip_addr_isbroadcast(¤t_iphdr_dest, inp)) { accepted = 0; } #endif /* LWIP_BROADCAST_PING */ /* broadcast or multicast destination address not acceptd? */ if (!accepted) { LWIP_DEBUGF(ICMP_DEBUG, ("icmp_input: Not echoing to multicast or broadcast pings\n")); ICMP_STATS_INC(icmp.err); pbuf_free(p); return; } } #endif /* !LWIP_MULTICAST_PING || !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 (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); snmp_inc_icmpinerrors(); return; } #if LWIP_ICMP_ECHO_CHECK_INPUT_PBUF_LEN if (pbuf_header(p, (PBUF_IP_HLEN + PBUF_LINK_HLEN))) { /* p is not big enough to contain link headers * allocate a new one and copy p into it */ struct pbuf *r; /* switch p->payload to ip header */ if (pbuf_header(p, hlen)) { LWIP_ASSERT("icmp_input: moving p->payload to ip header failed\n", 0); goto memerr; } /* allocate new packet buffer with space for link headers */ r = pbuf_alloc(PBUF_LINK, p->tot_len, PBUF_RAM); if (r == NULL) { LWIP_DEBUGF(ICMP_DEBUG, ("icmp_input: allocating new pbuf failed\n")); goto memerr; } LWIP_ASSERT("check that first pbuf can hold struct the ICMP header", (r->len >= hlen + sizeof(struct icmp_echo_hdr))); /* copy the whole packet including ip header */ if (pbuf_copy(r, p) != ERR_OK) { LWIP_ASSERT("icmp_input: copying to new pbuf failed\n", 0); goto memerr; } iphdr = (struct ip_hdr *)r->payload; /* switch r->payload back to icmp header */ if (pbuf_header(r, -hlen)) { LWIP_ASSERT("icmp_input: restoring original p->payload failed\n", 0); goto memerr; } /* 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))) { LWIP_ASSERT("icmp_input: restoring original p->payload failed\n", 0); goto memerr; } } #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; ip_addr_copy(iphdr->src, *ip_current_dest_addr()); ip_addr_copy(iphdr->dest, *ip_current_src_addr()); ICMPH_TYPE_SET(iecho, ICMP_ER); /* adjust the checksum */ if (iecho->chksum >= PP_HTONS(0xffff - (ICMP_ECHO << 8))) { iecho->chksum += PP_HTONS(ICMP_ECHO << 8) + 1; } else { iecho->chksum += PP_HTONS(ICMP_ECHO << 8); } /* Set the correct TTL and recalculate the header checksum. */ IPH_TTL_SET(iphdr, ICMP_TTL); IPH_CHKSUM_SET(iphdr, 0); #if 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 */ snmp_inc_icmpoutmsgs(); /* increase number of echo replies attempted to send */ snmp_inc_icmpoutechoreps(); if(pbuf_header(p, hlen)) { LWIP_ASSERT("Can't move over header in packet", 0); } else { err_t ret; /* send an ICMP packet, src addr is the dest addr of the curren packet */ ret = ip_output_if(p, ip_current_dest_addr(), 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: %c.\n", ret)); } } break; default: 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); snmp_inc_icmpinerrors(); return; #if LWIP_ICMP_ECHO_CHECK_INPUT_PBUF_LEN memerr: pbuf_free(p); ICMP_STATS_INC(icmp.err); snmp_inc_icmpinerrors(); return; #endif /* LWIP_ICMP_ECHO_CHECK_INPUT_PBUF_LEN */ } /** * 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) { 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) { 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 ICACHE_FLASH_ATTR 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; ip_addr_t iphdr_src; /* ICMP header + IP header + 8 bytes of data */ //Ϊpbufռ䣬pbufԤIPײ̫ײռ䣬pbuf //=ײ+ݳ(IPײ+8) 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")); 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;//ָIPݰײ LWIP_DEBUGF(ICMP_DEBUG, ("icmp_time_exceeded from ")); ip_addr_debug_print(ICMP_DEBUG, &(iphdr->src)); LWIP_DEBUGF(ICMP_DEBUG, (" to ")); ip_addr_debug_print(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;//ĿIJɴݱʱ icmphdr->seqno = 0;//ģײʣ4ֽڶΪ0 /* copy fields from original packet IPݱIPײ+8ֽݿ*/ SMEMCPY((u8_t *)q->payload + sizeof(struct icmp_echo_hdr), (u8_t *)p->payload, IP_HLEN + ICMP_DEST_UNREACH_DATASIZE); /* calculate checksum */ icmphdr->chksum = 0;//Уֶ0 icmphdr->chksum = inet_chksum(icmphdr, q->len);//дУ ICMP_STATS_INC(icmp.xmit); /* increase number of messages attempted to send */ snmp_inc_icmpoutmsgs(); /* increase number of destination unreachable messages attempted to send */ snmp_inc_icmpouttimeexcds(); ip_addr_copy(iphdr_src, iphdr->src); ip_output(q, NULL, &iphdr_src, ICMP_TTL, 0, IP_PROTO_ICMP);//IP㺯ICMP pbuf_free(q); } #endif /* LWIP_ICMP */ ================================================ FILE: app/lwip/core/ipv4/igmp.c ================================================ /** * @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_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/icmp.h" #include "lwip/udp.h" #include "lwip/tcp.h" #include "lwip/stats.h" #include "string.h" #ifdef MEMLEAK_DEBUG static const char mem_debug_file[] ICACHE_RODATA_ATTR = __FILE__; #endif /* * IGMP constants */ #define IGMP_TTL 1 #define IGMP_MINLEN 8 #define ROUTER_ALERT 0x9404 #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_FIELD(u8_t igmp_msgtype); PACK_STRUCT_FIELD(u8_t igmp_maxresp); PACK_STRUCT_FIELD(u16_t igmp_checksum); PACK_STRUCT_FIELD(ip_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, ip_addr_t *addr)ICACHE_FLASH_ATTR; static err_t igmp_remove_group(struct igmp_group *group)ICACHE_FLASH_ATTR; static void igmp_timeout( struct igmp_group *group)ICACHE_FLASH_ATTR; static void igmp_start_timer(struct igmp_group *group, u8_t max_time)ICACHE_FLASH_ATTR; static void igmp_stop_timer(struct igmp_group *group)ICACHE_FLASH_ATTR; static void igmp_delaying_member(struct igmp_group *group, u8_t maxresp)ICACHE_FLASH_ATTR; static err_t igmp_ip_output_if(struct pbuf *p, ip_addr_t *src, ip_addr_t *dest, struct netif *netif)ICACHE_FLASH_ATTR; static void igmp_send(struct igmp_group *group, u8_t type)ICACHE_FLASH_ATTR; static struct igmp_group* igmp_group_list; static ip_addr_t allsystems; static ip_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); } #ifdef LWIP_DEBUG /** * Dump global IGMP groups list */ void igmp_dump_group_list() { struct igmp_group *group = igmp_group_list; while (group != NULL) { LWIP_DEBUGF(IGMP_DEBUG, ("igmp_dump_group_list: [%"U32_F"] ", (u32_t)(group->group_state))); ip_addr_debug_print(IGMP_DEBUG, &group->group_address); LWIP_DEBUGF(IGMP_DEBUG, (" on if %p\n", group->netif)); group = group->next; } LWIP_DEBUGF(IGMP_DEBUG, ("\n")); } #else #define igmp_dump_group_list() #endif /* LWIP_DEBUG */ /** * 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", 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 ")); ip_addr_debug_print(IGMP_DEBUG, &allsystems); LWIP_DEBUGF(IGMP_DEBUG, (") on if %p\n", 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 ")); ip_addr_debug_print(IGMP_DEBUG, &group->group_address); LWIP_DEBUGF(IGMP_DEBUG, (") on if %p\n", 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", netif)); while (group != NULL) { if (group->netif == netif) { 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, ip_addr_t *addr) { struct igmp_group *group = igmp_group_list; while (group != NULL) { if ((group->netif == ifp) && (ip_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, ip_addr_t *addr) { struct igmp_group *group = igmp_group_list; /* 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; ip_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 "))); ip_addr_debug_print(IGMP_DEBUG, addr); LWIP_DEBUGF(IGMP_DEBUG, (" on if %p\n", 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 ip 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, ip_addr_t *dest) { struct ip_hdr * iphdr; 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 */ iphdr = (struct ip_hdr *)p->payload; if (pbuf_header(p, -(s16_t)(IPH_HL(iphdr) * 4)) || (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 ")); ip_addr_debug_print(IGMP_DEBUG, &(iphdr->src)); LWIP_DEBUGF(IGMP_DEBUG, (" to address ")); ip_addr_debug_print(IGMP_DEBUG, &(iphdr->dest)); LWIP_DEBUGF(IGMP_DEBUG, (" on if %p\n", 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 ((ip_addr_cmp(dest, &allsystems)) && ip_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) && (!(ip_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 (!ip_addr_isany(&igmp->igmp_group_address)) { LWIP_DEBUGF(IGMP_DEBUG, ("igmp_input: IGMP_MEMB_QUERY to a specific group ")); ip_addr_debug_print(IGMP_DEBUG, &igmp->igmp_group_address); if (ip_addr_cmp(dest, &allsystems)) { ip_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 */ ip_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, &group, 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(ip_addr_t *ifaddr, ip_addr_t *groupaddr) { err_t err = ERR_VAL; /* no matching interface */ struct igmp_group *group; struct netif *netif; /* make sure it is multicast address */ LWIP_ERROR("igmp_joingroup: attempt to join non-multicast address", ip_addr_ismulticast(groupaddr), return ERR_VAL;); LWIP_ERROR("igmp_joingroup: attempt to join allsystems address", (!ip_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) && ((ip_addr_isany(ifaddr) || ip_addr_cmp(&(netif->ip_addr), ifaddr)))) { /* 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: join to group not in state IGMP_GROUP_NON_MEMBER\n")); } else { /* OK - it was new group */ LWIP_DEBUGF(IGMP_DEBUG, ("igmp_joingroup: join to new group: ")); ip_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: igmp_mac_filter(ADD ")); ip_addr_debug_print(IGMP_DEBUG, groupaddr); LWIP_DEBUGF(IGMP_DEBUG, (") on if %p\n", 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 */ err = ERR_OK; } else { /* Return an error even if some network interfaces are joined */ /** @todo undo any other netif already joined */ LWIP_DEBUGF(IGMP_DEBUG, ("igmp_joingroup: Not enought memory to join to group\n")); return ERR_MEM; } } /* proceed to next network interface */ netif = netif->next; } return err; } /** * 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(ip_addr_t *ifaddr, ip_addr_t *groupaddr) { err_t err = ERR_VAL; /* no matching interface */ struct igmp_group *group; struct netif *netif; /* make sure it is multicast address */ LWIP_ERROR("igmp_leavegroup: attempt to leave non-multicast address", ip_addr_ismulticast(groupaddr), return ERR_VAL;); LWIP_ERROR("igmp_leavegroup: attempt to leave allsystems address", (!ip_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) && ((ip_addr_isany(ifaddr) || ip_addr_cmp(&(netif->ip_addr), ifaddr)))) { /* 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: Leaving group: ")); ip_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: 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: igmp_mac_filter(DEL ")); ip_addr_debug_print(IGMP_DEBUG, groupaddr); LWIP_DEBUGF(IGMP_DEBUG, (") on if %p\n", netif)); netif->igmp_mac_filter(netif, groupaddr, IGMP_DEL_MAC_FILTER); } LWIP_DEBUGF(IGMP_DEBUG, ("igmp_leavegroup: remove group: ")); ip_addr_debug_print(IGMP_DEBUG, groupaddr); LWIP_DEBUGF(IGMP_DEBUG, ("\n")); /* Free the group */ igmp_remove_group(group); } else { /* Decrement group use */ group->use--; } /* Leave on this interface */ err = ERR_OK; } else { /* It's not a fatal error on "leavegroup" */ LWIP_DEBUGF(IGMP_DEBUG, ("igmp_leavegroup: not member of group\n")); } } /* proceed to next network interface */ netif = netif->next; } return err; } /** * 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 */ if (group->group_state == IGMP_GROUP_DELAYING_MEMBER) { LWIP_DEBUGF(IGMP_DEBUG, ("igmp_timeout: report membership for group with address ")); ip_addr_debug_print(IGMP_DEBUG, &(group->group_address)); LWIP_DEBUGF(IGMP_DEBUG, (" on if %p\n", 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) { /* ensure the input value is > 0 */ if (max_time == 0) { max_time = 1; } /* ensure the random value is > 0 */ group->timer = (LWIP_RAND() % (max_time - 1)) + 1; } /** * Stop a timer for an igmp_group * * @param group the igmp_group for which to stop the timer */ static void igmp_stop_timer(struct igmp_group *group) { group->timer = 0; } /** * 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, ip_addr_t *src, ip_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 ip_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; ip_addr_t src = *IP_ADDR_ANY; ip_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))); ip_addr_copy(src, group->netif->ip_addr); if (type == IGMP_V2_MEMB_REPORT) { dest = &(group->group_address); ip_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; ip_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_IGMP */ ================================================ FILE: app/lwip/core/ipv4/inet.c ================================================ /** * @file * Functions common to all TCP/IPv4 modules, such as the byte order 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.h" ================================================ FILE: app/lwip/core/ipv4/inet_chksum.c ================================================ /** * @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 #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 #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) */ static u16_t ICACHE_FLASH_ATTR lwip_standard_chksum(void *dataptr, u16_t len) { u32_t acc; u16_t src; u8_t *octetptr; acc = 0; /* dataptr may be at odd or even addresses */ octetptr = (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) */ static u16_t ICACHE_FLASH_ATTR lwip_standard_chksum(void *dataptr, int len) { u8_t *pb = (u8_t *)dataptr; u16_t *ps, 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 = (u16_t *)(void *)pb; while (len > 1) { sum += *ps++; len -= 2; } /* Consume left-over byte, if any */ if (len > 0) { ((u8_t *)&t)[0] = *(u8_t *)ps; } /* Add end bytes */ sum += t; /* Fold 32-bit sum to 16 bits calling this twice is propably 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 */ static u16_t ICACHE_FLASH_ATTR lwip_standard_chksum(void *dataptr, int len) { u8_t *pb = (u8_t *)dataptr; u16_t *ps, t = 0; 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 = (u16_t *)pb; if (((mem_ptr_t)ps & 3) && len > 1) { sum += *ps++; len -= 2; } pl = (u32_t *)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 = (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] = *(u8_t *)ps; } sum += t; /* add end bytes */ /* Fold 32-bit sum to 16 bits calling this twice is propably 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 /* inet_chksum_pseudo: * * Calculates the 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, ip_addr_t *src, ip_addr_t *dest, u8_t proto, u16_t proto_len) { u32_t acc; u32_t addr; struct pbuf *q; u8_t swapped; acc = 0; 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); } 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); acc += (u32_t)htons((u16_t)proto); acc += (u32_t)htons(proto_len); /* Fold 32-bit sum to 16 bits calling this twice is propably 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); } /* inet_chksum_pseudo: * * Calculates the 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, ip_addr_t *src, ip_addr_t *dest, u8_t proto, u16_t proto_len, u16_t chksum_len) { u32_t acc; u32_t addr; struct pbuf *q; u8_t swapped; u16_t chklen; acc = 0; swapped = 0; /* 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); } 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); acc += (u32_t)htons((u16_t)proto); acc += (u32_t)htons(proto_len); /* Fold 32-bit sum to 16 bits calling this twice is propably 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); } /* 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(void *dataptr, u16_t len) { return ~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) */ ================================================ FILE: app/lwip/core/ipv4/ip.c ================================================ /** * @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" #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/tcp_impl.h" #include "lwip/snmp.h" #include "lwip/dhcp.h" #include "lwip/autoip.h" #include "lwip/stats.h" #include "arch/perf.h" #include /** 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 #define LWIP_INLINE_IP_CHKSUM 1 #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 * 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(dst_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 interface that provided the packet for the current callback * invocation. */ struct netif *current_netif; /** * Header of the input packet currently being processed. */ const struct ip_hdr *current_header; /** Source IP address of current_header */ ip_addr_t current_iphdr_src; /** Destination IP address of current_header */ ip_addr_t current_iphdr_dest; /** The IP header ID of the next outgoing IP packet */ static u16_t ip_id; /** * 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 * ip_route(ip_addr_t *dest) { struct netif *netif; /* iterate through netifs */ for(netif = netif_list; netif != NULL; netif = netif->next) { /* network mask matches? */ if (netif_is_up(netif)) { if (ip_addr_netcmp(dest, &(netif->ip_addr), &(netif->netmask))) { /* return netif on which to forward IP packet */ return netif; } } } /* iterate through netifs */ for(netif = netif_list; netif != NULL; netif = netif->next) { /* network mask matches? */ if (netif_is_up(netif)) { if (!ip_addr_isbroadcast(dest, netif) && netif == (struct netif *)eagle_lwip_getif(0)) { return netif; } } } if ((netif_default == NULL) || (!netif_is_up(netif_default))) { LWIP_DEBUGF(IP_DEBUG | LWIP_DBG_LEVEL_SERIOUS, ("ip_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); snmp_inc_ipoutnoroutes(); return NULL; } /* no matching netif found, use default netif */ return netif_default; } /** * Finds the appropriate network interface for a source 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 source the sourcination IP address for which to find the route * @return the netif on which to send to reach source */ struct netif *ICACHE_FLASH_ATTR ip_router(ip_addr_t *dest, ip_addr_t *source){ struct netif *netif; /* iterate through netifs */ for(netif = netif_list; netif != NULL; netif = netif->next) { /* network mask matches? */ if (netif_is_up(netif)) { if (ip_addr_netcmp(dest, &(netif->ip_addr), &(netif->netmask))) { /* return netif on which to forward IP packet */ return netif; } } if (netif_is_up(netif)) { if (ip_addr_netcmp(source, &(netif->ip_addr), &(netif->netmask))) { /* return netif on which to forward IP packet */ return netif; } } } if ((netif_default == NULL) || (!netif_is_up(netif_default))) { LWIP_DEBUGF(IP_DEBUG | LWIP_DBG_LEVEL_SERIOUS, ("ip_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); snmp_inc_ipoutnoroutes(); return NULL; } /* no matching netif found, use default netif */ os_printf("ip_router %d %p\n", __LINE__, netif_default); return netif_default; } #if IP_FORWARD /** * 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 ICACHE_FLASH_ATTR ip_forward(struct pbuf *p, struct ip_hdr *iphdr, struct netif *inp) { struct netif *netif; PERF_START; /* RFC3927 2.7: do not forward link-local addresses */ if (ip_addr_islinklocal(¤t_iphdr_dest)) { LWIP_DEBUGF(IP_DEBUG, ("ip_forward: not forwarding LLA %"U16_F".%"U16_F".%"U16_F".%"U16_F"\n", ip4_addr1_16(¤t_iphdr_dest), ip4_addr2_16(¤t_iphdr_dest), ip4_addr3_16(¤t_iphdr_dest), ip4_addr4_16(¤t_iphdr_dest))); goto return_noroute; } /* Find network interface where to forward this IP packet to. */ netif = ip_route(¤t_iphdr_dest); if (netif == NULL) { LWIP_DEBUGF(IP_DEBUG, ("ip_forward: no forwarding route for %"U16_F".%"U16_F".%"U16_F".%"U16_F" found\n", ip4_addr1_16(¤t_iphdr_dest), ip4_addr2_16(¤t_iphdr_dest), ip4_addr3_16(¤t_iphdr_dest), ip4_addr4_16(¤t_iphdr_dest))); goto return_noroute; } /* Do not forward packets onto the same network interface on which * they arrived. */ if (netif == inp) { LWIP_DEBUGF(IP_DEBUG, ("ip_forward: not bouncing packets back on incoming interface.\n")); goto return_noroute; } /* decrement TTL */ IPH_TTL_SET(iphdr, IPH_TTL(iphdr) - 1); /* send ICMP if TTL == 0 */ if (IPH_TTL(iphdr) == 0) { snmp_inc_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(0xffff - 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, ("ip_forward: forwarding packet to %"U16_F".%"U16_F".%"U16_F".%"U16_F"\n", ip4_addr1_16(¤t_iphdr_dest), ip4_addr2_16(¤t_iphdr_dest), ip4_addr3_16(¤t_iphdr_dest), ip4_addr4_16(¤t_iphdr_dest))); IP_STATS_INC(ip.fw); IP_STATS_INC(ip.xmit); snmp_inc_ipforwdatagrams(); PERF_STOP("ip_forward"); /* transmit pbuf on chosen interface */ netif->output(netif, p, ¤t_iphdr_dest); return; return_noroute: snmp_inc_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 ip_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 int check_ip_src=1; #endif /* IP_ACCEPT_LINK_LAYER_ADDRESSING */ IP_STATS_INC(ip.recv); snmp_inc_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))); ip_debug_print(p); pbuf_free(p); IP_STATS_INC(ip.err); IP_STATS_INC(ip.drop); snmp_inc_ipinhdrerrors(); return ERR_OK; } /* 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)); /* 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); snmp_inc_ipindiscards(); return ERR_OK; } /* verify checksum */ #if 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))); ip_debug_print(p); pbuf_free(p); IP_STATS_INC(ip.chkerr); IP_STATS_INC(ip.drop); snmp_inc_ipinhdrerrors(); return ERR_OK; } #endif /* 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, iphdr_len); /* copy IP addresses to aligned ip_addr_t */ ip_addr_copy(current_iphdr_dest, iphdr->dest); ip_addr_copy(current_iphdr_src, iphdr->src); /* match packet against an interface, i.e. is this packet for us? */ #if LWIP_IGMP if (ip_addr_ismulticast(¤t_iphdr_dest)) { if ((inp->flags & NETIF_FLAG_IGMP) && (igmp_lookfor_group(inp, ¤t_iphdr_dest))) { netif = inp; } else { netif = NULL; } } else #endif /* LWIP_IGMP */ { /* 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->ip_addr), ip4_addr_get_u32(&iphdr->dest) & ip4_addr_get_u32(&netif->netmask), ip4_addr_get_u32(&netif->ip_addr) & ip4_addr_get_u32(&netif->netmask), ip4_addr_get_u32(&iphdr->dest) & ~ip4_addr_get_u32(&netif->netmask))); /* interface is up and configured? */ if ((netif_is_up(netif)) && (!ip_addr_isany(&(netif->ip_addr)))) { /* unicast to this interface address? */ if (ip_addr_cmp(¤t_iphdr_dest, &(netif->ip_addr)) || /* or broadcast on this interface network address? */ ip_addr_isbroadcast(¤t_iphdr_dest, netif)) { LWIP_DEBUGF(IP_DEBUG, ("ip_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) && ip_addr_cmp(¤t_iphdr_dest, &(netif->autoip->llipaddr))) { LWIP_DEBUGF(IP_DEBUG, ("ip_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, ("ip_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, ("ip_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 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) */ if (check_ip_src && !ip_addr_isany(¤t_iphdr_src)) #endif /* IP_ACCEPT_LINK_LAYER_ADDRESSING */ { if ((ip_addr_isbroadcast(¤t_iphdr_src, inp)) || (ip_addr_ismulticast(¤t_iphdr_src))) { /* packet source is not valid */ LWIP_DEBUGF(IP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_LEVEL_WARNING, ("ip_input: packet source is not valid.\n")); /* free (drop) packet pbufs */ pbuf_free(p); IP_STATS_INC(ip.drop); snmp_inc_ipinaddrerrors(); snmp_inc_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, ("ip_input: packet not for us.\n")); #if IP_FORWARD /* non-broadcast packet? */ if (!ip_addr_isbroadcast(¤t_iphdr_dest, inp)) { /* try to forward IP packet on (other) interfaces */ ip_forward(p, iphdr, inp); } else #endif /* IP_FORWARD */ { snmp_inc_ipinaddrerrors(); snmp_inc_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 ip_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 = ip_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 */ snmp_inc_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 */ snmp_inc_ipinunknownprotos(); return ERR_OK; } #endif /* IP_OPTIONS_ALLOWED == 0 */ /* send to upper layers */ LWIP_DEBUGF(IP_DEBUG, ("ip_input: \n")); ip_debug_print(p); LWIP_DEBUGF(IP_DEBUG, ("ip_input: p->len %"U16_F" p->tot_len %"U16_F"\n", p->len, p->tot_len)); current_netif = inp; current_header = iphdr; #if LWIP_RAW /* raw input did not eat the packet? */ if (raw_input(p, inp) == 0) #endif /* LWIP_RAW */ { switch (IPH_PROTO(iphdr)) { #if LWIP_UDP case IP_PROTO_UDP: #if LWIP_UDPLITE case IP_PROTO_UDPLITE: #endif /* LWIP_UDPLITE */ snmp_inc_ipindelivers(); udp_input(p, inp); break; #endif /* LWIP_UDP */ #if LWIP_TCP case IP_PROTO_TCP: snmp_inc_ipindelivers(); tcp_input(p, inp); break; #endif /* LWIP_TCP */ #if LWIP_ICMP case IP_PROTO_ICMP: snmp_inc_ipindelivers(); icmp_input(p, inp); break; #endif /* LWIP_ICMP */ #if LWIP_IGMP case IP_PROTO_IGMP: igmp_input(p, inp, ¤t_iphdr_dest); break; #endif /* LWIP_IGMP */ default: #if LWIP_ICMP /* send ICMP destination protocol unreachable unless is was a broadcast */ if (!ip_addr_isbroadcast(¤t_iphdr_dest, inp) && !ip_addr_ismulticast(¤t_iphdr_dest)) { 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); snmp_inc_ipinunknownprotos(); } } current_netif = NULL; current_header = NULL; ip_addr_set_any(¤t_iphdr_src); ip_addr_set_any(¤t_iphdr_dest); 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 ip_output_if(struct pbuf *p, ip_addr_t *src, ip_addr_t *dest, u8_t ttl, u8_t tos, u8_t proto, struct netif *netif) { #if IP_OPTIONS_SEND return ip_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 ip_output_if_opt(struct pbuf *p, ip_addr_t *src, ip_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; ip_addr_t dest_addr; #if CHECKSUM_GEN_IP_INLINE u32_t chk_sum = 0; #endif /* CHECKSUM_GEN_IP_INLINE */ /* 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 */ LWIP_ASSERT("p->ref == 1", p->ref == 1); snmp_inc_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, ("ip_output_if_opt: not enough room for IP options in pbuf\n")); IP_STATS_INC(ip.err); snmp_inc_ipoutdiscards(); return ERR_BUF; } MEMCPY(p->payload, ip_options, optlen); if (optlen < optlen_aligned) { /* zero the remaining bytes */ os_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, ("ip_output: not enough room for IP header in pbuf\n")); IP_STATS_INC(ip.err); snmp_inc_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 */ ip_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_VHLTOS_SET(iphdr, 4, ip_hlen / 4, tos); #if CHECKSUM_GEN_IP_INLINE chk_sum += iphdr->_v_hl_tos; #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 (ip_addr_isany(src)) { ip_addr_copy(iphdr->src, netif->ip_addr); } else { /* src cannot be NULL here */ ip_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; iphdr->_chksum = chk_sum; /* network order */ #else /* CHECKSUM_GEN_IP_INLINE */ IPH_CHKSUM_SET(iphdr, 0); #if CHECKSUM_GEN_IP IPH_CHKSUM_SET(iphdr, inet_chksum(iphdr, ip_hlen)); #endif #endif /* CHECKSUM_GEN_IP_INLINE */ } else { /* IP header already included in p */ iphdr = (struct ip_hdr *)p->payload; ip_addr_copy(dest_addr, iphdr->dest); dest = &dest_addr; } IP_STATS_INC(ip.xmit); LWIP_DEBUGF(IP_DEBUG, ("ip_output_if: %c%c%"U16_F"\n", netif->name[0], netif->name[1], netif->num)); ip_debug_print(p); #if ENABLE_LOOPBACK if (ip_addr_cmp(dest, &netif->ip_addr)) { /* Packet to self, enqueue it for loopback */ LWIP_DEBUGF(IP_DEBUG, ("netif_loop_output()")); return netif_loop_output(netif, p, dest); } #if LWIP_IGMP if ((p->flags & PBUF_FLAG_MCASTLOOP) != 0) { netif_loop_output(netif, p, dest); } #endif /* LWIP_IGMP */ #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 ip_frag(p, netif, dest); } #endif /* IP_FRAG */ LWIP_DEBUGF(IP_DEBUG, ("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 ip_output(struct pbuf *p, ip_addr_t *src, ip_addr_t *dest, u8_t ttl, u8_t tos, u8_t proto) { struct netif *netif; /* 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 */ LWIP_ASSERT("p->ref == 1", p->ref == 1); if ((netif = ip_route(dest)) == NULL) { LWIP_DEBUGF(IP_DEBUG, ("ip_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 ip_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 ip_output_hinted(struct pbuf *p, ip_addr_t *src, ip_addr_t *dest, u8_t ttl, u8_t tos, u8_t proto, u8_t *addr_hint) { struct netif *netif; err_t err; /* 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 */ LWIP_ASSERT("p->ref == 1", p->ref == 1); if ((netif = ip_route(dest)) == NULL) { LWIP_DEBUGF(IP_DEBUG, ("ip_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->addr_hint = addr_hint; err = ip_output_if(p, src, dest, ttl, tos, proto, netif); netif->addr_hint = 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 ip_debug_print(struct pbuf *p) { struct ip_hdr *iphdr = (struct ip_hdr *)p->payload; u8_t *payload; payload = (u8_t *)iphdr + IP_HLEN; 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 */ ================================================ FILE: app/lwip/core/ipv4/ip_addr.c ================================================ /** * @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" #include "lwip/ip_addr.h" #include "lwip/netif.h" /* used by IP_ADDR_ANY and IP_ADDR_BROADCAST in ip_addr.h */ const ip_addr_t ip_addr_any ICACHE_RODATA_ATTR = { IPADDR_ANY }; const ip_addr_t ip_addr_broadcast ICACHE_RODATA_ATTR = { IPADDR_BROADCAST }; /** * 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_t addr, const struct netif *netif) { ip_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->ip_addr)) { return 0; /* on the same (sub) network... */ } else if (ip_addr_netcmp(&ipaddr, &(netif->ip_addr), &(netif->netmask)) /* ...and host identifier bits are all ones? =>... */ && ((addr & ~ip4_addr_get_u32(&netif->netmask)) == (IPADDR_BROADCAST & ~ip4_addr_get_u32(&netif->netmask)))) { /* => 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 = 1U << 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 represenation (e.g. "127.0.0.1") * @return ip address in network order */ u32_t ipaddr_addr(const char *cp) { ip_addr_t val; if (ipaddr_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 represenation (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 ipaddr_aton(const char *cp, ip_addr_t *addr) { u32_t val; u8_t base; char c; char ch; unsigned long cutoff; int cutlim; u32_t parts[4]; u32_t *pp = parts; 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; } 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; } 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) || (parts[0] > 0xff)) { return (0); } val |= parts[0] << 24; break; case 3: /* a.b.c -- 8.8.16 bits */ if ((val > 0xffff) || (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) || (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 * represenation of addr */ char * ipaddr_ntoa(const ip_addr_t *addr) { static char str[16]; return ipaddr_ntoa_r(addr, str, 16); } /** * 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 *ipaddr_ntoa_r(const ip_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; } ================================================ FILE: app/lwip/core/ipv4/ip_frag.c ================================================ /** * @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" #include "lwip/ip_frag.h" #include "lwip/def.h" #include "lwip/inet_chksum.h" #include "lwip/netif.h" #include "lwip/snmp.h" #include "lwip/stats.h" #include "lwip/icmp.h" #include #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) \ (ip_addr_cmp(&(iphdrA)->src, &(iphdrB)->src) && \ ip_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)ICACHE_FLASH_ATTR; static int ip_reass_free_complete_datagram(struct ip_reassdata *ipr, struct ip_reassdata *prev)ICACHE_FLASH_ATTR; /** * 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); } snmp_inc_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; 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; 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; } else if (r->timer <= oldest->timer) { /* older than the previous oldest */ oldest = r; } } if (r->next != NULL) { prev = r; } r = r->next; } if (oldest != NULL) { pbufs_freed_current = ip_reass_free_complete_datagram(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* ICACHE_FLASH_ATTR ip_reass_enqueue_new_datagram(struct ip_hdr *fraghdr, int clen) { struct ip_reassdata* ipr; /* 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; } } os_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 ICACHE_FLASH_ATTR 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_reass 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 ICACHE_FLASH_ATTR 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 on 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 wholes. */ 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 wholes so far */ if (valid) { /* then check if the rest of the fragments is here */ /* Check if the queue starts with the first datagram */ if (((struct ip_reass_helper*)ipr->p->payload)->start != 0) { valid = 0; } else { /* and check that there are no wholes 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 * ip_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; struct ip_reassdata *ipr_prev = NULL; IPFRAG_STATS_INC(ip_frag.recv); snmp_inc_ipreasmreqds(); fraghdr = (struct ip_hdr*)p->payload; if ((IPH_HL(fraghdr) * 4) != IP_HLEN) { LWIP_DEBUGF(IP_REASS_DEBUG,("ip_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,("ip_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, ("ip_reass: matching previous fragment ID=%"X16_F"\n", ntohs(IPH_ID(fraghdr)))); IPFRAG_STATS_INC(ip_frag.cachehit); break; } ipr_prev = ipr; } 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, ("ip_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)) { /* 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? */ IPH_CHKSUM_SET(fraghdr, inet_chksum(fraghdr, IP_HLEN)); 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 succeding fragment */ pbuf_header(r, -IP_HLEN); pbuf_cat(p, r); r = iprh->next_pbuf; } /* 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); /* 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,("ip_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* ICACHE_FLASH_ATTR 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 ICACHE_FLASH_ATTR 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 ICACHE_FLASH_ATTR 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 ip_frag(struct pbuf *p, struct netif *netif, ip_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")); return ERR_MEM; } 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) { return ERR_MEM; } 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); return ERR_MEM; } /* fill in the IP header */ SMEMCPY(rambuf->payload, original_iphdr, IP_HLEN); iphdr = 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) { return ERR_MEM; } 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); 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) { ip_frag_free_pbuf_custom_ref(pcr); pbuf_free(rambuf); return ERR_MEM; } 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); IPH_CHKSUM_SET(iphdr, inet_chksum(iphdr, IP_HLEN)); #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); snmp_inc_ipfragcreates(); pbuf_free(header); } else { LWIP_DEBUGF(IP_REASS_DEBUG, ("ip_frag: pbuf_alloc() for header failed\n")); pbuf_free(rambuf); return ERR_MEM; } #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 */ snmp_inc_ipfragoks(); return ERR_OK; } #endif /* IP_FRAG */ ================================================ FILE: app/lwip/core/mdns.c ================================================ /** * lwip MDNS resolver file. * * Created on: Jul 29, 2010 * Author: Daniel Toma * * 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. */ /** * This file implements a MDNS host name and PUCK service registration. *----------------------------------------------------------------------------- * Includes *----------------------------------------------------------------------------*/ #include "lwip/opt.h" #if LWIP_MDNS /* don't build if not configured for use in lwipopts.h */ #include "lwip/mdns.h" #include "lwip/puck_def.h" #include "lwip/udp.h" #include "lwip/mem.h" #include "lwip/igmp.h" #include "osapi.h" #include "os_type.h" #include "user_interface.h" #ifdef MEMLEAK_DEBUG static const char mem_debug_file[] ICACHE_RODATA_ATTR = __FILE__; #endif /** DNS server IP address */ #ifndef DNS_MULTICAST_ADDRESS #define DNS_MULTICAST_ADDRESS ipaddr_addr("224.0.0.251") /* resolver1.opendns.com */ #endif /** DNS server IP address */ #ifndef MDNS_LOCAL #define MDNS_LOCAL "local" /* resolver1.opendns.com */ #endif /** DNS server port address */ #ifndef DNS_MDNS_PORT #define DNS_MDNS_PORT 5353 #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 /* DNS protocol flags */ #define DNS_FLAG1_RESPONSE 0x84 #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 /* MDNS registration type */ #define MDNS_HOSTNAME_REG 0 #define MDNS_SERVICE_REG 1 /* MDNS registration type */ #define MDNS_REG_ANSWER 1 #define MDNS_SD_ANSWER 2 #define MDNS_SERVICE_REG_ANSWER 3 /* MDNS registration time */ #define MDNS_HOST_TIME 120 #define MDNS_SERVICE_TIME 3600 /** MDNS name length with "." at the beginning and end of name*/ #ifndef MDNS_LENGTH_ADD #define MDNS_LENGTH_ADD 2 #endif #ifdef MDNS_MAX_NAME_LENGTH #undef MDNS_MAX_NAME_LENGTH #endif #define MDNS_MAX_NAME_LENGTH (256) PACK_STRUCT_BEGIN /** DNS message header */ struct mdns_hdr { PACK_STRUCT_FIELD(u16_t id); PACK_STRUCT_FIELD(u8_t flags1); PACK_STRUCT_FIELD(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 #define SIZEOF_DNS_HDR 12 PACK_STRUCT_BEGIN /** MDNS query message structure */ struct mdns_query { /* MDNS query record starts with either a domain name or a pointer to a name already present somewhere in the packet. */PACK_STRUCT_FIELD(u16_t type); PACK_STRUCT_FIELD(u16_t class); }PACK_STRUCT_STRUCT; PACK_STRUCT_END #define SIZEOF_DNS_QUERY 4 PACK_STRUCT_BEGIN /** MDNS answer message structure */ struct mdns_answer { /* MDNS answer record starts with either a domain name or a pointer to a name already present somewhere in the packet. */PACK_STRUCT_FIELD(u16_t type); PACK_STRUCT_FIELD(u16_t class); PACK_STRUCT_FIELD(u32_t ttl); PACK_STRUCT_FIELD(u16_t len); }PACK_STRUCT_STRUCT; PACK_STRUCT_END #define SIZEOF_DNS_ANSWER 10 PACK_STRUCT_BEGIN /** MDNS answer message structure */ struct mdns_auth { PACK_STRUCT_FIELD(u32_t src); }PACK_STRUCT_STRUCT; PACK_STRUCT_END #define SIZEOF_MDNS_AUTH 4 PACK_STRUCT_BEGIN /** MDNS service registration message structure */ struct mdns_service { PACK_STRUCT_FIELD(u16_t prior); PACK_STRUCT_FIELD(u16_t weight); PACK_STRUCT_FIELD(u16_t port); }PACK_STRUCT_STRUCT; PACK_STRUCT_END #define SIZEOF_MDNS_SERVICE 6 uint16 PUCK_PORT ; os_timer_t mdns_timer; /* forward declarations */ static void mdns_recv(void *s, struct udp_pcb *pcb, struct pbuf *p, struct ip_addr *addr, u16_t port); /*----------------------------------------------------------------------------- * Globales *----------------------------------------------------------------------------*/ /* MDNS variables */ static char host_name[MDNS_NAME_LENGTH]; static char service_name[MDNS_NAME_LENGTH]; static char server_name[MDNS_NAME_LENGTH]; //static char puck_datasheet[PUCK_DATASHEET_SIZE]; static struct udp_pcb *mdns_pcb; static struct ip_addr multicast_addr; static struct ip_addr host_addr; static uint8 register_flag = 0; static uint8 mdns_flag = 0; //#if (DNS_USES_STATIC_BUF == 1) static u8_t mdns_payload[DNS_MSG_SIZE]; //#endif /* (MDNS_USES_STATIC_BUF == 1) */ /* * Function to set the UDP pcb used to send the mDNS packages */ void ICACHE_FLASH_ATTR getPcb(struct udp_pcb *pcb) { mdns_pcb = pcb; } #if DNS_DOES_NAME_CHECK /** * Compare the "dotted" name "query" with the encoded name "response" * to make sure an answer from the DNS server matches the current mdns_table * entry (otherwise, answers might arrive late for hostname not on the list * any more). * * @param query hostname (not encoded) from the mdns_table * @param response encoded hostname in the DNS response * @return 0: names equal; 1: names differ */ static u8_t ICACHE_FLASH_ATTR mdns_compare_name(unsigned char *query, unsigned char *response) { unsigned char n; do { n = *response++; /** @see RFC 1035 - 4.1.4. Message compression */ if ((n & 0xc0) == 0xc0) { /* Compressed name */ break; } else { /* Not compressed name */ while (n > 0) { if ((*query) != (*response)) { return 1; } ++response; ++query; --n; }; ++query; } } while (*response != 0); return 0; } #endif /* DNS_DOES_NAME_CHECK */ /** * Send a mDNS answer packet. * * @param type of answer hostname and service registration or service * @param name to query * @param id transaction ID in the DNS query packet * @return ERR_OK if packet is sent; an err_t indicating the problem otherwise */ static err_t ICACHE_FLASH_ATTR mdns_answer(u16_t type, const char* name, u8_t id) { err_t err; struct mdns_hdr *hdr; struct mdns_answer ans; struct mdns_auth auth; struct mdns_service serv; struct pbuf *p ,*p_sta; char *query, *nptr; const char *pHostname; struct netif * sta_netif = NULL; struct netif * ap_netif = NULL; static char tmpBuf[PUCK_DATASHEET_SIZE + PUCK_SERVICE_LENGTH]; u8_t n; u16_t length = 0; /* if here, we have either a new query or a retry on a previous query to process */ p = pbuf_alloc(PBUF_TRANSPORT, SIZEOF_DNS_HDR + MDNS_MAX_NAME_LENGTH * 2 + SIZEOF_DNS_QUERY, PBUF_RAM); if (p != NULL) { LWIP_ASSERT("pbuf must be in one piece", p->next == NULL); /* fill dns header */ hdr = (struct mdns_hdr*) p->payload; os_memset(hdr, 0, SIZEOF_DNS_HDR); hdr->id = htons(id); hdr->flags1 = DNS_FLAG1_RESPONSE; if (type == MDNS_SD_ANSWER) { pHostname = DNS_SD_SERVICE; hdr->numanswers = htons(1); } else if (type == MDNS_SERVICE_REG_ANSWER) { pHostname = PUCK_SERVICE; hdr->numanswers = htons(type); } else { pHostname = name; hdr->numanswers = htons(type); } query = (char*) hdr + SIZEOF_DNS_HDR; --pHostname; /* convert hostname into suitable query format. */ do { ++pHostname; nptr = query; ++query; for (n = 0; *pHostname != '.' && *pHostname != 0; ++pHostname) { *query = *pHostname; ++query; ++n; } *nptr = n; } while (*pHostname != 0); *query++ = '\0'; /* fill dns query */ if (type == MDNS_REG_ANSWER) { ans.type = htons(DNS_RRTYPE_A); ans.class = htons(DNS_RRCLASS_IN); ans.ttl = htonl(MDNS_SERVICE_TIME); ans.len = htons(DNS_IP_ADDR_LEN); length = DNS_IP_ADDR_LEN; MEMCPY( query, &ans, SIZEOF_DNS_ANSWER); /* resize the query */ query = query + SIZEOF_DNS_ANSWER; /* set the local IP address */ auth.src = host_addr.addr; MEMCPY( query, &auth, SIZEOF_MDNS_AUTH); } if (type == MDNS_SD_ANSWER) { ans.type = htons(DNS_RRTYPE_PTR); ans.class = htons(DNS_RRCLASS_IN); ans.ttl = htonl(300); ans.len = htons(os_strlen(PUCK_SERVICE) + 1 +1 ); length = 0; MEMCPY( query, &ans, SIZEOF_DNS_ANSWER); /* resize the query */ query = query + SIZEOF_DNS_ANSWER; pHostname = PUCK_SERVICE; --pHostname; /* convert hostname into suitable query format. */ do { ++pHostname; nptr = query; ++query; for (n = 0; *pHostname != '.' && *pHostname != 0; ++pHostname) { *query = *pHostname; ++query; ++n; } *nptr = n; } while (*pHostname != 0); *query++ = '\0'; } if (type == MDNS_SERVICE_REG_ANSWER) { ans.type = htons(DNS_RRTYPE_PTR); ans.class = htons(DNS_RRCLASS_IN); ans.ttl = htonl(MDNS_SERVICE_TIME); os_strcpy(tmpBuf, name); os_strcat(tmpBuf, "."); os_strcat(tmpBuf, PUCK_SERVICE); length = os_strlen(tmpBuf) + MDNS_LENGTH_ADD; ans.len = htons(length); length = 0; MEMCPY( query, &ans, SIZEOF_DNS_ANSWER); /* resize the query */ query = query + SIZEOF_DNS_ANSWER; pHostname = tmpBuf; --pHostname; /* convert hostname into suitable query format. */ do { ++pHostname; nptr = query; ++query; for (n = 0; *pHostname != '.' && *pHostname != 0; ++pHostname) { *query = *pHostname; ++query; ++n; } *nptr = n; } while (*pHostname != 0); *query++ = '\0'; /* Service query*/ pHostname = name; --pHostname; /* convert hostname into suitable query format. */ do { ++pHostname; nptr = query; ++query; for (n = 0; *pHostname != '.' && *pHostname != 0; ++pHostname) { *query = *pHostname; ++query; ++n; } *nptr = n; } while (*pHostname != 0); /* Add to the service name the service local * pointing to the beginning of the mDNS message*/ *query++ = DNS_OFFSET_FLAG; *query++ = DNS_DEFAULT_OFFSET; /* fill the query */ ans.type = htons(DNS_RRTYPE_SRV); ans.class = htons(DNS_RRCLASS_FLUSH_IN); ans.ttl = htonl(MDNS_SERVICE_TIME); os_strcpy(tmpBuf, host_name); os_strcat(tmpBuf, "."); os_strcat(tmpBuf, MDNS_LOCAL); length = os_strlen(tmpBuf) + MDNS_LENGTH_ADD; ans.len = htons(SIZEOF_MDNS_SERVICE + length); length = 0; MEMCPY( query, &ans, SIZEOF_DNS_ANSWER); /* resize the query */ query = query + SIZEOF_DNS_ANSWER; /* fill the service properties */ serv.prior = htons(0); serv.weight = htons(0); serv.port = htons(PUCK_PORT); MEMCPY( query, &serv, SIZEOF_MDNS_SERVICE); /* resize the query */ query = query + SIZEOF_MDNS_SERVICE; pHostname = tmpBuf; --pHostname; /* convert hostname into suitable query format. */ do { ++pHostname; nptr = query; ++query; for (n = 0; *pHostname != '.' && *pHostname != 0; ++pHostname) { *query = *pHostname; ++query; ++n; } *nptr = n; } while (*pHostname != 0); *query++ = '\0'; /* TXT answer */ pHostname = name; --pHostname; /* convert hostname into suitable query format. */ do { ++pHostname; nptr = query; ++query; for (n = 0; *pHostname != '.' && *pHostname != 0; ++pHostname) { *query = *pHostname; ++query; ++n; } *nptr = n; } while (*pHostname != 0); /* Add to the service name the service local * pointing to the beginning of the mDNS message*/ *query++ = DNS_OFFSET_FLAG; *query++ = DNS_DEFAULT_OFFSET; /* fill the answer */ ans.type = htons(DNS_RRTYPE_TXT); ans.class = htons(DNS_RRCLASS_IN); ans.ttl = htonl(MDNS_SERVICE_TIME); length = sizeof(SERVICE_DESCRIPTION); ans.len = htons(length); length = 0; MEMCPY( query, &ans, SIZEOF_DNS_ANSWER); /* resize the query */ query = query + SIZEOF_DNS_ANSWER; pHostname = SERVICE_DESCRIPTION; --pHostname; /* convert hostname into suitable query format. */ do { ++pHostname; nptr = query; ++query; for (n = 0; *pHostname != '.' && *pHostname != 0; ++pHostname) { *query = *pHostname; ++query; ++n; } *nptr = n; } while (*pHostname != 0); *query++ = '\0'; } /* resize pbuf to the exact dns query */ pbuf_realloc(p, (query + length) - ((char*) (p->payload))); /* send dns packet */ /*add by tzx for AP + STA MDNS begin------*/ sta_netif = (struct netif *)eagle_lwip_getif(0x00); ap_netif = (struct netif *)eagle_lwip_getif(0x01); if(wifi_get_opmode() == 0x03 && wifi_get_broadcast_if() == 0x03 &&\ sta_netif != NULL && ap_netif != NULL) { if(netif_is_up(sta_netif) && netif_is_up(ap_netif)) { p_sta = pbuf_alloc(PBUF_TRANSPORT, SIZEOF_DNS_HDR + MDNS_MAX_NAME_LENGTH * 2 + SIZEOF_DNS_QUERY, PBUF_RAM); if (pbuf_copy (p_sta,p) != ERR_OK) { os_printf("mdns_answer copying to new pbuf failed\n"); return -1; } netif_set_default(sta_netif); err = udp_sendto(mdns_pcb, p_sta, &multicast_addr, DNS_MDNS_PORT); pbuf_free(p_sta); netif_set_default(ap_netif); } } /*add by tzx for AP + STA MDNS end------*/ err = udp_sendto(mdns_pcb, p, &multicast_addr, DNS_MDNS_PORT); /* free pbuf */ pbuf_free(p); } else { err = ERR_MEM; } return err; } /** * Send a mDNS service answer packet. * * @param name service name to query * @param id transaction ID in the DNS query packet * @return ERR_OK if packet is sent; an err_t indicating the problem otherwise */ static err_t ICACHE_FLASH_ATTR mdns_send_service(struct mdns_info *info, u8_t id) { err_t err; struct mdns_hdr *hdr; struct mdns_answer ans; struct mdns_service serv; struct mdns_auth auth; struct pbuf *p ,*p_sta; char *query, *nptr; const char *pHostname; char *device_info; const char *name = info->host_name; u8_t n; u8_t i = 0; u16_t length = 0; u8_t addr1 = 12, addr2 = 12; struct netif * sta_netif = NULL; struct netif * ap_netif = NULL; static char tmpBuf[PUCK_DATASHEET_SIZE + PUCK_SERVICE_LENGTH]; /* if here, we have either a new query or a retry on a previous query to process */ p = pbuf_alloc(PBUF_TRANSPORT, SIZEOF_DNS_HDR + MDNS_MAX_NAME_LENGTH * 2 + SIZEOF_DNS_QUERY, PBUF_RAM); if (p != NULL) { LWIP_ASSERT("pbuf must be in one piece", p->next == NULL); /* fill dns header */ hdr = (struct mdns_hdr*) p->payload; os_memset(hdr, 0, SIZEOF_DNS_HDR); hdr->id = htons(id); hdr->flags1 = DNS_FLAG1_RESPONSE; hdr->numanswers = htons(4); query = (char*) hdr + SIZEOF_DNS_HDR; os_strcpy(tmpBuf, PUCK_SERVICE); pHostname = tmpBuf; --pHostname; /* convert hostname into suitable query format. */ do { ++pHostname; nptr = query; ++query; ++addr1; ++addr2; for (n = 0; *pHostname != '.' && *pHostname != 0; ++pHostname) { *query = *pHostname; ++query; ++addr1; ++addr2; ++n; } *nptr = n; } while (*pHostname != 0); *query++ = '\0'; length = sizeof(MDNS_LOCAL); addr1 -= length; length = os_strlen(PUCK_SERVICE) + 1; addr2 -= length; ans.type = htons(DNS_RRTYPE_PTR); ans.class = htons(DNS_RRCLASS_IN); ans.ttl = htonl(300); os_strcpy(tmpBuf, name); length = os_strlen(tmpBuf) + MDNS_LENGTH_ADD + 1; ans.len = htons(length); length = 0; MEMCPY( query, &ans, SIZEOF_DNS_ANSWER); /* resize the query */ query = query + SIZEOF_DNS_ANSWER; pHostname = tmpBuf; --pHostname; /* convert hostname into suitable query format. */ do { ++pHostname; nptr = query; ++query; for (n = 0; *pHostname != '.' && *pHostname != 0; ++pHostname) { *query = *pHostname; ++query; ++n; } *nptr = n; } while (*pHostname != 0); *query++ = DNS_OFFSET_FLAG; *query++ = DNS_DEFAULT_OFFSET; pHostname = name; --pHostname; /* convert hostname into suitable query format. */ do { ++pHostname; nptr = query; ++query; for (n = 0; *pHostname != '.' && *pHostname != 0; ++pHostname) { *query = *pHostname; ++query; ++n; } *nptr = n; } while (*pHostname != 0); //*query++ = '\0'; *query++ = DNS_OFFSET_FLAG; *query++ = DNS_DEFAULT_OFFSET; /* fill the answer */ ans.type = htons(DNS_RRTYPE_TXT); ans.class = htons(DNS_RRCLASS_FLUSH_IN); ans.ttl = htonl(300); // length = os_strlen(TXT_DATA) + MDNS_LENGTH_ADD + 1; device_info = (char *)os_zalloc(50); ets_sprintf(device_info,"vendor = %s","Espressif"); for(i = 0; i < 10 &&(info->txt_data[i] != NULL);i++) { length += os_strlen(info->txt_data[i]); length++; } length += os_strlen(device_info)+ 1 ; ans.len = htons(length); length = 0; MEMCPY( query, &ans, SIZEOF_DNS_ANSWER); query = query + SIZEOF_DNS_ANSWER; pHostname = device_info; --pHostname; /* convert hostname into suitable query format. */ do { ++pHostname; nptr = query; ++query; for (n = 0; *pHostname != 0; ++pHostname) { *query = *pHostname; ++query; ++n; } *nptr = n; } while (*pHostname != 0); i = 0; while(info->txt_data[i] != NULL && i < 10) { pHostname = info->txt_data[i]; --pHostname; /* convert hostname into suitable query format. */ do { ++pHostname; nptr = query; ++query; for (n = 0; *pHostname != 0; ++pHostname) { *query = *pHostname; ++query; ++n; } *nptr = n; } while (*pHostname != 0); i++; } // *query++ = '\0'; os_free(device_info); os_strcpy(tmpBuf, name); pHostname = tmpBuf; --pHostname; do { ++pHostname; nptr = query; ++query; for (n = 0; *pHostname != '.' && *pHostname != 0; ++pHostname) { *query = *pHostname; ++query; ++n; } *nptr = n; } while (*pHostname != 0); *query++ = DNS_OFFSET_FLAG; *query++ = DNS_DEFAULT_OFFSET; ans.type = htons(DNS_RRTYPE_SRV); ans.class = htons(DNS_RRCLASS_FLUSH_IN); ans.ttl = htonl(300); os_strcpy(tmpBuf,service_name); os_strcat(tmpBuf, "."); os_strcat(tmpBuf, MDNS_LOCAL); length = os_strlen(tmpBuf) + MDNS_LENGTH_ADD; ans.len = htons(SIZEOF_MDNS_SERVICE + length); length = 0; MEMCPY( query, &ans, SIZEOF_DNS_ANSWER); /* resize the query */ query = query + SIZEOF_DNS_ANSWER; serv.prior = htons(0); serv.weight = htons(0); serv.port = htons(PUCK_PORT); MEMCPY( query, &serv, SIZEOF_MDNS_SERVICE); /* resize the query */ query = query + SIZEOF_MDNS_SERVICE; pHostname = tmpBuf; --pHostname; do { ++pHostname; nptr = query; ++query; for (n = 0; *pHostname != '.' && *pHostname != 0; ++pHostname) { *query = *pHostname; ++query; ++n; } *nptr = n; } while (*pHostname != 0); *query++ = '\0'; /* set the name of the authority field. * The same name as the Query using the offset address*/ os_strcpy(tmpBuf,service_name); os_strcat(tmpBuf, "."); os_strcat(tmpBuf, MDNS_LOCAL); pHostname = tmpBuf; --pHostname; do { ++pHostname; nptr = query; ++query; for (n = 0; *pHostname != '.' && *pHostname != 0; ++pHostname) { *query = *pHostname; ++query; ++n; } *nptr = n; } while (*pHostname != 0); *query++ = '\0'; /* set the name of the authority field. * The same name as the Query using the offset address*/ //*query++ = DNS_OFFSET_FLAG; //*query++ = DNS_DEFAULT_OFFSET; ans.type = htons(DNS_RRTYPE_A); ans.class = htons(DNS_RRCLASS_FLUSH_IN); ans.ttl = htonl(300); ans.len = htons(DNS_IP_ADDR_LEN); MEMCPY( query, &ans, SIZEOF_DNS_ANSWER); /* resize the query */ query = query + SIZEOF_DNS_ANSWER; /* fill the payload of the mDNS message */ /* set the local IP address */ auth.src = host_addr.addr; //ipAddr; MEMCPY( query, &auth, SIZEOF_MDNS_AUTH); /* resize the query */ query = query + SIZEOF_MDNS_AUTH; /* set the name of the authority field. * The same name as the Query using the offset address*/ /* resize pbuf to the exact dns query */ pbuf_realloc(p, (query) - ((char*) (p->payload))); /* send dns packet */ sta_netif = (struct netif *)eagle_lwip_getif(0x00); ap_netif = (struct netif *)eagle_lwip_getif(0x01); if(wifi_get_opmode() == 0x03 && wifi_get_broadcast_if() == 0x03 &&\ sta_netif != NULL && ap_netif != NULL) { if(netif_is_up(sta_netif) && netif_is_up(ap_netif)) { p_sta = pbuf_alloc(PBUF_TRANSPORT, SIZEOF_DNS_HDR + MDNS_MAX_NAME_LENGTH * 2 + SIZEOF_DNS_QUERY, PBUF_RAM); if (pbuf_copy (p_sta,p) != ERR_OK) { os_printf("mdns_send_service copying to new pbuf failed\n"); return -1; } netif_set_default(sta_netif); err = udp_sendto(mdns_pcb, p_sta, &multicast_addr, DNS_MDNS_PORT); pbuf_free(p_sta); netif_set_default(ap_netif); } } err = udp_sendto(mdns_pcb, p, &multicast_addr, DNS_MDNS_PORT); /* free pbuf */ pbuf_free(p); } else { os_printf("ERR_MEM \n"); err = ERR_MEM; } return err; } /** * Receive input function for DNS response packets arriving for the dns UDP pcb. * * @params see udp.h */ static void ICACHE_FLASH_ATTR mdns_recv(void *arg, struct udp_pcb *pcb, struct pbuf *p, struct ip_addr *addr, u16_t port) { u8_t i; struct mdns_hdr *hdr; u8_t nquestions; LWIP_UNUSED_ARG(arg); LWIP_UNUSED_ARG(pcb); LWIP_UNUSED_ARG(addr); LWIP_UNUSED_ARG(port); struct mdns_info *info = (struct mdns_info *)arg; /* is the dns message too big ? */ if (p->tot_len > DNS_MSG_SIZE) { LWIP_DEBUGF(DNS_DEBUG, ("dns_recv: pbuf too big\n")); /* free pbuf and return */ goto memerr1; } /* is the dns message big enough ? */ if (p->tot_len < (SIZEOF_DNS_HDR + SIZEOF_DNS_QUERY + SIZEOF_DNS_ANSWER)) { LWIP_DEBUGF(DNS_DEBUG, ("dns_recv: pbuf too small\n")); /* free pbuf and return */ goto memerr1; } /* copy dns payload inside static buffer for processing */ if (pbuf_copy_partial(p, mdns_payload, p->tot_len, 0) == p->tot_len) { /* The ID in the DNS header should be our entry into the name table. */ hdr = (struct mdns_hdr*) mdns_payload; i = htons(hdr->id); if (i < DNS_TABLE_SIZE) { nquestions = htons(hdr->numquestions); //nanswers = htons(hdr->numanswers); /* if we have a question send an answer if necessary */ if (nquestions > 0) { /* MDNS_DS_DOES_NAME_CHECK */ /* Check if the name in the "question" part match with the name of the MDNS DS service. */ if (mdns_compare_name((unsigned char *) DNS_SD_SERVICE, (unsigned char *) mdns_payload + SIZEOF_DNS_HDR) == 0) { /* respond with the puck service*/ mdns_answer(MDNS_SD_ANSWER, PUCK_SERVICE, 0); } else if (mdns_compare_name((unsigned char *) PUCK_SERVICE, (unsigned char *) mdns_payload + SIZEOF_DNS_HDR) == 0) { /* respond with the puck service*/ mdns_send_service(info, 0); } else goto memerr2; } } } goto memerr2; memerr2: mem_free(mdns_payload); memerr1: /* free pbuf */ pbuf_free(p); return; } /** * close the UDP pcb . */ void ICACHE_FLASH_ATTR mdns_close(void) { if (mdns_pcb != NULL) udp_remove(mdns_pcb); } void ICACHE_FLASH_ATTR mdns_set_name(const char *name) { //strcpy(host_name, name); os_strcpy(service_name, name); } void ICACHE_FLASH_ATTR mdns_enable(void) { if(mdns_flag == 0) { udp_recv(mdns_pcb, mdns_recv, NULL); } } void ICACHE_FLASH_ATTR mdns_disable(void) { if (mdns_flag == 1) { udp_recv(mdns_pcb, NULL, NULL); } } /** * close the UDP pcb . */ char* ICACHE_FLASH_ATTR mdns_get_hostname(void) { //strcpy(host_name, name); char *name = host_name; if (host_name[0] != 0 ) { return name; } else { return ("Espressif"); } } void ICACHE_FLASH_ATTR mdns_set_hostname(char *name) { if (name == NULL) { os_strncpy(host_name, "Espressif", os_strlen("Espressif")+3); return; } if (os_strlen(name) + 3 <= MDNS_NAME_LENGTH ){ os_strncpy(host_name, name, os_strlen(name) ); // os_memset(host_name + os_strlen(host_name) ,0x00,3); } else { os_strncpy(host_name, name, MDNS_NAME_LENGTH); } } void ICACHE_FLASH_ATTR mdns_set_servername(const char *name) { if (name == NULL) { PUCK_SERVICE = "_Espressif._tcp._local"; }else { os_sprintf(server_name ,"_%s._tcp.local",name); PUCK_SERVICE = server_name; } } char* ICACHE_FLASH_ATTR mdns_get_servername(void) { char *name = PUCK_SERVICE; if (name == NULL) { PUCK_SERVICE = "_Espressif._tcp._local"; } return name; } void ICACHE_FLASH_ATTR mdns_server_unregister(void) { struct ip_addr ap_host_addr; struct ip_info ipconfig; if(register_flag == 1){ if (igmp_leavegroup(&host_addr, &multicast_addr) != ERR_OK) { os_printf("sta udp_leave_multigrup failed!\n"); return; }; if(wifi_get_opmode() == 0x03 || wifi_get_opmode() == 0x02) { wifi_get_ip_info(SOFTAP_IF, &ipconfig); ap_host_addr.addr = ipconfig.ip.addr; if (igmp_leavegroup(&ap_host_addr, &multicast_addr) != ERR_OK) { os_printf("ap udp_join_multigrup failed!\n"); return; }; } register_flag = 0; } } void ICACHE_FLASH_ATTR mdns_server_register(void) { if (register_flag == 1) { os_printf("mdns server is already registered !\n"); return; } else if (igmp_joingroup(&host_addr, &multicast_addr) != ERR_OK) { os_printf("udp_join_multigrup failed!\n"); return; }; register_flag = 1; } void ICACHE_FLASH_ATTR mdns_reg(struct mdns_info *info) { static uint8 i = 0; if (i <= 3) { mdns_send_service(info,0); i++; } else { os_timer_disarm(&mdns_timer); } } /** * Initialize the resolver: set up the UDP pcb and configure the default server * (NEW IP). */ void ICACHE_FLASH_ATTR mdns_init(struct mdns_info *info) { /* initialize default DNS server address */ multicast_addr.addr = DNS_MULTICAST_ADDRESS; struct ip_addr ap_host_addr; struct ip_info ipconfig; if (info->ipAddr == 0) { os_printf("mdns ip error!\n "); return; } host_addr.addr = info->ipAddr ; LWIP_DEBUGF(DNS_DEBUG, ("dns_init: initializing\n")); //get the datasheet from PUCK mdns_set_hostname(info->host_name); mdns_set_servername(info->server_name); mdns_set_name(info->host_name); // get the host name as instrumentName_serialNumber for MDNS // set the name of the service, the same as host name os_printf("host_name = %s\n", host_name); os_printf("server_name = %s\n", PUCK_SERVICE); if (info->server_port == 0) { PUCK_PORT = 80; } else { PUCK_PORT = info->server_port; } /* initialize mDNS */ mdns_pcb = udp_new(); if (mdns_pcb != NULL) { /* join to the multicast address 224.0.0.251 */ if(wifi_get_opmode() == 0x03 || wifi_get_opmode() == 0x01) { if (igmp_joingroup(&host_addr, &multicast_addr) != ERR_OK) { os_printf("sta udp_join_multigrup failed!\n"); return; }; } if(wifi_get_opmode() == 0x03 || wifi_get_opmode() == 0x02) { wifi_get_ip_info(SOFTAP_IF, &ipconfig); ap_host_addr.addr = ipconfig.ip.addr; if (igmp_joingroup(&ap_host_addr, &multicast_addr) != ERR_OK) { os_printf("ap udp_join_multigrup failed!\n"); return; }; } register_flag = 1; /* join to any IP address at the port 5353 */ if (udp_bind(mdns_pcb, IP_ADDR_ANY, DNS_MDNS_PORT) != ERR_OK) { os_printf("udp_bind failed!\n"); return; }; /*loopback function for the multicast(224.0.0.251) messages received at port 5353*/ // mdns_enable(); udp_recv(mdns_pcb, mdns_recv, info); mdns_flag = 1; /* * Register the name of the instrument */ os_timer_disarm(&mdns_timer); os_timer_setfn(&mdns_timer, (os_timer_func_t *)mdns_reg,info); os_timer_arm(&mdns_timer, 1000, 1); } } #endif /* LWIP_MDNS */ ================================================ FILE: app/lwip/core/mem.c ================================================ /** * @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 #if MEM_USE_POOLS /* 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) { struct memp_malloc_helper *element; memp_t poolnr; mem_size_t required_size = 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_sizes[poolnr]) { 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 */ element++; return element; } /** * 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 = (struct memp_malloc_helper*)rmem; 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--; 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)); /* 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 alignes. */ 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; u8_t pad[3]; /* XXX: pad here instead use global ALIGN */ } __ATTRIB_PACK; /** 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 */ /* enlarge heap as tx pbuf payload is allocate from heap as well */ u8_t ram_heap[MEM_SIZE_ALIGNED + (2*SIZEOF_STRUCT_MEM) + MEM_ALIGNMENT] SHMEM_ATTR; #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 */ //static sys_mutex_t mem_mutex; #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 ICACHE_FLASH_ATTR 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 */ 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 to run */ LWIP_MEM_ALLOC_PROTECT(); if (mem_free_count != 0) { local_mem_free_count = mem_free_count; } mem_free_count = 0; #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 excact 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 (mem == lfree) { /* Find next free block after mem and update lowest free pointer */ while (lfree->used && lfree != ram_end) { LWIP_MEM_ALLOC_UNPROTECT(); /* prevent high interrupt latency... */ LWIP_MEM_ALLOC_PROTECT(); lfree = (struct mem *)(void *)&ram[lfree->next]; } 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 */ os_memset(p, 0, count * size); } return p; } #endif /* !MEM_LIBC_MALLOC */ ================================================ FILE: app/lwip/core/memp.c ================================================ /** * @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/tcp_impl.h" #include "lwip/igmp.h" #include "lwip/api.h" #include "lwip/api_msg.h" #include "lwip/tcpip.h" #include "lwip/sys.h" #include "lwip/timers.h" #include "lwip/stats.h" #include "netif/etharp.h" #include "lwip/ip_frag.h" #include "lwip/snmp_structs.h" #include "lwip/snmp_msg.h" #include "lwip/dns.h" #include "netif/ppp_oe.h" #include #if !MEMP_MEM_MALLOC /* don't build if not configured for use in lwipopts.h */ struct memp { struct memp *next; #if MEMP_OVERFLOW_CHECK const char *file; int line; #endif /* MEMP_OVERFLOW_CHECK */ }; #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 */ /** This array holds the first free element of each pool. * Elements form a linked list. */ static struct memp *memp_tab[MEMP_MAX]; #else /* MEMP_MEM_MALLOC */ #define MEMP_ALIGN_SIZE(x) (LWIP_MEM_ALIGN_SIZE(x)) #endif /* MEMP_MEM_MALLOC */ /** This array holds the element sizes of each pool. */ #if !MEM_USE_POOLS && !MEMP_MEM_MALLOC static #endif const u32_t memp_sizes[MEMP_MAX] ICACHE_RODATA_ATTR = { //LWIP_MEM_ALIGN_SIZE #define LWIP_MEMPOOL(name,num,size,desc,attr) LWIP_MEM_ALIGN_SIZE(size), #include "lwip/memp_std.h" }; u16_t memp_sizes_test[1] = {PBUF_POOL_BUFSIZE,}; #if !MEMP_MEM_MALLOC /* don't build if not configured for use in lwipopts.h */ /** This array holds the number of elements in each pool. */ static const u16_t memp_num[MEMP_MAX] = { #define LWIP_MEMPOOL(name,num,size,desc,attr) (num), #include "lwip/memp_std.h" }; /** This array holds a textual description of each pool. */ //#ifdef LWIP_DEBUG //static const char *memp_desc[MEMP_MAX] = { const char *memp_desc[MEMP_MAX] = { #define LWIP_MEMPOOL(name,num,size,desc,attr) (desc), #include "lwip/memp_std.h" }; //#endif /* LWIP_DEBUG */ #if MEMP_SEPARATE_POOLS /** This creates each memory pool. These are named memp_memory_XXX_base (where * XXX is the name of the pool defined in memp_std.h). * To relocate a pool, declare it as extern in cc.h. Example for GCC: * extern u8_t __attribute__((section(".onchip_mem"))) memp_memory_UDP_PCB_base[]; */ #define LWIP_MEMPOOL(name,num,size,desc,attr) u8_t memp_memory_ ## name ## _base \ [((num) * (MEMP_SIZE + MEMP_ALIGN_SIZE(size)))] attr; #include "lwip/memp_std.h" /** This array holds the base of each memory pool. */ static u8_t *const memp_bases[] = { #define LWIP_MEMPOOL(name,num,size,desc,attr) memp_memory_ ## name ## _base, #include "lwip/memp_std.h" }; #else /* MEMP_SEPARATE_POOLS */ /** This is the actual memory used by the pools (all pools in one big block). */ static u8_t memp_memory[MEM_ALIGNMENT - 1 #define LWIP_MEMPOOL(name,num,size,desc, attr) + ( (num) * (MEMP_SIZE + MEMP_ALIGN_SIZE(size) ) ) #include "lwip/memp_std.h" ]; #endif /* MEMP_SEPARATE_POOLS */ #if MEMP_SANITY_CHECK /** * Check that memp-lists don't form a circle, modify by ives at 2014.4.23. */ static int ICACHE_FLASH_ATTR memp_sanity(void) { s16_t i; struct memp *t, *h; for (i = 0; i < MEMP_MAX; i++) { t = memp_tab[i]; if(t != NULL) { for (h = t->next; (t != NULL) && (h != NULL); t = t->next, h = (((h->next != NULL) && (h->next->next != NULL)) ? h->next->next : NULL)) { if (t == h) { return 0; } } } } return 1; } #endif /* MEMP_SANITY_CHECK*/ #if MEMP_OVERFLOW_CHECK #if defined(LWIP_DEBUG) && MEMP_STATS static const char * memp_overflow_names[] = { #define LWIP_MEMPOOL(name,num,size,desc,attr) "/"desc, #include "lwip/memp_std.h" }; #endif /** * 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 ICACHE_FLASH_ATTR memp_overflow_check_element_overflow(struct memp *p, u16_t memp_type) { u16_t k; u8_t *m; #if MEMP_SANITY_REGION_AFTER_ALIGNED > 0 m = (u8_t*)p + MEMP_SIZE + memp_sizes[memp_type]; for (k = 0; k < MEMP_SANITY_REGION_AFTER_ALIGNED; k++) { if (m[k] != 0xcd) { char errstr[128] = "detected memp overflow in pool "; char digit[] = "0"; if(memp_type >= 10) { digit[0] = '0' + (memp_type/10); strcat(errstr, digit); } digit[0] = '0' + (memp_type%10); strcat(errstr, digit); #if defined(LWIP_DEBUG) && MEMP_STATS strcat(errstr, memp_overflow_names[memp_type]); #endif 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 ICACHE_FLASH_ATTR memp_overflow_check_element_underflow(struct memp *p, u16_t memp_type) { 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 "; char digit[] = "0"; if(memp_type >= 10) { digit[0] = '0' + (memp_type/10); strcat(errstr, digit); } digit[0] = '0' + (memp_type%10); strcat(errstr, digit); #if defined(LWIP_DEBUG) && MEMP_STATS strcat(errstr, memp_overflow_names[memp_type]); #endif 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 ICACHE_FLASH_ATTR memp_overflow_check_all(void) { u16_t i, j; struct memp *p; p = (struct memp *)LWIP_MEM_ALIGN(memp_memory); for (i = 0; i < MEMP_MAX; ++i) { p = p; for (j = 0; j < memp_num[i]; ++j) { memp_overflow_check_element_overflow(p, i); p = (struct memp*)((u8_t*)p + MEMP_SIZE + memp_sizes[i] + MEMP_SANITY_REGION_AFTER_ALIGNED); } } p = (struct memp *)LWIP_MEM_ALIGN(memp_memory); for (i = 0; i < MEMP_MAX; ++i) { p = p; for (j = 0; j < memp_num[i]; ++j) { memp_overflow_check_element_underflow(p, i); p = (struct memp*)((u8_t*)p + MEMP_SIZE + memp_sizes[i] + MEMP_SANITY_REGION_AFTER_ALIGNED); } } } /** * Initialize the restricted areas of all memp elements in every pool. */ static void ICACHE_FLASH_ATTR memp_overflow_init(void) { u16_t i, j; struct memp *p; u8_t *m; p = (struct memp *)LWIP_MEM_ALIGN(memp_memory); for (i = 0; i < MEMP_MAX; ++i) { p = p; for (j = 0; j < memp_num[i]; ++j) { #if MEMP_SANITY_REGION_BEFORE_ALIGNED > 0 m = (u8_t*)p + MEMP_SIZE - MEMP_SANITY_REGION_BEFORE_ALIGNED; os_memset(m, 0xcd, MEMP_SANITY_REGION_BEFORE_ALIGNED); #endif #if MEMP_SANITY_REGION_AFTER_ALIGNED > 0 m = (u8_t*)p + MEMP_SIZE + memp_sizes[i]; os_memset(m, 0xcd, MEMP_SANITY_REGION_AFTER_ALIGNED); #endif p = (struct memp*)((u8_t*)p + MEMP_SIZE + memp_sizes[i] + MEMP_SANITY_REGION_AFTER_ALIGNED); } } } #endif /* MEMP_OVERFLOW_CHECK */ /** * Initialize this module. * * Carves out memp_memory into linked lists for each pool-type. */ void memp_init(void) { struct memp *memp; u16_t i, j; 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_num[i]); } #if !MEMP_SEPARATE_POOLS memp = (struct memp *)LWIP_MEM_ALIGN(memp_memory); #endif /* !MEMP_SEPARATE_POOLS */ /* for every pool: */ for (i = 0; i < MEMP_MAX; ++i) { memp_tab[i] = NULL; #if MEMP_SEPARATE_POOLS memp = (struct memp*)memp_bases[i]; #endif /* MEMP_SEPARATE_POOLS */ /* create a linked list of memp elements */ for (j = 0; j < memp_num[i]; ++j) { memp->next = (struct memp *)memp_tab[i]; memp_tab[i] = memp; memp = (struct memp *)(void *)((u8_t *)memp + MEMP_SIZE + memp_sizes[i] #if MEMP_OVERFLOW_CHECK + MEMP_SANITY_REGION_AFTER_ALIGNED #endif ); } } #if MEMP_OVERFLOW_CHECK memp_overflow_init(); /* check everything a first time to see if it worked */ memp_overflow_check_all(); #endif /* MEMP_OVERFLOW_CHECK */ } /** * 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 { struct memp *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 */ memp = memp_tab[type]; if (memp != NULL) { memp_tab[type] = memp->next; #if MEMP_OVERFLOW_CHECK memp->next = NULL; memp->file = file; memp->line = line; #endif /* MEMP_OVERFLOW_CHECK */ MEMP_STATS_INC_USED(used, type); LWIP_ASSERT("memp_malloc: memp properly aligned", ((mem_ptr_t)memp % MEM_ALIGNMENT) == 0); memp = (struct memp*)(void *)((u8_t*)memp + MEMP_SIZE); } else { LWIP_DEBUGF(MEMP_DEBUG | LWIP_DBG_LEVEL_SERIOUS, ("memp_malloc: out of memory in pool %s\n", memp_desc[type])); MEMP_STATS_INC(err, type); } SYS_ARCH_UNPROTECT(old_level); return memp; } /** * 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) { struct memp *memp; SYS_ARCH_DECL_PROTECT(old_level); if (mem == NULL) { return; } 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 #if MEMP_OVERFLOW_CHECK >= 2 memp_overflow_check_all(); #else memp_overflow_check_element_overflow(memp, type); memp_overflow_check_element_underflow(memp, type); #endif /* MEMP_OVERFLOW_CHECK >= 2 */ #endif /* MEMP_OVERFLOW_CHECK */ MEMP_STATS_DEC(used, type); memp->next = memp_tab[type]; memp_tab[type] = memp; #if MEMP_SANITY_CHECK LWIP_ASSERT("memp sanity", memp_sanity()); #endif /* MEMP_SANITY_CHECK */ SYS_ARCH_UNPROTECT(old_level); } #endif /* MEMP_MEM_MALLOC */ #if 0 void memp_dump(void) { printf("sizeof raw_pcb %u, memp_s1 %u, %s\n", sizeof(struct raw_pcb), memp_sizes[0], memp_desc[0]); printf("sizeof udp_pcb %u, memp_s2 %u, %s\n", sizeof(struct udp_pcb), memp_sizes[1], memp_desc[1]); printf("sizeof tcp_pcb %u, memp_s3 %u, %s\n", sizeof(struct tcp_pcb), memp_sizes[2], memp_desc[2]); printf("sizeof tcp_pcb_listen %u, memp_s4 %u, %s\n", sizeof(struct tcp_pcb_listen), memp_sizes[3], memp_desc[3]); printf("sizeof tcp_seg %u, memp_s5 %u, %s\n", sizeof(struct tcp_seg), memp_sizes[4], memp_desc[4]); printf("sizeof sys_timeo %u, memp_s6 %u, %s\n", sizeof(struct sys_timeo), memp_sizes[5], memp_desc[5]); printf("sizeof pbuf %u, memp_s7 %u, %s\n", sizeof(struct pbuf), memp_sizes[6], memp_desc[6]); printf("align pbuf size %u, memp_s8 %u, %s\n", (PBUF_POOL_BUFSIZE), memp_sizes[7], memp_desc[7]); printf("TCP_MSS %d PBUF_LINK_HLEN %d ETH_PAD_SIZE %d\n", TCP_MSS, PBUF_LINK_HLEN, ETH_PAD_SIZE); printf("TCP_MSS + PBUF_LINK_HLEN + ETH_PAD_SIZE %d \n", TCP_MSS+PBUF_LINK_HLEN+ETH_PAD_SIZE+40); printf("test size %u\n",memp_sizes_test[0]); printf("sizeof memp_memory_PBUF_pool %u \n", sizeof(memp_memory_PBUF_POOL_base)); } #endif //0000 ================================================ FILE: app/lwip/core/netif.c ================================================ /** * @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/netif.h" #include "lwip/tcp_impl.h" #include "lwip/snmp.h" #include "lwip/igmp.h" #include "netif/etharp.h" #include "lwip/stats.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_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 */ struct netif *netif_list; struct netif *netif_default; #if LWIP_HAVE_LOOPIF 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 ICACHE_FLASH_ATTR netif_loopif_init(struct netif *netif) { /* initialize the snmp variables and counters inside the struct netif * ifSpeed: no assumption can be made! */ NETIF_INIT_SNMP(netif, snmp_ifType_softwareLoopback, 0); netif->name[0] = 'l'; netif->name[1] = 'o'; netif->output = netif_loop_output; return ERR_OK; } #endif /* LWIP_HAVE_LOOPIF */ void netif_init(void) { #if LWIP_HAVE_LOOPIF ip_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); #if NO_SYS netif_add(&loop_netif, &loop_ipaddr, &loop_netmask, &loop_gw, NULL, netif_loopif_init, ip_input); #else /* NO_SYS */ netif_add(&loop_netif, &loop_ipaddr, &loop_netmask, &loop_gw, NULL, netif_loopif_init, tcpip_input); #endif /* NO_SYS */ 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, ip_addr_t *ipaddr, ip_addr_t *netmask, ip_addr_t *gw, void *state, netif_init_fn init, netif_input_fn input) { static u8_t netifnum = 0; LWIP_ASSERT("No init function given", init != NULL); /* reset new interface configuration state */ ip_addr_set_zero(&netif->ip_addr); ip_addr_set_zero(&netif->netmask); ip_addr_set_zero(&netif->gw); netif->flags = 0; #if LWIP_DHCP /* netif not under DHCP control by default */ netif->dhcp = NULL; netif->dhcps_pcb = NULL; #endif /* LWIP_DHCP */ #if LWIP_AUTOIP /* netif not under AutoIP control by default */ netif->autoip = NULL; #endif /* LWIP_AUTOIP */ #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 ENABLE_LOOPBACK netif->loop_first = NULL; netif->loop_last = NULL; #endif /* ENABLE_LOOPBACK */ /* remember netif specific state information data */ netif->state = state; netif->num = netifnum++; netif->input = input; #if LWIP_NETIF_HWADDRHINT netif->addr_hint = NULL; #endif /* LWIP_NETIF_HWADDRHINT*/ #if ENABLE_LOOPBACK && LWIP_LOOPBACK_MAX_PBUFS netif->loop_cnt_current = 0; #endif /* ENABLE_LOOPBACK && LWIP_LOOPBACK_MAX_PBUFS */ netif_set_addr(netif, ipaddr, netmask, gw); /* 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; snmp_inc_iflist(); #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 addr ", netif->name[0], netif->name[1])); ip_addr_debug_print(NETIF_DEBUG, ipaddr); LWIP_DEBUGF(NETIF_DEBUG, (" netmask ")); ip_addr_debug_print(NETIF_DEBUG, netmask); LWIP_DEBUGF(NETIF_DEBUG, (" gw ")); ip_addr_debug_print(NETIF_DEBUG, gw); LWIP_DEBUGF(NETIF_DEBUG, ("\n")); return netif; } /** * 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, ip_addr_t *ipaddr, ip_addr_t *netmask, ip_addr_t *gw) { netif_set_ipaddr(netif, ipaddr); netif_set_netmask(netif, netmask); netif_set_gw(netif, gw); } /** * 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_IGMP /* stop IGMP processing */ if (netif->flags & NETIF_FLAG_IGMP) { igmp_stop(netif); } #endif /* LWIP_IGMP */ if (netif_is_up(netif)) { /* set netif down before removing (call callback function) */ netif_set_down(netif); } snmp_delete_ipaddridx_tree(netif); /* is it the first netif? */ if (netif_list == netif) { netif_list = netif->next; } else { /* look for netif further down the list */ struct netif * tmpNetif; for (tmpNetif = netif_list; tmpNetif != NULL; tmpNetif = tmpNetif->next) { if (tmpNetif->next == netif) { tmpNetif->next = netif->next; break; } } if (tmpNetif == NULL) return; /* we didn't find any netif today */ } snmp_dec_iflist(); /* this netif is default? */ if (netif_default == netif) { /* reset default netif */ netif_set_default(NULL); } 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(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; } /** * 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, ip_addr_t *ipaddr) { /* TODO: Handling of obsolete pcbs */ /* See: http://mail.gnu.org/archive/html/lwip-users/2003-03/msg00118.html */ #if LWIP_TCP struct tcp_pcb *pcb; struct tcp_pcb_listen *lpcb; /* address is actually being changed? */ if (ipaddr && (ip_addr_cmp(ipaddr, &(netif->ip_addr))) == 0) { /* extern struct tcp_pcb *tcp_active_pcbs; defined by tcp.h */ LWIP_DEBUGF(NETIF_DEBUG | LWIP_DBG_STATE, ("netif_set_ipaddr: netif address being changed\n")); pcb = tcp_active_pcbs; while (pcb != NULL) { /* PCB bound to current local interface address? */ if (ip_addr_cmp(&(pcb->local_ip), &(netif->ip_addr)) #if LWIP_AUTOIP /* connections to link-local addresses must persist (RFC3927 ch. 1.9) */ && !ip_addr_islinklocal(&(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; } } for (lpcb = tcp_listen_pcbs.listen_pcbs; lpcb != NULL; lpcb = lpcb->next) { /* PCB bound to current local interface address? */ if ((!(ip_addr_isany(&(lpcb->local_ip)))) && (ip_addr_cmp(&(lpcb->local_ip), &(netif->ip_addr)))) { /* The PCB is listening to the old ipaddr and * is set to listen to the new one instead */ ip_addr_set(&(lpcb->local_ip), ipaddr); } } } #endif snmp_delete_ipaddridx_tree(netif); snmp_delete_iprteidx_tree(0,netif); /* set new IP address to netif */ ip_addr_set(&(netif->ip_addr), ipaddr); snmp_insert_ipaddridx_tree(netif); snmp_insert_iprteidx_tree(0,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->ip_addr), ip4_addr2_16(&netif->ip_addr), ip4_addr3_16(&netif->ip_addr), ip4_addr4_16(&netif->ip_addr))); } /** * 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, ip_addr_t *gw) { ip_addr_set(&(netif->gw), gw); 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->gw), ip4_addr2_16(&netif->gw), ip4_addr3_16(&netif->gw), ip4_addr4_16(&netif->gw))); } /** * 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, ip_addr_t *netmask) { snmp_delete_iprteidx_tree(0, netif); /* set new netmask to netif */ ip_addr_set(&(netif->netmask), netmask); snmp_insert_iprteidx_tree(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->netmask), ip4_addr2_16(&netif->netmask), ip4_addr3_16(&netif->netmask), ip4_addr4_16(&netif->netmask))); } /** * 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 */ snmp_delete_iprteidx_tree(1, netif); } else { /* install default route */ snmp_insert_iprteidx_tree(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. * * @note: Enabling DHCP on a down interface will make it come * up once configured. * * @see dhcp_start() */ void netif_set_up(struct netif *netif) { if (!(netif->flags & NETIF_FLAG_UP)) { netif->flags |= NETIF_FLAG_UP; #if LWIP_SNMP snmp_get_sysuptime(&netif->ts); #endif /* LWIP_SNMP */ NETIF_STATUS_CALLBACK(netif); if (netif->flags & NETIF_FLAG_LINK_UP) { #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 */ } } } /** * Bring an interface down, disabling any traffic processing. * * @note: Enabling DHCP on a down interface will make it come * up once configured. * * @see dhcp_start() */ void netif_set_down(struct netif *netif) { if (netif->flags & NETIF_FLAG_UP) { netif->flags &= ~NETIF_FLAG_UP; #if LWIP_SNMP snmp_get_sysuptime(&netif->ts); #endif #if LWIP_ARP if (netif->flags & NETIF_FLAG_ETHARP) { etharp_cleanup_netif(netif); } #endif /* LWIP_ARP */ NETIF_STATUS_CALLBACK(netif); } } #if LWIP_NETIF_STATUS_CALLBACK /** * Set callback to be called when interface is brought up/down */ 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 */ /** * 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) { #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 */ } 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' * @param ipaddr the ip address to send the packet to (not used) * @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, ip_addr_t *ipaddr) { 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 LWIP_SNMP #if LWIP_HAVE_LOOPIF struct netif *stats_if = &loop_netif; #else /* LWIP_HAVE_LOOPIF */ struct netif *stats_if = netif; #endif /* LWIP_HAVE_LOOPIF */ #endif /* LWIP_SNMP */ SYS_ARCH_DECL_PROTECT(lev); LWIP_UNUSED_ARG(ipaddr); /* 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); snmp_inc_ifoutdiscards(stats_if); 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); snmp_inc_ifoutdiscards(stats_if); 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); snmp_inc_ifoutdiscards(stats_if); 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); snmp_add_ifoutoctets(stats_if, p->tot_len); snmp_inc_ifoutucastpkts(stats_if); #if LWIP_NETIF_LOOPBACK_MULTITHREADING /* For multithreading environment, schedule a call to netif_poll */ tcpip_callback((tcpip_callback_fn)netif_poll, netif); #endif /* LWIP_NETIF_LOOPBACK_MULTITHREADING */ return ERR_OK; } /** * 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 LWIP_SNMP #if LWIP_HAVE_LOOPIF struct netif *stats_if = &loop_netif; #else /* LWIP_HAVE_LOOPIF */ struct netif *stats_if = netif; #endif /* LWIP_HAVE_LOOPIF */ #endif /* LWIP_SNMP */ 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 = pbuf_clen(in); /* 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 */ 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; } /* '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); snmp_add_ifinoctets(stats_if, in->tot_len); snmp_inc_ifinucastpkts(stats_if); /* 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 */ ================================================ FILE: app/lwip/core/pbuf.c ================================================ /** * @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" #include "arch/perf.h" #if TCP_QUEUE_OOSEQ #include "lwip/tcp_impl.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 = __FILE__; #endif #ifdef EBUF_LWIP #define EP_OFFSET 36 #else #define EP_OFFSET 0 #endif /* ESF_LWIP */ #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) /** * 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. */ #if TCP_QUEUE_OOSEQ void ICACHE_FLASH_ATTR pbuf_free_ooseq_new(void* arg) { struct tcp_pcb* pcb; struct tcp_seg *head = NULL; struct tcp_seg *seg1 = NULL; struct tcp_seg *seg2 = NULL; for (pcb = tcp_active_pcbs; NULL != pcb; pcb = pcb->next) { head = pcb->ooseq; seg1 = head; if (head != NULL) { if (seg1->next == NULL){ head = head->next; tcp_seg_free(seg1); pcb->ooseq = head; } else { while (seg1 != NULL){ seg2 = seg1; seg2 = seg2->next; if (seg2 ->next == NULL){ seg1->next = seg2->next; tcp_seg_free(seg2); break; } seg1 = seg1->next; } pcb->ooseq = head; } } } } #endif #if !LWIP_TCP || !TCP_QUEUE_OOSEQ || NO_SYS #define PBUF_POOL_IS_EMPTY() #else /* !LWIP_TCP || !TCP_QUEUE_OOSEQ || NO_SYS */ /** 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 PBUF_POOL_FREE_OOSEQ #include "lwip/tcpip.h" #define PBUF_POOL_IS_EMPTY() pbuf_pool_is_empty() static u8_t pbuf_free_ooseq_queued; /** * 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. */ static void ICACHE_FLASH_ATTR pbuf_free_ooseq(void* arg) { struct tcp_pcb* pcb; SYS_ARCH_DECL_PROTECT(old_level); LWIP_UNUSED_ARG(arg); SYS_ARCH_PROTECT(old_level); pbuf_free_ooseq_queued = 0; SYS_ARCH_UNPROTECT(old_level); 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; } } } /** Queue a call to pbuf_free_ooseq if not already queued. */ static void ICACHE_FLASH_ATTR pbuf_pool_is_empty(void) { u8_t queued; SYS_ARCH_DECL_PROTECT(old_level); SYS_ARCH_PROTECT(old_level); queued = pbuf_free_ooseq_queued; pbuf_free_ooseq_queued = 1; SYS_ARCH_UNPROTECT(old_level); if(!queued) { /* queue a call to pbuf_free_ooseq if not already queued */ if(tcpip_callback_with_block(pbuf_free_ooseq, NULL, 0) != ERR_OK) { SYS_ARCH_PROTECT(old_level); pbuf_free_ooseq_queued = 0; SYS_ARCH_UNPROTECT(old_level); } } } #endif /* PBUF_POOL_FREE_OOSEQ */ #endif /* !LWIP_TCP || !TCP_QUEUE_OOSEQ || NO_SYS */ /** * 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; u16_t offset; s32_t rem_len; /* remaining length */ LWIP_DEBUGF(PBUF_DEBUG | LWIP_DBG_TRACE, ("pbuf_alloc(length=%"U16_F")\n", length)); /* determine header offset */ offset = 0; switch (layer) { case PBUF_TRANSPORT: /* add room for transport (often TCP) layer header */ offset += PBUF_TRANSPORT_HLEN; /* FALLTHROUGH */ case PBUF_IP: /* add room for IP layer header */ offset += PBUF_IP_HLEN; /* FALLTHROUGH */ case PBUF_LINK: /* add room for link layer header */ offset += PBUF_LINK_HLEN; #ifdef PBUF_RSV_FOR_WLAN /* * 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 /* PBUF_RSV_FOR_WLAN */ break; case PBUF_RAW: #ifdef PBUF_RSV_FOR_WLAN /* * RAW pbuf suppose */ offset += EP_OFFSET; //remove LINK hdr in wlan #endif /* PBUF_RAW */ 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 unsuccesfully */ 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; p->eb = NULL; LWIP_ASSERT("pbuf_alloc: pbuf->payload properly aligned", ((mem_ptr_t)p->payload % MEM_ALIGNMENT) == 0); break; #ifdef EBUF_LWIP case PBUF_ESF_RX: #endif /* ESF_LWIP */ /* 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; 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 * @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 */ offset = 0; switch (l) { case PBUF_TRANSPORT: /* add room for transport (often TCP) layer header */ offset += PBUF_TRANSPORT_HLEN; /* FALLTHROUGH */ case PBUF_IP: /* add room for IP layer header */ offset += PBUF_IP_HLEN; /* FALLTHROUGH */ case PBUF_LINK: /* add room for link layer header */ offset += PBUF_LINK_HLEN; break; case PBUF_RAW: 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 = LWIP_MEM_ALIGN((void *)((u8_t *)payload_mem + 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)) { /* 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. * * 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 succesful. * * 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) { 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 + EP_OFFSET) { 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 unsuccesfully */ return 1; } /* pbuf types refering 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 { /* cannot expand payload to front (yet!) * bail out unsuccesfully */ if (type == PBUF_REF) { /* increase payload pointer */ p->payload = (u8_t *)p->payload - header_size_increment; } else { 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; } /** * 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 #ifdef EBUF_LWIP || p->type == PBUF_ESF_RX #endif //EBUF_LWIP ); 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 EBUF_LWIP || type == PBUF_ESF_RX #endif //EBUF_LWIP ) { #ifdef EBUF_LWIP system_pp_recycle_rx_pkt(p->eb); #endif //EBUF_LWIP 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 { LWIP_ASSERT("p_to != NULL", p_to != NULL); /* 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); if (offset_to == p_to->len) { /* on to next p_to (if any) */ offset_to = 0; p_to = p_to->next; } 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((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!\n", (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!\n", (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; } /** * 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 0;); LWIP_ERROR("pbuf_take: invalid dataptr", (dataptr != NULL), return 0;); 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, &((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; } /** * 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 copy_from = offset; struct pbuf* q = p; /* get the correct pbuf */ while ((q != NULL) && (q->len <= copy_from)) { copy_from -= q->len; q = q->next; } /* return requested data if pbuf is OK */ if ((q != NULL) && (q->len > copy_from)) { return ((u8_t*)q->payload)[copy_from]; } return 0; } /** Compare pbuf contents at specified offset with memory s2, both of length n * * @param p pbuf to compare * @param offset offset into p at wich 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 = ((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; ) { u16_t plus = pbuf_memcmp(p, i, mem, mem_len); if (plus == 0) { return i; } else { i += plus; } } } 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 = os_strlen(substr); if (substr_len >= 0xFFFF) { return 0xFFFF; } return pbuf_memfind(p, substr, (u16_t)substr_len, 0); } ================================================ FILE: app/lwip/core/raw.c ================================================ /** * @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 "arch/perf.h" #include #ifdef MEMLEAK_DEBUG static const char mem_debug_file[] ICACHE_RODATA_ATTR = __FILE__; #endif /** The list of RAW PCBs */ static struct raw_pcb *raw_pcbs; /** * 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 ICACHE_FLASH_ATTR raw_input(struct pbuf *p, struct netif *inp) { struct raw_pcb *pcb, *prev; struct ip_hdr *iphdr; s16_t proto; u8_t eaten = 0; LWIP_UNUSED_ARG(inp); iphdr = (struct ip_hdr *)p->payload; proto = IPH_PROTO(iphdr); 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) && (ip_addr_isany(&pcb->local_ip) || ip_addr_cmp(&(pcb->local_ip), ¤t_iphdr_dest))) { #if IP_SOF_BROADCAST_RECV /* broadcast filter? */ if ((pcb->so_options & SOF_BROADCAST) || !ip_addr_isbroadcast(¤t_iphdr_dest, inp)) #endif /* IP_SOF_BROADCAST_RECV */ { /* receive callback function available? */ if (pcb->recv != NULL) { /* the receive callback function did not eat the packet? */ if (pcb->recv(pcb->recv_arg, pcb, p, ip_current_src_addr()) != 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; } } } /* 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 occured. * - ERR_USE. The specified IP address is already bound to by * another RAW PCB. * * @see raw_disconnect() */ err_t ICACHE_FLASH_ATTR raw_bind(struct raw_pcb *pcb, ip_addr_t *ipaddr) { ip_addr_set(&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 ICACHE_FLASH_ATTR raw_connect(struct raw_pcb *pcb, ip_addr_t *ipaddr) { ip_addr_set(&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 ICACHE_FLASH_ATTR 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 ICACHE_FLASH_ATTR raw_sendto(struct raw_pcb *pcb, struct pbuf *p, ip_addr_t *ipaddr) { err_t err; struct netif *netif; ip_addr_t *src_ip; struct pbuf *q; /* q will be sent down the stack */ LWIP_DEBUGF(RAW_DEBUG | LWIP_DBG_TRACE, ("raw_sendto\n")); /* not enough space to add an IP header to first pbuf in given p chain? */ if (pbuf_header(p, IP_HLEN)) { /* 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, -IP_HLEN)) { LWIP_ASSERT("Can't restore header we just removed!", 0); return ERR_MEM; } } if ((netif = ip_route(ipaddr)) == NULL) { LWIP_DEBUGF(RAW_DEBUG | LWIP_DBG_LEVEL_WARNING, ("raw_sendto: No route to %"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))); /* free any temporary header pbuf allocated by pbuf_header() */ if (q != p) { pbuf_free(q); } return ERR_RTE; } #if IP_SOF_BROADCAST /* broadcast filter? */ if (((pcb->so_options & SOF_BROADCAST) == 0) && 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 = &(netif->ip_addr); } else { /* use RAW PCB local IP address as source address */ src_ip = &(pcb->local_ip); } #if LWIP_NETIF_HWADDRHINT netif->addr_hint = &(pcb->addr_hint); #endif /* LWIP_NETIF_HWADDRHINT*/ err = ip_output_if (q, src_ip, ipaddr, pcb->ttl, pcb->tos, pcb->protocol, netif); #if LWIP_NETIF_HWADDRHINT netif->addr_hint = NULL; #endif /* LWIP_NETIF_HWADDRHINT*/ /* 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 ICACHE_FLASH_ATTR 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 ICACHE_FLASH_ATTR 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; } } } 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 * ICACHE_FLASH_ATTR 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 */ os_memset(pcb, 0, sizeof(struct raw_pcb)); pcb->protocol = proto; pcb->ttl = RAW_TTL; pcb->next = raw_pcbs; raw_pcbs = pcb; } return pcb; } #endif /* LWIP_RAW */ ================================================ FILE: app/lwip/core/sntp.c ================================================ /** * @file * SNTP client module * * This is simple "SNTP" client for the lwIP raw API. * It is a minimal implementation of SNTPv4 as specified in RFC 4330. * * For a list of some public NTP servers, see this link : * http://support.ntp.org/bin/view/Servers/NTPPoolServers * * @todo: * - set/change servers at runtime * - complete SNTP_CHECK_RESPONSE checks 3 and 4 * - support broadcast/multicast mode? */ /* * 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 (lwIP raw API part) */ #include "lwip/sntp.h" #include "osapi.h" #include "os_type.h" #include "lwip/opt.h" #include "lwip/timers.h" #include "lwip/udp.h" #include "lwip/dns.h" #include "lwip/ip_addr.h" #include "lwip/pbuf.h" //#include #if LWIP_UDP /** * SNTP_DEBUG: Enable debugging for SNTP. */ #ifndef SNTP_DEBUG #define SNTP_DEBUG LWIP_DBG_ON #endif /** SNTP server port */ #ifndef SNTP_PORT #define SNTP_PORT 123 #endif /** Set this to 1 to allow config of SNTP server(s) by DNS name */ #ifndef SNTP_SERVER_DNS #define SNTP_SERVER_DNS 0 #endif /** Handle support for more than one server via NTP_MAX_SERVERS, * but catch legacy style of setting SNTP_SUPPORT_MULTIPLE_SERVERS, probably outside of this file */ #ifndef SNTP_SUPPORT_MULTIPLE_SERVERS #if SNTP_MAX_SERVERS > 1 #define SNTP_SUPPORT_MULTIPLE_SERVERS 1 #else /* NTP_MAX_SERVERS > 1 */ #define SNTP_SUPPORT_MULTIPLE_SERVERS 0 #endif /* NTP_MAX_SERVERS > 1 */ #else /* SNTP_SUPPORT_MULTIPLE_SERVERS */ /* The developer has defined SNTP_SUPPORT_MULTIPLE_SERVERS, probably from old code */ #if SNTP_MAX_SERVERS <= 1 #error "SNTP_MAX_SERVERS needs to be defined to the max amount of servers if SNTP_SUPPORT_MULTIPLE_SERVERS is defined" #endif /* SNTP_MAX_SERVERS <= 1 */ #endif /* SNTP_SUPPORT_MULTIPLE_SERVERS */ /** Sanity check: * Define this to * - 0 to turn off sanity checks (default; smaller code) * - >= 1 to check address and port of the response packet to ensure the * response comes from the server we sent the request to. * - >= 2 to check returned Originate Timestamp against Transmit Timestamp * sent to the server (to ensure response to older request). * - >= 3 @todo: discard reply if any of the LI, Stratum, or Transmit Timestamp * fields is 0 or the Mode field is not 4 (unicast) or 5 (broadcast). * - >= 4 @todo: to check that the Root Delay and Root Dispersion fields are each * greater than or equal to 0 and less than infinity, where infinity is * currently a cozy number like one second. This check avoids using a * server whose synchronization source has expired for a very long time. */ #ifndef SNTP_CHECK_RESPONSE #define SNTP_CHECK_RESPONSE 0 #endif /** According to the RFC, this shall be a random delay * between 1 and 5 minutes (in milliseconds) to prevent load peaks. * This can be defined to a random generation function, * which must return the delay in milliseconds as u32_t. * Turned off by default. */ #ifndef SNTP_STARTUP_DELAY #define SNTP_STARTUP_DELAY 0 #endif /** If you want the startup delay to be a function, define this * to a function (including the brackets) and define SNTP_STARTUP_DELAY to 1. */ #ifndef SNTP_STARTUP_DELAY_FUNC #define SNTP_STARTUP_DELAY_FUNC SNTP_STARTUP_DELAY #endif /** SNTP receive timeout - in milliseconds * Also used as retry timeout - this shouldn't be too low. * Default is 3 seconds. */ #ifndef SNTP_RECV_TIMEOUT #define SNTP_RECV_TIMEOUT 3000 #endif /** SNTP update delay - in milliseconds * Default is 1 hour. */ #ifndef SNTP_UPDATE_DELAY #define SNTP_UPDATE_DELAY 3600000 #endif #if (SNTP_UPDATE_DELAY < 15000) && !SNTP_SUPPRESS_DELAY_CHECK #error "SNTPv4 RFC 4330 enforces a minimum update time of 15 seconds!" #endif /** SNTP macro to change system time and/or the update the RTC clock */ #ifndef SNTP_SET_SYSTEM_TIME #define SNTP_SET_SYSTEM_TIME(sec) ((void)sec) #endif /** SNTP macro to change system time including microseconds */ #ifdef SNTP_SET_SYSTEM_TIME_US #define SNTP_CALC_TIME_US 1 #define SNTP_RECEIVE_TIME_SIZE 2 #else #define SNTP_SET_SYSTEM_TIME_US(sec, us) #define SNTP_CALC_TIME_US 0 #define SNTP_RECEIVE_TIME_SIZE 1 #endif /** SNTP macro to get system time, used with SNTP_CHECK_RESPONSE >= 2 * to send in request and compare in response. */ #ifndef SNTP_GET_SYSTEM_TIME #define SNTP_GET_SYSTEM_TIME(sec, us) do { (sec) = 0; (us) = 0; } while(0) #endif /** Default retry timeout (in milliseconds) if the response * received is invalid. * This is doubled with each retry until SNTP_RETRY_TIMEOUT_MAX is reached. */ #ifndef SNTP_RETRY_TIMEOUT #define SNTP_RETRY_TIMEOUT SNTP_RECV_TIMEOUT #endif /** Maximum retry timeout (in milliseconds). */ #ifndef SNTP_RETRY_TIMEOUT_MAX #define SNTP_RETRY_TIMEOUT_MAX (SNTP_RETRY_TIMEOUT * 10) #endif /** Increase retry timeout with every retry sent * Default is on to conform to RFC. */ #ifndef SNTP_RETRY_TIMEOUT_EXP #define SNTP_RETRY_TIMEOUT_EXP 1 #endif /* the various debug levels for this file */ #define SNTP_DEBUG_TRACE (SNTP_DEBUG | LWIP_DBG_TRACE) #define SNTP_DEBUG_STATE (SNTP_DEBUG | LWIP_DBG_STATE) #define SNTP_DEBUG_WARN (SNTP_DEBUG | LWIP_DBG_LEVEL_WARNING) #define SNTP_DEBUG_WARN_STATE (SNTP_DEBUG | LWIP_DBG_LEVEL_WARNING | LWIP_DBG_STATE) #define SNTP_DEBUG_SERIOUS (SNTP_DEBUG | LWIP_DBG_LEVEL_SERIOUS) #define SNTP_ERR_KOD 1 /* SNTP protocol defines */ #define SNTP_MSG_LEN 48 #define SNTP_OFFSET_LI_VN_MODE 0 #define SNTP_LI_MASK 0xC0 #define SNTP_LI_NO_WARNING 0x00 #define SNTP_LI_LAST_MINUTE_61_SEC 0x01 #define SNTP_LI_LAST_MINUTE_59_SEC 0x02 #define SNTP_LI_ALARM_CONDITION 0x03 /* (clock not synchronized) */ #define SNTP_VERSION_MASK 0x38 #define SNTP_VERSION (4/* NTP Version 4*/<<3) #define SNTP_MODE_MASK 0x07 #define SNTP_MODE_CLIENT 0x03 #define SNTP_MODE_SERVER 0x04 #define SNTP_MODE_BROADCAST 0x05 #define SNTP_OFFSET_STRATUM 1 #define SNTP_STRATUM_KOD 0x00 #define SNTP_OFFSET_ORIGINATE_TIME 24 #define SNTP_OFFSET_RECEIVE_TIME 32 #define SNTP_OFFSET_TRANSMIT_TIME 40 /* number of seconds between 1900 and 1970 */ #define DIFF_SEC_1900_1970 (2208988800UL) /** * SNTP packet format (without optional fields) * Timestamps are coded as 64 bits: * - 32 bits seconds since Jan 01, 1970, 00:00 * - 32 bits seconds fraction (0-padded) * For future use, if the MSB in the seconds part is set, seconds are based * on Feb 07, 2036, 06:28:16. */ #ifdef PACK_STRUCT_USE_INCLUDES # include "arch/bpstruct.h" #endif PACK_STRUCT_BEGIN #define PACK_STRUCT_FLD_8 PACK_STRUCT_FIELD struct sntp_msg { PACK_STRUCT_FLD_8(u8_t li_vn_mode); PACK_STRUCT_FLD_8(u8_t stratum); PACK_STRUCT_FLD_8(u8_t poll); PACK_STRUCT_FLD_8(u8_t precision); PACK_STRUCT_FIELD(u32_t root_delay); PACK_STRUCT_FIELD(u32_t root_dispersion); PACK_STRUCT_FIELD(u32_t reference_identifier); PACK_STRUCT_FIELD(u32_t reference_timestamp[2]); PACK_STRUCT_FIELD(u32_t originate_timestamp[2]); PACK_STRUCT_FIELD(u32_t receive_timestamp[2]); PACK_STRUCT_FIELD(u32_t transmit_timestamp[2]); } PACK_STRUCT_STRUCT; PACK_STRUCT_END #ifdef PACK_STRUCT_USE_INCLUDES # include "arch/epstruct.h" #endif /* function prototypes */ static void sntp_request(void *arg); /** The UDP pcb used by the SNTP client */ static struct udp_pcb* sntp_pcb; sint8 time_zone = 8; /** Names/Addresses of servers */ struct sntp_server { #if SNTP_SERVER_DNS char* name; #endif /* SNTP_SERVER_DNS */ ip_addr_t addr; }; static struct sntp_server sntp_servers[SNTP_MAX_SERVERS]; static u8_t sntp_set_servers_from_dhcp; #if SNTP_SUPPORT_MULTIPLE_SERVERS /** The currently used server (initialized to 0) */ static u8_t sntp_current_server; #else /* SNTP_SUPPORT_MULTIPLE_SERVERS */ #define sntp_current_server 0 #endif /* SNTP_SUPPORT_MULTIPLE_SERVERS */ #if SNTP_RETRY_TIMEOUT_EXP #define SNTP_RESET_RETRY_TIMEOUT() sntp_retry_timeout = SNTP_RETRY_TIMEOUT /** Retry time, initialized with SNTP_RETRY_TIMEOUT and doubled with each retry. */ static u32_t sntp_retry_timeout; #else /* SNTP_RETRY_TIMEOUT_EXP */ #define SNTP_RESET_RETRY_TIMEOUT() #define sntp_retry_timeout SNTP_RETRY_TIMEOUT #endif /* SNTP_RETRY_TIMEOUT_EXP */ #if SNTP_CHECK_RESPONSE >= 1 /** Saves the last server address to compare with response */ static ip_addr_t sntp_last_server_address; #endif /* SNTP_CHECK_RESPONSE >= 1 */ #if SNTP_CHECK_RESPONSE >= 2 /** Saves the last timestamp sent (which is sent back by the server) * to compare against in response */ static u32_t sntp_last_timestamp_sent[2]; #endif /* SNTP_CHECK_RESPONSE >= 2 */ typedef long time_t; //uint32 current_stamp_1 = 0; //uint32 current_stamp_2 = 0; uint32 realtime_stamp = 0; LOCAL os_timer_t sntp_timer; /*****************************************/ #define SECSPERMIN 60L #define MINSPERHOUR 60L #define HOURSPERDAY 24L #define SECSPERHOUR (SECSPERMIN * MINSPERHOUR) #define SECSPERDAY (SECSPERHOUR * HOURSPERDAY) #define DAYSPERWEEK 7 #define MONSPERYEAR 12 #define YEAR_BASE 1900 #define EPOCH_YEAR 1970 #define EPOCH_WDAY 4 #define EPOCH_YEARS_SINCE_LEAP 2 #define EPOCH_YEARS_SINCE_CENTURY 70 #define EPOCH_YEARS_SINCE_LEAP_CENTURY 370 #define isleap(y) ((((y) % 4) == 0 && ((y) % 100) != 0) || ((y) % 400) == 0) int __tznorth; int __tzyear; char reult[100]; static const int mon_lengths[2][12] = { {31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31}, {31, 29, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31} } ; static const int year_lengths[2] = { 365, 366 } ; 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; }; struct tm res_buf; typedef struct __tzrule_struct { char ch; int m; int n; int d; int s; time_t change; int offset; } __tzrule_type; __tzrule_type sntp__tzrule[2]; struct tm * ICACHE_FLASH_ATTR sntp_mktm_r(const time_t * tim_p ,struct tm *res ,int is_gmtime) { long days, rem; time_t lcltime; int i; int y; int yleap; const int *ip; /* base decision about std/dst time on current time */ lcltime = *tim_p; days = ((long)lcltime) / SECSPERDAY; rem = ((long)lcltime) % SECSPERDAY; while (rem < 0) { rem += SECSPERDAY; --days; } while (rem >= SECSPERDAY) { rem -= SECSPERDAY; ++days; } /* compute hour, min, and sec */ res->tm_hour = (int) (rem / SECSPERHOUR); rem %= SECSPERHOUR; res->tm_min = (int) (rem / SECSPERMIN); res->tm_sec = (int) (rem % SECSPERMIN); /* compute day of week */ if ((res->tm_wday = ((EPOCH_WDAY + days) % DAYSPERWEEK)) < 0) res->tm_wday += DAYSPERWEEK; /* compute year & day of year */ y = EPOCH_YEAR; if (days >= 0) { for (;;) { yleap = isleap(y); if (days < year_lengths[yleap]) break; y++; days -= year_lengths[yleap]; } } else { do { --y; yleap = isleap(y); days += year_lengths[yleap]; } while (days < 0); } res->tm_year = y - YEAR_BASE; res->tm_yday = days; ip = mon_lengths[yleap]; for (res->tm_mon = 0; days >= ip[res->tm_mon]; ++res->tm_mon) days -= ip[res->tm_mon]; res->tm_mday = days + 1; if (!is_gmtime) { int offset; int hours, mins, secs; // TZ_LOCK; // if (_daylight) // { // if (y == __tzyear || __tzcalc_limits (y)) // res->tm_isdst = (__tznorth // ? (*tim_p >= __tzrule[0].change && *tim_p < __tzrule[1].change) // : (*tim_p >= __tzrule[0].change || *tim_p < __tzrule[1].change)); // else // res->tm_isdst = -1; // } // else res->tm_isdst = 0; offset = (res->tm_isdst == 1 ? sntp__tzrule[1].offset : sntp__tzrule[0].offset); hours = offset / SECSPERHOUR; offset = offset % SECSPERHOUR; mins = offset / SECSPERMIN; secs = offset % SECSPERMIN; res->tm_sec -= secs; res->tm_min -= mins; res->tm_hour -= hours; if (res->tm_sec >= SECSPERMIN) { res->tm_min += 1; res->tm_sec -= SECSPERMIN; } else if (res->tm_sec < 0) { res->tm_min -= 1; res->tm_sec += SECSPERMIN; } if (res->tm_min >= MINSPERHOUR) { res->tm_hour += 1; res->tm_min -= MINSPERHOUR; } else if (res->tm_min < 0) { res->tm_hour -= 1; res->tm_min += MINSPERHOUR; } if (res->tm_hour >= HOURSPERDAY) { ++res->tm_yday; ++res->tm_wday; if (res->tm_wday > 6) res->tm_wday = 0; ++res->tm_mday; res->tm_hour -= HOURSPERDAY; if (res->tm_mday > ip[res->tm_mon]) { res->tm_mday -= ip[res->tm_mon]; res->tm_mon += 1; if (res->tm_mon == 12) { res->tm_mon = 0; res->tm_year += 1; res->tm_yday = 0; } } } else if (res->tm_hour < 0) { res->tm_yday -= 1; res->tm_wday -= 1; if (res->tm_wday < 0) res->tm_wday = 6; res->tm_mday -= 1; res->tm_hour += 24; if (res->tm_mday == 0) { res->tm_mon -= 1; if (res->tm_mon < 0) { res->tm_mon = 11; res->tm_year -= 1; res->tm_yday = 365 + isleap(res->tm_year); } res->tm_mday = ip[res->tm_mon]; } } // TZ_UNLOCK; } else res->tm_isdst = 0; // os_printf("res %d %d %d %d %d\n",res->tm_year,res->tm_mon,res->tm_mday,res->tm_yday,res->tm_hour); return (res); } struct tm * ICACHE_FLASH_ATTR sntp_localtime_r(const time_t * tim_p , struct tm *res) { return sntp_mktm_r (tim_p, res, 0); } struct tm * ICACHE_FLASH_ATTR sntp_localtime(const time_t * tim_p) { return sntp_localtime_r (tim_p, &res_buf); } int ICACHE_FLASH_ATTR sntp__tzcalc_limits(int year) { int days, year_days, years; int i, j; if (year < EPOCH_YEAR) return 0; __tzyear = year; years = (year - EPOCH_YEAR); year_days = years * 365 + (years - 1 + EPOCH_YEARS_SINCE_LEAP) / 4 - (years - 1 + EPOCH_YEARS_SINCE_CENTURY) / 100 + (years - 1 + EPOCH_YEARS_SINCE_LEAP_CENTURY) / 400; for (i = 0; i < 2; ++i) { if (sntp__tzrule[i].ch == 'J') days = year_days + sntp__tzrule[i].d + (isleap(year) && sntp__tzrule[i].d >= 60); else if (sntp__tzrule[i].ch == 'D') days = year_days + sntp__tzrule[i].d; else { int yleap = isleap(year); int m_day, m_wday, wday_diff; const int *ip = mon_lengths[yleap]; days = year_days; for (j = 1; j < sntp__tzrule[i].m; ++j) days += ip[j-1]; m_wday = (EPOCH_WDAY + days) % DAYSPERWEEK; wday_diff = sntp__tzrule[i].d - m_wday; if (wday_diff < 0) wday_diff += DAYSPERWEEK; m_day = (sntp__tzrule[i].n - 1) * DAYSPERWEEK + wday_diff; while (m_day >= ip[j-1]) m_day -= DAYSPERWEEK; days += m_day; } /* store the change-over time in GMT form by adding offset */ sntp__tzrule[i].change = days * SECSPERDAY + sntp__tzrule[i].s + sntp__tzrule[i].offset; } __tznorth = (sntp__tzrule[0].change < sntp__tzrule[1].change); return 1; } char * ICACHE_FLASH_ATTR sntp_asctime_r(struct tm *tim_p ,char *result) { static const char day_name[7][4] = { "Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat" }; static const char mon_name[12][4] = { "Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec" }; os_sprintf (result, "%s %s %02d %02d:%02d:%02d %02d\n", day_name[tim_p->tm_wday], mon_name[tim_p->tm_mon], tim_p->tm_mday, tim_p->tm_hour, tim_p->tm_min, tim_p->tm_sec, 1900 + tim_p->tm_year); return result; } char *ICACHE_FLASH_ATTR sntp_asctime(struct tm *tim_p) { return sntp_asctime_r (tim_p, reult); } uint32 sntp_get_current_timestamp() { if(realtime_stamp == 0){ os_printf("please start sntp first !\n"); return 0; } else { return realtime_stamp; } } char* sntp_get_real_time(time_t t) { return sntp_asctime(sntp_localtime (&t)); } /** * SNTP get time_zone default GMT + 8 */ sint8 ICACHE_FLASH_ATTR sntp_get_timezone(void) { return time_zone; } /** * SNTP set time_zone default GMT + 8 */ bool ICACHE_FLASH_ATTR sntp_set_timezone(sint8 timezone) { if(timezone >= -11 || timezone <= 13) { time_zone = timezone; return true; } else { return false; } } void ICACHE_FLASH_ATTR sntp_time_inc(void) { realtime_stamp++; } /** * SNTP processing of received timestamp */ static void ICACHE_FLASH_ATTR sntp_process(u32_t *receive_timestamp) { /* convert SNTP time (1900-based) to unix GMT time (1970-based) * @todo: if MSB is 1, SNTP time is 2036-based! */ time_t t = (ntohl(receive_timestamp[0]) - DIFF_SEC_1900_1970); #if SNTP_CALC_TIME_US u32_t us = ntohl(receive_timestamp[1]) / 4295; SNTP_SET_SYSTEM_TIME_US(t, us); /* display local time from GMT time */ LWIP_DEBUGF(SNTP_DEBUG_TRACE, ("sntp_process: %s, %"U32_F" us", ctime(&t), us)); #else /* SNTP_CALC_TIME_US */ /* change system time and/or the update the RTC clock */ SNTP_SET_SYSTEM_TIME(t); /* display local time from GMT time */ t += time_zone * 60 * 60;// format GMT + time_zone TIME ZONE realtime_stamp = t; os_timer_disarm(&sntp_timer); os_timer_setfn(&sntp_timer, (os_timer_func_t *)sntp_time_inc, NULL); os_timer_arm(&sntp_timer, 1000, 1); os_printf("%s\n",sntp_asctime(sntp_localtime (&t))); // os_printf("%s\n",ctime(&t)); // LWIP_DEBUGF(SNTP_DEBUG_TRACE, ("sntp_process: %s", ctime(&t))); #endif /* SNTP_CALC_TIME_US */ } /** * Initialize request struct to be sent to server. */ static void ICACHE_FLASH_ATTR sntp_initialize_request(struct sntp_msg *req) { os_memset(req, 0, SNTP_MSG_LEN); req->li_vn_mode = SNTP_LI_NO_WARNING | SNTP_VERSION | SNTP_MODE_CLIENT; #if SNTP_CHECK_RESPONSE >= 2 { u32_t sntp_time_sec, sntp_time_us; /* fill in transmit timestamp and save it in 'sntp_last_timestamp_sent' */ SNTP_GET_SYSTEM_TIME(sntp_time_sec, sntp_time_us); sntp_last_timestamp_sent[0] = htonl(sntp_time_sec + DIFF_SEC_1900_1970); req->transmit_timestamp[0] = sntp_last_timestamp_sent[0]; /* we send/save us instead of fraction to be faster... */ sntp_last_timestamp_sent[1] = htonl(sntp_time_us); req->transmit_timestamp[1] = sntp_last_timestamp_sent[1]; } #endif /* SNTP_CHECK_RESPONSE >= 2 */ } /** * Retry: send a new request (and increase retry timeout). * * @param arg is unused (only necessary to conform to sys_timeout) */ static void ICACHE_FLASH_ATTR sntp_retry(void* arg) { LWIP_UNUSED_ARG(arg); LWIP_DEBUGF(SNTP_DEBUG_STATE, ("sntp_retry: Next request will be sent in %"U32_F" ms\n", sntp_retry_timeout)); /* set up a timer to send a retry and increase the retry delay */ sys_timeout(sntp_retry_timeout, sntp_request, NULL); #if SNTP_RETRY_TIMEOUT_EXP { u32_t new_retry_timeout; /* increase the timeout for next retry */ new_retry_timeout = sntp_retry_timeout << 1; /* limit to maximum timeout and prevent overflow */ if ((new_retry_timeout <= SNTP_RETRY_TIMEOUT_MAX) && (new_retry_timeout > sntp_retry_timeout)) { sntp_retry_timeout = new_retry_timeout; } } #endif /* SNTP_RETRY_TIMEOUT_EXP */ } #if SNTP_SUPPORT_MULTIPLE_SERVERS /** * If Kiss-of-Death is received (or another packet parsing error), * try the next server or retry the current server and increase the retry * timeout if only one server is available. * (implicitly, SNTP_MAX_SERVERS > 1) * * @param arg is unused (only necessary to conform to sys_timeout) */ static void sntp_try_next_server(void* arg) { u8_t old_server, i; LWIP_UNUSED_ARG(arg); old_server = sntp_current_server; for (i = 0; i < SNTP_MAX_SERVERS - 1; i++) { sntp_current_server++; if (sntp_current_server >= SNTP_MAX_SERVERS) { sntp_current_server = 0; } if (!ip_addr_isany(&sntp_servers[sntp_current_server].addr) #if SNTP_SERVER_DNS || (sntp_servers[sntp_current_server].name != NULL) #endif ) { LWIP_DEBUGF(SNTP_DEBUG_STATE, ("sntp_try_next_server: Sending request to server %"U16_F"\n", (u16_t)sntp_current_server)); /* new server: reset retry timeout */ SNTP_RESET_RETRY_TIMEOUT(); /* instantly send a request to the next server */ sntp_request(NULL); return; } } /* no other valid server found */ sntp_current_server = old_server; sntp_retry(NULL); } #else /* SNTP_SUPPORT_MULTIPLE_SERVERS */ /* Always retry on error if only one server is supported */ #define sntp_try_next_server sntp_retry #endif /* SNTP_SUPPORT_MULTIPLE_SERVERS */ /** UDP recv callback for the sntp pcb */ static void ICACHE_FLASH_ATTR sntp_recv(void *arg, struct udp_pcb* pcb, struct pbuf *p, ip_addr_t *addr, u16_t port) { u8_t mode; u8_t stratum; u32_t receive_timestamp[SNTP_RECEIVE_TIME_SIZE]; err_t err; //os_printf("sntp_recv\n"); LWIP_UNUSED_ARG(arg); LWIP_UNUSED_ARG(pcb); /* packet received: stop retry timeout */ sys_untimeout(sntp_try_next_server, NULL); sys_untimeout(sntp_request, NULL); err = ERR_ARG; #if SNTP_CHECK_RESPONSE >= 1 /* check server address and port */ if (ip_addr_cmp(addr, &sntp_last_server_address) && (port == SNTP_PORT)) #else /* SNTP_CHECK_RESPONSE >= 1 */ LWIP_UNUSED_ARG(addr); LWIP_UNUSED_ARG(port); #endif /* SNTP_CHECK_RESPONSE >= 1 */ { /* process the response */ if (p->tot_len == SNTP_MSG_LEN) { pbuf_copy_partial(p, &mode, 1, SNTP_OFFSET_LI_VN_MODE); mode &= SNTP_MODE_MASK; /* if this is a SNTP response... */ if ((mode == SNTP_MODE_SERVER) || (mode == SNTP_MODE_BROADCAST)) { pbuf_copy_partial(p, &stratum, 1, SNTP_OFFSET_STRATUM); if (stratum == SNTP_STRATUM_KOD) { /* Kiss-of-death packet. Use another server or increase UPDATE_DELAY. */ err = SNTP_ERR_KOD; LWIP_DEBUGF(SNTP_DEBUG_STATE, ("sntp_recv: Received Kiss-of-Death\n")); } else { #if SNTP_CHECK_RESPONSE >= 2 /* check originate_timetamp against sntp_last_timestamp_sent */ u32_t originate_timestamp[2]; pbuf_copy_partial(p, &originate_timestamp, 8, SNTP_OFFSET_ORIGINATE_TIME); if ((originate_timestamp[0] != sntp_last_timestamp_sent[0]) || (originate_timestamp[1] != sntp_last_timestamp_sent[1])) { LWIP_DEBUGF(SNTP_DEBUG_WARN, ("sntp_recv: Invalid originate timestamp in response\n")); } else #endif /* SNTP_CHECK_RESPONSE >= 2 */ /* @todo: add code for SNTP_CHECK_RESPONSE >= 3 and >= 4 here */ { /* correct answer */ err = ERR_OK; pbuf_copy_partial(p, &receive_timestamp, SNTP_RECEIVE_TIME_SIZE * 4, SNTP_OFFSET_RECEIVE_TIME); } } } else { LWIP_DEBUGF(SNTP_DEBUG_WARN, ("sntp_recv: Invalid mode in response: %"U16_F"\n", (u16_t)mode)); } } else { LWIP_DEBUGF(SNTP_DEBUG_WARN, ("sntp_recv: Invalid packet length: %"U16_F"\n", p->tot_len)); } } pbuf_free(p); if (err == ERR_OK) { /* Correct response, reset retry timeout */ SNTP_RESET_RETRY_TIMEOUT(); sntp_process(receive_timestamp); /* Set up timeout for next request */ sys_timeout((u32_t)SNTP_UPDATE_DELAY, sntp_request, NULL); LWIP_DEBUGF(SNTP_DEBUG_STATE, ("sntp_recv: Scheduled next time request: %"U32_F" ms\n", (u32_t)SNTP_UPDATE_DELAY)); } else if (err == SNTP_ERR_KOD) { /* Kiss-of-death packet. Use another server or increase UPDATE_DELAY. */ sntp_try_next_server(NULL); } else { /* another error, try the same server again */ sntp_retry(NULL); } } /** Actually send an sntp request to a server. * * @param server_addr resolved IP address of the SNTP server */ static void ICACHE_FLASH_ATTR sntp_send_request(ip_addr_t *server_addr) { struct pbuf* p; // os_printf("sntp_send_request\n"); p = pbuf_alloc(PBUF_TRANSPORT, SNTP_MSG_LEN, PBUF_RAM); if (p != NULL) { struct sntp_msg *sntpmsg = (struct sntp_msg *)p->payload; LWIP_DEBUGF(SNTP_DEBUG_STATE, ("sntp_send_request: Sending request to server\n")); /* initialize request message */ sntp_initialize_request(sntpmsg); /* send request */ udp_sendto(sntp_pcb, p, server_addr, SNTP_PORT); /* free the pbuf after sending it */ pbuf_free(p); /* set up receive timeout: try next server or retry on timeout */ sys_timeout((u32_t)SNTP_RECV_TIMEOUT, sntp_try_next_server, NULL); #if SNTP_CHECK_RESPONSE >= 1 /* save server address to verify it in sntp_recv */ ip_addr_set(&sntp_last_server_address, server_addr); #endif /* SNTP_CHECK_RESPONSE >= 1 */ } else { LWIP_DEBUGF(SNTP_DEBUG_SERIOUS, ("sntp_send_request: Out of memory, trying again in %"U32_F" ms\n", (u32_t)SNTP_RETRY_TIMEOUT)); /* out of memory: set up a timer to send a retry */ sys_timeout((u32_t)SNTP_RETRY_TIMEOUT, sntp_request, NULL); } } #if SNTP_SERVER_DNS /** * DNS found callback when using DNS names as server address. */ static void sntp_dns_found(const char* hostname, ip_addr_t *ipaddr, void *arg) { LWIP_UNUSED_ARG(hostname); LWIP_UNUSED_ARG(arg); if (ipaddr != NULL) { /* Address resolved, send request */ LWIP_DEBUGF(SNTP_DEBUG_STATE, ("sntp_dns_found: Server address resolved, sending request\n")); sntp_send_request(ipaddr); } else { /* DNS resolving failed -> try another server */ LWIP_DEBUGF(SNTP_DEBUG_WARN_STATE, ("sntp_dns_found: Failed to resolve server address resolved, trying next server\n")); sntp_try_next_server(NULL); } } #endif /* SNTP_SERVER_DNS */ /** * Send out an sntp request. * * @param arg is unused (only necessary to conform to sys_timeout) */ static void ICACHE_FLASH_ATTR sntp_request(void *arg) { ip_addr_t sntp_server_address; err_t err; LWIP_UNUSED_ARG(arg); /* initialize SNTP server address */ #if SNTP_SERVER_DNS if (sntp_servers[sntp_current_server].name) { /* always resolve the name and rely on dns-internal caching & timeout */ ip_addr_set_any(&sntp_servers[sntp_current_server].addr); err = dns_gethostbyname(sntp_servers[sntp_current_server].name, &sntp_server_address, sntp_dns_found, NULL); if (err == ERR_INPROGRESS) { /* DNS request sent, wait for sntp_dns_found being called */ LWIP_DEBUGF(SNTP_DEBUG_STATE, ("sntp_request: Waiting for server address to be resolved.\n")); return; } else if (err == ERR_OK) { sntp_servers[sntp_current_server].addr = sntp_server_address; } } else #endif /* SNTP_SERVER_DNS */ { sntp_server_address = sntp_servers[sntp_current_server].addr; // os_printf("sntp_server_address ip %d\n",sntp_server_address.addr); err = (ip_addr_isany(&sntp_server_address)) ? ERR_ARG : ERR_OK; } if (err == ERR_OK) { LWIP_DEBUGF(SNTP_DEBUG_TRACE, ("sntp_request: current server address is %u.%u.%u.%u\n", ip4_addr1(&sntp_server_address), ip4_addr2(&sntp_server_address), ip4_addr3(&sntp_server_address), ip4_addr4(&sntp_server_address))); sntp_send_request(&sntp_server_address); } else { /* address conversion failed, try another server */ LWIP_DEBUGF(SNTP_DEBUG_WARN_STATE, ("sntp_request: Invalid server address, trying next server.\n")); sys_timeout((u32_t)SNTP_RETRY_TIMEOUT, sntp_try_next_server, NULL); } } /** * Initialize this module. * Send out request instantly or after SNTP_STARTUP_DELAY(_FUNC). */ void ICACHE_FLASH_ATTR sntp_init(void) { #ifdef SNTP_SERVER_ADDRESS #if SNTP_SERVER_DNS sntp_setservername(0, SNTP_SERVER_ADDRESS); #else #error SNTP_SERVER_ADDRESS string not supported SNTP_SERVER_DNS==0 #endif #endif /* SNTP_SERVER_ADDRESS */ if (sntp_pcb == NULL) { SNTP_RESET_RETRY_TIMEOUT(); sntp_pcb = udp_new(); LWIP_ASSERT("Failed to allocate udp pcb for sntp client", sntp_pcb != NULL); if (sntp_pcb != NULL) { udp_recv(sntp_pcb, sntp_recv, NULL); #if SNTP_STARTUP_DELAY sys_timeout((u32_t)SNTP_STARTUP_DELAY_FUNC, sntp_request, NULL); #else sntp_request(NULL); #endif } } } /** * Stop this module. */ void ICACHE_FLASH_ATTR sntp_stop(void) { if (sntp_pcb != NULL) { sys_untimeout(sntp_request, NULL); udp_remove(sntp_pcb); sntp_pcb = NULL; } os_timer_disarm(&sntp_timer); realtime_stamp = 0; } #if SNTP_GET_SERVERS_FROM_DHCP /** * Config SNTP server handling by IP address, name, or DHCP; clear table * @param set_servers_from_dhcp enable or disable getting server addresses from dhcp */ void sntp_servermode_dhcp(int set_servers_from_dhcp) { u8_t new_mode = set_servers_from_dhcp ? 1 : 0; if (sntp_set_servers_from_dhcp != new_mode) { sntp_set_servers_from_dhcp = new_mode; } } #endif /* SNTP_GET_SERVERS_FROM_DHCP */ /** * Initialize one of the NTP servers by IP address * * @param numdns the index of the NTP server to set must be < SNTP_MAX_SERVERS * @param dnsserver IP address of the NTP server to set */ void ICACHE_FLASH_ATTR sntp_setserver(u8_t idx, ip_addr_t *server) { if (idx < SNTP_MAX_SERVERS) { if (server != NULL) { sntp_servers[idx].addr = (*server); // os_printf("server ip %d\n",server->addr); } else { ip_addr_set_any(&sntp_servers[idx].addr); } #if SNTP_SERVER_DNS sntp_servers[idx].name = NULL; #endif } } #if LWIP_DHCP && SNTP_GET_SERVERS_FROM_DHCP /** * Initialize one of the NTP servers by IP address, required by DHCP * * @param numdns the index of the NTP server to set must be < SNTP_MAX_SERVERS * @param dnsserver IP address of the NTP server to set */ void dhcp_set_ntp_servers(u8_t num, ip_addr_t *server) { LWIP_DEBUGF(SNTP_DEBUG_TRACE, ("sntp: %s %u.%u.%u.%u as NTP server #%u via DHCP\n", (sntp_set_servers_from_dhcp ? "Got" : "Rejected"), ip4_addr1(server), ip4_addr2(server), ip4_addr3(server), ip4_addr4(server), num)); if (sntp_set_servers_from_dhcp && num) { u8_t i; for (i = 0; (i < num) && (i < SNTP_MAX_SERVERS); i++) { sntp_setserver(i, &server[i]); } for (i = num; i < SNTP_MAX_SERVERS; i++) { sntp_setserver(i, NULL); } } } #endif /* LWIP_DHCP && SNTP_GET_SERVERS_FROM_DHCP */ /** * Obtain one of the currently configured by IP address (or DHCP) NTP servers * * @param numdns the index of the NTP server * @return IP address of the indexed NTP server or "ip_addr_any" if the NTP * server has not been configured by address (or at all). */ ip_addr_t ICACHE_FLASH_ATTR sntp_getserver(u8_t idx) { if (idx < SNTP_MAX_SERVERS) { return sntp_servers[idx].addr; } return *IP_ADDR_ANY; } #if SNTP_SERVER_DNS /** * Initialize one of the NTP servers by name * * @param numdns the index of the NTP server to set must be < SNTP_MAX_SERVERS * @param dnsserver DNS name of the NTP server to set, to be resolved at contact time */ void ICACHE_FLASH_ATTR sntp_setservername(u8_t idx, char *server) { if (idx < SNTP_MAX_SERVERS) { sntp_servers[idx].name = server; } } /** * Obtain one of the currently configured by name NTP servers. * * @param numdns the index of the NTP server * @return IP address of the indexed NTP server or NULL if the NTP * server has not been configured by name (or at all) */ char * ICACHE_FLASH_ATTR sntp_getservername(u8_t idx) { if (idx < SNTP_MAX_SERVERS) { return sntp_servers[idx].name; } return NULL; } #endif /* SNTP_SERVER_DNS */ #endif /* LWIP_UDP */ ================================================ FILE: app/lwip/core/stats.c ================================================ /** * @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 struct stats_ lwip_stats; void stats_init(void) { #ifdef LWIP_DEBUG #if MEMP_STATS const char * memp_names[] = { #define LWIP_MEMPOOL(name,num,size,desc) desc, #include "lwip/memp_std.h" }; 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, 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 void stats_display_igmp(struct stats_igmp *igmp) { LWIP_PLATFORM_DIAG(("\nIGMP\n\t")); 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", igmp->rx_group)); LWIP_PLATFORM_DIAG(("rx_general: %"STAT_COUNTER_F"\n", 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 */ #if MEM_STATS || MEMP_STATS void stats_display_mem(struct stats_mem *mem, 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) { char * memp_names[] = { #define LWIP_MEMPOOL(name,num,size,desc) desc, #include "lwip/memp_std.h" }; 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(); IP_STATS_DISPLAY(); IGMP_STATS_DISPLAY(); ICMP_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 */ ================================================ FILE: app/lwip/core/sys.c ================================================ /** * @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 /** * 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 /* !NO_SYS */ ================================================ FILE: app/lwip/core/sys_arch.c ================================================ /* * copyright (c) 2010 - 2011 espressif system */ #include "c_types.h" #include "ets_sys.h" #include "osapi.h" #include "os_type.h" #include "lwip/opt.h" #include "lwip/sys.h" #include "eagle_soc.h" ================================================ FILE: app/lwip/core/tcp.c ================================================ /** * @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/snmp.h" #include "lwip/tcp.h" #include "lwip/tcp_impl.h" #include "lwip/debug.h" #include "lwip/stats.h" #include #ifdef MEMLEAK_DEBUG static const char mem_debug_file[] ICACHE_RODATA_ATTR = __FILE__; #endif #if TCP_DEBUG const char tcp_state_str_rodata[][12] ICACHE_RODATA_ATTR = { "CLOSED", "LISTEN", "SYN_SENT", "SYN_RCVD", "ESTABLISHED", "FIN_WAIT_1", "FIN_WAIT_2", "CLOSE_WAIT", "CLOSING", "LAST_ACK", "TIME_WAIT" }; char tcp_state_str[12]; #endif /* Incremented every coarse grained timer shot (typically every 500 ms). */ u32_t tcp_ticks; const u8_t tcp_backoff[13] ICACHE_RODATA_ATTR = { 1, 2, 3, 4, 5, 6, 7, 7, 7, 7, 7, 7, 7}; /* Times per slowtmr hits */ const u8_t tcp_persist_backoff[7] ICACHE_RODATA_ATTR = { 3, 6, 12, 24, 48, 96, 120 }; /* 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; #define NUM_TCP_PCB_LISTS 4 #define NUM_TCP_PCB_LISTS_NO_TIME_WAIT 3 /** An array with all (non-temporary) PCB lists, mainly used for smaller code size */ struct tcp_pcb ** const tcp_pcb_lists[] ICACHE_RODATA_ATTR = {&tcp_listen_pcbs.pcbs, &tcp_bound_pcbs, &tcp_active_pcbs, &tcp_tw_pcbs}; /** Only used for temporary storage. */ struct tcp_pcb *tcp_tmp_pcb; /** Timer counter to handle calling slow-timer from tcp_tmr() */ static u8_t tcp_timer; static u16_t tcp_new_port(void);//����µ�tcp���ض˿� /** * Called periodically to dispatch TCP timers. * */ void tcp_tmr(void) { /* Call tcp_fasttmr() every 250 ms */ tcp_fasttmr(); if (++tcp_timer & 1) { /* Call tcp_tmr() 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 != LISTEN)) { if ((pcb->refused_data != NULL) || (pcb->rcv_wnd != TCP_WND)) { /* 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); /* TODO: to which state do we move now? */ /* move to TIME_WAIT since we close actively */ TCP_RMV(&tcp_active_pcbs, pcb); pcb->state = TIME_WAIT; TCP_REG(&tcp_tw_pcbs, 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. */ /*��CLOSED״̬�¹ر�һ��pcb�ƺ��Ǵ���ģ� *������ˣ�һ�������״̬�·����˶��һ�û��ʹ��,�û���ҪһЩ�취���ͷ��� *����һ���Ѿ����رյ�pcb��tcp_close(),(��2��)����һ���Ѿ���ʹ����֮�󣬽���CLOSE״̬�Ǵ���� *������Щ����±��ͷŵ�pcb�Dz�����ڵ�,��ˣ��κ�ʣ��ľ���Ǽٵ� */ err = ERR_OK;//�趨����ֵ if (pcb->local_port != 0) { TCP_RMV(&tcp_bound_pcbs, pcb); } memp_free(MEMP_TCP_PCB, pcb);//��MEMP_TCP_PCB�ڴ���趨�ͷŵ���pcb��Ӧ�ĵ�Ԫֵ,�ͷ��ڴ� pcb = NULL; break; case LISTEN: err = ERR_OK; tcp_pcb_remove(&tcp_listen_pcbs.pcbs, pcb);//�Ӽ����PCB�б���ɾ���Ӧ��pcb memp_free(MEMP_TCP_PCB_LISTEN, pcb);//��MEMP_TCP_PCB_LISTEN�ڴ�����趨�ͷŵ�pcb��Ԫֵ ,�ͷ��ڴ� pcb = NULL; break; case SYN_SENT: err = ERR_OK; tcp_pcb_remove(&tcp_active_pcbs, pcb); memp_free(MEMP_TCP_PCB, pcb); pcb = NULL; snmp_inc_tcpattemptfails(); break; case SYN_RCVD: err = tcp_send_fin(pcb);//���������ر�FIN���ֱ��� if (err == ERR_OK) { snmp_inc_tcpattemptfails(); pcb->state = FIN_WAIT_1;//ת��FIN_WAIT_1״̬ } break; case ESTABLISHED: err = tcp_send_fin(pcb); if (err == ERR_OK) { snmp_inc_tcpestabresets(); pcb->state = FIN_WAIT_1; } break; case CLOSE_WAIT: err = tcp_send_fin(pcb); if (err == ERR_OK) { snmp_inc_tcpestabresets(); pcb->state = LAST_ACK;//����LAST_ACK�ȴ�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. */ /* @todo: When implementing SO_LINGER, this must be changed somehow: If SOF_LINGER is set, the data should be sent and acked before close returns. This can only be valid for sequential APIs, not for the raw API. */ tcp_output(pcb);//���ú����Ϳ��ƿ������ʣ��ı��ģ�����FIN���ֱ��Ķ� } 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 */ /* *ͨ��PCB�ر��������� *�����е�pcbӦ�ñ��ͷŵģ�Ҳ����ԶҲ���ᱻʹ���� *���û�����ӻ�����Ҳû�б�����,���ӵ�pcbӦ�ñ��ͷŵ� *���һ�����ӱ�����(����SYN�Ѿ������ջ�����һ���ر��е�״̬) *���ӱ��ر��ˣ�����������һ�����ڹرյ�״̬ *pcb�Զ���tcp_slowtmr()�ͷ�,�����������Dz���ȫ�� */ err_t tcp_close(struct tcp_pcb *pcb) { #if TCP_DEBUG //TCP debug��Ϣ����ӡpcb��״̬ LWIP_DEBUGF(TCP_DEBUG, ("tcp_close: closing in ")); tcp_debug_print_state(pcb->state); #endif /* TCP_DEBUG */ 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! * * @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: free buffered data... */ if (pcb->refused_data != NULL) { pbuf_free(pcb->refused_data); pcb->refused_data = NULL; } /* ... and set a flag not to receive any more data */ pcb->flags |= TF_RXCLOSED; } 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, 0); default: /* don't shut down other states */ break; } } /* @todo: return another err_t if not in correct state or already shut? */ 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; u16_t remote_port, local_port; ip_addr_t remote_ip, local_ip; #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 { seqno = pcb->snd_nxt; ackno = pcb->rcv_nxt; ip_addr_copy(local_ip, pcb->local_ip); ip_addr_copy(remote_ip, pcb->remote_ip); local_port = pcb->local_port; remote_port = pcb->remote_port; #if LWIP_CALLBACK_API errf = pcb->errf; #endif /* LWIP_CALLBACK_API */ errf_arg = pcb->callback_arg; tcp_pcb_remove(&tcp_active_pcbs, 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 (reset) { LWIP_DEBUGF(TCP_RST_DEBUG, ("tcp_abandon: sending RST\n")); tcp_rst(seqno, ackno, &local_ip, &remote_ip, local_port, remote_port); } TCP_EVENT_ERR(errf, errf_arg, ERR_ABRT); memp_free(MEMP_TCP_PCB, pcb); } } /** * 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 portnumber 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_OK if bound */ err_t tcp_bind(struct tcp_pcb *pcb, ip_addr_t *ipaddr, u16_t port) { int i; int max_pcb_list = NUM_TCP_PCB_LISTS; struct tcp_pcb *cpcb; LWIP_ERROR("tcp_bind: can only bind in state CLOSED", pcb->state == CLOSED, return ERR_ISCONN); #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 ((pcb->so_options & SOF_REUSEADDR) != 0) { max_pcb_list = NUM_TCP_PCB_LISTS_NO_TIME_WAIT; } #endif /* SO_REUSE */ if (port == 0) { port = tcp_new_port(); } /* 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 (((pcb->so_options & SOF_REUSEADDR) == 0) || ((cpcb->so_options & SOF_REUSEADDR) == 0)) #endif /* SO_REUSE */ { if (ip_addr_isany(&(cpcb->local_ip)) || ip_addr_isany(ipaddr) || ip_addr_cmp(&(cpcb->local_ip), ipaddr)) { //os_printf("Address in use\n"); return ERR_USE; } } } } } if (!ip_addr_isany(ipaddr)) { 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(pcb); LWIP_UNUSED_ARG(err); 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. *��ij���󶨵Ŀ��ƿ���Ϊ����״̬ * @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 ((pcb->so_options & SOF_REUSEADDR) != 0) { /* 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) { if (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->so_options |= SOF_ACCEPTCONN; lpcb->ttl = pcb->ttl; lpcb->tos = pcb->tos; 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; lpcb->backlog = (backlog ? backlog : 1); #endif /* TCP_LISTEN_BACKLOG */ TCP_REG(&tcp_listen_pcbs.pcbs, (struct tcp_pcb *)lpcb);//���ƿ����tcp_listen_pcbs�����ײ� 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; LWIP_ASSERT("new_rcv_ann_wnd <= 0xffff", new_rcv_ann_wnd <= 0xffff); pcb->rcv_ann_wnd = (u16_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; LWIP_ASSERT("tcp_recved: len would wrap rcv_wnd\n", len <= 0xffff - pcb->rcv_wnd ); pcb->rcv_wnd += len; if (pcb->rcv_wnd > TCP_WND) { pcb->rcv_wnd = TCP_WND; } 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: recveived %"U16_F" bytes, wnd %"U16_F" (%"U16_F").\n", len, pcb->rcv_wnd, TCP_WND - pcb->rcv_wnd)); } /** * A nastly hack featuring 'goto' statements that allocates a * new TCP local port. * * @return a new (free) local TCP port number */ static u16_t tcp_new_port(void) { int i; struct tcp_pcb *pcb; #ifndef TCP_LOCAL_PORT_RANGE_START #define TCP_LOCAL_PORT_RANGE_START 4096 #define TCP_LOCAL_PORT_RANGE_END 0x7fff #endif static u16_t port = TCP_LOCAL_PORT_RANGE_START; again: if (++port >= TCP_LOCAL_PORT_RANGE_END) { port = TCP_LOCAL_PORT_RANGE_START; } /* 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 == port) { goto again; } } } return port; } /** * Connects to another host. The function given as the "connected" * argument will be called when the connection has been established. *�����������һ��SYN���ֱ��� * @param pcb the tcp_pcb used to establish the connection �����Ŀ��ƿ���� * @param ipaddr the remote ip address to connect to ������IP��ַ * @param port the remote tcp port to connect to �������˿ں� * @param connected callback function to call when connected (or on error) * @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, ip_addr_t *ipaddr, u16_t port, tcp_connected_fn connected) { err_t ret; u32_t iss; u16_t old_local_port; LWIP_ERROR("tcp_connect: can only connected from state CLOSED", pcb->state == CLOSED, return ERR_ISCONN); LWIP_DEBUGF(TCP_DEBUG, ("tcp_connect to port %"U16_F"\n", port)); if (ipaddr != NULL) { pcb->remote_ip = *ipaddr;//������IP��ַ��Ч�������Ӽ�¼�м�¼��IP��ַ�����򷵻ش��� } else { return ERR_VAL; } 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 = ip_route(&(pcb->remote_ip)); if (netif == NULL) { /* Don't even try to send a SYN packet if we have no route since that will fail. */ return ERR_RTE; } /* Use the netif's IP address as local address. */ ip_addr_copy(pcb->local_ip, netif->ip_addr); } old_local_port = pcb->local_port; if (pcb->local_port == 0) { pcb->local_port = tcp_new_port(); } #if SO_REUSE if ((pcb->so_options & SOF_REUSEADDR) != 0) { /* 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; pcb->rcv_wnd = TCP_WND;//����Ĭ�Ͻ��մ��ڸ����ֶ�ֵ pcb->rcv_ann_wnd = 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, ipaddr); #endif /* TCP_CALCULATE_EFF_SEND_MSS */ pcb->cwnd = 1;//��ʼ������� pcb->ssthresh = pcb->mss * 10; #if LWIP_CALLBACK_API pcb->connected = 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 ���ƿ�����ΪSYN_SENT ״̬*/ pcb->state = SYN_SENT; if (old_local_port != 0) { TCP_RMV(&tcp_bound_pcbs, pcb); } TCP_REG(&tcp_active_pcbs, pcb); snmp_inc_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; u16_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; /* 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); 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. */ pcb->persist_cnt++; if (pcb->persist_cnt >= system_get_data_of_array_8(tcp_persist_backoff, pcb->persist_backoff-1)) { pcb->persist_cnt = 0; if (pcb->persist_backoff < sizeof(tcp_persist_backoff)) { pcb->persist_backoff++; } tcp_zero_window_probe(pcb); } } 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) { pcb->rto = ((pcb->sa >> 3) + pcb->sv) << system_get_data_of_array_8(tcp_backoff, pcb->nrtx); // if (pcb->rto >= TCP_MAXRTO) // pcb->rto >>= 1; } /* 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 < (pcb->mss << 1)) { pcb->ssthresh = (pcb->mss << 1); } pcb->cwnd = pcb->mss; LWIP_DEBUGF(TCP_CWND_DEBUG, ("tcp_slowtmr: cwnd %"U16_F " ssthresh %"U16_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 ((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((pcb->so_options & SOF_KEEPALIVE) && ((pcb->state == ESTABLISHED) || (pcb->state == CLOSE_WAIT))) { #if LWIP_TCP_KEEPALIVE if((u32_t)(tcp_ticks - pcb->tmr) > (pcb->keep_idle + (pcb->keep_cnt*pcb->keep_intvl)) / TCP_SLOW_INTERVAL) #else if((u32_t)(tcp_ticks - pcb->tmr) > (pcb->keep_idle + TCP_MAXIDLE) / TCP_SLOW_INTERVAL) #endif /* LWIP_TCP_KEEPALIVE */ { LWIP_DEBUGF(TCP_DEBUG, ("tcp_slowtmr: KEEPALIVE timeout. Aborting connection to %"U16_F".%"U16_F".%"U16_F".%"U16_F".\n", ip4_addr1_16(&pcb->remote_ip), ip4_addr2_16(&pcb->remote_ip), ip4_addr3_16(&pcb->remote_ip), ip4_addr4_16(&pcb->remote_ip))); ++pcb_remove; ++pcb_reset; } #if LWIP_TCP_KEEPALIVE else if((u32_t)(tcp_ticks - pcb->tmr) > (pcb->keep_idle + pcb->keep_cnt_sent * pcb->keep_intvl) / TCP_SLOW_INTERVAL) #else else if((u32_t)(tcp_ticks - pcb->tmr) > (pcb->keep_idle + pcb->keep_cnt_sent * TCP_KEEPINTVL_DEFAULT) / TCP_SLOW_INTERVAL) #endif /* LWIP_TCP_KEEPALIVE */ { tcp_keepalive(pcb); 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_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); } TCP_EVENT_ERR(pcb->errf, pcb->callback_arg, ERR_ABRT); pcb2 = pcb; pcb = pcb->next; memp_free(MEMP_TCP_PCB, pcb2); } 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_EVENT_POLL(prev, err); /* 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_active_pcbs; while(pcb != NULL) { struct tcp_pcb *next = pcb->next; /* If there is data which was previously "refused" by upper layer */ if (pcb->refused_data != NULL) { /* Notify again application with data previously received. */ err_t err; LWIP_DEBUGF(TCP_INPUT_DEBUG, ("tcp_fasttmr: notify kept packet\n")); TCP_EVENT_RECV(pcb, pcb->refused_data, ERR_OK, err); if (err == ERR_OK) { pcb->refused_data = NULL; } else if (err == ERR_ABRT) { /* if err == ERR_ABRT, 'pcb' is already deallocated */ pcb = NULL; } } /* send delayed ACKs */ if (pcb && (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); } pcb = next; } } /** * 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 lower priority than prio. * * @param prio minimum priority */ static void ICACHE_FLASH_ATTR tcp_kill_prio(u8_t prio) { struct tcp_pcb *pcb, *inactive; u32_t inactivity; u8_t mprio; mprio = TCP_PRIO_MAX; /* 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 <= prio && 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 TIME_WAIT state. * Called from tcp_alloc() if no more connections are available. */ static void ICACHE_FLASH_ATTR 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); } } /** * Allocate a new tcp_pcb structure. *����һ��TCP���ƿ�ṹ������ʼ������ֶ� * @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; pcb = (struct tcp_pcb *)memp_malloc(MEMP_TCP_PCB);//�����ڴ�ؿռ� if (pcb == NULL) { //os_printf("tcp_pcb memory is fail\n"); /* 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 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 twice before */ MEMP_STATS_DEC(err, MEMP_TCP_PCB); } } if (pcb != NULL) { /* adjust err stats: timewait PCB was freed above */ MEMP_STATS_DEC(err, MEMP_TCP_PCB); } } if (pcb != NULL) { os_memset(pcb, 0, sizeof(struct tcp_pcb)); //��0 pcb->prio = prio; //�������ȼ� pcb->snd_buf = TCP_SND_BUF; //��ʹ�õķ��ͻ������С pcb->snd_queuelen = 0; //��������ռ�õ�pbuf���� pcb->rcv_wnd = TCP_WND; //���մ��� pcb->rcv_ann_wnd = TCP_WND; //ͨ����մ��� pcb->tos = 0; //�������� pcb->ttl = TCP_TTL; //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 = 1000 / TCP_SLOW_INTERVAL; //��ʼ����ʱʱ�� pcb->sa = 0; //��ʼ����RTT��صIJ��� pcb->sv = 1000 / 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->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); } /** * Used to specify the argument that should be passed callback * functions. *����ƿ��callback_arg�ֶ�ע���û���ݣ���tcp_recv�Ⱥ���ص�ʱ�� * ���ֶν���Ϊ����ݸ�������� * @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) { pcb->callback_arg = arg; } #if LWIP_CALLBACK_API /** * Used to specify the function that should be called when a TCP * connection receives data. *����ƿ��recv�ֶ�ע�ắ���յ����ʱ�ص� * @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) { pcb->recv = recv; } /** * Used to specify the function that should be called when TCP data * has been successfully delivered to the remote host. *����ƿ�send �ֶ�ע�ắ����ݷ��ͳɹ���ص� * @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) { pcb->sent = sent; } /** * Used to specify the function that should be called when a fatal error * has occured on the connection. *����ƿ�err �ֶ�ע�ắ�����������ص� * @param pcb tcp_pcb to set the err callback * @param err callback function to call for this pcb when a fatal error * has occured on the connection */ void tcp_err(struct tcp_pcb *pcb, tcp_err_fn err) { pcb->errf = err; } /** * Used for specifying the function that should be called when a * LISTENing connection has been connected to another host. *����ƿ��accept�ֶ�ע�ắ����������ʱ�ص� * @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) { 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. *����ƿ��POLL�ֶ�ע�ắ��ú��������Ա����� */ void tcp_poll(struct tcp_pcb *pcb, tcp_poll_fn poll, u8_t interval) { #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_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; 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; again: iss += tcp_ticks; /* XXX */ if (iss == 0) goto again; return iss; } #if TCP_CALCULATE_EFF_SEND_MSS /** * Calcluates the effective send mss that can be used for a specific IP address * by using ip_route to determin 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(u16_t sendmss, ip_addr_t *addr) { u16_t mss_s; struct netif *outif; outif = ip_route(addr); if ((outif != NULL) && (outif->mtu != 0)) { mss_s = outif->mtu - IP_HLEN - TCP_HLEN; /* 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 TCP_DEBUG const char* tcp_debug_state_str(enum tcp_state s) { system_get_string_from_flash(tcp_state_str_rodata[s], tcp_state_str, 12); return tcp_state_str; } #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 */ ================================================ FILE: app/lwip/core/tcp_in.c ================================================ /** * @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/tcp_impl.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/snmp.h" #include "arch/perf.h" #ifdef MEMLEAK_DEBUG static const char mem_debug_file[] ICACHE_RODATA_ATTR = __FILE__; #endif /* 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; //tcp_seg�ṹ����������ı��Ķ� static struct tcp_hdr *tcphdr; //���Ķ���TCP�ײ� static struct ip_hdr *iphdr; //IP��ݰ��ײ� static u32_t seqno, ackno; //TCP�ײ�������ֶ���ȷ�Ϻ��ֶ� static u8_t flags; //�ײ���־�ֶ� static u16_t tcplen; //TCP���ij��� static u8_t recv_flags; //��ǰ���Ĵ����� static struct pbuf *recv_data; //���Ķ����pbuf struct tcp_pcb *tcp_input_pcb; //��ǰ���Ŀ��ƿ� /* Forward declarations. */ static err_t tcp_process(struct tcp_pcb *pcb)ICACHE_FLASH_ATTR; static void tcp_receive(struct tcp_pcb *pcb)ICACHE_FLASH_ATTR; static void tcp_parseopt(struct tcp_pcb *pcb)ICACHE_FLASH_ATTR; static err_t tcp_listen_input(struct tcp_pcb_listen *pcb)ICACHE_FLASH_ATTR; static err_t tcp_timewait_input(struct tcp_pcb *pcb)ICACHE_FLASH_ATTR; /** * 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 IP header) * @param inp network interface on which this segment was received */ /** * TCP��ʼ�����봦�?��֤��TCPͷ���������IP����� * @����p:������յ�TCP��(ָ��IPͷ�ĸ���) * @����inp:���նε�����ӿ� */ 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; PERF_START; TCP_STATS_INC(tcp.recv); //״̬��1 snmp_inc_tcpinsegs(); //tcp����μ�1 iphdr = (struct ip_hdr *)p->payload;// pointer to the actual data in the buffer /* *��ͷ����(IHL)��4λ��IPЭ���ͷ�ij��ȣ�ָ��IPv4Э���ͷ���ȵ��ֽ������ٸ�32λ�� *����IPv4�İ�ͷ���ܰ�ɱ������Ŀ�ѡ ���������ֶο�������ȷ��IPv4��ݱ�����ݲ��ֵ�ƫ������ *IPv4��ͷ����С������20���ֽڣ����IHL����ֶε���Сֵ��ʮ���Ʊ�ʾ����5 (5x4 = 20�ֽ�)�� *����˵�����ʾ�İ�ͷ�����ֽ�����4�ֽڵı��� */ tcphdr = (struct tcp_hdr *)((u8_t *)p->payload + IPH_HL(iphdr) * 4); #if TCP_INPUT_DEBUG tcp_debug_print(tcphdr); #endif /* remove header from payload */ if (pbuf_header(p, -((s16_t)(IPH_HL(iphdr) * 4))) || (p->tot_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);//���󳤶ȼ��� TCP_STATS_INC(tcp.drop);//��ֹ���� snmp_inc_tcpinerrs(); pbuf_free(p);//�ͷ�buffer return; } /* Don't even process incoming broadcasts/multicasts. */ if (ip_addr_isbroadcast(¤t_iphdr_dest, inp) || ip_addr_ismulticast(¤t_iphdr_dest)) { TCP_STATS_INC(tcp.proterr);//Э�������� TCP_STATS_INC(tcp.drop); snmp_inc_tcpinerrs(); pbuf_free(p); return; } #if CHECKSUM_CHECK_TCP /* Verify TCP checksum. */ if (inet_chksum_pseudo(p, ip_current_src_addr(), ip_current_dest_addr(), IP_PROTO_TCP, p->tot_len) != 0) { LWIP_DEBUGF(TCP_INPUT_DEBUG, ("tcp_input: packet discarded due to failing checksum 0x%04"X16_F"\n", inet_chksum_pseudo(p, ip_current_src_addr(), ip_current_dest_addr(), IP_PROTO_TCP, p->tot_len))); #if TCP_DEBUG tcp_debug_print(tcphdr); #endif /* TCP_DEBUG */ TCP_STATS_INC(tcp.chkerr);//У�������� TCP_STATS_INC(tcp.drop); snmp_inc_tcpinerrs(); pbuf_free(p); return; } #endif /* Move the payload pointer in the pbuf so that it points to the TCP data instead of the TCP header. */ hdrlen = TCPH_HDRLEN(tcphdr);//����ͷ�ij��� if(pbuf_header(p, -(hdrlen * 4))){//���TCPͷ������0Ϊ�ɹ������� /* drop short packets */ LWIP_DEBUGF(TCP_INPUT_DEBUG, ("tcp_input: short packet\n")); TCP_STATS_INC(tcp.lenerr);//tcp���ȴ������ TCP_STATS_INC(tcp.drop); snmp_inc_tcpinerrs(); pbuf_free(p); return; } /* 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); //ת��tcp���� flags = TCPH_FLAGS(tcphdr);//�õ�tcp header�ı�־ /* *��־��3λ�����ֶΣ��� * ����λ��1λ * ���ֶ�λ��1λ��ȡֵ��0��������ݱ��ֶΣ���1����ݱ����ֶܷΣ� * ����λ��1λ��ȡֵ��0����ݰ����û�а�1����ݰ�����и��İ� */ tcplen = p->tot_len + ((flags & (TCP_FIN | TCP_SYN)) ? 1 : 0);//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), ¤t_iphdr_src) && ip_addr_cmp(&(pcb->local_ip), ¤t_iphdr_dest)) {//�����صĵ�ַ /* 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;//pcb������ǰ�� } LWIP_ASSERT("tcp_input: pcb->next != pcb (after cache)", pcb->next != pcb); break; } prev = pcb;//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) {//����ȴ�״̬�µ�pcb 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), ¤t_iphdr_src) && ip_addr_cmp(&(pcb->local_ip), ¤t_iphdr_dest)) { /* 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);//����tcp timewait �İ� 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) {//�������״̬�����е�pcb if (lpcb->local_port == tcphdr->dest) { #if SO_REUSE if (ip_addr_cmp(&(lpcb->local_ip), ¤t_iphdr_dest)) { /* found an exact match */ break; } else if(ip_addr_isany(&(lpcb->local_ip))) { /* found an ANY-match */ lpcb_any = lpcb; lpcb_prev = prev; } #else /* SO_REUSE */ if (ip_addr_cmp(&(lpcb->local_ip), ¤t_iphdr_dest) || ip_addr_isany(&(lpcb->local_ip))) { /* found a match */ 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; } LWIP_DEBUGF(TCP_INPUT_DEBUG, ("tcp_input: packed for LISTENing connection.\n")); tcp_listen_input(lpcb);//����tcp������ݰ� 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) { /* The incoming segment belongs to a connection. */ #if TCP_INPUT_DEBUG #if TCP_DEBUG tcp_debug_print_state(pcb->state); #endif /* TCP_DEBUG */ #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 there is data which was previously "refused" by upper layer */ if (pcb->refused_data != NULL) { /* Notify again application with data previously received. */ LWIP_DEBUGF(TCP_INPUT_DEBUG, ("tcp_input: notify kept packet\n")); TCP_EVENT_RECV(pcb, pcb->refused_data, ERR_OK, err);//pcb������� if (err == ERR_OK) { pcb->refused_data = NULL; } else if ((err == ERR_ABRT) || (tcplen > 0)) { /* 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")); TCP_STATS_INC(tcp.drop);//tcp������� snmp_inc_tcpinerrs(); pbuf_free(p); return; } } 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);//ɾ���pcb�б��е�pcb memp_free(MEMP_TCP_PCB, pcb); } else 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); } 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) { TCP_EVENT_SENT(pcb, pcb->acked, err);//����ݱ�ȷ�ϣ��ص��û���send���� if (err == ERR_ABRT) { goto aborted; } } if (recv_data != NULL) {//����ݽ��յ� 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); tcp_abort(pcb); goto aborted; } //PSH��־ PSH ����λ�� //��PSH=1ʱ��Ҫ���ͷ����Ϸ��͸÷ֶΣ� //����շ�����Ľ����Ľ���Ӧ�ò㣬�������д��? if (flags & TCP_PSH) { recv_data->flags |= PBUF_FLAG_PUSH;//���bufferӦ������������ } /* Notify application that data has been received. */ TCP_EVENT_RECV(pcb, recv_data, ERR_OK, err); if (err == ERR_ABRT) { goto aborted; } /* If the upper layer can't receive this data, store it */ if (err != ERR_OK) { pcb->refused_data = recv_data; LWIP_DEBUGF(TCP_INPUT_DEBUG, ("tcp_input: keep incoming packet, because pcb is \"full\"\n")); } } /* If a FIN segment was received, we call the callback function with a NULL buffer to indicate EOF. */ if (recv_flags & TF_GOT_FIN) { /* correct rcv_wnd as the application won't call tcp_recved() for the FIN's seqno */ if (pcb->rcv_wnd != TCP_WND) { 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);//�ͷ�buffer inseg.p = NULL; } /*add processing queue segments that arrive out of order by LiuHan*/ #if TCP_QUEUE_OOSEQ extern char RxNodeNum(void); if (RxNodeNum() < 2){ extern void pbuf_free_ooseq_new(void* arg); // os_printf("reclaim some memory from queued\n"); pbuf_free_ooseq_new(NULL); } #endif } 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������� tcp_rst(ackno, seqno + tcplen, ip_current_dest_addr(), ip_current_src_addr(), tcphdr->dest, tcphdr->src);//����TCP��λ } pbuf_free(p); } LWIP_ASSERT("tcp_input: tcp_pcbs_sane()", tcp_pcbs_sane()); PERF_STOP("tcp_input"); } /** * 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 */ /* *����LISTEN״̬�Ŀ��ƿ���øú��� *ͨ���Ƿ�������������һ���˿ڲ�����ͻ���SYN�������� * */ static err_t tcp_listen_input(struct tcp_pcb_listen *pcb) { struct tcp_pcb *npcb; struct tcp_pcb *pactive_pcb; u8_t active_pcb_num = 0; err_t rc; /* 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 + 1, seqno + tcplen, ip_current_dest_addr(), ip_current_src_addr(), tcphdr->dest, tcphdr->src); } else if (flags & TCP_SYN) {//�յ�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 */ for(pactive_pcb = tcp_active_pcbs; pactive_pcb != NULL; pactive_pcb = pactive_pcb->next) active_pcb_num ++; if (active_pcb_num == MEMP_NUM_TCP_PCB){ LWIP_DEBUGF(TCP_DEBUG, ("tcp_listen_input: exceed the number of active TCP connections\n")); TCP_STATS_INC(tcp.memerr); return ERR_MEM; } 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);//TCP�ڴ������� return ERR_MEM; } #if TCP_LISTEN_BACKLOG pcb->accepts_pending++; #endif /* TCP_LISTEN_BACKLOG */ /* Set up the new PCB. */ //���ƿ���������ص�4���ֶ� ip_addr_copy(npcb->local_ip, current_iphdr_dest); npcb->local_port = pcb->local_port; ip_addr_copy(npcb->remote_ip, current_iphdr_src); npcb->remote_port = tcphdr->src; //���ƿ��������ֶ� npcb->state = SYN_RCVD;//��������״̬ npcb->rcv_nxt = seqno + 1;//������һ������������ npcb->rcv_ann_right_edge = npcb->rcv_nxt; npcb->snd_wnd = tcphdr->wnd;//���÷��ʹ��� npcb->ssthresh = npcb->snd_wnd; 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(&tcp_active_pcbs, npcb); /* Parse any options in the SYN. */ tcp_parseopt(npcb); #if TCP_CALCULATE_EFF_SEND_MSS npcb->mss = tcp_eff_send_mss(npcb->mss, &(npcb->remote_ip)); #endif /* TCP_CALCULATE_EFF_SEND_MSS */ snmp_inc_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 */ /* *����TIME_WAIT״̬�Ŀ��ƿ���øú������յ��ı��ĶΣ� *��״̬�£��ر����ӵ����ֹ���Ѿ��������ڵȴ�2MSL��ʱ�� *��״̬�µı��Ķ����������еľ���ݣ�ֱ��ɾ��ɡ� *����Ҫ���ͷ�����ACK���� */ static err_t tcp_timewait_input(struct tcp_pcb *pcb) { if (flags & TCP_RST) { //RST��λ��ֱ�ӷ��� return ERR_OK; } if (flags & TCP_SYN) { //��SYN������Ϣ����������ݱ���ڽ��մ����ڣ����ͷ�����RST���� if (TCP_SEQ_BETWEEN(seqno, pcb->rcv_nxt, pcb->rcv_nxt+pcb->rcv_wnd)) { 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) { //���İ�FIN������Ϣ pcb->tmr = tcp_ticks; //��λ�ȴ�2MSLʱ�䣬���ƿ����µȴ�2MSL } if ((tcplen > 0)) { //��������ݵı��Ļ����ڽ��մ������SYN���� pcb->flags |= TF_ACK_NOW;//����һ��ACK���� 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 = tcphdr->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->remote_ip)); #endif /* TCP_CALCULATE_EFF_SEND_MSS */ /* Set ssthresh again after changing pcb->mss (already set in tcp_connect * but for the default value of pcb->mss) */ pcb->ssthresh = pcb->mss * 10; pcb->cwnd = ((pcb->cwnd == 1) ? (pcb->mss * 2) : pcb->mss); LWIP_ASSERT("pcb->snd_queuelen > 0", (pcb->snd_queuelen > 0)); --pcb->snd_queuelen; LWIP_DEBUGF(TCP_QLEN_DEBUG, ("tcp_process: SYN-SENT --queuelen %"U16_F"\n", (u16_t)pcb->snd_queuelen)); rseg = pcb->unacked; pcb->unacked = rseg->next; /* 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; } tcp_seg_free(rseg); /* Call the user specified function to call when sucessfully * 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)) { u16_t old_cwnd; 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; } old_cwnd = pcb->cwnd; /* If there was any data contained within this ACK, * we'd better pass it on to the application as well. */ tcp_receive(pcb); /* Prevent ACK for SYN to generate a sent event */ if (pcb->acked != 0) { pcb->acked--; } pcb->cwnd = ((old_cwnd == 1) ? (pcb->mss * 2) : pcb->mss); 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(&tcp_active_pcbs, 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(&tcp_active_pcbs, 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(&tcp_active_pcbs, 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 ICACHE_FLASH_ATTR 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, is 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 * i 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 (flags & TCP_ACK) {//���İ�ACK right_wnd_edge = pcb->snd_wnd + pcb->snd_wl2;//���ʹ��� + ����Ӧ����󴰿ڸ��� // first /* Update window. */ /*seqno > snd_wl1���������ֹ�̲��ô��ָ���; *seqno = snd_wl1����ackno > snd_wl2;��ʱ���Է�û�з�����ݣ�ֻ���յ���ݵ�ȷ��; *ackno = snd_wl2�ұ����ײ��б�snd_wnd���Ĵ���.����������Ӧֵ */ if (TCP_SEQ_LT(pcb->snd_wl1, seqno) || (pcb->snd_wl1 == seqno && TCP_SEQ_LT(pcb->snd_wl2, ackno)) || (pcb->snd_wl2 == ackno && tcphdr->wnd > pcb->snd_wnd)) { pcb->snd_wnd = tcphdr->wnd; pcb->snd_wl1 = seqno; pcb->snd_wl2 = ackno; if (pcb->snd_wnd > 0 && pcb->persist_backoff > 0) { pcb->persist_backoff = 0;//�����ʱ���˳� } LWIP_DEBUGF(TCP_WND_DEBUG, ("tcp_receive: window update %"U16_F"\n", pcb->snd_wnd)); #if TCP_WND_DEBUG } else { if (pcb->snd_wnd != 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) ackno = lastack * * 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)) {//���ظ�ACK? 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 (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 ((u16_t)(pcb->cwnd + pcb->mss) > pcb->cwnd) { pcb->cwnd += pcb->mss; } } else if (pcb->dupacks == 3) {//���ظ�ACK /* 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)){//ackno��lastack+1��snd_nxt֮�䣬�жϷ��ʹ�������� /* We come here when the ACK acknowledges new data. */ if (pcb->flags & TF_INFR) { pcb->flags &= ~TF_INFR;// Reset the "IN Fast Retransmit" flag,since we are no longer in fast retransmit pcb->cwnd = pcb->ssthresh;//Reset the congestion window to the "slow start threshold". } /* 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? */ pcb->acked = (u16_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 ((u16_t)(pcb->cwnd + pcb->mss) > pcb->cwnd) { pcb->cwnd += pcb->mss; } LWIP_DEBUGF(TCP_CWND_DEBUG, ("tcp_receive: slow start cwnd %"U16_F"\n", pcb->cwnd)); } else { u16_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 %"U16_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 acknowlegdes them. *�ͷ�unacked�����ϱ�ȷ�ϵı��ĶΣ� *ֱ��unacked����Ϊ��ֹͣ*/ 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 = pcb->unacked->next;//pcb unacked ��һ����־ LWIP_DEBUGF(TCP_QLEN_DEBUG, ("tcp_receive: queuelen %"U16_F" ... ", (u16_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);//�������������pbufs���� tcp_seg_free(next);//�ͷ�tcp�� LWIP_DEBUGF(TCP_QLEN_DEBUG, ("%"U16_F" (after freeing unacked)\n", (u16_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; } else { /* Fix bug bug #21582: out of sequence ACK, didn't really ack anything */ pcb->acked = 0; } /* 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. */ /** unsent�������Ƿ��ܱ�acknoȷ�ϵı��ĶΣ������ͷ�**/ 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δ���ͱ�־ pcb->unsent = pcb->unsent->next;//δ���͵���һ�� LWIP_DEBUGF(TCP_QLEN_DEBUG, ("tcp_receive: queuelen %"U16_F" ... ", (u16_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);//������pbuf�ĸ��� tcp_seg_free(next);//�ͷŶ� LWIP_DEBUGF(TCP_QLEN_DEBUG, ("%"U16_F" (after freeing unsent)\n", (u16_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)) {//RTT���ڽ����Ҹñ��Ķα�ȷ�� /* 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);//����Mֵ 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 �����RTT���㹫ʽ*/ 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. */ if (tcplen > 0) { /* 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)){// seqno < rcv_nxt < seqno + tcplen /* 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.*/ //ȥ�����Ķ�����ݱ�ŵ���rcv_nxt����� 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)){//seqno < rcv_nxt /* the whole segment is < rcv_nxt */ /* must be a duplicate of a packet that has already been correctly handled */ //���Ķ���������ݱ�ž�С��rcv_nxt����˱������ظ����ģ� //ֱ����Դ����ӦACK���Ĵ��� 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)){//rcv_nxt < seqno < rcv_nxt + 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) &~ TCP_FIN); } /* Adjust length of segment to fit in the window. */ inseg.len = 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. */ 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); } 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) {//��ooseqȡ�µ�M�����ĶΣ��ñ��Ķηǿգ�M++ 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);//Ҫ����ı��Ķδ����M�����Ķ� if (cseg != NULL) { if (prev != NULL) { prev->next = cseg; } else { pcb->ooseq = cseg; } tcp_oos_insert_segment(cseg, next); } break; } else { /* Either the lenghts 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 ((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 = 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; } } #endif /* TCP_QUEUE_OOSEQ */ } } else { /* The incoming segment is not withing 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_GT(pcb->rcv_nxt, seqno) || TCP_SEQ_GEQ(seqno, pcb->rcv_nxt + pcb->rcv_wnd)) {*/ if(!TCP_SEQ_BETWEEN(seqno, pcb->rcv_nxt, pcb->rcv_nxt + pcb->rcv_wnd-1)){ tcp_ack_now(pcb);//��Դ�˷���һ������ȷ�ϱ��� } } } /** * 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) { u16_t c, max_c; u16_t mss; u8_t *opts, opt; #if LWIP_TCP_TIMESTAMPS u32_t tsval; #endif opts = (u8_t *)tcphdr + TCP_HLEN; /* Parse the TCP MSS option, if present. */ if(TCPH_HDRLEN(tcphdr) > 0x5) { max_c = (TCPH_HDRLEN(tcphdr) - 5) << 2; for (c = 0; c < max_c; ) { opt = opts[c]; switch (opt) { case 0x00: /* End of options. */ LWIP_DEBUGF(TCP_INPUT_DEBUG, ("tcp_parseopt: EOL\n")); return; case 0x01: /* NOP option. */ ++c; LWIP_DEBUGF(TCP_INPUT_DEBUG, ("tcp_parseopt: NOP\n")); break; case 0x02: LWIP_DEBUGF(TCP_INPUT_DEBUG, ("tcp_parseopt: MSS\n")); if (opts[c + 1] != 0x04 || c + 0x04 > max_c) { /* Bad length */ LWIP_DEBUGF(TCP_INPUT_DEBUG, ("tcp_parseopt: bad length\n")); return; } /* An MSS option with the right option length. */ mss = (opts[c + 2] << 8) | opts[c + 3]; /* Limit the mss to the configured TCP_MSS and prevent division by zero */ pcb->mss = ((mss > TCP_MSS) || (mss == 0)) ? TCP_MSS : mss; /* Advance to next option */ c += 0x04; break; #if LWIP_TCP_TIMESTAMPS case 0x08: LWIP_DEBUGF(TCP_INPUT_DEBUG, ("tcp_parseopt: TS\n")); if (opts[c + 1] != 0x0A || c + 0x0A > max_c) { /* Bad length */ LWIP_DEBUGF(TCP_INPUT_DEBUG, ("tcp_parseopt: bad length\n")); return; } /* TCP timestamp option with valid length */ tsval = (opts[c+2]) | (opts[c+3] << 8) | (opts[c+4] << 16) | (opts[c+5] << 24); if (flags & TCP_SYN) { pcb->ts_recent = ntohl(tsval); pcb->flags |= TF_TIMESTAMP; } else if (TCP_SEQ_BETWEEN(pcb->ts_lastacksent, seqno, seqno+tcplen)) { pcb->ts_recent = ntohl(tsval); } /* Advance to next option */ c += 0x0A; break; #endif default: LWIP_DEBUGF(TCP_INPUT_DEBUG, ("tcp_parseopt: other\n")); if (opts[c + 1] == 0) { 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. */ c += opts[c + 1]; } } } } #endif /* LWIP_TCP */ ================================================ FILE: app/lwip/core/tcp_out.c ================================================ /** * @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/tcp_impl.h" #include "lwip/def.h" #include "lwip/mem.h" #include "lwip/memp.h" #include "lwip/sys.h" #include "lwip/ip_addr.h" #include "lwip/netif.h" #include "lwip/inet_chksum.h" #include "lwip/stats.h" #include "lwip/snmp.h" #include "netif/etharp.h" #include #ifdef MEMLEAK_DEBUG static const char mem_debug_file[] ICACHE_RODATA_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 /* Forward declarations.*/ static void 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 *ICACHE_FLASH_ATTR 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(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); 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 *ICACHE_FLASH_ATTR 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 | 2, ("tcp_create_segment: no memory.\n")); pbuf_free(p); return NULL; } seg->flags = optflags; seg->next = NULL; seg->p = p; 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 | 2, ("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. * @param */ #if TCP_OVERSIZE static struct pbuf *ICACHE_FLASH_ATTR 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 = TCP_MSS; #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(length + TCP_OVERSIZE)); } } #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 ICACHE_FLASH_ATTR 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 ICACHE_FLASH_ATTR 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 | 3, ("tcp_write: too much data (len=%"U16_F" > snd_buf=%"U16_F")\n", len, pcb->snd_buf)); pcb->flags |= TF_NAGLEMEMERR; return ERR_MEM; } LWIP_DEBUGF(TCP_QLEN_DEBUG, ("tcp_write: queuelen: %"U16_F"\n", (u16_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 | 3, ("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 :����Ƿ���п������Լ����Ķ��ײ��Ƿ������PSH��־ * - 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 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; #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)) { optflags = TF_SEG_OPTS_TS; optlen = LWIP_TCP_OPT_LENGTH(TF_SEG_OPTS_TS); } #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); space = pcb->mss - (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 | 2, ("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, (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 | 2, ("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((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 */ concat_p->payload = (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 = pcb->mss - 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, pcb->mss, &oversize, pcb, apiflags, queue == NULL)) == NULL) { LWIP_DEBUGF(TCP_OUTPUT_DEBUG | 2, ("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, (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 | 2, ("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((u8_t*)arg + pos, seglen); #endif /* TCP_CHECKSUM_ON_COPY */ /* reference the non-volatile payload data */ p2->payload = (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 | 2, ("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 | 2, ("tcp_write: queue too long %"U16_F" (%"U16_F")\n", queuelen, 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 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) { 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 */ if ((pcb->snd_queuelen >= TCP_SND_QUEUELEN) || (pcb->snd_queuelen > TCP_SNDQUEUELEN_OVERFLOW)) { LWIP_DEBUGF(TCP_OUTPUT_DEBUG | 3, ("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_TCP_TIMESTAMPS if ((pcb->flags & TF_TIMESTAMP)) { 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 | 3, ("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 % MEM_ALIGNMENT) == 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 ICACHE_FLASH_ATTR 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 /** 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) { struct pbuf *p; struct tcp_hdr *tcphdr; u8_t optlen = 0; #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) { LWIP_DEBUGF(TCP_OUTPUT_DEBUG, ("tcp_output: (ACK) could not allocate pbuf\n")); return ERR_BUF; } tcphdr = (struct tcp_hdr *)p->payload; LWIP_DEBUGF(TCP_OUTPUT_DEBUG, ("tcp_output: sending ACK for %"U32_F"\n", pcb->rcv_nxt)); /* remove ACK flags from the PCB, as we send an empty ACK now */ pcb->flags &= ~(TF_ACK_DELAY | TF_ACK_NOW); /* NB. MSS option is only sent on SYNs, so ignore it 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 #if CHECKSUM_GEN_TCP tcphdr->chksum = inet_chksum_pseudo(p, &(pcb->local_ip), &(pcb->remote_ip), IP_PROTO_TCP, p->tot_len); #endif #if LWIP_NETIF_HWADDRHINT ip_output_hinted(p, &(pcb->local_ip), &(pcb->remote_ip), pcb->ttl, pcb->tos, IP_PROTO_TCP, &(pcb->addr_hint)); #else /* LWIP_NETIF_HWADDRHINT*/ ip_output(p, &(pcb->local_ip), &(pcb->remote_ip), pcb->ttl, pcb->tos, IP_PROTO_TCP); #endif /* LWIP_NETIF_HWADDRHINT*/ pbuf_free(p); return ERR_OK; } /** * 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 ICACHE_FLASH_ATTR tcp_output(struct tcp_pcb *pcb) { struct tcp_seg *seg, *useg; u32_t wnd, snd_nxt; #if TCP_CWND_DEBUG s16_t i = 0; #endif /* TCP_CWND_DEBUG */ /* 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);//����ֻ��ACK�ı��Ķ� } /* 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 %"U16_F ", cwnd %"U16_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 %"U16_F", cwnd %"U16_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 %"U16_F", cwnd %"U16_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 */ pcb->unsent = seg->next; if (pcb->state != SYN_SENT) { TCPH_SET_FLAG(seg->tcphdr, TCP_ACK);//��д�ײ�ACK��־ pcb->flags &= ~(TF_ACK_DELAY | TF_ACK_NOW);//����־λ } tcp_output_segment(seg, pcb);//���ú����ͱ��Ķ� snd_nxt = ntohl(seg->tcphdr->seqno) + TCP_TCPLEN(seg);//����snd_nxt 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 {//���Ķγ���Ϊ0��ֱ��ɾ�������ش� 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 */ //���ʹ��������±��IJ��ܷ��ͣ��������㴰��̽�⡣ if (seg != NULL && pcb->persist_backoff == 0 && ntohl(seg->tcphdr->seqno) - pcb->lastack + seg->len > pcb->snd_wnd) { /* prepare for persist timer */ pcb->persist_cnt = 0; pcb->persist_backoff = 1; } 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 void tcp_output_segment(struct tcp_seg *seg, struct tcp_pcb *pcb) { u16_t len; struct netif *netif; u32_t *opts; /** @bug Exclude retransmitted segments from this count. */ snmp_inc_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 */ seg->tcphdr->wnd = htons(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 */ LWIP_ASSERT("seg->tcphdr not aligned", ((mem_ptr_t)seg->tcphdr % MEM_ALIGNMENT) == 0); opts = (u32_t *)(void *)(seg->tcphdr + 1); if (seg->flags & TF_SEG_OPTS_MSS) { TCP_BUILD_MSS_OPTION(*opts); 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 /* Set retransmission timer running if it is not currently enabled This must be set before checking the route. modify by ives at 2014.4.24*/ if (pcb->rtime == -1) { pcb->rtime = 0; } /* If we don't have a local IP address, we get one by calling ip_route(). */ if (ip_addr_isany(&(pcb->local_ip))) { netif = ip_route(&(pcb->remote_ip)); if (netif == NULL) { return; } ip_addr_copy(pcb->local_ip, netif->ip_addr); } 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 TCP_CHECKSUM_ON_COPY { u32_t acc; #if TCP_CHECKSUM_ON_COPY_SANITY_CHECK u16_t chksum_slow = inet_chksum_pseudo(seg->p, &(pcb->local_ip), &(pcb->remote_ip), IP_PROTO_TCP, seg->p->tot_len); #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 = inet_chksum_pseudo_partial(seg->p, &(pcb->local_ip), &(pcb->remote_ip), IP_PROTO_TCP, seg->p->tot_len, TCPH_HDRLEN(seg->tcphdr) * 4); /* 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) { LWIP_DEBUGF(TCP_DEBUG | LWIP_DBG_LEVEL_WARNING, ("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 = inet_chksum_pseudo(seg->p, &(pcb->local_ip), &(pcb->remote_ip), IP_PROTO_TCP, seg->p->tot_len); #endif /* TCP_CHECKSUM_ON_COPY */ #endif /* CHECKSUM_GEN_TCP */ TCP_STATS_INC(tcp.xmit); #if LWIP_NETIF_HWADDRHINT ip_output_hinted(seg->p, &(pcb->local_ip), &(pcb->remote_ip), pcb->ttl, pcb->tos, IP_PROTO_TCP, &(pcb->addr_hint)); #else /* LWIP_NETIF_HWADDRHINT*/ ip_output(seg->p, &(pcb->local_ip), &(pcb->remote_ip), pcb->ttl, pcb->tos, IP_PROTO_TCP); #endif /* LWIP_NETIF_HWADDRHINT*/ } /** * 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, ip_addr_t *local_ip, ip_addr_t *remote_ip, u16_t local_port, u16_t remote_port) { struct pbuf *p; struct tcp_hdr *tcphdr; 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); tcphdr->wnd = PP_HTONS(TCP_WND); tcphdr->chksum = 0; tcphdr->urgp = 0; #if CHECKSUM_GEN_TCP tcphdr->chksum = inet_chksum_pseudo(p, local_ip, remote_ip, IP_PROTO_TCP, p->tot_len); #endif TCP_STATS_INC(tcp.xmit); snmp_inc_tcpoutrsts(); /* Send output with hardcoded TTL since we have no access to the pcb */ ip_output(p, local_ip, remote_ip, TCP_TTL, 0, IP_PROTO_TCP); 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; struct tcp_seg *t0_head = NULL, *t0_tail = NULL; /* keep in unacked */ struct tcp_seg *t1_head = NULL, *t1_tail = NULL; /* link to unsent */ bool t0_1st = true, t1_1st = true; if (pcb->unacked == NULL) { return; } #if 1 /* by Snake: resolve the bug of pbuf reuse */ seg = pcb->unacked; while (seg != NULL) { if (seg->p->eb) { if (t0_1st) { t0_head = t0_tail = seg; t0_1st = false; } else { t0_tail->next = seg; t0_tail = seg; } seg = seg->next; t0_tail->next = NULL; } else { if (t1_1st) { t1_head = t1_tail = seg; t1_1st = false; } else { t1_tail->next = seg; t1_tail = seg; } seg = seg->next; t1_tail->next = NULL; } } if (t1_head && t1_tail) { t1_tail->next = pcb->unsent; pcb->unsent = t1_head; } pcb->unacked = t0_head; #else /* 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; /* unsent queue is the concatenated queue (of unacked, unsent) */ pcb->unsent = pcb->unacked; /* unacked queue is now empty */ pcb->unacked = NULL; #endif /* 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; ++pcb->nrtx; /* Don't take any rtt measurements after retransmitting. */ pcb->rttest = 0; /* Do the actual retransmission. */ snmp_inc_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 < 2*pcb->mss) { LWIP_DEBUGF(TCP_FR_DEBUG, ("tcp_receive: The minimum value for ssthresh %"U16_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 */ void tcp_keepalive(struct tcp_pcb *pcb) { struct pbuf *p; struct tcp_hdr *tcphdr; LWIP_DEBUGF(TCP_DEBUG, ("tcp_keepalive: sending KEEPALIVE probe to %"U16_F".%"U16_F".%"U16_F".%"U16_F"\n", ip4_addr1_16(&pcb->remote_ip), ip4_addr2_16(&pcb->remote_ip), ip4_addr3_16(&pcb->remote_ip), ip4_addr4_16(&pcb->remote_ip))); 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; } tcphdr = (struct tcp_hdr *)p->payload; #if CHECKSUM_GEN_TCP tcphdr->chksum = inet_chksum_pseudo(p, &pcb->local_ip, &pcb->remote_ip, IP_PROTO_TCP, p->tot_len); #endif TCP_STATS_INC(tcp.xmit); /* Send output to IP */ #if LWIP_NETIF_HWADDRHINT ip_output_hinted(p, &pcb->local_ip, &pcb->remote_ip, pcb->ttl, 0, IP_PROTO_TCP, &(pcb->addr_hint)); #else /* LWIP_NETIF_HWADDRHINT*/ ip_output(p, &pcb->local_ip, &pcb->remote_ip, pcb->ttl, 0, IP_PROTO_TCP); #endif /* LWIP_NETIF_HWADDRHINT*/ pbuf_free(p); LWIP_DEBUGF(TCP_DEBUG, ("tcp_keepalive: seqno %"U32_F" ackno %"U32_F".\n", pcb->snd_nxt - 1, pcb->rcv_nxt)); } /** * 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 */ void tcp_zero_window_probe(struct tcp_pcb *pcb) { struct pbuf *p; struct tcp_hdr *tcphdr; struct tcp_seg *seg; u16_t offset = 0; u16_t len; u8_t is_fin; LWIP_DEBUGF(TCP_DEBUG, ("tcp_zero_window_probe: sending ZERO WINDOW probe to %" U16_F".%"U16_F".%"U16_F".%"U16_F"\n", ip4_addr1_16(&pcb->remote_ip), ip4_addr2_16(&pcb->remote_ip), ip4_addr3_16(&pcb->remote_ip), ip4_addr4_16(&pcb->remote_ip))); 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; } else { struct ip_hdr *iphdr = NULL; iphdr = (struct ip_hdr *)((char*)seg->p->payload + SIZEOF_ETH_HDR); offset = IPH_HL(iphdr)*4; offset += SIZEOF_ETH_HDR; } if(seg == NULL) { return; } 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; } 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 */ struct tcp_hdr *thdr = (struct tcp_hdr *)seg->p->payload; char *d = ((char *)p->payload + TCP_HLEN); if (pcb->unacked == NULL) pbuf_copy_partial(seg->p, d, 1, TCPH_HDRLEN(thdr) * 4); else { thdr = (struct tcp_hdr *)((char*)seg->p->payload + offset); pbuf_copy_partial(seg->p, d, 1, TCPH_HDRLEN(thdr) * 4 + offset); } } #if CHECKSUM_GEN_TCP tcphdr->chksum = inet_chksum_pseudo(p, &pcb->local_ip, &pcb->remote_ip, IP_PROTO_TCP, p->tot_len); #endif TCP_STATS_INC(tcp.xmit); /* Send output to IP */ #if LWIP_NETIF_HWADDRHINT ip_output_hinted(p, &pcb->local_ip, &pcb->remote_ip, pcb->ttl, 0, IP_PROTO_TCP, &(pcb->addr_hint)); #else /* LWIP_NETIF_HWADDRHINT*/ ip_output(p, &pcb->local_ip, &pcb->remote_ip, pcb->ttl, 0, IP_PROTO_TCP); #endif /* LWIP_NETIF_HWADDRHINT*/ pbuf_free(p); LWIP_DEBUGF(TCP_DEBUG, ("tcp_zero_window_probe: seqno %"U32_F " ackno %"U32_F".\n", pcb->snd_nxt - 1, pcb->rcv_nxt)); } #endif /* LWIP_TCP */ ================================================ FILE: app/lwip/core/timers.c ================================================ /** * @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/tcp_impl.h" #if LWIP_TIMERS #include "lwip/def.h" #include "lwip/memp.h" #include "lwip/tcpip.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" #ifdef MEMLEAK_DEBUG static const char mem_debug_file[] ICACHE_RODATA_ATTR = __FILE__; #endif /** The one and only timeout list */ static struct sys_timeo *next_timeout = NULL; #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 ICACHE_FLASH_ATTR 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); } } /** * Timer callback function that calls tcp_tmr() and reschedules itself. * * @param arg unused argument */ static void ICACHE_FLASH_ATTR tcp_timer_coarse(void *arg) { LWIP_UNUSED_ARG(arg); LWIP_DEBUGF(TIMERS_DEBUG, ("tcpip: tcp_tmr()\n")); tcp_tmr(); sys_timeout(TCP_TMR_INTERVAL, tcp_timer_coarse, NULL); } #endif /* LWIP_TCP */ #if IP_REASSEMBLY /** * Timer callback function that calls ip_reass_tmr() and reschedules itself. * * @param arg unused argument */ static void ICACHE_FLASH_ATTR 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 ICACHE_FLASH_ATTR 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 */ extern void dhcps_coarse_tmr(void); static void dhcp_timer_coarse(void *arg) { LWIP_UNUSED_ARG(arg); LWIP_DEBUGF(TIMERS_DEBUG, ("tcpip: dhcp_coarse_tmr()\n")); dhcp_coarse_tmr(); dhcps_coarse_tmr(); 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 */ #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 */ /** Initialize this module */ void sys_timeouts_init(void) { #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 DHCP_MAXRTX = 0; 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 */ #if LWIP_DNS sys_timeout(DNS_TMR_INTERVAL, dns_timer, NULL); #endif /* LWIP_DNS */ #if LWIP_TCP sys_timeout(TCP_TMR_INTERVAL, tcpip_tcp_timer, NULL); // sys_timeout(TCP_TMR_INTERVAL, tcp_timer_coarse, NULL); #endif #if NO_SYS /* Initialise timestamp for sys_check_timeouts */ timeouts_last_time = 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 */ void sys_timeout(u32_t msecs, sys_timeout_handler handler, void *arg) #endif /* LWIP_DEBUG_TIMERNAMES */ { struct sys_timeo *timeout, *t; 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; } timeout->next = NULL; timeout->h = handler; timeout->arg = arg; timeout->time = msecs; #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, even though the timeout has not triggered yet. * * @note This function only works as expected if there is only one timeout * calling 'handler' in the list of timeouts. * * @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 extern uint8 timer2_ms_flag; /** 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) { struct sys_timeo *tmptimeout; u32_t diff; sys_timeout_handler handler; void *arg; int had_one; u32_t now; now = NOW(); if (next_timeout) { /* this cares for wraparounds */ if (timer2_ms_flag == 0) { diff = LWIP_U32_DIFF(now, timeouts_last_time)/((APB_CLK_FREQ>>4)/1000); } else { diff = LWIP_U32_DIFF(now, timeouts_last_time)/((APB_CLK_FREQ>>8)/1000); } do { had_one = 0; tmptimeout = next_timeout; if (tmptimeout->time <= diff) { /* timeout has expired */ had_one = 1; timeouts_last_time = now; 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 = NOW(); } #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 occured 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 */ ================================================ FILE: app/lwip/core/udp.c ================================================ /** * @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/netif.h" #include "lwip/icmp.h" #include "lwip/stats.h" #include "lwip/snmp.h" #include "arch/perf.h" #include "lwip/dhcp.h" #include #ifdef MEMLEAK_DEBUG static const char mem_debug_file[] ICACHE_RODATA_ATTR = __FILE__; #endif /* The list of UDP PCBs */ /* exported in udp.h (was static) */ struct udp_pcb *udp_pcbs; /** * 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. * @param inp network interface on which the datagram was received. * */ void ICACHE_FLASH_ATTR udp_input(struct pbuf *p, struct netif *inp) { struct udp_hdr *udphdr; struct udp_pcb *pcb, *prev; struct udp_pcb *uncon_pcb; struct ip_hdr *iphdr; u16_t src, dest; u8_t local_match; u8_t broadcast; PERF_START; UDP_STATS_INC(udp.recv); iphdr = (struct ip_hdr *)p->payload; /* Check minimum length (IP header + UDP header) * and move payload pointer to UDP header */ if (p->tot_len < (IPH_HL(iphdr) * 4 + UDP_HLEN) || pbuf_header(p, -(s16_t)(IPH_HL(iphdr) * 4))) { /* 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); snmp_inc_udpinerrors(); pbuf_free(p); goto end; } udphdr = (struct udp_hdr *)p->payload; /* is broadcast packet ? */ broadcast = ip_addr_isbroadcast(¤t_iphdr_dest, inp); 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 (%"U16_F".%"U16_F".%"U16_F".%"U16_F", %"U16_F") <-- " "(%"U16_F".%"U16_F".%"U16_F".%"U16_F", %"U16_F")\n", ip4_addr1_16(&iphdr->dest), ip4_addr2_16(&iphdr->dest), ip4_addr3_16(&iphdr->dest), ip4_addr4_16(&iphdr->dest), ntohs(udphdr->dest), ip4_addr1_16(&iphdr->src), ip4_addr2_16(&iphdr->src), ip4_addr3_16(&iphdr->src), ip4_addr4_16(&iphdr->src), ntohs(udphdr->src))); #if LWIP_DHCP pcb = NULL; /* when LWIP_DHCP is active, packets to DHCP_CLIENT_PORT may only be processed by the dhcp module, no other UDP pcb may use the local UDP port DHCP_CLIENT_PORT */ if (dest == DHCP_CLIENT_PORT) { /* all packets for DHCP_CLIENT_PORT not coming from DHCP_SERVER_PORT are dropped! */ if (src == DHCP_SERVER_PORT) { if ((inp->dhcp != NULL) && (inp->dhcp->pcb != NULL)) { /* accept the packe if (- broadcast or directed to us) -> DHCP is link-layer-addressed, local ip is always ANY! - inp->dhcp->pcb->remote == ANY or iphdr->src */ if ((ip_addr_isany(&inp->dhcp->pcb->remote_ip) || ip_addr_cmp(&(inp->dhcp->pcb->remote_ip), ¤t_iphdr_src))) { pcb = inp->dhcp->pcb; } } } else if (dest == DHCP_SERVER_PORT) { if (src == DHCP_CLIENT_PORT) { if ( inp->dhcps_pcb != NULL ) { if ((ip_addr_isany(&inp->dhcps_pcb->local_ip) || ip_addr_cmp(&(inp->dhcps_pcb->local_ip), ¤t_iphdr_dest))) { pcb = inp->dhcps_pcb; } } } } } else #endif /* LWIP_DHCP */ { prev = NULL; local_match = 0; 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) { local_match = 0; /* print the PCB local and remote address */ LWIP_DEBUGF(UDP_DEBUG, ("pcb (%"U16_F".%"U16_F".%"U16_F".%"U16_F", %"U16_F") --- " "(%"U16_F".%"U16_F".%"U16_F".%"U16_F", %"U16_F")\n", ip4_addr1_16(&pcb->local_ip), ip4_addr2_16(&pcb->local_ip), ip4_addr3_16(&pcb->local_ip), ip4_addr4_16(&pcb->local_ip), pcb->local_port, ip4_addr1_16(&pcb->remote_ip), ip4_addr2_16(&pcb->remote_ip), ip4_addr3_16(&pcb->remote_ip), ip4_addr4_16(&pcb->remote_ip), pcb->remote_port)); /* compare PCB local addr+port to UDP destination addr+port */ if ((pcb->local_port == dest) && ((!broadcast && ip_addr_isany(&pcb->local_ip)) || ip_addr_cmp(&(pcb->local_ip), ¤t_iphdr_dest) || #if LWIP_IGMP ip_addr_ismulticast(¤t_iphdr_dest) || #endif /* LWIP_IGMP */ #if IP_SOF_BROADCAST_RECV (broadcast && (pcb->so_options & SOF_BROADCAST)))) { #else /* IP_SOF_BROADCAST_RECV */ (broadcast))) { #endif /* IP_SOF_BROADCAST_RECV */ local_match = 1; 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 ((local_match != 0) && (pcb->remote_port == src) && (ip_addr_isany(&pcb->remote_ip) || ip_addr_cmp(&(pcb->remote_ip), ¤t_iphdr_src))) { /* 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 || ip_addr_cmp(&inp->ip_addr, ¤t_iphdr_dest)) { LWIP_DEBUGF(UDP_DEBUG | LWIP_DBG_TRACE, ("udp_input: calculating checksum\n")); #if LWIP_UDPLITE if (IPH_PROTO(iphdr) == IP_PROTO_UDPLITE) { /* Do the UDP Lite checksum */ #if CHECKSUM_CHECK_UDP 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) */ UDP_STATS_INC(udp.chkerr); UDP_STATS_INC(udp.drop); snmp_inc_udpinerrors(); pbuf_free(p); goto end; } } if (inet_chksum_pseudo_partial(p, ¤t_iphdr_src, ¤t_iphdr_dest, IP_PROTO_UDPLITE, p->tot_len, chklen) != 0) { LWIP_DEBUGF(UDP_DEBUG | LWIP_DBG_LEVEL_SERIOUS, ("udp_input: UDP Lite datagram discarded due to failing checksum\n")); UDP_STATS_INC(udp.chkerr); UDP_STATS_INC(udp.drop); snmp_inc_udpinerrors(); pbuf_free(p); goto end; } #endif /* CHECKSUM_CHECK_UDP */ } else #endif /* LWIP_UDPLITE */ { #if CHECKSUM_CHECK_UDP if (udphdr->chksum != 0) { if (inet_chksum_pseudo(p, ip_current_src_addr(), ip_current_dest_addr(), IP_PROTO_UDP, p->tot_len) != 0) { LWIP_DEBUGF(UDP_DEBUG | LWIP_DBG_LEVEL_SERIOUS, ("udp_input: UDP datagram discarded due to failing checksum\n")); UDP_STATS_INC(udp.chkerr); UDP_STATS_INC(udp.drop); snmp_inc_udpinerrors(); pbuf_free(p); goto end; } } #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); snmp_inc_udpinerrors(); pbuf_free(p); goto end; } if (pcb != NULL) { snmp_inc_udpindatagrams(); #if SO_REUSE && SO_REUSE_RXTOALL if ((broadcast || ip_addr_ismulticast(¤t_iphdr_dest)) && ((pcb->so_options & SOF_REUSEADDR) != 0)) { /* 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; 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) && ((!broadcast && ip_addr_isany(&mpcb->local_ip)) || ip_addr_cmp(&(mpcb->local_ip), ¤t_iphdr_dest) || #if LWIP_IGMP ip_addr_ismulticast(¤t_iphdr_dest) || #endif /* LWIP_IGMP */ #if IP_SOF_BROADCAST_RECV (broadcast && (mpcb->so_options & SOF_BROADCAST)))) { #else /* IP_SOF_BROADCAST_RECV */ (broadcast))) { #endif /* IP_SOF_BROADCAST_RECV */ /* 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(p, (s16_t)((IPH_HL(iphdr) * 4) + UDP_HLEN)); 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, -(s16_t)((IPH_HL(iphdr) * 4) + UDP_HLEN)); 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, -(s16_t)((IPH_HL(iphdr) * 4) + UDP_HLEN)); } } #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 /* No match was found, send ICMP destination port unreachable unless destination address was broadcast/multicast. */ if (!broadcast && !ip_addr_ismulticast(¤t_iphdr_dest)) { /* move payload pointer back to ip header */ pbuf_header(p, (IPH_HL(iphdr) * 4) + UDP_HLEN); LWIP_ASSERT("p->payload == iphdr", (p->payload == iphdr)); icmp_dest_unreach(p, ICMP_DUR_PORT); } #endif /* LWIP_ICMP */ UDP_STATS_INC(udp.proterr); UDP_STATS_INC(udp.drop); snmp_inc_udpnoports(); pbuf_free(p); } } else { pbuf_free(p); } end: PERF_STOP("udp_input"); } /** * 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 occured. * - ERR_MEM. Out of memory. * - ERR_RTE. Could not find route to destination address. * - More errors could be returned by lower protocol layers. * * @see udp_disconnect() udp_sendto() */ err_t ICACHE_FLASH_ATTR udp_send(struct udp_pcb *pcb, struct pbuf *p) { /* 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 /** Same as udp_send() but with checksum */ err_t ICACHE_FLASH_ATTR udp_send_chksum(struct udp_pcb *pcb, struct pbuf *p, u8_t have_chksum, u16_t chksum) { /* 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 */ /** * 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 ICACHE_FLASH_ATTR udp_sendto(struct udp_pcb *pcb, struct pbuf *p, ip_addr_t *dst_ip, u16_t dst_port) { #if LWIP_CHECKSUM_ON_COPY return udp_sendto_chksum(pcb, p, dst_ip, dst_port, 0, 0); } /** Same as udp_sendto(), but with checksum */ err_t ICACHE_FLASH_ATTR udp_sendto_chksum(struct udp_pcb *pcb, struct pbuf *p, ip_addr_t *dst_ip, u16_t dst_port, u8_t have_chksum, u16_t chksum) { #endif /* LWIP_CHECKSUM_ON_COPY */ struct netif *netif; LWIP_DEBUGF(UDP_DEBUG | LWIP_DBG_TRACE, ("udp_send\n")); /* find the outgoing network interface for this packet */ #if LWIP_IGMP netif = ip_route((ip_addr_ismulticast(dst_ip))?(&(pcb->multicast_ip)):(dst_ip)); #else netif = ip_route(dst_ip); #endif /* LWIP_IGMP */ /* no outgoing network interface could be found? */ if (netif == NULL) { LWIP_DEBUGF(UDP_DEBUG | LWIP_DBG_LEVEL_SERIOUS, ("udp_send: No route to %"U16_F".%"U16_F".%"U16_F".%"U16_F"\n", ip4_addr1_16(dst_ip), ip4_addr2_16(dst_ip), ip4_addr3_16(dst_ip), ip4_addr4_16(dst_ip))); UDP_STATS_INC(udp.rterr); return ERR_RTE; } #if LWIP_CHECKSUM_ON_COPY return udp_sendto_if_chksum(pcb, p, dst_ip, dst_port, netif, have_chksum, chksum); #else /* LWIP_CHECKSUM_ON_COPY */ return udp_sendto_if(pcb, p, dst_ip, dst_port, netif); #endif /* LWIP_CHECKSUM_ON_COPY */ } /** * 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 ICACHE_FLASH_ATTR udp_sendto_if(struct udp_pcb *pcb, struct pbuf *p, ip_addr_t *dst_ip, u16_t dst_port, struct netif *netif) { #if LWIP_CHECKSUM_ON_COPY return udp_sendto_if_chksum(pcb, p, dst_ip, dst_port, netif, 0, 0); } /** Same as udp_sendto_if(), but with checksum */ err_t ICACHE_FLASH_ATTR udp_sendto_if_chksum(struct udp_pcb *pcb, struct pbuf *p, ip_addr_t *dst_ip, u16_t dst_port, struct netif *netif, u8_t have_chksum, u16_t chksum) { #endif /* LWIP_CHECKSUM_ON_COPY */ struct udp_hdr *udphdr; ip_addr_t *src_ip; err_t err; struct pbuf *q; /* q will be sent down the stack */ #if IP_SOF_BROADCAST /* broadcast filter? */ if ( ((pcb->so_options & SOF_BROADCAST) == 0) && 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 /* 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_IGMP if (ip_addr_ismulticast(dst_ip) && ((pcb->flags & UDP_FLAGS_MULTICAST_LOOP) != 0)) { q->flags |= PBUF_FLAG_MCASTLOOP; } #endif /* LWIP_IGMP */ /* PCB local address is IP_ANY_ADDR? */ if (ip_addr_isany(&pcb->local_ip)) { /* use outgoing network interface IP address as source address */ src_ip = &(netif->ip_addr); } else { /* check if UDP PCB local IP address is correct * this could be an old address if netif->ip_addr has changed */ if (!ip_addr_cmp(&(pcb->local_ip), &(netif->ip_addr))) { /* local_ip doesn't match, drop the packet */ if (q != p) { /* free the header pbuf */ pbuf_free(q); q = NULL; /* p is still referenced by the caller, and will live on */ } return ERR_VAL; } /* use UDP PCB local IP address as source address */ src_ip = &(pcb->local_ip); } 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 udphdr->chksum = inet_chksum_pseudo_partial(q, src_ip, dst_ip, IP_PROTO_UDPLITE, q->tot_len, #if !LWIP_CHECKSUM_ON_COPY chklen); #else /* !LWIP_CHECKSUM_ON_COPY */ (have_chksum ? UDP_HLEN : chklen)); 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 */ /* output to IP */ LWIP_DEBUGF(UDP_DEBUG, ("udp_send: ip_output_if (,,,,IP_PROTO_UDPLITE,)\n")); #if LWIP_NETIF_HWADDRHINT netif->addr_hint = &(pcb->addr_hint); #endif /* LWIP_NETIF_HWADDRHINT*/ err = ip_output_if(q, src_ip, dst_ip, pcb->ttl, pcb->tos, IP_PROTO_UDPLITE, netif); #if LWIP_NETIF_HWADDRHINT netif->addr_hint = NULL; #endif /* LWIP_NETIF_HWADDRHINT*/ } 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 ((pcb->flags & UDP_FLAGS_NOCHKSUM) == 0) { u16_t udpchksum; #if LWIP_CHECKSUM_ON_COPY if (have_chksum) { u32_t acc; udpchksum = inet_chksum_pseudo_partial(q, src_ip, dst_ip, IP_PROTO_UDP, q->tot_len, UDP_HLEN); acc = udpchksum + (u16_t)~(chksum); udpchksum = FOLD_U32T(acc); } else #endif /* LWIP_CHECKSUM_ON_COPY */ { udpchksum = inet_chksum_pseudo(q, src_ip, dst_ip, IP_PROTO_UDP, q->tot_len); } /* chksum zero must become 0xffff, as zero means 'no checksum' */ if (udpchksum == 0x0000) { udpchksum = 0xffff; } udphdr->chksum = udpchksum; } #endif /* CHECKSUM_GEN_UDP */ LWIP_DEBUGF(UDP_DEBUG, ("udp_send: UDP checksum 0x%04"X16_F"\n", udphdr->chksum)); LWIP_DEBUGF(UDP_DEBUG, ("udp_send: ip_output_if (,,,,IP_PROTO_UDP,)\n")); /* output to IP */ #if LWIP_NETIF_HWADDRHINT netif->addr_hint = &(pcb->addr_hint); #endif /* LWIP_NETIF_HWADDRHINT*/ err = ip_output_if(q, src_ip, dst_ip, pcb->ttl, pcb->tos, IP_PROTO_UDP, netif); #if LWIP_NETIF_HWADDRHINT netif->addr_hint = NULL; #endif /* LWIP_NETIF_HWADDRHINT*/ } /* TODO: must this be increased even if error occured? */ snmp_inc_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 occured. * - ERR_USE. The specified ipaddr and port are already bound to by * another UDP PCB. * * @see udp_disconnect() */ err_t ICACHE_FLASH_ATTR udp_bind(struct udp_pcb *pcb, ip_addr_t *ipaddr, u16_t port) { struct udp_pcb *ipcb; u8_t rebind; LWIP_DEBUGF(UDP_DEBUG | LWIP_DBG_TRACE, ("udp_bind(ipaddr = ")); ip_addr_debug_print(UDP_DEBUG, 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) { /* pcb may occur at most once in active list */ LWIP_ASSERT("rebind == 0", rebind == 0); /* pcb already in list, just rebind */ rebind = 1; } /* By default, we don't allow to bind to a port that any other udp PCB is alread bound to, unless *all* PCBs with that port have tha REUSEADDR flag set. */ #if SO_REUSE else if (((pcb->so_options & SOF_REUSEADDR) == 0) && ((ipcb->so_options & SOF_REUSEADDR) == 0)) { #else /* SO_REUSE */ /* port matches that of PCB in list and REUSEADDR not set -> reject */ else { #endif /* SO_REUSE */ if ((ipcb->local_port == port) && /* 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(&pcb->local_ip, ipaddr); /* no port specified? */ if (port == 0) { #ifndef UDP_LOCAL_PORT_RANGE_START #define UDP_LOCAL_PORT_RANGE_START 4096 #define UDP_LOCAL_PORT_RANGE_END 0x7fff #endif port = UDP_LOCAL_PORT_RANGE_START; ipcb = udp_pcbs; while ((ipcb != NULL) && (port != UDP_LOCAL_PORT_RANGE_END)) { if (ipcb->local_port == port) { /* port is already used by another udp_pcb */ port++; /* restart scanning all udp pcbs */ ipcb = udp_pcbs; } else { /* go on with next udp pcb */ ipcb = ipcb->next; } } if (ipcb != NULL) { /* no more ports available in local range */ LWIP_DEBUGF(UDP_DEBUG, ("udp_bind: out of free UDP ports\n")); return ERR_USE; } } pcb->local_port = port; snmp_insert_udpidx_tree(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 %"U16_F".%"U16_F".%"U16_F".%"U16_F", port %"U16_F"\n", ip4_addr1_16(&pcb->local_ip), ip4_addr2_16(&pcb->local_ip), ip4_addr3_16(&pcb->local_ip), ip4_addr4_16(&pcb->local_ip), 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 ICACHE_FLASH_ATTR udp_connect(struct udp_pcb *pcb, ip_addr_t *ipaddr, u16_t port) { struct udp_pcb *ipcb; 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(&pcb->remote_ip, ipaddr); pcb->remote_port = port; pcb->flags |= UDP_FLAGS_CONNECTED; /** TODO: this functionality belongs in upper layers */ #ifdef LWIP_UDP_TODO /* Nail down local IP for netconn_addr()/getsockname() */ if (ip_addr_isany(&pcb->local_ip) && !ip_addr_isany(&pcb->remote_ip)) { struct netif *netif; if ((netif = ip_route(&(pcb->remote_ip))) == NULL) { LWIP_DEBUGF(UDP_DEBUG, ("udp_connect: No route to 0x%lx\n", pcb->remote_ip.addr)); UDP_STATS_INC(udp.rterr); return ERR_RTE; } /** TODO: this will bind the udp pcb locally, to the interface which is used to route output packets to the remote address. However, we might want to accept incoming packets on any interface! */ pcb->local_ip = netif->ip_addr; } else if (ip_addr_isany(&pcb->remote_ip)) { pcb->local_ip.addr = 0; } #endif LWIP_DEBUGF(UDP_DEBUG | LWIP_DBG_TRACE | LWIP_DBG_STATE, ("udp_connect: connected to %"U16_F".%"U16_F".%"U16_F".%"U16_F",port %"U16_F"\n", ip4_addr1_16(&pcb->local_ip), ip4_addr2_16(&pcb->local_ip), ip4_addr3_16(&pcb->local_ip), ip4_addr4_16(&pcb->local_ip), pcb->local_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 ICACHE_FLASH_ATTR udp_disconnect(struct udp_pcb *pcb) { /* reset remote address association */ ip_addr_set_any(&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 wich 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 ICACHE_FLASH_ATTR 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 ICACHE_FLASH_ATTR udp_remove(struct udp_pcb *pcb) { struct udp_pcb *pcb2; snmp_delete_udpidx_tree(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; } } } 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 * ICACHE_FLASH_ATTR 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 */ os_memset(pcb, 0, sizeof(struct udp_pcb)); pcb->ttl = UDP_TTL; } return pcb; } #if UDP_DEBUG /** * Print UDP header information for debug purposes. * * @param udphdr pointer to the udp header in memory. */ void ICACHE_FLASH_ATTR 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 */ ================================================ FILE: app/lwip/netif/Makefile ================================================ ############################################################# # Required variables for each makefile # Discard this section from all parent makefiles # Expected variables (with automatic defaults): # CSRCS (all "C" files in the dir) # SUBDIRS (all subdirs with a Makefile) # GEN_LIBS - list of libs to be generated () # GEN_IMAGES - list of images to be generated () # COMPONENTS_xxx - a list of libs/objs in the form # subdir/lib to be extracted and rolled up into # a generated lib/image xxx.a () # ifndef PDIR GEN_LIBS = liblwipnetif.a endif ############################################################# # Configuration i.e. compile options etc. # Target specific stuff (defines etc.) goes in here! # Generally values applying to a tree are captured in the # makefile at its root level - these are then overridden # for a subtree within the makefile rooted therein # #DEFINES += ############################################################# # Recursion Magic - Don't touch this!! # # Each subtree potentially has an include directory # corresponding to the common APIs applicable to modules # rooted at that subtree. Accordingly, the INCLUDE PATH # of a module can only contain the include directories up # its parent path, and not its siblings # # Required for each makefile to inherit from the parent # INCLUDES := $(INCLUDES) -I $(PDIR)include INCLUDES += -I ./ PDIR := ../$(PDIR) sinclude $(PDIR)Makefile ================================================ FILE: app/lwip/netif/etharp.c ================================================ /** * @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 "lwip/ip_addr.h" #include "lwip/def.h" #include "lwip/ip.h" #include "lwip/stats.h" #include "lwip/snmp.h" #include "lwip/dhcp.h" #include "lwip/autoip.h" #include "netif/etharp.h" #if PPPOE_SUPPORT #include "netif/ppp_oe.h" #endif /* PPPOE_SUPPORT */ #include #ifdef MEMLEAK_DEBUG static const char mem_debug_file[] ICACHE_RODATA_ATTR = __FILE__; #endif const struct eth_addr ethbroadcast = {{0xff,0xff,0xff,0xff,0xff,0xff}}; const struct eth_addr ethzero = {{0,0,0,0,0,0}}; #if LWIP_ARP /* don't build if not configured for use in lwipopts.h */ /** the time an ARP entry stays valid after its last update, * for ARP_TMR_INTERVAL = 5000, this is * (240 * 5) seconds = 20 minutes. */ #define ARP_MAXAGE 240 /** 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 (ARP_MAXAGE - 12) /** the time an ARP entry stays pending after first request, * for ARP_TMR_INTERVAL = 5000, this is * (2 * 5) seconds = 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 2 #define HWTYPE_ETHERNET 1 enum etharp_state { ETHARP_STATE_EMPTY = 0, ETHARP_STATE_PENDING, ETHARP_STATE_STABLE, ETHARP_STATE_STABLE_REREQUESTING }; 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 */ ip_addr_t ipaddr; struct eth_addr ethaddr; #if LWIP_SNMP || LWIP_ARP struct netif *netif; #endif /* LWIP_SNMP */ u8_t state; u8_t ctime; #if ETHARP_SUPPORT_STATIC_ENTRIES u8_t static_entry; #endif /* ETHARP_SUPPORT_STATIC_ENTRIES */ }; 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 #define ETHARP_FLAG_STATIC_ENTRY 4 #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 */ static err_t update_arp_entry(struct netif *netif, ip_addr_t *ipaddr, struct eth_addr *ethaddr, u8_t flags); /* 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 #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 ICACHE_FLASH_ATTR free_entry(int i) { /* remove from SNMP ARP index tree */ snmp_delete_arpidx_tree(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_timer: 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; #if ETHARP_SUPPORT_STATIC_ENTRIES arp_table[i].static_entry = 0; #endif /* ETHARP_SUPPORT_STATIC_ENTRIES */ #ifdef LWIP_DEBUG /* for debugging, clean out the complete entry */ arp_table[i].ctime = 0; #if LWIP_SNMP arp_table[i].netif = NULL; #endif /* LWIP_SNMP */ ip_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 ETHARP_TMR_INTERVAL milliseconds (5 seconds), * 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 && (arp_table[i].static_entry == 0) #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 */ free_entry(i); } else if (arp_table[i].state == ETHARP_STATE_STABLE_REREQUESTING) { /* Reset state to stable, so that the next transmitted packet will re-send an ARP request. */ arp_table[i].state = ETHARP_STATE_STABLE; } #if ARP_QUEUEING /* still pending entry? (not expired) */ if (arp_table[i].state == ETHARP_STATE_PENDING) { /* resend an ARP query here? */ } #endif /* ARP_QUEUEING */ } } } /** * 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 ICACHE_FLASH_ATTR find_entry(ip_addr_t *ipaddr, u8_t flags) { s8_t old_pending = ARP_TABLE_SIZE, old_stable = ARP_TABLE_SIZE; s8_t empty = ARP_TABLE_SIZE; u8_t i = 0, age_pending = 0, age_stable = 0; /* oldest entry with packets on queue */ s8_t old_queue = ARP_TABLE_SIZE; /* its age */ u8_t age_queue = 0; /** * 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, ("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 && ip_addr_cmp(ipaddr, &arp_table[i].ipaddr)) { LWIP_DEBUGF(ETHARP_DEBUG | LWIP_DBG_TRACE, ("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 (arp_table[i].static_entry == 0) #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, ("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, ("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, ("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, ("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 free_entry) */ i = old_queue; LWIP_DEBUGF(ETHARP_DEBUG | LWIP_DBG_TRACE, ("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, ("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); 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 */ ip_addr_copy(arp_table[i].ipaddr, *ipaddr); } arp_table[i].ctime = 0; #if ETHARP_SUPPORT_STATIC_ENTRIES arp_table[i].static_entry = 0; #endif /* ETHARP_SUPPORT_STATIC_ENTRIES */ 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 ICACHE_FLASH_ATTR etharp_send_ip(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 the same as ETHARP_HWADDR_LEN for etharp!", (netif->hwaddr_len == ETHARP_HWADDR_LEN)); ETHADDR32_COPY(ðhdr->dest, dst); ETHADDR16_COPY(ðhdr->src, src); ethhdr->type = PP_HTONS(ETHTYPE_IP); 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 Succesfully 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 ICACHE_FLASH_ATTR update_arp_entry(struct netif *netif, ip_addr_t *ipaddr, struct eth_addr *ethaddr, u8_t flags) { s8_t i; LWIP_ASSERT("netif->hwaddr_len == ETHARP_HWADDR_LEN", netif->hwaddr_len == ETHARP_HWADDR_LEN); LWIP_DEBUGF(ETHARP_DEBUG | LWIP_DBG_TRACE, ("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 (ip_addr_isany(ipaddr) || ip_addr_isbroadcast(ipaddr, netif) || ip_addr_ismulticast(ipaddr)) { LWIP_DEBUGF(ETHARP_DEBUG | LWIP_DBG_TRACE, ("update_arp_entry: will not add non-unicast IP address to ARP cache\n")); return ERR_ARG; } /* find or create ARP entry */ i = find_entry(ipaddr, flags); /* 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].static_entry = 1; } #endif /* ETHARP_SUPPORT_STATIC_ENTRIES */ /* mark it stable */ arp_table[i].state = ETHARP_STATE_STABLE; #if LWIP_SNMP /* record network interface */ arp_table[i].netif = netif; #endif /* LWIP_SNMP */ /* insert in SNMP ARP index tree */ snmp_insert_arpidx_tree(netif, &arp_table[i].ipaddr); LWIP_DEBUGF(ETHARP_DEBUG | LWIP_DBG_TRACE, ("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(ip_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 = ip_route(ipaddr); if (netif == NULL) { return ERR_RTE; } return 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(ip_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 = find_entry(ipaddr, ETHARP_FLAG_FIND_ONLY); /* bail out if no entry could be found */ if (i < 0) { return (err_t)i; } if ((arp_table[i].state != ETHARP_STATE_STABLE) || (arp_table[i].static_entry == 0)) { /* entry wasn't a static entry, cannot remove it */ return ERR_ARG; } /* entry found, free it */ 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 ICACHE_FLASH_ATTR 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)) { 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, ip_addr_t *ipaddr, struct eth_addr **eth_ret, ip_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 = find_entry(ipaddr, ETHARP_FLAG_FIND_ONLY); 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; } #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 ICACHE_FLASH_ATTR etharp_ip_input(struct netif *netif, struct pbuf *p) { struct eth_hdr *ethhdr; struct ip_hdr *iphdr; ip_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 == ETHTYPE_VLAN) { iphdr = (struct ip_hdr *)((u8_t*)ethhdr + SIZEOF_ETH_HDR + SIZEOF_VLAN_HDR); } #endif /* ETHARP_SUPPORT_VLAN */ ip_addr_copy(iphdr_src, iphdr->src); /* source is not on the local network? */ if (!ip_addr_netcmp(&iphdr_src, &(netif->ip_addr), &(netif->netmask))) { /* 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. */ 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() */ static void ICACHE_FLASH_ATTR 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 */ ip_addr_t sipaddr, dipaddr; u8_t for_us; #if LWIP_AUTOIP const u8_t * ethdst_hwaddr; #endif /* LWIP_AUTOIP */ #ifdef EBUF_LWIP struct pbuf *q; #endif /* EBUF_LWIP */ 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 == 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 != ETHARP_HWADDR_LEN) || (hdr->protolen != sizeof(ip_addr_t)) || (hdr->proto != PP_HTONS(ETHTYPE_IP)) || (ethhdr->type != PP_HTONS(ETHTYPE_ARP))) { 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"/%"U16_F")\n", hdr->hwtype, hdr->hwlen, hdr->proto, hdr->protolen, ethhdr->type)); 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 continously 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 ip_addr2 to aligned ip_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 (ip_addr_isany(&netif->ip_addr)) { for_us = 0; } else { /* ARP packet directed to us? */ for_us = (u8_t)ip_addr_cmp(&dipaddr, &(netif->ip_addr)); } /* 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 */ 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 possiby 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->ip_addr); LWIP_ASSERT("netif->hwaddr_len must be the same as ETHARP_HWADDR_LEN for etharp!", (netif->hwaddr_len == ETHARP_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 = ip_addr_islinklocal(&netif->ip_addr) ? (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 */ #ifdef EBUF_LWIP /* * don't do flip-flop here... do a copy here. * otherwise, we need to handle existing pbuf->eb in ieee80211_output.c */ q = pbuf_alloc(PBUF_RAW, p->tot_len, PBUF_RAM); if (q != NULL) { pbuf_copy(q, p); //pbuf_free(p); } else { LWIP_ASSERT("q != NULL", q != NULL); } netif->linkoutput(netif, q); pbuf_free(q); #else /* return ARP reply */ netif->linkoutput(netif, p); #endif /* ESF_LWIP */ /* we are not configured? */ } else if (ip_addr_isany(&netif->ip_addr)) { /* { 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 ICACHE_FLASH_ATTR 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) && (arp_table[arp_idx].ctime >= ARP_AGE_REREQUEST_USED)) { if (etharp_request(netif, &arp_table[arp_idx].ipaddr) == ERR_OK) { arp_table[arp_idx].state = ETHARP_STATE_STABLE_REREQUESTING; } } 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, ip_addr_t *ipaddr) { struct eth_addr *dest, mcastaddr; /* 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")); LINK_STATS_INC(link.lenerr); return ERR_BUF; } /* assume unresolved Ethernet address */ dest = NULL; /* 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 (ip_addr_isbroadcast(ipaddr, netif)) { /* broadcast on Ethernet also */ dest = (struct eth_addr *)ðbroadcast; /* multicast destination IP address? */ } else if (ip_addr_ismulticast(ipaddr)) { /* Hash IP multicast address to MAC address.*/ mcastaddr.addr[0] = 0x01; mcastaddr.addr[1] = 0x00; mcastaddr.addr[2] = 0x5e; 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 (!ip_addr_netcmp(ipaddr, &(netif->ip_addr), &(netif->netmask)) && !ip_addr_islinklocal(ipaddr)) { #if LWIP_AUTOIP struct ip_hdr *iphdr = (struct ip_hdr*)((u8_t*)q->payload + 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 (!ip_addr_islinklocal(&iphdr->src)) #endif /* LWIP_AUTOIP */ { /* interface has default gateway? */ if (!ip_addr_isany(&netif->gw)) { /* send to hardware address of default gateway IP address */ ipaddr = &(netif->gw); /* 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) && (ip_addr_cmp(ipaddr, &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) && (ip_addr_cmp(ipaddr, &arp_table[i].ipaddr))) { /* found an existing, stable entry */ ETHARP_SET_HINT(netif, i); return etharp_output_to_arp_index(netif, q, i); } } /* queue on destination Ethernet address belonging to ipaddr */ return etharp_query(netif, ipaddr, 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, ip_addr_t *ipaddr, struct pbuf *q) { struct eth_addr * srcaddr = (struct eth_addr *)netif->hwaddr; err_t result = ERR_MEM; s8_t i; /* ARP entry index */ /* non-unicast address? */ if (ip_addr_isbroadcast(ipaddr, netif) || ip_addr_ismulticast(ipaddr) || ip_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 = find_entry(ipaddr, ETHARP_FLAG_TRY_HARD); /* 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) { arp_table[i].state = ETHARP_STATE_PENDING; } /* { 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 pending entry? or an implicit query request? */ if ((arp_table[i].state == ETHARP_STATE_PENDING) || (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, 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(qlen >= 3) { 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(MEM_ARP_QUEUE, old); } 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 ICACHE_FLASH_ATTR etharp_raw(struct netif *netif, const struct eth_addr *ethsrc_addr, const struct eth_addr *ethdst_addr, const struct eth_addr *hwsrc_addr, const ip_addr_t *ipsrc_addr, const struct eth_addr *hwdst_addr, const ip_addr_t *ipdst_addr, const u16_t opcode) { struct pbuf *p; err_t result = ERR_OK; struct eth_hdr *ethhdr; struct etharp_hdr *hdr; #if LWIP_AUTOIP const u8_t * ethdst_hwaddr; #endif /* LWIP_AUTOIP */ /* allocate a pbuf for the outgoing ARP request packet */ p = pbuf_alloc(PBUF_RAW, SIZEOF_ETHARP_PACKET, 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)); ethhdr = (struct eth_hdr *)p->payload; hdr = (struct etharp_hdr *)((u8_t*)ethhdr + SIZEOF_ETH_HDR); 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 ETHARP_HWADDR_LEN for etharp!", (netif->hwaddr_len == ETHARP_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 = ip_addr_islinklocal(ipsrc_addr) ? (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); /* 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); /* Copy struct ip_addr2 to aligned ip_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 = ETHARP_HWADDR_LEN; hdr->protolen = sizeof(ip_addr_t); ethhdr->type = PP_HTONS(ETHTYPE_ARP); /* 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. * * @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, ip_addr_t *ipaddr) { LWIP_DEBUGF(ETHARP_DEBUG | LWIP_DBG_TRACE, ("etharp_request: sending ARP request.\n")); return etharp_raw(netif, (struct eth_addr *)netif->hwaddr, ðbroadcast, (struct eth_addr *)netif->hwaddr, &netif->ip_addr, ðzero, ipaddr, ARP_REQUEST); } #endif /* LWIP_ARP */ /** * 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 recevied 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; s16_t ip_hdr_offset = SIZEOF_ETH_HDR; if (p->len <= SIZEOF_ETH_HDR) { /* a packet with only an ethernet header (or less) is not valid for us modify by ives at 2014.4.24*/ ETHARP_STATS_INC(etharp.proterr); ETHARP_STATS_INC(etharp.drop); 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 modify by ives at 2014.4.24*/ ETHARP_STATS_INC(etharp.proterr); ETHARP_STATS_INC(etharp.drop); goto free_and_return; } #ifdef ETHARP_VLAN_CHECK /* if not, allow all VLANs */ if (VLAN_ID(vlan) != ETHARP_VLAN_CHECK) { /* silently ignore this packet: not for our VLAN */ pbuf_free(p); return ERR_OK; } #endif /* ETHARP_VLAN_CHECK */ 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*/ switch (type) { #if 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(pbuf_header(p, -ip_hdr_offset)) { LWIP_ASSERT("Can't move over header in packet", 0); goto free_and_return; } else { /* pass to IP layer */ ip_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_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 */ default: ETHARP_STATS_INC(etharp.proterr); ETHARP_STATS_INC(etharp.drop); 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 */ ================================================ FILE: app/mqtt/Makefile ================================================ ############################################################# # Required variables for each makefile # Discard this section from all parent makefiles # Expected variables (with automatic defaults): # CSRCS (all "C" files in the dir) # SUBDIRS (all subdirs with a Makefile) # GEN_LIBS - list of libs to be generated () # GEN_IMAGES - list of images to be generated () # COMPONENTS_xxx - a list of libs/objs in the form # subdir/lib to be extracted and rolled up into # a generated lib/image xxx.a () # ifndef PDIR GEN_LIBS = mqtt.a endif ############################################################# # Configuration i.e. compile options etc. # Target specific stuff (defines etc.) goes in here! # Generally values applying to a tree are captured in the # makefile at its root level - these are then overridden # for a subtree within the makefile rooted therein # #DEFINES += ############################################################# # Recursion Magic - Don't touch this!! # # Each subtree potentially has an include directory # corresponding to the common APIs applicable to modules # rooted at that subtree. Accordingly, the INCLUDE PATH # of a module can only contain the include directories up # its parent path, and not its siblings # # Required for each makefile to inherit from the parent # INCLUDES := $(INCLUDES) -I $(PDIR)include INCLUDES += -I ./ INCLUDES += -I ../libc INCLUDES += -I ../ PDIR := ../$(PDIR) sinclude $(PDIR)Makefile ================================================ FILE: app/mqtt/app.c ================================================ #include "c_types.h" #include "c_string.h" #include "c_stdio.h" #include "user_interface.h" #include "mem.h" #include "osapi.h" #include "user_config.h" #include "espconn.h" #include "mqtt.h" #include "mqtt_msg.h" #include "driver/relay.h" #include "sensor/sensors.h" #include "serial_number.h" #define MQTT_SERVER_IP "104.131.71.110" #define MQTT_RELAY_SET_SUFIX "/SET" static os_timer_t mqtt_timer; static MQTT_Client mqtt_client; static os_timer_t sensor_read_timer; static uint8_t wifiStatus = STATION_IDLE, lastWifiStatus = STATION_IDLE; typedef struct mqtt_relay{ uint8_t id; char topic[20]; }mqtt_relay; mqtt_relay relays[RELAY_COUNT]; static void mqtt_relay_change_cb(int id,int state){ MQTT_DBG("mqtt_relay_change_cb #%d %d",id,state); mqtt_relay * relay = &relays[id]; if(state<0) state = relay_get_state(id); MQTT_Publish(&mqtt_client, relay->topic, state?"1":"0", 1, 0, 1); } static void ICACHE_FLASH_ATTR mqtt_app_timer_cb(void *arg){ struct ip_info ipConfig; wifi_get_ip_info(STATION_IF, &ipConfig); wifiStatus = wifi_station_get_connect_status(); //check wifi if(wifiStatus != lastWifiStatus){ lastWifiStatus = wifiStatus; if(wifiStatus==STATION_GOT_IP && ipConfig.ip.addr != 0){ MQTT_DBG("MQTT: Detected wifi network up"); MQTT_Connect(&mqtt_client); } else{ MQTT_DBG("MQTT: Detected wifi network down"); MQTT_Disconnect(&mqtt_client); } } } static void mqttConnectedCb(uint32_t *args) { MQTT_Client* client = (MQTT_Client*)args; MQTT_DBG("MQTT: Connected"); int i; for(i=0;itopic,strlen(r->topic))==0){ MQTT_DBG("Topic 1st part match"); //check set suffix if(os_strncmp(topic+strlen(r->topic),MQTT_RELAY_SET_SUFIX,strlen(MQTT_RELAY_SET_SUFIX))==0) { MQTT_DBG("Topic 2nd part match"); int state = data[0] - '0'; if(state==0 || state == 1) { MQTT_DBG("Setting relay #%d to %d via MQTT", i, state); relay_set_state(i,state); break; } } } } } static void ICACHE_FLASH_ATTR sensor_read_timer_cb(void *arg){ char * buff = (char *)os_zalloc(64); sensor_data data; sensors_get_data(&data); c_sprintf(buff,"%f",data.dht22.temp); MQTT_Publish(&mqtt_client, "temperature/"SERIAL_NUMBER, buff, strlen(buff), 0, 1); os_memset(buff,0,64); c_sprintf(buff,"%f",data.dht22.hum); MQTT_Publish(&mqtt_client, "humidity/"SERIAL_NUMBER, buff, strlen(buff), 0, 1); os_memset(buff,0,64); c_sprintf(buff,"%d",data.bmp180.press); MQTT_Publish(&mqtt_client, "pressure/"SERIAL_NUMBER, buff, strlen(buff), 0, 1); os_free(buff); } void ICACHE_FLASH_ATTR mqtt_app_init(){ //set relays int i; for(i=0;i * 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 Redis 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 "user_interface.h" #include "osapi.h" #include "espconn.h" #include "os_type.h" #include "mem.h" #include "mqtt_msg.h" #include "user_config.h" #include "mqtt.h" #include "queue.h" #define MQTT_TASK_PRIO 0 #define MQTT_TASK_QUEUE_SIZE 1 #define MQTT_SEND_TIMOUT 5 unsigned char *default_certificate; unsigned int default_certificate_len = 0; unsigned char *default_private_key; unsigned int default_private_key_len = 0; os_event_t mqtt_procTaskQueue[MQTT_TASK_QUEUE_SIZE]; LOCAL void ICACHE_FLASH_ATTR mqtt_dns_found(const char *name, ip_addr_t *ipaddr, void *arg) { struct espconn *pConn = (struct espconn *)arg; MQTT_Client* client = (MQTT_Client *)pConn->reverse; if(ipaddr == NULL) { MQTT_DBG("DNS: Found, but got no ip, try to reconnect"); client->connState = TCP_RECONNECT_REQ; return; } MQTT_DBG("DNS: found ip %d.%d.%d.%d", *((uint8 *) &ipaddr->addr), *((uint8 *) &ipaddr->addr + 1), *((uint8 *) &ipaddr->addr + 2), *((uint8 *) &ipaddr->addr + 3)); if(client->ip.addr == 0 && ipaddr->addr != 0) { os_memcpy(client->pCon->proto.tcp->remote_ip, &ipaddr->addr, 4); if(client->security){ espconn_secure_connect(client->pCon); } else { espconn_connect(client->pCon); } client->connState = TCP_CONNECTING; MQTT_DBG("TCP: connecting..."); } system_os_post(MQTT_TASK_PRIO, 0, (os_param_t)client); } LOCAL void ICACHE_FLASH_ATTR deliver_publish(MQTT_Client* client, uint8_t* message, int length) { mqtt_event_data_t event_data; event_data.topic_length = length; event_data.topic = mqtt_get_publish_topic(message, &event_data.topic_length); event_data.data_length = length; event_data.data = mqtt_get_publish_data(message, &event_data.data_length); if(client->dataCb) client->dataCb((uint32_t*)client, event_data.topic, event_data.topic_length, event_data.data, event_data.data_length); } /** * @brief Client received callback function. * @param arg: contain the ip link information * @param pdata: received data * @param len: the lenght of received data * @retval None */ void ICACHE_FLASH_ATTR mqtt_tcpclient_recv(void *arg, char *pdata, unsigned short len) { uint8_t msg_type; uint8_t msg_qos; uint16_t msg_id; struct espconn *pCon = (struct espconn*)arg; MQTT_Client *client = (MQTT_Client *)pCon->reverse; READPACKET: MQTT_DBG("TCP: data received %d bytes", len); if(len < MQTT_BUF_SIZE && len > 0){ os_memcpy(client->mqtt_state.in_buffer, pdata, len); msg_type = mqtt_get_type(client->mqtt_state.in_buffer); msg_qos = mqtt_get_qos(client->mqtt_state.in_buffer); msg_id = mqtt_get_id(client->mqtt_state.in_buffer, client->mqtt_state.in_buffer_length); switch(client->connState){ case MQTT_CONNECT_SENDING: if(msg_type == MQTT_MSG_TYPE_CONNACK){ if(client->mqtt_state.pending_msg_type != MQTT_MSG_TYPE_CONNECT){ MQTT_DBG("MQTT: Invalid packet"); if(client->security){ espconn_secure_disconnect(client->pCon); } else { espconn_disconnect(client->pCon); } } else { MQTT_DBG("MQTT: Connected to %s:%d", client->host, client->port); client->connState = MQTT_DATA; if(client->connectedCb) client->connectedCb((uint32_t*)client); } } break; case MQTT_DATA: client->mqtt_state.message_length_read = len; client->mqtt_state.message_length = mqtt_get_total_length(client->mqtt_state.in_buffer, client->mqtt_state.message_length_read); switch(msg_type) { case MQTT_MSG_TYPE_SUBACK: if(client->mqtt_state.pending_msg_type == MQTT_MSG_TYPE_SUBSCRIBE && client->mqtt_state.pending_msg_id == msg_id) MQTT_DBG("MQTT: Subscribe successful"); break; case MQTT_MSG_TYPE_UNSUBACK: if(client->mqtt_state.pending_msg_type == MQTT_MSG_TYPE_UNSUBSCRIBE && client->mqtt_state.pending_msg_id == msg_id) MQTT_DBG("MQTT: UnSubscribe successful"); break; case MQTT_MSG_TYPE_PUBLISH: if(msg_qos == 1) client->mqtt_state.outbound_message = mqtt_msg_puback(&client->mqtt_state.mqtt_connection, msg_id); else if(msg_qos == 2) client->mqtt_state.outbound_message = mqtt_msg_pubrec(&client->mqtt_state.mqtt_connection, msg_id); if(msg_qos == 1 || msg_qos == 2){ MQTT_DBG("MQTT: Queue response QoS: %d", msg_qos); if(QUEUE_Puts(&client->msgQueue, client->mqtt_state.outbound_message->data, client->mqtt_state.outbound_message->length) == -1){ MQTT_DBG("MQTT: Queue full"); } } deliver_publish(client, client->mqtt_state.in_buffer, client->mqtt_state.message_length_read); break; case MQTT_MSG_TYPE_PUBACK: if(client->mqtt_state.pending_msg_type == MQTT_MSG_TYPE_PUBLISH && client->mqtt_state.pending_msg_id == msg_id){ MQTT_DBG("MQTT: received MQTT_MSG_TYPE_PUBACK, finish QoS1 publish"); } break; case MQTT_MSG_TYPE_PUBREC: client->mqtt_state.outbound_message = mqtt_msg_pubrel(&client->mqtt_state.mqtt_connection, msg_id); if(QUEUE_Puts(&client->msgQueue, client->mqtt_state.outbound_message->data, client->mqtt_state.outbound_message->length) == -1){ MQTT_DBG("MQTT: Queue full"); } break; case MQTT_MSG_TYPE_PUBREL: client->mqtt_state.outbound_message = mqtt_msg_pubcomp(&client->mqtt_state.mqtt_connection, msg_id); if(QUEUE_Puts(&client->msgQueue, client->mqtt_state.outbound_message->data, client->mqtt_state.outbound_message->length) == -1){ MQTT_DBG("MQTT: Queue full"); } break; case MQTT_MSG_TYPE_PUBCOMP: if(client->mqtt_state.pending_msg_type == MQTT_MSG_TYPE_PUBLISH && client->mqtt_state.pending_msg_id == msg_id){ MQTT_DBG("MQTT: receive MQTT_MSG_TYPE_PUBCOMP, finish QoS2 publish"); } break; case MQTT_MSG_TYPE_PINGREQ: client->mqtt_state.outbound_message = mqtt_msg_pingresp(&client->mqtt_state.mqtt_connection); if(QUEUE_Puts(&client->msgQueue, client->mqtt_state.outbound_message->data, client->mqtt_state.outbound_message->length) == -1){ MQTT_DBG("MQTT: Queue full"); } break; case MQTT_MSG_TYPE_PINGRESP: // Ignore break; } // NOTE: this is done down here and not in the switch case above // because the PSOCK_READBUF_LEN() won't work inside a switch // statement due to the way protothreads resume. if(msg_type == MQTT_MSG_TYPE_PUBLISH) { len = client->mqtt_state.message_length_read; if(client->mqtt_state.message_length < client->mqtt_state.message_length_read) { //client->connState = MQTT_PUBLISH_RECV; //Not Implement yet len -= client->mqtt_state.message_length; pdata += client->mqtt_state.message_length; MQTT_DBG("Get another published message"); goto READPACKET; } } break; } } else { MQTT_DBG("ERROR: Message too long"); } system_os_post(MQTT_TASK_PRIO, 0, (os_param_t)client); } /** * @brief Client send over callback function. * @param arg: contain the ip link information * @retval None */ void ICACHE_FLASH_ATTR mqtt_tcpclient_sent_cb(void *arg) { struct espconn *pCon = (struct espconn *)arg; MQTT_Client* client = (MQTT_Client *)pCon->reverse; MQTT_DBG("TCP: Sent"); client->sendTimeout = 0; if(client->connState == MQTT_DATA && client->mqtt_state.pending_msg_type == MQTT_MSG_TYPE_PUBLISH){ if(client->publishedCb) client->publishedCb((uint32_t*)client); } system_os_post(MQTT_TASK_PRIO, 0, (os_param_t)client); } void ICACHE_FLASH_ATTR mqtt_timer(void *arg) { MQTT_Client* client = (MQTT_Client*)arg; if(client->connState == MQTT_DATA){ client->keepAliveTick ++; if(client->keepAliveTick > client->mqtt_state.connect_info->keepalive){ MQTT_DBG("MQTT: Send keepalive packet to %s:%d!", client->host, client->port); client->mqtt_state.outbound_message = mqtt_msg_pingreq(&client->mqtt_state.mqtt_connection); client->mqtt_state.pending_msg_type = MQTT_MSG_TYPE_PINGREQ; client->mqtt_state.pending_msg_type = mqtt_get_type(client->mqtt_state.outbound_message->data); client->mqtt_state.pending_msg_id = mqtt_get_id(client->mqtt_state.outbound_message->data, client->mqtt_state.outbound_message->length); client->sendTimeout = MQTT_SEND_TIMOUT; MQTT_DBG("MQTT: Sending, type: %d, id: %04X",client->mqtt_state.pending_msg_type, client->mqtt_state.pending_msg_id); if(client->security){ espconn_secure_sent(client->pCon, client->mqtt_state.outbound_message->data, client->mqtt_state.outbound_message->length); } else{ espconn_send(client->pCon, client->mqtt_state.outbound_message->data, client->mqtt_state.outbound_message->length); } client->mqtt_state.outbound_message = NULL; client->keepAliveTick = 0; system_os_post(MQTT_TASK_PRIO, 0, (os_param_t)client); } } else if(client->connState == TCP_RECONNECT_REQ){ client->reconnectTick ++; if(client->reconnectTick > MQTT_RECONNECT_TIMEOUT) { client->reconnectTick = 0; client->connState = TCP_RECONNECT; system_os_post(MQTT_TASK_PRIO, 0, (os_param_t)client); } } if(client->sendTimeout > 0) client->sendTimeout --; } void ICACHE_FLASH_ATTR mqtt_tcpclient_discon_cb(void *arg) { struct espconn *pespconn = (struct espconn *)arg; MQTT_Client* client = (MQTT_Client *)pespconn->reverse; MQTT_DBG("TCP: Disconnected callback"); client->connState = TCP_RECONNECT_REQ; if(client->disconnectedCb) client->disconnectedCb((uint32_t*)client); system_os_post(MQTT_TASK_PRIO, 0, (os_param_t)client); } /** * @brief Tcp client connect success callback function. * @param arg: contain the ip link information * @retval None */ void ICACHE_FLASH_ATTR mqtt_tcpclient_connect_cb(void *arg) { struct espconn *pCon = (struct espconn *)arg; MQTT_Client* client = (MQTT_Client *)pCon->reverse; //set opt espconn_set_opt(pCon, ESPCONN_NODELAY | ESPCONN_REUSEADDR | ESPCONN_KEEPALIVE); espconn_regist_disconcb(client->pCon, mqtt_tcpclient_discon_cb); espconn_regist_recvcb(client->pCon, mqtt_tcpclient_recv);//////// espconn_regist_sentcb(client->pCon, mqtt_tcpclient_sent_cb);/////// MQTT_DBG("MQTT: Connected to broker %s:%d", client->host, client->port); mqtt_msg_init(&client->mqtt_state.mqtt_connection, client->mqtt_state.out_buffer, client->mqtt_state.out_buffer_length); client->mqtt_state.outbound_message = mqtt_msg_connect(&client->mqtt_state.mqtt_connection, client->mqtt_state.connect_info); client->mqtt_state.pending_msg_type = mqtt_get_type(client->mqtt_state.outbound_message->data); client->mqtt_state.pending_msg_id = mqtt_get_id(client->mqtt_state.outbound_message->data, client->mqtt_state.outbound_message->length); client->sendTimeout = MQTT_SEND_TIMOUT; MQTT_DBG("MQTT: Sending, type: %d, id: %04X",client->mqtt_state.pending_msg_type, client->mqtt_state.pending_msg_id); if(client->security){ espconn_secure_sent(client->pCon, client->mqtt_state.outbound_message->data, client->mqtt_state.outbound_message->length); } else{ espconn_send(client->pCon, client->mqtt_state.outbound_message->data, client->mqtt_state.outbound_message->length); } client->mqtt_state.outbound_message = NULL; client->connState = MQTT_CONNECT_SENDING; system_os_post(MQTT_TASK_PRIO, 0, (os_param_t)client); } /** * @brief Tcp client connect repeat callback function. * @param arg: contain the ip link information * @retval None */ void ICACHE_FLASH_ATTR mqtt_tcpclient_recon_cb(void *arg, sint8 errType) { struct espconn *pCon = (struct espconn *)arg; MQTT_Client* client = (MQTT_Client *)pCon->reverse; MQTT_DBG("TCP: Reconnect to %s:%d", client->host, client->port); client->connState = TCP_RECONNECT_REQ; system_os_post(MQTT_TASK_PRIO, 0, (os_param_t)client); } /** * @brief MQTT publish function. * @param client: MQTT_Client reference * @param topic: string topic will publish to * @param data: buffer data send point to * @param data_length: length of data * @param qos: qos * @param retain: retain * @retval TRUE if success queue */ BOOL ICACHE_FLASH_ATTR MQTT_Publish(MQTT_Client *client, const char* topic, const char* data, int data_length, int qos, int retain) { uint8_t dataBuffer[MQTT_BUF_SIZE]; uint16_t dataLen; client->mqtt_state.outbound_message = mqtt_msg_publish(&client->mqtt_state.mqtt_connection, topic, data, data_length, qos, retain, &client->mqtt_state.pending_msg_id); if(client->mqtt_state.outbound_message->length == 0){ MQTT_DBG("MQTT: Queuing publish failed"); return FALSE; } MQTT_DBG("MQTT: queuing publish, length: %d, queue size(%d/%d)", client->mqtt_state.outbound_message->length, client->msgQueue.rb.fill_cnt, client->msgQueue.rb.size); while(QUEUE_Puts(&client->msgQueue, client->mqtt_state.outbound_message->data, client->mqtt_state.outbound_message->length) == -1){ MQTT_DBG("MQTT: Queue full"); if(QUEUE_Gets(&client->msgQueue, dataBuffer, &dataLen, MQTT_BUF_SIZE) == -1) { MQTT_DBG("MQTT: Serious buffer error"); return FALSE; } } system_os_post(MQTT_TASK_PRIO, 0, (os_param_t)client); return TRUE; } /** * @brief MQTT subscibe function. * @param client: MQTT_Client reference * @param topic: string topic will subscribe * @param qos: qos * @retval TRUE if success queue */ BOOL ICACHE_FLASH_ATTR MQTT_Subscribe(MQTT_Client *client, char* topic, uint8_t qos) { uint8_t dataBuffer[MQTT_BUF_SIZE]; uint16_t dataLen; client->mqtt_state.outbound_message = mqtt_msg_subscribe(&client->mqtt_state.mqtt_connection, topic, 0, &client->mqtt_state.pending_msg_id); MQTT_DBG("MQTT: queue subscribe, topic\"%s\", id: %d",topic, client->mqtt_state.pending_msg_id); while(QUEUE_Puts(&client->msgQueue, client->mqtt_state.outbound_message->data, client->mqtt_state.outbound_message->length) == -1){ MQTT_DBG("MQTT: Queue full"); if(QUEUE_Gets(&client->msgQueue, dataBuffer, &dataLen, MQTT_BUF_SIZE) == -1) { MQTT_DBG("MQTT: Serious buffer error"); return FALSE; } } system_os_post(MQTT_TASK_PRIO, 0, (os_param_t)client); return TRUE; } void ICACHE_FLASH_ATTR MQTT_Task(os_event_t *e) { MQTT_Client* client = (MQTT_Client*)e->par; uint8_t dataBuffer[MQTT_BUF_SIZE]; uint16_t dataLen; if(e->par == 0) return; switch(client->connState){ case TCP_RECONNECT_REQ: break; case TCP_RECONNECT: MQTT_Connect(client); MQTT_DBG("TCP: Reconnect to: %s:%d", client->host, client->port); client->connState = TCP_CONNECTING; break; case MQTT_DATA: if(QUEUE_IsEmpty(&client->msgQueue) || client->sendTimeout != 0) { break; } if(QUEUE_Gets(&client->msgQueue, dataBuffer, &dataLen, MQTT_BUF_SIZE) == 0){ client->mqtt_state.pending_msg_type = mqtt_get_type(dataBuffer); client->mqtt_state.pending_msg_id = mqtt_get_id(dataBuffer, dataLen); client->sendTimeout = MQTT_SEND_TIMOUT; MQTT_DBG("MQTT: Sending, type: %d, id: %04X",client->mqtt_state.pending_msg_type, client->mqtt_state.pending_msg_id); if(client->security){ espconn_secure_sent(client->pCon, dataBuffer, dataLen); } else{ espconn_send(client->pCon, dataBuffer, dataLen); } client->mqtt_state.outbound_message = NULL; break; } break; } } /** * @brief MQTT initialization connection function * @param client: MQTT_Client reference * @param host: Domain or IP string * @param port: Port to connect * @param security: 1 for ssl, 0 for none * @retval None */ void ICACHE_FLASH_ATTR MQTT_InitConnection(MQTT_Client *mqttClient, uint8_t* host, uint32 port, uint8_t security) { uint32_t temp; MQTT_DBG("MQTT_InitConnection"); os_memset(mqttClient, 0, sizeof(MQTT_Client)); temp = os_strlen(host); mqttClient->host = (uint8_t*)os_zalloc(temp + 1); os_strcpy(mqttClient->host, host); mqttClient->host[temp] = 0; mqttClient->port = port; mqttClient->security = security; } /** * @brief MQTT initialization mqtt client function * @param client: MQTT_Client reference * @param clientid: MQTT client id * @param client_user:MQTT client user * @param client_pass:MQTT client password * @param client_pass:MQTT keep alive timer, in second * @retval None */ void ICACHE_FLASH_ATTR MQTT_InitClient(MQTT_Client *mqttClient, char* client_id, char* client_user, char* client_pass, uint32_t keepAliveTime, uint8_t cleanSession) { uint32_t temp; MQTT_DBG("MQTT_InitClient"); os_memset(&mqttClient->connect_info, 0, sizeof(mqtt_connect_info_t)); mqttClient->connect_info.client_id= client_id; mqttClient->connect_info.username = client_user; mqttClient->connect_info.password = client_pass; mqttClient->connect_info.keepalive = keepAliveTime; mqttClient->connect_info.clean_session = cleanSession; mqttClient->mqtt_state.in_buffer = (uint8_t *)os_zalloc(MQTT_BUF_SIZE); mqttClient->mqtt_state.in_buffer_length = MQTT_BUF_SIZE; mqttClient->mqtt_state.out_buffer = (uint8_t *)os_zalloc(MQTT_BUF_SIZE); mqttClient->mqtt_state.out_buffer_length = MQTT_BUF_SIZE; mqttClient->mqtt_state.connect_info = &mqttClient->connect_info; mqtt_msg_init(&mqttClient->mqtt_state.mqtt_connection, mqttClient->mqtt_state.out_buffer, mqttClient->mqtt_state.out_buffer_length); QUEUE_Init(&mqttClient->msgQueue, QUEUE_BUFFER_SIZE); system_os_task(MQTT_Task, MQTT_TASK_PRIO, mqtt_procTaskQueue, MQTT_TASK_QUEUE_SIZE); system_os_post(MQTT_TASK_PRIO, 0, (os_param_t)mqttClient); } void ICACHE_FLASH_ATTR MQTT_InitLWT(MQTT_Client *mqttClient, uint8_t* will_topic, uint8_t* will_msg, uint8_t will_qos, uint8_t will_retain) { uint32_t temp; temp = os_strlen(will_topic); mqttClient->connect_info.will_topic = (uint8_t*)os_zalloc(temp + 1); os_strcpy(mqttClient->connect_info.will_topic, will_topic); mqttClient->connect_info.will_topic[temp] = 0; temp = os_strlen(will_msg); mqttClient->connect_info.will_message = (uint8_t*)os_zalloc(temp + 1); os_strcpy(mqttClient->connect_info.will_message, will_msg); mqttClient->connect_info.will_message[temp] = 0; mqttClient->connect_info.will_qos = will_qos; mqttClient->connect_info.will_retain = will_retain; } /** * @brief Begin connect to MQTT broker * @param client: MQTT_Client reference * @retval None */ void ICACHE_FLASH_ATTR MQTT_Connect(MQTT_Client *mqttClient) { MQTT_Disconnect(mqttClient); mqttClient->pCon = (struct espconn *)os_zalloc(sizeof(struct espconn)); mqttClient->pCon->type = ESPCONN_TCP; mqttClient->pCon->state = ESPCONN_NONE; mqttClient->pCon->proto.tcp = (esp_tcp *)os_zalloc(sizeof(esp_tcp)); mqttClient->pCon->proto.tcp->local_port = espconn_port(); mqttClient->pCon->proto.tcp->remote_port = mqttClient->port; mqttClient->pCon->reverse = mqttClient; espconn_regist_connectcb(mqttClient->pCon, mqtt_tcpclient_connect_cb); espconn_regist_reconcb(mqttClient->pCon, mqtt_tcpclient_recon_cb); mqttClient->keepAliveTick = 0; mqttClient->reconnectTick = 0; os_timer_disarm(&mqttClient->mqttTimer); os_timer_setfn(&mqttClient->mqttTimer, (os_timer_func_t *)mqtt_timer, mqttClient); os_timer_arm(&mqttClient->mqttTimer, 1000, 1); if(UTILS_StrToIP(mqttClient->host, &mqttClient->pCon->proto.tcp->remote_ip)) { MQTT_DBG("TCP: Connect to ip %s:%d", mqttClient->host, mqttClient->port); if(mqttClient->security){ espconn_secure_connect(mqttClient->pCon); } else { espconn_connect(mqttClient->pCon); } } else { MQTT_DBG("TCP: Connect to domain %s:%d", mqttClient->host, mqttClient->port); espconn_gethostbyname(mqttClient->pCon, mqttClient->host, &mqttClient->ip, mqtt_dns_found); } mqttClient->connState = TCP_CONNECTING; } void ICACHE_FLASH_ATTR MQTT_Disconnect(MQTT_Client *mqttClient) { if(mqttClient->pCon){ MQTT_DBG("Free memory"); if(mqttClient->pCon->proto.tcp) os_free(mqttClient->pCon->proto.tcp); os_free(mqttClient->pCon); mqttClient->pCon = NULL; } os_timer_disarm(&mqttClient->mqttTimer); } void ICACHE_FLASH_ATTR MQTT_OnConnected(MQTT_Client *mqttClient, MqttCallback connectedCb) { mqttClient->connectedCb = connectedCb; } void ICACHE_FLASH_ATTR MQTT_OnDisconnected(MQTT_Client *mqttClient, MqttCallback disconnectedCb) { mqttClient->disconnectedCb = disconnectedCb; } void ICACHE_FLASH_ATTR MQTT_OnData(MQTT_Client *mqttClient, MqttDataCallback dataCb) { mqttClient->dataCb = dataCb; } void ICACHE_FLASH_ATTR MQTT_OnPublished(MQTT_Client *mqttClient, MqttCallback publishedCb) { mqttClient->publishedCb = publishedCb; } ================================================ FILE: app/mqtt/mqtt.h ================================================ /* mqtt.h * * Copyright (c) 2014-2015, Tuan PM * 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 Redis 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. */ #ifndef USER_AT_MQTT_H_ #define USER_AT_MQTT_H_ #include "mqtt_msg.h" #include "user_interface.h" #define MQTT_BUF_SIZE 1024 #define MQTT_RECONNECT_TIMEOUT 5 #define QUEUE_BUFFER_SIZE 2048 #define MQTT_DEBUG_ON #ifdef MQTT_DEBUG_ON #define MQTT_DBG NODE_DBG #else #define MQTT_DBG #endif #include "queue.h" typedef struct mqtt_event_data_t { uint8_t type; const char* topic; const char* data; uint16_t topic_length; uint16_t data_length; uint16_t data_offset; } mqtt_event_data_t; typedef struct mqtt_state_t { uint16_t port; int auto_reconnect; mqtt_connect_info_t* connect_info; uint8_t* in_buffer; uint8_t* out_buffer; int in_buffer_length; int out_buffer_length; uint16_t message_length; uint16_t message_length_read; mqtt_message_t* outbound_message; mqtt_connection_t mqtt_connection; uint16_t pending_msg_id; int pending_msg_type; int pending_publish_qos; } mqtt_state_t; typedef enum { WIFI_INIT, WIFI_CONNECTING, WIFI_CONNECTING_ERROR, WIFI_CONNECTED, DNS_RESOLVE, TCP_DISCONNECTED, TCP_RECONNECT_REQ, TCP_RECONNECT, TCP_CONNECTING, TCP_CONNECTING_ERROR, TCP_CONNECTED, MQTT_CONNECT_SEND, MQTT_CONNECT_SENDING, MQTT_SUBSCIBE_SEND, MQTT_SUBSCIBE_SENDING, MQTT_DATA, MQTT_PUBLISH_RECV, MQTT_PUBLISHING } tConnState; typedef void (*MqttCallback)(uint32_t *args); typedef void (*MqttDataCallback)(uint32_t *args, const char* topic, uint32_t topic_len, const char *data, uint32_t lengh); typedef struct { struct espconn *pCon; uint8_t security; uint8_t* host; uint32_t port; ip_addr_t ip; mqtt_state_t mqtt_state; mqtt_connect_info_t connect_info; MqttCallback connectedCb; MqttCallback disconnectedCb; MqttCallback publishedCb; MqttDataCallback dataCb; ETSTimer mqttTimer; uint32_t keepAliveTick; uint32_t reconnectTick; uint32_t sendTimeout; tConnState connState; QUEUE msgQueue; void* user_data; } MQTT_Client; #define SEC_NONSSL 0 #define SEC_SSL 1 #define MQTT_FLAG_CONNECTED 1 #define MQTT_FLAG_READY 2 #define MQTT_FLAG_EXIT 4 #define MQTT_EVENT_TYPE_NONE 0 #define MQTT_EVENT_TYPE_CONNECTED 1 #define MQTT_EVENT_TYPE_DISCONNECTED 2 #define MQTT_EVENT_TYPE_SUBSCRIBED 3 #define MQTT_EVENT_TYPE_UNSUBSCRIBED 4 #define MQTT_EVENT_TYPE_PUBLISH 5 #define MQTT_EVENT_TYPE_PUBLISHED 6 #define MQTT_EVENT_TYPE_EXITED 7 #define MQTT_EVENT_TYPE_PUBLISH_CONTINUATION 8 void ICACHE_FLASH_ATTR MQTT_InitConnection(MQTT_Client *mqttClient, uint8_t* host, uint32 port, uint8_t security); void ICACHE_FLASH_ATTR MQTT_InitClient(MQTT_Client *mqttClient, char* client_id, char* client_user, char* client_pass, uint32_t keepAliveTime, uint8_t cleanSession); void ICACHE_FLASH_ATTR MQTT_InitLWT(MQTT_Client *mqttClient, uint8_t* will_topic, uint8_t* will_msg, uint8_t will_qos, uint8_t will_retain); void ICACHE_FLASH_ATTR MQTT_OnConnected(MQTT_Client *mqttClient, MqttCallback connectedCb); void ICACHE_FLASH_ATTR MQTT_OnDisconnected(MQTT_Client *mqttClient, MqttCallback disconnectedCb); void ICACHE_FLASH_ATTR MQTT_OnPublished(MQTT_Client *mqttClient, MqttCallback publishedCb); void ICACHE_FLASH_ATTR MQTT_OnData(MQTT_Client *mqttClient, MqttDataCallback dataCb); BOOL ICACHE_FLASH_ATTR MQTT_Subscribe(MQTT_Client *client, char* topic, uint8_t qos); void ICACHE_FLASH_ATTR MQTT_Connect(MQTT_Client *mqttClient); void ICACHE_FLASH_ATTR MQTT_Disconnect(MQTT_Client *mqttClient); BOOL ICACHE_FLASH_ATTR MQTT_Publish(MQTT_Client *client, const char* topic, const char* data, int data_length, int qos, int retain); #endif /* USER_AT_MQTT_H_ */ ================================================ FILE: app/mqtt/mqtt_msg.c ================================================ /* * Copyright (c) 2014, Stephen Robinson * 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 copyright holder 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. * */ #include #include "mqtt_msg.h" #include "user_config.h" #define MQTT_MAX_FIXED_HEADER_SIZE 3 enum mqtt_connect_flag { MQTT_CONNECT_FLAG_USERNAME = 1 << 7, MQTT_CONNECT_FLAG_PASSWORD = 1 << 6, MQTT_CONNECT_FLAG_WILL_RETAIN = 1 << 5, MQTT_CONNECT_FLAG_WILL = 1 << 2, MQTT_CONNECT_FLAG_CLEAN_SESSION = 1 << 1 }; struct __attribute((__packed__)) mqtt_connect_variable_header { uint8_t lengthMsb; uint8_t lengthLsb; #if defined(PROTOCOL_NAMEv31) uint8_t magic[6]; #elif defined(PROTOCOL_NAMEv311) uint8_t magic[4]; #else #error "Please define protocol name" #endif uint8_t version; uint8_t flags; uint8_t keepaliveMsb; uint8_t keepaliveLsb; }; static int ICACHE_FLASH_ATTR append_string(mqtt_connection_t* connection, const char* string, int len) { if(connection->message.length + len + 2 > connection->buffer_length) return -1; connection->buffer[connection->message.length++] = len >> 8; connection->buffer[connection->message.length++] = len & 0xff; memcpy(connection->buffer + connection->message.length, string, len); connection->message.length += len; return len + 2; } static uint16_t ICACHE_FLASH_ATTR append_message_id(mqtt_connection_t* connection, uint16_t message_id) { // If message_id is zero then we should assign one, otherwise // we'll use the one supplied by the caller while(message_id == 0) message_id = ++connection->message_id; if(connection->message.length + 2 > connection->buffer_length) return 0; connection->buffer[connection->message.length++] = message_id >> 8; connection->buffer[connection->message.length++] = message_id & 0xff; return message_id; } static int ICACHE_FLASH_ATTR init_message(mqtt_connection_t* connection) { connection->message.length = MQTT_MAX_FIXED_HEADER_SIZE; return MQTT_MAX_FIXED_HEADER_SIZE; } static mqtt_message_t* ICACHE_FLASH_ATTR fail_message(mqtt_connection_t* connection) { connection->message.data = connection->buffer; connection->message.length = 0; return &connection->message; } static mqtt_message_t* ICACHE_FLASH_ATTR fini_message(mqtt_connection_t* connection, int type, int dup, int qos, int retain) { int remaining_length = connection->message.length - MQTT_MAX_FIXED_HEADER_SIZE; if(remaining_length > 127) { connection->buffer[0] = ((type & 0x0f) << 4) | ((dup & 1) << 3) | ((qos & 3) << 1) | (retain & 1); connection->buffer[1] = 0x80 | (remaining_length % 128); connection->buffer[2] = remaining_length / 128; connection->message.length = remaining_length + 3; connection->message.data = connection->buffer; } else { connection->buffer[1] = ((type & 0x0f) << 4) | ((dup & 1) << 3) | ((qos & 3) << 1) | (retain & 1); connection->buffer[2] = remaining_length; connection->message.length = remaining_length + 2; connection->message.data = connection->buffer + 1; } return &connection->message; } void ICACHE_FLASH_ATTR mqtt_msg_init(mqtt_connection_t* connection, uint8_t* buffer, uint16_t buffer_length) { memset(connection, 0, sizeof(connection)); connection->buffer = buffer; connection->buffer_length = buffer_length; } int ICACHE_FLASH_ATTR mqtt_get_total_length(uint8_t* buffer, uint16_t length) { int i; int totlen = 0; for(i = 1; i < length; ++i) { totlen += (buffer[i] & 0x7f) << (7 * (i - 1)); if((buffer[i] & 0x80) == 0) { ++i; break; } } totlen += i; return totlen; } const char* ICACHE_FLASH_ATTR mqtt_get_publish_topic(uint8_t* buffer, uint16_t* length) { int i; int totlen = 0; int topiclen; for(i = 1; i < *length; ++i) { totlen += (buffer[i] & 0x7f) << (7 * (i -1)); if((buffer[i] & 0x80) == 0) { ++i; break; } } totlen += i; if(i + 2 >= *length) return NULL; topiclen = buffer[i++] << 8; topiclen |= buffer[i++]; if(i + topiclen > *length) return NULL; *length = topiclen; return (const char*)(buffer + i); } const char* ICACHE_FLASH_ATTR mqtt_get_publish_data(uint8_t* buffer, uint16_t* length) { int i; int totlen = 0; int topiclen; for(i = 1; i < *length; ++i) { totlen += (buffer[i] & 0x7f) << (7 * (i - 1)); if((buffer[i] & 0x80) == 0) { ++i; break; } } totlen += i; if(i + 2 >= *length) return NULL; topiclen = buffer[i++] << 8; topiclen |= buffer[i++]; if(i + topiclen >= *length){ *length = 0; return NULL; } i += topiclen; if(mqtt_get_qos(buffer) > 0) { if(i + 2 >= *length) return NULL; i += 2; } if(totlen < i) return NULL; if(totlen <= *length) *length = totlen - i; else *length = *length - i; return (const char*)(buffer + i); } uint16_t ICACHE_FLASH_ATTR mqtt_get_id(uint8_t* buffer, uint16_t length) { if(length < 1) return 0; switch(mqtt_get_type(buffer)) { case MQTT_MSG_TYPE_PUBLISH: { int i; int topiclen; for(i = 1; i < length; ++i) { if((buffer[i] & 0x80) == 0) { ++i; break; } } if(i + 2 >= length) return 0; topiclen = buffer[i++] << 8; topiclen |= buffer[i++]; if(i + topiclen >= length) return 0; i += topiclen; if(mqtt_get_qos(buffer) > 0) { if(i + 2 >= length) return 0; //i += 2; } else { return 0; } return (buffer[i] << 8) | buffer[i + 1]; } case MQTT_MSG_TYPE_PUBACK: case MQTT_MSG_TYPE_PUBREC: case MQTT_MSG_TYPE_PUBREL: case MQTT_MSG_TYPE_PUBCOMP: case MQTT_MSG_TYPE_SUBACK: case MQTT_MSG_TYPE_UNSUBACK: case MQTT_MSG_TYPE_SUBSCRIBE: { // This requires the remaining length to be encoded in 1 byte, // which it should be. if(length >= 4 && (buffer[1] & 0x80) == 0) return (buffer[2] << 8) | buffer[3]; else return 0; } default: return 0; } } mqtt_message_t* ICACHE_FLASH_ATTR mqtt_msg_connect(mqtt_connection_t* connection, mqtt_connect_info_t* info) { struct mqtt_connect_variable_header* variable_header; init_message(connection); if(connection->message.length + sizeof(*variable_header) > connection->buffer_length) return fail_message(connection); variable_header = (void*)(connection->buffer + connection->message.length); connection->message.length += sizeof(*variable_header); variable_header->lengthMsb = 0; #if defined(PROTOCOL_NAMEv31) variable_header->lengthLsb = 6; memcpy(variable_header->magic, "MQIsdp", 6); variable_header->version = 3; #elif defined(PROTOCOL_NAMEv311) variable_header->lengthLsb = 4; memcpy(variable_header->magic, "MQTT", 4); variable_header->version = 4; #else #error "Please define protocol name" #endif variable_header->flags = 0; variable_header->keepaliveMsb = info->keepalive >> 8; variable_header->keepaliveLsb = info->keepalive & 0xff; if(info->clean_session) variable_header->flags |= MQTT_CONNECT_FLAG_CLEAN_SESSION; if(info->client_id != NULL && info->client_id[0] != '\0') { if(append_string(connection, info->client_id, strlen(info->client_id)) < 0) return fail_message(connection); } else return fail_message(connection); if(info->will_topic != NULL && info->will_topic[0] != '\0') { if(append_string(connection, info->will_topic, strlen(info->will_topic)) < 0) return fail_message(connection); if(append_string(connection, info->will_message, strlen(info->will_message)) < 0) return fail_message(connection); variable_header->flags |= MQTT_CONNECT_FLAG_WILL; if(info->will_retain) variable_header->flags |= MQTT_CONNECT_FLAG_WILL_RETAIN; variable_header->flags |= (info->will_qos & 3) << 3; } if(info->username != NULL && info->username[0] != '\0') { if(append_string(connection, info->username, strlen(info->username)) < 0) return fail_message(connection); variable_header->flags |= MQTT_CONNECT_FLAG_USERNAME; } if(info->password != NULL && info->password[0] != '\0') { if(append_string(connection, info->password, strlen(info->password)) < 0) return fail_message(connection); variable_header->flags |= MQTT_CONNECT_FLAG_PASSWORD; } return fini_message(connection, MQTT_MSG_TYPE_CONNECT, 0, 0, 0); } mqtt_message_t* ICACHE_FLASH_ATTR mqtt_msg_publish(mqtt_connection_t* connection, const char* topic, const char* data, int data_length, int qos, int retain, uint16_t* message_id) { init_message(connection); if(topic == NULL || topic[0] == '\0') return fail_message(connection); if(append_string(connection, topic, strlen(topic)) < 0) return fail_message(connection); if(qos > 0) { if((*message_id = append_message_id(connection, 0)) == 0) return fail_message(connection); } else *message_id = 0; if(connection->message.length + data_length > connection->buffer_length) return fail_message(connection); memcpy(connection->buffer + connection->message.length, data, data_length); connection->message.length += data_length; return fini_message(connection, MQTT_MSG_TYPE_PUBLISH, 0, qos, retain); } mqtt_message_t* ICACHE_FLASH_ATTR mqtt_msg_puback(mqtt_connection_t* connection, uint16_t message_id) { init_message(connection); if(append_message_id(connection, message_id) == 0) return fail_message(connection); return fini_message(connection, MQTT_MSG_TYPE_PUBACK, 0, 0, 0); } mqtt_message_t* ICACHE_FLASH_ATTR mqtt_msg_pubrec(mqtt_connection_t* connection, uint16_t message_id) { init_message(connection); if(append_message_id(connection, message_id) == 0) return fail_message(connection); return fini_message(connection, MQTT_MSG_TYPE_PUBREC, 0, 0, 0); } mqtt_message_t* ICACHE_FLASH_ATTR mqtt_msg_pubrel(mqtt_connection_t* connection, uint16_t message_id) { init_message(connection); if(append_message_id(connection, message_id) == 0) return fail_message(connection); return fini_message(connection, MQTT_MSG_TYPE_PUBREL, 0, 1, 0); } mqtt_message_t* ICACHE_FLASH_ATTR mqtt_msg_pubcomp(mqtt_connection_t* connection, uint16_t message_id) { init_message(connection); if(append_message_id(connection, message_id) == 0) return fail_message(connection); return fini_message(connection, MQTT_MSG_TYPE_PUBCOMP, 0, 0, 0); } mqtt_message_t* ICACHE_FLASH_ATTR mqtt_msg_subscribe(mqtt_connection_t* connection, const char* topic, int qos, uint16_t* message_id) { init_message(connection); if(topic == NULL || topic[0] == '\0') return fail_message(connection); if((*message_id = append_message_id(connection, 0)) == 0) return fail_message(connection); if(append_string(connection, topic, strlen(topic)) < 0) return fail_message(connection); if(connection->message.length + 1 > connection->buffer_length) return fail_message(connection); connection->buffer[connection->message.length++] = qos; return fini_message(connection, MQTT_MSG_TYPE_SUBSCRIBE, 0, 1, 0); } mqtt_message_t* ICACHE_FLASH_ATTR mqtt_msg_unsubscribe(mqtt_connection_t* connection, const char* topic, uint16_t* message_id) { init_message(connection); if(topic == NULL || topic[0] == '\0') return fail_message(connection); if((*message_id = append_message_id(connection, 0)) == 0) return fail_message(connection); if(append_string(connection, topic, strlen(topic)) < 0) return fail_message(connection); return fini_message(connection, MQTT_MSG_TYPE_SUBSCRIBE, 0, 1, 0); } mqtt_message_t* ICACHE_FLASH_ATTR mqtt_msg_pingreq(mqtt_connection_t* connection) { init_message(connection); return fini_message(connection, MQTT_MSG_TYPE_PINGREQ, 0, 0, 0); } mqtt_message_t* ICACHE_FLASH_ATTR mqtt_msg_pingresp(mqtt_connection_t* connection) { init_message(connection); return fini_message(connection, MQTT_MSG_TYPE_PINGRESP, 0, 0, 0); } mqtt_message_t* ICACHE_FLASH_ATTR mqtt_msg_disconnect(mqtt_connection_t* connection) { init_message(connection); return fini_message(connection, MQTT_MSG_TYPE_DISCONNECT, 0, 0, 0); } ================================================ FILE: app/mqtt/mqtt_msg.h ================================================ /* * File: mqtt_msg.h * Author: Minh Tuan * * Created on July 12, 2014, 1:05 PM */ #ifndef MQTT_MSG_H #define MQTT_MSG_H #include "c_types.h" #ifdef __cplusplus extern "C" { #endif /* * Copyright (c) 2014, Stephen Robinson * 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 copyright holder 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. * */ /* 7 6 5 4 3 2 1 0*/ /*| --- Message Type---- | DUP Flag | QoS Level | Retain | /* Remaining Length */ #define PROTOCOL_NAMEv31 /*MQTT version 3.1 compatible with Mosquitto v0.15*/ enum mqtt_message_type { MQTT_MSG_TYPE_CONNECT = 1, MQTT_MSG_TYPE_CONNACK = 2, MQTT_MSG_TYPE_PUBLISH = 3, MQTT_MSG_TYPE_PUBACK = 4, MQTT_MSG_TYPE_PUBREC = 5, MQTT_MSG_TYPE_PUBREL = 6, MQTT_MSG_TYPE_PUBCOMP = 7, MQTT_MSG_TYPE_SUBSCRIBE = 8, MQTT_MSG_TYPE_SUBACK = 9, MQTT_MSG_TYPE_UNSUBSCRIBE = 10, MQTT_MSG_TYPE_UNSUBACK = 11, MQTT_MSG_TYPE_PINGREQ = 12, MQTT_MSG_TYPE_PINGRESP = 13, MQTT_MSG_TYPE_DISCONNECT = 14 }; typedef struct mqtt_message { uint8_t* data; uint16_t length; } mqtt_message_t; typedef struct mqtt_connection { mqtt_message_t message; uint16_t message_id; uint8_t* buffer; uint16_t buffer_length; } mqtt_connection_t; typedef struct mqtt_connect_info { char* client_id; char* username; char* password; char* will_topic; char* will_message; int keepalive; int will_qos; int will_retain; int clean_session; } mqtt_connect_info_t; static inline int ICACHE_FLASH_ATTR mqtt_get_type(uint8_t* buffer) { return (buffer[0] & 0xf0) >> 4; } static inline int ICACHE_FLASH_ATTR mqtt_get_dup(uint8_t* buffer) { return (buffer[0] & 0x08) >> 3; } static inline int ICACHE_FLASH_ATTR mqtt_get_qos(uint8_t* buffer) { return (buffer[0] & 0x06) >> 1; } static inline int ICACHE_FLASH_ATTR mqtt_get_retain(uint8_t* buffer) { return (buffer[0] & 0x01); } void ICACHE_FLASH_ATTR mqtt_msg_init(mqtt_connection_t* connection, uint8_t* buffer, uint16_t buffer_length); int ICACHE_FLASH_ATTR mqtt_get_total_length(uint8_t* buffer, uint16_t length); const char* ICACHE_FLASH_ATTR mqtt_get_publish_topic(uint8_t* buffer, uint16_t* length); const char* ICACHE_FLASH_ATTR mqtt_get_publish_data(uint8_t* buffer, uint16_t* length); uint16_t ICACHE_FLASH_ATTR mqtt_get_id(uint8_t* buffer, uint16_t length); mqtt_message_t* ICACHE_FLASH_ATTR mqtt_msg_connect(mqtt_connection_t* connection, mqtt_connect_info_t* info); mqtt_message_t* ICACHE_FLASH_ATTR mqtt_msg_publish(mqtt_connection_t* connection, const char* topic, const char* data, int data_length, int qos, int retain, uint16_t* message_id); mqtt_message_t* ICACHE_FLASH_ATTR mqtt_msg_puback(mqtt_connection_t* connection, uint16_t message_id); mqtt_message_t* ICACHE_FLASH_ATTR mqtt_msg_pubrec(mqtt_connection_t* connection, uint16_t message_id); mqtt_message_t* ICACHE_FLASH_ATTR mqtt_msg_pubrel(mqtt_connection_t* connection, uint16_t message_id); mqtt_message_t* ICACHE_FLASH_ATTR mqtt_msg_pubcomp(mqtt_connection_t* connection, uint16_t message_id); mqtt_message_t* ICACHE_FLASH_ATTR mqtt_msg_subscribe(mqtt_connection_t* connection, const char* topic, int qos, uint16_t* message_id); mqtt_message_t* ICACHE_FLASH_ATTR mqtt_msg_unsubscribe(mqtt_connection_t* connection, const char* topic, uint16_t* message_id); mqtt_message_t* ICACHE_FLASH_ATTR mqtt_msg_pingreq(mqtt_connection_t* connection); mqtt_message_t* ICACHE_FLASH_ATTR mqtt_msg_pingresp(mqtt_connection_t* connection); mqtt_message_t* ICACHE_FLASH_ATTR mqtt_msg_disconnect(mqtt_connection_t* connection); #ifdef __cplusplus } #endif #endif /* MQTT_MSG_H */ ================================================ FILE: app/mqtt/proto.c ================================================ #include "proto.h" #include "ringbuf.h" I8 ICACHE_FLASH_ATTR PROTO_Init(PROTO_PARSER *parser, PROTO_PARSE_CALLBACK *completeCallback, U8 *buf, U16 bufSize) { parser->buf = buf; parser->bufSize = bufSize; parser->dataLen = 0; parser->callback = completeCallback; parser->isEsc = 0; return 0; } I8 ICACHE_FLASH_ATTR PROTO_ParseByte(PROTO_PARSER *parser, U8 value) { switch(value){ case 0x7D: parser->isEsc = 1; break; case 0x7E: parser->dataLen = 0; parser->isEsc = 0; parser->isBegin = 1; break; case 0x7F: if (parser->callback != NULL) parser->callback(); parser->isBegin = 0; return 0; break; default: if(parser->isBegin == 0) break; if(parser->isEsc){ value ^= 0x20; parser->isEsc = 0; } if(parser->dataLen < parser->bufSize) parser->buf[parser->dataLen++] = value; break; } return -1; } I8 ICACHE_FLASH_ATTR PROTO_Parse(PROTO_PARSER *parser, U8 *buf, U16 len) { while(len--) PROTO_ParseByte(parser, *buf++); return 0; } I16 ICACHE_FLASH_ATTR PROTO_ParseRb(RINGBUF* rb, U8 *bufOut, U16* len, U16 maxBufLen) { U8 c; PROTO_PARSER proto; PROTO_Init(&proto, NULL, bufOut, maxBufLen); while(RINGBUF_Get(rb, &c) == 0){ if(PROTO_ParseByte(&proto, c) == 0){ *len = proto.dataLen; return 0; } } return -1; } I16 ICACHE_FLASH_ATTR PROTO_Add(U8 *buf, const U8 *packet, I16 bufSize) { U16 i = 2; U16 len = *(U16*) packet; if (bufSize < 1) return -1; *buf++ = 0x7E; bufSize--; while (len--) { switch (*packet) { case 0x7D: case 0x7E: case 0x7F: if (bufSize < 2) return -1; *buf++ = 0x7D; *buf++ = *packet++ ^ 0x20; i += 2; bufSize -= 2; break; default: if (bufSize < 1) return -1; *buf++ = *packet++; i++; bufSize--; break; } } if (bufSize < 1) return -1; *buf++ = 0x7F; return i; } I16 ICACHE_FLASH_ATTR PROTO_AddRb(RINGBUF *rb, const U8 *packet, I16 len) { U16 i = 2; if(RINGBUF_Put(rb, 0x7E) == -1) return -1; while (len--) { switch (*packet) { case 0x7D: case 0x7E: case 0x7F: if(RINGBUF_Put(rb, 0x7D) == -1) return -1; if(RINGBUF_Put(rb, *packet++ ^ 0x20) == -1) return -1; i += 2; break; default: if(RINGBUF_Put(rb, *packet++) == -1) return -1; i++; break; } } if(RINGBUF_Put(rb, 0x7F) == -1) return -1; return i; } ================================================ FILE: app/mqtt/proto.h ================================================ /* * File: proto.h * Author: ThuHien * * Created on November 23, 2012, 8:57 AM */ #ifndef _PROTO_H_ #define _PROTO_H_ #include #include "typedef.h" #include "ringbuf.h" typedef void(PROTO_PARSE_CALLBACK)(); typedef struct{ U8 *buf; U16 bufSize; U16 dataLen; U8 isEsc; U8 isBegin; PROTO_PARSE_CALLBACK* callback; }PROTO_PARSER; I8 ICACHE_FLASH_ATTR PROTO_Init(PROTO_PARSER *parser, PROTO_PARSE_CALLBACK *completeCallback, U8 *buf, U16 bufSize); I8 ICACHE_FLASH_ATTR PROTO_Parse(PROTO_PARSER *parser, U8 *buf, U16 len); I16 ICACHE_FLASH_ATTR PROTO_Add(U8 *buf, const U8 *packet, I16 bufSize); I16 ICACHE_FLASH_ATTR PROTO_AddRb(RINGBUF *rb, const U8 *packet, I16 len); I8 ICACHE_FLASH_ATTR PROTO_ParseByte(PROTO_PARSER *parser, U8 value); I16 ICACHE_FLASH_ATTR PROTO_ParseRb(RINGBUF *rb, U8 *bufOut, U16* len, U16 maxBufLen); #endif ================================================ FILE: app/mqtt/queue.c ================================================ /* str_queue.c * * Copyright (c) 2014-2015, Tuan PM * 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 Redis 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 "queue.h" #include "user_interface.h" #include "osapi.h" #include "os_type.h" #include "mem.h" #include "proto.h" void ICACHE_FLASH_ATTR QUEUE_Init(QUEUE *queue, int bufferSize) { queue->buf = (uint8_t*)os_zalloc(bufferSize); RINGBUF_Init(&queue->rb, queue->buf, bufferSize); } int32_t ICACHE_FLASH_ATTR QUEUE_Puts(QUEUE *queue, uint8_t* buffer, uint16_t len) { return PROTO_AddRb(&queue->rb, buffer, len); } int32_t ICACHE_FLASH_ATTR QUEUE_Gets(QUEUE *queue, uint8_t* buffer, uint16_t* len, uint16_t maxLen) { return PROTO_ParseRb(&queue->rb, buffer, len, maxLen); } BOOL ICACHE_FLASH_ATTR QUEUE_IsEmpty(QUEUE *queue) { if(queue->rb.fill_cnt<=0) return TRUE; return FALSE; } ================================================ FILE: app/mqtt/queue.h ================================================ /* str_queue.h -- * * Copyright (c) 2014-2015, Tuan PM * 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 Redis 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. */ #ifndef USER_QUEUE_H_ #define USER_QUEUE_H_ #include "os_type.h" #include "ringbuf.h" typedef struct { uint8_t *buf; RINGBUF rb; } QUEUE; void ICACHE_FLASH_ATTR QUEUE_Init(QUEUE *queue, int bufferSize); int32_t ICACHE_FLASH_ATTR QUEUE_Puts(QUEUE *queue, uint8_t* buffer, uint16_t len); int32_t ICACHE_FLASH_ATTR QUEUE_Gets(QUEUE *queue, uint8_t* buffer, uint16_t* len, uint16_t maxLen); BOOL ICACHE_FLASH_ATTR QUEUE_IsEmpty(QUEUE *queue); #endif /* USER_QUEUE_H_ */ ================================================ FILE: app/mqtt/ringbuf.c ================================================ /** * \file * Ring Buffer library */ #include "ringbuf.h" /** * \brief init a RINGBUF object * \param r pointer to a RINGBUF object * \param buf pointer to a byte array * \param size size of buf * \return 0 if successfull, otherwise failed */ I16 ICACHE_FLASH_ATTR RINGBUF_Init(RINGBUF *r, U8* buf, I32 size) { if(r == NULL || buf == NULL || size < 2) return -1; r->p_o = r->p_r = r->p_w = buf; r->fill_cnt = 0; r->size = size; return 0; } /** * \brief put a character into ring buffer * \param r pointer to a ringbuf object * \param c character to be put * \return 0 if successfull, otherwise failed */ I16 ICACHE_FLASH_ATTR RINGBUF_Put(RINGBUF *r, U8 c) { if(r->fill_cnt>=r->size)return -1; // ring buffer is full, this should be atomic operation r->fill_cnt++; // increase filled slots count, this should be atomic operation *r->p_w++ = c; // put character into buffer if(r->p_w >= r->p_o + r->size) // rollback if write pointer go pass r->p_w = r->p_o; // the physical boundary return 0; } /** * \brief get a character from ring buffer * \param r pointer to a ringbuf object * \param c read character * \return 0 if successfull, otherwise failed */ I16 ICACHE_FLASH_ATTR RINGBUF_Get(RINGBUF *r, U8* c) { if(r->fill_cnt<=0)return -1; // ring buffer is empty, this should be atomic operation r->fill_cnt--; // decrease filled slots count *c = *r->p_r++; // get the character out if(r->p_r >= r->p_o + r->size) // rollback if write pointer go pass r->p_r = r->p_o; // the physical boundary return 0; } ================================================ FILE: app/mqtt/ringbuf.h ================================================ #ifndef _RING_BUF_H_ #define _RING_BUF_H_ #include #include #include "typedef.h" typedef struct{ U8* p_o; /**< Original pointer */ U8* volatile p_r; /**< Read pointer */ U8* volatile p_w; /**< Write pointer */ volatile I32 fill_cnt; /**< Number of filled slots */ I32 size; /**< Buffer size */ }RINGBUF; I16 ICACHE_FLASH_ATTR RINGBUF_Init(RINGBUF *r, U8* buf, I32 size); I16 ICACHE_FLASH_ATTR RINGBUF_Put(RINGBUF *r, U8 c); I16 ICACHE_FLASH_ATTR RINGBUF_Get(RINGBUF *r, U8* c); #endif ================================================ FILE: app/mqtt/typedef.h ================================================ /** * \file * Standard Types definition */ #ifndef _TYPE_DEF_H_ #define _TYPE_DEF_H_ typedef char I8; typedef unsigned char U8; typedef short I16; typedef unsigned short U16; typedef long I32; typedef unsigned long U32; typedef unsigned long long U64; #endif ================================================ FILE: app/mqtt/utils.c ================================================ /* * Copyright (c) 2014, Tuan PM * Email: tuanpm@live.com * * 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 copyright holder 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. * */ #include #include #include #include #include #include "utils.h" uint8_t ICACHE_FLASH_ATTR UTILS_IsIPV4 (int8_t *str) { uint8_t segs = 0; /* Segment count. */ uint8_t chcnt = 0; /* Character count within segment. */ uint8_t accum = 0; /* Accumulator for segment. */ /* Catch NULL pointer. */ if (str == 0) return 0; /* Process every character in string. */ while (*str != '\0') { /* Segment changeover. */ if (*str == '.') { /* Must have some digits in segment. */ if (chcnt == 0) return 0; /* Limit number of segments. */ if (++segs == 4) return 0; /* Reset segment values and restart loop. */ chcnt = accum = 0; str++; continue; } /* Check numeric. */ if ((*str < '0') || (*str > '9')) return 0; /* Accumulate and check segment. */ if ((accum = accum * 10 + *str - '0') > 255) return 0; /* Advance other segment specific stuff and continue loop. */ chcnt++; str++; } /* Check enough segments and enough characters in last segment. */ if (segs != 3) return 0; if (chcnt == 0) return 0; /* Address okay. */ return 1; } uint8_t ICACHE_FLASH_ATTR UTILS_StrToIP(const int8_t* str, void *ip) { /* The count of the number of bytes processed. */ int i; /* A pointer to the next digit to process. */ const char * start; start = str; for (i = 0; i < 4; i++) { /* The digit being processed. */ char c; /* The value of this byte. */ int n = 0; while (1) { c = * start; start++; if (c >= '0' && c <= '9') { n *= 10; n += c - '0'; } /* We insist on stopping at "." if we are still parsing the first, second, or third numbers. If we have reached the end of the numbers, we will allow any character. */ else if ((i < 3 && c == '.') || i == 3) { break; } else { return 0; } } if (n >= 256) { return 0; } ((uint8_t*)ip)[i] = n; } return 1; } uint32_t ICACHE_FLASH_ATTR UTILS_Atoh(const int8_t *s) { uint32_t value = 0, digit; int8_t c; while((c = *s++)){ if('0' <= c && c <= '9') digit = c - '0'; else if('A' <= c && c <= 'F') digit = c - 'A' + 10; else if('a' <= c && c<= 'f') digit = c - 'a' + 10; else break; value = (value << 4) | digit; } return value; } ================================================ FILE: app/mqtt/utils.h ================================================ #ifndef _UTILS_H_ #define _UTILS_H_ #include "c_types.h" uint32_t ICACHE_FLASH_ATTR UTILS_Atoh(const int8_t *s); uint8_t ICACHE_FLASH_ATTR UTILS_StrToIP(const int8_t* str, void *ip); uint8_t ICACHE_FLASH_ATTR UTILS_IsIPV4 (int8_t *str); #endif ================================================ FILE: app/platform/Makefile ================================================ ############################################################# # Required variables for each makefile # Discard this section from all parent makefiles # Expected variables (with automatic defaults): # CSRCS (all "C" files in the dir) # SUBDIRS (all subdirs with a Makefile) # GEN_LIBS - list of libs to be generated () # GEN_IMAGES - list of images to be generated () # COMPONENTS_xxx - a list of libs/objs in the form # subdir/lib to be extracted and rolled up into # a generated lib/image xxx.a () # ifndef PDIR GEN_LIBS = libplatform.a endif ############################################################# # Configuration i.e. compile options etc. # Target specific stuff (defines etc.) goes in here! # Generally values applying to a tree are captured in the # makefile at its root level - these are then overridden # for a subtree within the makefile rooted therein # #DEFINES += ############################################################# # Recursion Magic - Don't touch this!! # # Each subtree potentially has an include directory # corresponding to the common APIs applicable to modules # rooted at that subtree. Accordingly, the INCLUDE PATH # of a module can only contain the include directories up # its parent path, and not its siblings # # Required for each makefile to inherit from the parent # INCLUDES := $(INCLUDES) -I $(PDIR)include INCLUDES += -I ./ INCLUDES += -I ../wofs INCLUDES += -I ../spiffs INCLUDES += -I ../libc PDIR := ../$(PDIR) sinclude $(PDIR)Makefile ================================================ FILE: app/platform/common.c ================================================ // Common code for all backends #include "platform.h" #include "common.h" #include "c_string.h" #include "c_stdio.h" #include "cpu_esp8266.h" void cmn_platform_init(void) { } // **************************************************************************** // GPIO functions int platform_gpio_exists( unsigned pin ) { return pin < NUM_GPIO; } // **************************************************************************** // CAN functions int platform_can_exists( unsigned id ) { return id < NUM_CAN; } // **************************************************************************** // SPI functions int platform_spi_exists( unsigned id ) { return id < NUM_SPI; } // **************************************************************************** // PWM functions int platform_pwm_exists( unsigned id ) { return ((id < NUM_PWM) && (id > 0)); } // **************************************************************************** // ADC functions int platform_adc_exists( unsigned id ) { return id < NUM_ADC; } // **************************************************************************** // UART functions int platform_uart_exists( unsigned id ) { return id < NUM_UART; } // **************************************************************************** // OneWire functions int platform_ow_exists( unsigned id ) { return ((id < NUM_OW) && (id > 0)); } // **************************************************************************** // Timer functions int platform_tmr_exists( unsigned id ) { return id < NUM_TMR; } // I2C support int platform_i2c_exists( unsigned id ) { #ifndef NUM_I2C return 0; #else return id < NUM_I2C; #endif } // **************************************************************************** // Internal flash support functions // This symbol must be exported by the linker command file and must reflect the // TOTAL size of flash used by the eLua image (not only the code and constants, // but also .data and whatever else ends up in the eLua image). FS will start // at the next usable (aligned to a flash sector boundary) address after // flash_used_size. // extern char flash_used_size[]; extern char _flash_used_end[]; // Helper function: find the flash sector in which an address resides // Return the sector number, as well as the start and end address of the sector static uint32_t flashh_find_sector( uint32_t address, uint32_t *pstart, uint32_t *pend ) { address -= INTERNAL_FLASH_START_ADDRESS; #ifdef INTERNAL_FLASH_SECTOR_SIZE // All the sectors in the flash have the same size, so just align the address uint32_t sect_id = address / INTERNAL_FLASH_SECTOR_SIZE; if( pstart ) *pstart = sect_id * INTERNAL_FLASH_SECTOR_SIZE + INTERNAL_FLASH_START_ADDRESS; if( pend ) *pend = ( sect_id + 1 ) * INTERNAL_FLASH_SECTOR_SIZE + INTERNAL_FLASH_START_ADDRESS - 1; return sect_id; #else // #ifdef INTERNAL_FLASH_SECTOR_SIZE // The flash has blocks of different size // Their size is decribed in the INTERNAL_FLASH_SECTOR_ARRAY macro const uint32_t flash_sect_size[] = INTERNAL_FLASH_SECTOR_ARRAY; uint32_t total = 0, i = 0; while( ( total <= address ) && ( i < sizeof( flash_sect_size ) / sizeof( uint32_t ) ) ) total += flash_sect_size[ i ++ ]; if( pstart ) *pstart = ( total - flash_sect_size[ i - 1 ] ) + INTERNAL_FLASH_START_ADDRESS; if( pend ) *pend = total + INTERNAL_FLASH_START_ADDRESS - 1; return i - 1; #endif // #ifdef INTERNAL_FLASH_SECTOR_SIZE } uint32_t platform_flash_get_sector_of_address( uint32_t addr ) { return flashh_find_sector( addr, NULL, NULL ); } uint32_t platform_flash_get_num_sectors(void) { #ifdef INTERNAL_FLASH_SECTOR_SIZE return INTERNAL_FLASH_SIZE / INTERNAL_FLASH_SECTOR_SIZE; #else // #ifdef INTERNAL_FLASH_SECTOR_SIZE const uint32_t flash_sect_size[] = INTERNAL_FLASH_SECTOR_ARRAY; return sizeof( flash_sect_size ) / sizeof( uint32_t ); #endif // #ifdef INTERNAL_FLASH_SECTOR_SIZE } uint32_t platform_flash_get_first_free_block_address( uint32_t *psect ) { // Round the total used flash size to the closest flash block address uint32_t start, end, sect; NODE_DBG("_flash_used_end:%08x", (uint32_t)_flash_used_end); if(_flash_used_end>0){ // find the used sector // sect = flashh_find_sector( ( uint32_t )flash_used_size + INTERNAL_FLASH_START_ADDRESS - 1, NULL, &end ); sect = flashh_find_sector( ( uint32_t )_flash_used_end - 1, NULL, &end ); if( psect ) *psect = sect + 1; return end + 1; }else{ sect = flashh_find_sector( INTERNAL_FLASH_START_ADDRESS, &start, NULL ); // find the first free sector if( psect ) *psect = sect; return start; } } uint32_t platform_flash_write( const void *from, uint32_t toaddr, uint32_t size ) { #ifndef INTERNAL_FLASH_WRITE_UNIT_SIZE return platform_s_flash_write( from, toaddr, size ); #else // #ifindef INTERNAL_FLASH_WRITE_UNIT_SIZE uint32_t temp, rest, ssize = size; unsigned i; char tmpdata[ INTERNAL_FLASH_WRITE_UNIT_SIZE ]; const uint8_t *pfrom = ( const uint8_t* )from; const uint32_t blksize = INTERNAL_FLASH_WRITE_UNIT_SIZE; const uint32_t blkmask = INTERNAL_FLASH_WRITE_UNIT_SIZE - 1; // Align the start if( toaddr & blkmask ) { rest = toaddr & blkmask; temp = toaddr & ~blkmask; // this is the actual aligned address // c_memcpy( tmpdata, ( const void* )temp, blksize ); platform_s_flash_read( tmpdata, temp, blksize ); for( i = rest; size && ( i < blksize ); i ++, size --, pfrom ++ ) tmpdata[ i ] = *pfrom; platform_s_flash_write( tmpdata, temp, blksize ); if( size == 0 ) return ssize; toaddr = temp + blksize; } // The start address is now a multiple of blksize // Compute how many bytes we can write as multiples of blksize rest = size & blkmask; temp = size & ~blkmask; // Program the blocks now if( temp ) { platform_s_flash_write( pfrom, toaddr, temp ); toaddr += temp; pfrom += temp; } // And the final part of a block if needed if( rest ) { // c_memcpy( tmpdata, ( const void* )toaddr, blksize ); platform_s_flash_read( tmpdata, toaddr, blksize ); for( i = 0; size && ( i < rest ); i ++, size --, pfrom ++ ) tmpdata[ i ] = *pfrom; platform_s_flash_write( tmpdata, toaddr, blksize ); } return ssize; #endif // #ifndef INTERNAL_FLASH_WRITE_UNIT_SIZE } uint32_t platform_flash_read( void *to, uint32_t fromaddr, uint32_t size ) { #ifndef INTERNAL_FLASH_READ_UNIT_SIZE return platform_s_flash_read( to, fromaddr, size ); #else // #ifindef INTERNAL_FLASH_READ_UNIT_SIZE uint32_t temp, rest, ssize = size; unsigned i; char tmpdata[ INTERNAL_FLASH_READ_UNIT_SIZE ]; uint8_t *pto = ( uint8_t* )to; const uint32_t blksize = INTERNAL_FLASH_READ_UNIT_SIZE; const uint32_t blkmask = INTERNAL_FLASH_READ_UNIT_SIZE - 1; // Align the start if( fromaddr & blkmask ) { rest = fromaddr & blkmask; temp = fromaddr & ~blkmask; // this is the actual aligned address platform_s_flash_read( tmpdata, temp, blksize ); for( i = rest; size && ( i < blksize ); i ++, size --, pto ++ ) *pto = tmpdata[ i ]; if( size == 0 ) return ssize; fromaddr = temp + blksize; } // The start address is now a multiple of blksize // Compute how many bytes we can read as multiples of blksize rest = size & blkmask; temp = size & ~blkmask; // Program the blocks now if( temp ) { platform_s_flash_read( pto, fromaddr, temp ); fromaddr += temp; pto += temp; } // And the final part of a block if needed if( rest ) { platform_s_flash_read( tmpdata, fromaddr, blksize ); for( i = 0; size && ( i < rest ); i ++, size --, pto ++ ) *pto = tmpdata[ i ]; } return ssize; #endif // #ifndef INTERNAL_FLASH_READ_UNIT_SIZE } ================================================ FILE: app/platform/common.h ================================================ // Common platform functions #ifndef __COMMON_H__ #define __COMMON_H__ #include "platform.h" // Functions exported by the common platform layer void cmn_platform_init(void); // Timer-specific functions // System timer generic implemenation // Filesystem-related functions #endif // #ifndef __COMMON_H__ ================================================ FILE: app/platform/config.c ================================================ #include "platform.h" #include "c_stdio.h" #include "c_string.h" #include "c_stdlib.h" #include "gpio.h" #include "user_interface.h" #include "user_config.h" #include "driver/uart.h" #include "config.h" static config_data temp_data; uint8_t local_up_to_date=0; uint8_t init_ok = 0 ; void config_save(config_data * data){ NODE_DBG("Config save"); platform_flash_erase_sector(CONFIG_SECTOR); if(data!=NULL){ platform_flash_write((const void *)data,CONFIG_ADDRESS,sizeof(config_data)); os_memcpy(temp_data,data,sizeof(config_data)); local_up_to_date=1; } else{ platform_flash_write((const void *)&temp_data,CONFIG_ADDRESS,sizeof(config_data)); } } static config_data * config_read_s(){ platform_s_flash_read(&temp_data,CONFIG_ADDRESS,sizeof(config_data)); local_up_to_date=1; return &temp_data; } config_data * config_read(){ if(!init_ok){ config_init(); init_ok=1; } if(!local_up_to_date) config_read_s(); return &temp_data; } void config_init(){ config_data * config = config_read_s(); NODE_DBG("Config init"); NODE_DBG("Config Magic =%08x",config->magic); if(config->magic == CONFIG_MAGIC) return; NODE_DBG("Config writing 0s"); os_memset(config,0,sizeof(config_data)); config->magic = CONFIG_MAGIC; config_save(config); } ================================================ FILE: app/platform/config.h ================================================ #ifndef __CONFIG_H #define __CONFIG_H #include "cpu_esp8266.h" #include "driver/relay.h" #define CONFIG_SECTOR (FLASH_SEC_NUM - 6) //last sector #define CONFIG_ADDRESS (INTERNAL_FLASH_START_ADDRESS+CONFIG_SECTOR*SPI_FLASH_SEC_SIZE) #define CONFIG_MAGIC 0x1FAF15FB //4-ALIGN EVERYTHING !! typedef struct { uint8_t gpioPin; uint8_t state; uint8_t pad[2]; } relay; typedef struct { uint32_t magic; struct{ relay relay[RELAY_COUNT]; uint32_t init_ok; } relay_state; } config_data; void config_save(config_data * data); config_data * config_read(); void config_init(); #endif ================================================ FILE: app/platform/cpu_esp8266.h ================================================ #ifndef __CPU_ESP8266_H__ #define __CPU_ESP8266_H__ #include "os_type.h" #include "spi_flash.h" #include "pin_map.h" #include "user_config.h" #include "flash_api.h" // Number of resources (0 if not available/not implemented) #define NUM_GPIO GPIO_PIN_NUM #define NUM_SPI 2 #define NUM_UART 1 #define NUM_PWM GPIO_PIN_NUM #define NUM_ADC 1 #define NUM_CAN 0 #define NUM_I2C 1 #define NUM_OW GPIO_PIN_NUM #define NUM_TMR 7 #if defined(FLASH_512K) #define FLASH_SEC_NUM 0x80 // 4MByte: 0x400, 2MByte: 0x200, 1MByte: 0x100, 512KByte: 0x80 #elif defined(FLASH_1M) #define FLASH_SEC_NUM 0x100 #elif defined(FLASH_2M) #define FLASH_SEC_NUM 0x200 #elif defined(FLASH_4M) #define FLASH_SEC_NUM 0x400 #elif defined(FLASH_AUTOSIZE) #define FLASH_SEC_NUM (flash_get_sec_num()) #else #define FLASH_SEC_NUM 0x80 #endif #define SYS_PARAM_SEC_NUM 4 #define SYS_PARAM_SEC_START (FLASH_SEC_NUM - SYS_PARAM_SEC_NUM) // #define WOFS_SEC_START 0x80 // #define WOFS_SEC_START 0x60 // #define WOFS_SEC_END (SYS_PARAM_SEC_START) // #define WOFS_SEC_NUM (WOFS_SEC_END - WOFS_SEC_START) // #define WOFS_SEC_NUM 0xc #define INTERNAL_FLASH_SECTOR_SIZE SPI_FLASH_SEC_SIZE // #define INTERNAL_FLASH_SECTOR_ARRAY { 0x4000, 0x4000, 0x4000, 0x4000, 0x10000, 0x20000, 0x20000, 0x20000, 0x20000, 0x20000 } #define INTERNAL_FLASH_WRITE_UNIT_SIZE 4 #define INTERNAL_FLASH_READ_UNIT_SIZE 4 #define INTERNAL_FLASH_SIZE ( (SYS_PARAM_SEC_START) * INTERNAL_FLASH_SECTOR_SIZE ) #define INTERNAL_FLASH_START_ADDRESS 0x40200000 // SpiFlashOpResult spi_flash_erase_sector(uint16 sec); // SpiFlashOpResult spi_flash_write(uint32 des_addr, uint32 *src_addr, uint32 size); // SpiFlashOpResult spi_flash_read(uint32 src_addr, uint32 *des_addr, uint32 size); #define flash_write spi_flash_write #define flash_erase spi_flash_erase_sector #define flash_read spi_flash_read #endif // #ifndef __CPU_ESP8266_H__ ================================================ FILE: app/platform/flash_api.c ================================================ /****************************************************************************** * Flash api for NodeMCU * NodeMCU Team * 2014-12-31 *******************************************************************************/ #include "user_config.h" #include "flash_api.h" #include "spi_flash.h" #include "c_stdio.h" static volatile const uint8_t flash_init_data[128] ICACHE_STORE_ATTR ICACHE_RODATA_ATTR = { 0x05, 0x00, 0x04, 0x02, 0x05, 0x05, 0x05, 0x02, 0x05, 0x00, 0x04, 0x05, 0x05, 0x04, 0x05, 0x05, 0x04, 0xFE, 0xFD, 0xFF, 0xF0, 0xF0, 0xF0, 0xE0, 0xE0, 0xE0, 0xE1, 0x0A, 0xFF, 0xFF, 0xF8, 0x00, 0xF8, 0xF8, 0x52, 0x4E, 0x4A, 0x44, 0x40, 0x38, 0x00, 0x00, 0x01, 0x01, 0x02, 0x03, 0x04, 0x05, 0x01, 0x00, 0x00, 0x00, 0x00, 0x00, 0x02, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xE1, 0x0A, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x01, 0x93, 0x43, 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, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00 }; SPIFlashInfo flash_get_info(void) { volatile SPIFlashInfo spi_flash_info ICACHE_STORE_ATTR; spi_flash_info = *((SPIFlashInfo *)(FLASH_MAP_START_ADDRESS)); return spi_flash_info; } uint8_t flash_get_size(void) { return flash_get_info().size; } uint32_t flash_get_size_byte(void) { uint32_t flash_size = 0; switch (flash_get_info().size) { case SIZE_2MBIT: // 2Mbit, 256kByte flash_size = 256 * 1024; break; case SIZE_4MBIT: // 4Mbit, 512kByte flash_size = 512 * 1024; break; case SIZE_8MBIT: // 8Mbit, 1MByte flash_size = 1 * 1024 * 1024; break; case SIZE_16MBIT: // 16Mbit, 2MByte flash_size = 2 * 1024 * 1024; break; case SIZE_32MBIT: // 32Mbit, 4MByte flash_size = 4 * 1024 * 1024; break; default: // Unknown flash size, fall back mode. flash_size = 512 * 1024; break; } return flash_size; } bool flash_set_size(uint8_t size) { // Dangerous, here are dinosaur infested!!!!! // Reboot required!!! // If you don't know what you're doing, your nodemcu may turn into stone ... uint8_t data[SPI_FLASH_SEC_SIZE] ICACHE_STORE_ATTR; spi_flash_read(0, (uint32 *)data, sizeof(data)); SPIFlashInfo *p_spi_flash_info = (SPIFlashInfo *)(data); p_spi_flash_info->size = size; spi_flash_erase_sector(0); spi_flash_write(0, (uint32 *)data, sizeof(data)); //p_spi_flash_info = flash_get_info(); //p_spi_flash_info->size = size; return true; } bool flash_set_size_byte(uint32_t size) { // Dangerous, here are dinosaur infested!!!!! // Reboot required!!! // If you don't know what you're doing, your nodemcu may turn into stone ... bool result = true; uint32_t flash_size = 0; switch (size) { case 256 * 1024: // 2Mbit, 256kByte flash_size = SIZE_2MBIT; flash_set_size(flash_size); break; case 512 * 1024: // 4Mbit, 512kByte flash_size = SIZE_4MBIT; flash_set_size(flash_size); break; case 1 * 1024 * 1024: // 8Mbit, 1MByte flash_size = SIZE_8MBIT; flash_set_size(flash_size); break; case 2 * 1024 * 1024: // 16Mbit, 2MByte flash_size = SIZE_16MBIT; flash_set_size(flash_size); break; case 4 * 1024 * 1024: // 32Mbit, 4MByte flash_size = SIZE_32MBIT; flash_set_size(flash_size); break; default: // Unknown flash size. result = false; break; } return result; } uint16_t flash_get_sec_num(void) { return flash_get_size_byte() / SPI_FLASH_SEC_SIZE; } uint8_t flash_get_mode(void) { SPIFlashInfo spi_flash_info = flash_get_info(); switch (spi_flash_info.mode) { // Reserved for future use case MODE_QIO: break; case MODE_QOUT: break; case MODE_DIO: break; case MODE_DOUT: break; } return spi_flash_info.mode; } uint32_t flash_get_speed(void) { uint32_t speed = 0; SPIFlashInfo spi_flash_info = flash_get_info(); switch (spi_flash_info.speed) { case SPEED_40MHZ: // 40MHz speed = 40000000; break; case SPEED_26MHZ: //26.7MHz speed = 26700000; break; case SPEED_20MHZ: // 20MHz speed = 20000000; break; case SPEED_80MHZ: //80MHz speed = 80000000; break; } return speed; } bool flash_init_data_written(void) { // FLASH SEC - 4 uint32_t data[2] ICACHE_STORE_ATTR; if (SPI_FLASH_RESULT_OK == spi_flash_read((flash_get_sec_num() - 4) * SPI_FLASH_SEC_SIZE, (uint32 *)data, sizeof(data))) { if (data[0] == 0xFFFFFFFF && data[1] == 0xFFFFFFFF) { return false; } } return true; } bool flash_init_data_default(void) { // FLASH SEC - 4 // Dangerous, here are dinosaur infested!!!!! // Reboot required!!! // It will init system data to default! bool result = false; if (SPI_FLASH_RESULT_OK == spi_flash_erase_sector((flash_get_sec_num() - 4))) { if (SPI_FLASH_RESULT_OK == spi_flash_write((flash_get_sec_num() - 4) * SPI_FLASH_SEC_SIZE, (uint32 *)flash_init_data, 128)) { result = true; } } return result; } bool flash_init_data_blank(void) { // FLASH SEC - 2 // Dangerous, here are dinosaur infested!!!!! // Reboot required!!! // It will init system config to blank! bool result = false; if ((SPI_FLASH_RESULT_OK == spi_flash_erase_sector((flash_get_sec_num() - 2))) && (SPI_FLASH_RESULT_OK == spi_flash_erase_sector((flash_get_sec_num() - 1)))) { result = true; } return result ; } bool flash_self_destruct(void) { // Dangerous, Erase your flash. Good bye! SPIEraseChip(); return true; } uint8_t byte_of_aligned_array(const uint8_t* aligned_array, uint32_t index) { if( (((uint32_t)aligned_array)%4) != 0 ){ //NODE_DBG("aligned_array is not 4-byte aligned."); return 0; } uint32_t v = ((uint32_t *)aligned_array)[ index/4 ]; uint8_t *p = (uint8_t *) (&v); return p[ (index%4) ]; } ================================================ FILE: app/platform/flash_api.h ================================================ #ifndef __FLASH_API_H__ #define __FLASH_API_H__ #include "ets_sys.h" #include "user_config.h" #include "cpu_esp8266.h" #define FLASH_MAP_START_ADDRESS (INTERNAL_FLASH_START_ADDRESS) /****************************************************************************** * ROM Function definition * Note: It is unsafe to use ROM function, but it may efficient. * SPIEraseSector * unknown SPIEraseSector(uint16 sec); * The 1st parameter is flash sector number. * SPIRead (Unsafe) * unknown SPIRead(uint32_t src_addr, uint32_t *des_addr, uint32_t size); * The 1st parameter is source addresses. * The 2nd parameter is destination addresses. * The 3rd parameter is size. * Note: Sometimes it have no effect, may be need a delay or other option(lock or unlock, etc.) with known reason. * SPIWrite (Unsafe) * unknown SPIWrite(uint32_t des_addr, uint32_t *src_addr, uint32_t size); * The 1st parameter is destination addresses. * The 2nd parameter is source addresses. * The 3rd parameter is size. * Note: Sometimes it have no effect, may be need a delay or other option(lock or unlock, etc.) with known reason. *******************************************************************************/ typedef struct { uint8_t unknown0; uint8_t unknown1; enum { MODE_QIO = 0, MODE_QOUT = 1, MODE_DIO = 2, MODE_DOUT = 15, } mode : 8; enum { SPEED_40MHZ = 0, SPEED_26MHZ = 1, SPEED_20MHZ = 2, SPEED_80MHZ = 15, } speed : 4; enum { SIZE_4MBIT = 0, SIZE_2MBIT = 1, SIZE_8MBIT = 2, SIZE_16MBIT = 3, SIZE_32MBIT = 4, } size : 4; } ICACHE_STORE_TYPEDEF_ATTR SPIFlashInfo; SPIFlashInfo flash_get_info(void); uint8_t flash_get_size(void); uint32_t flash_get_size_byte(void); bool flash_set_size(uint8_t); bool flash_set_size_byte(uint32_t); uint16_t flash_get_sec_num(void); uint8_t flash_get_mode(void); uint32_t flash_get_speed(void); bool flash_init_data_written(void); bool flash_init_data_default(void); bool flash_init_data_blank(void); bool flash_self_destruct(void); uint8_t byte_of_aligned_array(const uint8_t* aligned_array, uint32_t index); #endif // __FLASH_API_H__ ================================================ FILE: app/platform/flash_fs.c ================================================ #include "flash_fs.h" #include "c_string.h" #if defined( BUILD_WOFS ) #include "romfs.h" #elif defined( BUILD_SPIFFS ) #include "spiffs.h" #endif int fs_mode2flag(const char *mode){ if(c_strlen(mode)==1){ if(c_strcmp(mode,"w")==0) return FS_WRONLY|FS_CREAT|FS_TRUNC; else if(c_strcmp(mode, "r")==0) return FS_RDONLY; else if(c_strcmp(mode, "a")==0) return FS_WRONLY|FS_CREAT|FS_APPEND; else return FS_RDONLY; } else if (c_strlen(mode)==2){ if(c_strcmp(mode,"r+")==0) return FS_RDWR; else if(c_strcmp(mode, "w+")==0) return FS_RDWR|FS_CREAT|FS_TRUNC; else if(c_strcmp(mode, "a+")==0) return FS_RDWR|FS_CREAT|FS_APPEND; else return FS_RDONLY; } else { return FS_RDONLY; } } ================================================ FILE: app/platform/flash_fs.h ================================================ #ifndef __FLASH_FS_H__ #define __FLASH_FS_H__ #include "user_config.h" #if defined( BUILD_SPIFFS ) #include "spiffs.h" #define FS_OPEN_OK 1 #define FS_RDONLY SPIFFS_RDONLY #define FS_WRONLY SPIFFS_WRONLY #define FS_RDWR SPIFFS_RDWR #define FS_APPEND SPIFFS_APPEND #define FS_TRUNC SPIFFS_TRUNC #define FS_CREAT SPIFFS_CREAT #define FS_EXCL SPIFFS_EXCL #define FS_SEEK_SET SPIFFS_SEEK_SET #define FS_SEEK_CUR SPIFFS_SEEK_CUR #define FS_SEEK_END SPIFFS_SEEK_END #define fs_open myspiffs_open #define fs_close myspiffs_close #define fs_write myspiffs_write #define fs_read myspiffs_read #define fs_seek myspiffs_lseek #define fs_eof myspiffs_eof #define fs_getc myspiffs_getc #define fs_ungetc myspiffs_ungetc #define fs_flush myspiffs_flush #define fs_error myspiffs_error #define fs_clearerr myspiffs_clearerr #define fs_tell myspiffs_tell #define fs_format myspiffs_format #define fs_check myspiffs_check #define FS_NAME_MAX_LENGTH SPIFFS_OBJ_NAME_LEN #endif int fs_mode2flag(const char *mode); #endif // #ifndef __FLASH_FS_H__ ================================================ FILE: app/platform/pin_map.c ================================================ #include "pin_map.h" #include "eagle_soc.h" #if 0 uint32_t pin_mux[GPIO_PIN_NUM] = {PERIPHS_IO_MUX_MTDI_U, PERIPHS_IO_MUX_MTCK_U, PERIPHS_IO_MUX_MTMS_U, PERIPHS_IO_MUX_MTDO_U, PERIPHS_IO_MUX_U0RXD_U, PERIPHS_IO_MUX_U0TXD_U, PERIPHS_IO_MUX_SD_DATA2_U, PERIPHS_IO_MUX_SD_DATA3_U, PERIPHS_IO_MUX_GPIO0_U, PERIPHS_IO_MUX_GPIO2_U, PERIPHS_IO_MUX_GPIO4_U, PERIPHS_IO_MUX_GPIO5_U}; uint8_t pin_num[GPIO_PIN_NUM] = {12, 13, 14, 15, 3, 1, 9, 10, 0, 2, 4, 5}; uint8_t pin_func[GPIO_PIN_NUM] = {FUNC_GPIO12, FUNC_GPIO13, FUNC_GPIO14, FUNC_GPIO15, FUNC_GPIO3, FUNC_GPIO1, FUNC_GPIO9, FUNC_GPIO10, FUNC_GPIO0, FUNC_GPIO2, FUNC_GPIO4, FUNC_GPIO5}; #ifdef GPIO_INTERRUPT_ENABLE GPIO_INT_TYPE pin_int_type[GPIO_PIN_NUM] = { GPIO_PIN_INTR_DISABLE, GPIO_PIN_INTR_DISABLE, GPIO_PIN_INTR_DISABLE, GPIO_PIN_INTR_DISABLE, GPIO_PIN_INTR_DISABLE, GPIO_PIN_INTR_DISABLE, GPIO_PIN_INTR_DISABLE, GPIO_PIN_INTR_DISABLE, GPIO_PIN_INTR_DISABLE, GPIO_PIN_INTR_DISABLE, GPIO_PIN_INTR_DISABLE, GPIO_PIN_INTR_DISABLE}; #endif #else uint32_t pin_mux[GPIO_PIN_NUM] = {PAD_XPD_DCDC_CONF, PERIPHS_IO_MUX_GPIO5_U, PERIPHS_IO_MUX_GPIO4_U, PERIPHS_IO_MUX_GPIO0_U, PERIPHS_IO_MUX_GPIO2_U, PERIPHS_IO_MUX_MTMS_U, PERIPHS_IO_MUX_MTDI_U, PERIPHS_IO_MUX_MTCK_U, PERIPHS_IO_MUX_MTDO_U, PERIPHS_IO_MUX_U0RXD_U, PERIPHS_IO_MUX_U0TXD_U, PERIPHS_IO_MUX_SD_DATA2_U, PERIPHS_IO_MUX_SD_DATA3_U }; uint8_t pin_num[GPIO_PIN_NUM] = {16, 5, 4, 0, 2, 14, 12, 13, 15, 3, 1, 9, 10}; uint8_t pin_func[GPIO_PIN_NUM] = {0, FUNC_GPIO5, FUNC_GPIO4, FUNC_GPIO0, FUNC_GPIO2, FUNC_GPIO14, FUNC_GPIO12, FUNC_GPIO13, FUNC_GPIO15, FUNC_GPIO3, FUNC_GPIO1, FUNC_GPIO9, FUNC_GPIO10}; #ifdef GPIO_INTERRUPT_ENABLE GPIO_INT_TYPE pin_int_type[GPIO_PIN_NUM] = { GPIO_PIN_INTR_DISABLE, GPIO_PIN_INTR_DISABLE, GPIO_PIN_INTR_DISABLE, GPIO_PIN_INTR_DISABLE, GPIO_PIN_INTR_DISABLE, GPIO_PIN_INTR_DISABLE, GPIO_PIN_INTR_DISABLE, GPIO_PIN_INTR_DISABLE, GPIO_PIN_INTR_DISABLE, GPIO_PIN_INTR_DISABLE, GPIO_PIN_INTR_DISABLE, GPIO_PIN_INTR_DISABLE, GPIO_PIN_INTR_DISABLE}; #endif #endif ================================================ FILE: app/platform/pin_map.h ================================================ #ifndef __PIN_MAP_H__ #define __PIN_MAP_H__ #include "c_types.h" #include "user_config.h" #include "gpio.h" #define GPIO_PIN_NUM 13 extern uint8_t pin_num[GPIO_PIN_NUM]; extern uint8_t pin_func[GPIO_PIN_NUM]; extern uint32_t pin_mux[GPIO_PIN_NUM]; #ifdef GPIO_INTERRUPT_ENABLE extern GPIO_INT_TYPE pin_int_type[GPIO_PIN_NUM]; #endif #endif // #ifndef __PIN_MAP_H__ ================================================ FILE: app/platform/platform.c ================================================ // Platform-dependent functions #include "platform.h" #include "c_stdio.h" #include "c_string.h" #include "c_stdlib.h" #include "gpio.h" #include "user_interface.h" #include "driver/uart.h" // Platform specific includes static void pwms_init(); void output_redirect(const char *str){ #ifdef DEVELOP_VERSION uart_write_string(0,str); #endif } int platform_init() { // Setup PWMs pwms_init(); cmn_platform_init(); // All done return PLATFORM_OK; } // **************************************************************************** // KEY_LED functions uint8_t platform_key_led( uint8_t level){ uint8_t temp; gpio16_output_set(1); // set to high first, for reading key low level gpio16_input_conf(); temp = gpio16_input_get(); gpio16_output_conf(); gpio16_output_set(level); return temp; } // **************************************************************************** // GPIO functions int platform_gpio_mode( unsigned pin, unsigned mode, unsigned pull ) { // NODE_DBG("Function platform_gpio_mode() is called. pin_mux:%d, func:%d",pin_mux[pin],pin_func[pin]); if (pin >= NUM_GPIO) return -1; if(pin == 0){ if(mode==PLATFORM_GPIO_INPUT) gpio16_input_conf(); else gpio16_output_conf(); return 1; } platform_pwm_close(pin); // closed from pwm module, if it is used in pwm switch(pull){ case PLATFORM_GPIO_PULLUP: PIN_PULLDWN_DIS(pin_mux[pin]); PIN_PULLUP_EN(pin_mux[pin]); break; case PLATFORM_GPIO_PULLDOWN: PIN_PULLUP_DIS(pin_mux[pin]); PIN_PULLDWN_EN(pin_mux[pin]); break; case PLATFORM_GPIO_FLOAT: PIN_PULLUP_DIS(pin_mux[pin]); PIN_PULLDWN_DIS(pin_mux[pin]); break; default: PIN_PULLUP_DIS(pin_mux[pin]); PIN_PULLDWN_DIS(pin_mux[pin]); break; } switch(mode){ case PLATFORM_GPIO_INPUT: #ifdef GPIO_INTERRUPT_ENABLE //lua_gpio_unref(pin); // unref the lua ref call back. #endif GPIO_DIS_OUTPUT(pin_num[pin]); case PLATFORM_GPIO_OUTPUT: ETS_GPIO_INTR_DISABLE(); #ifdef GPIO_INTERRUPT_ENABLE pin_int_type[pin] = GPIO_PIN_INTR_DISABLE; #endif PIN_FUNC_SELECT(pin_mux[pin], pin_func[pin]); //disable interrupt gpio_pin_intr_state_set(GPIO_ID_PIN(pin_num[pin]), GPIO_PIN_INTR_DISABLE); //clear interrupt status GPIO_REG_WRITE(GPIO_STATUS_W1TC_ADDRESS, BIT(pin_num[pin])); GPIO_REG_WRITE(GPIO_PIN_ADDR(GPIO_ID_PIN(pin_num[pin])), GPIO_REG_READ(GPIO_PIN_ADDR(GPIO_ID_PIN(pin_num[pin]))) & (~ GPIO_PIN_PAD_DRIVER_SET(GPIO_PAD_DRIVER_ENABLE))); //disable open drain; ETS_GPIO_INTR_ENABLE(); break; #ifdef GPIO_INTERRUPT_ENABLE case PLATFORM_GPIO_INT: ETS_GPIO_INTR_DISABLE(); PIN_FUNC_SELECT(pin_mux[pin], pin_func[pin]); GPIO_DIS_OUTPUT(pin_num[pin]); gpio_register_set(GPIO_PIN_ADDR(GPIO_ID_PIN(pin_num[pin])), GPIO_PIN_INT_TYPE_SET(GPIO_PIN_INTR_DISABLE) | GPIO_PIN_PAD_DRIVER_SET(GPIO_PAD_DRIVER_DISABLE) | GPIO_PIN_SOURCE_SET(GPIO_AS_PIN_SOURCE)); ETS_GPIO_INTR_ENABLE(); break; #endif default: break; } return 1; } int platform_gpio_write( unsigned pin, unsigned level ) { // NODE_DBG("Function platform_gpio_write() is called. pin:%d, level:%d",GPIO_ID_PIN(pin_num[pin]),level); if (pin >= NUM_GPIO) return -1; if(pin == 0){ gpio16_output_conf(); gpio16_output_set(level); return 1; } GPIO_OUTPUT_SET(GPIO_ID_PIN(pin_num[pin]), level); } int platform_gpio_read( unsigned pin ) { // NODE_DBG("Function platform_gpio_read() is called. pin:%d",GPIO_ID_PIN(pin_num[pin])); if (pin >= NUM_GPIO) return -1; if(pin == 0){ // gpio16_input_conf(); return 0x1 & gpio16_input_get(); } // GPIO_DIS_OUTPUT(pin_num[pin]); return 0x1 & GPIO_INPUT_GET(GPIO_ID_PIN(pin_num[pin])); } #ifdef GPIO_INTERRUPT_ENABLE static void platform_gpio_intr_dispatcher( platform_gpio_intr_handler_fn_t cb){ uint8 i, level; uint32 gpio_status = GPIO_REG_READ(GPIO_STATUS_ADDRESS); for (i = 0; i < GPIO_PIN_NUM; i++) { if (pin_int_type[i] && (gpio_status & BIT(pin_num[i])) ) { //disable interrupt gpio_pin_intr_state_set(GPIO_ID_PIN(pin_num[i]), GPIO_PIN_INTR_DISABLE); //clear interrupt status GPIO_REG_WRITE(GPIO_STATUS_W1TC_ADDRESS, gpio_status & BIT(pin_num[i])); level = 0x1 & GPIO_INPUT_GET(GPIO_ID_PIN(pin_num[i])); if(cb){ cb(i, level); } gpio_pin_intr_state_set(GPIO_ID_PIN(pin_num[i]), pin_int_type[i]); } } } void platform_gpio_init( platform_gpio_intr_handler_fn_t cb ) { ETS_GPIO_INTR_ATTACH(platform_gpio_intr_dispatcher, cb); } int platform_gpio_intr_init( unsigned pin, GPIO_INT_TYPE type ) { if (pin >= NUM_GPIO) return -1; ETS_GPIO_INTR_DISABLE(); //clear interrupt status GPIO_REG_WRITE(GPIO_STATUS_W1TC_ADDRESS, BIT(pin_num[pin])); pin_int_type[pin] = type; //enable interrupt gpio_pin_intr_state_set(GPIO_ID_PIN(pin_num[pin]), type); ETS_GPIO_INTR_ENABLE(); } #endif // **************************************************************************** // UART // TODO: Support timeouts. // Send: version with and without mux void platform_uart_send( unsigned id, u8 data ) { uart_write_char(id, data); } // **************************************************************************** // PWMs static uint16_t pwms_duty[NUM_PWM] = {0}; static void pwms_init() { int i; for(i=0;i= NUM_PWM) return 0; if(!pwm_exist(pin)) return 0; return (uint32_t)pwm_get_freq(pin); } // Set the PWM clock uint32_t platform_pwm_set_clock( unsigned pin, uint32_t clock ) { // NODE_DBG("Function platform_pwm_set_clock() is called."); if( pin >= NUM_PWM) return 0; if(!pwm_exist(pin)) return 0; pwm_set_freq((uint16_t)clock, pin); pwm_start(); return (uint32_t)pwm_get_freq( pin ); } uint32_t platform_pwm_get_duty( unsigned pin ) { // NODE_DBG("Function platform_pwm_get_duty() is called."); if( pin < NUM_PWM){ if(!pwm_exist(pin)) return 0; // return NORMAL_DUTY(pwm_get_duty(pin)); return pwms_duty[pin]; } return 0; } // Set the PWM duty uint32_t platform_pwm_set_duty( unsigned pin, uint32_t duty ) { // NODE_DBG("Function platform_pwm_set_duty() is called."); if ( pin < NUM_PWM) { if(!pwm_exist(pin)) return 0; pwm_set_duty(DUTY(duty), pin); } else { return 0; } pwm_start(); pwms_duty[pin] = NORMAL_DUTY(pwm_get_duty(pin)); return pwms_duty[pin]; } uint32_t platform_pwm_setup( unsigned pin, uint32_t frequency, unsigned duty ) { uint32_t clock; if ( pin < NUM_PWM) { platform_gpio_mode(pin, PLATFORM_GPIO_OUTPUT, PLATFORM_GPIO_FLOAT); // disable gpio interrupt first if(!pwm_add(pin)) return 0; // pwm_set_duty(DUTY(duty), pin); pwm_set_duty(0, pin); pwms_duty[pin] = duty; pwm_set_freq((uint16_t)frequency, pin); } else { return 0; } clock = platform_pwm_get_clock( pin ); pwm_start(); return clock; } void platform_pwm_close( unsigned pin ) { // NODE_DBG("Function platform_pwm_stop() is called."); if ( pin < NUM_PWM) { pwm_delete(pin); pwm_start(); } } void platform_pwm_start( unsigned pin ) { // NODE_DBG("Function platform_pwm_start() is called."); if ( pin < NUM_PWM) { if(!pwm_exist(pin)) return; pwm_set_duty(DUTY(pwms_duty[pin]), pin); pwm_start(); } } void platform_pwm_stop( unsigned pin ) { // NODE_DBG("Function platform_pwm_stop() is called."); if ( pin < NUM_PWM) { if(!pwm_exist(pin)) return; pwm_set_duty(0, pin); pwm_start(); } } // ***************************************************************************** // I2C platform interface uint32_t platform_i2c_setup( unsigned id, uint8_t sda, uint8_t scl, uint32_t speed ){ if (sda >= NUM_GPIO || scl >= NUM_GPIO) return 0; // platform_pwm_close(sda); // platform_pwm_close(scl); // disable gpio interrupt first platform_gpio_mode(sda, PLATFORM_GPIO_INPUT, PLATFORM_GPIO_PULLUP); // inside this func call platform_pwm_close platform_gpio_mode(scl, PLATFORM_GPIO_INPUT, PLATFORM_GPIO_PULLUP); // disable gpio interrupt first i2c_master_gpio_init(sda, scl); return PLATFORM_I2C_SPEED_SLOW; } void platform_i2c_send_start( unsigned id ){ i2c_master_start(); } void platform_i2c_send_stop( unsigned id ){ i2c_master_stop(); } int platform_i2c_send_address( unsigned id, uint16_t address, int direction ){ // Convert enum codes to R/w bit value. // If TX == 0 and RX == 1, this test will be removed by the compiler if ( ! ( PLATFORM_I2C_DIRECTION_TRANSMITTER == 0 && PLATFORM_I2C_DIRECTION_RECEIVER == 1 ) ) { direction = ( direction == PLATFORM_I2C_DIRECTION_TRANSMITTER ) ? 0 : 1; } i2c_master_writeByte( (uint8_t) ((address << 1) | direction )); // Low-level returns nack (0=acked); we return ack (1=acked). return ! i2c_master_getAck(); } int platform_i2c_send_byte( unsigned id, uint8_t data ){ i2c_master_writeByte(data); // Low-level returns nack (0=acked); we return ack (1=acked). return ! i2c_master_getAck(); } int platform_i2c_recv_byte( unsigned id, int ack ){ uint8_t r = i2c_master_readByte(); i2c_master_setAck( !ack ); return r; } // ***************************************************************************** // SPI platform interface uint32_t platform_spi_setup( unsigned id, int mode, unsigned cpol, unsigned cpha, unsigned databits, uint32_t clock) { spi_master_init(id, cpol, cpha, databits, clock); return 1; } spi_data_type platform_spi_send_recv( unsigned id, spi_data_type data ) { spi_mast_byte_write(id, &data); return data; } // **************************************************************************** // Flash access functions uint32_t platform_s_flash_write( const void *from, uint32_t toaddr, uint32_t size ) { toaddr -= INTERNAL_FLASH_START_ADDRESS; SpiFlashOpResult r; const uint32_t blkmask = INTERNAL_FLASH_WRITE_UNIT_SIZE - 1; uint32_t *apbuf = NULL; if( ((uint32_t)from) & blkmask ){ apbuf = (uint32_t *)c_malloc(size); if(!apbuf) return 0; c_memcpy(apbuf, from, size); } WRITE_PERI_REG(0x60000914, 0x73); r = flash_write(toaddr, apbuf?(uint32 *)apbuf:(uint32 *)from, size); if(apbuf) c_free(apbuf); if(SPI_FLASH_RESULT_OK == r) return size; else{ NODE_ERR( "ERROR in flash_write: r=%d at %08X\n", ( int )r, ( unsigned )toaddr+INTERNAL_FLASH_START_ADDRESS ); return 0; } } uint32_t platform_s_flash_read( void *to, uint32_t fromaddr, uint32_t size ) { fromaddr -= INTERNAL_FLASH_START_ADDRESS; SpiFlashOpResult r; WRITE_PERI_REG(0x60000914, 0x73); r = flash_read(fromaddr, (uint32 *)to, size); if(SPI_FLASH_RESULT_OK == r) return size; else{ NODE_ERR( "ERROR in flash_read: r=%d at %08X\n", ( int )r, ( unsigned )fromaddr+INTERNAL_FLASH_START_ADDRESS ); return 0; } } int platform_flash_erase_sector( uint32_t sector_id ) { WRITE_PERI_REG(0x60000914, 0x73); return flash_erase( sector_id ) == SPI_FLASH_RESULT_OK ? PLATFORM_OK : PLATFORM_ERR; } ================================================ FILE: app/platform/platform.h ================================================ // Platform-specific functions #ifndef __PLATFORM_H__ #define __PLATFORM_H__ #include "cpu_esp8266.h" #include "c_types.h" #include "driver/pwm.h" // Error / status codes enum { PLATFORM_ERR, PLATFORM_OK, PLATFORM_UNDERFLOW = -1 }; // Platform initialization int platform_init(void); void platform_int_init(void); // **************************************************************************** // KEY_LED functions uint8_t platform_key_led( uint8_t level); // ***************************************************************************** // GPIO subsection #define PLATFORM_GPIO_FLOAT 0 #define PLATFORM_GPIO_PULLUP 1 #define PLATFORM_GPIO_PULLDOWN 2 #define PLATFORM_GPIO_INT 2 #define PLATFORM_GPIO_OUTPUT 1 #define PLATFORM_GPIO_INPUT 0 #define PLATFORM_GPIO_HIGH 1 #define PLATFORM_GPIO_LOW 0 /* GPIO interrupt handler */ typedef void (* platform_gpio_intr_handler_fn_t)( unsigned pin, unsigned level ); int platform_gpio_mode( unsigned pin, unsigned mode, unsigned pull ); int platform_gpio_write( unsigned pin, unsigned level ); int platform_gpio_read( unsigned pin ); void platform_gpio_init( platform_gpio_intr_handler_fn_t cb ); int platform_gpio_intr_init( unsigned pin, GPIO_INT_TYPE type ); // ***************************************************************************** // Timer subsection // Timer data type typedef uint32_t timer_data_type; // ***************************************************************************** // CAN subsection // Maximum length for any CAN message #define PLATFORM_CAN_MAXLEN 8 // eLua CAN ID types enum { ELUA_CAN_ID_STD = 0, ELUA_CAN_ID_EXT }; int platform_can_exists( unsigned id ); uint32_t platform_can_setup( unsigned id, uint32_t clock ); int platform_can_send( unsigned id, uint32_t canid, uint8_t idtype, uint8_t len, const uint8_t *data ); int platform_can_recv( unsigned id, uint32_t *canid, uint8_t *idtype, uint8_t *len, uint8_t *data ); // ***************************************************************************** // SPI subsection // There are 4 "virtual" SPI ports (SPI0...SPI3). #define PLATFORM_SPI_TOTAL 4 // TODO: PLATFORM_SPI_TOTAL is not used - figure out purpose, or remove? // SPI mode #define PLATFORM_SPI_MASTER 1 #define PLATFORM_SPI_SLAVE 0 // SS values #define PLATFORM_SPI_SELECT_ON 1 #define PLATFORM_SPI_SELECT_OFF 0 // SPI enable/disable #define PLATFORM_SPI_ENABLE 1 #define PLATFORM_SPI_DISABLE 0 // SPI clock phase #define PLATFORM_SPI_CPHA_LOW 0 #define PLATFORM_SPI_CPHA_HIGH 1 // SPI clock polarity #define PLATFORM_SPI_CPOL_LOW 0 #define PLATFORM_SPI_CPOL_HIGH 1 // SPI databits #define PLATFORM_SPI_DATABITS_8 8 #define PLATFORM_SPI_DATABITS_16 16 // Data types typedef uint32_t spi_data_type; // The platform SPI functions int platform_spi_exists( unsigned id ); uint32_t platform_spi_setup( unsigned id, int mode, unsigned cpol, unsigned cpha, unsigned databits, uint32_t clock); spi_data_type platform_spi_send_recv( unsigned id, spi_data_type data ); void platform_spi_select( unsigned id, int is_select ); // ***************************************************************************** // UART subsection // There are 3 "virtual" UART ports (UART0...UART2). #define PLATFORM_UART_TOTAL 3 // TODO: PLATFORM_UART_TOTAL is not used - figure out purpose, or remove? // Note: Some CPUs (e.g. LM4F/TM4C) have more than 3 hardware UARTs // Parity enum { PLATFORM_UART_PARITY_EVEN, PLATFORM_UART_PARITY_ODD, PLATFORM_UART_PARITY_NONE, PLATFORM_UART_PARITY_MARK, PLATFORM_UART_PARITY_SPACE }; // Stop bits enum { PLATFORM_UART_STOPBITS_1, PLATFORM_UART_STOPBITS_1_5, PLATFORM_UART_STOPBITS_2 }; // Flow control types (this is a bit mask, one can specify PLATFORM_UART_FLOW_RTS | PLATFORM_UART_FLOW_CTS ) #define PLATFORM_UART_FLOW_NONE 0 #define PLATFORM_UART_FLOW_RTS 1 #define PLATFORM_UART_FLOW_CTS 2 // The platform UART functions int platform_uart_exists( unsigned id ); uint32_t platform_uart_setup( unsigned id, uint32_t baud, int databits, int parity, int stopbits ); int platform_uart_set_buffer( unsigned id, unsigned size ); void platform_uart_send( unsigned id, uint8_t data ); void platform_s_uart_send( unsigned id, uint8_t data ); int platform_uart_recv( unsigned id, unsigned timer_id, timer_data_type timeout ); int platform_s_uart_recv( unsigned id, timer_data_type timeout ); int platform_uart_set_flow_control( unsigned id, int type ); int platform_s_uart_set_flow_control( unsigned id, int type ); // ***************************************************************************** // PWM subsection // There are 16 "virtual" PWM channels (PWM0...PWM15) #define PLATFORM_PWM_TOTAL 16 // TODO: PLATFORM_PWM_TOTAL is not used - figure out purpose, or remove? #define NORMAL_PWM_DEPTH PWM_DEPTH #define NORMAL_DUTY(d) (((unsigned)(d)*NORMAL_PWM_DEPTH) / PWM_DEPTH) #define DUTY(d) ((uint16_t)( ((unsigned)(d)*PWM_DEPTH) / NORMAL_PWM_DEPTH) ) // The platform PWM functions int platform_pwm_exists( unsigned id ); uint32_t platform_pwm_setup( unsigned id, uint32_t frequency, unsigned duty ); void platform_pwm_close( unsigned id ); void platform_pwm_start( unsigned id ); void platform_pwm_stop( unsigned id ); uint32_t platform_pwm_set_clock( unsigned id, uint32_t data ); uint32_t platform_pwm_get_clock( unsigned id ); uint32_t platform_pwm_set_duty( unsigned id, uint32_t data ); uint32_t platform_pwm_get_duty( unsigned id ); // ***************************************************************************** // The platform ADC functions // Functions requiring platform-specific implementation int platform_adc_update_sequence(void); int platform_adc_start_sequence(void); void platform_adc_stop( unsigned id ); uint32_t platform_adc_set_clock( unsigned id, uint32_t frequency); int platform_adc_check_timer_id( unsigned id, unsigned timer_id ); // ADC Common Functions int platform_adc_exists( unsigned id ); uint32_t platform_adc_get_maxval( unsigned id ); uint32_t platform_adc_set_smoothing( unsigned id, uint32_t length ); void platform_adc_set_blocking( unsigned id, uint32_t mode ); void platform_adc_set_freerunning( unsigned id, uint32_t mode ); uint32_t platform_adc_is_done( unsigned id ); void platform_adc_set_timer( unsigned id, uint32_t timer ); // ***************************************************************************** // I2C platform interface // I2C speed enum { PLATFORM_I2C_SPEED_SLOW = 100000, PLATFORM_I2C_SPEED_FAST = 400000 }; // I2C direction enum { PLATFORM_I2C_DIRECTION_TRANSMITTER, PLATFORM_I2C_DIRECTION_RECEIVER }; int platform_i2c_exists( unsigned id ); uint32_t platform_i2c_setup( unsigned id, uint8_t sda, uint8_t scl, uint32_t speed ); void platform_i2c_send_start( unsigned id ); void platform_i2c_send_stop( unsigned id ); int platform_i2c_send_address( unsigned id, uint16_t address, int direction ); int platform_i2c_send_byte( unsigned id, uint8_t data ); int platform_i2c_recv_byte( unsigned id, int ack ); // ***************************************************************************** // Ethernet specific functions void platform_eth_send_packet( const void* src, uint32_t size ); uint32_t platform_eth_get_packet_nb( void* buf, uint32_t maxlen ); void platform_eth_force_interrupt(void); uint32_t platform_eth_get_elapsed_time(void); // ***************************************************************************** // Internal flash erase/write functions uint32_t platform_flash_get_first_free_block_address( uint32_t *psect ); uint32_t platform_flash_get_sector_of_address( uint32_t addr ); uint32_t platform_flash_write( const void *from, uint32_t toaddr, uint32_t size ); uint32_t platform_flash_read( void *to, uint32_t fromaddr, uint32_t size ); uint32_t platform_s_flash_write( const void *from, uint32_t toaddr, uint32_t size ); uint32_t platform_s_flash_read( void *to, uint32_t fromaddr, uint32_t size ); uint32_t platform_flash_get_num_sectors(void); int platform_flash_erase_sector( uint32_t sector_id ); // ***************************************************************************** // Allocator support void* platform_get_first_free_ram( unsigned id ); void* platform_get_last_free_ram( unsigned id ); #endif ================================================ FILE: app/sensor/Makefile ================================================ ############################################################# # Required variables for each makefile # Discard this section from all parent makefiles # Expected variables (with automatic defaults): # CSRCS (all "C" files in the dir) # SUBDIRS (all subdirs with a Makefile) # GEN_LIBS - list of libs to be generated () # GEN_IMAGES - list of images to be generated () # COMPONENTS_xxx - a list of libs/objs in the form # subdir/lib to be extracted and rolled up into # a generated lib/image xxx.a () # ifndef PDIR GEN_LIBS = sensors.a endif ############################################################# # Configuration i.e. compile options etc. # Target specific stuff (defines etc.) goes in here! # Generally values applying to a tree are captured in the # makefile at its root level - these are then overridden # for a subtree within the makefile rooted therein # #DEFINES += ############################################################# # Recursion Magic - Don't touch this!! # # Each subtree potentially has an include directory # corresponding to the common APIs applicable to modules # rooted at that subtree. Accordingly, the INCLUDE PATH # of a module can only contain the include directories up # its parent path, and not its siblings # # Required for each makefile to inherit from the parent # INCLUDES := $(INCLUDES) -I $(PDIR)include INCLUDES += -I ./ INCLUDES += -I ../libc INCLUDES += -I ../platform INCLUDES += -I ../ PDIR := ../$(PDIR) sinclude $(PDIR)Makefile ================================================ FILE: app/sensor/bmp180.c ================================================ /* * ---------------------------------------------------------------------------- * "THE BEER-WARE LICENSE" (Revision 42): * Israel Lot and Jeroen Domburg * wrote this file. As long as you retain this notice you can do whatever you * want with this stuff. If we meet some day, and you think this stuff is * worth it, you can buy us a beer in return. * ---------------------------------------------------------------------------- */ #include "c_types.h" #include "c_stdio.h" #include "ets_sys.h" #include "osapi.h" #include "mem.h" #include "gpio.h" #include "platform.h" #include "user_interface.h" #include "user_config.h" #include "driver/i2c_master.h" #include "bmp180.h" #define BMP_DEBUG_ON #ifdef BMP_DEBUG_ON #define BMP_DEBUG NODE_DBG #else #define BMP_DEBUG #endif #define BMP180_SDA_PIN 3 #define BMP180_SCL_PIN 4 #define BMP180_ADDRESS 0xee #define CONVERSION_TIME 5 #define BMP180_CTRL_REG 0xf4 #define BMP180_DATA_REG 0xf6 #define BMP180_VERSION_REG 0xd1 #define BMP_CMD_MEASURE_TEMP (0x2E) // Max conversion time 4.5ms #define BMP_CMD_MEASURE_PRESSURE_0 (0x34) // Max conversion time 4.5ms (OSS = 0) //#define BMP_CMD_MEASURE_PRESSURE_1 (0x74) // Max conversion time 7.5ms (OSS = 1) //#define BMP_CMD_MEASURE_PRESSURE_2 (0xB4) // Max conversion time 13.5ms (OSS = 2) //#define BMP_CMD_MEASURE_PRESSURE_3 (0xF4) // Max conversion time 25.5ms (OSS = 3) static struct bmp_cal_data{ int16_t ac1; int16_t ac2; int16_t ac3; uint16_t ac4; uint16_t ac5; uint16_t ac6; int16_t b1; int16_t b2; int16_t mb; int16_t mc; int16_t md; }bmp_cal_data; static uint8_t bmp_init_ok=0; static uint8_t ICACHE_FLASH_ATTR bmp180_write_wait_ack(uint8_t byte,uint8_t start){ //i2c start signal if(start) i2c_master_start(); i2c_master_writeByte(byte); //address the bmp if(!i2c_master_checkAck()){ BMP_DEBUG("ack fail for byte %02x", byte); i2c_master_stop(); return 0; } return 1; } static uint8_t ICACHE_FLASH_ATTR bmp180_read_byte_ack(uint8_t ack_level){ uint8_t byte = i2c_master_readByte(); i2c_master_setAck(ack_level); i2c_master_send_ack(); return byte; } //read 16 bits static int16_t ICACHE_FLASH_ATTR bmp180_read_reg_16(uint8_t reg) { //BMP_DEBUG("bmp180_read_reg"); if(bmp180_write_wait_ack(BMP180_ADDRESS,1)) if(bmp180_write_wait_ack(reg,0)) if(bmp180_write_wait_ack(BMP180_ADDRESS+1,1)) { //read bytes uint8_t msb = bmp180_read_byte_ack(1); uint8_t lsb = bmp180_read_byte_ack(0); i2c_master_stop(); int16_t res = msb << 8; res += lsb; //BMP_DEBUG("\tvalue: %08x",res); return res; } return 0; //if we got here means there was some error } static int16_t ICACHE_FLASH_ATTR bmp180_read_raw(uint8_t cmd) { //BMP_DEBUG("bmp180_read_raw"); if(bmp180_write_wait_ack(BMP180_ADDRESS,1)) if(bmp180_write_wait_ack(BMP180_CTRL_REG,0)) if(bmp180_write_wait_ack(cmd,0)) { //BMP_DEBUG("bmp180_read_raw init ok"); i2c_master_stop(); os_delay_us(CONVERSION_TIME*1000); int16_t res = bmp180_read_reg_16(BMP180_DATA_REG); return res; } return 0; //if we got here means there was some error } int ICACHE_FLASH_ATTR bmp180_read(bmp_data *data){ if(!bmp_init_ok) return 0; int32_t UT; uint16_t UP; int32_t B3, B5, B6; uint32_t B4, B7; int32_t X1, X2, X3; int32_t T, P; UT = bmp180_read_raw(BMP_CMD_MEASURE_TEMP); UP = bmp180_read_raw(BMP_CMD_MEASURE_PRESSURE_0); //calc temp X1 = (UT - (int32_t)bmp_cal_data.ac6) * ((int32_t)bmp_cal_data.ac5) >> 15; X2 = ((int32_t)bmp_cal_data.mc << 11) / (X1 + (int32_t)bmp_cal_data.md); B5 = X1 + X2; T = (B5+8) >> 4; //calc pressure B6 = B5 - 4000; X1 = ((int32_t)bmp_cal_data.b2 * ((B6 * B6) >> 12)) >> 11; X2 = ((int32_t)bmp_cal_data.ac2 * B6) >> 11; X3 = X1 + X2; B3 = (((int32_t)bmp_cal_data.ac1 * 4 + X3) + 2) / 4; X1 = ((int32_t)bmp_cal_data.ac3 * B6) >> 13; X2 = ((int32_t)bmp_cal_data.b1 * ((B6 * B6) >> 12)) >> 16; X3 = ((X1 + X2) + 2) >> 2; B4 = ((uint32_t)bmp_cal_data.ac4 * (uint32_t)(X3 + 32768)) >> 15; B7 = ((uint32_t)UP - B3) * (uint32_t)(50000UL); if (B7 < 0x80000000) { P = (B7 * 2) / B4; } else { P = (B7 / B4) * 2; } X1 = (P >> 8) * (P >> 8); X1 = (X1 * 3038) >> 16; X2 = (-7357 * P) >> 16; P = P + ((X1 + X2 + (int32_t)3791) >> 4); data->temp=T; data->press=P; #ifdef BMP_DEBUG_ON BMP_DEBUG("bmp180 pressure : %d kPa",data->press); BMP_DEBUG("bmp180 temperature : %d mC",data->temp); #endif return 1; } int ICACHE_FLASH_ATTR bmp180_init(){ BMP_DEBUG("bmp180_init"); //setup i2c i2c_master_gpio_init(BMP180_SDA_PIN,BMP180_SCL_PIN); i2c_master_init(); if(!bmp180_read_reg_16(BMP180_VERSION_REG)) { BMP_DEBUG("failed reading bmp version"); return 0; } //calibration data bmp_cal_data.ac1 = bmp180_read_reg_16(0xAA); bmp_cal_data.ac2 = bmp180_read_reg_16(0xAC); bmp_cal_data.ac3 = bmp180_read_reg_16(0xAE); bmp_cal_data.ac4 = bmp180_read_reg_16(0xB0); bmp_cal_data.ac5 = bmp180_read_reg_16(0xB2); bmp_cal_data.ac6 = bmp180_read_reg_16(0xB4); bmp_cal_data.b1 = bmp180_read_reg_16(0xB6); bmp_cal_data.b2 = bmp180_read_reg_16(0xB8); bmp_cal_data.mb = bmp180_read_reg_16(0xBA); bmp_cal_data.mc = bmp180_read_reg_16(0xBC); bmp_cal_data.md = bmp180_read_reg_16(0xBE); bmp_init_ok=1; return 1; } ================================================ FILE: app/sensor/bmp180.h ================================================ /* * ---------------------------------------------------------------------------- * "THE BEER-WARE LICENSE" (Revision 42): * Israel Lot and Jeroen Domburg * wrote this file. As long as you retain this notice you can do whatever you * want with this stuff. If we meet some day, and you think this stuff is * worth it, you can buy us a beer in return. * ---------------------------------------------------------------------------- */ #ifndef __BMP180_H #define __BMP180_H typedef struct { int32_t temp; int32_t press; } bmp_data; int ICACHE_FLASH_ATTR bmp180_init(); int ICACHE_FLASH_ATTR bmp180_read(bmp_data *data); #endif ================================================ FILE: app/sensor/dht22.c ================================================ /* * ---------------------------------------------------------------------------- * "THE BEER-WARE LICENSE" (Revision 42): * Israel Lot and Jeroen Domburg * wrote this file. As long as you retain this notice you can do whatever you * want with this stuff. If we meet some day, and you think this stuff is * worth it, you can buy us a beer in return. * ---------------------------------------------------------------------------- */ #include "ets_sys.h" #include "osapi.h" #include "c_stdio.h" #include "mem.h" #include "gpio.h" #include "platform.h" #include "user_interface.h" #include "user_config.h" #include "dht22.h" #define DHT_DEBUG_ON #ifdef DHT_DEBUG_ON #define DHT_DBG NODE_DBG #else #define DHT_DBG #endif #define DHT_PIN 5 #define delay_ms(ms) os_delay_us(1000*ms) int ICACHE_FLASH_ATTR dht22_read(dht_data *read){ DHT_DBG("dht22_read"); //put dht pin on output mode with pullup platform_gpio_mode(DHT_PIN,PLATFORM_GPIO_OUTPUT,PLATFORM_GPIO_PULLUP); uint64_t data; os_memset(&data,0,sizeof(uint64_t)); //init sequence platform_gpio_write(DHT_PIN,1); delay_ms(5); platform_gpio_write(DHT_PIN,0); delay_ms(1); platform_gpio_write(DHT_PIN,1); //enable input reading platform_gpio_mode(DHT_PIN,PLATFORM_GPIO_INPUT,PLATFORM_GPIO_PULLUP); //find ACK start //wait pin to drop int timeout = 100; while(platform_gpio_read(DHT_PIN) == 1 && timeout > 0) { os_delay_us(5); timeout-=5; } if(timeout==0){ DHT_DBG("\tACK start timeout"); return 0; } //find ACK end //wait pin to rise timeout = 100; while(platform_gpio_read(DHT_PIN) == 0 && timeout > 0) { os_delay_us(10); timeout-=10; } if(timeout==0){ DHT_DBG("\tACK end timeout"); return 0; } //continue to read data while(1){ //wait pin to go low, signaling next bit timeout = 200; while(platform_gpio_read(DHT_PIN) == 1 && timeout > 0) { os_delay_us(5); timeout-=5; } if(timeout==0){ //NODE_DBG("\tdata signal timeout"); break; } //wait start of bit timeout = 200; while(platform_gpio_read(DHT_PIN) == 0 && timeout > 0) { os_delay_us(5); timeout-=5; } if(timeout==0){ //NODE_DBG("\tdata bit start timeout"); break; } //mearure pulse lenght timeout = 200; while(platform_gpio_read(DHT_PIN) == 1 && timeout > 0) { os_delay_us(5); timeout-=5; } if(timeout==0){ //NODE_DBG("\tdata bit read timeout"); break; } int pulseWidth = 200 - timeout; //shift data data <<= 1; if(pulseWidth > 40) { //bit is 1 data |=1; } else{ //bit is 0 //nothing to do } } //do the math float temp_p, hum_p; uint8_t data_part[5]; data_part[4] = ((uint8_t*)&data)[0]; data_part[3] = ((uint8_t*)&data)[1]; data_part[2] = ((uint8_t*)&data)[2]; data_part[1] = ((uint8_t*)&data)[3]; data_part[0] = ((uint8_t*)&data)[4]; int checksum = (data_part[0] + data_part[1] + data_part[2] + data_part[3]) & 0xFF; if (data_part[4] == checksum) { // yay! checksum is valid hum_p = data_part[0] * 256 + data_part[1]; hum_p /= 10; temp_p = (data_part[2] & 0x7F)* 256 + data_part[3]; temp_p /= 10.0; if (data_part[2] & 0x80) temp_p *= -1; read->temp = temp_p; read->hum = hum_p; #ifdef DHT_DEBUG_ON char * buff = (char *)os_zalloc(64); c_sprintf(buff,"%f",read->temp); DHT_DBG("dht22_init temp : %s C",buff); os_memset(buff,0,64); c_sprintf(buff,"%f",read->hum); DHT_DBG("dht22_init humidity : %s %%",buff); os_free(buff); #endif } return 1; } void ICACHE_FLASH_ATTR dht22_init(){ DHT_DBG("dht22_init"); //nothing to do actually } ================================================ FILE: app/sensor/dht22.h ================================================ /* * ---------------------------------------------------------------------------- * "THE BEER-WARE LICENSE" (Revision 42): * Israel Lot and Jeroen Domburg * wrote this file. As long as you retain this notice you can do whatever you * want with this stuff. If we meet some day, and you think this stuff is * worth it, you can buy us a beer in return. * ---------------------------------------------------------------------------- */ #ifndef __DHT22_H #define __DHT22_H typedef struct{ float temp; float hum; } dht_data; int ICACHE_FLASH_ATTR dht22_read(dht_data *data); #endif ================================================ FILE: app/sensor/ds18b20.c ================================================ // based on "How to measure temperature with your Arduino and a DS18B20" // http://www.tweaking4all.com/hardware/arduino/arduino-ds18b20-temperature-sensor/ #include "ets_sys.h" #include "osapi.h" #include "c_stdio.h" #include "mem.h" #include "platform.h" #include "user_interface.h" #include "user_config.h" #include "driver/onewire.h" #include "ds18b20.h" #define DS18B20_DEBUG_ON #ifdef DS18B20_DEBUG_ON #define DS18B20_DBG NODE_DBG #else #define DS18B20_DBG #endif #define DS18B20_PIN 4 #define delay_ms(ms) os_delay_us(1000*ms) static int gpioPin; int ICACHE_FLASH_ATTR ds18b20_read(ds18b20_data *read) { byte i; byte present = 0; byte type_s; byte data[12]; byte addr[8]; byte crc; float celsius; //float fahrenheit; DS18B20_DBG("Look for OneWire Devices on PIN =%d", gpioPin); if (!onewire_search(gpioPin, addr)) { DS18B20_DBG("No more addresses."); onewire_reset_search(gpioPin); delay_ms(250); return; } DS18B20_DBG("ADDRESS = %02x %02x %02x %02x %02x %02x %02x %02x", addr[0], addr[1], addr[2], addr[3], addr[4], addr[5], addr[6], addr[7]); // the first ROM byte indicates which chip switch (addr[0]) { case 0x10: DS18B20_DBG(" Chip = DS18S20"); // or old DS1820 type_s = 1; break; case 0x28: DS18B20_DBG(" Chip = DS18B20"); type_s = 0; break; case 0x22: DS18B20_DBG(" Chip = DS1822"); type_s = 0; break; default: DS18B20_DBG("Device is not a DS18x20 family device."); return; } onewire_reset(gpioPin); onewire_select(gpioPin, addr); onewire_write(gpioPin, 0x44, 1); // start conversion, use ds.write(0x44,1) with parasite power on at the end delay_ms(1000); present = onewire_reset(gpioPin); onewire_select(gpioPin, addr); onewire_write(gpioPin, 0xBE, 1); // Read Scratchpad //DS18B20_DBG(" Present = %d", present); for ( i = 0; i < 9; i++) { // we need 9 bytes data[i] = onewire_read(gpioPin); DS18B20_DBG(" DATA: %02x ", data[i]); } crc = onewire_crc8(data, 8); DS18B20_DBG(" CRC=%d ", crc); if (crc != data[8]) { DS18B20_DBG("CRC is not valid!"); return; } // Convert the data to actual temperature // because the result is a 16 bit signed integer, it should // be stored to an "int16_t" type, which is always 16 bits // even when compiled on a 32 bit processor. int16_t raw = (data[1] << 8) | data[0]; if (type_s) { raw = raw << 3; // 9 bit resolution default if (data[7] == 0x10) { // "count remain" gives full 12 bit resolution raw = (raw & 0xFFF0) + 12 - data[6]; } } else { byte cfg = (data[4] & 0x60); // at lower res, the low bits are undefined, so let's zero them if (cfg == 0x00) raw = raw & ~7; // 9 bit resolution, 93.75 ms else if (cfg == 0x20) raw = raw & ~3; // 10 bit res, 187.5 ms else if (cfg == 0x40) raw = raw & ~1; // 11 bit res, 375 ms //// default is 12 bit resolution, 750 ms conversion time } celsius = (float) raw / 16.0; //fahrenheit = celsius * 1.8 + 32.0; read->temp = celsius; DS18B20_DBG("Temperature = "); char *temp_string = (char*) os_zalloc(64); c_sprintf(temp_string, "%f", read->temp); DS18B20_DBG(" %s Celsius", temp_string); os_free(temp_string); //DS18B20_DBG(" %2.2f Fahrenheit", fahrenheit); return 1; } void ICACHE_FLASH_ATTR ds18b20_init(uint8_t pin) { DS18B20_DBG("ds18b20_init"); gpioPin = DS18B20_PIN; // default pin if ( pin > 0 && pin < 15) gpioPin = pin; onewire_init(gpioPin); onewire_reset_search(gpioPin); } ================================================ FILE: app/sensor/ds18b20.h ================================================ #ifndef __DS18b20_H #define __DS18b20_H typedef uint8_t boolean; typedef uint8_t byte; typedef struct{ float temp; } ds18b20_data; int ICACHE_FLASH_ATTR ds18b20_read(ds18b20_data *data); #endif ================================================ FILE: app/sensor/sensors.c ================================================ /* * ---------------------------------------------------------------------------- * "THE BEER-WARE LICENSE" (Revision 42): * Israel Lot wrote this file. As long as you retain * this notice you can do whatever you want with this stuff. If we meet some day, * and you think this stuff is worth it, you can buy me a beer in return. * ---------------------------------------------------------------------------- */ #include "c_types.h" #include "c_stdio.h" #include "ets_sys.h" #include "osapi.h" #include "mem.h" #include "gpio.h" #include "platform.h" #include "user_interface.h" #include "user_config.h" #include "sensors.h" #include "bmp180.h" #include "dht22.h" #include "ds18b20.h" #define DS18B20_PIN 4 #define SENSOR_TASK_QUEUE_LEN 1 #define SENSOR_TASK_PRIORITY 1 #define SENSOR_TASK_SIG 981237 static os_event_t sensor_read_task_queue[SENSOR_TASK_QUEUE_LEN]; static os_timer_t sensor_read_timer; sensor_data global_sensor_data; void ICACHE_FLASH_ATTR sensors_get_data(sensor_data *return_data) { //NODE_DBG("sensors_get_data"); *return_data = global_sensor_data; return; } static void ICACHE_FLASH_ATTR sensor_read_task(os_event_t *e){ if(e->sig != SENSOR_TASK_SIG) return; //not our signal dht22_read(&global_sensor_data.dht22); bmp180_read(&global_sensor_data.bmp180); } static void ICACHE_FLASH_ATTR sensor_read_timer_cb(void *arg){ system_os_post(SENSOR_TASK_PRIORITY, SENSOR_TASK_SIG, (os_param_t) NULL ); } void ICACHE_FLASH_ATTR sensors_init(){ NODE_DBG("sensors_init"); //init data os_memset(&global_sensor_data,0,sizeof(sensor_data)); //init sensors ds18b20_init(); dht22_init(); bmp180_init(); //Start os task system_os_task(sensor_read_task, SENSOR_TASK_PRIORITY ,sensor_read_task_queue, SENSOR_TASK_QUEUE_LEN); system_os_post(SENSOR_TASK_PRIORITY, SENSOR_TASK_SIG, (os_param_t) NULL ); //arm sensor read timer os_memset(&sensor_read_timer,0,sizeof(os_timer_t)); os_timer_disarm(&sensor_read_timer); os_timer_setfn(&sensor_read_timer, (os_timer_func_t *)sensor_read_timer_cb, NULL); os_timer_arm(&sensor_read_timer, 2000, 1); } ================================================ FILE: app/sensor/sensors.h ================================================ /* * ---------------------------------------------------------------------------- * "THE BEER-WARE LICENSE" (Revision 42): * Israel Lot wrote this file. As long as you retain * this notice you can do whatever you want with this stuff. If we meet some day, * and you think this stuff is worth it, you can buy me a beer in return. * ---------------------------------------------------------------------------- */ #ifndef __SENSORS_H #define __SENSORS_H #include "bmp180.h" #include "dht22.h" typedef struct { dht_data dht22; bmp_data bmp180; } sensor_data; void ICACHE_FLASH_ATTR sensors_init(); void ICACHE_FLASH_ATTR sensors_get_data(sensor_data *return_data); #endif ================================================ FILE: app/smart/Makefile ================================================ ############################################################# # Required variables for each makefile # Discard this section from all parent makefiles # Expected variables (with automatic defaults): # CSRCS (all "C" files in the dir) # SUBDIRS (all subdirs with a Makefile) # GEN_LIBS - list of libs to be generated () # GEN_IMAGES - list of images to be generated () # COMPONENTS_xxx - a list of libs/objs in the form # subdir/lib to be extracted and rolled up into # a generated lib/image xxx.a () # ifndef PDIR GEN_LIBS = smart.a endif ############################################################# # Configuration i.e. compile options etc. # Target specific stuff (defines etc.) goes in here! # Generally values applying to a tree are captured in the # makefile at its root level - these are then overridden # for a subtree within the makefile rooted therein # #DEFINES += ############################################################# # Recursion Magic - Don't touch this!! # # Each subtree potentially has an include directory # corresponding to the common APIs applicable to modules # rooted at that subtree. Accordingly, the INCLUDE PATH # of a module can only contain the include directories up # its parent path, and not its siblings # # Required for each makefile to inherit from the parent # INCLUDES := $(INCLUDES) -I $(PDIR)include INCLUDES += -I ./ INCLUDES += -I ../libc PDIR := ../$(PDIR) sinclude $(PDIR)Makefile ================================================ FILE: app/smart/smart.c ================================================ #include "c_stdio.h" #include "c_stdlib.h" #include "c_string.h" #include "user_interface.h" #include "smart.h" #define ADDR_MAP_NUM 10 static os_timer_t smart_timer; static smart_addr_map *am[ADDR_MAP_NUM]; static smart_addr_map *matched = NULL; static struct station_config *sta_conf; static int cur_channel = 1; static uint8_t mode = STATION_MODE; static uint8_t alldone = 0; // 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000(LSB) // when the bit is set, means the ssid byte is got static uint8_t *got_ssid = NULL; static uint8_t *got_password = NULL; static uint8_t *ssid_nibble = NULL; static uint8_t *password_nibble = NULL; static smart_succeed succeed = NULL; static void *smart_succeed_arg = NULL; void smart_end(); int smart_check(uint8_t *nibble, uint16_t len, uint8_t *dst, uint8_t *got){ if(len == 0) return 0; uint16_t dst_len = len/NIBBLE_PER_BYTE; uint16_t byte_num = 0, bit_num = 0; int i = 0, res = 1; // assume ok. c_memset(dst,0,dst_len); if(NIBBLE_PER_BYTE==1){ for(i=0;inibble[i] || nibble[i]>=0x7F){ // not printable NODE_DBG("Smart: got np byte %d:%02x", i, nibble[i]); nibble[i] = 0; got[byte_num] &= ~(0x1 << bit_num); // clear the bit res = 0; // not ok } else { dst[i] = nibble[i]; } } return res; } // NIBBLE_PER_BYTE == 2 if((len%NIBBLE_PER_BYTE) != 0){ // this should not happen NODE_DBG("Smart: smart_check got odd len"); return 0; } if(len == 2){ // only one byte if(nibble[0]<=0xF && ((nibble[0]^0x1)&0xF == (nibble[1]>>4)) ){ dst[0] = ((nibble[0]&0xF)<<4) + (nibble[1]&0xF); res = 1; }else{ nibble[0] = 0; nibble[1] = 0; got[0] &= ~(0x3 << 0); // clear the 0 bit res = 0; // not ok } return res; } res = 1; // assume ok. for(i=len-2;i>0;i--){ bool forward = ( ((nibble[i]&0xF)^((i+1)&0xF)) == (nibble[i+1]>>4) ); bool back = ( ((nibble[i-1]&0xF)^(i&0xF)) == (nibble[i]>>4) ); if(!forward || !back){ // wrong forward, or wrong back, replace i-1, i and i+1, until get right back, forward NODE_DBG("check: wf %d:%02x %02x %02x",i,nibble[i-1],nibble[i], nibble[i+1]); byte_num = (i-1) / 8; bit_num = (i-1) % 8; nibble[i-1] = 0; got[byte_num] &= ~(0x1 << bit_num); // clear the bit byte_num = (i) / 8; bit_num = (i) % 8; nibble[i] = 0; got[byte_num] &= ~(0x1 << bit_num); // clear the bit byte_num = (i+1) / 8; bit_num = (i+1) % 8; nibble[i+1] = 0; got[byte_num] &= ~(0x1 << bit_num); // clear the bit res = 0; return res; // once there is error, } if((i%NIBBLE_PER_BYTE) == 0) { // i == even dst[i/NIBBLE_PER_BYTE] = ((nibble[i]&0xF)<<4) + (nibble[i+1]&0xF); } } if(i==0){ dst[0] = ((nibble[0]&0xF)<<4) + (nibble[1]&0xF); } for(i=0;i%02x", i, nibble[i*NIBBLE_PER_BYTE], nibble[i*NIBBLE_PER_BYTE+1], dst[i]); byte_num = (i*NIBBLE_PER_BYTE) / 8; bit_num = (i*NIBBLE_PER_BYTE) % 8; if(0x20>dst[i] || dst[i]>=0x7F){ // not printable NODE_DBG("Smart: got np byte %d:%02x", i, dst[i]); dst[i] = 0; // reset byte nibble[i*NIBBLE_PER_BYTE] = 0; // reset hi-nibble nibble[i*NIBBLE_PER_BYTE+1] = 0; // reset lo-nibble got[byte_num] &= ~(0x3 << bit_num); // clear the bit res = 0; // not ok } } return res; } void detect(uint8 *buf, uint16 len){ uint16_t seq; int16_t seq_delta = 0; uint16_t byte_num = 0, bit_num = 0; int16_t c = 0; if( ( (buf[0]) & TYPE_SUBTYPE_MASK) != TYPE_SUBTYPE_QOS_DATA){ return; } if( (buf[1] & DS_RETRY_MASK) != NO_RETRY ) return; if( buf[SEQ_ADDR] & 0xF != 0 ) // Fragment Number should = 0 return; // calculate current seq number seq = buf[SEQ_ADDR+1]; seq = seq<<4; seq += buf[SEQ_ADDR]>>4; if(!matched){ // cur_base_seq is ref to flag[0] when finding the patern int i; for (i = 0; i < ADDR_MAP_NUM; i++) // for each source-dest adress pair in the map { if ( am[i]->flag_match_num == 0 ){ // not in the map yet if ( len - am[i]->base_len == am[i]->flag[0]) // store new source-dest adress pair to the map until flag[0] is got { // BSSID, SA, DA, store the SA, DA c_memcpy(am[i]->addr, &buf[ADDR_MATCH_START], ADDR_MATCH_LENGTH); am[i]->flag_match_num++; // =1 am[i]->cur_base_seq = seq; // assume the first seq is found am[i]->base_seq_valid = 1; // NODE_DBG("Smart: new addr pair found"); } break; // break any way for the next packet to come } else if(0 == c_memcmp(am[i]->addr, &buf[ADDR_MATCH_START], ADDR_MATCH_LENGTH)){ // source-dest adress pair match if(am[i]->base_seq_valid == 0){ if ( len - am[i]->base_len == am[i]->flag[0]) { // found the new flag[0] // here flag_match_num is already = 1 am[i]->cur_base_seq = seq; am[i]->base_seq_valid = 1; // the seq number is valid now // NODE_DBG("Smart: new base_seq found"); } break; // break any way for the next packet to come } // base seq number is valid, cal the delta if(seq >= am[i]->cur_base_seq){ seq_delta = seq - am[i]->cur_base_seq; } else { seq_delta = SEQ_MAX - am[i]->cur_base_seq + seq; } if(seq_delta < 0){ // this should never happen am[i]->base_seq_valid = 0; // the seq number is not valid break; } if(seq_delta == 0){ // base_seq is not valid any more if ( len - am[i]->base_len != am[i]->flag[0]) { // lost the flag[0] am[i]->base_seq_valid = 0; // the seq number is not valid } break; // break any way for the next packet to come } // delta is out of range, need to find the next flag[0] to start again if (seq_delta>=FLAG_NUM){ am[i]->flag_match_num = 1; // reset to 1 if ( len - am[i]->base_len == am[i]->flag[0]) { // found the new flag[0] // here flag_match_num is already = 1 am[i]->cur_base_seq = seq; am[i]->base_seq_valid = 1; // the seq number is valid now } else { am[i]->base_seq_valid = 0; } break; // done for this packet } // NODE_DBG("Smart: match_num:%d seq_delta:%d len:%d",am[i]->flag_match_num,seq_delta,len-am[i]->base_len); // seq_delta now from 1 to FLAG_NUM-1 // flag[] == 0 ,means skip this flag. if ( (am[i]->flag_match_num==seq_delta) && \ ( (am[i]->flag[am[i]->flag_match_num]==len-am[i]->base_len) || (am[i]->flag[am[i]->flag_match_num]==0) ) ){ am[i]->flag_match_num++; if(am[i]->flag_match_num == FLAG_MATCH_NUM){ //every thing is match. NODE_ERR("Smart: got matched sender\n"); matched = am[i]; // got the matched source-dest adress pair who is sending the udp data matched->base_seq_valid = 0; // set to 0, and start to reference to the SSID_FLAG from now on os_timer_disarm(&smart_timer); // note: may start a longer timeout } break; } // non match, reset, need to find next flag[0] to start again am[i]->flag_match_num = 1; am[i]->base_seq_valid = 0; break; } // non-match source-dest adress pair, continue to next pair in the map. } // for loop // break out, or loop done. goto end; } else { // cur_base_seq is ref to SSID_FLAG when patern is alread found if(0 != c_memcmp(matched->addr, &buf[ADDR_MATCH_START], ADDR_MATCH_LENGTH)){ // source-dest adress pair not match, ignore it return; } if (matched->base_seq_valid == 0){ // SSID_FLAG seq invalid, need to find the next valid seq number // base_seq not valid, find it if (len - matched->base_len == SSID_FLAG){ matched->cur_base_seq = seq; matched->base_seq_valid = 1; } goto end; } if(seq >= matched->cur_base_seq){ seq_delta = seq - matched->cur_base_seq; } else { seq_delta = SEQ_MAX - matched->cur_base_seq + seq; } if(seq_delta < 0){ // this should never happen matched->base_seq_valid = 0; // the seq number is not valid goto end; } if(seq_delta == 0){ // base_seq is not valid any more if ( len - matched->base_len != SSID_FLAG) { // lost the SSID_FLAG matched->base_seq_valid = 0; // the seq number is not valid } goto end; // exit for the next packet to come } if ( seq_delta > (SEP_NUM + 1)*(1+NIBBLE_PER_BYTE*matched->ssid_len) +\ 1 + (SEP_NUM + 1)*(1+NIBBLE_PER_BYTE*matched->pwd_len) ){ // delta out of the range if (len - matched->base_len == SSID_FLAG){ matched->cur_base_seq = seq; matched->base_seq_valid = 1; } else { matched->base_seq_valid = 0; } goto end; } // delta in the range if (seq_delta==1){ int16_t ssid_len = len - matched->base_len - L_FLAG; if ( matched->ssid_len == 0 ){ // update the ssid_len if ( (ssid_len <=32) && (ssid_len >0) ){ matched->ssid_len = ssid_len; NODE_DBG("Smart: found the ssid_len %d", matched->ssid_len); } goto end; } if (ssid_len != matched->ssid_len){ // ssid_len not match matched->base_seq_valid = 0; // note: not match, save the new one or old one? for now save the new one. matched->ssid_len = ssid_len; NODE_DBG("Smart: ssid_len not match"); } goto end; // to the next packet } if( (SEP_NUM==2)&&(seq_delta==2 || seq_delta==3) ) { if (len - matched->base_len != matched->flag[seq_delta-2+SEP_1_INDEX]){ // SEP not match matched->base_seq_valid = 0; NODE_DBG("Smart: SEP-L not match"); } goto end; // to the next packet } if( seq_delta==(SEP_NUM + 1)*(1+NIBBLE_PER_BYTE*matched->ssid_len) + 1) { if (len - matched->base_len != PWD_FLAG){ // PWD_FLAG not match matched->base_seq_valid = 0; NODE_DBG("Smart: PWD_FLAG not match"); } goto end; // to the next packet } if (seq_delta==(SEP_NUM + 1)*(1+NIBBLE_PER_BYTE*matched->ssid_len) + 1 + 1){ int16_t pwd_len = len - matched->base_len - L_FLAG; if ( matched->pwd_len == 0){ if ( (pwd_len <=64) && (pwd_len>0)){ matched->pwd_len = pwd_len; NODE_DBG("Smart: found the pwd_len %d", matched->pwd_len); } goto end; // to the next packet } if (pwd_len != matched->pwd_len){ // pwd_len not match matched->base_seq_valid = 0; // note: not match, save the new one or old one? for now save the new one. matched->pwd_len = pwd_len; // reset pwd_len to 0 NODE_DBG("Smart: pwd_len not match"); } goto end; } if (seq_delta <= (SEP_NUM + 1)*(1+NIBBLE_PER_BYTE*matched->ssid_len) ){ // in the ssid zone uint16_t it = (seq_delta-1-SEP_NUM-1) / (SEP_NUM + 1); // the number of ssid nibble: 0~31 or 0~63 uint16_t m = (seq_delta-1-SEP_NUM-1) % (SEP_NUM + 1); // 0~2 switch(m){ case 0: // the ssid hi/lo-nibble itself c = (int16_t)(len - matched->base_len - C_FLAG); if (c>255 || c<0){ matched->base_seq_valid = 0; NODE_DBG("Smart: wrong ssid nibble"); goto end; } byte_num = it / 8; // 0~7 bit_num = it % 8; // 0~7 if( (got_ssid[byte_num] & (0x1 << bit_num)) == 0){ got_ssid[byte_num] |= 0x1 << bit_num; // set the bit ssid_nibble[it] = c; } break; case 1: // seperator 1 case 2: // seperator 2 if(len - matched->base_len != matched->flag[m-1+SEP_1_INDEX]){ NODE_DBG("Smart: SEP-S not match"); matched->base_seq_valid = 0; goto end; } break; default: break; } } else { // in the pwd zone uint16_t it = (seq_delta -1 -(SEP_NUM + 1)*(1+NIBBLE_PER_BYTE*matched->ssid_len) - 2 - SEP_NUM) / (SEP_NUM + 1); // the number of pwd byte uint16_t m = (seq_delta -1 -(SEP_NUM + 1)*(1+NIBBLE_PER_BYTE*matched->ssid_len) - 2 - SEP_NUM) % (SEP_NUM + 1); switch(m){ case 0: // the pwd hi/lo-nibble itself c = (int16_t)(len - matched->base_len - C_FLAG); if (c>255 || c<0){ matched->base_seq_valid = 0; NODE_DBG("Smart: wrong password nibble"); goto end; } byte_num = it / 8; // 0~15 / 7 bit_num = it % 8; // 0~7 if( (got_password[byte_num] & (0x1 << bit_num)) == 0){ got_password[byte_num] |= 0x1 << bit_num; // set the bit password_nibble[it] = c; } break; case 1: // seperator 1 case 2: // seperator 2 if(len - matched->base_len != matched->flag[m-1+SEP_1_INDEX]){ NODE_DBG("Smart: SEP-P not match"); matched->base_seq_valid = 0; goto end; } break; default: break; } } // check if all done // NODE_DBG("Smart: ssid got %02x %02x", got_ssid[0], got_ssid[1]); // NODE_DBG("Smart: password got %02x %02x %02x", got_password[0], got_password[1], got_password[2]); int i,j; for(i=0;issid_len;i++){ byte_num = (i) / 8; bit_num = (i) % 8; if( (got_ssid[byte_num] & (0x1 << bit_num) ) != (0x1 << bit_num) ){ // check the bit == 1 break; } } for(j=0;jpwd_len;j++){ byte_num = (j) / 8; bit_num = (j) % 8; if( (got_password[byte_num] & (0x1 << bit_num) ) != (0x1 << bit_num) ){ // check the 2 bit == 11 break; } } if(matched->ssid_len > 0 && matched->pwd_len > 0 && i==NIBBLE_PER_BYTE*matched->ssid_len && j==NIBBLE_PER_BYTE*matched->pwd_len){ // get everything, check it. if( smart_check(ssid_nibble, NIBBLE_PER_BYTE*matched->ssid_len, sta_conf->ssid, got_ssid) && \ smart_check(password_nibble, NIBBLE_PER_BYTE*matched->pwd_len, sta_conf->password, got_password) ){ // all done alldone = 1; NODE_ERR(sta_conf->ssid); NODE_ERR(" %d\n", matched->ssid_len); NODE_ERR(sta_conf->password); NODE_ERR(" %d\n", matched->pwd_len); smart_end(); // if(succeed){ // succeed(smart_succeed_arg); // succeed = NULL; // reset to NULL when succeed // smart_succeed_arg = NULL; // } return; } } } end: #if 0 NODE_DBG("%d:\t0x%x 0x%x\t", len-BASE_LENGTH, buf[0],buf[1]); NODE_DBG(MACSTR, MAC2STR(&(buf[BSSID_ADDR]))); NODE_DBG("\t"); NODE_DBG(MACSTR, MAC2STR(&(buf[SOURCE_ADDR]))); NODE_DBG("\t"); NODE_DBG(MACSTR, MAC2STR(&(buf[DEST_ADDR]))); uint16_t tseq = buf[SEQ_ADDR+1]; tseq = tseq<<4; tseq += buf[SEQ_ADDR]>>4; NODE_DBG("\t0x%04x", tseq); #endif return; } void reset_map(smart_addr_map **am, size_t num){ int i; for (i = 0; i < num; ++i) { am[i]->flag_match_num = 0; am[i]->addr_len = ADDR_MATCH_LENGTH; am[i]->base_len = BASE_LENGTH; am[i]->cur_base_seq = -1; am[i]->base_seq_valid = 0; am[i]->ssid_len = 0; am[i]->pwd_len = 0; c_memset(am[i]->addr, 0, ADDR_MATCH_LENGTH); if(SEP_1_INDEX==0){ am[i]->flag[0] = SEP_1; am[i]->flag[1] = SEP_2; am[i]->flag[2] = SSID_FLAG; } if(SEP_1_INDEX==2){ am[i]->flag[0] = SSID_FLAG; am[i]->flag[1] = 0; // skip this flag am[i]->flag[2] = SEP_1; am[i]->flag[3] = SEP_2; } } } void smart_enable(void){ wifi_promiscuous_enable(1); } void smart_disable(void){ wifi_promiscuous_enable(0); } void smart_end(){ int i; os_timer_disarm(&smart_timer); smart_disable(); wifi_set_channel(cur_channel); if(NULL_MODE != mode){ wifi_set_opmode(mode); } else { wifi_set_opmode(STATION_MODE); } mode = wifi_get_opmode(); if(sta_conf && alldone){ if( (STATION_MODE == mode) || (mode == STATIONAP_MODE) ){ wifi_station_set_config(sta_conf); wifi_station_set_auto_connect(true); wifi_station_disconnect(); wifi_station_connect(); os_timer_disarm(&smart_timer); os_timer_setfn(&smart_timer, (os_timer_func_t *)station_check_connect, 1); os_timer_arm(&smart_timer, STATION_CHECK_TIME, 0); // no repeat } } for (i = 0; i < ADDR_MAP_NUM; ++i) { if(am[i]){ c_free(am[i]); am[i] = NULL; } matched = NULL; } if(sta_conf){ c_free(sta_conf); sta_conf = NULL; } if(got_password){ c_free(got_password); got_password = NULL; } if(got_ssid){ c_free(got_ssid); got_ssid = NULL; } if(password_nibble){ c_free(password_nibble); password_nibble = NULL; } if(ssid_nibble){ c_free(ssid_nibble); ssid_nibble = NULL; } // system_restart(); // restart to enable the mode } void smart_next_channel(){ smart_disable(); switch(cur_channel){ case 1: cur_channel = MAX_CHANNEL; break; case 2: case 3: case 4: cur_channel++; break; case 5: cur_channel = 7; break; case 6: cur_channel = 1; break; case 7: case 8: case 9: case 10: case 11: case 12: cur_channel++; break; case 13: cur_channel = 6; break; case MAX_CHANNEL: cur_channel = 2; break; default: cur_channel = 6; break; } NODE_ERR("switch to channel %d\n", cur_channel); wifi_set_channel(cur_channel); reset_map(am, ADDR_MAP_NUM); c_memset(sta_conf->ssid, 0, sizeof(sta_conf->ssid)); c_memset(sta_conf->password, 0, sizeof(sta_conf->password)); c_memset(got_ssid, 0, SSID_BIT_MAX); c_memset(got_password, 0, PWD_BIT_MAX); c_memset(ssid_nibble, 0, SSID_NIBBLE_MAX); c_memset(password_nibble, 0, PWD_NIBBLE_MAX); os_timer_disarm(&smart_timer); os_timer_arm(&smart_timer, TIME_OUT_PER_CHANNEL, 0); // no repeat smart_enable(); } void smart_begin(int chnl, smart_succeed s, void *arg){ int i; alldone = 0; for (i = 0; i < ADDR_MAP_NUM; ++i) { if(!am[i]){ am[i] = (smart_addr_map*)c_zalloc(sizeof(smart_addr_map)); if(!am[i]){ NODE_DBG("smart_begin map no memory"); smart_end(); return; } } } if(!sta_conf){ sta_conf = (struct station_config *)c_zalloc(sizeof(struct station_config)); if(!sta_conf){ NODE_DBG("smart_begin sta_conf no memory"); smart_end(); return; } } if(!ssid_nibble){ ssid_nibble = (uint8_t *)c_zalloc(SSID_NIBBLE_MAX); if(!ssid_nibble){ NODE_DBG("smart_begin sta_conf no memory"); smart_end(); return; } } if(!password_nibble){ password_nibble = (uint8_t *)c_zalloc(PWD_NIBBLE_MAX); if(!password_nibble){ NODE_DBG("smart_begin sta_conf no memory"); smart_end(); return; } } if(!got_ssid){ got_ssid = (uint8_t *)c_zalloc(SSID_BIT_MAX); if(!got_ssid){ NODE_DBG("smart_begin sta_conf no memory"); smart_end(); return; } } if(!got_password){ got_password = (uint8_t *)c_zalloc(PWD_BIT_MAX); if(!got_password){ NODE_DBG("smart_begin sta_conf no memory"); smart_end(); return; } } reset_map(am, ADDR_MAP_NUM); // c_memset(sta_conf->ssid, 0, sizeof(sta_conf->ssid)); // c_memset(sta_conf->password, 0, sizeof(sta_conf->password)); // c_memset(got_ssid, 0, SSID_BIT_MAX); // c_memset(got_password, 0, PWD_BIT_MAX); // c_memset(ssid_nibble, 0, SSID_NIBBLE_MAX); // c_memset(password_nibble, 0, PWD_NIBBLE_MAX); mode = wifi_get_opmode(); if( (STATION_MODE == mode) || (mode == STATIONAP_MODE) ){ wifi_station_set_auto_connect(false); wifi_station_disconnect(); } cur_channel = chnl; NODE_ERR("set channel to %d\n", cur_channel); wifi_set_channel(cur_channel); wifi_set_promiscuous_rx_cb(detect); os_timer_disarm(&smart_timer); os_timer_setfn(&smart_timer, (os_timer_func_t *)smart_next_channel, NULL); os_timer_arm(&smart_timer, TIME_OUT_PER_CHANNEL, 0); // no repeat if(s){ succeed = s; // init the succeed call back smart_succeed_arg = arg; } smart_enable(); } void station_check_connect(bool smart){ mode = wifi_get_opmode(); if( (STATION_MODE != mode) && (mode != STATIONAP_MODE) ){ return; } uint8_t status = wifi_station_get_connect_status(); switch(status){ case STATION_GOT_IP: NODE_DBG("station_check_connect is called with status: GOT_IP"); if(succeed){ succeed(smart_succeed_arg); succeed = NULL; // reset to NULL when succeed smart_succeed_arg = NULL; } return; case STATION_CONNECTING: NODE_DBG("station_check_connect is called with status: CONNECTING"); break; case STATION_IDLE: wifi_station_set_auto_connect(true); case STATION_CONNECT_FAIL: case STATION_NO_AP_FOUND: wifi_station_disconnect(); wifi_station_connect(); NODE_DBG("station_check_connect is called with smart: %d", smart); break; case STATION_WRONG_PASSWORD: if(smart) smart_begin(cur_channel, succeed, smart_succeed_arg); return; default: break; } os_timer_disarm(&smart_timer); os_timer_setfn(&smart_timer, (os_timer_func_t *)station_check_connect, smart); os_timer_arm(&smart_timer, STATION_CHECK_TIME, 0); // no repeat } ================================================ FILE: app/smart/smart.h ================================================ #ifndef _SMART_H #define _SMART_H 1 #ifdef __cplusplus extern "C" { #endif #define MAX_CHANNEL 14 #define TYPE_SUBTYPE_QOS_DATA 0x88 #define TYPE_SUBTYPE_MASK 0xFC #define NO_RETRY 0x41 #define DS_RETRY_MASK 0x4B #define BSSID_ADDR 4 #define SOURCE_ADDR 10 #define DEST_ADDR 16 #define ADDR_LENGTH 6 #define ADDR_MATCH_START (SOURCE_ADDR) #define ADDR_MATCH_LENGTH (ADDR_LENGTH*2) #define SEQ_ADDR 22 #define SEQ_LEN 2 #define SEQ_MAX 0x1000 #define BASE_LENGTH 82 #define SSID_FLAG 1399 #define PWD_FLAG 1459 #define L_FLAG 28 #define C_FLAG 593 #define SEP_1 3 #define SEP_2 23 #define SEP_3 24 #define SEP_4 25 #define SEP_5 26 #define SEP_NUM 2 #define NIBBLE_PER_BYTE 2 #define SEP_1_INDEX 2 #if(SEP_1_INDEX==0) #define FLAG_NUM (SEP_NUM+1) #elif(SEP_1_INDEX==2) #define FLAG_NUM (SEP_NUM+2) #endif #define FLAG_MATCH_NUM (FLAG_NUM-1) // only need to match 2 or 3 byte to increase speed. // #define TI_SMARTCONFIG 1 #define SSID_NIBBLE_MAX (32*NIBBLE_PER_BYTE) #define PWD_NIBBLE_MAX (64*NIBBLE_PER_BYTE) #define SSID_BIT_MAX (SSID_NIBBLE_MAX/8) #define PWD_BIT_MAX (PWD_NIBBLE_MAX/8) #define TIME_OUT_PER_CHANNEL (30*1000) #define STATION_CHECK_TIME (2*1000) struct _my_addr_map { uint8 addr[ADDR_LENGTH*3]; uint8_t addr_len; uint16_t base_len; int16_t flag[FLAG_NUM]; // flag[0]: SEP_1, flag[1]: SEP_2, flag[1]: SSID_FLAG. SEP followed by SSID_FLAG formed flag[] // if flag[i]==0, means skip this flag match, eg. SSID_FLAG, 0, SEP_1, SEP_2 uint8_t flag_match_num; int16_t cur_base_seq; int8_t base_seq_valid; int8_t ssid_len; int8_t pwd_len; }; typedef struct _my_addr_map smart_addr_map; typedef void (* smart_succeed)(void *arg); void smart_begin(int chnl, smart_succeed s, void *arg); void station_check_connect(bool smart); #ifdef __cplusplus } #endif #endif ================================================ FILE: app/spiffs/Makefile ================================================ ############################################################# # Required variables for each makefile # Discard this section from all parent makefiles # Expected variables (with automatic defaults): # CSRCS (all "C" files in the dir) # SUBDIRS (all subdirs with a Makefile) # GEN_LIBS - list of libs to be generated () # GEN_IMAGES - list of images to be generated () # COMPONENTS_xxx - a list of libs/objs in the form # subdir/lib to be extracted and rolled up into # a generated lib/image xxx.a () # ifndef PDIR GEN_LIBS = spiffs.a endif ############################################################# # Configuration i.e. compile options etc. # Target specific stuff (defines etc.) goes in here! # Generally values applying to a tree are captured in the # makefile at its root level - these are then overridden # for a subtree within the makefile rooted therein # #DEFINES += ############################################################# # Recursion Magic - Don't touch this!! # # Each subtree potentially has an include directory # corresponding to the common APIs applicable to modules # rooted at that subtree. Accordingly, the INCLUDE PATH # of a module can only contain the include directories up # its parent path, and not its siblings # # Required for each makefile to inherit from the parent # INCLUDES := $(INCLUDES) -I $(PDIR)include INCLUDES += -I ./ INCLUDES += -I ../libc INCLUDES += -I ../platform PDIR := ../$(PDIR) sinclude $(PDIR)Makefile ================================================ FILE: app/spiffs/docs/IMPLEMENTING ================================================ ================================================ FILE: app/spiffs/docs/INTEGRATION ================================================ * QUICK AND DIRTY INTEGRATION EXAMPLE So, assume you're running a Cortex-M3 board with a 2 MB SPI flash on it. The SPI flash has 64kB blocks. Your project is built using gnumake, and now you want to try things out. First, you simply copy the files in src/ to your own source folder. Exclude all files in test folder. Then you point out these files in your make script for compilation. Also copy the spiffs_config.h over from the src/default/ folder. Try building. This fails, nagging about inclusions and u32_t and whatnot. Open the spiffs_config.h and delete the bad inclusions. Also, add following typedefs: typedef signed int s32_t; typedef unsigned int u32_t; typedef signed short s16_t; typedef unsigned short u16_t; typedef signed char s8_t; typedef unsigned char u8_t; Now it should build. Over to the mounting business. Assume you already implemented the read, write and erase functions to your SPI flash: void my_spi_read(int addr, int size, char *buf) void my_spi_write(int addr, int size, char *buf) void my_spi_erase(int addr, int size) In your main.c or similar, include the spiffs.h and do that spiffs struct: #include static spiffs fs; Also, toss up some of the needed buffers: #define LOG_PAGE_SIZE 256 static u8_t spiffs_work_buf[LOG_PAGE_SIZE*2]; static u8_t spiffs_fds[32*4]; static u8_t spiffs_cache[(LOG_PAGE_SIZE+32)*4]; Now, write the my_spiffs_mount function: void my_spiffs_mount() { spiffs_config cfg; cfg.phys_size = 2*1024*1024; // use all spi flash cfg.phys_addr = 0; // start spiffs at start of spi flash cfg.phys_erase_block = 65536; // according to datasheet cfg.log_block_size = 65536; // let us not complicate things cfg.log_block_size = LOG_PAGE_SIZE; // as we said cfg.hal_read_f = my_spi_read; cfg.hal_write_f = my_spi_write; cfg.hal_erase_f = my_spi_erase; int res = SPIFFS_mount(&fs, &cfg, spiffs_work_buf, spiffs_fds, sizeof(spiffs_fds), spiffs_cache, sizeof(spiffs_cache), 0); printf("mount res: %i\n", res); } Now, build warns about the my_spi_read, write and erase functions. Wrong signatures, so go wrap them: static s32_t my_spiffs_read(u32_t addr, u32_t size, u8_t *dst) { my_spi_read(addr, size, dst); return SPIFFS_OK; } static s32_t my_spiffs_write(u32_t addr, u32_t size, u8_t *src) { my_spi_write(addr, size, dst); return SPIFFS_OK; } static s32_t my_spiffs_erase(u32_t addr, u32_t size) { my_spi_erase(addr, size); return SPIFFS_OK; } Redirect the config in my_spiffs_mount to the wrappers instead: cfg.hal_read_f = my_spiffs_read; cfg.hal_write_f = my_spiffs_write; cfg.hal_erase_f = my_spiffs_erase; Ok, now you should be able to build and run. However, you get this output: mount res: -1 but you wanted mount res: 0 This is probably due to you having experimented with your SPI flash, so it contains rubbish from spiffs's point of view. Do a mass erase and run again. If all is ok now, you're good to go. Try creating a file and read it back: static void test_spiffs() { char buf[12]; // Surely, I've mounted spiffs before entering here spiffs_file fd = SPIFFS_open(&fs, "my_file", SPIFFS_CREAT | SPIFFS_TRUNC | SPIFFS_RDWR, 0); if (SPIFFS_write(&fs, fd, (u8_t *)"Hello world", 12) < 0) printf("errno %i\n", SPIFFS_errno(&fs)); SPIFFS_close(&fs, fd); fd = SPIFFS_open(&fs, "my_file", SPIFFS_RDWR, 0); if (SPIFFS_read(&fs, fd, (u8_t *)buf, 12) < 0) printf("errno %i\n", SPIFFS_errno(&fs)); SPIFFS_close(&fs, fd); printf("--> %s <--\n", buf); } Compile, run, cross fingers hard, and you'll get the output: --> Hello world <-- Got errors? Check spiffs.h for error definitions to get a clue what went voodoo. * INTEGRATING SPIFFS In order to integrate spiffs to your embedded target, you will basically need: - A SPI flash device which your processor can communicate with - An implementation for reading, writing and erasing the flash - Memory (flash or ram) for the code - Memory (ram) for the stack Other stuff may be needed, threaded systems might need mutexes and so on. ** Logical structure First and foremost, one must decide how to divide up the SPI flash for spiffs. Having the datasheet for the actual SPI flash in hand will help. Spiffs can be defined to use all or only parts of the SPI flash. If following seems arcane, read the "HOW TO CONFIG" chapter first. - Decide the logical size of blocks. This must be a multiple of the biggest physical SPI flash block size. To go safe, use the physical block size - which in many cases is 65536 bytes. - Decide the logical size of pages. This must be a 2nd logarithm part of the logical block size. To go safe, use 256 bytes to start with. - Decide how much of the SPI flash memory to be used for spiffs. This must be on logical block boundary. If unsafe, use 1 megabyte to start with. - Decide where on the SPI flash memory the spiffs area should start. This must be on physical block/sector boundary. If unsafe, use address 0. ** SPI flash API The target must provide three functions to spiffs: - s32_t (*spiffs_read)(u32_t addr, u32_t size, u8_t *dst) - s32_t (*spiffs_write)(u32_t addr, u32_t size, u8_t *src) - s32_t (*spiffs_erase)(u32_t addr, u32_t size) These functions define the only communication between the SPI flash and the spiffs stack. On success these must return 0 (or SPIFFS_OK). Anything else will be considered an error. The size for read and write requests will never exceed the logical page size, but it may be less. The address and size on erase requests will always be on physical block size boundaries. ** Mount specification In spiffs.h, there is a SPIFFS_mount function defined, used to mount spiffs on the SPI flash. s32_t SPIFFS_mount( spiffs *fs, spiffs_config *config, u8_t *work, u8_t *fd_space, u32_t fd_space_size, void *cache, u32_t cache_size, spiffs_check_callback check_cb_f) - fs Points to a spiffs struct. This may be totally uninitialized. - config Points to a spiffs_config struct. This struct must be initialized when mounting. See below. - work A ram memory buffer being double the size of the logical page size. This buffer is used excessively by the spiffs stack. If logical page size is 256, this buffer must be 512 bytes. - fd_space A ram memory buffer used for file descriptors. - fd_space_size The size of the file descriptor buffer. A file descriptor normally is around 32 bytes depending on the build config - the bigger the buffer, the more file descriptors are available. - cache A ram memory buffer used for cache. Ignored if cache is disabled in build config. - cache_size The size of the cache buffer. Ignored if cache is disabled in build config. One cache page will be slightly larger than the logical page size. The more ram, the more cache pages, the quicker the system. - check_cb_f Callback function for monitoring spiffs consistency checks and mending operations. May be null. The config struct must be initialized prior to mounting. One must always define the SPI flash access functions: spiffs_config.hal_read_f - pointing to the function reading the SPI flash spiffs_config.hal_write_f - pointing to the function writing the SPI flash spiffs_config.hal_erase_f - pointing to the function erasing the SPI flash Depending on the build config - if SPIFFS_SINGLETON is set to zero - following parameters must be defined: spiffs_config.phys_size - the physical number of bytes accounted for spiffs on the SPI flash spiffs_config.phys_addr - the physical starting address on the SPI flash spiffs_config.phys_erase_block - the physical size of the largest block/sector on the SPI flash found within the spiffs usage address space spiffs_config.log_block_size - the logical size of a spiffs block spiffs_config.log_page_size - the logical size of a spiffs page If SPIFFS_SINGLETON is set to one, above parameters must be set ny defines in the config header file, spiffs_config.h. ** Build config makefile: The files needed to be compiled to your target resides in files.mk to be included in your makefile, either by cut and paste or by inclusion. Types: spiffs uses the types u8_t, s8_t, u16_t, s16_t, u32_t, s32_t; these must be typedeffed. spiffs_config.h: you also need to define a spiffs_config.h header. Example of this is found in the default/ directory. ** RAM Spiffs needs ram. It needs a working buffer being double the size of the logical page size. It also needs at least one file descriptor. If cache is enabled (highly recommended), it will also need a bunch of cache pages. Say you have a logical page size of 256 bytes. You want to be able to have four files open simultaneously, and you can give spiffs four cache pages. This roughly sums up to: 256*2 (work buffer) + 32*4 (file descriptors) + (256+32)*4 (cache pages) + 40 (cache metadata) i.e. 1832 bytes. This is apart from call stack usage. To get the exact amount of bytes needed on your specific target, enable SPIFFS_BUFFER_HELP in spiffs_config.h, rebuild and call: SPIFFS_buffer_bytes_for_filedescs SPIFFS_buffer_bytes_for_cache Having these figures you can disable SPIFFS_BUFFER_HELP again to save flash. * HOW TO CONFIG TODO ================================================ FILE: app/spiffs/docs/TECH_SPEC ================================================ * USING SPIFFS TODO * SPIFFS DESIGN Spiffs is inspired by YAFFS. However, YAFFS is designed for NAND flashes, and for bigger targets with much more ram. Nevertheless, many wise thoughts have been borrowed from YAFFS when writing spiffs. Kudos! The main complication writing spiffs was that it cannot be assumed the target has a heap. Spiffs must go along only with the work ram buffer given to it. This forces extra implementation on many areas of spiffs. ** SPI flash devices using NOR technology Below is a small description of how SPI flashes work internally. This is to give an understanding of the design choices made in spiffs. SPI flash devices are physically divided in blocks. On some SPI flash devices, blocks are further divided into sectors. Datasheets sometimes name blocks as sectors and vice versa. Common memory capacaties for SPI flashes are 512kB up to 8MB of data, where blocks may be 64kB. Sectors can be e.g. 4kB, if supported. Many SPI flashes have uniform block sizes, whereas others have non-uniform - the latter meaning that e.g. the first 16 blocks are 4kB big, and the rest are 64kB. The entire memory is linear and can be read and written in random access. Erasing can only be done block- or sectorwise; or by mass erase. SPI flashes can normally be erased from 100.000 up to 1.000.000 cycles before they fail. A clean SPI flash from factory have all bits in entire memory set to one. A mass erase will reset the device to this state. Block or sector erasing will put the all bits in the area given by the sector or block to ones. Writing to a NOR flash pulls ones to zeroes. Writing 0xFF to an address is simply a no-op. Writing 0b10101010 to a flash address holding 0b00001111 will yield 0b00001010. This way of "write by nand" is used considerably in spiffs. Common characteristics of NOR flashes are quick reads, but slow writes. And finally, unlike NAND flashes, NOR flashes seem to not need any error correction. They always write correctly I gather. ** Spiffs logical structure Some terminology before proceeding. Physical blocks/sectors means sizes stated in the datasheet. Logical blocks and pages is something the integrator choose. ** Blocks and pages Spiffs is allocated to a part or all of the memory of the SPI flash device. This area is divided into logical blocks, which in turn are divided into logical pages. The boundary of a logical block must coincide with one or more physical blocks. The sizes for logical blocks and logical pages always remain the same, they are uniform. Example: non-uniform flash mapped to spiffs with 128kB logical blocks PHYSICAL FLASH BLOCKS SPIFFS LOGICAL BLOCKS: 128kB +-----------------------+ - - - +-----------------------+ | Block 1 : 16kB | | Block 1 : 128kB | +-----------------------+ | | | Block 2 : 16kB | | | +-----------------------+ | | | Block 3 : 16kB | | | +-----------------------+ | | | Block 4 : 16kB | | | +-----------------------+ | | | Block 5 : 64kB | | | +-----------------------+ - - - +-----------------------+ | Block 6 : 64kB | | Block 2 : 128kB | +-----------------------+ | | | Block 7 : 64kB | | | +-----------------------+ - - - +-----------------------+ | Block 8 : 64kB | | Block 3 : 128kB | +-----------------------+ | | | Block 9 : 64kB | | | +-----------------------+ - - - +-----------------------+ | ... | | ... | A logical block is divided further into a number of logical pages. A page defines the smallest data holding element known to spiffs. Hence, if a file is created being one byte big, it will occupy one page for index and one page for data - it will occupy 2 x size of a logical page on flash. So it seems it is good to select a small page size. Each page has a metadata header being normally 5 to 9 bytes. This said, a very small page size will make metadata occupy a lot of the memory on the flash. A page size of 64 bytes will waste 8-14% on metadata, while 256 bytes 2-4%. So it seems it is good to select a big page size. Also, spiffs uses a ram buffer being two times the page size. This ram buffer is used for loading and manipulating pages, but it is also used for algorithms to find free file ids, scanning the file system, etc. Having too small a page size means less work buffer for spiffs, ending up in more reads operations and eventually gives a slower file system. Choosing the page size for the system involves many factors: - How big is the logical block size - What is the normal size of most files - How much ram can be spent - How much data (vs metadata) must be crammed into the file system - How fast must spiffs be - Other things impossible to find out So, chosing the Optimal Page Size (tm) seems tricky, to say the least. Don't fret - there is no optimal page size. This varies from how the target will use spiffs. Use the golden rule: ~~~ Logical Page Size = Logical Block Size / 256 ~~~ This is a good starting point. The final page size can then be derived through heuristical experimenting for us non-analytical minds. ** Objects, indices and look-ups A file, or an object as called in spiffs, is identified by an object id. Another YAFFS rip-off. This object id is a part of the page header. So, all pages know to which object/file they belong - not counting the free pages. An object is made up of two types of pages: object index pages and data pages. Data pages contain the data written by user. Index pages contain metadata about the object, more specifically what data pages are part of the object. The page header also includes something called a span index. Let's say a file is written covering three data pages. The first data page will then have span index 0, the second span index 1, and the last data page will have span index 2. Simple as that. Finally, each page header contain flags, telling if the page is used, deleted, finalized, holds index or data, and more. Object indices also have span indices, where an object index with span index 0 is referred to as the object index header. This page does not only contain references to data pages, but also extra info such as object name, object size in bytes, flags for file or directory, etc. If one were to create a file covering three data pages, named e.g. "spandex-joke.txt", given object id 12, it could look like this: PAGE 0 PAGE 1 page header: [obj_id:12 span_ix:0 flags:USED|DATA] PAGE 2 page header: [obj_id:12 span_ix:1 flags:USED|DATA] PAGE 3 page header: [obj_id:545 span_ix:13 flags:USED|DATA] PAGE 4 page header: [obj_id:12 span_ix:2 flags:USED|DATA] PAGE 5 page header: [obj_id:12 span_ix:0 flags:USED|INDEX] obj ix header: [name:spandex-joke.txt size:600 bytes flags:FILE] obj ix: [1 2 4] Looking in detail at page 5, the object index header page, the object index array refers to each data page in order, as mentioned before. The index of the object index array correlates with the data page span index. entry ix: 0 1 2 obj ix: [1 2 4] | | | PAGE 1, DATA, SPAN_IX 0 --------/ | | PAGE 2, DATA, SPAN_IX 1 --------/ | PAGE 4, DATA, SPAN_IX 2 --------/ Things to be unveiled in page 0 - well.. Spiffs is designed for systems low on ram. We cannot keep a dynamic list on the whereabouts of each object index header so we can find a file fast. There might not even be a heap! But, we do not want to scan all page headers on the flash to find the object index header. The first page(s) of each block contains the so called object look-up. These are not normal pages, they do not have a header. Instead, they are arrays pointing out what object-id the rest of all pages in the block belongs to. By this look-up, only the first page(s) in each block must to scanned to find the actual page which contains the object index header of the desired object. The object lookup is redundant metadata. The assumption is that it presents less overhead reading a full page of data to memory from each block and search that, instead of reading a small amount of data from each page (i.e. the page header) in all blocks. Each read operation from SPI flash normally contains extra data as the read command itself and the flash address. Also, depending on the underlying implementation, other criterions may need to be passed for each read transaction, like mutexes and such. The veiled example unveiled would look like this, with some extra pages: PAGE 0 [ 12 12 545 12 12 34 34 4 0 0 0 0 ...] PAGE 1 page header: [obj_id:12 span_ix:0 flags:USED|DATA] ... PAGE 2 page header: [obj_id:12 span_ix:1 flags:USED|DATA] ... PAGE 3 page header: [obj_id:545 span_ix:13 flags:USED|DATA] ... PAGE 4 page header: [obj_id:12 span_ix:2 flags:USED|DATA] ... PAGE 5 page header: [obj_id:12 span_ix:0 flags:USED|INDEX] ... PAGE 6 page header: [obj_id:34 span_ix:0 flags:USED|DATA] ... PAGE 7 page header: [obj_id:34 span_ix:1 flags:USED|DATA] ... PAGE 8 page header: [obj_id:4 span_ix:1 flags:USED|INDEX] ... PAGE 9 page header: [obj_id:23 span_ix:0 flags:DELETED|INDEX] ... PAGE 10 page header: [obj_id:23 span_ix:0 flags:DELETED|DATA] ... PAGE 11 page header: [obj_id:23 span_ix:1 flags:DELETED|DATA] ... PAGE 12 page header: [obj_id:23 span_ix:2 flags:DELETED|DATA] ... ... Ok, so why are page 9 to 12 marked as 0 when they belong to object id 23? These pages are deleted, so this is marked both in page header flags and in the look up. This is an example where spiffs uses NOR flashes "nand-way" of writing. As a matter of fact, there are two object id's which are special: obj id 0 (all bits zeroes) - indicates a deleted page in object look up obj id 0xff.. (all bits ones) - indicates a free page in object look up Actually, the object id's have another quirk: if the most significant bit is set, this indicates an object index page. If the most significant bit is zero, this indicates a data page. So to be fully correct, page 0 in above example would look like this: PAGE 0 [ 12 12 545 12 *12 34 34 *4 0 0 0 0 ...] where the asterisk means the msb of the object id is set. This is another way to speed up the searches when looking for object indices. By looking on the object id's msb in the object lookup, it is also possible to find out whether the page is an object index page or a data page. ================================================ FILE: app/spiffs/docs/TODO ================================================ * When mending lost pages, also see if they fit into length specified in object index header ================================================ FILE: app/spiffs/params_test.h ================================================ /* * params_test.h * * Created on: May 26, 2013 * Author: petera */ #ifndef PARAMS_TEST_H_ #define PARAMS_TEST_H_ // // total emulated spi flash size // #define PHYS_FLASH_SIZE (16*1024*1024) // // spiffs file system size // #define SPIFFS_FLASH_SIZE (2*1024*1024) // // spiffs file system offset in emulated spi flash // #define SPIFFS_PHYS_ADDR (4*1024*1024) // #define SECTOR_SIZE 65536 // #define LOG_BLOCK (SECTOR_SIZE*2) // #define LOG_PAGE (SECTOR_SIZE/256) // #define FD_BUF_SIZE 64*6 // #define CACHE_BUF_SIZE (LOG_PAGE + 32)*8 // #define ASSERT(c, m) real_assert((c),(m), __FILE__, __LINE__); typedef signed int s32_t; typedef unsigned int u32_t; typedef signed short s16_t; typedef unsigned short u16_t; typedef signed char s8_t; typedef unsigned char u8_t; void real_assert(int c, const char *n, const char *file, int l); #endif /* PARAMS_TEST_H_ */ ================================================ FILE: app/spiffs/spiffs.c ================================================ #include "c_stdio.h" #include "platform.h" #include "spiffs.h" spiffs fs; #define LOG_PAGE_SIZE 256 static u8_t spiffs_work_buf[LOG_PAGE_SIZE*2]; static u8_t spiffs_fds[32*4]; static u8_t spiffs_cache[(LOG_PAGE_SIZE+32)*4]; static s32_t my_spiffs_read(u32_t addr, u32_t size, u8_t *dst) { platform_flash_read(dst, addr, size); return SPIFFS_OK; } static s32_t my_spiffs_write(u32_t addr, u32_t size, u8_t *src) { platform_flash_write(src, addr, size); return SPIFFS_OK; } static s32_t my_spiffs_erase(u32_t addr, u32_t size) { u32_t sect_first = platform_flash_get_sector_of_address(addr); u32_t sect_last = sect_first; while( sect_first <= sect_last ) if( platform_flash_erase_sector( sect_first ++ ) == PLATFORM_ERR ) return SPIFFS_ERR_INTERNAL; return SPIFFS_OK; } void myspiffs_check_callback(spiffs_check_type type, spiffs_check_report report, u32_t arg1, u32_t arg2){ // if(SPIFFS_CHECK_PROGRESS == report) return; // NODE_ERR("type: %d, report: %d, arg1: %d, arg2: %d\n", type, report, arg1, arg2); } /******************* The W25Q32BV array is organized into 16,384 programmable pages of 256-bytes each. Up to 256 bytes can be programmed at a time.  Pages can be erased in groups of 16 (4KB sector erase), groups of 128 (32KB block erase), groups of 256 (64KB block erase) or  the entire chip (chip erase). The W25Q32BV has 1,024 erasable sectors and 64 erasable blocks respectively.  The small 4KB sectors allow for greater flexibility in applications that require data and parameter storage.  ********************/ void spiffs_mount() { spiffs_config cfg; cfg.phys_addr = ( u32_t )platform_flash_get_first_free_block_address( NULL ); cfg.phys_addr += 0x3000; cfg.phys_addr &= 0xFFFFC000; // align to 4 sector. cfg.phys_size = INTERNAL_FLASH_SIZE - ( ( u32_t )cfg.phys_addr - INTERNAL_FLASH_START_ADDRESS ); cfg.phys_erase_block = INTERNAL_FLASH_SECTOR_SIZE; // according to datasheet cfg.log_block_size = INTERNAL_FLASH_SECTOR_SIZE; // let us not complicate things cfg.log_page_size = LOG_PAGE_SIZE; // as we said NODE_DBG("fs.start:%x,max:%x",cfg.phys_addr,cfg.phys_size); cfg.hal_read_f = my_spiffs_read; cfg.hal_write_f = my_spiffs_write; cfg.hal_erase_f = my_spiffs_erase; int res = SPIFFS_mount(&fs, &cfg, spiffs_work_buf, spiffs_fds, sizeof(spiffs_fds), spiffs_cache, sizeof(spiffs_cache), // myspiffs_check_callback); 0); NODE_DBG("mount res: %i", res); } // FS formatting function // Returns 1 if OK, 0 for error int myspiffs_format( void ) { SPIFFS_unmount(&fs); u32_t sect_first, sect_last; sect_first = ( u32_t )platform_flash_get_first_free_block_address( NULL ); sect_first += 0x3000; sect_first &= 0xFFFFC000; // align to 4 sector. sect_first = platform_flash_get_sector_of_address(sect_first); sect_last = INTERNAL_FLASH_SIZE + INTERNAL_FLASH_START_ADDRESS - 4; sect_last = platform_flash_get_sector_of_address(sect_last); NODE_DBG("sect_first: %x, sect_last: %x", sect_first, sect_last); while( sect_first <= sect_last ) if( platform_flash_erase_sector( sect_first ++ ) == PLATFORM_ERR ) return 0; spiffs_mount(); return 1; } int myspiffs_check( void ) { // ets_wdt_disable(); // int res = (int)SPIFFS_check(&fs); // ets_wdt_enable(); // return res; } int myspiffs_open(const char *name, int flags){ return (int)SPIFFS_open(&fs, name, (spiffs_flags)flags, 0); } int myspiffs_close( int fd ){ SPIFFS_close(&fs, (spiffs_file)fd); return 0; } size_t myspiffs_write( int fd, const void* ptr, size_t len ){ #if 0 if(fd==c_stdout || fd==c_stderr){ uart0_tx_buffer((u8_t*)ptr, len); return len; } #endif int res = SPIFFS_write(&fs, (spiffs_file)fd, (void *)ptr, len); if (res < 0) { NODE_DBG("write errno %i", SPIFFS_errno(&fs)); return 0; } return res; } size_t myspiffs_read( int fd, void* ptr, size_t len){ int res = SPIFFS_read(&fs, (spiffs_file)fd, ptr, len); if (res < 0) { NODE_DBG("read errno %i", SPIFFS_errno(&fs)); return 0; } return res; } int myspiffs_lseek( int fd, int off, int whence ){ return SPIFFS_lseek(&fs, (spiffs_file)fd, off, whence); } int myspiffs_eof( int fd ){ return SPIFFS_eof(&fs, (spiffs_file)fd); } int myspiffs_tell( int fd ){ return SPIFFS_tell(&fs, (spiffs_file)fd); } int myspiffs_getc( int fd ){ unsigned char c = 0xFF; int res; if(!myspiffs_eof(fd)){ res = SPIFFS_read(&fs, (spiffs_file)fd, &c, 1); if (res != 1) { NODE_DBG("getc errno %i", SPIFFS_errno(&fs)); return (int)EOF; } else { return (int)c; } } return (int)EOF; } int myspiffs_ungetc( int c, int fd ){ return SPIFFS_lseek(&fs, (spiffs_file)fd, -1, SEEK_CUR); } int myspiffs_flush( int fd ){ return SPIFFS_fflush(&fs, (spiffs_file)fd); } int myspiffs_error( int fd ){ return SPIFFS_errno(&fs); } void myspiffs_clearerr( int fd ){ fs.errno = SPIFFS_OK; } #if 0 void test_spiffs() { char buf[12]; // Surely, I've mounted spiffs before entering here spiffs_file fd = SPIFFS_open(&fs, "my_file", SPIFFS_CREAT | SPIFFS_TRUNC | SPIFFS_RDWR, 0); if (SPIFFS_write(&fs, fd, (u8_t *)"Hello world", 12) < 0) NODE_DBG("errno %i", SPIFFS_errno(&fs)); SPIFFS_close(&fs, fd); fd = SPIFFS_open(&fs, "my_file", SPIFFS_RDWR, 0); if (SPIFFS_read(&fs, fd, (u8_t *)buf, 12) < 0) NODE_DBG("errno %i", SPIFFS_errno(&fs)); SPIFFS_close(&fs, fd); NODE_DBG("--> %s <--", buf); } #endif ================================================ FILE: app/spiffs/spiffs.h ================================================ /* * spiffs.h * * Created on: May 26, 2013 * Author: petera */ #ifndef SPIFFS_H_ #define SPIFFS_H_ #include "c_stdio.h" #include "spiffs_config.h" #define SPIFFS_OK 0 #define SPIFFS_ERR_NOT_MOUNTED -10000 #define SPIFFS_ERR_FULL -10001 #define SPIFFS_ERR_NOT_FOUND -10002 #define SPIFFS_ERR_END_OF_OBJECT -10003 #define SPIFFS_ERR_DELETED -10004 #define SPIFFS_ERR_NOT_FINALIZED -10005 #define SPIFFS_ERR_NOT_INDEX -10006 #define SPIFFS_ERR_OUT_OF_FILE_DESCS -10007 #define SPIFFS_ERR_FILE_CLOSED -10008 #define SPIFFS_ERR_FILE_DELETED -10009 #define SPIFFS_ERR_BAD_DESCRIPTOR -10010 #define SPIFFS_ERR_IS_INDEX -10011 #define SPIFFS_ERR_IS_FREE -10012 #define SPIFFS_ERR_INDEX_SPAN_MISMATCH -10013 #define SPIFFS_ERR_DATA_SPAN_MISMATCH -10014 #define SPIFFS_ERR_INDEX_REF_FREE -10015 #define SPIFFS_ERR_INDEX_REF_LU -10016 #define SPIFFS_ERR_INDEX_REF_INVALID -10017 #define SPIFFS_ERR_INDEX_FREE -10018 #define SPIFFS_ERR_INDEX_LU -10019 #define SPIFFS_ERR_INDEX_INVALID -10020 #define SPIFFS_ERR_NOT_WRITABLE -10021 #define SPIFFS_ERR_NOT_READABLE -10022 #define SPIFFS_ERR_INTERNAL -10050 #define SPIFFS_ERR_TEST -10100 // spiffs file descriptor index type. must be signed typedef s16_t spiffs_file; // spiffs file descriptor flags typedef u16_t spiffs_flags; // spiffs file mode typedef u16_t spiffs_mode; // object type typedef u8_t spiffs_obj_type; /* spi read call function type */ typedef s32_t (*spiffs_read)(u32_t addr, u32_t size, u8_t *dst); /* spi write call function type */ typedef s32_t (*spiffs_write)(u32_t addr, u32_t size, u8_t *src); /* spi erase call function type */ typedef s32_t (*spiffs_erase)(u32_t addr, u32_t size); /* file system check callback report operation */ typedef enum { SPIFFS_CHECK_LOOKUP = 0, SPIFFS_CHECK_INDEX, SPIFFS_CHECK_PAGE } spiffs_check_type; /* file system check callback report type */ typedef enum { SPIFFS_CHECK_PROGRESS = 0, SPIFFS_CHECK_ERROR, SPIFFS_CHECK_FIX_INDEX, SPIFFS_CHECK_FIX_LOOKUP, SPIFFS_CHECK_DELETE_ORPHANED_INDEX, SPIFFS_CHECK_DELETE_PAGE, SPIFFS_CHECK_DELETE_BAD_FILE, } spiffs_check_report; /* file system check callback function */ typedef void (*spiffs_check_callback)(spiffs_check_type type, spiffs_check_report report, u32_t arg1, u32_t arg2); #ifndef SPIFFS_DBG #define SPIFFS_DBG(...) \ print(__VA_ARGS__) #endif #ifndef SPIFFS_GC_DBG #define SPIFFS_GC_DBG(...) printf(__VA_ARGS__) #endif #ifndef SPIFFS_CACHE_DBG #define SPIFFS_CACHE_DBG(...) printf(__VA_ARGS__) #endif #ifndef SPIFFS_CHECK_DBG #define SPIFFS_CHECK_DBG(...) printf(__VA_ARGS__) #endif /* Any write to the filehandle is appended to end of the file */ #define SPIFFS_APPEND (1<<0) /* If the opened file exists, it will be truncated to zero length before opened */ #define SPIFFS_TRUNC (1<<1) /* If the opened file does not exist, it will be created before opened */ #define SPIFFS_CREAT (1<<2) /* The opened file may only be read */ #define SPIFFS_RDONLY (1<<3) /* The opened file may only be writted */ #define SPIFFS_WRONLY (1<<4) /* The opened file may be both read and writted */ #define SPIFFS_RDWR (SPIFFS_RDONLY | SPIFFS_WRONLY) /* Any writes to the filehandle will never be cached */ #define SPIFFS_DIRECT (1<<5) #define SPIFFS_SEEK_SET (0) #define SPIFFS_SEEK_CUR (1) #define SPIFFS_SEEK_END (2) #define SPIFFS_TYPE_FILE (1) #define SPIFFS_TYPE_DIR (2) #define SPIFFS_TYPE_HARD_LINK (3) #define SPIFFS_TYPE_SOFT_LINK (4) #ifndef SPIFFS_LOCK #define SPIFFS_LOCK(fs) #endif #ifndef SPIFFS_UNLOCK #define SPIFFS_UNLOCK(fs) #endif // phys structs // spiffs spi configuration struct typedef struct { // physical read function spiffs_read hal_read_f; // physical write function spiffs_write hal_write_f; // physical erase function spiffs_erase hal_erase_f; #if SPIFFS_SINGLETON == 0 // physical size of the spi flash u32_t phys_size; // physical offset in spi flash used for spiffs, // must be on block boundary u32_t phys_addr; // physical size when erasing a block u32_t phys_erase_block; // logical size of a block, must be on physical // block size boundary and must never be less than // a physical block u32_t log_block_size; // logical size of a page, must be at least // log_block_size / 8 u32_t log_page_size; #endif } spiffs_config; typedef struct { // file system configuration spiffs_config cfg; // number of logical blocks u32_t block_count; // cursor for free blocks, block index spiffs_block_ix free_cursor_block_ix; // cursor for free blocks, entry index int free_cursor_obj_lu_entry; // cursor when searching, block index spiffs_block_ix cursor_block_ix; // cursor when searching, entry index int cursor_obj_lu_entry; // primary work buffer, size of a logical page u8_t *lu_work; // secondary work buffer, size of a logical page u8_t *work; // file descriptor memory area u8_t *fd_space; // available file descriptors u32_t fd_count; // last error s32_t errno; // current number of free blocks u32_t free_blocks; // current number of busy pages u32_t stats_p_allocated; // current number of deleted pages u32_t stats_p_deleted; // flag indicating that garbage collector is cleaning u8_t cleaning; // max erase count amongst all blocks spiffs_obj_id max_erase_count; #if SPIFFS_GC_STATS u32_t stats_gc_runs; #endif #if SPIFFS_CACHE // cache memory void *cache; // cache size u32_t cache_size; #if SPIFFS_CACHE_STATS u32_t cache_hits; u32_t cache_misses; #endif #endif // check callback function spiffs_check_callback check_cb_f; } spiffs; /* spiffs file status struct */ typedef struct { spiffs_obj_id obj_id; u32_t size; spiffs_obj_type type; u8_t name[SPIFFS_OBJ_NAME_LEN]; } spiffs_stat; struct spiffs_dirent { spiffs_obj_id obj_id; u8_t name[SPIFFS_OBJ_NAME_LEN]; spiffs_obj_type type; u32_t size; }; typedef struct { spiffs *fs; spiffs_block_ix block; int entry; } spiffs_DIR; // functions /** * Initializes the file system dynamic parameters and mounts the filesystem * @param fs the file system struct * @param config the physical and logical configuration of the file system * @param work a memory work buffer comprising 2*config->log_page_size * bytes used throughout all file system operations * @param fd_space memory for file descriptors * @param fd_space_size memory size of file descriptors * @param cache memory for cache, may be null * @param cache_size memory size of cache * @param check_cb_f callback function for reporting during consistency checks */ s32_t SPIFFS_mount(spiffs *fs, spiffs_config *config, u8_t *work, u8_t *fd_space, u32_t fd_space_size, void *cache, u32_t cache_size, spiffs_check_callback check_cb_f); /** * Unmounts the file system. All file handles will be flushed of any * cached writes and closed. * @param fs the file system struct */ void SPIFFS_unmount(spiffs *fs); /** * Creates a new file. * @param fs the file system struct * @param path the path of the new file * @param mode ignored, for posix compliance */ s32_t SPIFFS_creat(spiffs *fs, const char *path, spiffs_mode mode); /** * Opens/creates a file. * @param fs the file system struct * @param path the path of the new file * @param flags the flags for the open command, can be combinations of * SPIFFS_APPEND, SPIFFS_TRUNC, SPIFFS_CREAT, SPIFFS_RD_ONLY, * SPIFFS_WR_ONLY, SPIFFS_RDWR, SPIFFS_DIRECT * @param mode ignored, for posix compliance */ spiffs_file SPIFFS_open(spiffs *fs, const char *path, spiffs_flags flags, spiffs_mode mode); /** * Reads from given filehandle. * @param fs the file system struct * @param fh the filehandle * @param buf where to put read data * @param len how much to read * @returns number of bytes read, or -1 if error */ s32_t SPIFFS_read(spiffs *fs, spiffs_file fh, void *buf, u32_t len); /** * Writes to given filehandle. * @param fs the file system struct * @param fh the filehandle * @param buf the data to write * @param len how much to write * @returns number of bytes written, or -1 if error */ s32_t SPIFFS_write(spiffs *fs, spiffs_file fh, void *buf, u32_t len); /** * Moves the read/write file offset * @param fs the file system struct * @param fh the filehandle * @param offs how much/where to move the offset * @param whence if SPIFFS_SEEK_SET, the file offset shall be set to offset bytes * if SPIFFS_SEEK_CUR, the file offset shall be set to its current location plus offset * if SPIFFS_SEEK_END, the file offset shall be set to the size of the file plus offset */ s32_t SPIFFS_lseek(spiffs *fs, spiffs_file fh, s32_t offs, int whence); /** * Removes a file by path * @param fs the file system struct * @param path the path of the file to remove */ s32_t SPIFFS_remove(spiffs *fs, const char *path); /** * Removes a file by filehandle * @param fs the file system struct * @param fh the filehandle of the file to remove */ s32_t SPIFFS_fremove(spiffs *fs, spiffs_file fh); /** * Gets file status by path * @param fs the file system struct * @param path the path of the file to stat * @param s the stat struct to populate */ s32_t SPIFFS_stat(spiffs *fs, const char *path, spiffs_stat *s); /** * Gets file status by filehandle * @param fs the file system struct * @param fh the filehandle of the file to stat * @param s the stat struct to populate */ s32_t SPIFFS_fstat(spiffs *fs, spiffs_file fh, spiffs_stat *s); /** * Flushes all pending write operations from cache for given file * @param fs the file system struct * @param fh the filehandle of the file to flush */ s32_t SPIFFS_fflush(spiffs *fs, spiffs_file fh); /** * Closes a filehandle. If there are pending write operations, these are finalized before closing. * @param fs the file system struct * @param fh the filehandle of the file to close */ void SPIFFS_close(spiffs *fs, spiffs_file fh); /** * Returns last error of last file operation. * @param fs the file system struct */ s32_t SPIFFS_errno(spiffs *fs); /** * Opens a directory stream corresponding to the given name. * The stream is positioned at the first entry in the directory. * On hydrogen builds the name argument is ignored as hydrogen builds always correspond * to a flat file structure - no directories. * @param fs the file system struct * @param name the name of the directory * @param d pointer the directory stream to be populated */ spiffs_DIR *SPIFFS_opendir(spiffs *fs, const char *name, spiffs_DIR *d); /** * Closes a directory stream * @param d the directory stream to close */ s32_t SPIFFS_closedir(spiffs_DIR *d); /** * Reads a directory into given spifs_dirent struct. * @param d pointer to the directory stream * @param e the dirent struct to be populated * @returns null if error or end of stream, else given dirent is returned */ struct spiffs_dirent *SPIFFS_readdir(spiffs_DIR *d, struct spiffs_dirent *e); /** * Runs a consistency check on given filesystem. * @param fs the file system struct */ s32_t SPIFFS_check(spiffs *fs); /** * Check if EOF reached. * @param fs the file system struct * @param fh the filehandle of the file to check */ s32_t SPIFFS_eof(spiffs *fs, spiffs_file fh); s32_t SPIFFS_tell(spiffs *fs, spiffs_file fh); #if SPIFFS_TEST_VISUALISATION /** * Prints out a visualization of the filesystem. * @param fs the file system struct */ s32_t SPIFFS_vis(spiffs *fs); #endif #if SPIFFS_BUFFER_HELP /** * Returns number of bytes needed for the filedescriptor buffer given * amount of file descriptors. */ u32_t SPIFFS_buffer_bytes_for_filedescs(spiffs *fs, u32_t num_descs); #if SPIFFS_CACHE /** * Returns number of bytes needed for the cache buffer given * amount of cache pages. */ u32_t SPIFFS_buffer_bytes_for_cache(spiffs *fs, u32_t num_pages); #endif #endif #if SPIFFS_CACHE #endif int myspiffs_open(const char *name, int flags); int myspiffs_close( int fd ); size_t myspiffs_write( int fd, const void* ptr, size_t len ); size_t myspiffs_read( int fd, void* ptr, size_t len); int myspiffs_lseek( int fd, int off, int whence ); int myspiffs_eof( int fd ); int myspiffs_tell( int fd ); int myspiffs_getc( int fd ); int myspiffs_ungetc( int c, int fd ); int myspiffs_flush( int fd ); int myspiffs_error( int fd ); void myspiffs_clearerr( int fd ); int myspiffs_check( void ); #endif /* SPIFFS_H_ */ ================================================ FILE: app/spiffs/spiffs_cache.c ================================================ /* * spiffs_cache.c * * Created on: Jun 23, 2013 * Author: petera */ #include "spiffs.h" #include "spiffs_nucleus.h" #if SPIFFS_CACHE // returns cached page for give page index, or null if no such cached page static spiffs_cache_page *spiffs_cache_page_get(spiffs *fs, spiffs_page_ix pix) { spiffs_cache *cache = spiffs_get_cache(fs); if ((cache->cpage_use_map & cache->cpage_use_mask) == 0) return 0; int i; for (i = 0; i < cache->cpage_count; i++) { spiffs_cache_page *cp = spiffs_get_cache_page_hdr(fs, cache, i); if ((cache->cpage_use_map & (1<flags & SPIFFS_CACHE_FLAG_TYPE_WR) == 0 && cp->pix == pix ) { SPIFFS_CACHE_DBG("CACHE_GET: have cache page %i for %04x\n", i, pix); cp->last_access = cache->last_access; return cp; } } //SPIFFS_CACHE_DBG("CACHE_GET: no cache for %04x\n", pix); return 0; } // frees cached page static s32_t spiffs_cache_page_free(spiffs *fs, int ix, u8_t write_back) { s32_t res = SPIFFS_OK; spiffs_cache *cache = spiffs_get_cache(fs); spiffs_cache_page *cp = spiffs_get_cache_page_hdr(fs, cache, ix); if (cache->cpage_use_map & (1<flags & SPIFFS_CACHE_FLAG_TYPE_WR) == 0 && (cp->flags & SPIFFS_CACHE_FLAG_DIRTY)) { u8_t *mem = spiffs_get_cache_page(fs, cache, ix); res = fs->cfg.hal_write_f(SPIFFS_PAGE_TO_PADDR(fs, cp->pix), SPIFFS_CFG_LOG_PAGE_SZ(fs), mem); } cp->flags = 0; cache->cpage_use_map &= ~(1 << ix); if (cp->flags & SPIFFS_CACHE_FLAG_TYPE_WR) { SPIFFS_CACHE_DBG("CACHE_FREE: free cache page %i objid %04x\n", ix, cp->obj_id); } else { SPIFFS_CACHE_DBG("CACHE_FREE: free cache page %i pix %04x\n", ix, cp->pix); } } return res; } // removes the oldest accessed cached page static s32_t spiffs_cache_page_remove_oldest(spiffs *fs, u8_t flag_mask, u8_t flags) { s32_t res = SPIFFS_OK; spiffs_cache *cache = spiffs_get_cache(fs); if ((cache->cpage_use_map & cache->cpage_use_mask) != cache->cpage_use_mask) { // at least one free cpage return SPIFFS_OK; } // all busy, scan thru all to find the cpage which has oldest access int i; int cand_ix = -1; u32_t oldest_val = 0; for (i = 0; i < cache->cpage_count; i++) { spiffs_cache_page *cp = spiffs_get_cache_page_hdr(fs, cache, i); if ((cache->last_access - cp->last_access) > oldest_val && (cp->flags & flag_mask) == flags) { oldest_val = cache->last_access - cp->last_access; cand_ix = i; } } if (cand_ix >= 0) { res = spiffs_cache_page_free(fs, cand_ix, 1); } return res; } // allocates a new cached page and returns it, or null if all cache pages are busy static spiffs_cache_page *spiffs_cache_page_allocate(spiffs *fs) { spiffs_cache *cache = spiffs_get_cache(fs); if (cache->cpage_use_map == 0xffffffff) { // out of cache memory return 0; } int i; for (i = 0; i < cache->cpage_count; i++) { if ((cache->cpage_use_map & (1<cpage_use_map |= (1<last_access = cache->last_access; SPIFFS_CACHE_DBG("CACHE_ALLO: allocated cache page %i\n", i); return cp; } } // out of cache entries return 0; } // drops the cache page for give page index void spiffs_cache_drop_page(spiffs *fs, spiffs_page_ix pix) { spiffs_cache_page *cp = spiffs_cache_page_get(fs, pix); if (cp) { spiffs_cache_page_free(fs, cp->ix, 0); } } // ------------------------------ // reads from spi flash or the cache s32_t spiffs_phys_rd( spiffs *fs, u8_t op, spiffs_file fh, u32_t addr, u32_t len, u8_t *dst) { s32_t res = SPIFFS_OK; spiffs_cache *cache = spiffs_get_cache(fs); spiffs_cache_page *cp = spiffs_cache_page_get(fs, SPIFFS_PADDR_TO_PAGE(fs, addr)); cache->last_access++; if (cp) { #if SPIFFS_CACHE_STATS fs->cache_hits++; #endif cp->last_access = cache->last_access; } else { if ((op & SPIFFS_OP_TYPE_MASK) == SPIFFS_OP_T_OBJ_LU2) { // for second layer lookup functions, we do not cache in order to prevent shredding return fs->cfg.hal_read_f( addr , len, dst); } #if SPIFFS_CACHE_STATS fs->cache_misses++; #endif res = spiffs_cache_page_remove_oldest(fs, SPIFFS_CACHE_FLAG_TYPE_WR, 0); cp = spiffs_cache_page_allocate(fs); if (cp) { cp->flags = SPIFFS_CACHE_FLAG_WRTHRU; cp->pix = SPIFFS_PADDR_TO_PAGE(fs, addr); } s32_t res2 = fs->cfg.hal_read_f( addr - SPIFFS_PADDR_TO_PAGE_OFFSET(fs, addr), SPIFFS_CFG_LOG_PAGE_SZ(fs), spiffs_get_cache_page(fs, cache, cp->ix)); if (res2 != SPIFFS_OK) { res = res2; } } u8_t *mem = spiffs_get_cache_page(fs, cache, cp->ix); c_memcpy(dst, &mem[SPIFFS_PADDR_TO_PAGE_OFFSET(fs, addr)], len); return res; } // writes to spi flash and/or the cache s32_t spiffs_phys_wr( spiffs *fs, u8_t op, spiffs_file fh, u32_t addr, u32_t len, u8_t *src) { spiffs_page_ix pix = SPIFFS_PADDR_TO_PAGE(fs, addr); spiffs_cache *cache = spiffs_get_cache(fs); spiffs_cache_page *cp = spiffs_cache_page_get(fs, pix); if (cp && (op & SPIFFS_OP_COM_MASK) != SPIFFS_OP_C_WRTHRU) { // have a cache page // copy in data to cache page if ((op & SPIFFS_OP_COM_MASK) == SPIFFS_OP_C_DELE && (op & SPIFFS_OP_TYPE_MASK) != SPIFFS_OP_T_OBJ_LU) { // page is being deleted, wipe from cache - unless it is a lookup page spiffs_cache_page_free(fs, cp->ix, 0); return fs->cfg.hal_write_f(addr, len, src); } u8_t *mem = spiffs_get_cache_page(fs, cache, cp->ix); c_memcpy(&mem[SPIFFS_PADDR_TO_PAGE_OFFSET(fs, addr)], src, len); cache->last_access++; cp->last_access = cache->last_access; if (cp->flags && SPIFFS_CACHE_FLAG_WRTHRU) { // page is being updated, no write-cache, just pass thru return fs->cfg.hal_write_f(addr, len, src); } else { return SPIFFS_OK; } } else { // no cache page, no write cache - just write thru return fs->cfg.hal_write_f(addr, len, src); } } #if SPIFFS_CACHE_WR // returns the cache page that this fd refers, or null if no cache page spiffs_cache_page *spiffs_cache_page_get_by_fd(spiffs *fs, spiffs_fd *fd) { spiffs_cache *cache = spiffs_get_cache(fs); if ((cache->cpage_use_map & cache->cpage_use_mask) == 0) { // all cpages free, no cpage cannot be assigned to obj_id return 0; } int i; for (i = 0; i < cache->cpage_count; i++) { spiffs_cache_page *cp = spiffs_get_cache_page_hdr(fs, cache, i); if ((cache->cpage_use_map & (1<flags & SPIFFS_CACHE_FLAG_TYPE_WR) && cp->obj_id == fd->obj_id) { return cp; } } return 0; } // allocates a new cache page and refers this to given fd - flushes an old cache // page if all cache is busy spiffs_cache_page *spiffs_cache_page_allocate_by_fd(spiffs *fs, spiffs_fd *fd) { // before this function is called, it is ensured that there is no already existing // cache page with same object id spiffs_cache_page_remove_oldest(fs, SPIFFS_CACHE_FLAG_TYPE_WR, 0); spiffs_cache_page *cp = spiffs_cache_page_allocate(fs); if (cp == 0) { // could not get cache page return 0; } cp->flags = SPIFFS_CACHE_FLAG_TYPE_WR; cp->obj_id = fd->obj_id; fd->cache_page = cp; return cp; } // unrefers all fds that this cache page refers to and releases the cache page void spiffs_cache_fd_release(spiffs *fs, spiffs_cache_page *cp) { if (cp == 0) return; int i; spiffs_fd *fds = (spiffs_fd *)fs->fd_space; for (i = 0; i < fs->fd_count; i++) { spiffs_fd *cur_fd = &fds[i]; if (cur_fd->file_nbr != 0 && cur_fd->cache_page == cp) { cur_fd->cache_page = 0; } } spiffs_cache_page_free(fs, cp->ix, 0); cp->obj_id = 0; } #endif // initializes the cache void spiffs_cache_init(spiffs *fs) { if (fs->cache == 0) return; u32_t sz = fs->cache_size; u32_t cache_mask = 0; int i; int cache_entries = (sz - sizeof(spiffs_cache)) / (SPIFFS_CACHE_PAGE_SIZE(fs)); if (cache_entries <= 0) return; for (i = 0; i < cache_entries; i++) { cache_mask <<= 1; cache_mask |= 1; } spiffs_cache cache; c_memset(&cache, 0, sizeof(spiffs_cache)); cache.cpage_count = cache_entries; cache.cpages = (u8_t *)(fs->cache) + sizeof(spiffs_cache); cache.cpage_use_map = 0xffffffff; cache.cpage_use_mask = cache_mask; c_memcpy(fs->cache, &cache, sizeof(spiffs_cache)); spiffs_cache *c = spiffs_get_cache(fs); c_memset(c->cpages, 0, c->cpage_count * SPIFFS_CACHE_PAGE_SIZE(fs)); c->cpage_use_map &= ~(c->cpage_use_mask); for (i = 0; i < cache.cpage_count; i++) { spiffs_get_cache_page_hdr(fs, c, i)->ix = i; } } #endif // SPIFFS_CACHE ================================================ FILE: app/spiffs/spiffs_check.c ================================================ /* * spiffs_check.c * * Contains functionality for checking file system consistency * and mending problems. * Three levels of consistency checks are implemented: * * Look up consistency * Checks if indices in lookup pages are coherent with page headers * Object index consistency * Checks if there are any orphaned object indices (missing object index headers). * If an object index is found but not its header, the object index is deleted. * This is critical for the following page consistency check. * Page consistency * Checks for pages that ought to be indexed, ought not to be indexed, are multiple indexed * * * Created on: Jul 7, 2013 * Author: petera */ #include "spiffs.h" #include "spiffs_nucleus.h" //--------------------------------------- // Look up consistency // searches in the object indices and returns the referenced page index given // the object id and the data span index // destroys fs->lu_work static s32_t spiffs_object_get_data_page_index_reference( spiffs *fs, spiffs_obj_id obj_id, spiffs_span_ix data_spix, spiffs_page_ix *pix, spiffs_page_ix *objix_pix) { s32_t res; // calculate object index span index for given data page span index spiffs_span_ix objix_spix = SPIFFS_OBJ_IX_ENTRY_SPAN_IX(fs, data_spix); // find obj index for obj id and span index res = spiffs_obj_lu_find_id_and_span(fs, obj_id | SPIFFS_OBJ_ID_IX_FLAG, objix_spix, 0, objix_pix); SPIFFS_CHECK_RES(res); // load obj index entry u32_t addr = SPIFFS_PAGE_TO_PADDR(fs, *objix_pix); if (objix_spix == 0) { // get referenced page from object index header addr += sizeof(spiffs_page_object_ix_header) + data_spix * sizeof(spiffs_page_ix); } else { // get referenced page from object index addr += sizeof(spiffs_page_object_ix) + SPIFFS_OBJ_IX_ENTRY(fs, data_spix) * sizeof(spiffs_page_ix); } res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_LU2 | SPIFFS_OP_C_READ, 0, addr, sizeof(spiffs_page_ix), (u8_t *)pix); return res; } // copies page contents to a new page static s32_t spiffs_rewrite_page(spiffs *fs, spiffs_page_ix cur_pix, spiffs_page_header *p_hdr, spiffs_page_ix *new_pix) { s32_t res; res = spiffs_page_allocate_data(fs, p_hdr->obj_id, p_hdr, 0,0,0,0, new_pix); SPIFFS_CHECK_RES(res); res = spiffs_phys_cpy(fs, 0, SPIFFS_PAGE_TO_PADDR(fs, *new_pix) + sizeof(spiffs_page_header), SPIFFS_PAGE_TO_PADDR(fs, cur_pix) + sizeof(spiffs_page_header), SPIFFS_DATA_PAGE_SIZE(fs)); SPIFFS_CHECK_RES(res); return res; } // rewrites the object index for given object id and replaces the // data page index to a new page index static s32_t spiffs_rewrite_index(spiffs *fs, spiffs_obj_id obj_id, spiffs_span_ix data_spix, spiffs_page_ix new_data_pix, spiffs_page_ix objix_pix) { s32_t res; spiffs_block_ix bix; int entry; spiffs_page_ix free_pix; obj_id |= SPIFFS_OBJ_ID_IX_FLAG; // find free entry res = spiffs_obj_lu_find_free(fs, fs->free_cursor_block_ix, fs->free_cursor_obj_lu_entry, &bix, &entry); SPIFFS_CHECK_RES(res); free_pix = SPIFFS_OBJ_LOOKUP_ENTRY_TO_PIX(fs, bix, entry); // calculate object index span index for given data page span index spiffs_span_ix objix_spix = SPIFFS_OBJ_IX_ENTRY_SPAN_IX(fs, data_spix); if (objix_spix == 0) { // calc index in index header entry = data_spix; } else { // calc entry in index entry = SPIFFS_OBJ_IX_ENTRY(fs, data_spix); } // load index res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_LU2 | SPIFFS_OP_C_READ, 0, SPIFFS_PAGE_TO_PADDR(fs, objix_pix), SPIFFS_CFG_LOG_PAGE_SZ(fs), fs->lu_work); SPIFFS_CHECK_RES(res); spiffs_page_header *objix_p_hdr = (spiffs_page_header *)fs->lu_work; // be ultra safe, double check header against provided data if (objix_p_hdr->obj_id != obj_id) { spiffs_page_delete(fs, free_pix); return SPIFFS_ERR_CHECK_OBJ_ID_MISM; } if (objix_p_hdr->span_ix != objix_spix) { spiffs_page_delete(fs, free_pix); return SPIFFS_ERR_CHECK_SPIX_MISM; } if ((objix_p_hdr->flags & (SPIFFS_PH_FLAG_USED | SPIFFS_PH_FLAG_IXDELE | SPIFFS_PH_FLAG_INDEX | SPIFFS_PH_FLAG_FINAL | SPIFFS_PH_FLAG_DELET)) != (SPIFFS_PH_FLAG_IXDELE | SPIFFS_PH_FLAG_DELET)) { spiffs_page_delete(fs, free_pix); return SPIFFS_ERR_CHECK_FLAGS_BAD; } // rewrite in mem if (objix_spix == 0) { ((spiffs_page_ix*)((u8_t *)fs->lu_work + sizeof(spiffs_page_object_ix_header)))[data_spix] = new_data_pix; } else { ((spiffs_page_ix*)((u8_t *)fs->lu_work + sizeof(spiffs_page_object_ix)))[SPIFFS_OBJ_IX_ENTRY(fs, data_spix)] = new_data_pix; } res = _spiffs_wr(fs, SPIFFS_OP_T_OBJ_DA | SPIFFS_OP_C_UPDT, 0, SPIFFS_PAGE_TO_PADDR(fs, free_pix), SPIFFS_CFG_LOG_PAGE_SZ(fs), fs->lu_work); SPIFFS_CHECK_RES(res); res = _spiffs_wr(fs, SPIFFS_OP_T_OBJ_LU | SPIFFS_OP_C_UPDT, 0, SPIFFS_BLOCK_TO_PADDR(fs, SPIFFS_BLOCK_FOR_PAGE(fs, free_pix)) + SPIFFS_OBJ_LOOKUP_ENTRY_FOR_PAGE(fs, free_pix) * sizeof(spiffs_page_ix), sizeof(spiffs_obj_id), (u8_t *)&obj_id); SPIFFS_CHECK_RES(res); res = spiffs_page_delete(fs, objix_pix); return res; } // deletes an object just by marking object index header as deleted static s32_t spiffs_delete_obj_lazy(spiffs *fs, spiffs_obj_id obj_id) { spiffs_page_ix objix_hdr_pix; s32_t res; res = spiffs_obj_lu_find_id_and_span(fs, obj_id, 0, 0, &objix_hdr_pix); if (res == SPIFFS_ERR_NOT_FOUND) { return SPIFFS_OK; } SPIFFS_CHECK_RES(res); u8_t flags = 0xff & ~SPIFFS_PH_FLAG_IXDELE; res = _spiffs_wr(fs, SPIFFS_OP_T_OBJ_LU | SPIFFS_OP_C_UPDT, 0, SPIFFS_PAGE_TO_PADDR(fs, objix_hdr_pix) + offsetof(spiffs_page_header, flags), sizeof(u8_t), (u8_t *)&flags); return res; } // validates the given look up entry static s32_t spiffs_lookup_check_validate(spiffs *fs, spiffs_obj_id lu_obj_id, spiffs_page_header *p_hdr, spiffs_page_ix cur_pix, spiffs_block_ix cur_block, int cur_entry, int *reload_lu) { u8_t delete_page = 0; s32_t res = SPIFFS_OK; spiffs_page_ix objix_pix; spiffs_page_ix ref_pix; // check validity, take actions if (((lu_obj_id == SPIFFS_OBJ_ID_DELETED) && (p_hdr->flags & SPIFFS_PH_FLAG_DELET)) || ((lu_obj_id == SPIFFS_OBJ_ID_FREE) && (p_hdr->flags & SPIFFS_PH_FLAG_USED) == 0)) { // look up entry deleted / free but used in page header SPIFFS_CHECK_DBG("LU: pix %04x deleted/free in lu but not on page\n", cur_pix); *reload_lu = 1; delete_page = 1; if (p_hdr->flags & SPIFFS_PH_FLAG_INDEX) { // header says data page // data page can be removed if not referenced by some object index res = spiffs_object_get_data_page_index_reference(fs, p_hdr->obj_id, p_hdr->span_ix, &ref_pix, &objix_pix); if (res == SPIFFS_ERR_NOT_FOUND) { // no object with this id, so remove page safely res = SPIFFS_OK; } else { SPIFFS_CHECK_RES(res); if (ref_pix == cur_pix) { // data page referenced by object index but deleted in lu // copy page to new place and re-write the object index to new place spiffs_page_ix new_pix; res = spiffs_rewrite_page(fs, cur_pix, p_hdr, &new_pix); SPIFFS_CHECK_DBG("LU: FIXUP: data page not found elsewhere, rewriting %04x to new page %04x\n", cur_pix, new_pix); SPIFFS_CHECK_RES(res); *reload_lu = 1; SPIFFS_CHECK_DBG("LU: FIXUP: %04x rewritten to %04x, affected objix_pix %04x\n", cur_pix, new_pix, objix_pix); res = spiffs_rewrite_index(fs, p_hdr->obj_id, p_hdr->span_ix, new_pix, objix_pix); if (res <= _SPIFFS_ERR_CHECK_FIRST && res > _SPIFFS_ERR_CHECK_LAST) { // index bad also, cannot mend this file SPIFFS_CHECK_DBG("LU: FIXUP: index bad %i, cannot mend!\n", res); res = spiffs_page_delete(fs, new_pix); SPIFFS_CHECK_RES(res); res = spiffs_delete_obj_lazy(fs, p_hdr->obj_id); if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_LOOKUP, SPIFFS_CHECK_DELETE_BAD_FILE, p_hdr->obj_id, 0); } else { if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_LOOKUP, SPIFFS_CHECK_FIX_INDEX, p_hdr->obj_id, p_hdr->span_ix); } SPIFFS_CHECK_RES(res); } } } else { // header says index page // index page can be removed if other index with same obj_id and spanix is found res = spiffs_obj_lu_find_id_and_span(fs, p_hdr->obj_id | SPIFFS_OBJ_ID_IX_FLAG, p_hdr->span_ix, cur_pix, 0); if (res == SPIFFS_ERR_NOT_FOUND) { // no such index page found, check for a data page amongst page headers // lu cannot be trusted res = spiffs_obj_lu_find_id_and_span_by_phdr(fs, p_hdr->obj_id | SPIFFS_OBJ_ID_IX_FLAG, 0, 0, 0); if (res == SPIFFS_OK) { // ignore other errors // got a data page also, assume lu corruption only, rewrite to new page spiffs_page_ix new_pix; res = spiffs_rewrite_page(fs, cur_pix, p_hdr, &new_pix); SPIFFS_CHECK_DBG("LU: FIXUP: ix page with data not found elsewhere, rewriting %04x to new page %04x\n", cur_pix, new_pix); SPIFFS_CHECK_RES(res); *reload_lu = 1; if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_LOOKUP, SPIFFS_CHECK_FIX_LOOKUP, p_hdr->obj_id, p_hdr->span_ix); } } else { SPIFFS_CHECK_RES(res); } } } if (lu_obj_id != SPIFFS_OBJ_ID_FREE && lu_obj_id != SPIFFS_OBJ_ID_DELETED) { // look up entry used if ((p_hdr->obj_id | SPIFFS_OBJ_ID_IX_FLAG) != (lu_obj_id | SPIFFS_OBJ_ID_IX_FLAG)) { SPIFFS_CHECK_DBG("LU: pix %04x differ in obj_id lu:%04x ph:%04x\n", cur_pix, lu_obj_id, p_hdr->obj_id); delete_page = 1; if ((p_hdr->flags & SPIFFS_PH_FLAG_DELET) == 0 || (p_hdr->flags & SPIFFS_PH_FLAG_FINAL) || (p_hdr->flags & (SPIFFS_PH_FLAG_INDEX | SPIFFS_PH_FLAG_IXDELE)) == 0) { // page deleted or not finalized, just remove it } else { if (p_hdr->flags & SPIFFS_PH_FLAG_INDEX) { // if data page, check for reference to this page res = spiffs_object_get_data_page_index_reference(fs, p_hdr->obj_id, p_hdr->span_ix, &ref_pix, &objix_pix); if (res == SPIFFS_ERR_NOT_FOUND) { // no object with this id, so remove page safely res = SPIFFS_OK; } else { SPIFFS_CHECK_RES(res); // if found, rewrite page with object id, update index, and delete current if (ref_pix == cur_pix) { spiffs_page_ix new_pix; res = spiffs_rewrite_page(fs, cur_pix, p_hdr, &new_pix); SPIFFS_CHECK_RES(res); res = spiffs_rewrite_index(fs, p_hdr->obj_id, p_hdr->span_ix, new_pix, objix_pix); if (res <= _SPIFFS_ERR_CHECK_FIRST && res > _SPIFFS_ERR_CHECK_LAST) { // index bad also, cannot mend this file SPIFFS_CHECK_DBG("LU: FIXUP: index bad %i, cannot mend!\n", res); res = spiffs_page_delete(fs, new_pix); SPIFFS_CHECK_RES(res); res = spiffs_delete_obj_lazy(fs, p_hdr->obj_id); *reload_lu = 1; if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_LOOKUP, SPIFFS_CHECK_DELETE_BAD_FILE, p_hdr->obj_id, 0); } SPIFFS_CHECK_RES(res); } } } else { // else if index, check for other pages with both obj_id's and spanix spiffs_page_ix objix_pix_lu, objix_pix_ph; // see if other object index page exists for lookup obj id and span index res = spiffs_obj_lu_find_id_and_span(fs, lu_obj_id | SPIFFS_OBJ_ID_IX_FLAG, p_hdr->span_ix, 0, &objix_pix_lu); if (res == SPIFFS_ERR_NOT_FOUND) { res = SPIFFS_OK; objix_pix_lu = 0; } SPIFFS_CHECK_RES(res); // see if other object index exists for page header obj id and span index res = spiffs_obj_lu_find_id_and_span(fs, p_hdr->obj_id | SPIFFS_OBJ_ID_IX_FLAG, p_hdr->span_ix, 0, &objix_pix_ph); if (res == SPIFFS_ERR_NOT_FOUND) { res = SPIFFS_OK; objix_pix_ph = 0; } SPIFFS_CHECK_RES(res); // if both obj_id's found, just delete current if (objix_pix_ph == 0 || objix_pix_lu == 0) { // otherwise try finding first corresponding data pages spiffs_page_ix data_pix_lu, data_pix_ph; // see if other data page exists for look up obj id and span index res = spiffs_obj_lu_find_id_and_span(fs, lu_obj_id & ~SPIFFS_OBJ_ID_IX_FLAG, 0, 0, &data_pix_lu); if (res == SPIFFS_ERR_NOT_FOUND) { res = SPIFFS_OK; objix_pix_lu = 0; } SPIFFS_CHECK_RES(res); // see if other data page exists for page header obj id and span index res = spiffs_obj_lu_find_id_and_span(fs, p_hdr->obj_id & ~SPIFFS_OBJ_ID_IX_FLAG, 0, 0, &data_pix_ph); if (res == SPIFFS_ERR_NOT_FOUND) { res = SPIFFS_OK; objix_pix_ph = 0; } SPIFFS_CHECK_RES(res); spiffs_page_header new_ph; new_ph.flags = 0xff & ~(SPIFFS_PH_FLAG_USED | SPIFFS_PH_FLAG_INDEX | SPIFFS_PH_FLAG_FINAL); new_ph.span_ix = p_hdr->span_ix; spiffs_page_ix new_pix; if ((objix_pix_lu && data_pix_lu && data_pix_ph && objix_pix_ph == 0) || (objix_pix_lu == 0 && data_pix_ph && objix_pix_ph == 0)) { // got a data page for page header obj id // rewrite as obj_id_ph new_ph.obj_id = p_hdr->obj_id | SPIFFS_OBJ_ID_IX_FLAG; res = spiffs_rewrite_page(fs, cur_pix, &new_ph, &new_pix); SPIFFS_CHECK_DBG("LU: FIXUP: rewrite page %04x as %04x to pix %04x\n", cur_pix, new_ph.obj_id, new_pix); if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_LOOKUP, SPIFFS_CHECK_FIX_LOOKUP, p_hdr->obj_id, p_hdr->span_ix); SPIFFS_CHECK_RES(res); *reload_lu = 1; } else if ((objix_pix_ph && data_pix_ph && data_pix_lu && objix_pix_lu == 0) || (objix_pix_ph == 0 && data_pix_lu && objix_pix_lu == 0)) { // got a data page for look up obj id // rewrite as obj_id_lu new_ph.obj_id = lu_obj_id | SPIFFS_OBJ_ID_IX_FLAG; SPIFFS_CHECK_DBG("LU: FIXUP: rewrite page %04x as %04x\n", cur_pix, new_ph.obj_id); if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_LOOKUP, SPIFFS_CHECK_FIX_LOOKUP, p_hdr->obj_id, p_hdr->span_ix); res = spiffs_rewrite_page(fs, cur_pix, &new_ph, &new_pix); SPIFFS_CHECK_RES(res); *reload_lu = 1; } else { // cannot safely do anything SPIFFS_CHECK_DBG("LU: FIXUP: nothing to do, just delete\n"); } } } } } else if (((lu_obj_id & SPIFFS_OBJ_ID_IX_FLAG) && (p_hdr->flags & SPIFFS_PH_FLAG_INDEX)) || ((lu_obj_id & SPIFFS_OBJ_ID_IX_FLAG) == 0 && (p_hdr->flags & SPIFFS_PH_FLAG_INDEX) == 0)) { SPIFFS_CHECK_DBG("LU: %04x lu/page index marking differ\n", cur_pix); spiffs_page_ix data_pix, objix_pix; // see if other data page exists for given obj id and span index res = spiffs_obj_lu_find_id_and_span(fs, lu_obj_id & ~SPIFFS_OBJ_ID_IX_FLAG, p_hdr->span_ix, cur_pix, &data_pix); if (res == SPIFFS_ERR_NOT_FOUND) { res = SPIFFS_OK; data_pix = 0; } SPIFFS_CHECK_RES(res); // see if other object index exists for given obj id and span index res = spiffs_obj_lu_find_id_and_span(fs, lu_obj_id | SPIFFS_OBJ_ID_IX_FLAG, p_hdr->span_ix, cur_pix, &objix_pix); if (res == SPIFFS_ERR_NOT_FOUND) { res = SPIFFS_OK; objix_pix = 0; } SPIFFS_CHECK_RES(res); delete_page = 1; // if other data page exists and object index exists, just delete page if (data_pix && objix_pix) { SPIFFS_CHECK_DBG("LU: FIXUP: other index and data page exists, simply remove\n"); } else // if only data page exists, make this page index if (data_pix && objix_pix == 0) { SPIFFS_CHECK_DBG("LU: FIXUP: other data page exists, make this index\n"); if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_LOOKUP, SPIFFS_CHECK_FIX_INDEX, lu_obj_id, p_hdr->span_ix); spiffs_page_header new_ph; spiffs_page_ix new_pix; new_ph.flags = 0xff & ~(SPIFFS_PH_FLAG_USED | SPIFFS_PH_FLAG_FINAL | SPIFFS_PH_FLAG_INDEX); new_ph.obj_id = lu_obj_id | SPIFFS_OBJ_ID_IX_FLAG; new_ph.span_ix = p_hdr->span_ix; res = spiffs_page_allocate_data(fs, new_ph.obj_id, &new_ph, 0, 0, 0, 1, &new_pix); SPIFFS_CHECK_RES(res); res = spiffs_phys_cpy(fs, 0, SPIFFS_PAGE_TO_PADDR(fs, new_pix) + sizeof(spiffs_page_header), SPIFFS_PAGE_TO_PADDR(fs, cur_pix) + sizeof(spiffs_page_header), SPIFFS_CFG_LOG_PAGE_SZ(fs) - sizeof(spiffs_page_header)); SPIFFS_CHECK_RES(res); } else // if only index exists, make data page if (data_pix == 0 && objix_pix) { SPIFFS_CHECK_DBG("LU: FIXUP: other index page exists, make this data\n"); if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_LOOKUP, SPIFFS_CHECK_FIX_LOOKUP, lu_obj_id, p_hdr->span_ix); spiffs_page_header new_ph; spiffs_page_ix new_pix; new_ph.flags = 0xff & ~(SPIFFS_PH_FLAG_USED | SPIFFS_PH_FLAG_FINAL); new_ph.obj_id = lu_obj_id & ~SPIFFS_OBJ_ID_IX_FLAG; new_ph.span_ix = p_hdr->span_ix; res = spiffs_page_allocate_data(fs, new_ph.obj_id, &new_ph, 0, 0, 0, 1, &new_pix); SPIFFS_CHECK_RES(res); res = spiffs_phys_cpy(fs, 0, SPIFFS_PAGE_TO_PADDR(fs, new_pix) + sizeof(spiffs_page_header), SPIFFS_PAGE_TO_PADDR(fs, cur_pix) + sizeof(spiffs_page_header), SPIFFS_CFG_LOG_PAGE_SZ(fs) - sizeof(spiffs_page_header)); SPIFFS_CHECK_RES(res); } else { // if nothing exists, we cannot safely make a decision - delete } } else if ((p_hdr->flags & SPIFFS_PH_FLAG_DELET) == 0) { SPIFFS_CHECK_DBG("LU: pix %04x busy in lu but deleted on page\n", cur_pix); delete_page = 1; } else if ((p_hdr->flags & SPIFFS_PH_FLAG_FINAL)) { SPIFFS_CHECK_DBG("LU: pix %04x busy but not final\n", cur_pix); // page can be removed if not referenced by object index *reload_lu = 1; res = spiffs_object_get_data_page_index_reference(fs, lu_obj_id, p_hdr->span_ix, &ref_pix, &objix_pix); if (res == SPIFFS_ERR_NOT_FOUND) { // no object with this id, so remove page safely res = SPIFFS_OK; delete_page = 1; } else { SPIFFS_CHECK_RES(res); if (ref_pix != cur_pix) { SPIFFS_CHECK_DBG("LU: FIXUP: other finalized page is referred, just delete\n"); delete_page = 1; } else { // page referenced by object index but not final // just finalize SPIFFS_CHECK_DBG("LU: FIXUP: unfinalized page is referred, finalizing\n"); if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_LOOKUP, SPIFFS_CHECK_FIX_LOOKUP, p_hdr->obj_id, p_hdr->span_ix); u8_t flags = 0xff & ~SPIFFS_PH_FLAG_FINAL; res = _spiffs_wr(fs, SPIFFS_OP_T_OBJ_DA | SPIFFS_OP_C_UPDT, 0, SPIFFS_PAGE_TO_PADDR(fs, cur_pix) + offsetof(spiffs_page_header, flags), sizeof(u8_t), (u8_t*)&flags); } } } } if (delete_page) { SPIFFS_CHECK_DBG("LU: FIXUP: deleting page %04x\n", cur_pix); if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_LOOKUP, SPIFFS_CHECK_DELETE_PAGE, cur_pix, 0); res = spiffs_page_delete(fs, cur_pix); SPIFFS_CHECK_RES(res); } return res; } static s32_t spiffs_lookup_check_v(spiffs *fs, spiffs_obj_id obj_id, spiffs_block_ix cur_block, int cur_entry, u32_t user_data, void *user_p) { s32_t res = SPIFFS_OK; spiffs_page_header p_hdr; spiffs_page_ix cur_pix = SPIFFS_OBJ_LOOKUP_ENTRY_TO_PIX(fs, cur_block, cur_entry); if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_LOOKUP, SPIFFS_CHECK_PROGRESS, (cur_block * 256)/fs->block_count, 0); // load header res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_LU2 | SPIFFS_OP_C_READ, 0, SPIFFS_PAGE_TO_PADDR(fs, cur_pix), sizeof(spiffs_page_header), (u8_t*)&p_hdr); SPIFFS_CHECK_RES(res); int reload_lu = 0; res = spiffs_lookup_check_validate(fs, obj_id, &p_hdr, cur_pix, cur_block, cur_entry, &reload_lu); SPIFFS_CHECK_RES(res); if (res == SPIFFS_OK) { return reload_lu ? SPIFFS_VIS_COUNTINUE_RELOAD : SPIFFS_VIS_COUNTINUE; } return res; } // Scans all object look up. For each entry, corresponding page header is checked for validity. // If an object index header page is found, this is also checked s32_t spiffs_lookup_consistency_check(spiffs *fs, u8_t check_all_objects) { s32_t res = SPIFFS_OK; if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_LOOKUP, SPIFFS_CHECK_PROGRESS, 0, 0); res = spiffs_obj_lu_find_entry_visitor(fs, 0, 0, 0, 0, spiffs_lookup_check_v, 0, 0, 0, 0); if (res == SPIFFS_VIS_END) { res = SPIFFS_OK; } if (res != SPIFFS_OK) { if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_LOOKUP, SPIFFS_CHECK_ERROR, res, 0); } if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_LOOKUP, SPIFFS_CHECK_PROGRESS, 256, 0); return res; } //--------------------------------------- // Page consistency // Scans all pages (except lu pages), reserves 4 bits in working memory for each page // bit 0: 0 == FREE|DELETED, 1 == USED // bit 1: 0 == UNREFERENCED, 1 == REFERENCED // bit 2: 0 == NOT_INDEX, 1 == INDEX // bit 3: unused // A consistent file system will have only pages being // * x000 free, unreferenced, not index // * x011 used, referenced only once, not index // * x101 used, unreferenced, index // The working memory might not fit all pages so several scans might be needed static s32_t spiffs_page_consistency_check_i(spiffs *fs) { const u32_t bits = 4; const spiffs_page_ix pages_per_scan = SPIFFS_CFG_LOG_PAGE_SZ(fs) * 8 / bits; s32_t res = SPIFFS_OK; spiffs_page_ix pix_offset = 0; // for each range of pages fitting into work memory while (pix_offset < SPIFFS_PAGES_PER_BLOCK(fs) * fs->block_count) { // set this flag to abort all checks and rescan the page range u8_t restart = 0; c_memset(fs->work, 0, SPIFFS_CFG_LOG_PAGE_SZ(fs)); spiffs_block_ix cur_block = 0; // build consistency bitmap for id range traversing all blocks while (!restart && cur_block < fs->block_count) { if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_PAGE, SPIFFS_CHECK_PROGRESS, (pix_offset*256)/(SPIFFS_PAGES_PER_BLOCK(fs) * fs->block_count) + ((((cur_block * pages_per_scan * 256)/ (SPIFFS_PAGES_PER_BLOCK(fs) * fs->block_count))) / fs->block_count), 0); // traverse each page except for lookup pages spiffs_page_ix cur_pix = SPIFFS_OBJ_LOOKUP_PAGES(fs) + SPIFFS_PAGES_PER_BLOCK(fs) * cur_block; while (!restart && cur_pix < SPIFFS_PAGES_PER_BLOCK(fs) * (cur_block+1)) { // read header spiffs_page_header p_hdr; res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_LU2 | SPIFFS_OP_C_READ, 0, SPIFFS_PAGE_TO_PADDR(fs, cur_pix), sizeof(spiffs_page_header), (u8_t*)&p_hdr); SPIFFS_CHECK_RES(res); u8_t within_range = (cur_pix >= pix_offset && cur_pix < pix_offset + pages_per_scan); const u32_t pix_byte_ix = (cur_pix - pix_offset) / (8/bits); const u8_t pix_bit_ix = (cur_pix & ((8/bits)-1)) * bits; if (within_range && (p_hdr.flags & SPIFFS_PH_FLAG_DELET) && (p_hdr.flags & SPIFFS_PH_FLAG_USED) == 0) { // used fs->work[pix_byte_ix] |= (1<<(pix_bit_ix + 0)); } if ((p_hdr.flags & SPIFFS_PH_FLAG_DELET) && (p_hdr.flags & SPIFFS_PH_FLAG_IXDELE) && (p_hdr.flags & (SPIFFS_PH_FLAG_INDEX | SPIFFS_PH_FLAG_USED)) == 0) { // found non-deleted index if (within_range) { fs->work[pix_byte_ix] |= (1<<(pix_bit_ix + 2)); } // load non-deleted index res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_LU2 | SPIFFS_OP_C_READ, 0, SPIFFS_PAGE_TO_PADDR(fs, cur_pix), SPIFFS_CFG_LOG_PAGE_SZ(fs), fs->lu_work); SPIFFS_CHECK_RES(res); // traverse index for referenced pages spiffs_page_ix *object_page_index; spiffs_page_header *objix_p_hdr = (spiffs_page_header *)fs->lu_work; int entries; int i; spiffs_span_ix data_spix_offset; if (p_hdr.span_ix == 0) { // object header page index entries = SPIFFS_OBJ_HDR_IX_LEN(fs); data_spix_offset = 0; object_page_index = (spiffs_page_ix *)((u8_t *)fs->lu_work + sizeof(spiffs_page_object_ix_header)); } else { // object page index entries = SPIFFS_OBJ_IX_LEN(fs); data_spix_offset = SPIFFS_OBJ_HDR_IX_LEN(fs) + SPIFFS_OBJ_IX_LEN(fs) * (p_hdr.span_ix - 1); object_page_index = (spiffs_page_ix *)((u8_t *)fs->lu_work + sizeof(spiffs_page_object_ix)); } // for all entries in index for (i = 0; !restart && i < entries; i++) { spiffs_page_ix rpix = object_page_index[i]; u8_t rpix_within_range = rpix >= pix_offset && rpix < pix_offset + pages_per_scan; if ((rpix != (spiffs_page_ix)-1 && rpix > SPIFFS_MAX_PAGES(fs)) || (rpix_within_range && SPIFFS_IS_LOOKUP_PAGE(fs, rpix))) { // bad reference SPIFFS_CHECK_DBG("PA: pix %04x bad pix / LU referenced from page %04x\n", rpix, cur_pix); // check for data page elsewhere spiffs_page_ix data_pix; res = spiffs_obj_lu_find_id_and_span(fs, objix_p_hdr->obj_id & ~SPIFFS_OBJ_ID_IX_FLAG, data_spix_offset + i, 0, &data_pix); if (res == SPIFFS_ERR_NOT_FOUND) { res = SPIFFS_OK; data_pix = 0; } SPIFFS_CHECK_RES(res); if (data_pix == 0) { // if not, allocate free page spiffs_page_header new_ph; new_ph.flags = 0xff & ~(SPIFFS_PH_FLAG_USED | SPIFFS_PH_FLAG_FINAL); new_ph.obj_id = objix_p_hdr->obj_id & ~SPIFFS_OBJ_ID_IX_FLAG; new_ph.span_ix = data_spix_offset + i; res = spiffs_page_allocate_data(fs, new_ph.obj_id, &new_ph, 0, 0, 0, 1, &data_pix); SPIFFS_CHECK_RES(res); SPIFFS_CHECK_DBG("PA: FIXUP: found no existing data page, created new @ %04x\n", data_pix); } // remap index SPIFFS_CHECK_DBG("PA: FIXUP: rewriting index pix %04x\n", cur_pix); res = spiffs_rewrite_index(fs, objix_p_hdr->obj_id | SPIFFS_OBJ_ID_IX_FLAG, data_spix_offset + i, data_pix, cur_pix); if (res <= _SPIFFS_ERR_CHECK_FIRST && res > _SPIFFS_ERR_CHECK_LAST) { // index bad also, cannot mend this file SPIFFS_CHECK_DBG("PA: FIXUP: index bad %i, cannot mend - delete object\n", res); if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_PAGE, SPIFFS_CHECK_DELETE_BAD_FILE, objix_p_hdr->obj_id, 0); // delete file res = spiffs_page_delete(fs, cur_pix); } else { if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_PAGE, SPIFFS_CHECK_FIX_INDEX, objix_p_hdr->obj_id, objix_p_hdr->span_ix); } SPIFFS_CHECK_RES(res); restart = 1; } else if (rpix_within_range) { // valid reference // read referenced page header spiffs_page_header rp_hdr; res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_LU2 | SPIFFS_OP_C_READ, 0, SPIFFS_PAGE_TO_PADDR(fs, rpix), sizeof(spiffs_page_header), (u8_t*)&rp_hdr); SPIFFS_CHECK_RES(res); // cross reference page header check if (rp_hdr.obj_id != (p_hdr.obj_id & ~SPIFFS_OBJ_ID_IX_FLAG) || rp_hdr.span_ix != data_spix_offset + i || (rp_hdr.flags & (SPIFFS_PH_FLAG_DELET | SPIFFS_PH_FLAG_INDEX | SPIFFS_PH_FLAG_USED)) != (SPIFFS_PH_FLAG_DELET | SPIFFS_PH_FLAG_INDEX)) { SPIFFS_CHECK_DBG("PA: pix %04x has inconsistent page header ix id/span:%04x/%04x, ref id/span:%04x/%04x flags:%02x\n", rpix, p_hdr.obj_id & ~SPIFFS_OBJ_ID_IX_FLAG, data_spix_offset + i, rp_hdr.obj_id, rp_hdr.span_ix, rp_hdr.flags); // try finding correct page spiffs_page_ix data_pix; res = spiffs_obj_lu_find_id_and_span(fs, p_hdr.obj_id & ~SPIFFS_OBJ_ID_IX_FLAG, data_spix_offset + i, rpix, &data_pix); if (res == SPIFFS_ERR_NOT_FOUND) { res = SPIFFS_OK; data_pix = 0; } SPIFFS_CHECK_RES(res); if (data_pix == 0) { // not found, this index is badly borked SPIFFS_CHECK_DBG("PA: FIXUP: index bad, delete object id %04x\n", p_hdr.obj_id); if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_PAGE, SPIFFS_CHECK_DELETE_BAD_FILE, p_hdr.obj_id, 0); res = spiffs_delete_obj_lazy(fs, p_hdr.obj_id); SPIFFS_CHECK_RES(res); break; } else { // found it, so rewrite index SPIFFS_CHECK_DBG("PA: FIXUP: found correct data pix %04x, rewrite ix pix %04x id %04x\n", data_pix, cur_pix, p_hdr.obj_id); res = spiffs_rewrite_index(fs, p_hdr.obj_id, data_spix_offset + i, data_pix, cur_pix); if (res <= _SPIFFS_ERR_CHECK_FIRST && res > _SPIFFS_ERR_CHECK_LAST) { // index bad also, cannot mend this file SPIFFS_CHECK_DBG("PA: FIXUP: index bad %i, cannot mend!\n", res); if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_PAGE, SPIFFS_CHECK_DELETE_BAD_FILE, p_hdr.obj_id, 0); res = spiffs_delete_obj_lazy(fs, p_hdr.obj_id); } else { if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_PAGE, SPIFFS_CHECK_FIX_INDEX, p_hdr.obj_id, p_hdr.span_ix); } SPIFFS_CHECK_RES(res); restart = 1; } } else { // mark rpix as referenced const u32_t rpix_byte_ix = (rpix - pix_offset) / (8/bits); const u8_t rpix_bit_ix = (rpix & ((8/bits)-1)) * bits; if (fs->work[rpix_byte_ix] & (1<<(rpix_bit_ix + 1))) { SPIFFS_CHECK_DBG("PA: pix %04x multiple referenced from page %04x\n", rpix, cur_pix); // Here, we should have fixed all broken references - getting this means there // must be multiple files with same object id. Only solution is to delete // the object which is referring to this page SPIFFS_CHECK_DBG("PA: FIXUP: removing object %04x and page %04x\n", p_hdr.obj_id, cur_pix); if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_PAGE, SPIFFS_CHECK_DELETE_BAD_FILE, p_hdr.obj_id, 0); res = spiffs_delete_obj_lazy(fs, p_hdr.obj_id); SPIFFS_CHECK_RES(res); // extra precaution, delete this page also res = spiffs_page_delete(fs, cur_pix); SPIFFS_CHECK_RES(res); restart = 1; } fs->work[rpix_byte_ix] |= (1<<(rpix_bit_ix + 1)); } } } // for all index entries } // found index // next page cur_pix++; } // next block cur_block++; } // check consistency bitmap if (!restart) { spiffs_page_ix objix_pix; spiffs_page_ix rpix; int byte_ix; int bit_ix; for (byte_ix = 0; !restart && byte_ix < SPIFFS_CFG_LOG_PAGE_SZ(fs); byte_ix++) { for (bit_ix = 0; !restart && bit_ix < 8/bits; bit_ix ++) { u8_t bitmask = (fs->work[byte_ix] >> (bit_ix * bits)) & 0x7; spiffs_page_ix cur_pix = pix_offset + byte_ix * (8/bits) + bit_ix; // 000 ok - free, unreferenced, not index if (bitmask == 0x1) { // 001 SPIFFS_CHECK_DBG("PA: pix %04x USED, UNREFERENCED, not index\n", cur_pix); u8_t rewrite_ix_to_this = 0; u8_t delete_page = 0; // check corresponding object index entry spiffs_page_header p_hdr; res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_LU2 | SPIFFS_OP_C_READ, 0, SPIFFS_PAGE_TO_PADDR(fs, cur_pix), sizeof(spiffs_page_header), (u8_t*)&p_hdr); SPIFFS_CHECK_RES(res); res = spiffs_object_get_data_page_index_reference(fs, p_hdr.obj_id, p_hdr.span_ix, &rpix, &objix_pix); if (res == SPIFFS_OK) { if (((rpix == (spiffs_page_ix)-1 || rpix > SPIFFS_MAX_PAGES(fs)) || (SPIFFS_IS_LOOKUP_PAGE(fs, rpix)))) { // pointing to a bad page altogether, rewrite index to this rewrite_ix_to_this = 1; SPIFFS_CHECK_DBG("PA: corresponding ref is bad: %04x, rewrite to this %04x\n", rpix, cur_pix); } else { // pointing to something else, check what spiffs_page_header rp_hdr; res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_LU2 | SPIFFS_OP_C_READ, 0, SPIFFS_PAGE_TO_PADDR(fs, rpix), sizeof(spiffs_page_header), (u8_t*)&rp_hdr); SPIFFS_CHECK_RES(res); if (((p_hdr.obj_id & ~SPIFFS_OBJ_ID_IX_FLAG) == rp_hdr.obj_id) && ((rp_hdr.flags & (SPIFFS_PH_FLAG_INDEX | SPIFFS_PH_FLAG_DELET | SPIFFS_PH_FLAG_USED | SPIFFS_PH_FLAG_FINAL)) == (SPIFFS_PH_FLAG_INDEX | SPIFFS_PH_FLAG_DELET))) { // pointing to something else valid, just delete this page then SPIFFS_CHECK_DBG("PA: corresponding ref is good but different: %04x, delete this %04x\n", rpix, cur_pix); delete_page = 1; } else { // pointing to something weird, update index to point to this page instead if (rpix != cur_pix) { SPIFFS_CHECK_DBG("PA: corresponding ref is weird: %04x %s%s%s%s, rewrite this %04x\n", rpix, (rp_hdr.flags & SPIFFS_PH_FLAG_INDEX) ? "" : "INDEX ", (rp_hdr.flags & SPIFFS_PH_FLAG_DELET) ? "" : "DELETED ", (rp_hdr.flags & SPIFFS_PH_FLAG_USED) ? "NOTUSED " : "", (rp_hdr.flags & SPIFFS_PH_FLAG_FINAL) ? "NOTFINAL " : "", cur_pix); rewrite_ix_to_this = 1; } else { // should not happen, destined for fubar } } } } else if (res == SPIFFS_ERR_NOT_FOUND) { SPIFFS_CHECK_DBG("PA: corresponding ref not found, delete %04x\n", cur_pix); delete_page = 1; res = SPIFFS_OK; } if (rewrite_ix_to_this) { // if pointing to invalid page, redirect index to this page SPIFFS_CHECK_DBG("PA: FIXUP: rewrite index id %04x data spix %04x to point to this pix: %04x\n", p_hdr.obj_id, p_hdr.span_ix, cur_pix); res = spiffs_rewrite_index(fs, p_hdr.obj_id, p_hdr.span_ix, cur_pix, objix_pix); if (res <= _SPIFFS_ERR_CHECK_FIRST && res > _SPIFFS_ERR_CHECK_LAST) { // index bad also, cannot mend this file SPIFFS_CHECK_DBG("PA: FIXUP: index bad %i, cannot mend!\n", res); if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_PAGE, SPIFFS_CHECK_DELETE_BAD_FILE, p_hdr.obj_id, 0); res = spiffs_page_delete(fs, cur_pix); SPIFFS_CHECK_RES(res); res = spiffs_delete_obj_lazy(fs, p_hdr.obj_id); } else { if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_PAGE, SPIFFS_CHECK_FIX_INDEX, p_hdr.obj_id, p_hdr.span_ix); } SPIFFS_CHECK_RES(res); restart = 1; continue; } else if (delete_page) { SPIFFS_CHECK_DBG("PA: FIXUP: deleting page %04x\n", cur_pix); if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_PAGE, SPIFFS_CHECK_DELETE_PAGE, cur_pix, 0); res = spiffs_page_delete(fs, cur_pix); } SPIFFS_CHECK_RES(res); } if (bitmask == 0x2) { // 010 SPIFFS_CHECK_DBG("PA: pix %04x FREE, REFERENCED, not index\n", cur_pix); // no op, this should be taken care of when checking valid references } // 011 ok - busy, referenced, not index if (bitmask == 0x4) { // 100 SPIFFS_CHECK_DBG("PA: pix %04x FREE, unreferenced, INDEX\n", cur_pix); // this should never happen, major fubar } // 101 ok - busy, unreferenced, index if (bitmask == 0x6) { // 110 SPIFFS_CHECK_DBG("PA: pix %04x FREE, REFERENCED, INDEX\n", cur_pix); // no op, this should be taken care of when checking valid references } if (bitmask == 0x7) { // 111 SPIFFS_CHECK_DBG("PA: pix %04x USED, REFERENCED, INDEX\n", cur_pix); // no op, this should be taken care of when checking valid references } } } } // next page range if (!restart) { pix_offset += pages_per_scan; } } // while page range not reached end return res; } // Checks consistency amongst all pages and fixes irregularities s32_t spiffs_page_consistency_check(spiffs *fs) { if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_PAGE, SPIFFS_CHECK_PROGRESS, 0, 0); s32_t res = spiffs_page_consistency_check_i(fs); if (res != SPIFFS_OK) { if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_PAGE, SPIFFS_CHECK_ERROR, res, 0); } if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_PAGE, SPIFFS_CHECK_PROGRESS, 256, 0); return res; } //--------------------------------------- // Object index consistency // searches for given object id in temporary object id index, // returns the index or -1 static int spiffs_object_index_search(spiffs *fs, spiffs_obj_id obj_id) { int i; spiffs_obj_id *obj_table = (spiffs_obj_id *)fs->work; obj_id &= ~SPIFFS_OBJ_ID_IX_FLAG; for (i = 0; i < SPIFFS_CFG_LOG_PAGE_SZ(fs) / sizeof(spiffs_obj_id); i++) { if ((obj_table[i] & ~SPIFFS_OBJ_ID_IX_FLAG) == obj_id) { return i; } } return -1; } s32_t spiffs_object_index_consistency_check_v(spiffs *fs, spiffs_obj_id obj_id, spiffs_block_ix cur_block, int cur_entry, u32_t user_data, void *user_p) { s32_t res_c = SPIFFS_VIS_COUNTINUE; s32_t res = SPIFFS_OK; u32_t *log_ix = (u32_t *)user_p; spiffs_obj_id *obj_table = (spiffs_obj_id *)fs->work; if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_INDEX, SPIFFS_CHECK_PROGRESS, (cur_block * 256)/fs->block_count, 0); if (obj_id != SPIFFS_OBJ_ID_FREE && obj_id != SPIFFS_OBJ_ID_DELETED && (obj_id & SPIFFS_OBJ_ID_IX_FLAG)) { spiffs_page_header p_hdr; spiffs_page_ix cur_pix = SPIFFS_OBJ_LOOKUP_ENTRY_TO_PIX(fs, cur_block, cur_entry); // load header res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_LU2 | SPIFFS_OP_C_READ, 0, SPIFFS_PAGE_TO_PADDR(fs, cur_pix), sizeof(spiffs_page_header), (u8_t*)&p_hdr); SPIFFS_CHECK_RES(res); if (p_hdr.span_ix == 0 && (p_hdr.flags & (SPIFFS_PH_FLAG_INDEX | SPIFFS_PH_FLAG_FINAL | SPIFFS_PH_FLAG_DELET | SPIFFS_PH_FLAG_IXDELE)) == (SPIFFS_PH_FLAG_DELET)) { SPIFFS_CHECK_DBG("IX: pix %04x, obj id:%04x spix:%04x header not fully deleted - deleting\n", cur_pix, obj_id, p_hdr.span_ix); if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_INDEX, SPIFFS_CHECK_DELETE_PAGE, cur_pix, obj_id); res = spiffs_page_delete(fs, cur_pix); SPIFFS_CHECK_RES(res); return res_c; } if ((p_hdr.flags & (SPIFFS_PH_FLAG_INDEX | SPIFFS_PH_FLAG_FINAL | SPIFFS_PH_FLAG_DELET | SPIFFS_PH_FLAG_IXDELE)) == (SPIFFS_PH_FLAG_DELET | SPIFFS_PH_FLAG_IXDELE)) { return res_c; } if (p_hdr.span_ix == 0) { // objix header page, register objid as reachable int r = spiffs_object_index_search(fs, obj_id); if (r == -1) { // not registered, do it obj_table[*log_ix] = obj_id & ~SPIFFS_OBJ_ID_IX_FLAG; (*log_ix)++; if (*log_ix >= SPIFFS_CFG_LOG_PAGE_SZ(fs) / sizeof(spiffs_obj_id)) { *log_ix = 0; } } } else { // span index // objix page, see if header can be found int r = spiffs_object_index_search(fs, obj_id); u8_t delete = 0; if (r == -1) { // not in temporary index, try finding it spiffs_page_ix objix_hdr_pix; res = spiffs_obj_lu_find_id_and_span(fs, obj_id | SPIFFS_OBJ_ID_IX_FLAG, 0, 0, &objix_hdr_pix); res_c = SPIFFS_VIS_COUNTINUE_RELOAD; if (res == SPIFFS_OK) { // found, register as reachable obj_table[*log_ix] = obj_id & ~SPIFFS_OBJ_ID_IX_FLAG; } else if (res == SPIFFS_ERR_NOT_FOUND) { // not found, register as unreachable delete = 1; obj_table[*log_ix] = obj_id | SPIFFS_OBJ_ID_IX_FLAG; } else { SPIFFS_CHECK_RES(res); } (*log_ix)++; if (*log_ix >= SPIFFS_CFG_LOG_PAGE_SZ(fs) / sizeof(spiffs_obj_id)) { *log_ix = 0; } } else { // in temporary index, check reachable flag if ((obj_table[r] & SPIFFS_OBJ_ID_IX_FLAG)) { // registered as unreachable delete = 1; } } if (delete) { SPIFFS_CHECK_DBG("IX: FIXUP: pix %04x, obj id:%04x spix:%04x is orphan index - deleting\n", cur_pix, obj_id, p_hdr.span_ix); if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_INDEX, SPIFFS_CHECK_DELETE_ORPHANED_INDEX, cur_pix, obj_id); res = spiffs_page_delete(fs, cur_pix); SPIFFS_CHECK_RES(res); } } // span index } // valid object index id return res_c; } // Removes orphaned and partially deleted index pages. // Scans for index pages. When an index page is found, corresponding index header is searched for. // If no such page exists, the index page cannot be reached as no index header exists and must be // deleted. s32_t spiffs_object_index_consistency_check(spiffs *fs) { s32_t res = SPIFFS_OK; // impl note: // fs->work is used for a temporary object index memory, listing found object ids and // indicating whether they can be reached or not. Acting as a fifo if object ids cannot fit. // In the temporary object index memory, SPIFFS_OBJ_ID_IX_FLAG bit is used to indicate // a reachable/unreachable object id. c_memset(fs->work, 0, SPIFFS_CFG_LOG_PAGE_SZ(fs)); u32_t obj_id_log_ix = 0; if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_INDEX, SPIFFS_CHECK_PROGRESS, 0, 0); res = spiffs_obj_lu_find_entry_visitor(fs, 0, 0, 0, 0, spiffs_object_index_consistency_check_v, 0, &obj_id_log_ix, 0, 0); if (res == SPIFFS_VIS_END) { res = SPIFFS_OK; } if (res != SPIFFS_OK) { if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_INDEX, SPIFFS_CHECK_ERROR, res, 0); } if (fs->check_cb_f) fs->check_cb_f(SPIFFS_CHECK_INDEX, SPIFFS_CHECK_PROGRESS, 256, 0); return res; } ================================================ FILE: app/spiffs/spiffs_config.h ================================================ /* * spiffs_config.h * * Created on: Jul 3, 2013 * Author: petera */ #ifndef SPIFFS_CONFIG_H_ #define SPIFFS_CONFIG_H_ // ----------- 8< ------------ // Following includes are for the linux test build of spiffs // These may/should/must be removed/altered/replaced in your target // #include "params_test.h" #include "c_stdio.h" #include "c_stdlib.h" #include "c_string.h" #include "c_stddef.h" #include "c_types.h" // ----------- >8 ------------ typedef sint32_t s32_t; typedef uint32_t u32_t; typedef sint16_t s16_t; typedef uint16_t u16_t; typedef sint8_t s8_t; typedef uint8_t u8_t; // compile time switches // Set generic spiffs debug output call. #ifndef SPIFFS_DGB #define SPIFFS_DBG(...) #endif // Set spiffs debug output call for garbage collecting. #ifndef SPIFFS_GC_DGB #define SPIFFS_GC_DBG(...) #endif // Set spiffs debug output call for caching. #ifndef SPIFFS_CACHE_DGB #define SPIFFS_CACHE_DBG(...) #endif // Set spiffs debug output call for system consistency checks. #ifndef SPIFFS_CHECK_DGB #define SPIFFS_CHECK_DBG(...) #endif // Enable/disable API functions to determine exact number of bytes // for filedescriptor and cache buffers. Once decided for a configuration, // this can be disabled to reduce flash. #ifndef SPIFFS_BUFFER_HELP #define SPIFFS_BUFFER_HELP 0 #endif // Enables/disable memory read caching of nucleus file system operations. // If enabled, memory area must be provided for cache in SPIFFS_mount. #ifndef SPIFFS_CACHE #define SPIFFS_CACHE 1 #endif #if SPIFFS_CACHE // Enables memory write caching for file descriptors in hydrogen #ifndef SPIFFS_CACHE_WR #define SPIFFS_CACHE_WR 1 #endif // Enable/disable statistics on caching. Debug/test purpose only. #ifndef SPIFFS_CACHE_STATS #define SPIFFS_CACHE_STATS 0 #endif #endif // Always check header of each accessed page to ensure consistent state. // If enabled it will increase number of reads, will increase flash. #ifndef SPIFFS_PAGE_CHECK #define SPIFFS_PAGE_CHECK 1 #endif // Define maximum number of gc runs to perform to reach desired free pages. #ifndef SPIFFS_GC_MAX_RUNS #define SPIFFS_GC_MAX_RUNS 3 #endif // Enable/disable statistics on gc. Debug/test purpose only. #ifndef SPIFFS_GC_STATS #define SPIFFS_GC_STATS 0 #endif // Garbage collecting examines all pages in a block which and sums up // to a block score. Deleted pages normally gives positive score and // used pages normally gives a negative score (as these must be moved). // To have a fair wear-leveling, the erase age is also included in score, // whose factor normally is the most positive. // The larger the score, the more likely it is that the block will // picked for garbage collection. // Garbage collecting heuristics - weight used for deleted pages. #ifndef SPIFFS_GC_HEUR_W_DELET #define SPIFFS_GC_HEUR_W_DELET (5) #endif // Garbage collecting heuristics - weight used for used pages. #ifndef SPIFFS_GC_HEUR_W_USED #define SPIFFS_GC_HEUR_W_USED (-1) #endif // Garbage collecting heuristics - weight used for time between // last erased and erase of this block. #ifndef SPIFFS_GC_HEUR_W_ERASE_AGE #define SPIFFS_GC_HEUR_W_ERASE_AGE (50) #endif // Object name maximum length. #ifndef SPIFFS_OBJ_NAME_LEN #define SPIFFS_OBJ_NAME_LEN (32) #endif // Size of buffer allocated on stack used when copying data. // Lower value generates more read/writes. No meaning having it bigger // than logical page size. #ifndef SPIFFS_COPY_BUFFER_STACK #define SPIFFS_COPY_BUFFER_STACK (64) #endif // SPIFFS_LOCK and SPIFFS_UNLOCK protects spiffs from reentrancy on api level // These should be defined on a multithreaded system // define this to entering a mutex if you're running on a multithreaded system #ifndef SPIFFS_LOCK #define SPIFFS_LOCK(fs) #endif // define this to exiting a mutex if you're running on a multithreaded system #ifndef SPIFFS_UNLOCK #define SPIFFS_UNLOCK(fs) #endif // Enable if only one spiffs instance with constant configuration will exist // on the target. This will reduce calculations, flash and memory accesses. // Parts of configuration must be defined below instead of at time of mount. #ifndef SPIFFS_SINGLETON #define SPIFFS_SINGLETON 0 #endif #if SPIFFS_SINGLETON // Instead of giving parameters in config struct, singleton build must // give parameters in defines below. #ifndef SPIFFS_CFG_PHYS_SZ #define SPIFFS_CFG_PHYS_SZ(ignore) (1024*1024*2) #endif #ifndef SPIFFS_CFG_PHYS_ERASE_SZ #define SPIFFS_CFG_PHYS_ERASE_SZ(ignore) (65536) #endif #ifndef SPIFFS_CFG_PHYS_ADDR #define SPIFFS_CFG_PHYS_ADDR(ignore) (0) #endif #ifndef SPIFFS_CFG_LOG_PAGE_SZ #define SPIFFS_CFG_LOG_PAGE_SZ(ignore) (256) #endif #ifndef SPIFFS_CFG_LOG_BLOCK_SZ #define SPIFFS_CFG_LOG_BLOCK_SZ(ignore) (65536) #endif #endif // Set SPFIFS_TEST_VISUALISATION to non-zero to enable SPIFFS_vis function // in the api. This function will visualize all filesystem using given printf // function. #ifndef SPIFFS_TEST_VISUALISATION #define SPIFFS_TEST_VISUALISATION 1 #endif #if SPIFFS_TEST_VISUALISATION #ifndef spiffs_printf #define spiffs_printf(...) c_printf(__VA_ARGS__) #endif // spiffs_printf argument for a free page #ifndef SPIFFS_TEST_VIS_FREE_STR #define SPIFFS_TEST_VIS_FREE_STR "_" #endif // spiffs_printf argument for a deleted page #ifndef SPIFFS_TEST_VIS_DELE_STR #define SPIFFS_TEST_VIS_DELE_STR "/" #endif // spiffs_printf argument for an index page for given object id #ifndef SPIFFS_TEST_VIS_INDX_STR #define SPIFFS_TEST_VIS_INDX_STR(id) "i" #endif // spiffs_printf argument for a data page for given object id #ifndef SPIFFS_TEST_VIS_DATA_STR #define SPIFFS_TEST_VIS_DATA_STR(id) "d" #endif #endif // Types depending on configuration such as the amount of flash bytes // given to spiffs file system in total (spiffs_file_system_size), // the logical block size (log_block_size), and the logical page size // (log_page_size) // Block index type. Make sure the size of this type can hold // the highest number of all blocks - i.e. spiffs_file_system_size / log_block_size typedef u16_t spiffs_block_ix; // Page index type. Make sure the size of this type can hold // the highest page number of all pages - i.e. spiffs_file_system_size / log_page_size typedef u16_t spiffs_page_ix; // Object id type - most significant bit is reserved for index flag. Make sure the // size of this type can hold the highest object id on a full system, // i.e. 2 + (spiffs_file_system_size / (2*log_page_size))*2 typedef u16_t spiffs_obj_id; // Object span index type. Make sure the size of this type can // hold the largest possible span index on the system - // i.e. (spiffs_file_system_size / log_page_size) - 1 typedef u16_t spiffs_span_ix; #endif /* SPIFFS_CONFIG_H_ */ ================================================ FILE: app/spiffs/spiffs_gc.c ================================================ #include "spiffs.h" #include "spiffs_nucleus.h" // Erases a logical block and updates the erase counter. // If cache is enabled, all pages that might be cached in this block // is dropped. static s32_t spiffs_gc_erase_block( spiffs *fs, spiffs_block_ix bix) { s32_t res; u32_t addr = SPIFFS_BLOCK_TO_PADDR(fs, bix); s32_t size = SPIFFS_CFG_LOG_BLOCK_SZ(fs); SPIFFS_GC_DBG("gc: erase block %i\n", bix); // here we ignore res, just try erasing the block while (size > 0) { SPIFFS_GC_DBG("gc: erase %08x:%08x\n", addr, SPIFFS_CFG_PHYS_ERASE_SZ(fs)); (void)fs->cfg.hal_erase_f(addr, SPIFFS_CFG_PHYS_ERASE_SZ(fs)); addr += SPIFFS_CFG_PHYS_ERASE_SZ(fs); size -= SPIFFS_CFG_PHYS_ERASE_SZ(fs); } fs->free_blocks++; // register erase count for this block res = _spiffs_wr(fs, SPIFFS_OP_C_WRTHRU | SPIFFS_OP_T_OBJ_LU2, 0, SPIFFS_ERASE_COUNT_PADDR(fs, bix), sizeof(spiffs_obj_id), (u8_t *)&fs->max_erase_count); SPIFFS_CHECK_RES(res); fs->max_erase_count++; if (fs->max_erase_count == SPIFFS_OBJ_ID_IX_FLAG) { fs->max_erase_count = 0; } #if SPIFFS_CACHE { int i; for (i = 0; i < SPIFFS_PAGES_PER_BLOCK(fs); i++) { spiffs_cache_drop_page(fs, SPIFFS_PAGE_FOR_BLOCK(fs, bix) + i); } } #endif return res; } // Searches for blocks where all entries are deleted - if one is found, // the block is erased. Compared to the non-quick gc, the quick one ensures // that no updates are needed on existing objects on pages that are erased. s32_t spiffs_gc_quick( spiffs *fs) { s32_t res = SPIFFS_OK; u32_t blocks = fs->block_count; spiffs_block_ix cur_block = 0; u32_t cur_block_addr = 0; int cur_entry = 0; spiffs_obj_id *obj_lu_buf = (spiffs_obj_id *)fs->lu_work; SPIFFS_GC_DBG("gc_quick: running\n", cur_block); #if SPIFFS_GC_STATS fs->stats_gc_runs++; #endif u32_t entries_per_page = (SPIFFS_CFG_LOG_PAGE_SZ(fs) / sizeof(spiffs_obj_id)); // find fully deleted blocks // check each block while (res == SPIFFS_OK && blocks--) { u16_t deleted_pages_in_block = 0; int obj_lookup_page = 0; // check each object lookup page while (res == SPIFFS_OK && obj_lookup_page < SPIFFS_OBJ_LOOKUP_PAGES(fs)) { int entry_offset = obj_lookup_page * entries_per_page; res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_LU | SPIFFS_OP_C_READ, 0, cur_block_addr + SPIFFS_PAGE_TO_PADDR(fs, obj_lookup_page), SPIFFS_CFG_LOG_PAGE_SZ(fs), fs->lu_work); // check each entry while (res == SPIFFS_OK && cur_entry - entry_offset < entries_per_page && cur_entry < SPIFFS_PAGES_PER_BLOCK(fs)-SPIFFS_OBJ_LOOKUP_PAGES(fs)) { spiffs_obj_id obj_id = obj_lu_buf[cur_entry-entry_offset]; if (obj_id == SPIFFS_OBJ_ID_DELETED) { deleted_pages_in_block++; } else if (obj_id == SPIFFS_OBJ_ID_FREE) { // kill scan, go for next block obj_lookup_page = SPIFFS_OBJ_LOOKUP_PAGES(fs); break; } else { // kill scan, go for next block obj_lookup_page = SPIFFS_OBJ_LOOKUP_PAGES(fs); break; } cur_entry++; } // per entry obj_lookup_page++; } // per object lookup page if (res == SPIFFS_OK && deleted_pages_in_block == SPIFFS_PAGES_PER_BLOCK(fs)-SPIFFS_OBJ_LOOKUP_PAGES(fs)) { // found a fully deleted block fs->stats_p_deleted -= deleted_pages_in_block; res = spiffs_gc_erase_block(fs, cur_block); return res; } cur_entry = 0; cur_block++; cur_block_addr += SPIFFS_CFG_LOG_BLOCK_SZ(fs); } // per block return res; } // Checks if garbaga collecting is necessary. If so a candidate block is found, // cleansed and erased s32_t spiffs_gc_check( spiffs *fs, u32_t len) { s32_t res; u32_t free_pages = (SPIFFS_PAGES_PER_BLOCK(fs) - SPIFFS_OBJ_LOOKUP_PAGES(fs)) * fs->block_count - fs->stats_p_allocated - fs->stats_p_deleted; int tries = 0; if (fs->free_blocks > 3 && len < free_pages * SPIFFS_DATA_PAGE_SIZE(fs)) { return SPIFFS_OK; } //printf("gcing started %i dirty, blocks %i free, want %i bytes\n", fs->stats_p_allocated + fs->stats_p_deleted, fs->free_blocks, len); do { SPIFFS_GC_DBG("\ngc_check #%i: run gc free_blocks:%i pfree:%i pallo:%i pdele:%i [%i] len:%i of %i\n", tries, fs->free_blocks, free_pages, fs->stats_p_allocated, fs->stats_p_deleted, (free_pages+fs->stats_p_allocated+fs->stats_p_deleted), len, free_pages*SPIFFS_DATA_PAGE_SIZE(fs)); spiffs_block_ix *cands; int count; spiffs_block_ix cand; res = spiffs_gc_find_candidate(fs, &cands, &count); SPIFFS_CHECK_RES(res); if (count == 0) { SPIFFS_GC_DBG("gc_check: no candidates, return\n"); return res; } #if SPIFFS_GC_STATS fs->stats_gc_runs++; #endif cand = cands[0]; fs->cleaning = 1; //printf("gcing: cleaning block %i\n", cand); res = spiffs_gc_clean(fs, cand); fs->cleaning = 0; if (res < 0) { SPIFFS_GC_DBG("gc_check: cleaning block %i, result %i\n", cand, res); } else { SPIFFS_GC_DBG("gc_check: cleaning block %i, result %i\n", cand, res); } SPIFFS_CHECK_RES(res); res = spiffs_gc_erase_page_stats(fs, cand); SPIFFS_CHECK_RES(res); res = spiffs_gc_erase_block(fs, cand); SPIFFS_CHECK_RES(res); free_pages = (SPIFFS_PAGES_PER_BLOCK(fs) - SPIFFS_OBJ_LOOKUP_PAGES(fs)) * fs->block_count - fs->stats_p_allocated - fs->stats_p_deleted; } while (++tries < SPIFFS_GC_MAX_RUNS && (fs->free_blocks <= 2 || len > free_pages*SPIFFS_DATA_PAGE_SIZE(fs))); SPIFFS_GC_DBG("gc_check: finished\n"); //printf("gcing finished %i dirty, blocks %i free, %i pages free, %i tries, res %i\n", // fs->stats_p_allocated + fs->stats_p_deleted, // fs->free_blocks, free_pages, tries, res); return res; } // Updates page statistics for a block that is about to be erased s32_t spiffs_gc_erase_page_stats( spiffs *fs, spiffs_block_ix bix) { s32_t res = SPIFFS_OK; int obj_lookup_page = 0; u32_t entries_per_page = (SPIFFS_CFG_LOG_PAGE_SZ(fs) / sizeof(spiffs_obj_id)); spiffs_obj_id *obj_lu_buf = (spiffs_obj_id *)fs->lu_work; int cur_entry = 0; u32_t dele = 0; u32_t allo = 0; // check each object lookup page while (res == SPIFFS_OK && obj_lookup_page < SPIFFS_OBJ_LOOKUP_PAGES(fs)) { int entry_offset = obj_lookup_page * entries_per_page; res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_LU | SPIFFS_OP_C_READ, 0, bix * SPIFFS_CFG_LOG_BLOCK_SZ(fs) + SPIFFS_PAGE_TO_PADDR(fs, obj_lookup_page), SPIFFS_CFG_LOG_PAGE_SZ(fs), fs->lu_work); // check each entry while (res == SPIFFS_OK && cur_entry - entry_offset < entries_per_page && cur_entry < SPIFFS_PAGES_PER_BLOCK(fs)-SPIFFS_OBJ_LOOKUP_PAGES(fs)) { spiffs_obj_id obj_id = obj_lu_buf[cur_entry-entry_offset]; if (obj_id == SPIFFS_OBJ_ID_FREE) { } else if (obj_id == SPIFFS_OBJ_ID_DELETED) { dele++; } else { allo++; } cur_entry++; } // per entry obj_lookup_page++; } // per object lookup page SPIFFS_GC_DBG("gc_check: wipe pallo:%i pdele:%i\n", allo, dele); fs->stats_p_allocated -= allo; fs->stats_p_deleted -= dele; return res; } // Finds block candidates to erase s32_t spiffs_gc_find_candidate( spiffs *fs, spiffs_block_ix **block_candidates, int *candidate_count) { s32_t res = SPIFFS_OK; u32_t blocks = fs->block_count; spiffs_block_ix cur_block = 0; u32_t cur_block_addr = 0; spiffs_obj_id *obj_lu_buf = (spiffs_obj_id *)fs->lu_work; int cur_entry = 0; // using fs->work area as sorted candidate memory, (spiffs_block_ix)cand_bix/(s32_t)score int max_candidates = MIN(fs->block_count, (SPIFFS_CFG_LOG_PAGE_SZ(fs)-8)/(sizeof(spiffs_block_ix) + sizeof(s32_t))); *candidate_count = 0; c_memset(fs->work, 0xff, SPIFFS_CFG_LOG_PAGE_SZ(fs)); // divide up work area into block indices and scores // todo alignment? spiffs_block_ix *cand_blocks = (spiffs_block_ix *)fs->work; s32_t *cand_scores = (s32_t *)(fs->work + max_candidates * sizeof(spiffs_block_ix)); *block_candidates = cand_blocks; u32_t entries_per_page = (SPIFFS_CFG_LOG_PAGE_SZ(fs) / sizeof(spiffs_obj_id)); // check each block while (res == SPIFFS_OK && blocks--) { u16_t deleted_pages_in_block = 0; u16_t used_pages_in_block = 0; int obj_lookup_page = 0; // check each object lookup page while (res == SPIFFS_OK && obj_lookup_page < SPIFFS_OBJ_LOOKUP_PAGES(fs)) { int entry_offset = obj_lookup_page * entries_per_page; res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_LU | SPIFFS_OP_C_READ, 0, cur_block_addr + SPIFFS_PAGE_TO_PADDR(fs, obj_lookup_page), SPIFFS_CFG_LOG_PAGE_SZ(fs), fs->lu_work); // check each entry while (res == SPIFFS_OK && cur_entry - entry_offset < entries_per_page && cur_entry < SPIFFS_PAGES_PER_BLOCK(fs)-SPIFFS_OBJ_LOOKUP_PAGES(fs)) { spiffs_obj_id obj_id = obj_lu_buf[cur_entry-entry_offset]; if (obj_id == SPIFFS_OBJ_ID_FREE) { // when a free entry is encountered, scan logic ensures that all following entries are free also break; } else if (obj_id == SPIFFS_OBJ_ID_DELETED) { deleted_pages_in_block++; } else { used_pages_in_block++; } cur_entry++; } // per entry obj_lookup_page++; } // per object lookup page // calculate score and insert into candidate table // stoneage sort, but probably not so many blocks if (res == SPIFFS_OK && deleted_pages_in_block > 0) { // read erase count spiffs_obj_id erase_count; res = _spiffs_rd(fs, SPIFFS_OP_C_READ | SPIFFS_OP_T_OBJ_LU2, 0, SPIFFS_ERASE_COUNT_PADDR(fs, cur_block), sizeof(spiffs_obj_id), (u8_t *)&erase_count); SPIFFS_CHECK_RES(res); spiffs_obj_id erase_age; if (fs->max_erase_count > erase_count) { erase_age = fs->max_erase_count - erase_count; } else { erase_age = SPIFFS_OBJ_ID_FREE - (erase_count - fs->max_erase_count); } s32_t score = deleted_pages_in_block * SPIFFS_GC_HEUR_W_DELET + used_pages_in_block * SPIFFS_GC_HEUR_W_USED + erase_age * SPIFFS_GC_HEUR_W_ERASE_AGE; int cand_ix = 0; SPIFFS_GC_DBG("gc_check: bix:%i del:%i use:%i score:%i\n", cur_block, deleted_pages_in_block, used_pages_in_block, score); while (cand_ix < max_candidates) { if (cand_blocks[cand_ix] == (spiffs_block_ix)-1) { cand_blocks[cand_ix] = cur_block; cand_scores[cand_ix] = score; break; } else if (cand_scores[cand_ix] < score) { int reorder_cand_ix = max_candidates - 2; while (reorder_cand_ix >= cand_ix) { cand_blocks[reorder_cand_ix + 1] = cand_blocks[reorder_cand_ix]; cand_scores[reorder_cand_ix + 1] = cand_scores[reorder_cand_ix]; reorder_cand_ix--; } cand_blocks[cand_ix] = cur_block; cand_scores[cand_ix] = score; break; } cand_ix++; } (*candidate_count)++; } cur_entry = 0; cur_block++; cur_block_addr += SPIFFS_CFG_LOG_BLOCK_SZ(fs); } // per block return res; } typedef enum { FIND_OBJ_DATA, MOVE_OBJ_DATA, MOVE_OBJ_IX, FINISHED } spiffs_gc_clean_state; typedef struct { spiffs_gc_clean_state state; spiffs_obj_id cur_obj_id; spiffs_span_ix cur_objix_spix; spiffs_page_ix cur_objix_pix; int stored_scan_entry_index; u8_t obj_id_found; } spiffs_gc; // Empties given block by moving all data into free pages of another block // Strategy: // loop: // scan object lookup for object data pages // for first found id, check spix and load corresponding object index page to memory // push object scan lookup entry index // rescan object lookup, find data pages with same id and referenced by same object index // move data page, update object index in memory // when reached end of lookup, store updated object index // pop object scan lookup entry index // repeat loop until end of object lookup // scan object lookup again for remaining object index pages, move to new page in other block // s32_t spiffs_gc_clean(spiffs *fs, spiffs_block_ix bix) { s32_t res = SPIFFS_OK; u32_t entries_per_page = (SPIFFS_CFG_LOG_PAGE_SZ(fs) / sizeof(spiffs_obj_id)); int cur_entry = 0; spiffs_obj_id *obj_lu_buf = (spiffs_obj_id *)fs->lu_work; spiffs_gc gc; spiffs_page_ix cur_pix = 0; spiffs_page_object_ix_header *objix_hdr = (spiffs_page_object_ix_header *)fs->work; spiffs_page_object_ix *objix = (spiffs_page_object_ix *)fs->work; SPIFFS_GC_DBG("gc_clean: cleaning block %i\n", bix); c_memset(&gc, 0, sizeof(spiffs_gc)); gc.state = FIND_OBJ_DATA; if (fs->free_cursor_block_ix == bix) { // move free cursor to next block, cannot use free pages from the block we want to clean fs->free_cursor_block_ix = (bix+1)%fs->block_count; fs->free_cursor_obj_lu_entry = 0; SPIFFS_GC_DBG("gc_clean: move free cursor to block %i\n", fs->free_cursor_block_ix); } while (res == SPIFFS_OK && gc.state != FINISHED) { SPIFFS_GC_DBG("gc_clean: state = %i entry:%i\n", gc.state, cur_entry); gc.obj_id_found = 0; // scan through lookup pages int obj_lookup_page = cur_entry / entries_per_page; u8_t scan = 1; // check each object lookup page while (scan && res == SPIFFS_OK && obj_lookup_page < SPIFFS_OBJ_LOOKUP_PAGES(fs)) { int entry_offset = obj_lookup_page * entries_per_page; res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_LU | SPIFFS_OP_C_READ, 0, bix * SPIFFS_CFG_LOG_BLOCK_SZ(fs) + SPIFFS_PAGE_TO_PADDR(fs, obj_lookup_page), SPIFFS_CFG_LOG_PAGE_SZ(fs), fs->lu_work); // check each entry while (scan && res == SPIFFS_OK && cur_entry - entry_offset < entries_per_page && cur_entry < SPIFFS_PAGES_PER_BLOCK(fs)-SPIFFS_OBJ_LOOKUP_PAGES(fs)) { spiffs_obj_id obj_id = obj_lu_buf[cur_entry-entry_offset]; cur_pix = SPIFFS_OBJ_LOOKUP_ENTRY_TO_PIX(fs, bix, cur_entry); // act upon object id depending on gc state switch (gc.state) { case FIND_OBJ_DATA: if (obj_id != SPIFFS_OBJ_ID_DELETED && obj_id != SPIFFS_OBJ_ID_FREE && ((obj_id & SPIFFS_OBJ_ID_IX_FLAG) == 0)) { SPIFFS_GC_DBG("gc_clean: FIND_DATA state:%i - found obj id %04x\n", gc.state, obj_id); gc.obj_id_found = 1; gc.cur_obj_id = obj_id; scan = 0; } break; case MOVE_OBJ_DATA: if (obj_id == gc.cur_obj_id) { spiffs_page_header p_hdr; res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_LU2 | SPIFFS_OP_C_READ, 0, SPIFFS_PAGE_TO_PADDR(fs, cur_pix), sizeof(spiffs_page_header), (u8_t*)&p_hdr); SPIFFS_CHECK_RES(res); SPIFFS_GC_DBG("gc_clean: MOVE_DATA found data page %04x:%04x @ %04x\n", gc.cur_obj_id, p_hdr.span_ix, cur_pix); if (SPIFFS_OBJ_IX_ENTRY_SPAN_IX(fs, p_hdr.span_ix) != gc.cur_objix_spix) { SPIFFS_GC_DBG("gc_clean: MOVE_DATA no objix spix match, take in another run\n"); } else { spiffs_page_ix new_data_pix; if (p_hdr.flags & SPIFFS_PH_FLAG_DELET) { // move page res = spiffs_page_move(fs, 0, 0, obj_id, &p_hdr, cur_pix, &new_data_pix); SPIFFS_GC_DBG("gc_clean: MOVE_DATA move objix %04x:%04x page %04x to %04x\n", gc.cur_obj_id, p_hdr.span_ix, cur_pix, new_data_pix); SPIFFS_CHECK_RES(res); // move wipes obj_lu, reload it res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_LU | SPIFFS_OP_C_READ, 0, bix * SPIFFS_CFG_LOG_BLOCK_SZ(fs) + SPIFFS_PAGE_TO_PADDR(fs, obj_lookup_page), SPIFFS_CFG_LOG_PAGE_SZ(fs), fs->lu_work); SPIFFS_CHECK_RES(res); } else { // page is deleted but not deleted in lookup, scrap it SPIFFS_GC_DBG("gc_clean: MOVE_DATA wipe objix %04x:%04x page %04x\n", obj_id, p_hdr.span_ix, cur_pix); res = spiffs_page_delete(fs, cur_pix); SPIFFS_CHECK_RES(res); new_data_pix = SPIFFS_OBJ_ID_FREE; } // update memory representation of object index page with new data page if (gc.cur_objix_spix == 0) { // update object index header page ((spiffs_page_ix*)((u8_t *)objix_hdr + sizeof(spiffs_page_object_ix_header)))[p_hdr.span_ix] = new_data_pix; SPIFFS_GC_DBG("gc_clean: MOVE_DATA wrote page %04x to objix_hdr entry %02x in mem\n", new_data_pix, SPIFFS_OBJ_IX_ENTRY(fs, p_hdr.span_ix)); } else { // update object index page ((spiffs_page_ix*)((u8_t *)objix + sizeof(spiffs_page_object_ix)))[SPIFFS_OBJ_IX_ENTRY(fs, p_hdr.span_ix)] = new_data_pix; SPIFFS_GC_DBG("gc_clean: MOVE_DATA wrote page %04x to objix entry %02x in mem\n", new_data_pix, SPIFFS_OBJ_IX_ENTRY(fs, p_hdr.span_ix)); } } } break; case MOVE_OBJ_IX: if (obj_id != SPIFFS_OBJ_ID_DELETED && obj_id != SPIFFS_OBJ_ID_FREE && (obj_id & SPIFFS_OBJ_ID_IX_FLAG)) { // found an index object id spiffs_page_header p_hdr; spiffs_page_ix new_pix; // load header res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_LU2 | SPIFFS_OP_C_READ, 0, SPIFFS_PAGE_TO_PADDR(fs, cur_pix), sizeof(spiffs_page_header), (u8_t*)&p_hdr); SPIFFS_CHECK_RES(res); if (p_hdr.flags & SPIFFS_PH_FLAG_DELET) { // move page res = spiffs_page_move(fs, 0, 0, obj_id, &p_hdr, cur_pix, &new_pix); SPIFFS_GC_DBG("gc_clean: MOVE_OBJIX move objix %04x:%04x page %04x to %04x\n", obj_id, p_hdr.span_ix, cur_pix, new_pix); SPIFFS_CHECK_RES(res); spiffs_cb_object_event(fs, 0, SPIFFS_EV_IX_UPD, obj_id, p_hdr.span_ix, new_pix, 0); // move wipes obj_lu, reload it res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_LU | SPIFFS_OP_C_READ, 0, bix * SPIFFS_CFG_LOG_BLOCK_SZ(fs) + SPIFFS_PAGE_TO_PADDR(fs, obj_lookup_page), SPIFFS_CFG_LOG_PAGE_SZ(fs), fs->lu_work); SPIFFS_CHECK_RES(res); } else { // page is deleted but not deleted in lookup, scrap it SPIFFS_GC_DBG("gc_clean: MOVE_OBJIX wipe objix %04x:%04x page %04x\n", obj_id, p_hdr.span_ix, cur_pix); res = spiffs_page_delete(fs, cur_pix); if (res == SPIFFS_OK) { spiffs_cb_object_event(fs, 0, SPIFFS_EV_IX_DEL, obj_id, p_hdr.span_ix, cur_pix, 0); } } SPIFFS_CHECK_RES(res); } break; default: scan = 0; break; } cur_entry++; } // per entry obj_lookup_page++; } // per object lookup page if (res != SPIFFS_OK) break; // state finalization and switch switch (gc.state) { case FIND_OBJ_DATA: if (gc.obj_id_found) { // find out corresponding obj ix page and load it to memory spiffs_page_header p_hdr; spiffs_page_ix objix_pix; gc.stored_scan_entry_index = cur_entry; cur_entry = 0; gc.state = MOVE_OBJ_DATA; res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_LU2 | SPIFFS_OP_C_READ, 0, SPIFFS_PAGE_TO_PADDR(fs, cur_pix), sizeof(spiffs_page_header), (u8_t*)&p_hdr); SPIFFS_CHECK_RES(res); gc.cur_objix_spix = SPIFFS_OBJ_IX_ENTRY_SPAN_IX(fs, p_hdr.span_ix); SPIFFS_GC_DBG("gc_clean: FIND_DATA find objix span_ix:%04x\n", gc.cur_objix_spix); res = spiffs_obj_lu_find_id_and_span(fs, gc.cur_obj_id | SPIFFS_OBJ_ID_IX_FLAG, gc.cur_objix_spix, 0, &objix_pix); SPIFFS_CHECK_RES(res); SPIFFS_GC_DBG("gc_clean: FIND_DATA found object index at page %04x\n", objix_pix); res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_LU2 | SPIFFS_OP_C_READ, 0, SPIFFS_PAGE_TO_PADDR(fs, objix_pix), SPIFFS_CFG_LOG_PAGE_SZ(fs), fs->work); SPIFFS_CHECK_RES(res); SPIFFS_VALIDATE_OBJIX(objix->p_hdr, gc.cur_obj_id | SPIFFS_OBJ_ID_IX_FLAG, gc.cur_objix_spix); gc.cur_objix_pix = objix_pix; } else { gc.state = MOVE_OBJ_IX; cur_entry = 0; // restart entry scan index } break; case MOVE_OBJ_DATA: { // store modified objix (hdr) page spiffs_page_ix new_objix_pix; gc.state = FIND_OBJ_DATA; cur_entry = gc.stored_scan_entry_index; if (gc.cur_objix_spix == 0) { // store object index header page res = spiffs_object_update_index_hdr(fs, 0, gc.cur_obj_id | SPIFFS_OBJ_ID_IX_FLAG, gc.cur_objix_pix, fs->work, 0, 0, &new_objix_pix); SPIFFS_GC_DBG("gc_clean: MOVE_DATA store modified objix_hdr page, %04x:%04x\n", new_objix_pix, 0); SPIFFS_CHECK_RES(res); } else { // store object index page spiffs_page_ix new_objix_pix; res = spiffs_page_move(fs, 0, fs->work, gc.cur_obj_id | SPIFFS_OBJ_ID_IX_FLAG, 0, gc.cur_objix_pix, &new_objix_pix); SPIFFS_GC_DBG("gc_clean: MOVE_DATA store modified objix page, %04x:%04x\n", new_objix_pix, objix->p_hdr.span_ix); SPIFFS_CHECK_RES(res); spiffs_cb_object_event(fs, 0, SPIFFS_EV_IX_UPD, gc.cur_obj_id, objix->p_hdr.span_ix, new_objix_pix, 0); } } break; case MOVE_OBJ_IX: gc.state = FINISHED; break; default: cur_entry = 0; break; } SPIFFS_GC_DBG("gc_clean: state-> %i\n", gc.state); } // while state != FINISHED return res; } ================================================ FILE: app/spiffs/spiffs_hydrogen.c ================================================ /* * spiffs_hydrogen.c * * Created on: Jun 16, 2013 * Author: petera */ #include "spiffs.h" #include "spiffs_nucleus.h" static s32_t spiffs_fflush_cache(spiffs *fs, spiffs_file fh); #if SPIFFS_BUFFER_HELP u32_t SPIFFS_buffer_bytes_for_filedescs(spiffs *fs, u32_t num_descs) { return num_descs * sizeof(spiffs_fd); } #if SPIFFS_CACHE u32_t SPIFFS_buffer_bytes_for_cache(spiffs *fs, u32_t num_pages) { return sizeof(spiffs_cache) + num_pages * (sizeof(spiffs_cache_page) + SPIFFS_CFG_LOG_PAGE_SZ(fs)); } #endif #endif s32_t SPIFFS_mount(spiffs *fs, spiffs_config *config, u8_t *work, u8_t *fd_space, u32_t fd_space_size, void *cache, u32_t cache_size, spiffs_check_callback check_cb_f) { SPIFFS_LOCK(fs); c_memset(fs, 0, sizeof(spiffs)); c_memcpy(&fs->cfg, config, sizeof(spiffs_config)); fs->block_count = SPIFFS_CFG_PHYS_SZ(fs) / SPIFFS_CFG_LOG_BLOCK_SZ(fs); fs->work = &work[0]; fs->lu_work = &work[SPIFFS_CFG_LOG_PAGE_SZ(fs)]; c_memset(fd_space, 0, fd_space_size); // align fd_space pointer to pointer size byte boundary, below is safe u8_t ptr_size = sizeof(void*); // #pragma GCC diagnostic push // #pragma GCC diagnostic ignored "-Wpointer-to-int-cast" u8_t addr_lsb = (u8_t)(((u32_t)fd_space) & (ptr_size-1)); // #pragma GCC diagnostic pop if (addr_lsb) { fd_space += (ptr_size-addr_lsb); fd_space_size -= (ptr_size-addr_lsb); } fs->fd_space = fd_space; fs->fd_count = (fd_space_size/sizeof(spiffs_fd)); // align cache pointer to 4 byte boundary, below is safe // #pragma GCC diagnostic push // #pragma GCC diagnostic ignored "-Wpointer-to-int-cast" addr_lsb = (u8_t)(((u32_t)cache) & (ptr_size-1)); // #pragma GCC diagnostic pop if (addr_lsb) { cache = (u8_t *)cache + (ptr_size-addr_lsb); cache_size -= (ptr_size-addr_lsb); } if (cache_size & (ptr_size-1)) { cache_size -= (cache_size & (ptr_size-1)); } #if SPIFFS_CACHE fs->cache = cache; fs->cache_size = cache_size; spiffs_cache_init(fs); #endif s32_t res = spiffs_obj_lu_scan(fs); SPIFFS_API_CHECK_RES_UNLOCK(fs, res); SPIFFS_DBG("page index byte len: %i\n", SPIFFS_CFG_LOG_PAGE_SZ(fs)); SPIFFS_DBG("object lookup pages: %i\n", SPIFFS_OBJ_LOOKUP_PAGES(fs)); SPIFFS_DBG("page pages per block: %i\n", SPIFFS_PAGES_PER_BLOCK(fs)); SPIFFS_DBG("page header length: %i\n", sizeof(spiffs_page_header)); SPIFFS_DBG("object header index entries: %i\n", SPIFFS_OBJ_HDR_IX_LEN(fs)); SPIFFS_DBG("object index entries: %i\n", SPIFFS_OBJ_IX_LEN(fs)); SPIFFS_DBG("available file descriptors: %i\n", fs->fd_count); SPIFFS_DBG("free blocks: %i\n", fs->free_blocks); fs->check_cb_f = check_cb_f; SPIFFS_UNLOCK(fs); return 0; } void SPIFFS_unmount(spiffs *fs) { if (!SPIFFS_CHECK_MOUNT(fs)) return; SPIFFS_LOCK(fs); int i; spiffs_fd *fds = (spiffs_fd *)fs->fd_space; for (i = 0; i < fs->fd_count; i++) { spiffs_fd *cur_fd = &fds[i]; if (cur_fd->file_nbr != 0) { #if SPIFFS_CACHE (void)spiffs_fflush_cache(fs, cur_fd->file_nbr); #endif spiffs_fd_return(fs, cur_fd->file_nbr); } } fs->block_count = 0; SPIFFS_UNLOCK(fs); } s32_t SPIFFS_errno(spiffs *fs) { return fs->errno; } s32_t SPIFFS_creat(spiffs *fs, const char *path, spiffs_mode mode) { SPIFFS_API_CHECK_MOUNT(fs); SPIFFS_LOCK(fs); spiffs_obj_id obj_id; s32_t res; res = spiffs_obj_lu_find_free_obj_id(fs, &obj_id); SPIFFS_API_CHECK_RES_UNLOCK(fs, res); res = spiffs_object_create(fs, obj_id, (u8_t*)path, SPIFFS_TYPE_FILE, 0); SPIFFS_API_CHECK_RES_UNLOCK(fs, res); SPIFFS_UNLOCK(fs); return 0; } spiffs_file SPIFFS_open(spiffs *fs, const char *path, spiffs_flags flags, spiffs_mode mode) { SPIFFS_API_CHECK_MOUNT(fs); SPIFFS_LOCK(fs); spiffs_fd *fd; spiffs_page_ix pix; s32_t res = spiffs_fd_find_new(fs, &fd); SPIFFS_API_CHECK_RES_UNLOCK(fs, res); res = spiffs_object_find_object_index_header_by_name(fs, (u8_t*)path, &pix); if ((flags & SPIFFS_CREAT) == 0) { if (res < SPIFFS_OK) { spiffs_fd_return(fs, fd->file_nbr); } SPIFFS_API_CHECK_RES_UNLOCK(fs, res); } if ((flags & SPIFFS_CREAT) && res == SPIFFS_ERR_NOT_FOUND) { spiffs_obj_id obj_id; res = spiffs_obj_lu_find_free_obj_id(fs, &obj_id); if (res < SPIFFS_OK) { spiffs_fd_return(fs, fd->file_nbr); } SPIFFS_API_CHECK_RES_UNLOCK(fs, res); res = spiffs_object_create(fs, obj_id, (u8_t*)path, SPIFFS_TYPE_FILE, &pix); if (res < SPIFFS_OK) { spiffs_fd_return(fs, fd->file_nbr); } SPIFFS_API_CHECK_RES_UNLOCK(fs, res); flags &= ~SPIFFS_TRUNC; } else { if (res < SPIFFS_OK) { spiffs_fd_return(fs, fd->file_nbr); } SPIFFS_API_CHECK_RES_UNLOCK(fs, res); } res = spiffs_object_open_by_page(fs, pix, fd, flags, flags); if (res < SPIFFS_OK) { spiffs_fd_return(fs, fd->file_nbr); } SPIFFS_API_CHECK_RES_UNLOCK(fs, res); if (flags & SPIFFS_TRUNC) { res = spiffs_object_truncate(fd, 0, 0); if (res < SPIFFS_OK) { spiffs_fd_return(fs, fd->file_nbr); } SPIFFS_API_CHECK_RES_UNLOCK(fs, res); } fd->fdoffset = 0; SPIFFS_UNLOCK(fs); return fd->file_nbr; } s32_t SPIFFS_read(spiffs *fs, spiffs_file fh, void *buf, u32_t len) { SPIFFS_API_CHECK_MOUNT(fs); SPIFFS_LOCK(fs); spiffs_fd *fd; s32_t res; res = spiffs_fd_get(fs, fh, &fd); SPIFFS_API_CHECK_RES_UNLOCK(fs, res); if ((fd->flags & SPIFFS_RDONLY) == 0) { res = SPIFFS_ERR_NOT_READABLE; SPIFFS_API_CHECK_RES_UNLOCK(fs, res); } #if SPIFFS_CACHE_WR spiffs_fflush_cache(fs, fh); #endif if (fd->fdoffset + len >= fd->size) { // reading beyond file size s32_t avail = fd->size - fd->fdoffset; if (avail <= 0) { SPIFFS_API_CHECK_RES_UNLOCK(fs, SPIFFS_ERR_END_OF_OBJECT); } res = spiffs_object_read(fd, fd->fdoffset, avail, (u8_t*)buf); if (res == SPIFFS_OK) { fd->fdoffset += avail; SPIFFS_UNLOCK(fs); return avail; } else { SPIFFS_API_CHECK_RES_UNLOCK(fs, res); } } else { // reading within file size res = spiffs_object_read(fd, fd->fdoffset, len, (u8_t*)buf); SPIFFS_API_CHECK_RES_UNLOCK(fs, res); } fd->fdoffset += len; SPIFFS_UNLOCK(fs); return len; } static s32_t spiffs_hydro_write(spiffs *fs, spiffs_fd *fd, void *buf, u32_t offset, s32_t len) { s32_t res = SPIFFS_OK; s32_t remaining = len; if (fd->size != SPIFFS_UNDEFINED_LEN && offset < fd->size) { s32_t m_len = MIN(fd->size - offset, len); res = spiffs_object_modify(fd, offset, (u8_t *)buf, m_len); SPIFFS_CHECK_RES(res); remaining -= m_len; buf = (u8_t *)buf + m_len; offset += m_len; } if (remaining > 0) { res = spiffs_object_append(fd, offset, (u8_t *)buf, remaining); SPIFFS_CHECK_RES(res); } return len; } s32_t SPIFFS_write(spiffs *fs, spiffs_file fh, void *buf, u32_t len) { SPIFFS_API_CHECK_MOUNT(fs); SPIFFS_LOCK(fs); spiffs_fd *fd; s32_t res; u32_t offset; res = spiffs_fd_get(fs, fh, &fd); SPIFFS_API_CHECK_RES_UNLOCK(fs, res); if ((fd->flags & SPIFFS_WRONLY) == 0) { res = SPIFFS_ERR_NOT_WRITABLE; SPIFFS_API_CHECK_RES_UNLOCK(fs, res); } offset = fd->fdoffset; #if SPIFFS_CACHE_WR if (fd->cache_page == 0) { // see if object id is associated with cache already fd->cache_page = spiffs_cache_page_get_by_fd(fs, fd); } #endif if (fd->flags & SPIFFS_APPEND) { if (fd->size == SPIFFS_UNDEFINED_LEN) { offset = 0; } else { offset = fd->size; } #if SPIFFS_CACHE_WR if (fd->cache_page) { offset = MAX(offset, fd->cache_page->offset + fd->cache_page->size); } #endif } SPIFFS_DBG("SPIFFS_write %i %04x offs:%i len %i\n", fh, fd->obj_id, offset, len); #if SPIFFS_CACHE_WR if ((fd->flags & SPIFFS_DIRECT) == 0) { if (len < SPIFFS_CFG_LOG_PAGE_SZ(fs)) { // small write, try to cache it u8_t alloc_cpage = 1; if (fd->cache_page) { // have a cached page for this fd already, check cache page boundaries if (offset < fd->cache_page->offset || // writing before cache offset > fd->cache_page->offset + fd->cache_page->size || // writing after cache offset + len > fd->cache_page->offset + SPIFFS_CFG_LOG_PAGE_SZ(fs)) // writing beyond cache page { // boundary violation, write back cache first and allocate new SPIFFS_CACHE_DBG("CACHE_WR_DUMP: dumping cache page %i for fd %i:&04x, boundary viol, offs:%i size:%i\n", fd->cache_page->ix, fd->file_nbr, fd->obj_id, fd->cache_page->offset, fd->cache_page->size); res = spiffs_hydro_write(fs, fd, spiffs_get_cache_page(fs, spiffs_get_cache(fs), fd->cache_page->ix), fd->cache_page->offset, fd->cache_page->size); spiffs_cache_fd_release(fs, fd->cache_page); } else { // writing within cache alloc_cpage = 0; } } if (alloc_cpage) { fd->cache_page = spiffs_cache_page_allocate_by_fd(fs, fd); if (fd->cache_page) { fd->cache_page->offset = offset; fd->cache_page->size = 0; SPIFFS_CACHE_DBG("CACHE_WR_ALLO: allocating cache page %i for fd %i:%04x\n", fd->cache_page->ix, fd->file_nbr, fd->obj_id); } } if (fd->cache_page) { u32_t offset_in_cpage = offset - fd->cache_page->offset; SPIFFS_CACHE_DBG("CACHE_WR_WRITE: storing to cache page %i for fd %i:%04x, offs %i:%i len %i\n", fd->cache_page->ix, fd->file_nbr, fd->obj_id, offset, offset_in_cpage, len); spiffs_cache *cache = spiffs_get_cache(fs); u8_t *cpage_data = spiffs_get_cache_page(fs, cache, fd->cache_page->ix); c_memcpy(&cpage_data[offset_in_cpage], buf, len); fd->cache_page->size = MAX(fd->cache_page->size, offset_in_cpage + len); fd->fdoffset += len; SPIFFS_UNLOCK(fs); return len; } else { res = spiffs_hydro_write(fs, fd, buf, offset, len); SPIFFS_API_CHECK_RES(fs, res); fd->fdoffset += len; SPIFFS_UNLOCK(fs); return res; } } else { // big write, no need to cache it - but first check if there is a cached write already if (fd->cache_page) { // write back cache first SPIFFS_CACHE_DBG("CACHE_WR_DUMP: dumping cache page %i for fd %i:%04x, big write, offs:%i size:%i\n", fd->cache_page->ix, fd->file_nbr, fd->obj_id, fd->cache_page->offset, fd->cache_page->size); res = spiffs_hydro_write(fs, fd, spiffs_get_cache_page(fs, spiffs_get_cache(fs), fd->cache_page->ix), fd->cache_page->offset, fd->cache_page->size); spiffs_cache_fd_release(fs, fd->cache_page); res = spiffs_hydro_write(fs, fd, buf, offset, len); SPIFFS_API_CHECK_RES(fs, res); } } } #endif res = spiffs_hydro_write(fs, fd, buf, offset, len); SPIFFS_API_CHECK_RES(fs, res); fd->fdoffset += len; SPIFFS_UNLOCK(fs); return res; } s32_t SPIFFS_lseek(spiffs *fs, spiffs_file fh, s32_t offs, int whence) { SPIFFS_API_CHECK_MOUNT(fs); SPIFFS_LOCK(fs); spiffs_fd *fd; s32_t res; res = spiffs_fd_get(fs, fh, &fd); SPIFFS_API_CHECK_RES(fs, res); #if SPIFFS_CACHE_WR spiffs_fflush_cache(fs, fh); #endif switch (whence) { case SPIFFS_SEEK_CUR: offs = fd->fdoffset+offs; break; case SPIFFS_SEEK_END: offs = (fd->size == SPIFFS_UNDEFINED_LEN ? 0 : fd->size) + offs; break; } if (offs > fd->size) { res = SPIFFS_ERR_END_OF_OBJECT; } SPIFFS_API_CHECK_RES_UNLOCK(fs, res); spiffs_span_ix data_spix = offs / SPIFFS_DATA_PAGE_SIZE(fs); spiffs_span_ix objix_spix = SPIFFS_OBJ_IX_ENTRY_SPAN_IX(fs, data_spix); if (fd->cursor_objix_spix != objix_spix) { spiffs_page_ix pix; res = spiffs_obj_lu_find_id_and_span( fs, fd->obj_id | SPIFFS_OBJ_ID_IX_FLAG, objix_spix, 0, &pix); SPIFFS_API_CHECK_RES_UNLOCK(fs, res); fd->cursor_objix_spix = objix_spix; fd->cursor_objix_pix = pix; } fd->fdoffset = offs; SPIFFS_UNLOCK(fs); return 0; } s32_t SPIFFS_remove(spiffs *fs, const char *path) { SPIFFS_API_CHECK_MOUNT(fs); SPIFFS_LOCK(fs); spiffs_fd *fd; spiffs_page_ix pix; s32_t res; res = spiffs_fd_find_new(fs, &fd); SPIFFS_API_CHECK_RES_UNLOCK(fs, res); res = spiffs_object_find_object_index_header_by_name(fs, (u8_t*)path, &pix); if (res != SPIFFS_OK) { spiffs_fd_return(fs, fd->file_nbr); } SPIFFS_API_CHECK_RES_UNLOCK(fs, res); res = spiffs_object_open_by_page(fs, pix, fd, 0,0); if (res != SPIFFS_OK) { spiffs_fd_return(fs, fd->file_nbr); } SPIFFS_API_CHECK_RES_UNLOCK(fs, res); res = spiffs_object_truncate(fd, 0, 1); if (res != SPIFFS_OK) { spiffs_fd_return(fs, fd->file_nbr); } SPIFFS_API_CHECK_RES_UNLOCK(fs, res); SPIFFS_UNLOCK(fs); return 0; } s32_t SPIFFS_fremove(spiffs *fs, spiffs_file fh) { SPIFFS_API_CHECK_MOUNT(fs); SPIFFS_LOCK(fs); spiffs_fd *fd; s32_t res; res = spiffs_fd_get(fs, fh, &fd); SPIFFS_API_CHECK_RES_UNLOCK(fs, res); if ((fd->flags & SPIFFS_WRONLY) == 0) { res = SPIFFS_ERR_NOT_WRITABLE; SPIFFS_API_CHECK_RES_UNLOCK(fs, res); } #if SPIFFS_CACHE_WR spiffs_cache_fd_release(fs, fd->cache_page); #endif res = spiffs_object_truncate(fd, 0, 1); SPIFFS_API_CHECK_RES_UNLOCK(fs, res); SPIFFS_UNLOCK(fs); return 0; } static s32_t spiffs_stat_pix(spiffs *fs, spiffs_page_ix pix, spiffs_file fh, spiffs_stat *s) { spiffs_page_object_ix_header objix_hdr; spiffs_obj_id obj_id; s32_t res =_spiffs_rd(fs, SPIFFS_OP_T_OBJ_IX | SPIFFS_OP_C_READ, fh, SPIFFS_PAGE_TO_PADDR(fs, pix), sizeof(spiffs_page_object_ix_header), (u8_t *)&objix_hdr); SPIFFS_API_CHECK_RES(fs, res); u32_t obj_id_addr = SPIFFS_BLOCK_TO_PADDR(fs, SPIFFS_BLOCK_FOR_PAGE(fs , pix)) + SPIFFS_OBJ_LOOKUP_ENTRY_FOR_PAGE(fs, pix) * sizeof(spiffs_obj_id); res =_spiffs_rd(fs, SPIFFS_OP_T_OBJ_LU | SPIFFS_OP_C_READ, fh, obj_id_addr, sizeof(spiffs_obj_id), (u8_t *)&obj_id); SPIFFS_API_CHECK_RES(fs, res); s->obj_id = obj_id; s->type = objix_hdr.type; s->size = objix_hdr.size == SPIFFS_UNDEFINED_LEN ? 0 : objix_hdr.size; strncpy((char *)s->name, (char *)objix_hdr.name, SPIFFS_OBJ_NAME_LEN); return res; } s32_t SPIFFS_stat(spiffs *fs, const char *path, spiffs_stat *s) { SPIFFS_API_CHECK_MOUNT(fs); SPIFFS_LOCK(fs); s32_t res; spiffs_page_ix pix; res = spiffs_object_find_object_index_header_by_name(fs, (u8_t*)path, &pix); SPIFFS_API_CHECK_RES_UNLOCK(fs, res); res = spiffs_stat_pix(fs, pix, 0, s); SPIFFS_UNLOCK(fs); return res; } s32_t SPIFFS_fstat(spiffs *fs, spiffs_file fh, spiffs_stat *s) { SPIFFS_API_CHECK_MOUNT(fs); SPIFFS_LOCK(fs); spiffs_fd *fd; s32_t res; res = spiffs_fd_get(fs, fh, &fd); SPIFFS_API_CHECK_RES_UNLOCK(fs, res); #if SPIFFS_CACHE_WR spiffs_fflush_cache(fs, fh); #endif res = spiffs_stat_pix(fs, fd->objix_hdr_pix, fh, s); SPIFFS_UNLOCK(fs); return res; } // Checks if there are any cached writes for the object id associated with // given filehandle. If so, these writes are flushed. static s32_t spiffs_fflush_cache(spiffs *fs, spiffs_file fh) { s32_t res = SPIFFS_OK; #if SPIFFS_CACHE_WR spiffs_fd *fd; res = spiffs_fd_get(fs, fh, &fd); SPIFFS_API_CHECK_RES(fs, res); if ((fd->flags & SPIFFS_DIRECT) == 0) { if (fd->cache_page == 0) { // see if object id is associated with cache already fd->cache_page = spiffs_cache_page_get_by_fd(fs, fd); } if (fd->cache_page) { SPIFFS_CACHE_DBG("CACHE_WR_DUMP: dumping cache page %i for fd %i:%04x, flush, offs:%i size:%i\n", fd->cache_page->ix, fd->file_nbr, fd->obj_id, fd->cache_page->offset, fd->cache_page->size); res = spiffs_hydro_write(fs, fd, spiffs_get_cache_page(fs, spiffs_get_cache(fs), fd->cache_page->ix), fd->cache_page->offset, fd->cache_page->size); if (res < SPIFFS_OK) { fs->errno = res; } spiffs_cache_fd_release(fs, fd->cache_page); } } #endif return res; } s32_t SPIFFS_fflush(spiffs *fs, spiffs_file fh) { SPIFFS_API_CHECK_MOUNT(fs); s32_t res = SPIFFS_OK; #if SPIFFS_CACHE_WR SPIFFS_LOCK(fs); res = spiffs_fflush_cache(fs, fh); SPIFFS_API_CHECK_RES_UNLOCK(fs,res); SPIFFS_UNLOCK(fs); #endif return res; } void SPIFFS_close(spiffs *fs, spiffs_file fh) { if (!SPIFFS_CHECK_MOUNT(fs)) { fs->errno = SPIFFS_ERR_NOT_MOUNTED; return; } SPIFFS_LOCK(fs); #if SPIFFS_CACHE spiffs_fflush_cache(fs, fh); #endif spiffs_fd_return(fs, fh); SPIFFS_UNLOCK(fs); } spiffs_DIR *SPIFFS_opendir(spiffs *fs, const char *name, spiffs_DIR *d) { if (!SPIFFS_CHECK_MOUNT(fs)) { fs->errno = SPIFFS_ERR_NOT_MOUNTED; return 0; } d->fs = fs; d->block = 0; d->entry = 0; return d; } static s32_t spiffs_read_dir_v( spiffs *fs, spiffs_obj_id obj_id, spiffs_block_ix bix, int ix_entry, u32_t user_data, void *user_p) { s32_t res; spiffs_page_object_ix_header objix_hdr; if (obj_id == SPIFFS_OBJ_ID_FREE || obj_id == SPIFFS_OBJ_ID_DELETED || (obj_id & SPIFFS_OBJ_ID_IX_FLAG) == 0) { return SPIFFS_VIS_COUNTINUE; } spiffs_page_ix pix = SPIFFS_OBJ_LOOKUP_ENTRY_TO_PIX(fs, bix, ix_entry); res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_LU2 | SPIFFS_OP_C_READ, 0, SPIFFS_PAGE_TO_PADDR(fs, pix), sizeof(spiffs_page_object_ix_header), (u8_t *)&objix_hdr); if (res != SPIFFS_OK) return res; if ((obj_id & SPIFFS_OBJ_ID_IX_FLAG) && objix_hdr.p_hdr.span_ix == 0 && (objix_hdr.p_hdr.flags& (SPIFFS_PH_FLAG_DELET | SPIFFS_PH_FLAG_FINAL | SPIFFS_PH_FLAG_IXDELE)) == (SPIFFS_PH_FLAG_DELET | SPIFFS_PH_FLAG_IXDELE)) { struct spiffs_dirent *e = (struct spiffs_dirent *)user_p; e->obj_id = obj_id; strcpy((char *)e->name, (char *)objix_hdr.name); e->type = objix_hdr.type; e->size = objix_hdr.size == SPIFFS_UNDEFINED_LEN ? 0 : objix_hdr.size; return SPIFFS_OK; } return SPIFFS_VIS_COUNTINUE; } struct spiffs_dirent *SPIFFS_readdir(spiffs_DIR *d, struct spiffs_dirent *e) { if (!SPIFFS_CHECK_MOUNT(d->fs)) { d->fs->errno = SPIFFS_ERR_NOT_MOUNTED; return 0; } SPIFFS_LOCK(fs); spiffs_block_ix bix; int entry; s32_t res; struct spiffs_dirent *ret = 0; res = spiffs_obj_lu_find_entry_visitor(d->fs, d->block, d->entry, SPIFFS_VIS_NO_WRAP, 0, spiffs_read_dir_v, 0, e, &bix, &entry); if (res == SPIFFS_OK) { d->block = bix; d->entry = entry + 1; ret = e; } else { d->fs->errno = res; } SPIFFS_UNLOCK(fs); return ret; } s32_t SPIFFS_closedir(spiffs_DIR *d) { SPIFFS_API_CHECK_MOUNT(d->fs); return 0; } s32_t SPIFFS_check(spiffs *fs) { s32_t res; SPIFFS_API_CHECK_MOUNT(fs); SPIFFS_LOCK(fs); res = spiffs_lookup_consistency_check(fs, 0); res = spiffs_object_index_consistency_check(fs); // NODE_ERR("before spiffs_object_index_consistency_check\n"); res = spiffs_page_consistency_check(fs); // NODE_ERR("spiffs_page_consistency_check\n"); res = spiffs_obj_lu_scan(fs); // NODE_ERR("spiffs_obj_lu_scan\n"); SPIFFS_UNLOCK(fs); return res; } s32_t SPIFFS_eof(spiffs *fs, spiffs_file fh) { SPIFFS_API_CHECK_MOUNT(fs); SPIFFS_LOCK(fs); spiffs_fd *fd; s32_t res; res = spiffs_fd_get(fs, fh, &fd); SPIFFS_API_CHECK_RES(fs, res); #if SPIFFS_CACHE_WR spiffs_fflush_cache(fs, fh); #endif res = (fd->fdoffset == fd->size); SPIFFS_UNLOCK(fs); return res; } s32_t SPIFFS_tell(spiffs *fs, spiffs_file fh) { SPIFFS_API_CHECK_MOUNT(fs); SPIFFS_LOCK(fs); spiffs_fd *fd; s32_t res; res = spiffs_fd_get(fs, fh, &fd); SPIFFS_API_CHECK_RES(fs, res); #if SPIFFS_CACHE_WR spiffs_fflush_cache(fs, fh); #endif res = fd->fdoffset; SPIFFS_UNLOCK(fs); return res; } #if SPIFFS_TEST_VISUALISATION s32_t SPIFFS_vis(spiffs *fs) { s32_t res = SPIFFS_OK; SPIFFS_API_CHECK_MOUNT(fs); SPIFFS_LOCK(fs); u32_t entries_per_page = (SPIFFS_CFG_LOG_PAGE_SZ(fs) / sizeof(spiffs_obj_id)); spiffs_obj_id *obj_lu_buf = (spiffs_obj_id *)fs->lu_work; spiffs_block_ix bix = 0; while (bix < fs->block_count) { // check each object lookup page int obj_lookup_page = 0; int cur_entry = 0; while (res == SPIFFS_OK && obj_lookup_page < SPIFFS_OBJ_LOOKUP_PAGES(fs)) { int entry_offset = obj_lookup_page * entries_per_page; res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_LU | SPIFFS_OP_C_READ, 0, bix * SPIFFS_CFG_LOG_BLOCK_SZ(fs) + SPIFFS_PAGE_TO_PADDR(fs, obj_lookup_page), SPIFFS_CFG_LOG_PAGE_SZ(fs), fs->lu_work); // check each entry while (res == SPIFFS_OK && cur_entry - entry_offset < entries_per_page && cur_entry < SPIFFS_PAGES_PER_BLOCK(fs)-SPIFFS_OBJ_LOOKUP_PAGES(fs)) { spiffs_obj_id obj_id = obj_lu_buf[cur_entry-entry_offset]; if (cur_entry == 0) { spiffs_printf("%4i ", bix); } else if ((cur_entry & 0x3f) == 0) { spiffs_printf(" "); } if (obj_id == SPIFFS_OBJ_ID_FREE) { spiffs_printf(SPIFFS_TEST_VIS_FREE_STR); } else if (obj_id == SPIFFS_OBJ_ID_DELETED) { spiffs_printf(SPIFFS_TEST_VIS_DELE_STR); } else if (obj_id & SPIFFS_OBJ_ID_IX_FLAG){ spiffs_printf(SPIFFS_TEST_VIS_INDX_STR(obj_id)); } else { spiffs_printf(SPIFFS_TEST_VIS_DATA_STR(obj_id)); } cur_entry++; if ((cur_entry & 0x3f) == 0) { spiffs_printf("\n"); } } // per entry obj_lookup_page++; } // per object lookup page spiffs_obj_id erase_count; res = _spiffs_rd(fs, SPIFFS_OP_C_READ | SPIFFS_OP_T_OBJ_LU2, 0, SPIFFS_ERASE_COUNT_PADDR(fs, bix), sizeof(spiffs_obj_id), (u8_t *)&erase_count); SPIFFS_CHECK_RES(res); if (erase_count != (spiffs_obj_id)-1) { spiffs_printf("\tera_cnt: %i\n", erase_count); } else { spiffs_printf("\tera_cnt: N/A\n"); } bix++; } // per block spiffs_printf("era_cnt_max: %i\n", fs->max_erase_count); spiffs_printf("last_errno: %i\n", fs->errno); spiffs_printf("blocks: %i\n", fs->block_count); spiffs_printf("free_blocks: %i\n", fs->free_blocks); spiffs_printf("page_alloc: %i\n", fs->stats_p_allocated); spiffs_printf("page_delet: %i\n", fs->stats_p_deleted); SPIFFS_UNLOCK(fs); return res; } #endif ================================================ FILE: app/spiffs/spiffs_nucleus.c ================================================ #include "spiffs.h" #include "spiffs_nucleus.h" static s32_t spiffs_page_data_check(spiffs *fs, spiffs_fd *fd, spiffs_page_ix pix, spiffs_span_ix spix) { s32_t res = SPIFFS_OK; if (pix == (spiffs_page_ix)-1) { // referring to page 0xffff...., bad object index return SPIFFS_ERR_INDEX_REF_FREE; } if (pix % SPIFFS_PAGES_PER_BLOCK(fs) < SPIFFS_OBJ_LOOKUP_PAGES(fs)) { // referring to an object lookup page, bad object index return SPIFFS_ERR_INDEX_REF_LU; } if (pix > SPIFFS_MAX_PAGES(fs)) { // referring to a bad page return SPIFFS_ERR_INDEX_REF_INVALID; } #if SPIFFS_PAGE_CHECK spiffs_page_header ph; res = _spiffs_rd( fs, SPIFFS_OP_T_OBJ_DA | SPIFFS_OP_C_READ, fd->file_nbr, SPIFFS_PAGE_TO_PADDR(fs, pix), sizeof(spiffs_page_header), (u8_t *)&ph); SPIFFS_CHECK_RES(res); SPIFFS_VALIDATE_DATA(ph, fd->obj_id & ~SPIFFS_OBJ_ID_IX_FLAG, spix); #endif return res; } static s32_t spiffs_page_index_check(spiffs *fs, spiffs_fd *fd, spiffs_page_ix pix, spiffs_span_ix spix) { s32_t res = SPIFFS_OK; if (pix == (spiffs_page_ix)-1) { // referring to page 0xffff...., bad object index return SPIFFS_ERR_INDEX_FREE; } if (pix % SPIFFS_PAGES_PER_BLOCK(fs) < SPIFFS_OBJ_LOOKUP_PAGES(fs)) { // referring to an object lookup page, bad object index return SPIFFS_ERR_INDEX_LU; } if (pix > SPIFFS_MAX_PAGES(fs)) { // referring to a bad page return SPIFFS_ERR_INDEX_INVALID; } #if SPIFFS_PAGE_CHECK spiffs_page_header ph; res = _spiffs_rd( fs, SPIFFS_OP_T_OBJ_IX | SPIFFS_OP_C_READ, fd->file_nbr, SPIFFS_PAGE_TO_PADDR(fs, pix), sizeof(spiffs_page_header), (u8_t *)&ph); SPIFFS_CHECK_RES(res); SPIFFS_VALIDATE_OBJIX(ph, fd->obj_id, spix); #endif return res; } #if !SPIFFS_CACHE s32_t spiffs_phys_rd( spiffs *fs, u32_t addr, u32_t len, u8_t *dst) { return fs->cfg.hal_read_f(addr, len, dst); } s32_t spiffs_phys_wr( spiffs *fs, u32_t addr, u32_t len, u8_t *src) { return fs->cfg.hal_write_f(addr, len, src); } #endif s32_t spiffs_phys_cpy( spiffs *fs, spiffs_file fh, u32_t dst, u32_t src, u32_t len) { s32_t res; u8_t b[SPIFFS_COPY_BUFFER_STACK]; while (len > 0) { u32_t chunk_size = MIN(SPIFFS_COPY_BUFFER_STACK, len); res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_DA | SPIFFS_OP_C_MOVS, fh, src, chunk_size, b); SPIFFS_CHECK_RES(res); res = _spiffs_wr(fs, SPIFFS_OP_T_OBJ_DA | SPIFFS_OP_C_MOVD, fh, dst, chunk_size, b); SPIFFS_CHECK_RES(res); len -= chunk_size; src += chunk_size; dst += chunk_size; } return SPIFFS_OK; } // Find object lookup entry containing given id with visitor. // Iterate over object lookup pages in each block until a given object id entry is found. // When found, the visitor function is called with block index, entry index and user_data. // If visitor returns SPIFFS_VIS_CONTINUE, the search goes on. Otherwise, the search will be // ended and visitor's return code is returned to caller. // If no visitor is given (0) the search returns on first entry with matching object id. // If no match is found in all look up, SPIFFS_VIS_END is returned. // @param fs the file system // @param starting_block the starting block to start search in // @param starting_lu_entry the look up index entry to start search in // @param flags ored combination of SPIFFS_VIS_CHECK_ID, SPIFFS_VIS_CHECK_PH, // SPIFFS_VIS_NO_WRAP // @param obj_id argument object id // @param v visitor callback function // @param user_data any data, passed to the callback visitor function // @param user_p any pointer, passed to the callback visitor function // @param block_ix reported block index where match was found // @param lu_entry reported look up index where match was found s32_t spiffs_obj_lu_find_entry_visitor( spiffs *fs, spiffs_block_ix starting_block, int starting_lu_entry, u8_t flags, spiffs_obj_id obj_id, spiffs_visitor_f v, u32_t user_data, void *user_p, spiffs_block_ix *block_ix, int *lu_entry) { s32_t res = SPIFFS_OK; s32_t entry_count = fs->block_count * SPIFFS_OBJ_LOOKUP_MAX_ENTRIES(fs); spiffs_block_ix cur_block = starting_block; u32_t cur_block_addr = starting_block * SPIFFS_CFG_LOG_BLOCK_SZ(fs); spiffs_obj_id *obj_lu_buf = (spiffs_obj_id *)fs->lu_work; int cur_entry = starting_lu_entry; u32_t entries_per_page = (SPIFFS_CFG_LOG_PAGE_SZ(fs) / sizeof(spiffs_obj_id)); // wrap initial if (cur_entry >= SPIFFS_OBJ_LOOKUP_MAX_ENTRIES(fs) - 1) { cur_entry = 0; cur_block++; cur_block_addr = cur_block * SPIFFS_CFG_LOG_BLOCK_SZ(fs); if (cur_block >= fs->block_count) { // block wrap cur_block = 0; cur_block_addr = 0; } } // check each block while (res == SPIFFS_OK && entry_count > 0) { int obj_lookup_page = cur_entry / entries_per_page; // check each object lookup page while (res == SPIFFS_OK && obj_lookup_page < SPIFFS_OBJ_LOOKUP_PAGES(fs)) { int entry_offset = obj_lookup_page * entries_per_page; res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_LU | SPIFFS_OP_C_READ, 0, cur_block_addr + SPIFFS_PAGE_TO_PADDR(fs, obj_lookup_page), SPIFFS_CFG_LOG_PAGE_SZ(fs), fs->lu_work); // check each entry while (res == SPIFFS_OK && cur_entry - entry_offset < entries_per_page && // for non-last obj lookup pages cur_entry < SPIFFS_OBJ_LOOKUP_MAX_ENTRIES(fs)) // for last obj lookup page { if ((flags & SPIFFS_VIS_CHECK_ID) == 0 || obj_lu_buf[cur_entry-entry_offset] == obj_id) { if (block_ix) *block_ix = cur_block; if (lu_entry) *lu_entry = cur_entry; if (v) { res = v( fs, (flags & SPIFFS_VIS_CHECK_PH) ? obj_id : obj_lu_buf[cur_entry-entry_offset], cur_block, cur_entry, user_data, user_p); if (res == SPIFFS_VIS_COUNTINUE || res == SPIFFS_VIS_COUNTINUE_RELOAD) { if (res == SPIFFS_VIS_COUNTINUE_RELOAD) { res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_LU | SPIFFS_OP_C_READ, 0, cur_block_addr + SPIFFS_PAGE_TO_PADDR(fs, obj_lookup_page), SPIFFS_CFG_LOG_PAGE_SZ(fs), fs->lu_work); SPIFFS_CHECK_RES(res); } res = SPIFFS_OK; cur_entry++; entry_count--; continue; } else { return res; } } else { return SPIFFS_OK; } } entry_count--; cur_entry++; } // per entry obj_lookup_page++; } // per object lookup page cur_entry = 0; cur_block++; cur_block_addr += SPIFFS_CFG_LOG_BLOCK_SZ(fs); if (cur_block >= fs->block_count) { if (flags & SPIFFS_VIS_NO_WRAP) { return SPIFFS_VIS_END; } else { // block wrap cur_block = 0; cur_block_addr = 0; } } } // per block SPIFFS_CHECK_RES(res); return SPIFFS_VIS_END; } static s32_t spiffs_obj_lu_scan_v( spiffs *fs, spiffs_obj_id obj_id, spiffs_block_ix bix, int ix_entry, u32_t user_data, void *user_p) { if (obj_id == SPIFFS_OBJ_ID_FREE) { if (ix_entry == 0) { fs->free_blocks++; // todo optimize further, return SPIFFS_NEXT_BLOCK } } else if (obj_id == SPIFFS_OBJ_ID_DELETED) { fs->stats_p_deleted++; } else { fs->stats_p_allocated++; } return SPIFFS_VIS_COUNTINUE; } // Scans thru all obj lu and counts free, deleted and used pages // Find the maximum block erase count s32_t spiffs_obj_lu_scan( spiffs *fs) { s32_t res; spiffs_block_ix bix; int entry; fs->free_blocks = 0; fs->stats_p_allocated = 0; fs->stats_p_deleted = 0; res = spiffs_obj_lu_find_entry_visitor(fs, 0, 0, 0, 0, spiffs_obj_lu_scan_v, 0, 0, &bix, &entry); if (res == SPIFFS_VIS_END) { res = SPIFFS_OK; } SPIFFS_CHECK_RES(res); bix = 0; spiffs_obj_id erase_count_final; spiffs_obj_id erase_count_min = SPIFFS_OBJ_ID_FREE; spiffs_obj_id erase_count_max = 0; while (bix < fs->block_count) { spiffs_obj_id erase_count; res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_LU2 | SPIFFS_OP_C_READ, 0, SPIFFS_ERASE_COUNT_PADDR(fs, bix) , sizeof(spiffs_obj_id), (u8_t *)&erase_count); SPIFFS_CHECK_RES(res); if (erase_count != SPIFFS_OBJ_ID_FREE) { erase_count_min = MIN(erase_count_min, erase_count); erase_count_max = MAX(erase_count_max, erase_count); } bix++; } if (erase_count_min == 0 && erase_count_max == SPIFFS_OBJ_ID_FREE) { // clean system, set counter to zero erase_count_final = 0; } else if (erase_count_max - erase_count_min > (SPIFFS_OBJ_ID_FREE)/2) { // wrap, take min erase_count_final = erase_count_min+1; } else { erase_count_final = erase_count_max+1; } fs->max_erase_count = erase_count_final; return res; } // Find free object lookup entry // Iterate over object lookup pages in each block until a free object id entry is found s32_t spiffs_obj_lu_find_free( spiffs *fs, spiffs_block_ix starting_block, int starting_lu_entry, spiffs_block_ix *block_ix, int *lu_entry) { s32_t res; if (!fs->cleaning && fs->free_blocks < 2) { res = spiffs_gc_quick(fs); SPIFFS_CHECK_RES(res); if (fs->free_blocks < 2) { return SPIFFS_ERR_FULL; } } res = spiffs_obj_lu_find_id(fs, starting_block, starting_lu_entry, SPIFFS_OBJ_ID_FREE, block_ix, lu_entry); if (res == SPIFFS_OK) { fs->free_cursor_block_ix = *block_ix; fs->free_cursor_obj_lu_entry = *lu_entry; if (*lu_entry == 0) { fs->free_blocks--; } } if (res == SPIFFS_VIS_END) { SPIFFS_DBG("fs full\n"); } return res == SPIFFS_VIS_END ? SPIFFS_ERR_FULL : res; } // Find object lookup entry containing given id // Iterate over object lookup pages in each block until a given object id entry is found s32_t spiffs_obj_lu_find_id( spiffs *fs, spiffs_block_ix starting_block, int starting_lu_entry, spiffs_obj_id obj_id, spiffs_block_ix *block_ix, int *lu_entry) { s32_t res = spiffs_obj_lu_find_entry_visitor( fs, starting_block, starting_lu_entry, SPIFFS_VIS_CHECK_ID, obj_id, 0, 0, 0, block_ix, lu_entry); if (res == SPIFFS_VIS_END) { res = SPIFFS_ERR_NOT_FOUND; } return res; } static s32_t spiffs_obj_lu_find_id_and_span_v( spiffs *fs, spiffs_obj_id obj_id, spiffs_block_ix bix, int ix_entry, u32_t user_data, void *user_p) { s32_t res; spiffs_page_header ph; spiffs_page_ix pix = SPIFFS_OBJ_LOOKUP_ENTRY_TO_PIX(fs, bix, ix_entry); res = _spiffs_rd(fs, 0, SPIFFS_OP_T_OBJ_LU2 | SPIFFS_OP_C_READ, SPIFFS_PAGE_TO_PADDR(fs, pix), sizeof(spiffs_page_header), (u8_t *)&ph); SPIFFS_CHECK_RES(res); if (ph.obj_id == obj_id && ph.span_ix == (spiffs_span_ix)user_data && (ph.flags & (SPIFFS_PH_FLAG_FINAL | SPIFFS_PH_FLAG_DELET | SPIFFS_PH_FLAG_USED)) == SPIFFS_PH_FLAG_DELET && !((obj_id & SPIFFS_OBJ_ID_IX_FLAG) && (ph.flags & SPIFFS_PH_FLAG_IXDELE) == 0 && ph.span_ix == 0) && (user_p == 0 || *((spiffs_page_ix *)user_p) != pix)) { return SPIFFS_OK; } else { return SPIFFS_VIS_COUNTINUE; } } // Find object lookup entry containing given id and span index // Iterate over object lookup pages in each block until a given object id entry is found s32_t spiffs_obj_lu_find_id_and_span( spiffs *fs, spiffs_obj_id obj_id, spiffs_span_ix spix, spiffs_page_ix exclusion_pix, spiffs_page_ix *pix) { s32_t res; spiffs_block_ix bix; int entry; res = spiffs_obj_lu_find_entry_visitor(fs, fs->cursor_block_ix, fs->cursor_obj_lu_entry, SPIFFS_VIS_CHECK_ID, obj_id, spiffs_obj_lu_find_id_and_span_v, (u32_t)spix, exclusion_pix ? &exclusion_pix : 0, &bix, &entry); if (res == SPIFFS_VIS_END) { res = SPIFFS_ERR_NOT_FOUND; } SPIFFS_CHECK_RES(res); if (pix) { *pix = SPIFFS_OBJ_LOOKUP_ENTRY_TO_PIX(fs, bix, entry); } fs->cursor_block_ix = bix; fs->cursor_obj_lu_entry = entry; return res; } // Find object lookup entry containing given id and span index in page headers only // Iterate over object lookup pages in each block until a given object id entry is found s32_t spiffs_obj_lu_find_id_and_span_by_phdr( spiffs *fs, spiffs_obj_id obj_id, spiffs_span_ix spix, spiffs_page_ix exclusion_pix, spiffs_page_ix *pix) { s32_t res; spiffs_block_ix bix; int entry; res = spiffs_obj_lu_find_entry_visitor(fs, fs->cursor_block_ix, fs->cursor_obj_lu_entry, SPIFFS_VIS_CHECK_PH, obj_id, spiffs_obj_lu_find_id_and_span_v, (u32_t)spix, exclusion_pix ? &exclusion_pix : 0, &bix, &entry); if (res == SPIFFS_VIS_END) { res = SPIFFS_ERR_NOT_FOUND; } SPIFFS_CHECK_RES(res); if (pix) { *pix = SPIFFS_OBJ_LOOKUP_ENTRY_TO_PIX(fs, bix, entry); } fs->cursor_block_ix = bix; fs->cursor_obj_lu_entry = entry; return res; } // Allocates a free defined page with given obj_id // Occupies object lookup entry and page // data may be NULL; where only page header is stored, len and page_offs is ignored s32_t spiffs_page_allocate_data( spiffs *fs, spiffs_obj_id obj_id, spiffs_page_header *ph, u8_t *data, u32_t len, u32_t page_offs, u8_t finalize, spiffs_page_ix *pix) { s32_t res = SPIFFS_OK; spiffs_block_ix bix; int entry; // find free entry res = spiffs_obj_lu_find_free(fs, fs->free_cursor_block_ix, fs->free_cursor_obj_lu_entry, &bix, &entry); SPIFFS_CHECK_RES(res); // occupy page in object lookup res = _spiffs_wr(fs, SPIFFS_OP_T_OBJ_LU | SPIFFS_OP_C_UPDT, 0, SPIFFS_BLOCK_TO_PADDR(fs, bix) + entry * sizeof(spiffs_obj_id), sizeof(spiffs_obj_id), (u8_t*)&obj_id); SPIFFS_CHECK_RES(res); fs->stats_p_allocated++; // write page header ph->flags &= ~SPIFFS_PH_FLAG_USED; res = _spiffs_wr(fs, SPIFFS_OP_T_OBJ_DA | SPIFFS_OP_C_UPDT, 0, SPIFFS_OBJ_LOOKUP_ENTRY_TO_PADDR(fs, bix, entry), sizeof(spiffs_page_header), (u8_t*)ph); SPIFFS_CHECK_RES(res); // write page data if (data) { res = _spiffs_wr(fs, SPIFFS_OP_T_OBJ_DA | SPIFFS_OP_C_UPDT, 0,SPIFFS_OBJ_LOOKUP_ENTRY_TO_PADDR(fs, bix, entry) + sizeof(spiffs_page_header) + page_offs, len, data); SPIFFS_CHECK_RES(res); } // finalize header if necessary if (finalize && (ph->flags & SPIFFS_PH_FLAG_FINAL)) { ph->flags &= ~SPIFFS_PH_FLAG_FINAL; res = _spiffs_wr(fs, SPIFFS_OP_T_OBJ_DA | SPIFFS_OP_C_UPDT, 0, SPIFFS_OBJ_LOOKUP_ENTRY_TO_PADDR(fs, bix, entry) + offsetof(spiffs_page_header, flags), sizeof(u8_t), (u8_t *)&ph->flags); SPIFFS_CHECK_RES(res); } // return written page if (pix) { *pix = SPIFFS_OBJ_LOOKUP_ENTRY_TO_PIX(fs, bix, entry); } return res; } // Moves a page from src to a free page and finalizes it. Updates page index. Page data is given in param page. // If page data is null, provided header is used for metainfo and page data is physically copied. s32_t spiffs_page_move( spiffs *fs, spiffs_file fh, u8_t *page_data, spiffs_obj_id obj_id, spiffs_page_header *page_hdr, spiffs_page_ix src_pix, spiffs_page_ix *dst_pix) { s32_t res; u8_t was_final = 0; spiffs_page_header *p_hdr; spiffs_block_ix bix; int entry; spiffs_page_ix free_pix; // find free entry res = spiffs_obj_lu_find_free(fs, fs->free_cursor_block_ix, fs->free_cursor_obj_lu_entry, &bix, &entry); SPIFFS_CHECK_RES(res); free_pix = SPIFFS_OBJ_LOOKUP_ENTRY_TO_PIX(fs, bix, entry); if (dst_pix) *dst_pix = free_pix; p_hdr = page_data ? (spiffs_page_header *)page_data : page_hdr; if (page_data) { // got page data was_final = (p_hdr->flags & SPIFFS_PH_FLAG_FINAL) == 0; // write unfinalized page p_hdr->flags |= SPIFFS_PH_FLAG_FINAL; p_hdr->flags &= ~SPIFFS_PH_FLAG_USED; res = _spiffs_wr(fs, SPIFFS_OP_T_OBJ_DA | SPIFFS_OP_C_UPDT, 0, SPIFFS_PAGE_TO_PADDR(fs, free_pix), SPIFFS_CFG_LOG_PAGE_SZ(fs), page_data); } else { // copy page data res = spiffs_phys_cpy(fs, fh, SPIFFS_PAGE_TO_PADDR(fs, free_pix), SPIFFS_PAGE_TO_PADDR(fs, src_pix), SPIFFS_CFG_LOG_PAGE_SZ(fs)); } SPIFFS_CHECK_RES(res); // mark entry in destination object lookup res = _spiffs_wr(fs, SPIFFS_OP_T_OBJ_LU | SPIFFS_OP_C_UPDT, 0, SPIFFS_BLOCK_TO_PADDR(fs, SPIFFS_BLOCK_FOR_PAGE(fs, free_pix)) + SPIFFS_OBJ_LOOKUP_ENTRY_FOR_PAGE(fs, free_pix) * sizeof(spiffs_page_ix), sizeof(spiffs_obj_id), (u8_t *)&obj_id); SPIFFS_CHECK_RES(res); fs->stats_p_allocated++; if (was_final) { // mark finalized in destination page p_hdr->flags &= ~(SPIFFS_PH_FLAG_FINAL | SPIFFS_PH_FLAG_USED); res = _spiffs_wr(fs, SPIFFS_OP_T_OBJ_DA | SPIFFS_OP_C_UPDT, fh, SPIFFS_PAGE_TO_PADDR(fs, free_pix) + offsetof(spiffs_page_header, flags), sizeof(u8_t), (u8_t *)&p_hdr->flags); SPIFFS_CHECK_RES(res); } // mark source deleted res = spiffs_page_delete(fs, src_pix); return res; } // Deletes a page and removes it from object lookup. s32_t spiffs_page_delete( spiffs *fs, spiffs_page_ix pix) { s32_t res; spiffs_page_header hdr; hdr.flags = 0xff & ~(SPIFFS_PH_FLAG_DELET | SPIFFS_PH_FLAG_USED); // mark deleted entry in source object lookup spiffs_obj_id d_obj_id = SPIFFS_OBJ_ID_DELETED; res = _spiffs_wr(fs, SPIFFS_OP_T_OBJ_LU | SPIFFS_OP_C_DELE, 0, SPIFFS_BLOCK_TO_PADDR(fs, SPIFFS_BLOCK_FOR_PAGE(fs, pix)) + SPIFFS_OBJ_LOOKUP_ENTRY_FOR_PAGE(fs, pix) * sizeof(spiffs_page_ix), sizeof(spiffs_obj_id), (u8_t *)&d_obj_id); SPIFFS_CHECK_RES(res); fs->stats_p_deleted++; fs->stats_p_allocated--; // mark deleted in source page res = _spiffs_wr(fs, SPIFFS_OP_T_OBJ_DA | SPIFFS_OP_C_DELE, 0, SPIFFS_PAGE_TO_PADDR(fs, pix) + offsetof(spiffs_page_header, flags), sizeof(u8_t), (u8_t *)&hdr.flags); return res; } // Create an object index header page with empty index and undefined length s32_t spiffs_object_create( spiffs *fs, spiffs_obj_id obj_id, u8_t name[SPIFFS_OBJ_NAME_LEN], spiffs_obj_type type, spiffs_page_ix *objix_hdr_pix) { s32_t res = SPIFFS_OK; spiffs_block_ix bix; spiffs_page_object_ix_header oix_hdr; int entry; res = spiffs_gc_check(fs, 0); SPIFFS_CHECK_RES(res); obj_id |= SPIFFS_OBJ_ID_IX_FLAG; // find free entry res = spiffs_obj_lu_find_free(fs, fs->free_cursor_block_ix, fs->free_cursor_obj_lu_entry, &bix, &entry); SPIFFS_CHECK_RES(res); SPIFFS_DBG("create: found free page @ %04x bix:%i entry:%i\n", SPIFFS_OBJ_LOOKUP_ENTRY_TO_PIX(fs, bix, entry), bix, entry); // occupy page in object lookup res = _spiffs_wr(fs, SPIFFS_OP_T_OBJ_LU | SPIFFS_OP_C_UPDT, 0, SPIFFS_BLOCK_TO_PADDR(fs, bix) + entry * sizeof(spiffs_obj_id), sizeof(spiffs_obj_id), (u8_t*)&obj_id); SPIFFS_CHECK_RES(res); fs->stats_p_allocated++; // write empty object index page oix_hdr.p_hdr.obj_id = obj_id; oix_hdr.p_hdr.span_ix = 0; oix_hdr.p_hdr.flags = 0xff & ~(SPIFFS_PH_FLAG_FINAL | SPIFFS_PH_FLAG_INDEX | SPIFFS_PH_FLAG_USED); oix_hdr.type = type; oix_hdr.size = SPIFFS_UNDEFINED_LEN; // keep ones so we can update later without wasting this page strncpy((char *)&oix_hdr.name, (char *)name, SPIFFS_OBJ_NAME_LEN); // update page res = _spiffs_wr(fs, SPIFFS_OP_T_OBJ_DA | SPIFFS_OP_C_UPDT, 0, SPIFFS_OBJ_LOOKUP_ENTRY_TO_PADDR(fs, bix, entry), sizeof(spiffs_page_object_ix_header), (u8_t*)&oix_hdr); SPIFFS_CHECK_RES(res); spiffs_cb_object_event(fs, 0, SPIFFS_EV_IX_NEW, obj_id, 0, SPIFFS_OBJ_LOOKUP_ENTRY_TO_PIX(fs, bix, entry), SPIFFS_UNDEFINED_LEN); if (objix_hdr_pix) { *objix_hdr_pix = SPIFFS_OBJ_LOOKUP_ENTRY_TO_PIX(fs, bix, entry); } return res; } // update object index header with any combination of name/size/index // new_objix_hdr_data may be null, if so the object index header page is loaded // name may be null, if so name is not changed // size may be null, if so size is not changed s32_t spiffs_object_update_index_hdr( spiffs *fs, spiffs_fd *fd, spiffs_obj_id obj_id, spiffs_page_ix objix_hdr_pix, u8_t *new_objix_hdr_data, u8_t name[SPIFFS_OBJ_NAME_LEN], u32_t size, spiffs_page_ix *new_pix) { s32_t res = SPIFFS_OK; spiffs_page_object_ix_header *objix_hdr; spiffs_page_ix new_objix_hdr_pix; obj_id |= SPIFFS_OBJ_ID_IX_FLAG; if (new_objix_hdr_data) { // object index header page already given to us, no need to load it objix_hdr = (spiffs_page_object_ix_header *)new_objix_hdr_data; } else { // read object index header page res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_IX | SPIFFS_OP_C_READ, fd->file_nbr, SPIFFS_PAGE_TO_PADDR(fs, objix_hdr_pix), SPIFFS_CFG_LOG_PAGE_SZ(fs), fs->work); SPIFFS_CHECK_RES(res); objix_hdr = (spiffs_page_object_ix_header *)fs->work; } SPIFFS_VALIDATE_OBJIX(objix_hdr->p_hdr, obj_id, 0); // change name if (name) { strncpy((char *)objix_hdr->name, (char *)name, SPIFFS_OBJ_NAME_LEN); } if (size) { objix_hdr->size = size; } // move and update page res = spiffs_page_move(fs, fd == 0 ? 0 : fd->file_nbr, (u8_t*)objix_hdr, obj_id, 0, objix_hdr_pix, &new_objix_hdr_pix); if (res == SPIFFS_OK) { if (new_pix) { *new_pix = new_objix_hdr_pix; } // callback on object index update spiffs_cb_object_event(fs, fd, SPIFFS_EV_IX_UPD, obj_id, objix_hdr->p_hdr.span_ix, new_objix_hdr_pix, objix_hdr->size); if (fd) fd->objix_hdr_pix = new_objix_hdr_pix; // if this is not in the registered cluster } return res; } void spiffs_cb_object_event( spiffs *fs, spiffs_fd *fd, int ev, spiffs_obj_id obj_id, spiffs_span_ix spix, spiffs_page_ix new_pix, u32_t new_size) { // update index caches in all file descriptors obj_id &= ~SPIFFS_OBJ_ID_IX_FLAG; int i; spiffs_fd *fds = (spiffs_fd *)fs->fd_space; for (i = 0; i < fs->fd_count; i++) { spiffs_fd *cur_fd = &fds[i]; if (cur_fd->file_nbr == 0 || (cur_fd->obj_id & ~SPIFFS_OBJ_ID_IX_FLAG) != obj_id) continue; if (spix == 0) { if (ev == SPIFFS_EV_IX_NEW || ev == SPIFFS_EV_IX_UPD) { SPIFFS_DBG(" callback: setting fd %i:%04x objix_hdr_pix to %04x, size:%i\n", cur_fd->file_nbr, cur_fd->obj_id, new_pix, new_size); cur_fd->objix_hdr_pix = new_pix; if (new_size != 0) { cur_fd->size = new_size; } } else if (ev == SPIFFS_EV_IX_DEL) { cur_fd->file_nbr = 0; cur_fd->obj_id = SPIFFS_OBJ_ID_DELETED; } } if (cur_fd->cursor_objix_spix == spix) { if (ev == SPIFFS_EV_IX_NEW || ev == SPIFFS_EV_IX_UPD) { SPIFFS_DBG(" callback: setting fd %i:%04x span:%04x objix_pix to %04x\n", cur_fd->file_nbr, cur_fd->obj_id, spix, new_pix); cur_fd->cursor_objix_pix = new_pix; } else { cur_fd->cursor_objix_pix = 0; } } } } // Open object by id s32_t spiffs_object_open_by_id( spiffs *fs, spiffs_obj_id obj_id, spiffs_fd *fd, spiffs_flags flags, spiffs_mode mode) { s32_t res = SPIFFS_OK; spiffs_page_ix pix; res = spiffs_obj_lu_find_id_and_span(fs, obj_id | SPIFFS_OBJ_ID_IX_FLAG, 0, 0, &pix); SPIFFS_CHECK_RES(res); res = spiffs_object_open_by_page(fs, pix, fd, flags, mode); return res; } // Open object by page index s32_t spiffs_object_open_by_page( spiffs *fs, spiffs_page_ix pix, spiffs_fd *fd, spiffs_flags flags, spiffs_mode mode) { s32_t res = SPIFFS_OK; spiffs_page_object_ix_header oix_hdr; spiffs_obj_id obj_id; res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_IX | SPIFFS_OP_C_READ, fd->file_nbr, SPIFFS_PAGE_TO_PADDR(fs, pix), sizeof(spiffs_page_object_ix_header), (u8_t *)&oix_hdr); SPIFFS_CHECK_RES(res); spiffs_block_ix bix = SPIFFS_BLOCK_FOR_PAGE(fs, pix); int entry = SPIFFS_OBJ_LOOKUP_ENTRY_FOR_PAGE(fs, pix); res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_LU | SPIFFS_OP_C_READ, 0, SPIFFS_BLOCK_TO_PADDR(fs, bix) + entry * sizeof(spiffs_obj_id), sizeof(spiffs_obj_id), (u8_t *)&obj_id); fd->fs = fs; fd->objix_hdr_pix = pix; fd->size = oix_hdr.size; fd->offset = 0; fd->cursor_objix_pix = pix; fd->cursor_objix_spix = 0; fd->obj_id = obj_id; fd->flags = flags; SPIFFS_VALIDATE_OBJIX(oix_hdr.p_hdr, fd->obj_id, 0); SPIFFS_DBG("open: fd %i is obj id %04x\n", fd->file_nbr, fd->obj_id); return res; } // Append to object // keep current object index (header) page in fs->work buffer s32_t spiffs_object_append(spiffs_fd *fd, u32_t offset, u8_t *data, u32_t len) { spiffs *fs = fd->fs; s32_t res = SPIFFS_OK; u32_t written = 0; res = spiffs_gc_check(fs, len); SPIFFS_CHECK_RES(res); spiffs_page_object_ix_header *objix_hdr = (spiffs_page_object_ix_header *)fs->work; spiffs_page_object_ix *objix = (spiffs_page_object_ix *)fs->work; spiffs_page_header p_hdr; spiffs_span_ix cur_objix_spix = 0; spiffs_span_ix prev_objix_spix = (spiffs_span_ix)-1; spiffs_page_ix cur_objix_pix = fd->objix_hdr_pix; spiffs_page_ix new_objix_hdr_page; spiffs_span_ix data_spix = offset / SPIFFS_DATA_PAGE_SIZE(fs); spiffs_page_ix data_page; u32_t page_offs = offset % SPIFFS_DATA_PAGE_SIZE(fs); // write all data while (res == SPIFFS_OK && written < len) { // calculate object index page span index cur_objix_spix = SPIFFS_OBJ_IX_ENTRY_SPAN_IX(fs, data_spix); // handle storing and loading of object indices if (cur_objix_spix != prev_objix_spix) { // new object index page // within this clause we return directly if something fails, object index mess-up if (written > 0) { // store previous object index page, unless first pass SPIFFS_DBG("append: %04x store objix %04x:%04x, written %i\n", fd->obj_id, cur_objix_pix, prev_objix_spix, written); if (prev_objix_spix == 0) { // this is an update to object index header page objix_hdr->size = offset+written; if (offset == 0) { // was an empty object, update same page (size was 0xffffffff) res = spiffs_page_index_check(fs, fd, cur_objix_pix, 0); SPIFFS_CHECK_RES(res); res = _spiffs_wr(fs, SPIFFS_OP_T_OBJ_IX | SPIFFS_OP_C_UPDT, fd->file_nbr, SPIFFS_PAGE_TO_PADDR(fs, cur_objix_pix), SPIFFS_CFG_LOG_PAGE_SZ(fs), fs->work); SPIFFS_CHECK_RES(res); } else { // was a nonempty object, update to new page res = spiffs_object_update_index_hdr(fs, fd, fd->obj_id, fd->objix_hdr_pix, fs->work, 0, offset+written, &new_objix_hdr_page); SPIFFS_CHECK_RES(res); SPIFFS_DBG("append: %04x store new objix_hdr, %04x:%04x, written %i\n", fd->obj_id, new_objix_hdr_page, 0, written); } } else { // this is an update to an object index page res = spiffs_page_index_check(fs, fd, cur_objix_pix, prev_objix_spix); SPIFFS_CHECK_RES(res); res = _spiffs_wr(fs, SPIFFS_OP_T_OBJ_IX | SPIFFS_OP_C_UPDT, fd->file_nbr, SPIFFS_PAGE_TO_PADDR(fs, cur_objix_pix), SPIFFS_CFG_LOG_PAGE_SZ(fs), fs->work); SPIFFS_CHECK_RES(res); spiffs_cb_object_event(fs, fd, SPIFFS_EV_IX_UPD,fd->obj_id, objix->p_hdr.span_ix, cur_objix_pix, 0); // update length in object index header page res = spiffs_object_update_index_hdr(fs, fd, fd->obj_id, fd->objix_hdr_pix, 0, 0, offset+written, &new_objix_hdr_page); SPIFFS_CHECK_RES(res); SPIFFS_DBG("append: %04x store new size I %i in objix_hdr, %04x:%04x, written %i\n", fd->obj_id, offset+written, new_objix_hdr_page, 0, written); } fd->size = offset+written; fd->offset = offset+written; } // create or load new object index page if (cur_objix_spix == 0) { // load object index header page, must always exist SPIFFS_DBG("append: %04x load objixhdr page %04x:%04x\n", fd->obj_id, cur_objix_pix, cur_objix_spix); res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_IX | SPIFFS_OP_C_READ, fd->file_nbr, SPIFFS_PAGE_TO_PADDR(fs, cur_objix_pix), SPIFFS_CFG_LOG_PAGE_SZ(fs), fs->work); SPIFFS_CHECK_RES(res); SPIFFS_VALIDATE_OBJIX(objix_hdr->p_hdr, fd->obj_id, cur_objix_spix); } else { spiffs_span_ix len_objix_spix = SPIFFS_OBJ_IX_ENTRY_SPAN_IX(fs, (fd->size-1)/SPIFFS_DATA_PAGE_SIZE(fs)); // on subsequent passes, create a new object index page if (written > 0 || cur_objix_spix > len_objix_spix) { p_hdr.obj_id = fd->obj_id | SPIFFS_OBJ_ID_IX_FLAG; p_hdr.span_ix = cur_objix_spix; p_hdr.flags = 0xff & ~(SPIFFS_PH_FLAG_FINAL | SPIFFS_PH_FLAG_INDEX); res = spiffs_page_allocate_data(fs, fd->obj_id | SPIFFS_OBJ_ID_IX_FLAG, &p_hdr, 0, 0, 0, 1, &cur_objix_pix); SPIFFS_CHECK_RES(res); spiffs_cb_object_event(fs, fd, SPIFFS_EV_IX_NEW, fd->obj_id, cur_objix_spix, cur_objix_pix, 0); // quick "load" of new object index page c_memset(fs->work, 0xff, SPIFFS_CFG_LOG_PAGE_SZ(fs)); c_memcpy(fs->work, &p_hdr, sizeof(spiffs_page_header)); SPIFFS_DBG("append: %04x create objix page, %04x:%04x, written %i\n", fd->obj_id , cur_objix_pix, cur_objix_spix, written); } else { // on first pass, we load existing object index page spiffs_page_ix pix; SPIFFS_DBG("append: %04x find objix span_ix:%04x\n", fd->obj_id, cur_objix_spix); if (fd->cursor_objix_spix == cur_objix_spix) { pix = fd->cursor_objix_pix; } else { res = spiffs_obj_lu_find_id_and_span(fs, fd->obj_id | SPIFFS_OBJ_ID_IX_FLAG, cur_objix_spix, 0, &pix); SPIFFS_CHECK_RES(res); } SPIFFS_DBG("append: %04x found object index at page %04x\n", fd->obj_id, pix); res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_IX | SPIFFS_OP_C_READ, fd->file_nbr, SPIFFS_PAGE_TO_PADDR(fs, pix), SPIFFS_CFG_LOG_PAGE_SZ(fs), fs->work); SPIFFS_CHECK_RES(res); SPIFFS_VALIDATE_OBJIX(objix_hdr->p_hdr, fd->obj_id, cur_objix_spix); cur_objix_pix = pix; } fd->cursor_objix_pix = cur_objix_pix; fd->cursor_objix_spix = cur_objix_spix; fd->offset = offset+written; fd->size = offset+written; } prev_objix_spix = cur_objix_spix; } // write data u32_t to_write = MIN(len-written, SPIFFS_DATA_PAGE_SIZE(fs) - page_offs); if (page_offs == 0) { // at beginning of a page, allocate and write a new page of data p_hdr.obj_id = fd->obj_id & ~SPIFFS_OBJ_ID_IX_FLAG; p_hdr.span_ix = data_spix; p_hdr.flags = 0xff & ~(SPIFFS_PH_FLAG_FINAL); // finalize immediately res = spiffs_page_allocate_data(fs, fd->obj_id & ~SPIFFS_OBJ_ID_IX_FLAG, &p_hdr, &data[written], to_write, page_offs, 1, &data_page); SPIFFS_DBG("append: %04x store new data page, %04x:%04x offset:%i, len %i, written %i\n", fd->obj_id, data_page, data_spix, page_offs, to_write, written); } else { // append to existing page, fill out free data in existing page if (cur_objix_spix == 0) { // get data page from object index header page data_page = ((spiffs_page_ix*)((u8_t *)objix_hdr + sizeof(spiffs_page_object_ix_header)))[data_spix]; } else { // get data page from object index page data_page = ((spiffs_page_ix*)((u8_t *)objix + sizeof(spiffs_page_object_ix)))[SPIFFS_OBJ_IX_ENTRY(fs, data_spix)]; } res = spiffs_page_data_check(fs, fd, data_page, data_spix); SPIFFS_CHECK_RES(res); res = _spiffs_wr(fs, SPIFFS_OP_T_OBJ_DA | SPIFFS_OP_C_UPDT, fd->file_nbr, SPIFFS_PAGE_TO_PADDR(fs, data_page) + sizeof(spiffs_page_header) + page_offs, to_write, &data[written]); SPIFFS_DBG("append: %04x store to existing data page, %04x:%04x offset:%i, len %i, written %i\n", fd->obj_id , data_page, data_spix, page_offs, to_write, written); } if (res != SPIFFS_OK) break; // update memory representation of object index page with new data page if (cur_objix_spix == 0) { // update object index header page ((spiffs_page_ix*)((u8_t *)objix_hdr + sizeof(spiffs_page_object_ix_header)))[data_spix] = data_page; SPIFFS_DBG("append: %04x wrote page %04x to objix_hdr entry %02x in mem\n", fd->obj_id , data_page, data_spix); objix_hdr->size = offset+written; } else { // update object index page ((spiffs_page_ix*)((u8_t *)objix + sizeof(spiffs_page_object_ix)))[SPIFFS_OBJ_IX_ENTRY(fs, data_spix)] = data_page; SPIFFS_DBG("append: %04x wrote page %04x to objix entry %02x in mem\n", fd->obj_id , data_page, SPIFFS_OBJ_IX_ENTRY(fs, data_spix)); } // update internals page_offs = 0; data_spix++; written += to_write; } // while all data fd->size = offset+written; fd->offset = offset+written; fd->cursor_objix_pix = cur_objix_pix; fd->cursor_objix_spix = cur_objix_spix; // finalize updated object indices s32_t res2 = SPIFFS_OK; if (cur_objix_spix != 0) { // wrote beyond object index header page // write last modified object index page, unless object header index page SPIFFS_DBG("append: %04x store objix page, %04x:%04x, written %i\n", fd->obj_id, cur_objix_pix, cur_objix_spix, written); res2 = spiffs_page_index_check(fs, fd, cur_objix_pix, cur_objix_spix); SPIFFS_CHECK_RES(res2); res2 = _spiffs_wr(fs, SPIFFS_OP_T_OBJ_IX | SPIFFS_OP_C_UPDT, fd->file_nbr, SPIFFS_PAGE_TO_PADDR(fs, cur_objix_pix), SPIFFS_CFG_LOG_PAGE_SZ(fs), fs->work); SPIFFS_CHECK_RES(res2); spiffs_cb_object_event(fs, fd, SPIFFS_EV_IX_UPD, fd->obj_id, objix->p_hdr.span_ix, cur_objix_pix, 0); // update size in object header index page res2 = spiffs_object_update_index_hdr(fs, fd, fd->obj_id, fd->objix_hdr_pix, 0, 0, offset+written, &new_objix_hdr_page); SPIFFS_DBG("append: %04x store new size II %i in objix_hdr, %04x:%04x, written %i\n", fd->obj_id , offset+written, new_objix_hdr_page, 0, written); SPIFFS_CHECK_RES(res2); } else { // wrote within object index header page if (offset == 0) { // wrote to empty object - simply update size and write whole page objix_hdr->size = offset+written; SPIFFS_DBG("append: %04x store fresh objix_hdr page, %04x:%04x, written %i\n", fd->obj_id , cur_objix_pix, cur_objix_spix, written); res2 = spiffs_page_index_check(fs, fd, cur_objix_pix, cur_objix_spix); SPIFFS_CHECK_RES(res2); res2 = _spiffs_wr(fs, SPIFFS_OP_T_OBJ_IX | SPIFFS_OP_C_UPDT, fd->file_nbr, SPIFFS_PAGE_TO_PADDR(fs, cur_objix_pix), SPIFFS_CFG_LOG_PAGE_SZ(fs), fs->work); SPIFFS_CHECK_RES(res2); // callback on object index update spiffs_cb_object_event(fs, fd, SPIFFS_EV_IX_UPD, fd->obj_id, objix_hdr->p_hdr.span_ix, cur_objix_pix, objix_hdr->size); } else { // modifying object index header page, update size and make new copy res2 = spiffs_object_update_index_hdr(fs, fd, fd->obj_id, fd->objix_hdr_pix, fs->work, 0, offset+written, &new_objix_hdr_page); SPIFFS_DBG("append: %04x store modified objix_hdr page, %04x:%04x, written %i\n", fd->obj_id , new_objix_hdr_page, 0, written); SPIFFS_CHECK_RES(res2); } } return res; } // Modify object // keep current object index (header) page in fs->work buffer s32_t spiffs_object_modify(spiffs_fd *fd, u32_t offset, u8_t *data, u32_t len) { spiffs *fs = fd->fs; s32_t res = SPIFFS_OK; u32_t written = 0; res = spiffs_gc_check(fs, len); SPIFFS_CHECK_RES(res); spiffs_page_object_ix_header *objix_hdr = (spiffs_page_object_ix_header *)fs->work; spiffs_page_object_ix *objix = (spiffs_page_object_ix *)fs->work; spiffs_page_header p_hdr; spiffs_span_ix cur_objix_spix = 0; spiffs_span_ix prev_objix_spix = (spiffs_span_ix)-1; spiffs_page_ix cur_objix_pix = fd->objix_hdr_pix; spiffs_page_ix new_objix_hdr_pix; spiffs_span_ix data_spix = offset / SPIFFS_DATA_PAGE_SIZE(fs); spiffs_page_ix data_pix; u32_t page_offs = offset % SPIFFS_DATA_PAGE_SIZE(fs); // write all data while (res == SPIFFS_OK && written < len) { // calculate object index page span index cur_objix_spix = SPIFFS_OBJ_IX_ENTRY_SPAN_IX(fs, data_spix); // handle storing and loading of object indices if (cur_objix_spix != prev_objix_spix) { // new object index page // within this clause we return directly if something fails, object index mess-up if (written > 0) { // store previous object index (header) page, unless first pass if (prev_objix_spix == 0) { // store previous object index header page res = spiffs_object_update_index_hdr(fs, fd, fd->obj_id, fd->objix_hdr_pix, fs->work, 0, 0, &new_objix_hdr_pix); SPIFFS_DBG("modify: store modified objix_hdr page, %04x:%04x, written %i\n", new_objix_hdr_pix, 0, written); SPIFFS_CHECK_RES(res); } else { // store new version of previous object index page spiffs_page_ix new_objix_pix; res = spiffs_page_index_check(fs, fd, cur_objix_pix, prev_objix_spix); SPIFFS_CHECK_RES(res); res = spiffs_page_move(fs, fd->file_nbr, (u8_t*)objix, fd->obj_id, 0, cur_objix_pix, &new_objix_pix); SPIFFS_DBG("modify: store previous modified objix page, %04x:%04x, written %i\n", new_objix_pix, objix->p_hdr.span_ix, written); SPIFFS_CHECK_RES(res); spiffs_cb_object_event(fs, fd, SPIFFS_EV_IX_UPD, fd->obj_id, objix->p_hdr.span_ix, new_objix_pix, 0); } } // load next object index page if (cur_objix_spix == 0) { // load object index header page, must exist SPIFFS_DBG("modify: load objixhdr page %04x:%04x\n", cur_objix_pix, cur_objix_spix); res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_IX | SPIFFS_OP_C_READ, fd->file_nbr, SPIFFS_PAGE_TO_PADDR(fs, cur_objix_pix), SPIFFS_CFG_LOG_PAGE_SZ(fs), fs->work); SPIFFS_CHECK_RES(res); SPIFFS_VALIDATE_OBJIX(objix_hdr->p_hdr, fd->obj_id, cur_objix_spix); } else { // load existing object index page on first pass spiffs_page_ix pix; SPIFFS_DBG("modify: find objix span_ix:%04x\n", cur_objix_spix); if (fd->cursor_objix_spix == cur_objix_spix) { pix = fd->cursor_objix_pix; } else { res = spiffs_obj_lu_find_id_and_span(fs, fd->obj_id | SPIFFS_OBJ_ID_IX_FLAG, cur_objix_spix, 0, &pix); SPIFFS_CHECK_RES(res); } SPIFFS_DBG("modify: found object index at page %04x\n", pix); res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_IX | SPIFFS_OP_C_READ, fd->file_nbr, SPIFFS_PAGE_TO_PADDR(fs, pix), SPIFFS_CFG_LOG_PAGE_SZ(fs), fs->work); SPIFFS_CHECK_RES(res); SPIFFS_VALIDATE_OBJIX(objix_hdr->p_hdr, fd->obj_id, cur_objix_spix); cur_objix_pix = pix; } fd->cursor_objix_pix = cur_objix_pix; fd->cursor_objix_spix = cur_objix_spix; fd->offset = offset+written; prev_objix_spix = cur_objix_spix; } // write partial data u32_t to_write = MIN(len-written, SPIFFS_DATA_PAGE_SIZE(fs) - page_offs); spiffs_page_ix orig_data_pix; if (cur_objix_spix == 0) { // get data page from object index header page orig_data_pix = ((spiffs_page_ix*)((u8_t *)objix_hdr + sizeof(spiffs_page_object_ix_header)))[data_spix]; } else { // get data page from object index page orig_data_pix = ((spiffs_page_ix*)((u8_t *)objix + sizeof(spiffs_page_object_ix)))[SPIFFS_OBJ_IX_ENTRY(fs, data_spix)]; } p_hdr.obj_id = fd->obj_id & ~SPIFFS_OBJ_ID_IX_FLAG; p_hdr.span_ix = data_spix; p_hdr.flags = 0xff; if (page_offs == 0 && to_write == SPIFFS_DATA_PAGE_SIZE(fs)) { // a full page, allocate and write a new page of data res = spiffs_page_allocate_data(fs, fd->obj_id & ~SPIFFS_OBJ_ID_IX_FLAG, &p_hdr, &data[written], to_write, page_offs, 1, &data_pix); SPIFFS_DBG("modify: store new data page, %04x:%04x offset:%i, len %i, written %i\n", data_pix, data_spix, page_offs, to_write, written); } else { // write to existing page, allocate new and copy unmodified data res = spiffs_page_data_check(fs, fd, orig_data_pix, data_spix); SPIFFS_CHECK_RES(res); res = spiffs_page_allocate_data(fs, fd->obj_id & ~SPIFFS_OBJ_ID_IX_FLAG, &p_hdr, 0, 0, 0, 0, &data_pix); if (res != SPIFFS_OK) break; // copy unmodified data if (page_offs > 0) { // before modification res = spiffs_phys_cpy(fs, fd->file_nbr, SPIFFS_PAGE_TO_PADDR(fs, data_pix) + sizeof(spiffs_page_header), SPIFFS_PAGE_TO_PADDR(fs, orig_data_pix) + sizeof(spiffs_page_header), page_offs); if (res != SPIFFS_OK) break; } if (page_offs + to_write < SPIFFS_DATA_PAGE_SIZE(fs)) { // after modification res = spiffs_phys_cpy(fs, fd->file_nbr, SPIFFS_PAGE_TO_PADDR(fs, data_pix) + sizeof(spiffs_page_header) + page_offs + to_write, SPIFFS_PAGE_TO_PADDR(fs, orig_data_pix) + sizeof(spiffs_page_header) + page_offs + to_write, SPIFFS_DATA_PAGE_SIZE(fs) - (page_offs + to_write)); if (res != SPIFFS_OK) break; } res = _spiffs_wr(fs, SPIFFS_OP_T_OBJ_DA | SPIFFS_OP_C_UPDT, fd->file_nbr, SPIFFS_PAGE_TO_PADDR(fs, data_pix) + sizeof(spiffs_page_header) + page_offs, to_write, &data[written]); if (res != SPIFFS_OK) break; p_hdr.flags &= ~SPIFFS_PH_FLAG_FINAL; res = _spiffs_wr(fs, SPIFFS_OP_T_OBJ_DA | SPIFFS_OP_C_UPDT, fd->file_nbr, SPIFFS_PAGE_TO_PADDR(fs, data_pix) + offsetof(spiffs_page_header, flags), sizeof(u8_t), (u8_t *)&p_hdr.flags); if (res != SPIFFS_OK) break; SPIFFS_DBG("modify: store to existing data page, src:%04x, dst:%04x:%04x offset:%i, len %i, written %i\n", orig_data_pix, data_pix, data_spix, page_offs, to_write, written); } // delete original data page res = spiffs_page_delete(fs, orig_data_pix); if (res != SPIFFS_OK) break; // update memory representation of object index page with new data page if (cur_objix_spix == 0) { // update object index header page ((spiffs_page_ix*)((u8_t *)objix_hdr + sizeof(spiffs_page_object_ix_header)))[data_spix] = data_pix; SPIFFS_DBG("modify: wrote page %04x to objix_hdr entry %02x in mem\n", data_pix, data_spix); } else { // update object index page ((spiffs_page_ix*)((u8_t *)objix + sizeof(spiffs_page_object_ix)))[SPIFFS_OBJ_IX_ENTRY(fs, data_spix)] = data_pix; SPIFFS_DBG("modify: wrote page %04x to objix entry %02x in mem\n", data_pix, SPIFFS_OBJ_IX_ENTRY(fs, data_spix)); } // update internals page_offs = 0; data_spix++; written += to_write; } // while all data fd->offset = offset+written; fd->cursor_objix_pix = cur_objix_pix; fd->cursor_objix_spix = cur_objix_spix; // finalize updated object indices s32_t res2 = SPIFFS_OK; if (cur_objix_spix != 0) { // wrote beyond object index header page // write last modified object index page // move and update page spiffs_page_ix new_objix_pix; res2 = spiffs_page_index_check(fs, fd, cur_objix_pix, cur_objix_spix); SPIFFS_CHECK_RES(res2); res2 = spiffs_page_move(fs, fd->file_nbr, (u8_t*)objix, fd->obj_id, 0, cur_objix_pix, &new_objix_pix); SPIFFS_DBG("modify: store modified objix page, %04x:%04x, written %i\n", new_objix_pix, cur_objix_spix, written); fd->cursor_objix_pix = new_objix_pix; fd->cursor_objix_spix = cur_objix_spix; SPIFFS_CHECK_RES(res2); spiffs_cb_object_event(fs, fd, SPIFFS_EV_IX_UPD, fd->obj_id, objix->p_hdr.span_ix, new_objix_pix, 0); } else { // wrote within object index header page res2 = spiffs_object_update_index_hdr(fs, fd, fd->obj_id, fd->objix_hdr_pix, fs->work, 0, 0, &new_objix_hdr_pix); SPIFFS_DBG("modify: store modified objix_hdr page, %04x:%04x, written %i\n", new_objix_hdr_pix, 0, written); SPIFFS_CHECK_RES(res2); } return res; } static s32_t spiffs_object_find_object_index_header_by_name_v( spiffs *fs, spiffs_obj_id obj_id, spiffs_block_ix bix, int ix_entry, u32_t user_data, void *user_p) { s32_t res; spiffs_page_object_ix_header objix_hdr; spiffs_page_ix pix = SPIFFS_OBJ_LOOKUP_ENTRY_TO_PIX(fs, bix, ix_entry); if (obj_id == SPIFFS_OBJ_ID_FREE || obj_id == SPIFFS_OBJ_ID_DELETED || (obj_id & SPIFFS_OBJ_ID_IX_FLAG) == 0) { return SPIFFS_VIS_COUNTINUE; } res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_LU2 | SPIFFS_OP_C_READ, 0, SPIFFS_PAGE_TO_PADDR(fs, pix), sizeof(spiffs_page_object_ix_header), (u8_t *)&objix_hdr); SPIFFS_CHECK_RES(res); if (objix_hdr.p_hdr.span_ix == 0 && (objix_hdr.p_hdr.flags & (SPIFFS_PH_FLAG_DELET | SPIFFS_PH_FLAG_FINAL | SPIFFS_PH_FLAG_IXDELE)) == (SPIFFS_PH_FLAG_DELET | SPIFFS_PH_FLAG_IXDELE)) { if (strcmp((char *)user_p, (char *)objix_hdr.name) == 0) { return SPIFFS_OK; } } return SPIFFS_VIS_COUNTINUE; } // Finds object index header page by name s32_t spiffs_object_find_object_index_header_by_name( spiffs *fs, u8_t name[SPIFFS_OBJ_NAME_LEN], spiffs_page_ix *pix) { s32_t res; spiffs_block_ix bix; int entry; res = spiffs_obj_lu_find_entry_visitor(fs, fs->cursor_block_ix, fs->cursor_obj_lu_entry, 0, 0, spiffs_object_find_object_index_header_by_name_v, 0, name, &bix, &entry); if (res == SPIFFS_VIS_END) { res = SPIFFS_ERR_NOT_FOUND; } SPIFFS_CHECK_RES(res); if (pix) { *pix = SPIFFS_OBJ_LOOKUP_ENTRY_TO_PIX(fs, bix, entry); } fs->cursor_block_ix = bix; fs->cursor_obj_lu_entry = entry; return res; } // Truncates object to new size. If new size is null, object may be removed totally s32_t spiffs_object_truncate( spiffs_fd *fd, u32_t new_size, u8_t remove) { s32_t res = SPIFFS_OK; spiffs *fs = fd->fs; res = spiffs_gc_check(fs, 0); SPIFFS_CHECK_RES(res); spiffs_page_ix objix_pix = fd->objix_hdr_pix; spiffs_span_ix data_spix = (fd->size > 0 ? fd->size-1 : 0) / SPIFFS_DATA_PAGE_SIZE(fs); u32_t cur_size = fd->size == SPIFFS_UNDEFINED_LEN ? 0 : fd->size ; spiffs_span_ix cur_objix_spix = 0; spiffs_span_ix prev_objix_spix = (spiffs_span_ix)-1; spiffs_page_object_ix_header *objix_hdr = (spiffs_page_object_ix_header *)fs->work; spiffs_page_object_ix *objix = (spiffs_page_object_ix *)fs->work; spiffs_page_ix data_pix; spiffs_page_ix new_objix_hdr_pix; // before truncating, check if object is to be fully removed and mark this if (remove && new_size == 0) { u8_t flags = ~( SPIFFS_PH_FLAG_USED | SPIFFS_PH_FLAG_INDEX | SPIFFS_PH_FLAG_FINAL | SPIFFS_PH_FLAG_IXDELE); res = _spiffs_wr(fs, SPIFFS_OP_T_OBJ_IX | SPIFFS_OP_C_UPDT, fd->file_nbr, SPIFFS_PAGE_TO_PADDR(fs, fd->objix_hdr_pix) + offsetof(spiffs_page_header, flags), sizeof(u8_t), (u8_t *)&flags); SPIFFS_CHECK_RES(res); } // delete from end of object until desired len is reached while (cur_size > new_size) { cur_objix_spix = SPIFFS_OBJ_IX_ENTRY_SPAN_IX(fs, data_spix); // put object index for current data span index in work buffer if (prev_objix_spix != cur_objix_spix) { if (prev_objix_spix != (spiffs_span_ix)-1) { // remove previous object index page SPIFFS_DBG("truncate: delete objix page %04x:%04x\n", objix_pix, prev_objix_spix); res = spiffs_page_index_check(fs, fd, objix_pix, prev_objix_spix); SPIFFS_CHECK_RES(res); res = spiffs_page_delete(fs, objix_pix); SPIFFS_CHECK_RES(res); spiffs_cb_object_event(fs, fd, SPIFFS_EV_IX_DEL, fd->obj_id, objix->p_hdr.span_ix, objix_pix, 0); if (prev_objix_spix > 0) { // update object index header page SPIFFS_DBG("truncate: update objix hdr page %04x:%04x to size %i\n", fd->objix_hdr_pix, prev_objix_spix, cur_size); res = spiffs_object_update_index_hdr(fs, fd, fd->obj_id, fd->objix_hdr_pix, 0, 0, cur_size, &new_objix_hdr_pix); SPIFFS_CHECK_RES(res); fd->size = cur_size; } } // load current object index (header) page if (cur_objix_spix == 0) { objix_pix = fd->objix_hdr_pix; } else { res = spiffs_obj_lu_find_id_and_span(fs, fd->obj_id | SPIFFS_OBJ_ID_IX_FLAG, cur_objix_spix, 0, &objix_pix); SPIFFS_CHECK_RES(res); } SPIFFS_DBG("truncate: load objix page %04x:%04x for data spix:%04x\n", objix_pix, cur_objix_spix, data_spix); res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_IX | SPIFFS_OP_C_READ, fd->file_nbr, SPIFFS_PAGE_TO_PADDR(fs, objix_pix), SPIFFS_CFG_LOG_PAGE_SZ(fs), fs->work); SPIFFS_CHECK_RES(res); SPIFFS_VALIDATE_OBJIX(objix_hdr->p_hdr, fd->obj_id, cur_objix_spix); fd->cursor_objix_pix = objix_pix; fd->cursor_objix_spix = cur_objix_spix; fd->offset = cur_size; prev_objix_spix = cur_objix_spix; } if (cur_objix_spix == 0) { // get data page from object index header page data_pix = ((spiffs_page_ix*)((u8_t *)objix_hdr + sizeof(spiffs_page_object_ix_header)))[data_spix]; ((spiffs_page_ix*)((u8_t *)objix_hdr + sizeof(spiffs_page_object_ix_header)))[data_spix] = SPIFFS_OBJ_ID_FREE; } else { // get data page from object index page data_pix = ((spiffs_page_ix*)((u8_t *)objix + sizeof(spiffs_page_object_ix)))[SPIFFS_OBJ_IX_ENTRY(fs, data_spix)]; ((spiffs_page_ix*)((u8_t *)objix + sizeof(spiffs_page_object_ix)))[SPIFFS_OBJ_IX_ENTRY(fs, data_spix)] = SPIFFS_OBJ_ID_FREE; } if (cur_size - SPIFFS_DATA_PAGE_SIZE(fs) >= new_size) { // delete full data page res = spiffs_page_data_check(fs, fd, data_pix, data_spix); if (res != SPIFFS_OK) break; res = spiffs_page_delete(fs, data_pix); if (res != SPIFFS_OK) break; // update current size if (cur_size % SPIFFS_DATA_PAGE_SIZE(fs) == 0) { cur_size -= SPIFFS_DATA_PAGE_SIZE(fs); } else { cur_size -= cur_size % SPIFFS_DATA_PAGE_SIZE(fs); } fd->size = cur_size; fd->offset = cur_size; SPIFFS_DBG("truncate: delete data page %04x for data spix:%04x, cur_size:%i\n", data_pix, data_spix, cur_size); } else { // delete last page, partially spiffs_page_header p_hdr; spiffs_page_ix new_data_pix; u32_t bytes_to_remove = SPIFFS_DATA_PAGE_SIZE(fs) - (new_size % SPIFFS_DATA_PAGE_SIZE(fs)); SPIFFS_DBG("truncate: delete %i bytes from data page %04x for data spix:%04x, cur_size:%i\n", bytes_to_remove, data_pix, data_spix, cur_size); res = spiffs_page_data_check(fs, fd, data_pix, data_spix); if (res != SPIFFS_OK) break; p_hdr.obj_id = fd->obj_id & ~SPIFFS_OBJ_ID_IX_FLAG; p_hdr.span_ix = data_spix; p_hdr.flags = 0xff; // allocate new page and copy unmodified data res = spiffs_page_allocate_data(fs, fd->obj_id & ~SPIFFS_OBJ_ID_IX_FLAG, &p_hdr, 0, 0, 0, 0, &new_data_pix); if (res != SPIFFS_OK) break; res = spiffs_phys_cpy(fs, 0, SPIFFS_PAGE_TO_PADDR(fs, new_data_pix) + sizeof(spiffs_page_header), SPIFFS_PAGE_TO_PADDR(fs, data_pix) + sizeof(spiffs_page_header), SPIFFS_DATA_PAGE_SIZE(fs) - bytes_to_remove); if (res != SPIFFS_OK) break; // delete original data page res = spiffs_page_delete(fs, data_pix); if (res != SPIFFS_OK) break; p_hdr.flags &= ~SPIFFS_PH_FLAG_FINAL; res = _spiffs_wr(fs, SPIFFS_OP_T_OBJ_DA | SPIFFS_OP_C_UPDT, fd->file_nbr, SPIFFS_PAGE_TO_PADDR(fs, new_data_pix) + offsetof(spiffs_page_header, flags), sizeof(u8_t), (u8_t *)&p_hdr.flags); if (res != SPIFFS_OK) break; // update memory representation of object index page with new data page if (cur_objix_spix == 0) { // update object index header page ((spiffs_page_ix*)((u8_t *)objix_hdr + sizeof(spiffs_page_object_ix_header)))[data_spix] = new_data_pix; SPIFFS_DBG("truncate: wrote page %04x to objix_hdr entry %02x in mem\n", new_data_pix, SPIFFS_OBJ_IX_ENTRY(fs, data_spix)); } else { // update object index page ((spiffs_page_ix*)((u8_t *)objix + sizeof(spiffs_page_object_ix)))[SPIFFS_OBJ_IX_ENTRY(fs, data_spix)] = new_data_pix; SPIFFS_DBG("truncate: wrote page %04x to objix entry %02x in mem\n", new_data_pix, SPIFFS_OBJ_IX_ENTRY(fs, data_spix)); } cur_size = new_size; fd->size = new_size; fd->offset = cur_size; break; } data_spix--; } // while all data // update object indices if (cur_objix_spix == 0) { // update object index header page if (cur_size == 0) { if (remove) { // remove object altogether SPIFFS_DBG("truncate: remove object index header page %04x\n", objix_pix); res = spiffs_page_index_check(fs, fd, objix_pix, 0); SPIFFS_CHECK_RES(res); res = spiffs_page_delete(fs, objix_pix); SPIFFS_CHECK_RES(res); spiffs_cb_object_event(fs, fd, SPIFFS_EV_IX_DEL, fd->obj_id, 0, objix_pix, 0); } else { // make uninitialized object SPIFFS_DBG("truncate: reset objix_hdr page %04x\n", objix_pix); c_memset(fs->work + sizeof(spiffs_page_object_ix_header), 0xff, SPIFFS_CFG_LOG_PAGE_SZ(fs) - sizeof(spiffs_page_object_ix_header)); res = spiffs_object_update_index_hdr(fs, fd, fd->obj_id, objix_pix, fs->work, 0, SPIFFS_UNDEFINED_LEN, &new_objix_hdr_pix); SPIFFS_CHECK_RES(res); } } else { // update object index header page SPIFFS_DBG("truncate: update object index header page with indices and size\n"); res = spiffs_object_update_index_hdr(fs, fd, fd->obj_id, objix_pix, fs->work, 0, cur_size, &new_objix_hdr_pix); SPIFFS_CHECK_RES(res); } } else { // update both current object index page and object index header page spiffs_page_ix new_objix_pix; res = spiffs_page_index_check(fs, fd, objix_pix, cur_objix_spix); SPIFFS_CHECK_RES(res); // move and update object index page res = spiffs_page_move(fs, fd->file_nbr, (u8_t*)objix_hdr, fd->obj_id, 0, objix_pix, &new_objix_pix); SPIFFS_CHECK_RES(res); spiffs_cb_object_event(fs, fd, SPIFFS_EV_IX_UPD, fd->obj_id, objix->p_hdr.span_ix, new_objix_pix, 0); SPIFFS_DBG("truncate: store modified objix page, %04x:%04x\n", new_objix_pix, cur_objix_spix); fd->cursor_objix_pix = new_objix_pix; fd->cursor_objix_spix = cur_objix_spix; fd->offset = cur_size; // update object index header page with new size res = spiffs_object_update_index_hdr(fs, fd, fd->obj_id, fd->objix_hdr_pix, 0, 0, cur_size, &new_objix_hdr_pix); SPIFFS_CHECK_RES(res); } fd->size = cur_size; return res; } s32_t spiffs_object_read( spiffs_fd *fd, u32_t offset, u32_t len, u8_t *dst) { s32_t res = SPIFFS_OK; spiffs *fs = fd->fs; spiffs_page_ix objix_pix; spiffs_page_ix data_pix; spiffs_span_ix data_spix = offset / SPIFFS_DATA_PAGE_SIZE(fs); u32_t cur_offset = offset; spiffs_span_ix cur_objix_spix; spiffs_span_ix prev_objix_spix = (spiffs_span_ix)-1; spiffs_page_object_ix_header *objix_hdr = (spiffs_page_object_ix_header *)fs->work; spiffs_page_object_ix *objix = (spiffs_page_object_ix *)fs->work; while (cur_offset < offset + len) { cur_objix_spix = SPIFFS_OBJ_IX_ENTRY_SPAN_IX(fs, data_spix); if (prev_objix_spix != cur_objix_spix) { // load current object index (header) page if (cur_objix_spix == 0) { objix_pix = fd->objix_hdr_pix; } else { SPIFFS_DBG("read: find objix %04x:%04x\n", fd->obj_id, cur_objix_spix); res = spiffs_obj_lu_find_id_and_span(fs, fd->obj_id | SPIFFS_OBJ_ID_IX_FLAG, cur_objix_spix, 0, &objix_pix); SPIFFS_CHECK_RES(res); } SPIFFS_DBG("read: load objix page %04x:%04x for data spix:%04x\n", objix_pix, cur_objix_spix, data_spix); res = _spiffs_rd(fs, SPIFFS_OP_T_OBJ_IX | SPIFFS_OP_C_READ, fd->file_nbr, SPIFFS_PAGE_TO_PADDR(fs, objix_pix), SPIFFS_CFG_LOG_PAGE_SZ(fs), fs->work); SPIFFS_CHECK_RES(res); SPIFFS_VALIDATE_OBJIX(objix->p_hdr, fd->obj_id, cur_objix_spix); fd->offset = cur_offset; fd->cursor_objix_pix = objix_pix; fd->cursor_objix_spix = cur_objix_spix; prev_objix_spix = cur_objix_spix; } if (cur_objix_spix == 0) { // get data page from object index header page data_pix = ((spiffs_page_ix*)((u8_t *)objix_hdr + sizeof(spiffs_page_object_ix_header)))[data_spix]; } else { // get data page from object index page data_pix = ((spiffs_page_ix*)((u8_t *)objix + sizeof(spiffs_page_object_ix)))[SPIFFS_OBJ_IX_ENTRY(fs, data_spix)]; } // all remaining data u32_t len_to_read = offset + len - cur_offset; // remaining data in page len_to_read = MIN(len_to_read, SPIFFS_DATA_PAGE_SIZE(fs) - (cur_offset % SPIFFS_DATA_PAGE_SIZE(fs))); // remaining data in file len_to_read = MIN(len_to_read, fd->size); SPIFFS_DBG("read: offset:%i rd:%i data spix:%04x is data_pix:%04x addr:%08x\n", cur_offset, len_to_read, data_spix, data_pix, SPIFFS_PAGE_TO_PADDR(fs, data_pix) + sizeof(spiffs_page_header) + (cur_offset % SPIFFS_DATA_PAGE_SIZE(fs))); if (len_to_read <= 0) { res = SPIFFS_ERR_END_OF_OBJECT; break; } res = spiffs_page_data_check(fs, fd, data_pix, data_spix); SPIFFS_CHECK_RES(res); res = _spiffs_rd( fs, SPIFFS_OP_T_OBJ_DA | SPIFFS_OP_C_READ, fd->file_nbr, SPIFFS_PAGE_TO_PADDR(fs, data_pix) + sizeof(spiffs_page_header) + (cur_offset % SPIFFS_DATA_PAGE_SIZE(fs)), len_to_read, dst); SPIFFS_CHECK_RES(res); dst += len_to_read; cur_offset += len_to_read; fd->offset = cur_offset; data_spix++; } return res; } typedef struct { spiffs_obj_id min_obj_id; spiffs_obj_id max_obj_id; u32_t compaction; } spiffs_free_obj_id_state; static s32_t spiffs_obj_lu_find_free_obj_id_bitmap_v(spiffs *fs, spiffs_obj_id id, spiffs_block_ix bix, int ix_entry, u32_t user_data, void *user_p) { if (id != SPIFFS_OBJ_ID_FREE && id != SPIFFS_OBJ_ID_DELETED) { spiffs_obj_id min_obj_id = user_data; id &= ~SPIFFS_OBJ_ID_IX_FLAG; int bit_ix = (id-min_obj_id) & 7; int byte_ix = (id-min_obj_id) >> 3; if (byte_ix >= 0 && byte_ix < SPIFFS_CFG_LOG_PAGE_SZ(fs)) { fs->work[byte_ix] |= (1<= state->min_obj_id && id <= state->max_obj_id) { u8_t *map = (u8_t *)fs->work; int ix = (id - state->min_obj_id) / state->compaction; //SPIFFS_DBG("free_obj_id: add ix %i for id %04x min:%04x max%04x comp:%i\n", ix, id, state->min_obj_id, state->max_obj_id, state->compaction); map[ix]++; } } } return SPIFFS_VIS_COUNTINUE; } // Scans thru all object lookup for object index header pages. If total possible number of // object ids cannot fit into a work buffer, these are grouped. When a group containing free // object ids is found, the object lu is again scanned for object ids within group and bitmasked. // Finally, the bitmasked is searched for a free id s32_t spiffs_obj_lu_find_free_obj_id(spiffs *fs, spiffs_obj_id *obj_id) { s32_t res = SPIFFS_OK; u32_t max_objects = (SPIFFS_CFG_PHYS_SZ(fs) / (u32_t)SPIFFS_CFG_LOG_PAGE_SZ(fs)) / 2; spiffs_free_obj_id_state state; spiffs_obj_id free_obj_id = SPIFFS_OBJ_ID_FREE; state.min_obj_id = 1; state.max_obj_id = max_objects + 1; if (state.max_obj_id & SPIFFS_OBJ_ID_IX_FLAG) { state.max_obj_id = ((spiffs_obj_id)-1) & ~SPIFFS_OBJ_ID_IX_FLAG; } state.compaction = 0; while (res == SPIFFS_OK && free_obj_id == SPIFFS_OBJ_ID_FREE) { if (state.max_obj_id - state.min_obj_id <= SPIFFS_CFG_LOG_PAGE_SZ(fs)*8) { // possible to represent in bitmap int i, j; SPIFFS_DBG("free_obj_id: BITM min:%04x max:%04x\n", state.min_obj_id, state.max_obj_id); c_memset(fs->work, 0, SPIFFS_CFG_LOG_PAGE_SZ(fs)); res = spiffs_obj_lu_find_entry_visitor(fs, 0, 0, 0, 0, spiffs_obj_lu_find_free_obj_id_bitmap_v, state.min_obj_id, 0, 0, 0); if (res == SPIFFS_VIS_END) res = SPIFFS_OK; SPIFFS_CHECK_RES(res); // traverse bitmask until found free obj_id for (i = 0; i < SPIFFS_CFG_LOG_PAGE_SZ(fs); i++) { u8_t mask = fs->work[i]; if (mask == 0xff) { continue; } for (j = 0; j < 8; j++) { if ((mask & (1<work; u8_t min_count = 0xff; for (i = 0; i < SPIFFS_CFG_LOG_PAGE_SZ(fs)/sizeof(u8_t); i++) { if (map[i] < min_count) { min_count = map[i]; min_i = i; if (min_count == 0) { break; } } } if (min_count == state.compaction) { // there are no free objids! SPIFFS_DBG("free_obj_id: compacted table is full\n"); return SPIFFS_ERR_FULL; } SPIFFS_DBG("free_obj_id: COMP select index:%i min_count:%i min:%04x max:%04x compact:%i\n", min_i, min_count, state.min_obj_id, state.max_obj_id, state.compaction); if (min_count == 0) { // no id in this range, skip compacting and use directly *obj_id = min_i * state.compaction + state.min_obj_id; return SPIFFS_OK; } else { SPIFFS_DBG("free_obj_id: COMP SEL chunk:%04x min:%04x -> %04x\n", state.compaction, state.min_obj_id, state.min_obj_id + min_i * state.compaction); state.min_obj_id += min_i * state.compaction; state.max_obj_id = state.min_obj_id + state.compaction; // decrease compaction } if ((state.max_obj_id - state.min_obj_id <= SPIFFS_CFG_LOG_PAGE_SZ(fs)*8)) { // no need for compacting, use bitmap continue; } } // in a work memory of log_page_size bytes, we may fit in log_page_size ids // todo what if compaction is > 255 - then we cannot fit it in a byte state.compaction = (state.max_obj_id-state.min_obj_id) / ((SPIFFS_CFG_LOG_PAGE_SZ(fs) / sizeof(u8_t))); SPIFFS_DBG("free_obj_id: COMP min:%04x max:%04x compact:%i\n", state.min_obj_id, state.max_obj_id, state.compaction); c_memset(fs->work, 0, SPIFFS_CFG_LOG_PAGE_SZ(fs)); res = spiffs_obj_lu_find_entry_visitor(fs, 0, 0, 0, 0, spiffs_obj_lu_find_free_obj_id_compact_v, 0, &state, 0, 0); if (res == SPIFFS_VIS_END) res = SPIFFS_OK; SPIFFS_CHECK_RES(res); } } return res; } s32_t spiffs_fd_find_new(spiffs *fs, spiffs_fd **fd) { int i; spiffs_fd *fds = (spiffs_fd *)fs->fd_space; for (i = 0; i < fs->fd_count; i++) { spiffs_fd *cur_fd = &fds[i]; if (cur_fd->file_nbr == 0) { cur_fd->file_nbr = i+1; *fd = cur_fd; return SPIFFS_OK; } } return SPIFFS_ERR_OUT_OF_FILE_DESCS; } s32_t spiffs_fd_return(spiffs *fs, spiffs_file f) { if (f <= 0 || f > fs->fd_count) { return SPIFFS_ERR_BAD_DESCRIPTOR; } spiffs_fd *fds = (spiffs_fd *)fs->fd_space; spiffs_fd *fd = &fds[f-1]; if (fd->file_nbr == 0) { return SPIFFS_ERR_FILE_CLOSED; } fd->file_nbr = 0; return SPIFFS_OK; } s32_t spiffs_fd_get(spiffs *fs, spiffs_file f, spiffs_fd **fd) { if (f <= 0 || f > fs->fd_count) { return SPIFFS_ERR_BAD_DESCRIPTOR; } spiffs_fd *fds = (spiffs_fd *)fs->fd_space; *fd = &fds[f-1]; if ((*fd)->file_nbr == 0) { return SPIFFS_ERR_FILE_CLOSED; } return SPIFFS_OK; } ================================================ FILE: app/spiffs/spiffs_nucleus.h ================================================ /* * spiffs_nucleus.h * * Created on: Jun 15, 2013 * Author: petera */ /* SPIFFS layout * * spiffs is designed for following spi flash characteristics: * - only big areas of data (blocks) can be erased * - erasing resets all bits in a block to ones * - writing pulls ones to zeroes * - zeroes cannot be pulled to ones, without erase * - wear leveling * * spiffs is also meant to be run on embedded, memory constraint devices. * * Entire area is divided in blocks. Entire area is also divided in pages. * Each block contains same number of pages. A page cannot be erased, but a * block can be erased. * * Entire area must be block_size * x * page_size must be block_size / (2^y) where y > 2 * * ex: area = 1024*1024 bytes, block size = 65536 bytes, page size = 256 bytes * * BLOCK 0 PAGE 0 object lookup 1 * PAGE 1 object lookup 2 * ... * PAGE n-1 object lookup n * PAGE n object data 1 * PAGE n+1 object data 2 * ... * PAGE n+m-1 object data m * * BLOCK 1 PAGE n+m object lookup 1 * PAGE n+m+1 object lookup 2 * ... * PAGE 2n+m-1 object lookup n * PAGE 2n+m object data 1 * PAGE 2n+m object data 2 * ... * PAGE 2n+2m-1 object data m * ... * * n is number of object lookup pages, which is number of pages needed to index all pages * in a block by object id * : block_size / page_size * sizeof(obj_id) / page_size * m is number data pages, which is number of pages in block minus number of lookup pages * : block_size / page_size - block_size / page_size * sizeof(obj_id) / page_size * thus, n+m is total number of pages in a block * : block_size / page_size * * ex: n = 65536/256*2/256 = 2, m = 65536/256 - 2 = 254 => n+m = 65536/256 = 256 * * Object lookup pages contain object id entries. Each entry represent the corresponding * data page. * Assuming a 16 bit object id, an object id being 0xffff represents a free page. * An object id being 0x0000 represents a deleted page. * * ex: page 0 : lookup : 0008 0001 0aaa ffff ffff ffff ffff ffff .. * page 1 : lookup : ffff ffff ffff ffff ffff ffff ffff ffff .. * page 2 : data : data for object id 0008 * page 3 : data : data for object id 0001 * page 4 : data : data for object id 0aaa * ... * * * Object data pages can be either object index pages or object content. * All object data pages contains a data page header, containing object id and span index. * The span index denotes the object page ordering amongst data pages with same object id. * This applies to both object index pages (when index spans more than one page of entries), * and object data pages. * An object index page contains page entries pointing to object content page. The entry index * in a object index page correlates to the span index in the actual object data page. * The first object index page (span index 0) is called object index header page, and also * contains object flags (directory/file), size, object name etc. * * ex: * BLOCK 1 * PAGE 256: objectl lookup page 1 * [*123] [ 123] [ 123] [ 123] * [ 123] [*123] [ 123] [ 123] * [free] [free] [free] [free] ... * PAGE 257: objectl lookup page 2 * [free] [free] [free] [free] ... * PAGE 258: object index page (header) * obj.id:0123 span.ix:0000 flags:INDEX * size:1600 name:ex.txt type:file * [259] [260] [261] [262] * PAGE 259: object data page * obj.id:0123 span.ix:0000 flags:DATA * PAGE 260: object data page * obj.id:0123 span.ix:0001 flags:DATA * PAGE 261: object data page * obj.id:0123 span.ix:0002 flags:DATA * PAGE 262: object data page * obj.id:0123 span.ix:0003 flags:DATA * PAGE 263: object index page * obj.id:0123 span.ix:0001 flags:INDEX * [264] [265] [fre] [fre] * [fre] [fre] [fre] [fre] * PAGE 264: object data page * obj.id:0123 span.ix:0004 flags:DATA * PAGE 265: object data page * obj.id:0123 span.ix:0005 flags:DATA * */ #ifndef SPIFFS_NUCLEUS_H_ #define SPIFFS_NUCLEUS_H_ #define _SPIFFS_ERR_CHECK_FIRST (SPIFFS_ERR_INTERNAL - 1) #define SPIFFS_ERR_CHECK_OBJ_ID_MISM (SPIFFS_ERR_INTERNAL - 1) #define SPIFFS_ERR_CHECK_SPIX_MISM (SPIFFS_ERR_INTERNAL - 2) #define SPIFFS_ERR_CHECK_FLAGS_BAD (SPIFFS_ERR_INTERNAL - 3) #define _SPIFFS_ERR_CHECK_LAST (SPIFFS_ERR_INTERNAL - 4) #define SPIFFS_VIS_COUNTINUE (SPIFFS_ERR_INTERNAL - 20) #define SPIFFS_VIS_COUNTINUE_RELOAD (SPIFFS_ERR_INTERNAL - 21) #define SPIFFS_VIS_END (SPIFFS_ERR_INTERNAL - 22) #define SPIFFS_EV_IX_UPD 0 #define SPIFFS_EV_IX_NEW 1 #define SPIFFS_EV_IX_DEL 2 #define SPIFFS_OBJ_ID_IX_FLAG (1<<(8*sizeof(spiffs_obj_id)-1)) #define SPIFFS_UNDEFINED_LEN (-1) #define SPIFFS_OBJ_ID_DELETED ((spiffs_obj_id)0) #define SPIFFS_OBJ_ID_FREE ((spiffs_obj_id)-1) #if SPIFFS_SINGLETON == 0 #define SPIFFS_CFG_LOG_PAGE_SZ(fs) \ ((fs)->cfg.log_page_size) #define SPIFFS_CFG_LOG_BLOCK_SZ(fs) \ ((fs)->cfg.log_block_size) #define SPIFFS_CFG_PHYS_SZ(fs) \ ((fs)->cfg.phys_size) #define SPIFFS_CFG_PHYS_ERASE_SZ(fs) \ ((fs)->cfg.phys_erase_block) #define SPIFFS_CFG_PHYS_ADDR(fs) \ ((fs)->cfg.phys_addr) #endif // total number of pages #define SPIFFS_MAX_PAGES(fs) \ ( SPIFFS_CFG_PHYS_SZ(fs)/SPIFFS_CFG_LOG_PAGE_SZ(fs) ) // total number of pages per block, including object lookup pages #define SPIFFS_PAGES_PER_BLOCK(fs) \ ( SPIFFS_CFG_LOG_BLOCK_SZ(fs)/SPIFFS_CFG_LOG_PAGE_SZ(fs) ) // number of object lookup pages per block #define SPIFFS_OBJ_LOOKUP_PAGES(fs) \ (MAX(1, (SPIFFS_PAGES_PER_BLOCK(fs) * sizeof(spiffs_obj_id)) / SPIFFS_CFG_LOG_PAGE_SZ(fs)) ) // checks if page index belongs to object lookup #define SPIFFS_IS_LOOKUP_PAGE(fs,pix) \ (((pix) % SPIFFS_PAGES_PER_BLOCK(fs)) < SPIFFS_OBJ_LOOKUP_PAGES(fs)) // number of object lookup entries in all object lookup pages #define SPIFFS_OBJ_LOOKUP_MAX_ENTRIES(fs) \ (SPIFFS_PAGES_PER_BLOCK(fs)-SPIFFS_OBJ_LOOKUP_PAGES(fs)) // converts a block to physical address #define SPIFFS_BLOCK_TO_PADDR(fs, block) \ ( SPIFFS_CFG_PHYS_ADDR(fs) + (block)* SPIFFS_CFG_LOG_BLOCK_SZ(fs) ) // converts a object lookup entry to page index #define SPIFFS_OBJ_LOOKUP_ENTRY_TO_PIX(fs, block, entry) \ ((block)*SPIFFS_PAGES_PER_BLOCK(fs) + (SPIFFS_OBJ_LOOKUP_PAGES(fs) + entry)) // converts a object lookup entry to physical address of corresponding page #define SPIFFS_OBJ_LOOKUP_ENTRY_TO_PADDR(fs, block, entry) \ (SPIFFS_BLOCK_TO_PADDR(fs, block) + (SPIFFS_OBJ_LOOKUP_PAGES(fs) + entry) * SPIFFS_CFG_LOG_PAGE_SZ(fs) ) // converts a page to physical address #define SPIFFS_PAGE_TO_PADDR(fs, page) \ ( SPIFFS_CFG_PHYS_ADDR(fs) + (page) * SPIFFS_CFG_LOG_PAGE_SZ(fs) ) // converts a physical address to page #define SPIFFS_PADDR_TO_PAGE(fs, addr) \ ( ((addr) - SPIFFS_CFG_PHYS_ADDR(fs)) / SPIFFS_CFG_LOG_PAGE_SZ(fs) ) // gives index in page for a physical address #define SPIFFS_PADDR_TO_PAGE_OFFSET(fs, addr) \ ( ((addr) - SPIFFS_CFG_PHYS_ADDR(fs)) % SPIFFS_CFG_LOG_PAGE_SZ(fs) ) // returns containing block for given page #define SPIFFS_BLOCK_FOR_PAGE(fs, page) \ ( (page) / SPIFFS_PAGES_PER_BLOCK(fs) ) // returns starting page for block #define SPIFFS_PAGE_FOR_BLOCK(fs, block) \ ( (block) * SPIFFS_PAGES_PER_BLOCK(fs) ) // converts page to entry in object lookup page #define SPIFFS_OBJ_LOOKUP_ENTRY_FOR_PAGE(fs, page) \ ( (page) % SPIFFS_PAGES_PER_BLOCK(fs) - SPIFFS_OBJ_LOOKUP_PAGES(fs) ) // returns data size in a data page #define SPIFFS_DATA_PAGE_SIZE(fs) \ ( SPIFFS_CFG_LOG_PAGE_SZ(fs) - sizeof(spiffs_page_header) ) // returns physical address for block's erase count #define SPIFFS_ERASE_COUNT_PADDR(fs, bix) \ ( SPIFFS_BLOCK_TO_PADDR(fs, bix) + SPIFFS_OBJ_LOOKUP_PAGES(fs) * SPIFFS_CFG_LOG_PAGE_SZ(fs) - sizeof(spiffs_obj_id) ) // define helpers object // entries in an object header page index #define SPIFFS_OBJ_HDR_IX_LEN(fs) \ ((SPIFFS_CFG_LOG_PAGE_SZ(fs) - sizeof(spiffs_page_object_ix_header))/sizeof(spiffs_page_ix)) // entries in an object page index #define SPIFFS_OBJ_IX_LEN(fs) \ ((SPIFFS_CFG_LOG_PAGE_SZ(fs) - sizeof(spiffs_page_object_ix))/sizeof(spiffs_page_ix)) // object index entry for given data span index #define SPIFFS_OBJ_IX_ENTRY(fs, spix) \ ((spix) < SPIFFS_OBJ_HDR_IX_LEN(fs) ? (spix) : (((spix)-SPIFFS_OBJ_HDR_IX_LEN(fs))%SPIFFS_OBJ_IX_LEN(fs))) // object index span index number for given data span index or entry #define SPIFFS_OBJ_IX_ENTRY_SPAN_IX(fs, spix) \ ((spix) < SPIFFS_OBJ_HDR_IX_LEN(fs) ? 0 : (1+((spix)-SPIFFS_OBJ_HDR_IX_LEN(fs))/SPIFFS_OBJ_IX_LEN(fs))) #define SPIFFS_OP_T_OBJ_LU (0<<0) #define SPIFFS_OP_T_OBJ_LU2 (1<<0) #define SPIFFS_OP_T_OBJ_IX (2<<0) #define SPIFFS_OP_T_OBJ_DA (3<<0) #define SPIFFS_OP_C_DELE (0<<2) #define SPIFFS_OP_C_UPDT (1<<2) #define SPIFFS_OP_C_MOVS (2<<2) #define SPIFFS_OP_C_MOVD (3<<2) #define SPIFFS_OP_C_FLSH (4<<2) #define SPIFFS_OP_C_READ (5<<2) #define SPIFFS_OP_C_WRTHRU (6<<2) #define SPIFFS_OP_TYPE_MASK (3<<0) #define SPIFFS_OP_COM_MASK (7<<2) // if 0, this page is written to, else clean #define SPIFFS_PH_FLAG_USED (1<<0) // if 0, writing is finalized, else under modification #define SPIFFS_PH_FLAG_FINAL (1<<1) // if 0, this is an index page, else a data page #define SPIFFS_PH_FLAG_INDEX (1<<2) // if 0, page is deleted, else valid #define SPIFFS_PH_FLAG_DELET (1<<7) // if 0, this index header is being deleted #define SPIFFS_PH_FLAG_IXDELE (1<<6) #define SPIFFS_CHECK_MOUNT(fs) \ ((fs)->block_count > 0) #define SPIFFS_CHECK_RES(res) \ do { \ if ((res) < SPIFFS_OK) return (res); \ } while (0); #define SPIFFS_API_CHECK_MOUNT(fs) \ if (!SPIFFS_CHECK_MOUNT((fs))) { \ (fs)->errno = SPIFFS_ERR_NOT_MOUNTED; \ return -1; \ } #define SPIFFS_API_CHECK_RES(fs, res) \ if ((res) < SPIFFS_OK) { \ (fs)->errno = (res); \ return -1; \ } #define SPIFFS_API_CHECK_RES_UNLOCK(fs, res) \ if ((res) < SPIFFS_OK) { \ (fs)->errno = (res); \ SPIFFS_UNLOCK(fs); \ return -1; \ } #define SPIFFS_VALIDATE_OBJIX(ph, objid, spix) \ if (((ph).flags & SPIFFS_PH_FLAG_USED) != 0) return SPIFFS_ERR_IS_FREE; \ if (((ph).flags & SPIFFS_PH_FLAG_DELET) == 0) return SPIFFS_ERR_DELETED; \ if (((ph).flags & SPIFFS_PH_FLAG_FINAL) != 0) return SPIFFS_ERR_NOT_FINALIZED; \ if (((ph).flags & SPIFFS_PH_FLAG_INDEX) != 0) return SPIFFS_ERR_NOT_INDEX; \ if (((objid) & SPIFFS_OBJ_ID_IX_FLAG) == 0) return SPIFFS_ERR_NOT_INDEX; \ if ((ph).span_ix != (spix)) return SPIFFS_ERR_INDEX_SPAN_MISMATCH; //if ((spix) == 0 && ((ph).flags & SPIFFS_PH_FLAG_IXDELE) == 0) return SPIFFS_ERR_DELETED; #define SPIFFS_VALIDATE_DATA(ph, objid, spix) \ if (((ph).flags & SPIFFS_PH_FLAG_USED) != 0) return SPIFFS_ERR_IS_FREE; \ if (((ph).flags & SPIFFS_PH_FLAG_DELET) == 0) return SPIFFS_ERR_DELETED; \ if (((ph).flags & SPIFFS_PH_FLAG_FINAL) != 0) return SPIFFS_ERR_NOT_FINALIZED; \ if (((ph).flags & SPIFFS_PH_FLAG_INDEX) == 0) return SPIFFS_ERR_IS_INDEX; \ if ((objid) & SPIFFS_OBJ_ID_IX_FLAG) return SPIFFS_ERR_IS_INDEX; \ if ((ph).span_ix != (spix)) return SPIFFS_ERR_DATA_SPAN_MISMATCH; // check id #define SPIFFS_VIS_CHECK_ID (1<<0) // report argument object id to visitor - else object lookup id is reported #define SPIFFS_VIS_CHECK_PH (1<<1) // stop searching at end of all look up pages #define SPIFFS_VIS_NO_WRAP (1<<2) #if SPIFFS_CACHE #define SPIFFS_CACHE_FLAG_DIRTY (1<<0) #define SPIFFS_CACHE_FLAG_WRTHRU (1<<1) #define SPIFFS_CACHE_FLAG_OBJLU (1<<2) #define SPIFFS_CACHE_FLAG_OBJIX (1<<3) #define SPIFFS_CACHE_FLAG_DATA (1<<4) #define SPIFFS_CACHE_FLAG_TYPE_WR (1<<7) #define SPIFFS_CACHE_PAGE_SIZE(fs) \ (sizeof(spiffs_cache_page) + SPIFFS_CFG_LOG_PAGE_SZ(fs)) #define spiffs_get_cache(fs) \ ((spiffs_cache *)((fs)->cache)) #define spiffs_get_cache_page_hdr(fs, c, ix) \ ((spiffs_cache_page *)(&((c)->cpages[(ix) * SPIFFS_CACHE_PAGE_SIZE(fs)]))) #define spiffs_get_cache_page(fs, c, ix) \ ((u8_t *)(&((c)->cpages[(ix) * SPIFFS_CACHE_PAGE_SIZE(fs)])) + sizeof(spiffs_cache_page)) // cache page struct typedef struct { // cache flags u8_t flags; // cache page index u8_t ix; // last access of this cache page u32_t last_access; union { // type read cache struct { // read cache page index spiffs_page_ix pix; }; #if SPIFFS_CACHE_WR // type write cache struct { // write cache spiffs_obj_id obj_id; // offset in cache page u32_t offset; // size of cache page u16_t size; }; #endif }; } spiffs_cache_page; // cache struct typedef struct { u8_t cpage_count; u32_t last_access; u32_t cpage_use_map; u32_t cpage_use_mask; u8_t *cpages; } spiffs_cache; #endif // spiffs nucleus file descriptor typedef struct { // the filesystem of this descriptor spiffs *fs; // number of file descriptor - if 0, the file descriptor is closed spiffs_file file_nbr; // object id - if SPIFFS_OBJ_ID_ERASED, the file was deleted spiffs_obj_id obj_id; // size of the file u32_t size; // cached object index header page index spiffs_page_ix objix_hdr_pix; // cached offset object index page index spiffs_page_ix cursor_objix_pix; // cached offset object index span index spiffs_span_ix cursor_objix_spix; // current absolute offset u32_t offset; // current file descriptor offset u32_t fdoffset; // fd flags spiffs_flags flags; #if SPIFFS_CACHE_WR spiffs_cache_page *cache_page; #endif } spiffs_fd; // object structs // page header, part of each page except object lookup pages typedef struct __attribute(( packed )) { // object id spiffs_obj_id obj_id; // object span index spiffs_span_ix span_ix; // flags u8_t flags; } spiffs_page_header; // object index header page header typedef struct __attribute(( packed )) { // common page header spiffs_page_header p_hdr; // alignment u8_t _align[4 - (sizeof(spiffs_page_header)&3)==0 ? 4 : (sizeof(spiffs_page_header)&3)]; // size of object u32_t size; // type of object spiffs_obj_type type; // alignment2 u8_t _align2[4 - (sizeof(spiffs_obj_type)&3)==0 ? 4 : (sizeof(spiffs_obj_type)&3)]; // name of object u8_t name[SPIFFS_OBJ_NAME_LEN]; } spiffs_page_object_ix_header; // object index page header typedef struct __attribute(( packed )) { spiffs_page_header p_hdr; u8_t _align[4 - (sizeof(spiffs_page_header)&3)==0 ? 4 : (sizeof(spiffs_page_header)&3)]; } spiffs_page_object_ix; // callback func for object lookup visitor typedef s32_t (*spiffs_visitor_f)(spiffs *fs, spiffs_obj_id id, spiffs_block_ix bix, int ix_entry, u32_t user_data, void *user_p); #if SPIFFS_CACHE #define _spiffs_rd(fs, op, fh, addr, len, dst) \ spiffs_phys_rd((fs), (op), (fh), (addr), (len), (dst)) #define _spiffs_wr(fs, op, fh, addr, len, src) \ spiffs_phys_wr((fs), (op), (fh), (addr), (len), (src)) #else #define _spiffs_rd(fs, op, fh, addr, len, dst) \ spiffs_phys_rd((fs), (addr), (len), (dst)) #define _spiffs_wr(fs, op, fh, addr, len, src) \ spiffs_phys_wr((fs), (addr), (len), (src)) #endif #ifndef MIN #define MIN(a,b) ((a) < (b) ? (a) : (b)) #endif #ifndef MAX #define MAX(a,b) ((a) > (b) ? (a) : (b)) #endif // --------------- s32_t spiffs_phys_rd( spiffs *fs, #if SPIFFS_CACHE u8_t op, spiffs_file fh, #endif u32_t addr, u32_t len, u8_t *dst); s32_t spiffs_phys_wr( spiffs *fs, #if SPIFFS_CACHE u8_t op, spiffs_file fh, #endif u32_t addr, u32_t len, u8_t *src); s32_t spiffs_phys_cpy( spiffs *fs, spiffs_file fh, u32_t dst, u32_t src, u32_t len); s32_t spiffs_phys_count_free_blocks( spiffs *fs); s32_t spiffs_obj_lu_find_entry_visitor( spiffs *fs, spiffs_block_ix starting_block, int starting_lu_entry, u8_t flags, spiffs_obj_id obj_id, spiffs_visitor_f v, u32_t user_data, void *user_p, spiffs_block_ix *block_ix, int *lu_entry); // --------------- s32_t spiffs_obj_lu_scan( spiffs *fs); s32_t spiffs_obj_lu_find_free_obj_id( spiffs *fs, spiffs_obj_id *obj_id); s32_t spiffs_obj_lu_find_free( spiffs *fs, spiffs_block_ix starting_block, int starting_lu_entry, spiffs_block_ix *block_ix, int *lu_entry); s32_t spiffs_obj_lu_find_id( spiffs *fs, spiffs_block_ix starting_block, int starting_lu_entry, spiffs_obj_id obj_id, spiffs_block_ix *block_ix, int *lu_entry); s32_t spiffs_obj_lu_find_id_and_span( spiffs *fs, spiffs_obj_id obj_id, spiffs_span_ix spix, spiffs_page_ix exclusion_pix, spiffs_page_ix *pix); s32_t spiffs_obj_lu_find_id_and_span_by_phdr( spiffs *fs, spiffs_obj_id obj_id, spiffs_span_ix spix, spiffs_page_ix exclusion_pix, spiffs_page_ix *pix); // --------------- s32_t spiffs_page_allocate_data( spiffs *fs, spiffs_obj_id obj_id, spiffs_page_header *ph, u8_t *data, u32_t len, u32_t page_offs, u8_t finalize, spiffs_page_ix *pix); s32_t spiffs_page_move( spiffs *fs, spiffs_file fh, u8_t *page_data, spiffs_obj_id obj_id, spiffs_page_header *page_hdr, spiffs_page_ix src_pix, spiffs_page_ix *dst_pix); s32_t spiffs_page_delete( spiffs *fs, spiffs_page_ix pix); // --------------- s32_t spiffs_object_create( spiffs *fs, spiffs_obj_id obj_id, u8_t name[SPIFFS_OBJ_NAME_LEN], spiffs_obj_type type, spiffs_page_ix *objix_hdr_pix); s32_t spiffs_object_update_index_hdr( spiffs *fs, spiffs_fd *fd, spiffs_obj_id obj_id, spiffs_page_ix objix_hdr_pix, u8_t *new_objix_hdr_data, u8_t name[SPIFFS_OBJ_NAME_LEN], u32_t size, spiffs_page_ix *new_pix); void spiffs_cb_object_event( spiffs *fs, spiffs_fd *fd, int ev, spiffs_obj_id obj_id, spiffs_span_ix spix, spiffs_page_ix new_pix, u32_t new_size); s32_t spiffs_object_open_by_id( spiffs *fs, spiffs_obj_id obj_id, spiffs_fd *f, spiffs_flags flags, spiffs_mode mode); s32_t spiffs_object_open_by_page( spiffs *fs, spiffs_page_ix pix, spiffs_fd *f, spiffs_flags flags, spiffs_mode mode); s32_t spiffs_object_append( spiffs_fd *fd, u32_t offset, u8_t *data, u32_t len); s32_t spiffs_object_modify( spiffs_fd *fd, u32_t offset, u8_t *data, u32_t len); s32_t spiffs_object_read( spiffs_fd *fd, u32_t offset, u32_t len, u8_t *dst); s32_t spiffs_object_truncate( spiffs_fd *fd, u32_t new_len, u8_t remove_object); s32_t spiffs_object_find_object_index_header_by_name( spiffs *fs, u8_t name[SPIFFS_OBJ_NAME_LEN], spiffs_page_ix *pix); // --------------- s32_t spiffs_gc_check( spiffs *fs, u32_t len); s32_t spiffs_gc_erase_page_stats( spiffs *fs, spiffs_block_ix bix); s32_t spiffs_gc_find_candidate( spiffs *fs, spiffs_block_ix **block_candidate, int *candidate_count); s32_t spiffs_gc_clean( spiffs *fs, spiffs_block_ix bix); s32_t spiffs_gc_quick( spiffs *fs); // --------------- s32_t spiffs_fd_find_new( spiffs *fs, spiffs_fd **fd); s32_t spiffs_fd_return( spiffs *fs, spiffs_file f); s32_t spiffs_fd_get( spiffs *fs, spiffs_file f, spiffs_fd **fd); #if SPIFFS_CACHE void spiffs_cache_init( spiffs *fs); void spiffs_cache_drop_page( spiffs *fs, spiffs_page_ix pix); #if SPIFFS_CACHE_WR spiffs_cache_page *spiffs_cache_page_allocate_by_fd( spiffs *fs, spiffs_fd *fd); void spiffs_cache_fd_release( spiffs *fs, spiffs_cache_page *cp); spiffs_cache_page *spiffs_cache_page_get_by_fd( spiffs *fs, spiffs_fd *fd); #endif #endif s32_t spiffs_lookup_consistency_check( spiffs *fs, u8_t check_all_objects); s32_t spiffs_page_consistency_check( spiffs *fs); s32_t spiffs_object_index_consistency_check( spiffs *fs); #endif /* SPIFFS_NUCLEUS_H_ */ ================================================ FILE: app/ssl/Makefile ================================================ ############################################################# # Required variables for each makefile # Discard this section from all parent makefiles # Expected variables (with automatic defaults): # CSRCS (all "C" files in the dir) # SUBDIRS (all subdirs with a Makefile) # GEN_LIBS - list of libs to be generated () # GEN_IMAGES - list of images to be generated () # COMPONENTS_xxx - a list of libs/objs in the form # subdir/lib to be extracted and rolled up into # a generated lib/image xxx.a () # ifndef PDIR UP_EXTRACT_DIR = .. GEN_LIBS = libssl.a COMPONENTS_libssl = crypto/libsslcrypto.a \ ssl/libsslssl.a \ app/libsslapp.a endif ############################################################# # Configuration i.e. compile options etc. # Target specific stuff (defines etc.) goes in here! # Generally values applying to a tree are captured in the # makefile at its root level - these are then overridden # for a subtree within the makefile rooted therein # #DEFINES += ############################################################# # Recursion Magic - Don't touch this!! # # Each subtree potentially has an include directory # corresponding to the common APIs applicable to modules # rooted at that subtree. Accordingly, the INCLUDE PATH # of a module can only contain the include directories up # its parent path, and not its siblings # # Required for each makefile to inherit from the parent # INCLUDES := $(INCLUDES) -I $(PDIR)include INCLUDES += -I ./ PDIR := ../$(PDIR) sinclude $(PDIR)Makefile ================================================ FILE: app/ssl/app/Makefile ================================================ ############################################################# # Required variables for each makefile # Discard this section from all parent makefiles # Expected variables (with automatic defaults): # CSRCS (all "C" files in the dir) # SUBDIRS (all subdirs with a Makefile) # GEN_LIBS - list of libs to be generated () # GEN_IMAGES - list of images to be generated () # COMPONENTS_xxx - a list of libs/objs in the form # subdir/lib to be extracted and rolled up into # a generated lib/image xxx.a () # ifndef PDIR GEN_LIBS = libsslapp.a endif ############################################################# # Configuration i.e. compile options etc. # Target specific stuff (defines etc.) goes in here! # Generally values applying to a tree are captured in the # makefile at its root level - these are then overridden # for a subtree within the makefile rooted therein # #DEFINES += ############################################################# # Recursion Magic - Don't touch this!! # # Each subtree potentially has an include directory # corresponding to the common APIs applicable to modules # rooted at that subtree. Accordingly, the INCLUDE PATH # of a module can only contain the include directories up # its parent path, and not its siblings # # Required for each makefile to inherit from the parent # INCLUDES := $(INCLUDES) -I $(PDIR)include INCLUDES += -I ./ PDIR := ../$(PDIR) sinclude $(PDIR)Makefile ================================================ FILE: app/ssl/app/espconn_secure.c ================================================ /****************************************************************************** * Copyright 2013-2014 Espressif Systems (Wuxi) * * FileName: espconn_encry.c * * Description: data encrypt interface * * Modification history: * 2014/3/31, v1.0 create this file. *******************************************************************************/ #include "lwip/netif.h" #include "lwip/inet.h" #include "netif/etharp.h" #include "lwip/tcp.h" #include "lwip/ip.h" #include "lwip/init.h" #include "ets_sys.h" #include "os_type.h" //#include "os.h" #include "ssl/app/espconn_ssl.h" /****************************************************************************** * FunctionName : espconn_encry_connect * Description : The function given as the connect * Parameters : espconn -- the espconn used to listen the connection * Returns : none *******************************************************************************/ sint8 ICACHE_FLASH_ATTR espconn_secure_connect(struct espconn *espconn) { if (espconn == NULL) return ESPCONN_ARG; return espconn_ssl_client(espconn); } /****************************************************************************** * FunctionName : espconn_encry_disconnect * Description : The function given as the disconnect * Parameters : espconn -- the espconn used to listen the connection * Returns : none *******************************************************************************/ sint8 ICACHE_FLASH_ATTR espconn_secure_disconnect(struct espconn *espconn) { espconn_msg *pnode = NULL; bool value = false; if (espconn == NULL) return ESPCONN_ARG; value = espconn_find_connection(espconn, &pnode); if (value){ espconn_ssl_disconnect(pnode); return ESPCONN_OK; } else return ESPCONN_ARG; } /****************************************************************************** * FunctionName : espconn_encry_sent * Description : sent data for client or server * Parameters : espconn -- espconn to set for client or server * psent -- data to send * length -- length of data to send * Returns : none *******************************************************************************/ sint8 ICACHE_FLASH_ATTR espconn_secure_sent(struct espconn *espconn, uint8 *psent, uint16 length) { espconn_msg *pnode = NULL; bool value = false; if (espconn == NULL) return ESPCONN_ARG; espconn ->state = ESPCONN_WRITE; value = espconn_find_connection(espconn, &pnode); if (value){ espconn_ssl_sent(pnode, psent, length); return ESPCONN_OK; } else return ESPCONN_ARG; } sint8 ICACHE_FLASH_ATTR espconn_secure_accept(struct espconn *espconn) { if (espconn == NULL) return ESPCONN_ARG; return espconn_ssl_server(espconn); } ================================================ FILE: app/ssl/app/espconn_ssl.c ================================================ /****************************************************************************** * Copyright 2013-2014 Espressif Systems (Wuxi) * * FileName: espconn_ssl.c * * Description: ssl encrypt interface * * Modification history: * 2014/3/31, v1.0 create this file. *******************************************************************************/ #include "lwip/netif.h" #include "netif/etharp.h" #include "lwip/tcp.h" #include "lwip/ip.h" #include "lwip/init.h" #include "lwip/tcp_impl.h" #include "ssl/ssl_os_port.h" #include "ssl/app/espconn_ssl.h" #include "ets_sys.h" #include "os_type.h" //#include "os.h" #include "lwip/app/espconn.h" struct pbuf *psslpbuf = NULL; extern espconn_msg *plink_active; static err_t espconn_ssl_crecv(void *arg, struct tcp_pcb *pcb, struct pbuf *p, err_t err); static err_t espconn_ssl_srecv(void *arg, struct tcp_pcb *pcb, struct pbuf *p, err_t err); static void espconn_ssl_sclose(void *arg, struct tcp_pcb *pcb); static void espconn_ssl_cclose(void *arg, struct tcp_pcb *pcb); /////////////////////////////common function/////////////////////////////////// /****************************************************************************** * FunctionName : display_session_id * Description : Display what session id we have. * Parameters : * Returns : *******************************************************************************/ static void ICACHE_FLASH_ATTR display_session_id(SSL *ssl) { int i; const uint8_t *session_id = ssl_get_session_id(ssl); int sess_id_size = ssl_get_session_id_size(ssl); if (sess_id_size > 0) { ssl_printf("-----BEGIN SSL SESSION PARAMETERS-----\n"); for (i = 0; i < sess_id_size; i++) { ssl_printf("%02x", session_id[i]); } ssl_printf("\n-----END SSL SESSION PARAMETERS-----\n"); //TTY_FLUSH(); } } /****************************************************************************** * FunctionName : display_cipher * Description : Display what cipher we are using * Parameters : * Returns : *******************************************************************************/ static void ICACHE_FLASH_ATTR display_cipher(SSL *ssl) { ssl_printf("CIPHER is "); switch (ssl_get_cipher_id(ssl)) { case SSL_AES128_SHA: ssl_printf("AES128-SHA"); break; case SSL_AES256_SHA: ssl_printf("AES256-SHA"); break; case SSL_RC4_128_SHA: ssl_printf("RC4-SHA"); break; case SSL_RC4_128_MD5: ssl_printf("RC4-MD5"); break; default: ssl_printf("Unknown - %d", ssl_get_cipher_id(ssl)); break; } ssl_printf("\n"); //TTY_FLUSH(); } /****************************************************************************** * FunctionName : espconn_ssl_reconnect * Description : reconnect with host * Parameters : arg -- Additional argument to pass to the callback function * Returns : none *******************************************************************************/ static void ICACHE_FLASH_ATTR espconn_ssl_reconnect(void *arg) { espconn_msg *pssl_recon = arg; struct espconn *espconn = NULL; ssl_msg *pssl = NULL; sint8 ssl_reerr = 0; if (pssl_recon != NULL) { espconn = pssl_recon->preverse; if (pssl_recon->pespconn != NULL){ if (espconn != NULL){ /*espconn_copy_partial(espconn, pssl_recon->pespconn); if (pssl_recon->pespconn->proto.tcp != NULL){ os_free(pssl_recon->pespconn->proto.tcp); pssl_recon->pespconn->proto.tcp = NULL; } os_free(pssl_recon->pespconn); pssl_recon->pespconn = NULL;*/ espconn = pssl_recon->preverse; } else { espconn = pssl_recon->pespconn; } } pssl = pssl_recon->pssl; ssl_reerr = pssl_recon->pcommon.err; if (pssl != NULL) { if (pssl->ssl) { ssl_free(pssl->ssl); } if (pssl->ssl_ctx) { ssl_ctx_free(pssl->ssl_ctx); } os_free(pssl); pssl = NULL; pssl_recon->pssl = pssl; } os_free(pssl_recon); pssl_recon = NULL; if (espconn ->proto.tcp->reconnect_callback != NULL) { espconn ->proto.tcp->reconnect_callback(espconn, ssl_reerr); } } else { ssl_printf("espconn_ssl_reconnect err\n"); } } /****************************************************************************** * FunctionName : espconn_ssl_dissuccessful * Description : as * Parameters : * Returns : *******************************************************************************/ static void ICACHE_FLASH_ATTR espconn_ssl_dissuccessful(void *arg) { espconn_msg *pdiscon = arg; struct espconn *espconn = NULL; struct tcp_pcb *pcb = NULL; ssl_msg *pssl = NULL; if (pdiscon != NULL) { espconn = pdiscon->preverse; if (pdiscon->pespconn != NULL){ if (espconn != NULL){ /*espconn_copy_partial(espconn, pdiscon->pespconn); if (pdiscon->pespconn->proto.tcp != NULL){ os_free(pdiscon->pespconn->proto.tcp); pdiscon->pespconn->proto.tcp = NULL; } os_free(pdiscon->pespconn); pdiscon->pespconn = NULL;*/ espconn = pdiscon->preverse; } else{ espconn = pdiscon->pespconn; } pcb = pdiscon->pcommon.pcb; tcp_arg(pcb, NULL); tcp_err(pcb, NULL); } pssl = pdiscon->pssl; if (pssl != NULL) { if (pssl->ssl) { ssl_free(pssl->ssl); } if (pssl->ssl_ctx) { ssl_ctx_free(pssl->ssl_ctx); } os_free(pssl); pssl = NULL; pdiscon->pssl = pssl; } os_free(pdiscon); pdiscon = NULL; if (espconn ->proto.tcp->disconnect_callback != NULL) { espconn ->proto.tcp->disconnect_callback(espconn); } } else { espconn_printf("espconn_ssl_dissuccessful err\n"); } } /****************************************************************************** * FunctionName : espconn_ssl_write * Description : sent data for client or server * Parameters : void *arg -- client or server to send * uint8* psent -- Data to send * uint16 length -- Length of data to send * Returns : none *******************************************************************************/ void ICACHE_FLASH_ATTR espconn_ssl_sent(void *arg, uint8 *psent, uint16 length) { espconn_msg *pssl_sent = arg; struct tcp_pcb *pcb = NULL; ssl_msg *pssl = NULL; u16_t len = 0; int res = 0; ssl_printf("espconn_ssl_sent pcb %p psent %p length %d\n", arg, psent, length); if (pssl_sent == NULL || psent == NULL || length == 0) { return; } pcb = pssl_sent->pcommon.pcb; pssl = pssl_sent->pssl; if (RT_MAX_PLAIN_LENGTH < length) { len = RT_MAX_PLAIN_LENGTH; } else { len = length; } if (pssl != NULL) { if (pssl->ssl != NULL) { pssl->ssl->SslClient_pcb = pcb; res = ssl_write(pssl->ssl, psent, len); pssl_sent->pcommon.ptrbuf = psent + len; pssl_sent->pcommon.cntr = length - len; } } } /****************************************************************************** * FunctionName : espconn_sent_packet * Description : sent data for client or server * Parameters : void *arg -- client or server to send * uint8* psent -- Data to send * uint16 length -- Length of data to send * Returns : none *******************************************************************************/ void ICACHE_FLASH_ATTR espconn_sent_packet(struct tcp_pcb *pcb, uint8 *psent, uint16 length) { err_t err = 0; u16_t len = 0; if (pcb == NULL || psent == NULL || length == 0) { return; } if (tcp_sndbuf(pcb) < length) { len = tcp_sndbuf(pcb); } else { len = length; } if (len > (2 * pcb->mss)) { len = 2 * pcb->mss; } do { err = tcp_write(pcb, psent, len, 0); if (err == ERR_MEM) { len /= 2; } } while (err == ERR_MEM && len > 1); if (err == ERR_OK) { err = tcp_output(pcb); } } ////////////////////////////////client function//////////////////////////////// /****************************************************************************** * FunctionName : espconn_ssl_cclose_cb * Description : as * Parameters : * Returns : *******************************************************************************/ static void ICACHE_FLASH_ATTR espconn_ssl_cclose_cb(void *arg) { static uint16 timecount = 0; espconn_msg *pcclose_cb = arg; if (pcclose_cb == NULL) { return; } struct tcp_pcb *pcb = pcclose_cb->pcommon.pcb; ssl_printf("espconn_ssl_cclose_cb %d %d\n", pcb->state, pcb->nrtx); if (pcb->state == TIME_WAIT || pcb->state == CLOSED) { pcclose_cb->pespconn ->state = ESPCONN_CLOSE; /*remove the node from the client's active connection list*/ espconn_list_delete(&plink_active, pcclose_cb); espconn_ssl_dissuccessful((void *)pcclose_cb); } else { os_timer_arm(&pcclose_cb->pcommon.ptimer, TCP_FAST_INTERVAL, 0); } } /****************************************************************************** * FunctionName : espconn_sslclient_close * Description : The connection shall be actively closed. * Parameters : pcb -- Additional argument to pass to the callback function * pcb -- the pcb to close * Returns : none *******************************************************************************/ static void ICACHE_FLASH_ATTR espconn_ssl_cclose(void *arg, struct tcp_pcb *pcb) { espconn_msg *pcclose = arg; os_timer_disarm(&pcclose->pcommon.ptimer); os_timer_setfn(&pcclose->pcommon.ptimer, espconn_ssl_cclose_cb, pcclose); os_timer_arm(&pcclose->pcommon.ptimer, TCP_FAST_INTERVAL, 0); tcp_recv(pcb, NULL); pcclose->pcommon.err = tcp_close(pcb); ssl_printf("espconn_ssl_cclose %d\n", pcclose->pcommon.err); if (pcclose->pcommon.err != ERR_OK) { /* closing failed, try again later */ tcp_recv(pcb, espconn_ssl_crecv); } else { tcp_sent(pcb, NULL); tcp_poll(pcb, NULL, 0); } } /****************************************************************************** * FunctionName : espconn_sslclient_sent * Description : Data has been sent and acknowledged by the remote host. * This means that more data can be sent. * Parameters : arg -- Additional argument to pass to the callback function * pcb -- The connection pcb for which data has been acknowledged * len -- The amount of bytes acknowledged * Returns : ERR_OK: try to send some data by calling tcp_output * ERR_ABRT: if you have called tcp_abort from within the function! *******************************************************************************/ static err_t ICACHE_FLASH_ATTR espconn_ssl_csent(void *arg, struct tcp_pcb *pcb, u16_t len) { espconn_msg *psent = arg; ssl_msg *pssl = psent->pssl; psent->pcommon.pcb = pcb; if (pssl->quiet == true) { int pkt_size = pssl->ssl->bm_index + SSL_RECORD_SIZE; u16_t max_len = 2 * pcb->mss; pssl->pkt_length += len; ssl_printf("espconn_ssl_csent %d %d %d\n", len, pssl->pkt_length, pkt_size); if (pssl->pkt_length == pkt_size){ pssl->ssl->bm_index = 0; pssl->pkt_length = 0; if (psent->pcommon.cntr == 0) { psent->pespconn->state = ESPCONN_CONNECT; if (psent->pespconn->sent_callback != NULL) { psent->pespconn->sent_callback(psent->pespconn); } } else { espconn_ssl_sent(psent, psent->pcommon.ptrbuf, psent->pcommon.cntr); } } else { if (len == max_len){ espconn_sent_packet(pcb, &pssl->ssl->bm_all_data[pssl->pkt_length], pkt_size - pssl->pkt_length); } } } else { ssl_printf("espconn_ssl_csent %p %p %d\n", pcb, pssl->ssl->bm_all_data, len); } return ERR_OK; } /****************************************************************************** * FunctionName : espconn_sslclient_recv * Description : Data has been received on this pcb. * Parameters : arg -- Additional argument to pass to the callback function * pcb -- The connection pcb which received data * p -- The received data (or NULL when the connection has been closed!) * err -- An error code if there has been an error receiving * Returns : ERR_ABRT: if you have called tcp_abort from within the function! *******************************************************************************/ static err_t ICACHE_FLASH_ATTR espconn_ssl_crecv(void *arg, struct tcp_pcb *pcb, struct pbuf *p, err_t err) { u16_t ret = 0; espconn_msg *precv = arg; ssl_msg *pssl = precv->pssl; ssl_printf("espconn_ssl_crecv %d %p %p\n", __LINE__, pssl->ssl, p); if (p != NULL) { tcp_recved(pcb, p ->tot_len); if (pssl->ssl == NULL) { pbuf_free(p); } else { pssl->ssl->ssl_pbuf = p; if (ssl_handshake_status(pssl->ssl) != SSL_OK) { ret = ssl_read(pssl->ssl, NULL); pbuf_free(p); if (ret != SSL_OK){ os_printf("client handshake failed\n"); espconn_ssl_cclose(arg, pcb); } } if (ssl_handshake_status(pssl->ssl) == SSL_OK) { if (!pssl->quiet) { ssl_printf("client handshake need size %d\n", system_get_free_heap_size()); const char *common_name = ssl_get_cert_dn(pssl->ssl, SSL_X509_CERT_COMMON_NAME); if (common_name) { ssl_printf("Common Name:\t\t\t%s\n", common_name); } display_session_id(pssl->ssl); display_cipher(pssl->ssl); pssl->quiet = true; os_printf("client handshake ok!\n"); REG_CLR_BIT(0x3ff00014, BIT(0)); os_update_cpu_frequency(80); precv->pespconn->state = ESPCONN_CONNECT; precv->pcommon.pcb = pcb; pbuf_free(p); if (precv->pespconn->proto.tcp->connect_callback != NULL) { precv->pespconn->proto.tcp->connect_callback(precv->pespconn); } } else { uint8_t *read_buf = NULL; ret = ssl_read(pssl->ssl, &read_buf); precv->pespconn->state = ESPCONN_READ; precv->pcommon.pcb = pcb; pbuf_free(p); if (precv->pespconn->recv_callback != NULL && read_buf != NULL) { precv->pespconn->recv_callback(precv->pespconn, read_buf, ret); } precv->pespconn->state = ESPCONN_CONNECT; } } } } if (err == ERR_OK && p == NULL) { espconn_ssl_cclose(precv, pcb); } return ERR_OK; } /****************************************************************************** * FunctionName : espconn_client_err * Description : The pcb had an error and is already deallocated. * The argument might still be valid (if != NULL). * Parameters : arg -- Additional argument to pass to the callback function * err -- Error code to indicate why the pcb has been closed * Returns : none *******************************************************************************/ static void ICACHE_FLASH_ATTR espconn_ssl_cerr(void *arg, err_t err) { espconn_msg *pssl_cerr = arg; struct tcp_pcb *pcb = NULL; LWIP_UNUSED_ARG(err); if (pssl_cerr != NULL) { os_timer_disarm(&pssl_cerr->pcommon.ptimer); pcb = pssl_cerr->pcommon.pcb; pssl_cerr->pespconn->state = ESPCONN_CLOSE; espconn_printf("espconn_ssl_cerr %d %d %d\n", pcb->state, pcb->nrtx, err); /*remove the node from the client's active connection list*/ espconn_list_delete(&plink_active, pssl_cerr); if (err == ERR_ABRT) { switch (pcb->state) { case SYN_SENT: if (pcb->nrtx == TCP_SYNMAXRTX) { pssl_cerr->pcommon.err = ESPCONN_CONN; } else { pssl_cerr->pcommon.err = err; } break; case ESTABLISHED: if (pcb->nrtx == TCP_MAXRTX) { pssl_cerr->pcommon.err = ESPCONN_TIMEOUT; } else { pssl_cerr->pcommon.err = err; } break; case FIN_WAIT_1: if (pcb->nrtx == TCP_MAXRTX) { pssl_cerr->pcommon.err = ESPCONN_CLSD; } else { pssl_cerr->pcommon.err = err; } break; case FIN_WAIT_2: pssl_cerr->pcommon.err = ESPCONN_CLSD; break; case CLOSED: pssl_cerr->pcommon.err = ESPCONN_CONN; break; default : break; } } else { pssl_cerr->pcommon.err = err; } os_timer_setfn(&pssl_cerr->pcommon.ptimer, espconn_ssl_reconnect, pssl_cerr); os_timer_arm(&pssl_cerr->pcommon.ptimer, 10, 0); } } #if 0 /****************************************************************************** * FunctionName : espconn_ssl_cpoll * Description : The poll function is called every 3nd second. * If there has been no data sent (which resets the retries) in 3 seconds, close. * If the last portion of a file has not been sent in 3 seconds, close. * * This could be increased, but we don't want to waste resources for bad connections. * Parameters : arg -- Additional argument to pass to the callback function * pcb -- The connection pcb for which data has been acknowledged * Returns : ERR_OK: try to send some data by calling tcp_output * ERR_ABRT: if you have called tcp_abort from within the function! *******************************************************************************/ static err_t ICACHE_FLASH_ATTR espconn_ssl_cpoll(void *arg, struct tcp_pcb *pcb) { ssl_printf("espconn_ssl_cpoll %p %d\n", pcb, pcb->state); struct espconn *espconn = arg; if (arg == NULL) { tcp_abandon(pcb, 0); tcp_poll(pcb, NULL, 0); return ERR_ABRT; } if (pcb ->state == ESTABLISHED) { espconn->recv_check ++; if (espconn ->recv_check == 0x05){ //tcp_poll(pcb, espconn_ssl_cpoll, 0); espconn->recv_check = 0; espconn_ssl_cclose(arg, pcb); } } else { //tcp_poll(pcb, espconn_ssl_cpoll, 0); espconn_ssl_cclose(arg, pcb); } return ERR_OK; } #endif /****************************************************************************** * FunctionName : espconn_sslclient_connect * Description : A new incoming connection has been connected. * Parameters : arg -- Additional argument to pass to the callback function * tpcb -- The connection pcb which is connected * err -- An unused error code, always ERR_OK currently * Returns : connection result *******************************************************************************/ static err_t ICACHE_FLASH_ATTR espconn_ssl_connect(void *arg, struct tcp_pcb *tpcb, err_t err) { espconn_msg *pconnect = arg; ssl_msg *pssl = NULL; uint32_t options; options = SSL_SERVER_VERIFY_LATER | SSL_DISPLAY_CERTS | SSL_NO_DEFAULT_KEY; ssl_printf("espconn_ssl_connect %p %p %p %d\n", tpcb, arg, pespconn->psecure, system_get_free_heap_size()); //if (pespconn->psecure != NULL){ // return ERR_ISCONN; //} pconnect->pcommon.pcb = tpcb; pssl = (ssl_msg *)os_zalloc(sizeof(ssl_msg)); pconnect->pssl = pssl; if (pssl == NULL) { return ERR_MEM; } REG_SET_BIT(0x3ff00014, BIT(0)); os_update_cpu_frequency(160); os_printf("client handshake start.\n"); pssl->quiet = false; pssl->ssl_ctx = ssl_ctx_new(options, SSL_DEFAULT_CLNT_SESS); if (pssl->ssl_ctx == NULL) { return ERR_MEM; } ssl_printf("espconn_ssl_client ssl_ctx %p\n", pssl->ssl_ctx); pssl->ssl = SSLClient_new(pssl->ssl_ctx, tpcb, NULL, 0); if (pssl->ssl == NULL) { return ERR_MEM; } tcp_arg(tpcb, arg); tcp_sent(tpcb, espconn_ssl_csent); tcp_recv(tpcb, espconn_ssl_crecv); //tcp_poll(tpcb, espconn_ssl_cpoll, 6); return ERR_OK; } /****************************************************************************** * FunctionName : espconn_ssl_disconnect * Description : A new incoming connection has been disconnected. * Parameters : espconn -- the espconn used to disconnect with host * Returns : none *******************************************************************************/ void ICACHE_FLASH_ATTR espconn_ssl_disconnect(espconn_msg *pdis) { if (pdis != NULL) { if (pdis->preverse == NULL) espconn_ssl_cclose(pdis, pdis->pcommon.pcb); else espconn_ssl_sclose(pdis, pdis->pcommon.pcb); } else { ssl_printf("espconn_ssl_disconnect err.\n"); } } /****************************************************************************** * FunctionName : espconn_ssl_client * Description : Initialize the client: set up a connect PCB and bind it to * the defined port * Parameters : espconn -- the espconn used to build client * Returns : none *******************************************************************************/ sint8 ICACHE_FLASH_ATTR espconn_ssl_client(struct espconn *espconn) { struct tcp_pcb *pcb; struct ip_addr ipaddr; espconn_msg *pclient = NULL; pclient = plink_active; while(pclient != NULL){ if (pclient->pssl != NULL) return ESPCONN_ISCONN; pclient = pclient->pnext; } pclient = (espconn_msg *)os_zalloc(sizeof(espconn_msg)); if (pclient == NULL){ return ESPCONN_MEM; } IP4_ADDR(&ipaddr, espconn->proto.tcp->remote_ip[0], espconn->proto.tcp->remote_ip[1], espconn->proto.tcp->remote_ip[2], espconn->proto.tcp->remote_ip[3]); pcb = tcp_new(); if (pcb == NULL) { espconn ->state = ESPCONN_NONE; os_free(pclient); pclient = NULL; return ESPCONN_MEM; } else { /*insert the node to the active connection list*/ espconn_list_creat(&plink_active, pclient); tcp_arg(pcb, (void *)pclient); tcp_err(pcb, espconn_ssl_cerr); pclient->preverse = NULL; pclient->pespconn = espconn; pclient->pespconn->state = ESPCONN_WAIT; pclient->pcommon.pcb = pcb; tcp_bind(pcb, IP_ADDR_ANY, pclient->pespconn->proto.tcp->local_port); pclient->pcommon.err = tcp_connect(pcb, &ipaddr, pclient->pespconn->proto.tcp->remote_port, espconn_ssl_connect); return ESPCONN_OK; } } /////////////////////////////server's function///////////////////////////////// /****************************************************************************** * FunctionName : espconn_ssl_sclose_cb * Description : as * Parameters : * Returns : *******************************************************************************/ static void ICACHE_FLASH_ATTR espconn_ssl_sclose_cb(void *arg) { static uint16 timecount = 0; espconn_msg *psclose_cb = arg; if (psclose_cb == NULL) { return; } struct tcp_pcb *pcb = psclose_cb->pcommon.pcb; ssl_printf("espconn_ssl_sclose_cb %d %d\n", pcb->state, pcb->nrtx); if (pcb->state == CLOSED || pcb->state == TIME_WAIT) { psclose_cb ->pespconn ->state = ESPCONN_CLOSE; psclose_cb->pespconn->link_cnt --; /*remove the node from the server's active connection list*/ espconn_list_delete(&plink_active, psclose_cb); espconn_ssl_dissuccessful((void *)psclose_cb); } else { os_timer_arm(&psclose_cb->pcommon.ptimer, TCP_FAST_INTERVAL, 0); } } /****************************************************************************** * FunctionName : espconn_sslclient_close * Description : The connection shall be actively closed. * Parameters : pcb -- Additional argument to pass to the callback function * pcb -- the pcb to close * Returns : none *******************************************************************************/ static void ICACHE_FLASH_ATTR espconn_ssl_sclose(void *arg, struct tcp_pcb *pcb) { espconn_msg *psclose = arg; os_timer_disarm(&psclose->pcommon.ptimer); os_timer_setfn(&psclose->pcommon.ptimer, espconn_ssl_sclose_cb, psclose); os_timer_arm(&psclose->pcommon.ptimer, TCP_FAST_INTERVAL, 0); tcp_recv(pcb, NULL); psclose->pcommon.err = tcp_close(pcb); if (psclose->pcommon.err != ERR_OK) { /* closing failed, try again later */ tcp_recv(pcb, espconn_ssl_srecv); } else { tcp_sent(pcb, NULL); tcp_poll(pcb, NULL, 0); } } /****************************************************************************** * FunctionName : espconn_sslclient_sent * Description : Data has been sent and acknowledged by the remote host. * This means that more data can be sent. * Parameters : arg -- Additional argument to pass to the callback function * pcb -- The connection pcb for which data has been acknowledged * len -- The amount of bytes acknowledged * Returns : ERR_OK: try to send some data by calling tcp_output * ERR_ABRT: if you have called tcp_abort from within the function! *******************************************************************************/ static err_t ICACHE_FLASH_ATTR espconn_ssl_ssent(void *arg, struct tcp_pcb *pcb, u16_t len) { espconn_msg *psent = arg; ssl_msg *pssl = psent->pssl; psent->pcommon.pcb = pcb; psent->pcommon.recv_check = 0; if (ssl_handshake_status(pssl->ssl) == SSL_OK) { if (!pssl->quiet) { ssl_printf("espconn_ssl_ssent %p %d\n",pcb, system_get_free_heap_size()); const char *common_name = ssl_get_cert_dn(pssl->ssl, SSL_X509_CERT_COMMON_NAME); if (common_name) { ssl_printf("Common Name:\t\t\t%s\n", common_name); } display_session_id(pssl->ssl); display_cipher(pssl->ssl); pssl->quiet = true; os_printf("server handshake ok!\n"); REG_CLR_BIT(0x3ff00014, BIT(0)); os_update_cpu_frequency(80); psent->pespconn->state = ESPCONN_CONNECT; if (psent->pespconn->proto.tcp->connect_callback != NULL) { psent->pespconn->proto.tcp->connect_callback(psent->pespconn); } } else { int pkt_size = pssl->ssl->bm_index + SSL_RECORD_SIZE; u16_t max_len = 2 * pcb->mss; pssl->pkt_length += len; ssl_printf("espconn_ssl_ssent %d %d %d\n", len, pssl->pkt_length, pkt_size); if (pssl->pkt_length == pkt_size){ pssl->ssl->bm_index = 0; pssl->pkt_length = 0; if (psent->pcommon.cntr == 0) { psent->pespconn->state = ESPCONN_CONNECT; if (psent->pespconn->sent_callback != NULL) { psent->pespconn->sent_callback(psent->pespconn); } } else { espconn_ssl_sent(psent, psent->pcommon.ptrbuf, psent->pcommon.cntr); } } else { if (len == max_len){ espconn_sent_packet(pcb, &pssl->ssl->bm_all_data[pssl->pkt_length], pkt_size - pssl->pkt_length); } } } } else { ssl_printf("espconn_ssl_ssent %p %p %d\n",pcb, pssl->ssl->bm_all_data, len); } return ERR_OK; } /****************************************************************************** * FunctionName : espconn_sslclient_recv * Description : Data has been received on this pcb. * Parameters : arg -- Additional argument to pass to the callback function * pcb -- The connection pcb which received data * p -- The received data (or NULL when the connection has been closed!) * err -- An error code if there has been an error receiving * Returns : ERR_ABRT: if you have called tcp_abort from within the function! *******************************************************************************/ static err_t ICACHE_FLASH_ATTR espconn_ssl_srecv(void *arg, struct tcp_pcb *pcb, struct pbuf *p, err_t err) { u16_t ret = 0; espconn_msg *precv = arg; ssl_msg *pssl = precv->pssl; ssl_printf("espconn_ssl_srecv %d %p %p\n", __LINE__, pcb, p); if (p != NULL) { tcp_recved(pcb, p ->tot_len); precv->pcommon.recv_check = 0; if (pssl->ssl == NULL) { pbuf_free(p); } else { pssl->ssl->ssl_pbuf = p; if (ssl_handshake_status(pssl->ssl) != SSL_OK) { ret = ssl_read(pssl->ssl, NULL); pbuf_free(p); if (ret != SSL_OK){ os_printf("server handshake failed.\n"); espconn_ssl_sclose(arg, pcb); } } else { uint8_t *read_buf = NULL; ret = ssl_read(pssl->ssl, &read_buf); precv->pespconn->state = ESPCONN_READ; precv->pcommon.pcb = pcb; pbuf_free(p); if (precv->pespconn->recv_callback != NULL && read_buf != NULL) { precv->pespconn->recv_callback(precv->pespconn, read_buf, ret); } precv->pespconn->state = ESPCONN_CONNECT; } } } if (err == ERR_OK && p == NULL) { espconn_ssl_sclose(precv, pcb); } return ERR_OK; } /****************************************************************************** * FunctionName : espconn_server_poll * Description : The poll function is called every 3nd second. * If there has been no data sent (which resets the retries) in 3 seconds, close. * If the last portion of a file has not been sent in 3 seconds, close. * * This could be increased, but we don't want to waste resources for bad connections. * Parameters : arg -- Additional argument to pass to the callback function * pcb -- The connection pcb for which data has been acknowledged * Returns : ERR_OK: try to send some data by calling tcp_output * ERR_ABRT: if you have called tcp_abort from within the function! *******************************************************************************/ static err_t ICACHE_FLASH_ATTR espconn_ssl_spoll(void *arg, struct tcp_pcb *pcb) { ssl_printf("espconn_ssl_spoll %p %d\n", pcb, pcb->state); espconn_msg *pspoll = arg; if (arg == NULL) { tcp_abandon(pcb, 0); tcp_poll(pcb, NULL, 0); return ERR_ABRT; } if (pcb ->state == ESTABLISHED) { pspoll ->pcommon.recv_check ++; if (pspoll ->pcommon.recv_check == pspoll ->pcommon.timeout){ tcp_poll(pcb, NULL, 0); pspoll ->pcommon.recv_check = 0; espconn_ssl_sclose(arg, pcb); } } else { tcp_poll(pcb, NULL, 0); espconn_ssl_sclose(arg, pcb); } return ERR_OK; } /****************************************************************************** * FunctionName : esponn_server_err * Description : The pcb had an error and is already deallocated. * The argument might still be valid (if != NULL). * Parameters : arg -- Additional argument to pass to the callback function * err -- Error code to indicate why the pcb has been closed * Returns : none *******************************************************************************/ static void ICACHE_FLASH_ATTR espconn_ssl_serr(void *arg, err_t err) { espconn_msg *pserr = arg; struct tcp_pcb *pcb = NULL; LWIP_UNUSED_ARG(err); if (pserr != NULL) { os_timer_disarm(&pserr->pcommon.ptimer); pcb = pserr->pcommon.pcb; pserr->pespconn->state = ESPCONN_CLOSE; /*remove the node from the server's active connection list*/ espconn_list_delete(&plink_active, pserr); if (err == ERR_ABRT) { switch (pcb->state) { case SYN_RCVD: if (pcb->nrtx == TCP_SYNMAXRTX) { pserr->pcommon.err = ESPCONN_CONN; } else { pserr->pcommon.err = err; } break; case ESTABLISHED: if (pcb->nrtx == TCP_MAXRTX) { pserr->pcommon.err = ESPCONN_TIMEOUT; } else { pserr->pcommon.err = err; } break; case CLOSE_WAIT: if (pcb->nrtx == TCP_MAXRTX) { pserr->pcommon.err = ESPCONN_CLSD; } else { pserr->pcommon.err = err; } break; case LAST_ACK: pserr->pcommon.err = ESPCONN_CLSD; break; case CLOSED: pserr->pcommon.err = ESPCONN_CONN; break; default : break; } } else { pserr->pcommon.err = err; } os_timer_setfn(&pserr->pcommon.ptimer, espconn_ssl_reconnect, pserr); os_timer_arm(&pserr->pcommon.ptimer, 10, 0); } } /****************************************************************************** * FunctionName : espconn_tcp_accept * Description : A new incoming connection has been accepted. * Parameters : arg -- Additional argument to pass to the callback function * pcb -- The connection pcb which is accepted * err -- An unused error code, always ERR_OK currently * Returns : acception result *******************************************************************************/ static err_t ICACHE_FLASH_ATTR espconn_ssl_accept(void *arg, struct tcp_pcb *pcb, err_t err) { struct espconn *espconn = arg; ssl_msg *pssl = NULL; espconn_msg *paccept = NULL; remot_info *pinfo = NULL; ssl_printf("espconn_ssl_accept %p %p %p %d\n", pcb, arg, espconn->psecure, system_get_free_heap_size()); LWIP_UNUSED_ARG(err); paccept = (espconn_msg *)os_zalloc(sizeof(espconn_msg)); tcp_arg(pcb, paccept); tcp_err(pcb, espconn_ssl_serr); if (paccept == NULL) return ERR_MEM; /*insert the node to the active connection list*/ espconn_list_creat(&plink_active, paccept); paccept->preverse = espconn; paccept->pespconn = espconn; paccept->pcommon.timeout = 0x0a; paccept->pcommon.pcb = pcb; paccept->pcommon.remote_port = pcb->remote_port; paccept->pcommon.remote_ip[0] = ip4_addr1_16(&pcb->remote_ip); paccept->pcommon.remote_ip[1] = ip4_addr2_16(&pcb->remote_ip); paccept->pcommon.remote_ip[2] = ip4_addr3_16(&pcb->remote_ip); paccept->pcommon.remote_ip[3] = ip4_addr4_16(&pcb->remote_ip); os_memcpy(espconn->proto.tcp->remote_ip, paccept->pcommon.remote_ip, 4); espconn->proto.tcp->remote_port = pcb->remote_port; espconn_get_connection_info(espconn, &pinfo , ESPCONN_SSL); if (espconn->link_cnt == 0x01) return ERR_ISCONN; pssl = (ssl_msg *)os_zalloc(sizeof(ssl_msg)); paccept->pssl = pssl; if (pssl == NULL) { return ERR_MEM; } REG_SET_BIT(0x3ff00014, BIT(0)); os_update_cpu_frequency(160); os_printf("server handshake start.\n"); pssl->quiet = false; pssl->ssl_ctx = ssl_ctx_new(SSL_DISPLAY_CERTS, SSL_DEFAULT_SVR_SESS); if (pssl->ssl_ctx == NULL) { ssl_printf("Error: Server context is invalid\n"); return ERR_MEM; } ssl_printf("Server context %p\n", pssl->ssl_ctx); pssl->ssl = sslserver_new(pssl->ssl_ctx, pcb); if (pssl->ssl == NULL) { ssl_printf("Error: Server ssl connection is invalid\n"); return ERR_MEM; } tcp_sent(pcb, espconn_ssl_ssent); tcp_recv(pcb, espconn_ssl_srecv); tcp_poll(pcb, espconn_ssl_spoll, 2); return ERR_OK; } /****************************************************************************** * FunctionName : espconn_ssl_server * Description : as * Parameters : * Returns : *******************************************************************************/ sint8 ICACHE_FLASH_ATTR espconn_ssl_server(struct espconn *espconn) { struct tcp_pcb *pcb; pcb = tcp_new(); if (pcb == NULL) { espconn ->state = ESPCONN_NONE; return ESPCONN_MEM; } else { tcp_bind(pcb, IP_ADDR_ANY, espconn->proto.tcp->local_port); pcb = tcp_listen(pcb); if (pcb != NULL) { espconn ->state = ESPCONN_LISTEN; tcp_arg(pcb, (void *)espconn); tcp_accept(pcb, espconn_ssl_accept); return ESPCONN_OK; } else { espconn ->state = ESPCONN_NONE; return ESPCONN_MEM; } } } ================================================ FILE: app/ssl/crypto/Makefile ================================================ ############################################################# # Required variables for each makefile # Discard this section from all parent makefiles # Expected variables (with automatic defaults): # CSRCS (all "C" files in the dir) # SUBDIRS (all subdirs with a Makefile) # GEN_LIBS - list of libs to be generated () # GEN_IMAGES - list of images to be generated () # COMPONENTS_xxx - a list of libs/objs in the form # subdir/lib to be extracted and rolled up into # a generated lib/image xxx.a () # ifndef PDIR GEN_LIBS = libsslcrypto.a endif ############################################################# # Configuration i.e. compile options etc. # Target specific stuff (defines etc.) goes in here! # Generally values applying to a tree are captured in the # makefile at its root level - these are then overridden # for a subtree within the makefile rooted therein # #DEFINES += ############################################################# # Recursion Magic - Don't touch this!! # # Each subtree potentially has an include directory # corresponding to the common APIs applicable to modules # rooted at that subtree. Accordingly, the INCLUDE PATH # of a module can only contain the include directories up # its parent path, and not its siblings # # Required for each makefile to inherit from the parent # INCLUDES := $(INCLUDES) -I $(PDIR)include INCLUDES += -I ./ PDIR := ../$(PDIR) sinclude $(PDIR)Makefile ================================================ FILE: app/ssl/crypto/ssl_aes.c ================================================ /* * Copyright (c) 2007, Cameron Rich * * 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 axTLS project 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. */ /** * AES implementation - this is a small code version. There are much faster * versions around but they are much larger in size (i.e. they use large * submix tables). */ //#include #include "lwip/opt.h" #include "lwip/def.h" #include "ssl/ssl_os_port.h" #include "ssl/ssl_crypto.h" /* all commented out in skeleton mode */ #ifndef CONFIG_SSL_SKELETON_MODE #define rot1(x) (((x) << 24) | ((x) >> 8)) #define rot2(x) (((x) << 16) | ((x) >> 16)) #define rot3(x) (((x) << 8) | ((x) >> 24)) /* * This cute trick does 4 'mul by two' at once. Stolen from * Dr B. R. Gladman but I'm sure the u-(u>>7) is * a standard graphics trick * The key to this is that we need to xor with 0x1b if the top bit is set. * a 1xxx xxxx 0xxx 0xxx First we mask the 7bit, * b 1000 0000 0000 0000 then we shift right by 7 putting the 7bit in 0bit, * c 0000 0001 0000 0000 we then subtract (c) from (b) * d 0111 1111 0000 0000 and now we and with our mask * e 0001 1011 0000 0000 */ #define mt 0x80808080 #define ml 0x7f7f7f7f #define mh 0xfefefefe #define mm 0x1b1b1b1b #define mul2(x,t) ((t)=((x)&mt), \ ((((x)+(x))&mh)^(((t)-((t)>>7))&mm))) #define inv_mix_col(x,f2,f4,f8,f9) (\ (f2)=mul2(x,f2), \ (f4)=mul2(f2,f4), \ (f8)=mul2(f4,f8), \ (f9)=(x)^(f8), \ (f8)=((f2)^(f4)^(f8)), \ (f2)^=(f9), \ (f4)^=(f9), \ (f8)^=rot3(f2), \ (f8)^=rot2(f4), \ (f8)^rot1(f9)) /* * AES S-box */ static const uint8_t aes_sbox[256] ICACHE_STORE_ATTR ICACHE_RODATA_ATTR = { 0x63,0x7C,0x77,0x7B,0xF2,0x6B,0x6F,0xC5, 0x30,0x01,0x67,0x2B,0xFE,0xD7,0xAB,0x76, 0xCA,0x82,0xC9,0x7D,0xFA,0x59,0x47,0xF0, 0xAD,0xD4,0xA2,0xAF,0x9C,0xA4,0x72,0xC0, 0xB7,0xFD,0x93,0x26,0x36,0x3F,0xF7,0xCC, 0x34,0xA5,0xE5,0xF1,0x71,0xD8,0x31,0x15, 0x04,0xC7,0x23,0xC3,0x18,0x96,0x05,0x9A, 0x07,0x12,0x80,0xE2,0xEB,0x27,0xB2,0x75, 0x09,0x83,0x2C,0x1A,0x1B,0x6E,0x5A,0xA0, 0x52,0x3B,0xD6,0xB3,0x29,0xE3,0x2F,0x84, 0x53,0xD1,0x00,0xED,0x20,0xFC,0xB1,0x5B, 0x6A,0xCB,0xBE,0x39,0x4A,0x4C,0x58,0xCF, 0xD0,0xEF,0xAA,0xFB,0x43,0x4D,0x33,0x85, 0x45,0xF9,0x02,0x7F,0x50,0x3C,0x9F,0xA8, 0x51,0xA3,0x40,0x8F,0x92,0x9D,0x38,0xF5, 0xBC,0xB6,0xDA,0x21,0x10,0xFF,0xF3,0xD2, 0xCD,0x0C,0x13,0xEC,0x5F,0x97,0x44,0x17, 0xC4,0xA7,0x7E,0x3D,0x64,0x5D,0x19,0x73, 0x60,0x81,0x4F,0xDC,0x22,0x2A,0x90,0x88, 0x46,0xEE,0xB8,0x14,0xDE,0x5E,0x0B,0xDB, 0xE0,0x32,0x3A,0x0A,0x49,0x06,0x24,0x5C, 0xC2,0xD3,0xAC,0x62,0x91,0x95,0xE4,0x79, 0xE7,0xC8,0x37,0x6D,0x8D,0xD5,0x4E,0xA9, 0x6C,0x56,0xF4,0xEA,0x65,0x7A,0xAE,0x08, 0xBA,0x78,0x25,0x2E,0x1C,0xA6,0xB4,0xC6, 0xE8,0xDD,0x74,0x1F,0x4B,0xBD,0x8B,0x8A, 0x70,0x3E,0xB5,0x66,0x48,0x03,0xF6,0x0E, 0x61,0x35,0x57,0xB9,0x86,0xC1,0x1D,0x9E, 0xE1,0xF8,0x98,0x11,0x69,0xD9,0x8E,0x94, 0x9B,0x1E,0x87,0xE9,0xCE,0x55,0x28,0xDF, 0x8C,0xA1,0x89,0x0D,0xBF,0xE6,0x42,0x68, 0x41,0x99,0x2D,0x0F,0xB0,0x54,0xBB,0x16, }; /* * AES is-box */ static const uint8_t aes_isbox[256] ICACHE_STORE_ATTR ICACHE_RODATA_ATTR = { 0x52,0x09,0x6a,0xd5,0x30,0x36,0xa5,0x38, 0xbf,0x40,0xa3,0x9e,0x81,0xf3,0xd7,0xfb, 0x7c,0xe3,0x39,0x82,0x9b,0x2f,0xff,0x87, 0x34,0x8e,0x43,0x44,0xc4,0xde,0xe9,0xcb, 0x54,0x7b,0x94,0x32,0xa6,0xc2,0x23,0x3d, 0xee,0x4c,0x95,0x0b,0x42,0xfa,0xc3,0x4e, 0x08,0x2e,0xa1,0x66,0x28,0xd9,0x24,0xb2, 0x76,0x5b,0xa2,0x49,0x6d,0x8b,0xd1,0x25, 0x72,0xf8,0xf6,0x64,0x86,0x68,0x98,0x16, 0xd4,0xa4,0x5c,0xcc,0x5d,0x65,0xb6,0x92, 0x6c,0x70,0x48,0x50,0xfd,0xed,0xb9,0xda, 0x5e,0x15,0x46,0x57,0xa7,0x8d,0x9d,0x84, 0x90,0xd8,0xab,0x00,0x8c,0xbc,0xd3,0x0a, 0xf7,0xe4,0x58,0x05,0xb8,0xb3,0x45,0x06, 0xd0,0x2c,0x1e,0x8f,0xca,0x3f,0x0f,0x02, 0xc1,0xaf,0xbd,0x03,0x01,0x13,0x8a,0x6b, 0x3a,0x91,0x11,0x41,0x4f,0x67,0xdc,0xea, 0x97,0xf2,0xcf,0xce,0xf0,0xb4,0xe6,0x73, 0x96,0xac,0x74,0x22,0xe7,0xad,0x35,0x85, 0xe2,0xf9,0x37,0xe8,0x1c,0x75,0xdf,0x6e, 0x47,0xf1,0x1a,0x71,0x1d,0x29,0xc5,0x89, 0x6f,0xb7,0x62,0x0e,0xaa,0x18,0xbe,0x1b, 0xfc,0x56,0x3e,0x4b,0xc6,0xd2,0x79,0x20, 0x9a,0xdb,0xc0,0xfe,0x78,0xcd,0x5a,0xf4, 0x1f,0xdd,0xa8,0x33,0x88,0x07,0xc7,0x31, 0xb1,0x12,0x10,0x59,0x27,0x80,0xec,0x5f, 0x60,0x51,0x7f,0xa9,0x19,0xb5,0x4a,0x0d, 0x2d,0xe5,0x7a,0x9f,0x93,0xc9,0x9c,0xef, 0xa0,0xe0,0x3b,0x4d,0xae,0x2a,0xf5,0xb0, 0xc8,0xeb,0xbb,0x3c,0x83,0x53,0x99,0x61, 0x17,0x2b,0x04,0x7e,0xba,0x77,0xd6,0x26, 0xe1,0x69,0x14,0x63,0x55,0x21,0x0c,0x7d }; static const unsigned char Rcon[30]= { 0x01,0x02,0x04,0x08,0x10,0x20,0x40,0x80, 0x1b,0x36,0x6c,0xd8,0xab,0x4d,0x9a,0x2f, 0x5e,0xbc,0x63,0xc6,0x97,0x35,0x6a,0xd4, 0xb3,0x7d,0xfa,0xef,0xc5,0x91, }; /* ----- static functions ----- */ static void AES_encrypt(const AES_CTX *ctx, uint32_t *data); static void AES_decrypt(const AES_CTX *ctx, uint32_t *data); /* Perform doubling in Galois Field GF(2^8) using the irreducible polynomial x^8+x^4+x^3+x+1 */ static unsigned char ICACHE_FLASH_ATTR AES_xtime(uint32_t x) { return (x&0x80) ? (x<<1)^0x1b : x<<1; } /** * Set up AES with the key/iv and cipher size. */ void ICACHE_FLASH_ATTR AES_set_key(AES_CTX *ctx, const uint8_t *key, const uint8_t *iv, AES_MODE mode) { int i, ii; uint32_t *W, tmp, tmp2; const unsigned char *ip; int words; switch (mode) { case AES_MODE_128: i = 10; words = 4; break; case AES_MODE_256: i = 14; words = 8; break; default: /* fail silently */ return; } ctx->rounds = i; ctx->key_size = words; W = ctx->ks; for (i = 0; i < words; i+=2) { W[i+0]= ((uint32_t)key[ 0]<<24)| ((uint32_t)key[ 1]<<16)| ((uint32_t)key[ 2]<< 8)| ((uint32_t)key[ 3] ); W[i+1]= ((uint32_t)key[ 4]<<24)| ((uint32_t)key[ 5]<<16)| ((uint32_t)key[ 6]<< 8)| ((uint32_t)key[ 7] ); key += 8; } ip = Rcon; ii = 4 * (ctx->rounds+1); for (i = words; i> 8)&0xff]<<16; // tmp2|=(uint32_t)aes_sbox[(tmp>>16)&0xff]<<24; // tmp2|=(uint32_t)aes_sbox[(tmp>>24) ]; tmp2 =((uint32_t)byte_of_aligned_array(aes_sbox,(tmp )&0xff))<< 8; tmp2|=((uint32_t)byte_of_aligned_array(aes_sbox,(tmp>> 8)&0xff))<<16; tmp2|=((uint32_t)byte_of_aligned_array(aes_sbox,(tmp>>16)&0xff))<<24; tmp2|=((uint32_t)byte_of_aligned_array(aes_sbox,(tmp>>24) )); tmp=tmp2^(((unsigned int)*ip)<<24); ip++; } if ((words == 8) && ((i % words) == 4)) { // tmp2 =(uint32_t)aes_sbox[(tmp )&0xff] ; // tmp2|=(uint32_t)aes_sbox[(tmp>> 8)&0xff]<< 8; // tmp2|=(uint32_t)aes_sbox[(tmp>>16)&0xff]<<16; // tmp2|=(uint32_t)aes_sbox[(tmp>>24) ]<<24; tmp2 =((uint32_t)byte_of_aligned_array(aes_sbox,(tmp )&0xff)) ; tmp2|=((uint32_t)byte_of_aligned_array(aes_sbox,(tmp>> 8)&0xff))<< 8; tmp2|=((uint32_t)byte_of_aligned_array(aes_sbox,(tmp>>16)&0xff))<<16; tmp2|=((uint32_t)byte_of_aligned_array(aes_sbox,(tmp>>24) ))<<24; tmp=tmp2; } W[i]=W[i-words]^tmp; } /* copy the iv across */ os_memcpy(ctx->iv, iv, 16); } /** * Change a key for decryption. */ void ICACHE_FLASH_ATTR AES_convert_key(AES_CTX *ctx) { int i; uint32_t *k,w,t1,t2,t3,t4; k = ctx->ks; k += 4; for (i= ctx->rounds*4; i > 4; i--) { w= *k; w = inv_mix_col(w,t1,t2,t3,t4); *k++ =w; } } /** * Encrypt a byte sequence (with a block size 16) using the AES cipher. */ void ICACHE_FLASH_ATTR AES_cbc_encrypt(AES_CTX *ctx, const uint8_t *msg, uint8_t *out, int length) { int i; uint32_t tin[4], tout[4], iv[4]; os_memcpy(iv, ctx->iv, AES_IV_SIZE); for (i = 0; i < 4; i++) tout[i] = ntohl(iv[i]); for (length -= AES_BLOCKSIZE; length >= 0; length -= AES_BLOCKSIZE) { uint32_t msg_32[4]; uint32_t out_32[4]; os_memcpy(msg_32, msg, AES_BLOCKSIZE); msg += AES_BLOCKSIZE; for (i = 0; i < 4; i++) tin[i] = ntohl(msg_32[i])^tout[i]; AES_encrypt(ctx, tin); for (i = 0; i < 4; i++) { tout[i] = tin[i]; out_32[i] = htonl(tout[i]); } os_memcpy(out, out_32, AES_BLOCKSIZE); out += AES_BLOCKSIZE; } for (i = 0; i < 4; i++) iv[i] = htonl(tout[i]); os_memcpy(ctx->iv, iv, AES_IV_SIZE); } /** * Decrypt a byte sequence (with a block size 16) using the AES cipher. */ void ICACHE_FLASH_ATTR AES_cbc_decrypt(AES_CTX *ctx, const uint8_t *msg, uint8_t *out, int length) { int i; uint32_t tin[4], xor[4], tout[4], data[4], iv[4]; os_memcpy(iv, ctx->iv, AES_IV_SIZE); for (i = 0; i < 4; i++) xor[i] = ntohl(iv[i]); for (length -= 16; length >= 0; length -= 16) { uint32_t msg_32[4]; uint32_t out_32[4]; os_memcpy(msg_32, msg, AES_BLOCKSIZE); msg += AES_BLOCKSIZE; for (i = 0; i < 4; i++) { tin[i] = ntohl(msg_32[i]); data[i] = tin[i]; } AES_decrypt(ctx, data); for (i = 0; i < 4; i++) { tout[i] = data[i]^xor[i]; xor[i] = tin[i]; out_32[i] = htonl(tout[i]); } os_memcpy(out, out_32, AES_BLOCKSIZE); out += AES_BLOCKSIZE; } for (i = 0; i < 4; i++) iv[i] = htonl(xor[i]); os_memcpy(ctx->iv, iv, AES_IV_SIZE); } /** * Encrypt a single block (16 bytes) of data */ static void ICACHE_FLASH_ATTR AES_encrypt(const AES_CTX *ctx, uint32_t *data) { /* To make this code smaller, generate the sbox entries on the fly. * This will have a really heavy effect upon performance. */ uint32_t tmp[4]; uint32_t tmp1, old_a0, a0, a1, a2, a3, row; int curr_rnd; int rounds = ctx->rounds; const uint32_t *k = ctx->ks; /* Pre-round key addition */ for (row = 0; row < 4; row++) data[row] ^= *(k++); /* Encrypt one block. */ for (curr_rnd = 0; curr_rnd < rounds; curr_rnd++) { /* Perform ByteSub and ShiftRow operations together */ for (row = 0; row < 4; row++) { // a0 = (uint32_t)aes_sbox[(data[row%4]>>24)&0xFF]; // a1 = (uint32_t)aes_sbox[(data[(row+1)%4]>>16)&0xFF]; // a2 = (uint32_t)aes_sbox[(data[(row+2)%4]>>8)&0xFF]; // a3 = (uint32_t)aes_sbox[(data[(row+3)%4])&0xFF]; a0 = (uint32_t)(byte_of_aligned_array(aes_sbox,(data[row%4]>>24)&0xFF)); a1 = (uint32_t)(byte_of_aligned_array(aes_sbox,(data[(row+1)%4]>>16)&0xFF)); a2 = (uint32_t)(byte_of_aligned_array(aes_sbox,(data[(row+2)%4]>>8)&0xFF)); a3 = (uint32_t)(byte_of_aligned_array(aes_sbox,(data[(row+3)%4])&0xFF)); /* Perform MixColumn iff not last round */ if (curr_rnd < (rounds - 1)) { tmp1 = a0 ^ a1 ^ a2 ^ a3; old_a0 = a0; a0 ^= tmp1 ^ AES_xtime(a0 ^ a1); a1 ^= tmp1 ^ AES_xtime(a1 ^ a2); a2 ^= tmp1 ^ AES_xtime(a2 ^ a3); a3 ^= tmp1 ^ AES_xtime(a3 ^ old_a0); } tmp[row] = ((a0 << 24) | (a1 << 16) | (a2 << 8) | a3); } /* KeyAddition - note that it is vital that this loop is separate from the MixColumn operation, which must be atomic...*/ for (row = 0; row < 4; row++) data[row] = tmp[row] ^ *(k++); } } /** * Decrypt a single block (16 bytes) of data */ static void ICACHE_FLASH_ATTR AES_decrypt(const AES_CTX *ctx, uint32_t *data) { uint32_t tmp[4]; uint32_t xt0,xt1,xt2,xt3,xt4,xt5,xt6; uint32_t a0, a1, a2, a3, row; int curr_rnd; int rounds = ctx->rounds; const uint32_t *k = ctx->ks + ((rounds+1)*4); /* pre-round key addition */ for (row=4; row > 0;row--) data[row-1] ^= *(--k); /* Decrypt one block */ for (curr_rnd = 0; curr_rnd < rounds; curr_rnd++) { /* Perform ByteSub and ShiftRow operations together */ for (row = 4; row > 0; row--) { // a0 = aes_isbox[(data[(row+3)%4]>>24)&0xFF]; // a1 = aes_isbox[(data[(row+2)%4]>>16)&0xFF]; // a2 = aes_isbox[(data[(row+1)%4]>>8)&0xFF]; // a3 = aes_isbox[(data[row%4])&0xFF]; a0 = byte_of_aligned_array(aes_isbox,(data[(row+3)%4]>>24)&0xFF); a1 = byte_of_aligned_array(aes_isbox,(data[(row+2)%4]>>16)&0xFF); a2 = byte_of_aligned_array(aes_isbox,(data[(row+1)%4]>>8)&0xFF); a3 = byte_of_aligned_array(aes_isbox,(data[row%4])&0xFF); /* Perform MixColumn iff not last round */ if (curr_rnd<(rounds-1)) { /* The MDS cofefficients (0x09, 0x0B, 0x0D, 0x0E) are quite large compared to encryption; this operation slows decryption down noticeably. */ xt0 = AES_xtime(a0^a1); xt1 = AES_xtime(a1^a2); xt2 = AES_xtime(a2^a3); xt3 = AES_xtime(a3^a0); xt4 = AES_xtime(xt0^xt1); xt5 = AES_xtime(xt1^xt2); xt6 = AES_xtime(xt4^xt5); xt0 ^= a1^a2^a3^xt4^xt6; xt1 ^= a0^a2^a3^xt5^xt6; xt2 ^= a0^a1^a3^xt4^xt6; xt3 ^= a0^a1^a2^xt5^xt6; tmp[row-1] = ((xt0<<24)|(xt1<<16)|(xt2<<8)|xt3); } else tmp[row-1] = ((a0<<24)|(a1<<16)|(a2<<8)|a3); } for (row = 4; row > 0; row--) data[row-1] = tmp[row-1] ^ *(--k); } } #endif ================================================ FILE: app/ssl/crypto/ssl_bigint.c ================================================ /* * Copyright (c) 2007, Cameron Rich * * 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 axTLS project 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. */ /** * @defgroup bigint_api Big Integer API * @brief The bigint implementation as used by the axTLS project. * * The bigint library is for RSA encryption/decryption as well as signing. * This code tries to minimise use of malloc/free by maintaining a small * cache. A bigint context may maintain state by being made "permanent". * It be be later released with a bi_depermanent() and bi_free() call. * * It supports the following reduction techniques: * - Classical * - Barrett * - Montgomery * * It also implements the following: * - Karatsuba multiplication * - Squaring * - Sliding window exponentiation * - Chinese Remainder Theorem (implemented in rsa.c). * * All the algorithms used are pretty standard, and designed for different * data bus sizes. Negative numbers are not dealt with at all, so a subtraction * may need to be tested for negativity. * * This library steals some ideas from Jef Poskanzer * * and GMP . It gets most of its implementation * detail from "The Handbook of Applied Cryptography" * * @{ */ //#include //#include //#include //#include //#include #include "ssl/ssl_os_port.h" #include "ssl/ssl_bigint.h" //#include "os.h" #include "lwip/mem.h" #define V1 v->comps[v->size-1] /**< v1 for division */ #define V2 v->comps[v->size-2] /**< v2 for division */ #define U(j) tmp_u->comps[tmp_u->size-j-1] /**< uj for division */ #define Q(j) quotient->comps[quotient->size-j-1] /**< qj for division */ static bigint *bi_int_multiply(BI_CTX *ctx, bigint *bi, comp i); static bigint *bi_int_divide(BI_CTX *ctx, bigint *biR, comp denom); static bigint *alloc(BI_CTX *ctx, int size); static bigint *trim(bigint *bi); static void more_comps(bigint *bi, int n); #if defined(CONFIG_BIGINT_KARATSUBA) || defined(CONFIG_BIGINT_BARRETT) || \ defined(CONFIG_BIGINT_MONTGOMERY) static bigint *comp_right_shift(bigint *biR, int num_shifts); static bigint *comp_left_shift(bigint *biR, int num_shifts); #endif #ifdef CONFIG_BIGINT_CHECK_ON static void check(const bigint *bi); #else #define check(A) /**< disappears in normal production mode */ #endif /** * @brief Start a new bigint context. * @return A bigint context. */ BI_CTX * ICACHE_FLASH_ATTR bi_initialize(void) { /* calloc() sets everything to zero */ BI_CTX *ctx = (BI_CTX *)os_zalloc(sizeof(BI_CTX)); /* the radix */ ctx->bi_radix = alloc(ctx, 2); ctx->bi_radix->comps[0] = 0; ctx->bi_radix->comps[1] = 1; bi_permanent(ctx->bi_radix); return ctx; } /** * @brief Close the bigint context and free any resources. * * Free up any used memory - a check is done if all objects were not * properly freed. * @param ctx [in] The bigint session context. */ void ICACHE_FLASH_ATTR bi_terminate(BI_CTX *ctx) { bi_depermanent(ctx->bi_radix); bi_free(ctx, ctx->bi_radix); if (ctx->active_count != 0) { #ifdef CONFIG_SSL_FULL_MODE ssl_printf("bi_terminate: there were %d un-freed bigints\n", ctx->active_count); #endif return; /* wujg : org ---> abort(); */ } bi_clear_cache(ctx); os_free(ctx); } /** *@brief Clear the memory cache. */ void ICACHE_FLASH_ATTR bi_clear_cache(BI_CTX *ctx) { bigint *p, *pn; if (ctx->free_list == NULL) return; for (p = ctx->free_list; p != NULL; p = pn) { pn = p->next; os_free(p->comps); os_free(p); } ctx->free_count = 0; ctx->free_list = NULL; } /** * @brief Increment the number of references to this object. * It does not do a full copy. * @param bi [in] The bigint to copy. * @return A reference to the same bigint. */ bigint * ICACHE_FLASH_ATTR bi_copy(bigint *bi) { check(bi); if (bi->refs != PERMANENT) bi->refs++; return bi; } /** * @brief Simply make a bigint object "unfreeable" if bi_free() is called on it. * * For this object to be freed, bi_depermanent() must be called. * @param bi [in] The bigint to be made permanent. */ void ICACHE_FLASH_ATTR bi_permanent(bigint *bi) { check(bi); if (bi->refs != 1) { #ifdef CONFIG_SSL_FULL_MODE ssl_printf("bi_permanent: refs was not 1\n"); #endif return; /* wujg : org ----> abort(); */ } bi->refs = PERMANENT; } /** * @brief Take a permanent object and make it eligible for freedom. * @param bi [in] The bigint to be made back to temporary. */ void ICACHE_FLASH_ATTR bi_depermanent(bigint *bi) { check(bi); if (bi->refs != PERMANENT) { #ifdef CONFIG_SSL_FULL_MODE ssl_printf("bi_depermanent: bigint was not permanent\n"); #endif return; /* wujg : org ----> abort(); */ } bi->refs = 1; } /** * @brief Free a bigint object so it can be used again. * * The memory itself it not actually freed, just tagged as being available * @param ctx [in] The bigint session context. * @param bi [in] The bigint to be freed. */ void ICACHE_FLASH_ATTR bi_free(BI_CTX *ctx, bigint *bi) { check(bi); if (bi->refs == PERMANENT) { return; } if (--bi->refs > 0) { return; } bi->next = ctx->free_list; ctx->free_list = bi; ctx->free_count++; if (--ctx->active_count < 0) { #ifdef CONFIG_SSL_FULL_MODE ssl_printf("bi_free: active_count went negative " "- double-freed bigint?\n"); #endif return; /* wujg : org ----> abort(); */ } } /** * @brief Convert an (unsigned) integer into a bigint. * @param ctx [in] The bigint session context. * @param i [in] The (unsigned) integer to be converted. * */ bigint * ICACHE_FLASH_ATTR int_to_bi(BI_CTX *ctx, comp i) { bigint *biR = alloc(ctx, 1); biR->comps[0] = i; return biR; } /** * @brief Do a full copy of the bigint object. * @param ctx [in] The bigint session context. * @param bi [in] The bigint object to be copied. */ bigint * ICACHE_FLASH_ATTR bi_clone(BI_CTX *ctx, const bigint *bi) { bigint *biR = alloc(ctx, bi->size); check(bi); os_memcpy(biR->comps, bi->comps, bi->size*COMP_BYTE_SIZE); return biR; } /** * @brief Perform an addition operation between two bigints. * @param ctx [in] The bigint session context. * @param bia [in] A bigint. * @param bib [in] Another bigint. * @return The result of the addition. */ bigint * ICACHE_FLASH_ATTR bi_add(BI_CTX *ctx, bigint *bia, bigint *bib) { int n; comp carry = 0; comp *pa, *pb; check(bia); check(bib); n = max(bia->size, bib->size); more_comps(bia, n+1); more_comps(bib, n); pa = bia->comps; pb = bib->comps; do { comp sl, rl, cy1; sl = *pa + *pb++; rl = sl + carry; cy1 = sl < *pa; carry = cy1 | (rl < sl); *pa++ = rl; } while (--n != 0); *pa = carry; /* do overflow */ bi_free(ctx, bib); return trim(bia); } /** * @brief Perform a subtraction operation between two bigints. * @param ctx [in] The bigint session context. * @param bia [in] A bigint. * @param bib [in] Another bigint. * @param is_negative [out] If defined, indicates that the result was negative. * is_negative may be null. * @return The result of the subtraction. The result is always positive. */ bigint * ICACHE_FLASH_ATTR bi_subtract(BI_CTX *ctx, bigint *bia, bigint *bib, int *is_negative) { int n = bia->size; comp *pa, *pb, carry = 0; check(bia); check(bib); more_comps(bib, n); pa = bia->comps; pb = bib->comps; do { comp sl, rl, cy1; sl = *pa - *pb++; rl = sl - carry; cy1 = sl > *pa; carry = cy1 | (rl > sl); *pa++ = rl; } while (--n != 0); if (is_negative) /* indicate a negative result */ { *is_negative = carry; } bi_free(ctx, trim(bib)); /* put bib back to the way it was */ return trim(bia); } /** * Perform a multiply between a bigint an an (unsigned) integer */ static bigint * ICACHE_FLASH_ATTR bi_int_multiply(BI_CTX *ctx, bigint *bia, comp b) { int j = 0, n = bia->size; bigint *biR = alloc(ctx, n + 1); comp carry = 0; comp *r = biR->comps; comp *a = bia->comps; check(bia); /* clear things to start with */ os_memset(r, 0, ((n+1)*COMP_BYTE_SIZE)); do { long_comp tmp = *r + (long_comp)a[j]*b + carry; *r++ = (comp)tmp; /* downsize */ carry = (comp)(tmp >> COMP_BIT_SIZE); } while (++j < n); *r = carry; bi_free(ctx, bia); return trim(biR); } /** * @brief Does both division and modulo calculations. * * Used extensively when doing classical reduction. * @param ctx [in] The bigint session context. * @param u [in] A bigint which is the numerator. * @param v [in] Either the denominator or the modulus depending on the mode. * @param is_mod [n] Determines if this is a normal division (0) or a reduction * (1). * @return The result of the division/reduction. */ bigint * ICACHE_FLASH_ATTR bi_divide(BI_CTX *ctx, bigint *u, bigint *v, int is_mod) { int n = v->size, m = u->size-n; int j = 0, orig_u_size = u->size; uint8_t mod_offset = ctx->mod_offset; comp d; bigint *quotient, *tmp_u; comp q_dash; check(u); check(v); /* if doing reduction and we are < mod, then return mod */ if (is_mod && bi_compare(v, u) > 0) { bi_free(ctx, v); return u; } quotient = alloc(ctx, m+1); tmp_u = alloc(ctx, n+1); v = trim(v); /* make sure we have no leading 0's */ d = (comp)((long_comp)COMP_RADIX/(V1+1)); /* clear things to start with */ os_memset(quotient->comps, 0, ((quotient->size)*COMP_BYTE_SIZE)); /* normalise */ if (d > 1) { u = bi_int_multiply(ctx, u, d); if (is_mod) { v = ctx->bi_normalised_mod[mod_offset]; } else { v = bi_int_multiply(ctx, v, d); } } if (orig_u_size == u->size) /* new digit position u0 */ { more_comps(u, orig_u_size + 1); } do { /* get a temporary short version of u */ os_memcpy(tmp_u->comps, &u->comps[u->size-n-1-j], (n+1)*COMP_BYTE_SIZE); /* calculate q' */ if (U(0) == V1) { q_dash = COMP_RADIX-1; } else { q_dash = (comp)(((long_comp)U(0)*COMP_RADIX + U(1))/V1); if (v->size > 1 && V2) { /* we are implementing the following: if (V2*q_dash > (((U(0)*COMP_RADIX + U(1) - q_dash*V1)*COMP_RADIX) + U(2))) ... */ comp inner = (comp)((long_comp)COMP_RADIX*U(0) + U(1) - (long_comp)q_dash*V1); if ((long_comp)V2*q_dash > (long_comp)inner*COMP_RADIX + U(2)) { q_dash--; } } } /* multiply and subtract */ if (q_dash) { int is_negative; tmp_u = bi_subtract(ctx, tmp_u, bi_int_multiply(ctx, bi_copy(v), q_dash), &is_negative); more_comps(tmp_u, n+1); Q(j) = q_dash; /* add back */ if (is_negative) { Q(j)--; tmp_u = bi_add(ctx, tmp_u, bi_copy(v)); /* lop off the carry */ tmp_u->size--; v->size--; } } else { Q(j) = 0; } /* copy back to u */ os_memcpy(&u->comps[u->size-n-1-j], tmp_u->comps, (n+1)*COMP_BYTE_SIZE); } while (++j <= m); bi_free(ctx, tmp_u); bi_free(ctx, v); if (is_mod) /* get the remainder */ { bi_free(ctx, quotient); return bi_int_divide(ctx, trim(u), d); } else /* get the quotient */ { bi_free(ctx, u); return trim(quotient); } } /* * Perform an integer divide on a bigint. */ static bigint * ICACHE_FLASH_ATTR bi_int_divide(BI_CTX *ctx, bigint *biR, comp denom) { int i = biR->size - 1; long_comp r = 0; check(biR); do { r = (r<comps[i]; biR->comps[i] = (comp)(r / denom); r %= denom; } while (--i >= 0); return trim(biR); } #ifdef CONFIG_BIGINT_MONTGOMERY /** * There is a need for the value of integer N' such that B^-1(B-1)-N^-1N'=1, * where B^-1(B-1) mod N=1. Actually, only the least significant part of * N' is needed, hence the definition N0'=N' mod b. We reproduce below the * simple algorithm from an article by Dusse and Kaliski to efficiently * find N0' from N0 and b */ static comp ICACHE_FLASH_ATTR modular_inverse(bigint *bim) { int i; comp t = 1; comp two_2_i_minus_1 = 2; /* 2^(i-1) */ long_comp two_2_i = 4; /* 2^i */ comp N = bim->comps[0]; for (i = 2; i <= COMP_BIT_SIZE; i++) { if ((long_comp)N*t%two_2_i >= two_2_i_minus_1) { t += two_2_i_minus_1; } two_2_i_minus_1 <<= 1; two_2_i <<= 1; } return (comp)(COMP_RADIX-t); } #endif #if defined(CONFIG_BIGINT_KARATSUBA) || defined(CONFIG_BIGINT_BARRETT) || \ defined(CONFIG_BIGINT_MONTGOMERY) /** * Take each component and shift down (in terms of components) */ static bigint * ICACHE_FLASH_ATTR comp_right_shift(bigint *biR, int num_shifts) { int i = biR->size-num_shifts; comp *x = biR->comps; comp *y = &biR->comps[num_shifts]; check(biR); if (i <= 0) /* have we completely right shifted? */ { biR->comps[0] = 0; /* return 0 */ biR->size = 1; return biR; } do { *x++ = *y++; } while (--i > 0); biR->size -= num_shifts; return biR; } /** * Take each component and shift it up (in terms of components) */ static bigint * ICACHE_FLASH_ATTR comp_left_shift(bigint *biR, int num_shifts) { int i = biR->size-1; comp *x, *y; check(biR); if (num_shifts <= 0) { return biR; } more_comps(biR, biR->size + num_shifts); x = &biR->comps[i+num_shifts]; y = &biR->comps[i]; do { *x-- = *y--; } while (i--); os_memset(biR->comps, 0, num_shifts*COMP_BYTE_SIZE); /* zero LS comps */ return biR; } #endif /** * @brief Allow a binary sequence to be imported as a bigint. * @param ctx [in] The bigint session context. * @param data [in] The data to be converted. * @param size [in] The number of bytes of data. * @return A bigint representing this data. */ bigint * ICACHE_FLASH_ATTR bi_import(BI_CTX *ctx, const uint8_t *data, int size) { bigint *biR = alloc(ctx, (size+COMP_BYTE_SIZE-1)/COMP_BYTE_SIZE); int i, j = 0, offset = 0; os_memset(biR->comps, 0, biR->size*COMP_BYTE_SIZE); for (i = size-1; i >= 0; i--) { biR->comps[offset] += data[i] << (j*8); if (++j == COMP_BYTE_SIZE) { j = 0; offset ++; } } return trim(biR); } #ifdef CONFIG_SSL_FULL_MODE /** * @brief The testharness uses this code to import text hex-streams and * convert them into bigints. * @param ctx [in] The bigint session context. * @param data [in] A string consisting of hex characters. The characters must * be in upper case. * @return A bigint representing this data. */ bigint * ICACHE_FLASH_ATTR bi_str_import(BI_CTX *ctx, const char *data) { int size = os_strlen(data); bigint *biR = alloc(ctx, (size+COMP_NUM_NIBBLES-1)/COMP_NUM_NIBBLES); int i, j = 0, offset = 0; os_memset(biR->comps, 0, biR->size*COMP_BYTE_SIZE); for (i = size-1; i >= 0; i--) { int num = (data[i] <= '9') ? (data[i] - '0') : (data[i] - 'A' + 10); biR->comps[offset] += num << (j*4); if (++j == COMP_NUM_NIBBLES) { j = 0; offset ++; } } return biR; } void ICACHE_FLASH_ATTR bi_print(const char *label, bigint *x) { int i, j; if (x == NULL) { ssl_printf("%s: (null)\n", label); return; } ssl_printf("%s: (size %d)\n", label, x->size); for (i = x->size-1; i >= 0; i--) { for (j = COMP_NUM_NIBBLES-1; j >= 0; j--) { comp mask = 0x0f << (j*4); comp num = (x->comps[i] & mask) >> (j*4); os_putc((num <= 9) ? (num + '0') : (num + 'A' - 10)); } } ssl_printf("\n"); } #endif /** * @brief Take a bigint and convert it into a byte sequence. * * This is useful after a decrypt operation. * @param ctx [in] The bigint session context. * @param x [in] The bigint to be converted. * @param data [out] The converted data as a byte stream. * @param size [in] The maximum size of the byte stream. Unused bytes will be * zeroed. */ void ICACHE_FLASH_ATTR bi_export(BI_CTX *ctx, bigint *x, uint8_t *data, int size) { int i, j, k = size-1; check(x); os_memset(data, 0, size); /* ensure all leading 0's are cleared */ for (i = 0; i < x->size; i++) { for (j = 0; j < COMP_BYTE_SIZE; j++) { comp mask = 0xff << (j*8); int num = (x->comps[i] & mask) >> (j*8); data[k--] = num; if (k < 0) { goto buf_done; } } } buf_done: bi_free(ctx, x); } /** * @brief Pre-calculate some of the expensive steps in reduction. * * This function should only be called once (normally when a session starts). * When the session is over, bi_free_mod() should be called. bi_mod_power() * relies on this function being called. * @param ctx [in] The bigint session context. * @param bim [in] The bigint modulus that will be used. * @param mod_offset [in] There are three moduluii that can be stored - the * standard modulus, and its two primes p and q. This offset refers to which * modulus we are referring to. * @see bi_free_mod(), bi_mod_power(). */ void ICACHE_FLASH_ATTR bi_set_mod(BI_CTX *ctx, bigint *bim, int mod_offset) { int k = bim->size; comp d = (comp)((long_comp)COMP_RADIX/(bim->comps[k-1]+1)); #ifdef CONFIG_BIGINT_MONTGOMERY bigint *R, *R2; #endif ctx->bi_mod[mod_offset] = bim; bi_permanent(ctx->bi_mod[mod_offset]); ctx->bi_normalised_mod[mod_offset] = bi_int_multiply(ctx, bim, d); bi_permanent(ctx->bi_normalised_mod[mod_offset]); #if defined(CONFIG_BIGINT_MONTGOMERY) /* set montgomery variables */ R = comp_left_shift(bi_clone(ctx, ctx->bi_radix), k-1); /* R */ R2 = comp_left_shift(bi_clone(ctx, ctx->bi_radix), k*2-1); /* R^2 */ ctx->bi_RR_mod_m[mod_offset] = bi_mod(ctx, R2); /* R^2 mod m */ ctx->bi_R_mod_m[mod_offset] = bi_mod(ctx, R); /* R mod m */ bi_permanent(ctx->bi_RR_mod_m[mod_offset]); bi_permanent(ctx->bi_R_mod_m[mod_offset]); ctx->N0_dash[mod_offset] = modular_inverse(ctx->bi_mod[mod_offset]); #elif defined (CONFIG_BIGINT_BARRETT) ctx->bi_mu[mod_offset] = bi_divide(ctx, comp_left_shift( bi_clone(ctx, ctx->bi_radix), k*2-1), ctx->bi_mod[mod_offset], 0); bi_permanent(ctx->bi_mu[mod_offset]); #endif } /** * @brief Used when cleaning various bigints at the end of a session. * @param ctx [in] The bigint session context. * @param mod_offset [in] The offset to use. * @see bi_set_mod(). */ void ICACHE_FLASH_ATTR bi_free_mod(BI_CTX *ctx, int mod_offset) { bi_depermanent(ctx->bi_mod[mod_offset]); bi_free(ctx, ctx->bi_mod[mod_offset]); #if defined (CONFIG_BIGINT_MONTGOMERY) bi_depermanent(ctx->bi_RR_mod_m[mod_offset]); bi_depermanent(ctx->bi_R_mod_m[mod_offset]); bi_free(ctx, ctx->bi_RR_mod_m[mod_offset]); bi_free(ctx, ctx->bi_R_mod_m[mod_offset]); #elif defined(CONFIG_BIGINT_BARRETT) bi_depermanent(ctx->bi_mu[mod_offset]); bi_free(ctx, ctx->bi_mu[mod_offset]); #endif bi_depermanent(ctx->bi_normalised_mod[mod_offset]); bi_free(ctx, ctx->bi_normalised_mod[mod_offset]); } /** * Perform a standard multiplication between two bigints. * * Barrett reduction has no need for some parts of the product, so ignore bits * of the multiply. This routine gives Barrett its big performance * improvements over Classical/Montgomery reduction methods. */ static bigint * ICACHE_FLASH_ATTR regular_multiply(BI_CTX *ctx, bigint *bia, bigint *bib, int inner_partial, int outer_partial) { int i = 0, j; int n = bia->size; int t = bib->size; bigint *biR = alloc(ctx, n + t); comp *sr = biR->comps; comp *sa = bia->comps; comp *sb = bib->comps; check(bia); check(bib); /* clear things to start with */ os_memset(biR->comps, 0, ((n+t)*COMP_BYTE_SIZE)); do { long_comp tmp; comp carry = 0; int r_index = i; j = 0; if (outer_partial && outer_partial-i > 0 && outer_partial < n) { r_index = outer_partial-1; j = outer_partial-i-1; } do { if (inner_partial && r_index >= inner_partial) { break; } tmp = sr[r_index] + ((long_comp)sa[j])*sb[i] + carry; sr[r_index++] = (comp)tmp; /* downsize */ carry = tmp >> COMP_BIT_SIZE; } while (++j < n); sr[r_index] = carry; } while (++i < t); bi_free(ctx, bia); bi_free(ctx, bib); return trim(biR); } #ifdef CONFIG_BIGINT_KARATSUBA /* * Karatsuba improves on regular multiplication due to only 3 multiplications * being done instead of 4. The additional additions/subtractions are O(N) * rather than O(N^2) and so for big numbers it saves on a few operations */ static bigint * ICACHE_FLASH_ATTR karatsuba(BI_CTX *ctx, bigint *bia, bigint *bib, int is_square) { bigint *x0, *x1; bigint *p0, *p1, *p2; int m; if (is_square) { m = (bia->size + 1)/2; } else { m = (max(bia->size, bib->size) + 1)/2; } x0 = bi_clone(ctx, bia); x0->size = m; x1 = bi_clone(ctx, bia); comp_right_shift(x1, m); bi_free(ctx, bia); /* work out the 3 partial products */ if (is_square) { p0 = bi_square(ctx, bi_copy(x0)); p2 = bi_square(ctx, bi_copy(x1)); p1 = bi_square(ctx, bi_add(ctx, x0, x1)); } else /* normal multiply */ { bigint *y0, *y1; y0 = bi_clone(ctx, bib); y0->size = m; y1 = bi_clone(ctx, bib); comp_right_shift(y1, m); bi_free(ctx, bib); p0 = bi_multiply(ctx, bi_copy(x0), bi_copy(y0)); p2 = bi_multiply(ctx, bi_copy(x1), bi_copy(y1)); p1 = bi_multiply(ctx, bi_add(ctx, x0, x1), bi_add(ctx, y0, y1)); } p1 = bi_subtract(ctx, bi_subtract(ctx, p1, bi_copy(p2), NULL), bi_copy(p0), NULL); comp_left_shift(p1, m); comp_left_shift(p2, 2*m); return bi_add(ctx, p1, bi_add(ctx, p0, p2)); } #endif /** * @brief Perform a multiplication operation between two bigints. * @param ctx [in] The bigint session context. * @param bia [in] A bigint. * @param bib [in] Another bigint. * @return The result of the multiplication. */ bigint * ICACHE_FLASH_ATTR bi_multiply(BI_CTX *ctx, bigint *bia, bigint *bib) { check(bia); check(bib); #ifdef CONFIG_BIGINT_KARATSUBA if (min(bia->size, bib->size) < MUL_KARATSUBA_THRESH) { return regular_multiply(ctx, bia, bib, 0, 0); } return karatsuba(ctx, bia, bib, 0); #else return regular_multiply(ctx, bia, bib, 0, 0); #endif } #ifdef CONFIG_BIGINT_SQUARE /* * Perform the actual square operion. It takes into account overflow. */ static bigint * ICACHE_FLASH_ATTR regular_square(BI_CTX *ctx, bigint *bi) { int t = bi->size; int i = 0, j; bigint *biR = alloc(ctx, t*2+1); comp *w = biR->comps; comp *x = bi->comps; long_comp carry; os_memset(w, 0, biR->size*COMP_BYTE_SIZE); do { long_comp tmp = w[2*i] + (long_comp)x[i]*x[i]; w[2*i] = (comp)tmp; carry = tmp >> COMP_BIT_SIZE; for (j = i+1; j < t; j++) { uint8_t c = 0; long_comp xx = (long_comp)x[i]*x[j]; if ((COMP_MAX-xx) < xx) c = 1; tmp = (xx<<1); if ((COMP_MAX-tmp) < w[i+j]) c = 1; tmp += w[i+j]; if ((COMP_MAX-tmp) < carry) c = 1; tmp += carry; w[i+j] = (comp)tmp; carry = tmp >> COMP_BIT_SIZE; if (c) carry += COMP_RADIX; } tmp = w[i+t] + carry; w[i+t] = (comp)tmp; w[i+t+1] = tmp >> COMP_BIT_SIZE; } while (++i < t); bi_free(ctx, bi); return trim(biR); } /** * @brief Perform a square operation on a bigint. * @param ctx [in] The bigint session context. * @param bia [in] A bigint. * @return The result of the multiplication. */ bigint * ICACHE_FLASH_ATTR bi_square(BI_CTX *ctx, bigint *bia) { check(bia); #ifdef CONFIG_BIGINT_KARATSUBA if (bia->size < SQU_KARATSUBA_THRESH) { return regular_square(ctx, bia); } return karatsuba(ctx, bia, NULL, 1); #else return regular_square(ctx, bia); #endif } #endif /** * @brief Compare two bigints. * @param bia [in] A bigint. * @param bib [in] Another bigint. * @return -1 if smaller, 1 if larger and 0 if equal. */ int ICACHE_FLASH_ATTR bi_compare(bigint *bia, bigint *bib) { int r, i; check(bia); check(bib); if (bia->size > bib->size) r = 1; else if (bia->size < bib->size) r = -1; else { comp *a = bia->comps; comp *b = bib->comps; /* Same number of components. Compare starting from the high end * and working down. */ r = 0; i = bia->size - 1; do { if (a[i] > b[i]) { r = 1; break; } else if (a[i] < b[i]) { r = -1; break; } } while (--i >= 0); } return r; } /* * Allocate and zero more components. Does not consume bi. */ static void ICACHE_FLASH_ATTR more_comps(bigint *bi, int n) { if (n > bi->max_comps) { bi->max_comps = max(bi->max_comps * 2, n); bi->comps = (comp*)os_realloc(bi->comps, bi->max_comps * COMP_BYTE_SIZE); } if (n > bi->size) { os_memset(&bi->comps[bi->size], 0, (n-bi->size)*COMP_BYTE_SIZE); } bi->size = n; } /* * Make a new empty bigint. It may just use an old one if one is available. * Otherwise get one off the heap. */ static bigint * ICACHE_FLASH_ATTR alloc(BI_CTX *ctx, int size) { bigint *biR; /* Can we recycle an old bigint? */ if (ctx->free_list != NULL) { biR = ctx->free_list; ctx->free_list = biR->next; ctx->free_count--; if (biR->refs != 0) { #ifdef CONFIG_SSL_FULL_MODE ssl_printf("alloc: refs was not 0\n"); #endif return; /* wujg : org ----> abort(); */ } more_comps(biR, size); } else { /* No free bigints available - create a new one. */ biR = (bigint *)os_malloc(sizeof(bigint)); biR->comps = (comp*)os_malloc(size * COMP_BYTE_SIZE); biR->max_comps = size; /* give some space to spare */ } biR->size = size; biR->refs = 1; biR->next = NULL; ctx->active_count++; return biR; } /* * Work out the highest '1' bit in an exponent. Used when doing sliding-window * exponentiation. */ static int ICACHE_FLASH_ATTR find_max_exp_index(bigint *biexp) { int i = COMP_BIT_SIZE-1; comp shift = COMP_RADIX/2; comp test = biexp->comps[biexp->size-1]; /* assume no leading zeroes */ check(biexp); do { if (test & shift) { return i+(biexp->size-1)*COMP_BIT_SIZE; } shift >>= 1; } while (i-- != 0); return -1; /* error - must have been a leading 0 */ } /* * Is a particular bit is an exponent 1 or 0? Used when doing sliding-window * exponentiation. */ static int ICACHE_FLASH_ATTR exp_bit_is_one(bigint *biexp, int offset) { comp test = biexp->comps[offset / COMP_BIT_SIZE]; int num_shifts = offset % COMP_BIT_SIZE; comp shift = 1; int i; check(biexp); for (i = 0; i < num_shifts; i++) { shift <<= 1; } return (test & shift) != 0; } #ifdef CONFIG_BIGINT_CHECK_ON /* * Perform a sanity check on bi. */ static void ICACHE_FLASH_ATTR check(const bigint *bi) { if (bi->refs <= 0) { ssl_printf("check: zero or negative refs in bigint\n"); return; /* wujg : org ----> abort(); */ } if (bi->next != NULL) { ssl_printf("check: attempt to use a bigint from " "the free list\n"); return; /* wujg : org ----> abort(); */ } } #endif /* * Delete any leading 0's (and allow for 0). */ static bigint * ICACHE_FLASH_ATTR trim(bigint *bi) { check(bi); while (bi->comps[bi->size-1] == 0 && bi->size > 1) { bi->size--; } return bi; } #if defined(CONFIG_BIGINT_MONTGOMERY) /** * @brief Perform a single montgomery reduction. * @param ctx [in] The bigint session context. * @param bixy [in] A bigint. * @return The result of the montgomery reduction. */ bigint * ICACHE_FLASH_ATTR bi_mont(BI_CTX *ctx, bigint *bixy) { int i = 0, n; uint8_t mod_offset = ctx->mod_offset; bigint *bim = ctx->bi_mod[mod_offset]; comp mod_inv = ctx->N0_dash[mod_offset]; check(bixy); if (ctx->use_classical) /* just use classical instead */ { return bi_mod(ctx, bixy); } n = bim->size; do { bixy = bi_add(ctx, bixy, comp_left_shift( bi_int_multiply(ctx, bim, bixy->comps[i]*mod_inv), i)); } while (++i < n); comp_right_shift(bixy, n); if (bi_compare(bixy, bim) >= 0) { bixy = bi_subtract(ctx, bixy, bim, NULL); } return bixy; } #elif defined(CONFIG_BIGINT_BARRETT) /* * Stomp on the most significant components to give the illusion of a "mod base * radix" operation */ static bigint * ICACHE_FLASH_ATTR comp_mod(bigint *bi, int mod) { check(bi); if (bi->size > mod) { bi->size = mod; } return bi; } /** * @brief Perform a single Barrett reduction. * @param ctx [in] The bigint session context. * @param bi [in] A bigint. * @return The result of the Barrett reduction. */ bigint * ICACHE_FLASH_ATTR bi_barrett(BI_CTX *ctx, bigint *bi) { bigint *q1, *q2, *q3, *r1, *r2, *r; uint8_t mod_offset = ctx->mod_offset; bigint *bim = ctx->bi_mod[mod_offset]; int k = bim->size; check(bi); check(bim); /* use Classical method instead - Barrett cannot help here */ if (bi->size > k*2) { return bi_mod(ctx, bi); } q1 = comp_right_shift(bi_clone(ctx, bi), k-1); /* do outer partial multiply */ q2 = regular_multiply(ctx, q1, ctx->bi_mu[mod_offset], 0, k-1); q3 = comp_right_shift(q2, k+1); r1 = comp_mod(bi, k+1); /* do inner partial multiply */ r2 = comp_mod(regular_multiply(ctx, q3, bim, k+1, 0), k+1); r = bi_subtract(ctx, r1, r2, NULL); /* if (r >= m) r = r - m; */ if (bi_compare(r, bim) >= 0) { r = bi_subtract(ctx, r, bim, NULL); } return r; } #endif /* CONFIG_BIGINT_BARRETT */ #ifdef CONFIG_BIGINT_SLIDING_WINDOW /* * Work out g1, g3, g5, g7... etc for the sliding-window algorithm */ static void ICACHE_FLASH_ATTR precompute_slide_window(BI_CTX *ctx, int window, bigint *g1) { int k = 1, i; bigint *g2; for (i = 0; i < window-1; i++) /* compute 2^(window-1) */ { k <<= 1; } ctx->g = (bigint **)os_malloc(k*sizeof(bigint *)); ctx->g[0] = bi_clone(ctx, g1); bi_permanent(ctx->g[0]); g2 = bi_residue(ctx, bi_square(ctx, ctx->g[0])); /* g^2 */ for (i = 1; i < k; i++) { ctx->g[i] = bi_residue(ctx, bi_multiply(ctx, ctx->g[i-1], bi_copy(g2))); bi_permanent(ctx->g[i]); } bi_free(ctx, g2); ctx->window = k; } #endif /** * @brief Perform a modular exponentiation. * * This function requires bi_set_mod() to have been called previously. This is * one of the optimisations used for performance. * @param ctx [in] The bigint session context. * @param bi [in] The bigint on which to perform the mod power operation. * @param biexp [in] The bigint exponent. * @return The result of the mod exponentiation operation * @see bi_set_mod(). */ bigint * ICACHE_FLASH_ATTR bi_mod_power(BI_CTX *ctx, bigint *bi, bigint *biexp) { int i = find_max_exp_index(biexp), j, window_size = 1; bigint *biR = int_to_bi(ctx, 1); #if defined(CONFIG_BIGINT_MONTGOMERY) uint8_t mod_offset = ctx->mod_offset; if (!ctx->use_classical) { /* preconvert */ bi = bi_mont(ctx, bi_multiply(ctx, bi, ctx->bi_RR_mod_m[mod_offset])); /* x' */ bi_free(ctx, biR); biR = ctx->bi_R_mod_m[mod_offset]; /* A */ } #endif check(bi); check(biexp); #ifdef CONFIG_BIGINT_SLIDING_WINDOW for (j = i; j > 32; j /= 5) /* work out an optimum size */ window_size++; /* work out the slide constants */ precompute_slide_window(ctx, window_size, bi); #else /* just one constant */ ctx->g = (bigint **)os_malloc(sizeof(bigint *)); ctx->g[0] = bi_clone(ctx, bi); ctx->window = 1; bi_permanent(ctx->g[0]); #endif /* if sliding-window is off, then only one bit will be done at a time and * will reduce to standard left-to-right exponentiation */ do { if (exp_bit_is_one(biexp, i)) { int l = i-window_size+1; int part_exp = 0; if (l < 0) /* LSB of exponent will always be 1 */ l = 0; else { while (exp_bit_is_one(biexp, l) == 0) l++; /* go back up */ } /* build up the section of the exponent */ for (j = i; j >= l; j--) { biR = bi_residue(ctx, bi_square(ctx, biR)); if (exp_bit_is_one(biexp, j)) part_exp++; if (j != l) part_exp <<= 1; } part_exp = (part_exp-1)/2; /* adjust for array */ biR = bi_residue(ctx, bi_multiply(ctx, biR, ctx->g[part_exp])); i = l-1; } else /* square it */ { biR = bi_residue(ctx, bi_square(ctx, biR)); i--; } } while (i >= 0); /* cleanup */ for (i = 0; i < ctx->window; i++) { bi_depermanent(ctx->g[i]); bi_free(ctx, ctx->g[i]); } os_free(ctx->g); bi_free(ctx, bi); bi_free(ctx, biexp); #if defined CONFIG_BIGINT_MONTGOMERY return ctx->use_classical ? biR : bi_mont(ctx, biR); /* convert back */ #else /* CONFIG_BIGINT_CLASSICAL or CONFIG_BIGINT_BARRETT */ return biR; #endif } #ifdef CONFIG_SSL_CERT_VERIFICATION /** * @brief Perform a modular exponentiation using a temporary modulus. * * We need this function to check the signatures of certificates. The modulus * of this function is temporary as it's just used for authentication. * @param ctx [in] The bigint session context. * @param bi [in] The bigint to perform the exp/mod. * @param bim [in] The temporary modulus. * @param biexp [in] The bigint exponent. * @return The result of the mod exponentiation operation * @see bi_set_mod(). */ bigint * ICACHE_FLASH_ATTR bi_mod_power2(BI_CTX *ctx, bigint *bi, bigint *bim, bigint *biexp) { bigint *biR, *tmp_biR; /* Set up a temporary bigint context and transfer what we need between * them. We need to do this since we want to keep the original modulus * which is already in this context. This operation is only called when * doing peer verification, and so is not expensive :-) */ BI_CTX *tmp_ctx = bi_initialize(); bi_set_mod(tmp_ctx, bi_clone(tmp_ctx, bim), BIGINT_M_OFFSET); tmp_biR = bi_mod_power(tmp_ctx, bi_clone(tmp_ctx, bi), bi_clone(tmp_ctx, biexp)); biR = bi_clone(ctx, tmp_biR); bi_free(tmp_ctx, tmp_biR); bi_free_mod(tmp_ctx, BIGINT_M_OFFSET); bi_terminate(tmp_ctx); bi_free(ctx, bi); bi_free(ctx, bim); bi_free(ctx, biexp); return biR; } #endif #ifdef CONFIG_BIGINT_CRT /** * @brief Use the Chinese Remainder Theorem to quickly perform RSA decrypts. * * @param ctx [in] The bigint session context. * @param bi [in] The bigint to perform the exp/mod. * @param dP [in] CRT's dP bigint * @param dQ [in] CRT's dQ bigint * @param p [in] CRT's p bigint * @param q [in] CRT's q bigint * @param qInv [in] CRT's qInv bigint * @return The result of the CRT operation */ bigint * ICACHE_FLASH_ATTR bi_crt(BI_CTX *ctx, bigint *bi, bigint *dP, bigint *dQ, bigint *p, bigint *q, bigint *qInv) { bigint *m1, *m2, *h; /* Montgomery has a condition the 0 < x, y < m and these products violate * that condition. So disable Montgomery when using CRT */ #if defined(CONFIG_BIGINT_MONTGOMERY) ctx->use_classical = 1; #endif ctx->mod_offset = BIGINT_P_OFFSET; m1 = bi_mod_power(ctx, bi_copy(bi), dP); ctx->mod_offset = BIGINT_Q_OFFSET; m2 = bi_mod_power(ctx, bi, dQ); h = bi_subtract(ctx, bi_add(ctx, m1, p), bi_copy(m2), NULL); h = bi_multiply(ctx, h, qInv); ctx->mod_offset = BIGINT_P_OFFSET; h = bi_residue(ctx, h); #if defined(CONFIG_BIGINT_MONTGOMERY) ctx->use_classical = 0; /* reset for any further operation */ #endif return bi_add(ctx, m2, bi_multiply(ctx, q, h)); } #endif /** @} */ ================================================ FILE: app/ssl/crypto/ssl_crypto_misc.c ================================================ /* * Copyright (c) 2007, Cameron Rich * * 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 axTLS project 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. */ /** * Some misc. routines to help things out */ #include //#include //#include //#include #include "ssl/ssl_os_port.h" #include "ssl/ssl_crypto_misc.h" #ifdef CONFIG_WIN32_USE_CRYPTO_LIB #include "wincrypt.h" #endif #ifndef WIN32 static int rng_fd = -1; #elif defined(CONFIG_WIN32_USE_CRYPTO_LIB) static HCRYPTPROV gCryptProv; #endif #if (!defined(CONFIG_USE_DEV_URANDOM) && !defined(CONFIG_WIN32_USE_CRYPTO_LIB)) /* change to processor registers as appropriate */ #define ENTROPY_POOL_SIZE 32 #define ENTROPY_COUNTER1 ((((uint64_t)tv.tv_sec)<<32) | tv.tv_usec) #define ENTROPY_COUNTER2 rand() static uint8_t entropy_pool[ENTROPY_POOL_SIZE]; #endif const char * const unsupported_str = "Error: Feature not supported\n"; #ifndef CONFIG_SSL_SKELETON_MODE /** * Retrieve a file and put it into memory * @return The size of the file, or -1 on failure. */ int get_file(const char *filename, uint8_t **buf) { #if 0 int total_bytes = 0; int bytes_read = 0; int filesize; FILE *stream = fopen(filename, "rb"); if (stream == NULL) { #ifdef CONFIG_SSL_FULL_MODE printf("file '%s' does not exist\n", filename); //TTY_FLUSH(); #endif return -1; } /* Win CE doesn't support stat() */ fseek(stream, 0, SEEK_END); filesize = ftell(stream); *buf = (uint8_t *)os_malloc(filesize); fseek(stream, 0, SEEK_SET); do { bytes_read = fread(*buf+total_bytes, 1, filesize-total_bytes, stream); total_bytes += bytes_read; } while (total_bytes < filesize && bytes_read > 0); fclose(stream); return filesize; #endif return 0; } #endif /** * Initialise the Random Number Generator engine. * - On Win32 use the platform SDK's crypto engine. * - On Linux use /dev/urandom * - If none of these work then use a custom RNG. */ EXP_FUNC void STDCALL ICACHE_FLASH_ATTR RNG_initialize() { #if !defined(WIN32) && defined(CONFIG_USE_DEV_URANDOM) rng_fd = ax_open("/dev/urandom", O_RDONLY); #elif defined(WIN32) && defined(CONFIG_WIN32_USE_CRYPTO_LIB) if (!CryptAcquireContext(&gCryptProv, NULL, NULL, PROV_RSA_FULL, 0)) { if (GetLastError() == NTE_BAD_KEYSET && !CryptAcquireContext(&gCryptProv, NULL, NULL, PROV_RSA_FULL, CRYPT_NEWKEYSET)) { printf("CryptoLib: %x\n", unsupported_str, GetLastError()); exit(1); } } #else /* start of with a stack to copy across */ int i; os_memcpy(entropy_pool, &i, ENTROPY_POOL_SIZE); srand((unsigned int)&i); #endif } /** * If no /dev/urandom, then initialise the RNG with something interesting. */ EXP_FUNC void STDCALL ICACHE_FLASH_ATTR RNG_custom_init(const uint8_t *seed_buf, int size) { #if defined(WIN32) || defined(CONFIG_WIN32_USE_CRYPTO_LIB) int i; for (i = 0; i < ENTROPY_POOL_SIZE && i < size; i++) entropy_pool[i] ^= seed_buf[i]; #endif } /** * Terminate the RNG engine. */ EXP_FUNC void STDCALL ICACHE_FLASH_ATTR RNG_terminate(void) { #ifndef WIN32 // close(rng_fd); #elif defined(CONFIG_WIN32_USE_CRYPTO_LIB) CryptReleaseContext(gCryptProv, 0); #endif } /** * Set a series of bytes with a random number. Individual bytes can be 0 */ EXP_FUNC void STDCALL ICACHE_FLASH_ATTR get_random(int num_rand_bytes, uint8_t *rand_data) { #if !defined(WIN32) && defined(CONFIG_USE_DEV_URANDOM) /* use the Linux default */ read(rng_fd, rand_data, num_rand_bytes); /* read from /dev/urandom */ #elif defined(WIN32) && defined(CONFIG_WIN32_USE_CRYPTO_LIB) /* use Microsoft Crypto Libraries */ CryptGenRandom(gCryptProv, num_rand_bytes, rand_data); #else /* nothing else to use, so use a custom RNG */ /* The method we use when we've got nothing better. Use RC4, time and a couple of random seeds to generate a random sequence */ RC4_CTX rng_ctx; struct timeval tv; MD5_CTX rng_digest_ctx; uint8_t digest[MD5_SIZE]; uint64_t *ep; int i; /* A proper implementation would use counters etc for entropy */ // gettimeofday(&tv, NULL); ep = (uint64_t *)entropy_pool; ep[0] ^= ENTROPY_COUNTER1; ep[1] ^= ENTROPY_COUNTER2; /* use a digested version of the entropy pool as a key */ MD5_Init(&rng_digest_ctx); MD5_Update(&rng_digest_ctx, entropy_pool, ENTROPY_POOL_SIZE); MD5_Final(digest, &rng_digest_ctx); /* come up with the random sequence */ RC4_setup(&rng_ctx, digest, MD5_SIZE); /* use as a key */ os_memcpy(rand_data, entropy_pool, num_rand_bytes < ENTROPY_POOL_SIZE ? num_rand_bytes : ENTROPY_POOL_SIZE); RC4_crypt(&rng_ctx, rand_data, rand_data, num_rand_bytes); /* move things along */ for (i = ENTROPY_POOL_SIZE-1; i >= MD5_SIZE ; i--) entropy_pool[i] = entropy_pool[i-MD5_SIZE]; /* insert the digest at the start of the entropy pool */ os_memcpy(entropy_pool, digest, MD5_SIZE); #endif } /** * Set a series of bytes with a random number. Individual bytes are not zero. */ void ICACHE_FLASH_ATTR get_random_NZ(int num_rand_bytes, uint8_t *rand_data) { int i; get_random(num_rand_bytes, rand_data); for (i = 0; i < num_rand_bytes; i++) { while (rand_data[i] == 0) /* can't be 0 */ rand_data[i] = (uint8_t)(rand()); } } /** * Some useful diagnostic routines */ #if defined(CONFIG_SSL_FULL_MODE) || defined(CONFIG_DEBUG) int hex_finish; int hex_index; static void ICACHE_FLASH_ATTR print_hex_init(int finish) { hex_finish = finish; hex_index = 0; } static void ICACHE_FLASH_ATTR print_hex(uint8_t hex) { static int column; if (hex_index == 0) { column = 0; } ssl_printf("%02x ", hex); if (++column == 8) { ssl_printf(": "); } else if (column >= 16) { ssl_printf("\n"); column = 0; } if (++hex_index >= hex_finish && column > 0) { ssl_printf("\n"); } } /** * Spit out a blob of data for diagnostics. The data is is a nice column format * for easy reading. * * @param format [in] The string (with possible embedded format characters) * @param size [in] The number of numbers to print * @param data [in] The start of data to use * @param ... [in] Any additional arguments */ EXP_FUNC void STDCALL ICACHE_FLASH_ATTR print_blob(const char *format, const uint8_t *data, int size, ...) { // int i; // char tmp[80]; // va_list(ap); // va_start(ap, size); // sprintf(tmp, "%s\n", format); // vprintf(tmp, ap); // print_hex_init(size); // for (i = 0; i < size; i++) // { // print_hex(data[i]); // } // va_end(ap); // TTY_FLUSH(); } #elif defined(WIN32) /* VC6.0 doesn't handle variadic macros */ EXP_FUNC void STDCALL print_blob(const char *format, const unsigned char *data, int size, ...) {} #endif #if defined(CONFIG_SSL_HAS_PEM) || defined(CONFIG_HTTP_HAS_AUTHORIZATION) /* base64 to binary lookup table */ static const uint8_t map[128] = { 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 62, 255, 255, 255, 63, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 255, 255, 255, 254, 255, 255, 255, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 255, 255, 255, 255, 255, 255, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 255, 255, 255, 255, 255 }; EXP_FUNC int STDCALL ICACHE_FLASH_ATTR base64_decode(const char *in, int len, uint8_t *out, int *outlen) { int g, t, x, y, z; uint8_t c; int ret = -1; g = 3; for (x = y = z = t = 0; x < len; x++) { if ((c = map[in[x]&0x7F]) == 0xff) continue; if (c == 254) /* this is the end... */ { c = 0; if (--g < 0) goto error; } else if (g != 3) /* only allow = at end */ goto error; t = (t<<6) | c; if (++y == 4) { out[z++] = (uint8_t)((t>>16)&255); if (g > 1) out[z++] = (uint8_t)((t>>8)&255); if (g > 2) out[z++] = (uint8_t)(t&255); y = t = 0; } /* check that we don't go past the output buffer */ if (z > *outlen) goto error; } if (y != 0) goto error; *outlen = z; ret = 0; error: #ifdef CONFIG_SSL_FULL_MODE if (ret < 0) ssl_printf("Error: Invalid base64\n"); //TTY_FLUSH(); #endif //TTY_FLUSH(); return ret; } #endif ================================================ FILE: app/ssl/crypto/ssl_hmac.c ================================================ /* * Copyright (c) 2007, Cameron Rich * * 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 axTLS project 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. */ /** * HMAC implementation - This code was originally taken from RFC2104 * See http://www.ietf.org/rfc/rfc2104.txt and * http://www.faqs.org/rfcs/rfc2202.html */ //#include #include "ssl/ssl_os_port.h" #include "ssl/ssl_crypto.h" /** * Perform HMAC-MD5 * NOTE: does not handle keys larger than the block size. */ void ICACHE_FLASH_ATTR ssl_hmac_md5(const uint8_t *msg, int length, const uint8_t *key, int key_len, uint8_t *digest) { MD5_CTX context; uint8_t k_ipad[64]; uint8_t k_opad[64]; int i; os_memset(k_ipad, 0, sizeof k_ipad); os_memset(k_opad, 0, sizeof k_opad); os_memcpy(k_ipad, key, key_len); os_memcpy(k_opad, key, key_len); for (i = 0; i < 64; i++) { k_ipad[i] ^= 0x36; k_opad[i] ^= 0x5c; } MD5_Init(&context); MD5_Update(&context, k_ipad, 64); MD5_Update(&context, msg, length); MD5_Final(digest, &context); MD5_Init(&context); MD5_Update(&context, k_opad, 64); MD5_Update(&context, digest, MD5_SIZE); MD5_Final(digest, &context); } /** * Perform HMAC-SHA1 * NOTE: does not handle keys larger than the block size. */ void ICACHE_FLASH_ATTR ssl_hmac_sha1(const uint8_t *msg, int length, const uint8_t *key, int key_len, uint8_t *digest) { SHA1_CTX context; uint8_t k_ipad[64]; uint8_t k_opad[64]; int i; os_memset(k_ipad, 0, sizeof k_ipad); os_memset(k_opad, 0, sizeof k_opad); os_memcpy(k_ipad, key, key_len); os_memcpy(k_opad, key, key_len); for (i = 0; i < 64; i++) { k_ipad[i] ^= 0x36; k_opad[i] ^= 0x5c; } SHA1_Init(&context); SHA1_Update(&context, k_ipad, 64); SHA1_Update(&context, msg, length); SHA1_Final(digest, &context); SHA1_Init(&context); SHA1_Update(&context, k_opad, 64); SHA1_Update(&context, digest, SHA1_SIZE); SHA1_Final(digest, &context); } ================================================ FILE: app/ssl/crypto/ssl_md2.c ================================================ /* * Copyright (c) 2007, Cameron Rich * * 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 axTLS project 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. */ /* * RFC 1115/1319 compliant MD2 implementation * The MD2 algorithm was designed by Ron Rivest in 1989. * * http://www.ietf.org/rfc/rfc1115.txt * http://www.ietf.org/rfc/rfc1319.txt */ //#include //#include #include "ssl/ssl_os_port.h" #include "ssl/ssl_crypto.h" //#include "os.h" #include "lwip/mem.h" /** * This code is only here to enable the verification of Verisign root * certificates. So only enable it for verification mode. */ #ifdef CONFIG_SSL_CERT_VERIFICATION static const uint8_t PI_SUBST[256] = { 0x29, 0x2E, 0x43, 0xC9, 0xA2, 0xD8, 0x7C, 0x01, 0x3D, 0x36, 0x54, 0xA1, 0xEC, 0xF0, 0x06, 0x13, 0x62, 0xA7, 0x05, 0xF3, 0xC0, 0xC7, 0x73, 0x8C, 0x98, 0x93, 0x2B, 0xD9, 0xBC, 0x4C, 0x82, 0xCA, 0x1E, 0x9B, 0x57, 0x3C, 0xFD, 0xD4, 0xE0, 0x16, 0x67, 0x42, 0x6F, 0x18, 0x8A, 0x17, 0xE5, 0x12, 0xBE, 0x4E, 0xC4, 0xD6, 0xDA, 0x9E, 0xDE, 0x49, 0xA0, 0xFB, 0xF5, 0x8E, 0xBB, 0x2F, 0xEE, 0x7A, 0xA9, 0x68, 0x79, 0x91, 0x15, 0xB2, 0x07, 0x3F, 0x94, 0xC2, 0x10, 0x89, 0x0B, 0x22, 0x5F, 0x21, 0x80, 0x7F, 0x5D, 0x9A, 0x5A, 0x90, 0x32, 0x27, 0x35, 0x3E, 0xCC, 0xE7, 0xBF, 0xF7, 0x97, 0x03, 0xFF, 0x19, 0x30, 0xB3, 0x48, 0xA5, 0xB5, 0xD1, 0xD7, 0x5E, 0x92, 0x2A, 0xAC, 0x56, 0xAA, 0xC6, 0x4F, 0xB8, 0x38, 0xD2, 0x96, 0xA4, 0x7D, 0xB6, 0x76, 0xFC, 0x6B, 0xE2, 0x9C, 0x74, 0x04, 0xF1, 0x45, 0x9D, 0x70, 0x59, 0x64, 0x71, 0x87, 0x20, 0x86, 0x5B, 0xCF, 0x65, 0xE6, 0x2D, 0xA8, 0x02, 0x1B, 0x60, 0x25, 0xAD, 0xAE, 0xB0, 0xB9, 0xF6, 0x1C, 0x46, 0x61, 0x69, 0x34, 0x40, 0x7E, 0x0F, 0x55, 0x47, 0xA3, 0x23, 0xDD, 0x51, 0xAF, 0x3A, 0xC3, 0x5C, 0xF9, 0xCE, 0xBA, 0xC5, 0xEA, 0x26, 0x2C, 0x53, 0x0D, 0x6E, 0x85, 0x28, 0x84, 0x09, 0xD3, 0xDF, 0xCD, 0xF4, 0x41, 0x81, 0x4D, 0x52, 0x6A, 0xDC, 0x37, 0xC8, 0x6C, 0xC1, 0xAB, 0xFA, 0x24, 0xE1, 0x7B, 0x08, 0x0C, 0xBD, 0xB1, 0x4A, 0x78, 0x88, 0x95, 0x8B, 0xE3, 0x63, 0xE8, 0x6D, 0xE9, 0xCB, 0xD5, 0xFE, 0x3B, 0x00, 0x1D, 0x39, 0xF2, 0xEF, 0xB7, 0x0E, 0x66, 0x58, 0xD0, 0xE4, 0xA6, 0x77, 0x72, 0xF8, 0xEB, 0x75, 0x4B, 0x0A, 0x31, 0x44, 0x50, 0xB4, 0x8F, 0xED, 0x1F, 0x1A, 0xDB, 0x99, 0x8D, 0x33, 0x9F, 0x11, 0x83, 0x14 }; /* * MD2 context setup */ EXP_FUNC void STDCALL ICACHE_FLASH_ATTR MD2_Init(MD2_CTX *ctx) { os_memset(ctx, 0, sizeof *ctx); } static void ICACHE_FLASH_ATTR md2_process(MD2_CTX *ctx) { int i, j; uint8_t t = 0; for (i = 0; i < 16; i++) { ctx->state[i + 16] = ctx->buffer[i]; ctx->state[i + 32] = ctx->buffer[i] ^ ctx->state[i]; } for (i = 0; i < 18; i++) { for (j = 0; j < 48; j++) t = (ctx->state[j] ^= PI_SUBST[t]); t = (t + i) & 0xFF; } t = ctx->cksum[15]; for (i = 0; i < 16; i++) t = (ctx->cksum[i] ^= PI_SUBST[ctx->buffer[i] ^ t]); } /* * MD2 process buffer */ EXP_FUNC void STDCALL ICACHE_FLASH_ATTR MD2_Update(MD2_CTX *ctx, const uint8_t *input, int ilen) { int fill; while (ilen > 0) { if (ctx->left + ilen > 16) fill = 16 - ctx->left; else fill = ilen; os_memcpy(ctx->buffer + ctx->left, input, fill); ctx->left += fill; input += fill; ilen -= fill; if (ctx->left == 16) { ctx->left = 0; md2_process(ctx); } } } /* * MD2 final digest */ EXP_FUNC void STDCALL ICACHE_FLASH_ATTR MD2_Final(uint8_t *output, MD2_CTX *ctx) { int i; uint8_t x; x = (uint8_t)(16 - ctx->left); for (i = ctx->left; i < 16; i++) ctx->buffer[i] = x; md2_process(ctx); os_memcpy(ctx->buffer, ctx->cksum, 16); md2_process(ctx); os_memcpy(output, ctx->state, 16); } #endif ================================================ FILE: app/ssl/crypto/ssl_md5.c ================================================ /* * Copyright (c) 2007, Cameron Rich * * 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 axTLS project 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. */ /** * This file implements the MD5 algorithm as defined in RFC1321 */ //#include #include "ssl/ssl_os_port.h" #include "ssl/ssl_crypto.h" //#include "os.h" #include "lwip/mem.h" /* Constants for MD5Transform routine. */ #define S11 7 #define S12 12 #define S13 17 #define S14 22 #define S21 5 #define S22 9 #define S23 14 #define S24 20 #define S31 4 #define S32 11 #define S33 16 #define S34 23 #define S41 6 #define S42 10 #define S43 15 #define S44 21 /* ----- static functions ----- */ static void MD5Transform(uint32_t state[4], const uint8_t block[64]); static void Encode(uint8_t *output, uint32_t *input, uint32_t len); static void Decode(uint32_t *output, const uint8_t *input, uint32_t len); static const uint8_t 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 }; /* F, G, H and I are basic MD5 functions. */ #define F(x, y, z) (((x) & (y)) | ((~x) & (z))) #define G(x, y, z) (((x) & (z)) | ((y) & (~z))) #define H(x, y, z) ((x) ^ (y) ^ (z)) #define I(x, y, z) ((y) ^ ((x) | (~z))) /* ROTATE_LEFT rotates x left n bits. */ #define ROTATE_LEFT(x, n) (((x) << (n)) | ((x) >> (32-(n)))) /* FF, GG, HH, and II transformations for rounds 1, 2, 3, and 4. Rotation is separate from addition to prevent recomputation. */ #define FF(a, b, c, d, x, s, ac) { \ (a) += F ((b), (c), (d)) + (x) + (uint32_t)(ac); \ (a) = ROTATE_LEFT ((a), (s)); \ (a) += (b); \ } #define GG(a, b, c, d, x, s, ac) { \ (a) += G ((b), (c), (d)) + (x) + (uint32_t)(ac); \ (a) = ROTATE_LEFT ((a), (s)); \ (a) += (b); \ } #define HH(a, b, c, d, x, s, ac) { \ (a) += H ((b), (c), (d)) + (x) + (uint32_t)(ac); \ (a) = ROTATE_LEFT ((a), (s)); \ (a) += (b); \ } #define II(a, b, c, d, x, s, ac) { \ (a) += I ((b), (c), (d)) + (x) + (uint32_t)(ac); \ (a) = ROTATE_LEFT ((a), (s)); \ (a) += (b); \ } /** * MD5 initialization - begins an MD5 operation, writing a new ctx. */ EXP_FUNC void STDCALL ICACHE_FLASH_ATTR MD5_Init(MD5_CTX *ctx) { ctx->count[0] = ctx->count[1] = 0; /* Load magic initialization constants. */ ctx->state[0] = 0x67452301; ctx->state[1] = 0xefcdab89; ctx->state[2] = 0x98badcfe; ctx->state[3] = 0x10325476; } /** * Accepts an array of octets as the next portion of the message. */ EXP_FUNC void STDCALL ICACHE_FLASH_ATTR MD5_Update(MD5_CTX *ctx, const uint8_t * msg, int len) { uint32_t x; int i, partLen; /* Compute number of bytes mod 64 */ x = (uint32_t)((ctx->count[0] >> 3) & 0x3F); /* Update number of bits */ if ((ctx->count[0] += ((uint32_t)len << 3)) < ((uint32_t)len << 3)) ctx->count[1]++; ctx->count[1] += ((uint32_t)len >> 29); partLen = 64 - x; /* Transform as many times as possible. */ if (len >= partLen) { os_memcpy(&ctx->buffer[x], msg, partLen); MD5Transform(ctx->state, ctx->buffer); for (i = partLen; i + 63 < len; i += 64) MD5Transform(ctx->state, &msg[i]); x = 0; } else i = 0; /* Buffer remaining input */ os_memcpy(&ctx->buffer[x], &msg[i], len-i); } /** * Return the 128-bit message digest into the user's array */ EXP_FUNC void STDCALL ICACHE_FLASH_ATTR MD5_Final(uint8_t *digest, MD5_CTX *ctx) { uint8_t bits[8]; uint32_t x, padLen; /* Save number of bits */ Encode(bits, ctx->count, 8); /* Pad out to 56 mod 64. */ x = (uint32_t)((ctx->count[0] >> 3) & 0x3f); padLen = (x < 56) ? (56 - x) : (120 - x); MD5_Update(ctx, PADDING, padLen); /* Append length (before padding) */ MD5_Update(ctx, bits, 8); /* Store state in digest */ Encode(digest, ctx->state, MD5_SIZE); } /** * MD5 basic transformation. Transforms state based on block. */ static void ICACHE_FLASH_ATTR MD5Transform(uint32_t state[4], const uint8_t block[64]) { uint32_t a = state[0], b = state[1], c = state[2], d = state[3], x[MD5_SIZE]; Decode(x, block, 64); /* Round 1 */ FF (a, b, c, d, x[ 0], S11, 0xd76aa478); /* 1 */ FF (d, a, b, c, x[ 1], S12, 0xe8c7b756); /* 2 */ FF (c, d, a, b, x[ 2], S13, 0x242070db); /* 3 */ FF (b, c, d, a, x[ 3], S14, 0xc1bdceee); /* 4 */ FF (a, b, c, d, x[ 4], S11, 0xf57c0faf); /* 5 */ FF (d, a, b, c, x[ 5], S12, 0x4787c62a); /* 6 */ FF (c, d, a, b, x[ 6], S13, 0xa8304613); /* 7 */ FF (b, c, d, a, x[ 7], S14, 0xfd469501); /* 8 */ FF (a, b, c, d, x[ 8], S11, 0x698098d8); /* 9 */ FF (d, a, b, c, x[ 9], S12, 0x8b44f7af); /* 10 */ FF (c, d, a, b, x[10], S13, 0xffff5bb1); /* 11 */ FF (b, c, d, a, x[11], S14, 0x895cd7be); /* 12 */ FF (a, b, c, d, x[12], S11, 0x6b901122); /* 13 */ FF (d, a, b, c, x[13], S12, 0xfd987193); /* 14 */ FF (c, d, a, b, x[14], S13, 0xa679438e); /* 15 */ FF (b, c, d, a, x[15], S14, 0x49b40821); /* 16 */ /* Round 2 */ GG (a, b, c, d, x[ 1], S21, 0xf61e2562); /* 17 */ GG (d, a, b, c, x[ 6], S22, 0xc040b340); /* 18 */ GG (c, d, a, b, x[11], S23, 0x265e5a51); /* 19 */ GG (b, c, d, a, x[ 0], S24, 0xe9b6c7aa); /* 20 */ GG (a, b, c, d, x[ 5], S21, 0xd62f105d); /* 21 */ GG (d, a, b, c, x[10], S22, 0x2441453); /* 22 */ GG (c, d, a, b, x[15], S23, 0xd8a1e681); /* 23 */ GG (b, c, d, a, x[ 4], S24, 0xe7d3fbc8); /* 24 */ GG (a, b, c, d, x[ 9], S21, 0x21e1cde6); /* 25 */ GG (d, a, b, c, x[14], S22, 0xc33707d6); /* 26 */ GG (c, d, a, b, x[ 3], S23, 0xf4d50d87); /* 27 */ GG (b, c, d, a, x[ 8], S24, 0x455a14ed); /* 28 */ GG (a, b, c, d, x[13], S21, 0xa9e3e905); /* 29 */ GG (d, a, b, c, x[ 2], S22, 0xfcefa3f8); /* 30 */ GG (c, d, a, b, x[ 7], S23, 0x676f02d9); /* 31 */ GG (b, c, d, a, x[12], S24, 0x8d2a4c8a); /* 32 */ /* Round 3 */ HH (a, b, c, d, x[ 5], S31, 0xfffa3942); /* 33 */ HH (d, a, b, c, x[ 8], S32, 0x8771f681); /* 34 */ HH (c, d, a, b, x[11], S33, 0x6d9d6122); /* 35 */ HH (b, c, d, a, x[14], S34, 0xfde5380c); /* 36 */ HH (a, b, c, d, x[ 1], S31, 0xa4beea44); /* 37 */ HH (d, a, b, c, x[ 4], S32, 0x4bdecfa9); /* 38 */ HH (c, d, a, b, x[ 7], S33, 0xf6bb4b60); /* 39 */ HH (b, c, d, a, x[10], S34, 0xbebfbc70); /* 40 */ HH (a, b, c, d, x[13], S31, 0x289b7ec6); /* 41 */ HH (d, a, b, c, x[ 0], S32, 0xeaa127fa); /* 42 */ HH (c, d, a, b, x[ 3], S33, 0xd4ef3085); /* 43 */ HH (b, c, d, a, x[ 6], S34, 0x4881d05); /* 44 */ HH (a, b, c, d, x[ 9], S31, 0xd9d4d039); /* 45 */ HH (d, a, b, c, x[12], S32, 0xe6db99e5); /* 46 */ HH (c, d, a, b, x[15], S33, 0x1fa27cf8); /* 47 */ HH (b, c, d, a, x[ 2], S34, 0xc4ac5665); /* 48 */ /* Round 4 */ II (a, b, c, d, x[ 0], S41, 0xf4292244); /* 49 */ II (d, a, b, c, x[ 7], S42, 0x432aff97); /* 50 */ II (c, d, a, b, x[14], S43, 0xab9423a7); /* 51 */ II (b, c, d, a, x[ 5], S44, 0xfc93a039); /* 52 */ II (a, b, c, d, x[12], S41, 0x655b59c3); /* 53 */ II (d, a, b, c, x[ 3], S42, 0x8f0ccc92); /* 54 */ II (c, d, a, b, x[10], S43, 0xffeff47d); /* 55 */ II (b, c, d, a, x[ 1], S44, 0x85845dd1); /* 56 */ II (a, b, c, d, x[ 8], S41, 0x6fa87e4f); /* 57 */ II (d, a, b, c, x[15], S42, 0xfe2ce6e0); /* 58 */ II (c, d, a, b, x[ 6], S43, 0xa3014314); /* 59 */ II (b, c, d, a, x[13], S44, 0x4e0811a1); /* 60 */ II (a, b, c, d, x[ 4], S41, 0xf7537e82); /* 61 */ II (d, a, b, c, x[11], S42, 0xbd3af235); /* 62 */ II (c, d, a, b, x[ 2], S43, 0x2ad7d2bb); /* 63 */ II (b, c, d, a, x[ 9], S44, 0xeb86d391); /* 64 */ state[0] += a; state[1] += b; state[2] += c; state[3] += d; } /** * Encodes input (uint32_t) into output (uint8_t). Assumes len is * a multiple of 4. */ static void ICACHE_FLASH_ATTR Encode(uint8_t *output, uint32_t *input, uint32_t len) { uint32_t i, j; for (i = 0, j = 0; j < len; i++, j += 4) { output[j] = (uint8_t)(input[i] & 0xff); output[j+1] = (uint8_t)((input[i] >> 8) & 0xff); output[j+2] = (uint8_t)((input[i] >> 16) & 0xff); output[j+3] = (uint8_t)((input[i] >> 24) & 0xff); } } /** * Decodes input (uint8_t) into output (uint32_t). Assumes len is * a multiple of 4. */ static void ICACHE_FLASH_ATTR Decode(uint32_t *output, const uint8_t *input, uint32_t len) { uint32_t i, j; for (i = 0, j = 0; j < len; i++, j += 4) output[i] = ((uint32_t)input[j]) | (((uint32_t)input[j+1]) << 8) | (((uint32_t)input[j+2]) << 16) | (((uint32_t)input[j+3]) << 24); } ================================================ FILE: app/ssl/crypto/ssl_rc4.c ================================================ /* * Copyright (c) 2007, Cameron Rich * * 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 axTLS project 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. */ /** * An implementation of the RC4/ARC4 algorithm. * Originally written by Christophe Devine. */ //#include #include "ssl/ssl_os_port.h" #include "ssl/ssl_crypto.h" /** * Get ready for an encrypt/decrypt operation */ void ICACHE_FLASH_ATTR RC4_setup(RC4_CTX *ctx, const uint8_t *key, int length) { int i, j = 0, k = 0, a; uint8_t *m; ctx->x = 0; ctx->y = 0; m = ctx->m; for (i = 0; i < 256; i++) m[i] = i; for (i = 0; i < 256; i++) { a = m[i]; j = (uint8_t)(j + a + key[k]); m[i] = m[j]; m[j] = a; if (++k >= length) k = 0; } } /** * Perform the encrypt/decrypt operation (can use it for either since * this is a stream cipher). * NOTE: *msg and *out must be the same pointer (performance tweak) */ void ICACHE_FLASH_ATTR RC4_crypt(RC4_CTX *ctx, const uint8_t *msg, uint8_t *out, int length) { int i; uint8_t *m, x, y, a, b; x = ctx->x; y = ctx->y; m = ctx->m; for (i = 0; i < length; i++) { a = m[++x]; y += a; m[x] = b = m[y]; m[y] = a; out[i] ^= m[(uint8_t)(a + b)]; } ctx->x = x; ctx->y = y; } ================================================ FILE: app/ssl/crypto/ssl_rsa.c ================================================ /* * Copyright (c) 2007, Cameron Rich * * 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 axTLS project 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. */ /** * Implements the RSA public encryption algorithm. Uses the bigint library to * perform its calculations. */ //#include //#include //#include //#include #include "ssl/ssl_os_port.h" #include "ssl/ssl_crypto.h" //#include "os.h" #include "lwip/mem.h" void ICACHE_FLASH_ATTR RSA_priv_key_new(RSA_CTX **ctx, const uint8_t *modulus, int mod_len, const uint8_t *pub_exp, int pub_len, const uint8_t *priv_exp, int priv_len #if CONFIG_BIGINT_CRT , const uint8_t *p, int p_len, const uint8_t *q, int q_len, const uint8_t *dP, int dP_len, const uint8_t *dQ, int dQ_len, const uint8_t *qInv, int qInv_len #endif ) { RSA_CTX *rsa_ctx; BI_CTX *bi_ctx; RSA_pub_key_new(ctx, modulus, mod_len, pub_exp, pub_len); rsa_ctx = *ctx; bi_ctx = rsa_ctx->bi_ctx; rsa_ctx->d = bi_import(bi_ctx, priv_exp, priv_len); bi_permanent(rsa_ctx->d); #ifdef CONFIG_BIGINT_CRT rsa_ctx->p = bi_import(bi_ctx, p, p_len); rsa_ctx->q = bi_import(bi_ctx, q, q_len); rsa_ctx->dP = bi_import(bi_ctx, dP, dP_len); rsa_ctx->dQ = bi_import(bi_ctx, dQ, dQ_len); rsa_ctx->qInv = bi_import(bi_ctx, qInv, qInv_len); bi_permanent(rsa_ctx->dP); bi_permanent(rsa_ctx->dQ); bi_permanent(rsa_ctx->qInv); bi_set_mod(bi_ctx, rsa_ctx->p, BIGINT_P_OFFSET); bi_set_mod(bi_ctx, rsa_ctx->q, BIGINT_Q_OFFSET); #endif } void ICACHE_FLASH_ATTR RSA_pub_key_new(RSA_CTX **ctx, const uint8_t *modulus, int mod_len, const uint8_t *pub_exp, int pub_len) { RSA_CTX *rsa_ctx; BI_CTX *bi_ctx; if (*ctx) /* if we load multiple certs, dump the old one */ RSA_free(*ctx); bi_ctx = bi_initialize(); *ctx = (RSA_CTX *)os_zalloc(sizeof(RSA_CTX)); rsa_ctx = *ctx; rsa_ctx->bi_ctx = bi_ctx; rsa_ctx->num_octets = mod_len; rsa_ctx->m = bi_import(bi_ctx, modulus, mod_len); bi_set_mod(bi_ctx, rsa_ctx->m, BIGINT_M_OFFSET); rsa_ctx->e = bi_import(bi_ctx, pub_exp, pub_len); bi_permanent(rsa_ctx->e); } /** * Free up any RSA context resources. */ void ICACHE_FLASH_ATTR RSA_free(RSA_CTX *rsa_ctx) { BI_CTX *bi_ctx; if (rsa_ctx == NULL) /* deal with ptrs that are null */ return; bi_ctx = rsa_ctx->bi_ctx; bi_depermanent(rsa_ctx->e); bi_free(bi_ctx, rsa_ctx->e); bi_free_mod(rsa_ctx->bi_ctx, BIGINT_M_OFFSET); if (rsa_ctx->d) { bi_depermanent(rsa_ctx->d); bi_free(bi_ctx, rsa_ctx->d); #ifdef CONFIG_BIGINT_CRT bi_depermanent(rsa_ctx->dP); bi_depermanent(rsa_ctx->dQ); bi_depermanent(rsa_ctx->qInv); bi_free(bi_ctx, rsa_ctx->dP); bi_free(bi_ctx, rsa_ctx->dQ); bi_free(bi_ctx, rsa_ctx->qInv); bi_free_mod(rsa_ctx->bi_ctx, BIGINT_P_OFFSET); bi_free_mod(rsa_ctx->bi_ctx, BIGINT_Q_OFFSET); #endif } bi_terminate(bi_ctx); os_free(rsa_ctx); } /** * @brief Use PKCS1.5 for decryption/verification. * @param ctx [in] The context * @param in_data [in] The data to encrypt (must be < modulus size-11) * @param out_data [out] The encrypted data. * @param is_decryption [in] Decryption or verify operation. * @return The number of bytes that were originally encrypted. -1 on error. * @see http://www.rsasecurity.com/rsalabs/node.asp?id=2125 */ int ICACHE_FLASH_ATTR RSA_decrypt(const RSA_CTX *ctx, const uint8_t *in_data, uint8_t *out_data, int is_decryption) { const int byte_size = ctx->num_octets; int i, size; bigint *decrypted_bi, *dat_bi; uint8_t *block = (uint8_t *)os_malloc(byte_size); os_memset(out_data, 0, byte_size); /* initialise */ /* decrypt */ dat_bi = bi_import(ctx->bi_ctx, in_data, byte_size); #ifdef CONFIG_SSL_CERT_VERIFICATION decrypted_bi = is_decryption ? /* decrypt or verify? */ RSA_private(ctx, dat_bi) : RSA_public(ctx, dat_bi); #else /* always a decryption */ decrypted_bi = RSA_private(ctx, dat_bi); #endif /* convert to a normal block */ bi_export(ctx->bi_ctx, decrypted_bi, block, byte_size); i = 10; /* start at the first possible non-padded byte */ #ifdef CONFIG_SSL_CERT_VERIFICATION if (is_decryption == 0) /* PKCS1.5 signing pads with "0xff"s */ { while (block[i++] == 0xff && i < byte_size); if (block[i-2] != 0xff) i = byte_size; /*ensure size is 0 */ } else /* PKCS1.5 encryption padding is random */ #endif { while (block[i++] && i < byte_size); } size = byte_size - i; /* get only the bit we want */ if (size > 0) os_memcpy(out_data, &block[i], size); os_free(block); return size ? size : -1; } /** * Performs m = c^d mod n */ bigint *ICACHE_FLASH_ATTR RSA_private(const RSA_CTX *c, bigint *bi_msg) { #ifdef CONFIG_BIGINT_CRT return bi_crt(c->bi_ctx, bi_msg, c->dP, c->dQ, c->p, c->q, c->qInv); #else BI_CTX *ctx = c->bi_ctx; ctx->mod_offset = BIGINT_M_OFFSET; return bi_mod_power(ctx, bi_msg, c->d); #endif } #ifdef CONFIG_SSL_FULL_MODE /** * Used for diagnostics. */ void ICACHE_FLASH_ATTR RSA_print(const RSA_CTX *rsa_ctx) { if (rsa_ctx == NULL) return; ssl_printf("----------------- RSA DEBUG ----------------\n"); ssl_printf("Size:\t%d\n", rsa_ctx->num_octets); bi_print("Modulus", rsa_ctx->m); bi_print("Public Key", rsa_ctx->e); bi_print("Private Key", rsa_ctx->d); } #endif #if defined(CONFIG_SSL_CERT_VERIFICATION) || defined(CONFIG_SSL_GENERATE_X509_CERT) /** * Performs c = m^e mod n */ bigint *ICACHE_FLASH_ATTR RSA_public(const RSA_CTX * c, bigint *bi_msg) { c->bi_ctx->mod_offset = BIGINT_M_OFFSET; return bi_mod_power(c->bi_ctx, bi_msg, c->e); } /** * Use PKCS1.5 for encryption/signing. * see http://www.rsasecurity.com/rsalabs/node.asp?id=2125 */ int ICACHE_FLASH_ATTR RSA_encrypt(const RSA_CTX *ctx, const uint8_t *in_data, uint16_t in_len, uint8_t *out_data, int is_signing) { int byte_size = ctx->num_octets; int num_pads_needed = byte_size-in_len-3; bigint *dat_bi, *encrypt_bi; /* note: in_len+11 must be > byte_size */ out_data[0] = 0; /* ensure encryption block is < modulus */ if (is_signing) { out_data[1] = 1; /* PKCS1.5 signing pads with "0xff"'s */ os_memset(&out_data[2], 0xff, num_pads_needed); } else /* randomize the encryption padding with non-zero bytes */ { out_data[1] = 2; get_random_NZ(num_pads_needed, &out_data[2]); } out_data[2+num_pads_needed] = 0; os_memcpy(&out_data[3+num_pads_needed], in_data, in_len); /* now encrypt it */ dat_bi = bi_import(ctx->bi_ctx, out_data, byte_size); encrypt_bi = is_signing ? RSA_private(ctx, dat_bi) : RSA_public(ctx, dat_bi); bi_export(ctx->bi_ctx, encrypt_bi, out_data, byte_size); /* save a few bytes of memory */ bi_clear_cache(ctx->bi_ctx); return byte_size; } #endif /* CONFIG_SSL_CERT_VERIFICATION */ ================================================ FILE: app/ssl/crypto/ssl_sha1.c ================================================ /* * Copyright (c) 2007, Cameron Rich * * 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 axTLS project 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. */ /** * SHA1 implementation - as defined in FIPS PUB 180-1 published April 17, 1995. * This code was originally taken from RFC3174 */ //#include #include "ssl/ssl_os_port.h" #include "ssl/ssl_crypto.h" //#include "os.h" #include "lwip/mem.h" /* * Define the SHA1 circular left shift macro */ #define SHA1CircularShift(bits,word) \ (((word) << (bits)) | ((word) >> (32-(bits)))) /* ----- static functions ----- */ static void SHA1PadMessage(SHA1_CTX *ctx); static void SHA1ProcessMessageBlock(SHA1_CTX *ctx); /** * Initialize the SHA1 context */ void ICACHE_FLASH_ATTR SHA1_Init(SHA1_CTX *ctx) { ctx->Length_Low = 0; ctx->Length_High = 0; ctx->Message_Block_Index = 0; ctx->Intermediate_Hash[0] = 0x67452301; ctx->Intermediate_Hash[1] = 0xEFCDAB89; ctx->Intermediate_Hash[2] = 0x98BADCFE; ctx->Intermediate_Hash[3] = 0x10325476; ctx->Intermediate_Hash[4] = 0xC3D2E1F0; } /** * Accepts an array of octets as the next portion of the message. */ void ICACHE_FLASH_ATTR SHA1_Update(SHA1_CTX *ctx, const uint8_t *msg, int len) { while (len--) { ctx->Message_Block[ctx->Message_Block_Index++] = (*msg & 0xFF); ctx->Length_Low += 8; if (ctx->Length_Low == 0) ctx->Length_High++; if (ctx->Message_Block_Index == 64) SHA1ProcessMessageBlock(ctx); msg++; } } /** * Return the 160-bit message digest into the user's array */ void ICACHE_FLASH_ATTR SHA1_Final(uint8_t *digest, SHA1_CTX *ctx) { int i; SHA1PadMessage(ctx); os_memset(ctx->Message_Block, 0, 64); ctx->Length_Low = 0; /* and clear length */ ctx->Length_High = 0; for (i = 0; i < SHA1_SIZE; i++) { digest[i] = ctx->Intermediate_Hash[i>>2] >> 8 * ( 3 - ( i & 0x03 ) ); } } /** * Process the next 512 bits of the message stored in the array. */ static void ICACHE_FLASH_ATTR SHA1ProcessMessageBlock(SHA1_CTX *ctx) { const uint32_t K[] = { /* Constants defined in SHA-1 */ 0x5A827999, 0x6ED9EBA1, 0x8F1BBCDC, 0xCA62C1D6 }; int t; /* Loop counter */ uint32_t temp; /* Temporary word value */ uint32_t W[80]; /* Word sequence */ uint32_t A, B, C, D, E; /* Word buffers */ /* * Initialize the first 16 words in the array W */ for (t = 0; t < 16; t++) { W[t] = ctx->Message_Block[t * 4] << 24; W[t] |= ctx->Message_Block[t * 4 + 1] << 16; W[t] |= ctx->Message_Block[t * 4 + 2] << 8; W[t] |= ctx->Message_Block[t * 4 + 3]; } for (t = 16; t < 80; t++) { W[t] = SHA1CircularShift(1,W[t-3] ^ W[t-8] ^ W[t-14] ^ W[t-16]); } A = ctx->Intermediate_Hash[0]; B = ctx->Intermediate_Hash[1]; C = ctx->Intermediate_Hash[2]; D = ctx->Intermediate_Hash[3]; E = ctx->Intermediate_Hash[4]; for (t = 0; t < 20; t++) { temp = SHA1CircularShift(5,A) + ((B & C) | ((~B) & D)) + E + W[t] + K[0]; E = D; D = C; C = SHA1CircularShift(30,B); B = A; A = temp; } for (t = 20; t < 40; t++) { temp = SHA1CircularShift(5,A) + (B ^ C ^ D) + E + W[t] + K[1]; E = D; D = C; C = SHA1CircularShift(30,B); B = A; A = temp; } for (t = 40; t < 60; t++) { temp = SHA1CircularShift(5,A) + ((B & C) | (B & D) | (C & D)) + E + W[t] + K[2]; E = D; D = C; C = SHA1CircularShift(30,B); B = A; A = temp; } for (t = 60; t < 80; t++) { temp = SHA1CircularShift(5,A) + (B ^ C ^ D) + E + W[t] + K[3]; E = D; D = C; C = SHA1CircularShift(30,B); B = A; A = temp; } ctx->Intermediate_Hash[0] += A; ctx->Intermediate_Hash[1] += B; ctx->Intermediate_Hash[2] += C; ctx->Intermediate_Hash[3] += D; ctx->Intermediate_Hash[4] += E; ctx->Message_Block_Index = 0; } /* * According to the standard, the message must be padded to an even * 512 bits. The first padding bit must be a '1'. The last 64 * bits represent the length of the original message. All bits in * between should be 0. This function will pad the message * according to those rules by filling the Message_Block array * accordingly. It will also call the ProcessMessageBlock function * provided appropriately. When it returns, it can be assumed that * the message digest has been computed. * * @param ctx [in, out] The SHA1 context */ static void ICACHE_FLASH_ATTR SHA1PadMessage(SHA1_CTX *ctx) { /* * Check to see if the current message block is too small to hold * the initial padding bits and length. If so, we will pad the * block, process it, and then continue padding into a second * block. */ if (ctx->Message_Block_Index > 55) { ctx->Message_Block[ctx->Message_Block_Index++] = 0x80; while(ctx->Message_Block_Index < 64) { ctx->Message_Block[ctx->Message_Block_Index++] = 0; } SHA1ProcessMessageBlock(ctx); while (ctx->Message_Block_Index < 56) { ctx->Message_Block[ctx->Message_Block_Index++] = 0; } } else { ctx->Message_Block[ctx->Message_Block_Index++] = 0x80; while(ctx->Message_Block_Index < 56) { ctx->Message_Block[ctx->Message_Block_Index++] = 0; } } /* * Store the message length as the last 8 octets */ ctx->Message_Block[56] = ctx->Length_High >> 24; ctx->Message_Block[57] = ctx->Length_High >> 16; ctx->Message_Block[58] = ctx->Length_High >> 8; ctx->Message_Block[59] = ctx->Length_High; ctx->Message_Block[60] = ctx->Length_Low >> 24; ctx->Message_Block[61] = ctx->Length_Low >> 16; ctx->Message_Block[62] = ctx->Length_Low >> 8; ctx->Message_Block[63] = ctx->Length_Low; SHA1ProcessMessageBlock(ctx); } ================================================ FILE: app/ssl/ssl/Makefile ================================================ ############################################################# # Required variables for each makefile # Discard this section from all parent makefiles # Expected variables (with automatic defaults): # CSRCS (all "C" files in the dir) # SUBDIRS (all subdirs with a Makefile) # GEN_LIBS - list of libs to be generated () # GEN_IMAGES - list of images to be generated () # COMPONENTS_xxx - a list of libs/objs in the form # subdir/lib to be extracted and rolled up into # a generated lib/image xxx.a () # ifndef PDIR GEN_LIBS = libsslssl.a endif ############################################################# # Configuration i.e. compile options etc. # Target specific stuff (defines etc.) goes in here! # Generally values applying to a tree are captured in the # makefile at its root level - these are then overridden # for a subtree within the makefile rooted therein # #DEFINES += ############################################################# # Recursion Magic - Don't touch this!! # # Each subtree potentially has an include directory # corresponding to the common APIs applicable to modules # rooted at that subtree. Accordingly, the INCLUDE PATH # of a module can only contain the include directories up # its parent path, and not its siblings # # Required for each makefile to inherit from the parent # INCLUDES := $(INCLUDES) -I $(PDIR)include INCLUDES += -I ./ PDIR := ../$(PDIR) sinclude $(PDIR)Makefile ================================================ FILE: app/ssl/ssl/ssl_asn1.c ================================================ /* * Copyright (c) 2007, Cameron Rich * * 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 axTLS project 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. */ /** * Some primitive asn methods for extraction ASN.1 data. */ //#include //#include //#include //#include #include "ssl/ssl_os_port.h" #include "ssl/ssl_crypto.h" #include "ssl/ssl_crypto_misc.h" //#include "os.h" #include "lwip/mem.h" struct tm { int tm_sec; /* Seconds. [0-60] (1 leap second) */ int tm_min; /* Minutes. [0-59] */ int tm_hour; /* Hours. [0-23] */ int tm_mday; /* Day. [1-31] */ int tm_mon; /* Month. [0-11] */ int tm_year; /* Year - 1900. */ int tm_wday; /* Day of week. [0-6] */ int tm_yday; /* Days in year.[0-365] */ int tm_isdst; /* DST. [-1/0/1]*/ #ifdef __USE_BSD long int tm_gmtoff; /* Seconds east of UTC. */ __const char *tm_zone; /* Timezone abbreviation. */ #else long int __tm_gmtoff; /* Seconds east of UTC. */ __const char *__tm_zone; /* Timezone abbreviation. */ #endif }; #define SIG_OID_PREFIX_SIZE 8 #define SIG_IIS6_OID_SIZE 5 #define SIG_SUBJECT_ALT_NAME_SIZE 3 /* Must be an RSA algorithm with either SHA1 or MD5 for verifying to work */ static const uint8_t sig_oid_prefix[SIG_OID_PREFIX_SIZE] = { 0x2a, 0x86, 0x48, 0x86, 0xf7, 0x0d, 0x01, 0x01 }; static const uint8_t sig_sha1WithRSAEncrypt[SIG_IIS6_OID_SIZE] = { 0x2b, 0x0e, 0x03, 0x02, 0x1d }; static const uint8_t sig_subject_alt_name[SIG_SUBJECT_ALT_NAME_SIZE] = { 0x55, 0x1d, 0x11 }; /* CN, O, OU */ static const uint8_t g_dn_types[] = { 3, 10, 11 }; int ICACHE_FLASH_ATTR get_asn1_length(const uint8_t *buf, int *offset) { int len, i; if (!(buf[*offset] & 0x80)) /* short form */ { len = buf[(*offset)++]; } else /* long form */ { int length_bytes = buf[(*offset)++]&0x7f; len = 0; for (i = 0; i < length_bytes; i++) { len <<= 8; len += buf[(*offset)++]; } } return len; } /** * Skip the ASN1.1 object type and its length. Get ready to read the object's * data. */ int ICACHE_FLASH_ATTR asn1_next_obj(const uint8_t *buf, int *offset, int obj_type) { if (buf[*offset] != obj_type) return X509_NOT_OK; (*offset)++; return get_asn1_length(buf, offset); } /** * Skip over an ASN.1 object type completely. Get ready to read the next * object. */ int ICACHE_FLASH_ATTR asn1_skip_obj(const uint8_t *buf, int *offset, int obj_type) { int len; if (buf[*offset] != obj_type) return X509_NOT_OK; (*offset)++; len = get_asn1_length(buf, offset); *offset += len; return 0; } /** * Read an integer value for ASN.1 data * Note: This function allocates memory which must be freed by the user. */ int ICACHE_FLASH_ATTR asn1_get_int(const uint8_t *buf, int *offset, uint8_t **object) { int len; if ((len = asn1_next_obj(buf, offset, ASN1_INTEGER)) < 0) goto end_int_array; if (len > 1 && buf[*offset] == 0x00) /* ignore the negative byte */ { len--; (*offset)++; } *object = (uint8_t *)os_malloc(len); os_memcpy(*object, &buf[*offset], len); *offset += len; end_int_array: return len; } /** * Get all the RSA private key specifics from an ASN.1 encoded file */ int ICACHE_FLASH_ATTR asn1_get_private_key(const uint8_t *buf, int len, RSA_CTX **rsa_ctx) { int offset = 7; uint8_t *modulus = NULL, *priv_exp = NULL, *pub_exp = NULL; int mod_len, priv_len, pub_len; #ifdef CONFIG_BIGINT_CRT uint8_t *p = NULL, *q = NULL, *dP = NULL, *dQ = NULL, *qInv = NULL; int p_len, q_len, dP_len, dQ_len, qInv_len; #endif /* not in der format */ if (buf[0] != ASN1_SEQUENCE) /* basic sanity check */ { #ifdef CONFIG_SSL_FULL_MODE ssl_printf("Error: This is not a valid ASN.1 file\n"); #endif return X509_INVALID_PRIV_KEY; } /* Use the private key to mix up the RNG if possible. */ RNG_custom_init(buf, len); mod_len = asn1_get_int(buf, &offset, &modulus); pub_len = asn1_get_int(buf, &offset, &pub_exp); priv_len = asn1_get_int(buf, &offset, &priv_exp); if (mod_len <= 0 || pub_len <= 0 || priv_len <= 0) return X509_INVALID_PRIV_KEY; #ifdef CONFIG_BIGINT_CRT p_len = asn1_get_int(buf, &offset, &p); q_len = asn1_get_int(buf, &offset, &q); dP_len = asn1_get_int(buf, &offset, &dP); dQ_len = asn1_get_int(buf, &offset, &dQ); qInv_len = asn1_get_int(buf, &offset, &qInv); if (p_len <= 0 || q_len <= 0 || dP_len <= 0 || dQ_len <= 0 || qInv_len <= 0) return X509_INVALID_PRIV_KEY; RSA_priv_key_new(rsa_ctx, modulus, mod_len, pub_exp, pub_len, priv_exp, priv_len, p, p_len, q, p_len, dP, dP_len, dQ, dQ_len, qInv, qInv_len); os_free(p); os_free(q); os_free(dP); os_free(dQ); os_free(qInv); #else RSA_priv_key_new(rsa_ctx, modulus, mod_len, pub_exp, pub_len, priv_exp, priv_len); #endif os_free(modulus); os_free(priv_exp); os_free(pub_exp); return X509_OK; } /** * Get the time of a certificate. Ignore hours/minutes/seconds. */ static int ICACHE_FLASH_ATTR asn1_get_utc_time(const uint8_t *buf, int *offset, time_t *t) { int ret = X509_NOT_OK, len, t_offset; struct tm tm; if (buf[(*offset)++] != ASN1_UTC_TIME) goto end_utc_time; len = get_asn1_length(buf, offset); t_offset = *offset; os_memset(&tm, 0, sizeof(struct tm)); tm.tm_year = (buf[t_offset] - '0')*10 + (buf[t_offset+1] - '0'); if (tm.tm_year <= 50) /* 1951-2050 thing */ { tm.tm_year += 100; } tm.tm_mon = (buf[t_offset+2] - '0')*10 + (buf[t_offset+3] - '0') - 1; tm.tm_mday = (buf[t_offset+4] - '0')*10 + (buf[t_offset+5] - '0'); // wujg : pass compile first // *t = mktime(&tm); *offset += len; ret = X509_OK; end_utc_time: return ret; } /** * Get the version type of a certificate (which we don't actually care about) */ int ICACHE_FLASH_ATTR asn1_version(const uint8_t *cert, int *offset, X509_CTX *x509_ctx) { int ret = X509_NOT_OK; (*offset) += 2; /* get past explicit tag */ if (asn1_skip_obj(cert, offset, ASN1_INTEGER)) goto end_version; ret = X509_OK; end_version: return ret; } /** * Retrieve the notbefore and notafter certificate times. */ int ICACHE_FLASH_ATTR asn1_validity(const uint8_t *cert, int *offset, X509_CTX *x509_ctx) { return (asn1_next_obj(cert, offset, ASN1_SEQUENCE) < 0 || asn1_get_utc_time(cert, offset, &x509_ctx->not_before) || asn1_get_utc_time(cert, offset, &x509_ctx->not_after)); } /** * Get the components of a distinguished name */ static int ICACHE_FLASH_ATTR asn1_get_oid_x520(const uint8_t *buf, int *offset) { int dn_type = 0; int len; if ((len = asn1_next_obj(buf, offset, ASN1_OID)) < 0) goto end_oid; /* expect a sequence of 2.5.4.[x] where x is a one of distinguished name components we are interested in. */ if (len == 3 && buf[(*offset)++] == 0x55 && buf[(*offset)++] == 0x04) dn_type = buf[(*offset)++]; else { *offset += len; /* skip over it */ } end_oid: return dn_type; } /** * Obtain an ASN.1 printable string type. */ static int ICACHE_FLASH_ATTR asn1_get_printable_str(const uint8_t *buf, int *offset, char **str) { int len = X509_NOT_OK; int asn1_type = buf[*offset]; /* some certs have this awful crud in them for some reason */ if (asn1_type != ASN1_PRINTABLE_STR && asn1_type != ASN1_PRINTABLE_STR2 && asn1_type != ASN1_TELETEX_STR && asn1_type != ASN1_IA5_STR && asn1_type != ASN1_UNICODE_STR) goto end_pnt_str; (*offset)++; len = get_asn1_length(buf, offset); if (asn1_type == ASN1_UNICODE_STR) { int i; *str = (char *)os_malloc(len/2+1); /* allow for null */ for (i = 0; i < len; i += 2) (*str)[i/2] = buf[*offset + i + 1]; (*str)[len/2] = 0; /* null terminate */ } else { *str = (char *)os_malloc(len+1); /* allow for null */ os_memcpy(*str, &buf[*offset], len); (*str)[len] = 0; /* null terminate */ } *offset += len; end_pnt_str: return len; } /** * Get the subject name (or the issuer) of a certificate. */ int ICACHE_FLASH_ATTR asn1_name(const uint8_t *cert, int *offset, char *dn[]) { int ret = X509_NOT_OK; int dn_type; char *tmp; if (asn1_next_obj(cert, offset, ASN1_SEQUENCE) < 0) goto end_name; while (asn1_next_obj(cert, offset, ASN1_SET) >= 0) { int i, found = 0; if (asn1_next_obj(cert, offset, ASN1_SEQUENCE) < 0 || (dn_type = asn1_get_oid_x520(cert, offset)) < 0) goto end_name; tmp = NULL; if (asn1_get_printable_str(cert, offset, &tmp) < 0) { os_free(tmp); goto end_name; } /* find the distinguished named type */ for (i = 0; i < X509_NUM_DN_TYPES; i++) { if (dn_type == g_dn_types[i]) { if (dn[i] == NULL) { dn[i] = tmp; found = 1; break; } } } if (found == 0) /* not found so get rid of it */ { os_free(tmp); } } ret = X509_OK; end_name: return ret; } /** * Read the modulus and public exponent of a certificate. */ int ICACHE_FLASH_ATTR asn1_public_key(const uint8_t *cert, int *offset, X509_CTX *x509_ctx) { int ret = X509_NOT_OK, mod_len, pub_len; uint8_t *modulus = NULL, *pub_exp = NULL; if (asn1_next_obj(cert, offset, ASN1_SEQUENCE) < 0 || asn1_skip_obj(cert, offset, ASN1_SEQUENCE) || asn1_next_obj(cert, offset, ASN1_BIT_STRING) < 0) goto end_pub_key; (*offset)++; /* ignore the padding bit field */ if (asn1_next_obj(cert, offset, ASN1_SEQUENCE) < 0) goto end_pub_key; mod_len = asn1_get_int(cert, offset, &modulus); pub_len = asn1_get_int(cert, offset, &pub_exp); RSA_pub_key_new(&x509_ctx->rsa_ctx, modulus, mod_len, pub_exp, pub_len); os_free(modulus); os_free(pub_exp); ret = X509_OK; end_pub_key: return ret; } #ifdef CONFIG_SSL_CERT_VERIFICATION /** * Read the signature of the certificate. */ int ICACHE_FLASH_ATTR asn1_signature(const uint8_t *cert, int *offset, X509_CTX *x509_ctx) { int ret = X509_NOT_OK; if (cert[(*offset)++] != ASN1_BIT_STRING) goto end_sig; x509_ctx->sig_len = get_asn1_length(cert, offset)-1; (*offset)++; /* ignore bit string padding bits */ x509_ctx->signature = (uint8_t *)os_malloc(x509_ctx->sig_len); os_memcpy(x509_ctx->signature, &cert[*offset], x509_ctx->sig_len); *offset += x509_ctx->sig_len; ret = X509_OK; end_sig: return ret; } /* * Compare 2 distinguished name components for equality * @return 0 if a match */ static int ICACHE_FLASH_ATTR asn1_compare_dn_comp(const char *dn1, const char *dn2) { int ret; if (dn1 == NULL && dn2 == NULL) ret = 0; else ret = (dn1 && dn2) ? os_strcmp(dn1, dn2) : 1; return ret; } /** * Clean up all of the CA certificates. */ void ICACHE_FLASH_ATTR remove_ca_certs(CA_CERT_CTX *ca_cert_ctx) { int i = 0; if (ca_cert_ctx == NULL) return; while (i < CONFIG_X509_MAX_CA_CERTS && ca_cert_ctx->cert[i]) { x509_free(ca_cert_ctx->cert[i]); ca_cert_ctx->cert[i++] = NULL; } os_free(ca_cert_ctx); } /* * Compare 2 distinguished names for equality * @return 0 if a match */ int ICACHE_FLASH_ATTR asn1_compare_dn(char * const dn1[], char * const dn2[]) { int i; for (i = 0; i < X509_NUM_DN_TYPES; i++) { if (asn1_compare_dn_comp(dn1[i], dn2[i])) return 1; } return 0; /* all good */ } int ICACHE_FLASH_ATTR asn1_find_oid(const uint8_t* cert, int* offset, const uint8_t* oid, int oid_length) { int seqlen; if ((seqlen = asn1_next_obj(cert, offset, ASN1_SEQUENCE))> 0) { int end = *offset + seqlen; while (*offset < end) { int type = cert[(*offset)++]; int length = get_asn1_length(cert, offset); int noffset = *offset + length; if (type == ASN1_SEQUENCE) { type = cert[(*offset)++]; length = get_asn1_length(cert, offset); if (type == ASN1_OID && length == oid_length && os_memcmp(cert + *offset, oid, oid_length) == 0) { *offset += oid_length; return 1; } } *offset = noffset; } } return 0; } int ICACHE_FLASH_ATTR asn1_find_subjectaltname(const uint8_t* cert, int offset) { if (asn1_find_oid(cert, &offset, sig_subject_alt_name, SIG_SUBJECT_ALT_NAME_SIZE)) { return offset; } return 0; } #endif /* CONFIG_SSL_CERT_VERIFICATION */ /** * Read the signature type of the certificate. We only support RSA-MD5 and * RSA-SHA1 signature types. */ int ICACHE_FLASH_ATTR asn1_signature_type(const uint8_t *cert, int *offset, X509_CTX *x509_ctx) { int ret = X509_NOT_OK, len; if (cert[(*offset)++] != ASN1_OID) goto end_check_sig; len = get_asn1_length(cert, offset); if (len == 5 && os_memcmp(sig_sha1WithRSAEncrypt, &cert[*offset], SIG_IIS6_OID_SIZE) == 0) { x509_ctx->sig_type = SIG_TYPE_SHA1; } else { if (os_memcmp(sig_oid_prefix, &cert[*offset], SIG_OID_PREFIX_SIZE)) goto end_check_sig; /* unrecognised cert type */ x509_ctx->sig_type = cert[*offset + SIG_OID_PREFIX_SIZE]; } *offset += len; asn1_skip_obj(cert, offset, ASN1_NULL); /* if it's there */ ret = X509_OK; end_check_sig: return ret; } ================================================ FILE: app/ssl/ssl/ssl_gen_cert.c ================================================ /* * Copyright (c) 2007, Cameron Rich * * 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 axTLS project 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 "ssl/ssl_config.h" #ifdef CONFIG_SSL_GENERATE_X509_CERT #include #include #include "ssl/ssl_os_port.h" #include "ssl/ssl_ssl.h" /** * Generate a basic X.509 certificate */ static uint8_t ICACHE_FLASH_ATTR set_gen_length(int len, uint8_t *buf, int *offset) { if (len < 0x80) /* short form */ { buf[(*offset)++] = len; return 1; } else /* long form */ { int i, length_bytes = 0; if (len & 0x00FF0000) length_bytes = 3; else if (len & 0x0000FF00) length_bytes = 2; else if (len & 0x000000FF) length_bytes = 1; buf[(*offset)++] = 0x80 + length_bytes; for (i = length_bytes-1; i >= 0; i--) { buf[*offset+i] = len & 0xFF; len >>= 8; } *offset += length_bytes; return length_bytes+1; } } static int ICACHE_FLASH_ATTR pre_adjust_with_size(uint8_t type, int *seq_offset, uint8_t *buf, int *offset) { buf[(*offset)++] = type; *seq_offset = *offset; *offset += 4; /* fill in later */ return *offset; } static void ICACHE_FLASH_ATTR adjust_with_size(int seq_size, int seq_start, uint8_t *buf, int *offset) { uint8_t seq_byte_size; int orig_seq_size = seq_size; int orig_seq_start = seq_start; seq_size = *offset-seq_size; seq_byte_size = set_gen_length(seq_size, buf, &seq_start); if (seq_byte_size != 4) { memmove(&buf[orig_seq_start+seq_byte_size], &buf[orig_seq_size], seq_size); *offset -= 4-seq_byte_size; } } static void ICACHE_FLASH_ATTR gen_serial_number(uint8_t *buf, int *offset) { static const uint8_t ser_oid[] = { ASN1_INTEGER, 1, 0x7F }; memcpy(&buf[*offset], ser_oid , sizeof(ser_oid)); *offset += sizeof(ser_oid); } static void ICACHE_FLASH_ATTR gen_signature_alg(uint8_t *buf, int *offset) { /* OBJECT IDENTIFIER sha1withRSAEncryption (1 2 840 113549 1 1 5) */ static const uint8_t sig_oid[] = { ASN1_SEQUENCE, 0x0d, ASN1_OID, 0x09, 0x2a, 0x86, 0x48, 0x86, 0xf7, 0x0d, 0x01, 0x01, 0x05, ASN1_NULL, 0x00 }; memcpy(&buf[*offset], sig_oid, sizeof(sig_oid)); *offset += sizeof(sig_oid); } static int ICACHE_FLASH_ATTR gen_dn(const char *name, uint8_t dn_type, uint8_t *buf, int *offset) { int ret = X509_OK; int name_size = strlen(name); if (name_size > 0x70) /* just too big */ { ret = X509_NOT_OK; goto error; } buf[(*offset)++] = ASN1_SET; set_gen_length(9+name_size, buf, offset); buf[(*offset)++] = ASN1_SEQUENCE; set_gen_length(7+name_size, buf, offset); buf[(*offset)++] = ASN1_OID; buf[(*offset)++] = 3; buf[(*offset)++] = 0x55; buf[(*offset)++] = 0x04; buf[(*offset)++] = dn_type; buf[(*offset)++] = ASN1_PRINTABLE_STR; buf[(*offset)++] = name_size; strcpy(&buf[*offset], name); *offset += name_size; error: return ret; } static int ICACHE_FLASH_ATTR gen_issuer(const char * dn[], uint8_t *buf, int *offset) { int ret = X509_OK; int seq_offset; int seq_size = pre_adjust_with_size( ASN1_SEQUENCE, &seq_offset, buf, offset); char fqdn[128]; /* we need the common name, so if not configured, work out the fully * qualified domain name */ if (dn[X509_COMMON_NAME] == NULL || strlen(dn[X509_COMMON_NAME]) == 0) { int fqdn_len; gethostname(fqdn, sizeof(fqdn)); fqdn_len = strlen(fqdn); fqdn[fqdn_len++] = '.'; getdomainname(&fqdn[fqdn_len], sizeof(fqdn)-fqdn_len); fqdn_len = strlen(fqdn); if (fqdn[fqdn_len-1] == '.') /* ensure '.' is not last char */ fqdn[fqdn_len-1] = 0; dn[X509_COMMON_NAME] = fqdn; } if ((ret = gen_dn(dn[X509_COMMON_NAME], 3, buf, offset))) goto error; if (dn[X509_ORGANIZATION] != NULL && strlen(dn[X509_ORGANIZATION]) > 0) { if ((ret = gen_dn(dn[X509_ORGANIZATION], 10, buf, offset))) goto error; } if (dn[X509_ORGANIZATIONAL_UNIT] != NULL && strlen(dn[X509_ORGANIZATIONAL_UNIT]) > 0) { if ((ret = gen_dn(dn[X509_ORGANIZATIONAL_UNIT], 11, buf, offset))) goto error; } adjust_with_size(seq_size, seq_offset, buf, offset); error: return ret; } static void ICACHE_FLASH_ATTR gen_utc_time(uint8_t *buf, int *offset) { static const uint8_t time_seq[] = { ASN1_SEQUENCE, 30, ASN1_UTC_TIME, 13, '0', '7', '0', '1', '0', '1', '0', '0', '0', '0', '0', '0', 'Z', ASN1_UTC_TIME, 13, /* make it good for 30 or so years */ '3', '8', '0', '1', '0', '1', '0', '0', '0', '0', '0', '0', 'Z' }; /* fixed time */ memcpy(&buf[*offset], time_seq, sizeof(time_seq)); *offset += sizeof(time_seq); } static void ICACHE_FLASH_ATTR gen_pub_key2(const RSA_CTX *rsa_ctx, uint8_t *buf, int *offset) { static const uint8_t pub_key_seq[] = { ASN1_INTEGER, 0x03, 0x01, 0x00, 0x01 /* INTEGER 65537 */ }; int seq_offset; int pub_key_size = rsa_ctx->num_octets; uint8_t *block = (uint8_t *)alloca(pub_key_size); int seq_size = pre_adjust_with_size( ASN1_SEQUENCE, &seq_offset, buf, offset); buf[(*offset)++] = ASN1_INTEGER; bi_export(rsa_ctx->bi_ctx, rsa_ctx->m, block, pub_key_size); if (*block & 0x80) /* make integer positive */ { set_gen_length(pub_key_size+1, buf, offset); buf[(*offset)++] = 0; } else set_gen_length(pub_key_size, buf, offset); memcpy(&buf[*offset], block, pub_key_size); *offset += pub_key_size; memcpy(&buf[*offset], pub_key_seq, sizeof(pub_key_seq)); *offset += sizeof(pub_key_seq); adjust_with_size(seq_size, seq_offset, buf, offset); } static void ICACHE_FLASH_ATTR gen_pub_key1(const RSA_CTX *rsa_ctx, uint8_t *buf, int *offset) { int seq_offset; int seq_size = pre_adjust_with_size( ASN1_BIT_STRING, &seq_offset, buf, offset); buf[(*offset)++] = 0; /* bit string is multiple of 8 */ gen_pub_key2(rsa_ctx, buf, offset); adjust_with_size(seq_size, seq_offset, buf, offset); } static void ICACHE_FLASH_ATTR gen_pub_key(const RSA_CTX *rsa_ctx, uint8_t *buf, int *offset) { /* OBJECT IDENTIFIER rsaEncryption (1 2 840 113549 1 1 1) */ static const uint8_t rsa_enc_oid[] = { ASN1_SEQUENCE, 0x0d, ASN1_OID, 0x09, 0x2a, 0x86, 0x48, 0x86, 0xf7, 0x0d, 0x01, 0x01, 0x01, ASN1_NULL, 0x00 }; int seq_offset; int seq_size = pre_adjust_with_size( ASN1_SEQUENCE, &seq_offset, buf, offset); memcpy(&buf[*offset], rsa_enc_oid, sizeof(rsa_enc_oid)); *offset += sizeof(rsa_enc_oid); gen_pub_key1(rsa_ctx, buf, offset); adjust_with_size(seq_size, seq_offset, buf, offset); } static void ICACHE_FLASH_ATTR gen_signature(const RSA_CTX *rsa_ctx, const uint8_t *sha_dgst, uint8_t *buf, int *offset) { static const uint8_t asn1_sig[] = { ASN1_SEQUENCE, 0x21, ASN1_SEQUENCE, 0x09, ASN1_OID, 0x05, 0x2b, 0x0e, 0x03, 0x02, 0x1a, /* sha1 (1 3 14 3 2 26) */ ASN1_NULL, 0x00, ASN1_OCTET_STRING, 0x14 }; uint8_t *enc_block = (uint8_t *)alloca(rsa_ctx->num_octets); uint8_t *block = (uint8_t *)alloca(sizeof(asn1_sig) + SHA1_SIZE); int sig_size; /* add the digest as an embedded asn.1 sequence */ memcpy(block, asn1_sig, sizeof(asn1_sig)); memcpy(&block[sizeof(asn1_sig)], sha_dgst, SHA1_SIZE); sig_size = RSA_encrypt(rsa_ctx, block, sizeof(asn1_sig) + SHA1_SIZE, enc_block, 1); buf[(*offset)++] = ASN1_BIT_STRING; set_gen_length(sig_size+1, buf, offset); buf[(*offset)++] = 0; /* bit string is multiple of 8 */ memcpy(&buf[*offset], enc_block, sig_size); *offset += sig_size; } static int ICACHE_FLASH_ATTR gen_tbs_cert(const char * dn[], const RSA_CTX *rsa_ctx, uint8_t *buf, int *offset, uint8_t *sha_dgst) { int ret = X509_OK; SHA1_CTX sha_ctx; int seq_offset; int begin_tbs = *offset; int seq_size = pre_adjust_with_size( ASN1_SEQUENCE, &seq_offset, buf, offset); gen_serial_number(buf, offset); gen_signature_alg(buf, offset); /* CA certicate issuer */ if ((ret = gen_issuer(dn, buf, offset))) goto error; gen_utc_time(buf, offset); /* certificate issuer */ if ((ret = gen_issuer(dn, buf, offset))) goto error; gen_pub_key(rsa_ctx, buf, offset); adjust_with_size(seq_size, seq_offset, buf, offset); SHA1_Init(&sha_ctx); SHA1_Update(&sha_ctx, &buf[begin_tbs], *offset-begin_tbs); SHA1_Final(sha_dgst, &sha_ctx); error: return ret; } /** * Create a new certificate. */ EXP_FUNC int ICACHE_FLASH_ATTR STDCALL ssl_x509_create(SSL_CTX *ssl_ctx, uint32_t options, const char * dn[], uint8_t **cert_data) { int ret = X509_OK, offset = 0, seq_offset; /* allocate enough space to load a new certificate */ uint8_t *buf = (uint8_t *)alloca(ssl_ctx->rsa_ctx->num_octets*2 + 512); uint8_t sha_dgst[SHA1_SIZE]; int seq_size = pre_adjust_with_size(ASN1_SEQUENCE, &seq_offset, buf, &offset); if ((ret = gen_tbs_cert(dn, ssl_ctx->rsa_ctx, buf, &offset, sha_dgst)) < 0) goto error; gen_signature_alg(buf, &offset); gen_signature(ssl_ctx->rsa_ctx, sha_dgst, buf, &offset); adjust_with_size(seq_size, seq_offset, buf, &offset); *cert_data = (uint8_t *)os_malloc(offset); /* create the exact memory for it */ memcpy(*cert_data, buf, offset); error: return ret < 0 ? ret : offset; } #endif ================================================ FILE: app/ssl/ssl/ssl_loader.c ================================================ /* * Copyright (c) 2007, Cameron Rich * * 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 axTLS project 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. */ /** * Load certificates/keys into memory. These can be in many different formats. * PEM support and other formats can be processed here. * * The PEM private keys may be optionally encrypted with AES128 or AES256. * The encrypted PEM keys were generated with something like: * * openssl genrsa -aes128 -passout pass:abcd -out axTLS.key_aes128.pem 512 */ //#include //#include //#include #include "ssl/ssl_os_port.h" #include "ssl/ssl_ssl.h" static int do_obj(SSL_CTX *ssl_ctx, int obj_type, SSLObjLoader *ssl_obj, const char *password); #ifdef CONFIG_SSL_HAS_PEM static int ssl_obj_PEM_load(SSL_CTX *ssl_ctx, int obj_type, SSLObjLoader *ssl_obj, const char *password); #endif /* * Load a file into memory that is in binary DER (or ascii PEM) format. */ EXP_FUNC int STDCALL ICACHE_FLASH_ATTR ssl_obj_load(SSL_CTX *ssl_ctx, int obj_type, const char *filename, const char *password) { #ifndef CONFIG_SSL_SKELETON_MODE static const char * const begin = "-----BEGIN"; int ret = SSL_OK; SSLObjLoader *ssl_obj = NULL; if (filename == NULL) { ret = SSL_ERROR_INVALID_KEY; goto error; } ssl_obj = (SSLObjLoader *)os_zalloc(sizeof(SSLObjLoader)); ssl_obj->len = get_file(filename, &ssl_obj->buf); if (ssl_obj->len <= 0) { ret = SSL_ERROR_INVALID_KEY; goto error; } /* is the file a PEM file? */ if ((char *)os_strstr((const char *)ssl_obj->buf, begin) != NULL) { #ifdef CONFIG_SSL_HAS_PEM ret = ssl_obj_PEM_load(ssl_ctx, obj_type, ssl_obj, password); #else ssl_printf(unsupported_str); ret = SSL_ERROR_NOT_SUPPORTED; #endif } else ret = do_obj(ssl_ctx, obj_type, ssl_obj, password); error: ssl_obj_free(ssl_obj); return ret; #else ssl_printf(unsupported_str); return SSL_ERROR_NOT_SUPPORTED; #endif /* CONFIG_SSL_SKELETON_MODE */ } /* * Transfer binary data into the object loader. */ EXP_FUNC int STDCALL ICACHE_FLASH_ATTR ssl_obj_memory_load(SSL_CTX *ssl_ctx, int mem_type, const uint8_t *data, int len, const char *password) { int ret; SSLObjLoader *ssl_obj; ssl_obj = (SSLObjLoader *)os_zalloc(sizeof(SSLObjLoader)); ssl_obj->buf = (uint8_t *)os_malloc(len); os_memcpy(ssl_obj->buf, data, len); ssl_obj->len = len; ret = do_obj(ssl_ctx, mem_type, ssl_obj, password); ssl_obj_free(ssl_obj); return ret; } /* * Actually work out what we are doing */ static int ICACHE_FLASH_ATTR do_obj(SSL_CTX *ssl_ctx, int obj_type, SSLObjLoader *ssl_obj, const char *password) { int ret = SSL_OK; switch (obj_type) { case SSL_OBJ_RSA_KEY: ret = add_private_key(ssl_ctx, ssl_obj); break; case SSL_OBJ_X509_CERT: ret = add_cert(ssl_ctx, ssl_obj->buf, ssl_obj->len); break; #ifdef CONFIG_SSL_CERT_VERIFICATION case SSL_OBJ_X509_CACERT: add_cert_auth(ssl_ctx, ssl_obj->buf, ssl_obj->len); break; #endif #ifdef CONFIG_SSL_USE_PKCS12 case SSL_OBJ_PKCS8: ret = pkcs8_decode(ssl_ctx, ssl_obj, password); break; case SSL_OBJ_PKCS12: ret = pkcs12_decode(ssl_ctx, ssl_obj, password); break; #endif default: ssl_printf(unsupported_str); ret = SSL_ERROR_NOT_SUPPORTED; break; } return ret; } /* * Clean up our mess. */ void ICACHE_FLASH_ATTR ssl_obj_free(SSLObjLoader *ssl_obj) { if (ssl_obj) { os_free(ssl_obj->buf); os_free(ssl_obj); } } /* * Support for PEM encoded keys/certificates. */ #ifdef CONFIG_SSL_HAS_PEM #define NUM_PEM_TYPES 4 #define IV_SIZE 16 #define IS_RSA_PRIVATE_KEY 0 #define IS_ENCRYPTED_PRIVATE_KEY 1 #define IS_PRIVATE_KEY 2 #define IS_CERTIFICATE 3 static const char * const begins[NUM_PEM_TYPES] = { "-----BEGIN RSA PRIVATE KEY-----", "-----BEGIN ENCRYPTED PRIVATE KEY-----", "-----BEGIN PRIVATE KEY-----", "-----BEGIN CERTIFICATE-----", }; static const char * const ends[NUM_PEM_TYPES] = { "-----END RSA PRIVATE KEY-----", "-----END ENCRYPTED PRIVATE KEY-----", "-----END PRIVATE KEY-----", "-----END CERTIFICATE-----", }; static const char * const aes_str[2] = { "DEK-Info: AES-128-CBC,", "DEK-Info: AES-256-CBC," }; /** * Take a base64 blob of data and decrypt it (using AES) into its * proper ASN.1 form. */ static int ICACHE_FLASH_ATTR pem_decrypt(const char *where, const char *end, const char *password, SSLObjLoader *ssl_obj) { int ret = -1; int is_aes_256 = 0; char *start = NULL; uint8_t iv[IV_SIZE]; int i, pem_size; MD5_CTX md5_ctx; AES_CTX aes_ctx; uint8_t key[32]; /* AES256 size */ if (password == NULL || os_strlen(password) == 0) { #ifdef CONFIG_SSL_FULL_MODE ssl_printf("Error: Need a password for this PEM file\n"); //TTY_FLUSH(); #endif goto error; } if ((start = (char *)os_strstr((const char *)where, aes_str[0]))) /* AES128? */ { start += os_strlen(aes_str[0]); } else if ((start = (char *)os_strstr((const char *)where, aes_str[1]))) /* AES256? */ { is_aes_256 = 1; start += os_strlen(aes_str[1]); } else { #ifdef CONFIG_SSL_FULL_MODE ssl_printf("Error: Unsupported password cipher\n"); //TTY_FLUSH(); #endif goto error; } /* convert from hex to binary - assumes uppercase hex */ for (i = 0; i < IV_SIZE; i++) { char c = *start++ - '0'; iv[i] = (c > 9 ? c + '0' - 'A' + 10 : c) << 4; c = *start++ - '0'; iv[i] += (c > 9 ? c + '0' - 'A' + 10 : c); } while (*start == '\r' || *start == '\n') start++; /* turn base64 into binary */ pem_size = (int)(end-start); if (base64_decode(start, pem_size, ssl_obj->buf, &ssl_obj->len) != 0) goto error; /* work out the key */ MD5_Init(&md5_ctx); MD5_Update(&md5_ctx, (const uint8_t *)password, os_strlen(password)); MD5_Update(&md5_ctx, iv, SALT_SIZE); MD5_Final(key, &md5_ctx); if (is_aes_256) { MD5_Init(&md5_ctx); MD5_Update(&md5_ctx, key, MD5_SIZE); MD5_Update(&md5_ctx, (const uint8_t *)password, os_strlen(password)); MD5_Update(&md5_ctx, iv, SALT_SIZE); MD5_Final(&key[MD5_SIZE], &md5_ctx); } /* decrypt using the key/iv */ AES_set_key(&aes_ctx, key, iv, is_aes_256 ? AES_MODE_256 : AES_MODE_128); AES_convert_key(&aes_ctx); AES_cbc_decrypt(&aes_ctx, ssl_obj->buf, ssl_obj->buf, ssl_obj->len); ret = 0; error: return ret; } /** * Take a base64 blob of data and turn it into its proper ASN.1 form. */ static int ICACHE_FLASH_ATTR new_pem_obj(SSL_CTX *ssl_ctx, int is_cacert, char *where, int remain, const char *password) { int ret = SSL_ERROR_BAD_CERTIFICATE; SSLObjLoader *ssl_obj = NULL; while (remain > 0) { int i, pem_size, obj_type; char *start = NULL, *end = NULL; for (i = 0; i < NUM_PEM_TYPES; i++) { if ((start = (char *)os_strstr(where, begins[i])) && (end = (char *)os_strstr(where, ends[i]))) { remain -= (int)(end-where); start += os_strlen(begins[i]); pem_size = (int)(end-start); ssl_obj = (SSLObjLoader *)os_zalloc(sizeof(SSLObjLoader)); /* 4/3 bigger than what we need but so what */ ssl_obj->buf = (uint8_t *)os_zalloc(pem_size); ssl_obj->len = pem_size; if (i == IS_RSA_PRIVATE_KEY && os_strstr(start, "Proc-Type:") && os_strstr(start, "4,ENCRYPTED")) { /* check for encrypted PEM file */ if (pem_decrypt(start, end, password, ssl_obj) < 0) { ret = SSL_ERROR_BAD_CERTIFICATE; goto error; } } else { ssl_obj->len = pem_size; if (base64_decode(start, pem_size, ssl_obj->buf, &ssl_obj->len) != 0) { ret = SSL_ERROR_BAD_CERTIFICATE; goto error; } } switch (i) { case IS_RSA_PRIVATE_KEY: obj_type = SSL_OBJ_RSA_KEY; break; case IS_ENCRYPTED_PRIVATE_KEY: case IS_PRIVATE_KEY: obj_type = SSL_OBJ_PKCS8; break; case IS_CERTIFICATE: obj_type = is_cacert ? SSL_OBJ_X509_CACERT : SSL_OBJ_X509_CERT; break; default: ret = SSL_ERROR_BAD_CERTIFICATE; goto error; } /* In a format we can now understand - so process it */ if ((ret = do_obj(ssl_ctx, obj_type, ssl_obj, password))) goto error; end += os_strlen(ends[i]); remain -= os_strlen(ends[i]); while (remain > 0 && (*end == '\r' || *end == '\n')) { end++; remain--; } where = end; break; } } ssl_obj_free(ssl_obj); ssl_obj = NULL; if (start == NULL) break; } error: ssl_obj_free(ssl_obj); return ret; } /* * Load a file into memory that is in ASCII PEM format. */ static int ICACHE_FLASH_ATTR ssl_obj_PEM_load(SSL_CTX *ssl_ctx, int obj_type, SSLObjLoader *ssl_obj, const char *password) { char *start; /* add a null terminator */ ssl_obj->len++; ssl_obj->buf = (uint8_t *)os_realloc(ssl_obj->buf, ssl_obj->len); ssl_obj->buf[ssl_obj->len-1] = 0; start = (char *)ssl_obj->buf; return new_pem_obj(ssl_ctx, obj_type == SSL_OBJ_X509_CACERT, start, ssl_obj->len, password); } #endif /* CONFIG_SSL_HAS_PEM */ /** * Load the key/certificates in memory depending on compile-time and user * options. */ int ICACHE_FLASH_ATTR load_key_certs(SSL_CTX *ssl_ctx) { int ret = SSL_OK; uint32_t options = ssl_ctx->options; #ifdef CONFIG_SSL_GENERATE_X509_CERT uint8_t *cert_data = NULL; int cert_size; static const char *dn[] = { CONFIG_SSL_X509_COMMON_NAME, CONFIG_SSL_X509_ORGANIZATION_NAME, CONFIG_SSL_X509_ORGANIZATION_UNIT_NAME }; #endif /* do the private key first */ if (os_strlen(CONFIG_SSL_PRIVATE_KEY_LOCATION) > 0) { if ((ret = ssl_obj_load(ssl_ctx, SSL_OBJ_RSA_KEY, CONFIG_SSL_PRIVATE_KEY_LOCATION, CONFIG_SSL_PRIVATE_KEY_PASSWORD)) < 0) goto error; } else if (!(options & SSL_NO_DEFAULT_KEY)) { #if defined(CONFIG_SSL_USE_DEFAULT_KEY) || defined(CONFIG_SSL_SKELETON_MODE) // static const /* saves a few more bytes */ //#include "private_key.h" extern unsigned int default_private_key_len; extern unsigned char default_private_key[]; ssl_obj_memory_load(ssl_ctx, SSL_OBJ_RSA_KEY, default_private_key, default_private_key_len, NULL); #endif } /* now load the certificate */ #ifdef CONFIG_SSL_GENERATE_X509_CERT if ((cert_size = ssl_x509_create(ssl_ctx, 0, dn, &cert_data)) < 0) { ret = cert_size; goto error; } ssl_obj_memory_load(ssl_ctx, SSL_OBJ_X509_CERT, cert_data, cert_size, NULL); os_free(cert_data); #else if (os_strlen(CONFIG_SSL_X509_CERT_LOCATION)) { if ((ret = ssl_obj_load(ssl_ctx, SSL_OBJ_X509_CERT, CONFIG_SSL_X509_CERT_LOCATION, NULL)) < 0) goto error; } else if (!(options & SSL_NO_DEFAULT_KEY)) { #if defined(CONFIG_SSL_USE_DEFAULT_KEY) || defined(CONFIG_SSL_SKELETON_MODE) // static const /* saves a few bytes and RAM */ //#include "cert.h" extern unsigned char default_certificate[]; extern unsigned int default_certificate_len; ssl_obj_memory_load(ssl_ctx, SSL_OBJ_X509_CERT, default_certificate, default_certificate_len, NULL); #endif } #endif error: #ifdef CONFIG_SSL_FULL_MODE if (ret) { ssl_printf("Error: Certificate or key not loaded\n"); //TTY_FLUSH(); } #endif return ret; } ================================================ FILE: app/ssl/ssl/ssl_openssl.c ================================================ /* * Copyright (c) 2007, Cameron Rich * * 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 axTLS project 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. */ /* * Enable a subset of openssl compatible functions. We don't aim to be 100% * compatible - just to be able to do basic ports etc. * * Only really tested on mini_httpd, so I'm not too sure how extensive this * port is. */ #include "ssl/ssl_config.h" #ifdef CONFIG_OPENSSL_COMPATIBLE #include #include #include #include "ssl/ssl_os_port.h" #include "ssl/ssl_ssl.h" #define OPENSSL_CTX_ATTR ((OPENSSL_CTX *)ssl_ctx->bonus_attr) static char *key_password = NULL; void *SSLv23_server_method(void) { return NULL; } void *SSLv3_server_method(void) { return NULL; } void *TLSv1_server_method(void) { return NULL; } void *SSLv23_client_method(void) { return NULL; } void *SSLv3_client_method(void) { return NULL; } void *TLSv1_client_method(void) { return NULL; } typedef void * (*ssl_func_type_t)(void); typedef void * (*bio_func_type_t)(void); typedef struct { ssl_func_type_t ssl_func_type; } OPENSSL_CTX; SSL_CTX *ICACHE_FLASH_ATTR SSL_CTX_new(ssl_func_type_t meth) { SSL_CTX *ssl_ctx = ssl_ctx_new(0, 5); ssl_ctx->bonus_attr = os_malloc(sizeof(OPENSSL_CTX)); OPENSSL_CTX_ATTR->ssl_func_type = meth; return ssl_ctx; } void ICACHE_FLASH_ATTR SSL_CTX_free(SSL_CTX *ssl_ctx) { free(ssl_ctx->bonus_attr); ssl_ctx_free(ssl_ctx); } SSL *ICACHE_FLASH_ATTR SSL_new(SSL_CTX *ssl_ctx) { SSL *ssl; ssl_func_type_t ssl_func_type; ssl = ssl_new(ssl_ctx, -1); /* fd is set later */ ssl_func_type = OPENSSL_CTX_ATTR->ssl_func_type; #ifdef CONFIG_SSL_ENABLE_CLIENT if (ssl_func_type == SSLv23_client_method || ssl_func_type == SSLv3_client_method || ssl_func_type == TLSv1_client_method) { SET_SSL_FLAG(SSL_IS_CLIENT); } else #endif { ssl->next_state = HS_CLIENT_HELLO; } return ssl; } int ICACHE_FLASH_ATTR SSL_set_fd(SSL *s, int fd) { s->client_fd = fd; return 1; /* always succeeds */ } int ICACHE_FLASH_ATTR SSL_accept(SSL *ssl) { while (ssl_read(ssl, NULL) == SSL_OK) { if (ssl->next_state == HS_CLIENT_HELLO) return 1; /* we're done */ } return -1; } #ifdef CONFIG_SSL_ENABLE_CLIENT int ICACHE_FLASH_ATTR SSL_connect(SSL *ssl) { return do_client_connect(ssl) == SSL_OK ? 1 : -1; } #endif void ICACHE_FLASH_ATTR SSL_free(SSL *ssl) { ssl_free(ssl); } int ICACHE_FLASH_ATTR SSL_read(SSL *ssl, void *buf, int num) { uint8_t *read_buf; int ret; while ((ret = ssl_read(ssl, &read_buf)) == SSL_OK); if (ret > SSL_OK) { os_memcpy(buf, read_buf, ret > num ? num : ret); } return ret; } int ICACHE_FLASH_ATTR SSL_write(SSL *ssl, const void *buf, int num) { return ssl_write(ssl, buf, num); } int ICACHE_FLASH_ATTR SSL_CTX_use_certificate_file(SSL_CTX *ssl_ctx, const char *file, int type) { return (ssl_obj_load(ssl_ctx, SSL_OBJ_X509_CERT, file, NULL) == SSL_OK); } int ICACHE_FLASH_ATTR SSL_CTX_use_PrivateKey_file(SSL_CTX *ssl_ctx, const char *file, int type) { return (ssl_obj_load(ssl_ctx, SSL_OBJ_RSA_KEY, file, key_password) == SSL_OK); } int ICACHE_FLASH_ATTR SSL_CTX_use_certificate_ASN1(SSL_CTX *ssl_ctx, int len, const uint8_t *d) { return (ssl_obj_memory_load(ssl_ctx, SSL_OBJ_X509_CERT, d, len, NULL) == SSL_OK); } int ICACHE_FLASH_ATTR SSL_CTX_set_session_id_context(SSL_CTX *ctx, const unsigned char *sid_ctx, unsigned int sid_ctx_len) { return 1; } int ICACHE_FLASH_ATTR SSL_CTX_set_default_verify_paths(SSL_CTX *ctx) { return 1; } int ICACHE_FLASH_ATTR SSL_CTX_use_certificate_chain_file(SSL_CTX *ssl_ctx, const char *file) { return (ssl_obj_load(ssl_ctx, SSL_OBJ_X509_CERT, file, NULL) == SSL_OK); } int ICACHE_FLASH_ATTR SSL_shutdown(SSL *ssl) { return 1; } /*** get/set session ***/ SSL_SESSION *ICACHE_FLASH_ATTR SSL_get1_session(SSL *ssl) { return (SSL_SESSION *)ssl_get_session_id(ssl); /* note: wrong cast */ } int ICACHE_FLASH_ATTR SSL_set_session(SSL *ssl, SSL_SESSION *session) { os_memcpy(ssl->session_id, (uint8_t *)session, SSL_SESSION_ID_SIZE); return 1; } void ICACHE_FLASH_ATTR SSL_SESSION_free(SSL_SESSION *session) { } /*** end get/set session ***/ long ICACHE_FLASH_ATTR SSL_CTX_ctrl(SSL_CTX *ctx, int cmd, long larg, void *parg) { return 0; } void ICACHE_FLASH_ATTR SSL_CTX_set_verify(SSL_CTX *ctx, int mode, int (*verify_callback)(int, void *)) { } void ICACHE_FLASH_ATTR SSL_CTX_set_verify_depth(SSL_CTX *ctx, int depth) { } int ICACHE_FLASH_ATTR SSL_CTX_load_verify_locations(SSL_CTX *ctx, const char *CAfile, const char *CApath) { return 1; } void *ICACHE_FLASH_ATTR SSL_load_client_CA_file(const char *file) { return (void *)file; } void ICACHE_FLASH_ATTR SSL_CTX_set_client_CA_list(SSL_CTX *ssl_ctx, void *file) { ssl_obj_load(ssl_ctx, SSL_OBJ_X509_CERT, (const char *)file, NULL); } void ICACHE_FLASH_ATTR SSLv23_method(void) { } void ICACHE_FLASH_ATTR SSL_CTX_set_default_passwd_cb(SSL_CTX *ctx, void *cb) { } void ICACHE_FLASH_ATTR SSL_CTX_set_default_passwd_cb_userdata(SSL_CTX *ctx, void *u) { key_password = (char *)u; } int ICACHE_FLASH_ATTR SSL_peek(SSL *ssl, void *buf, int num) { os_memcpy(buf, ssl->bm_data, num); return num; } void ICACHE_FLASH_ATTR SSL_set_bio(SSL *ssl, void *rbio, void *wbio) { } long ICACHE_FLASH_ATTR SSL_get_verify_result(const SSL *ssl) { return ssl_handshake_status(ssl); } int ICACHE_FLASH_ATTR SSL_state(SSL *ssl) { return 0x03; // ok state } /** end of could do better list */ void *ICACHE_FLASH_ATTR SSL_get_peer_certificate(const SSL *ssl) { return &ssl->ssl_ctx->certs[0]; } int ICACHE_FLASH_ATTR SSL_clear(SSL *ssl) { return 1; } int ICACHE_FLASH_ATTR SSL_CTX_check_private_key(const SSL_CTX *ctx) { return 1; } int ICACHE_FLASH_ATTR SSL_CTX_set_cipher_list(SSL *s, const char *str) { return 1; } int ICACHE_FLASH_ATTR SSL_get_error(const SSL *ssl, int ret) { ssl_display_error(ret); return 0; /* TODO: return proper return code */ } void ICACHE_FLASH_ATTR SSL_CTX_set_options(SSL_CTX *ssl_ctx, int option) {} int ICACHE_FLASH_ATTR SSL_library_init(void ) { return 1; } void ICACHE_FLASH_ATTR SSL_load_error_strings(void ) {} void ICACHE_FLASH_ATTR ERR_print_errors_fp(FILE *fp) {} #ifndef CONFIG_SSL_SKELETON_MODE long ICACHE_FLASH_ATTR SSL_CTX_get_timeout(const SSL_CTX *ssl_ctx) { return CONFIG_SSL_EXPIRY_TIME*3600; } long ICACHE_FLASH_ATTR SSL_CTX_set_timeout(SSL_CTX *ssl_ctx, long t) { return SSL_CTX_get_timeout(ssl_ctx); } #endif void ICACHE_FLASH_ATTR BIO_printf(FILE *f, const char *format, ...) { va_list(ap); va_start(ap, format); vfprintf(f, format, ap); va_end(ap); } void* ICACHE_FLASH_ATTR BIO_s_null(void) { return NULL; } FILE *ICACHE_FLASH_ATTR BIO_new(bio_func_type_t func) { if (func == BIO_s_null) return fopen("/dev/null", "r"); else return NULL; } FILE *ICACHE_FLASH_ATTR BIO_new_fp(FILE *stream, int close_flag) { return stream; } int ICACHE_FLASH_ATTR BIO_free(FILE *a) { if (a != stdout && a != stderr) fclose(a); return 1; } #endif ================================================ FILE: app/ssl/ssl/ssl_os_port.c ================================================ /* * Copyright (c) 2007, Cameron Rich * * 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 axTLS project 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. */ /** * @file os_port.c * * OS specific functions. */ //#include //#include //#include //#include #include "ssl/ssl_os_port.h" #ifdef WIN32 /** * gettimeofday() not in Win32 */ EXP_FUNC void STDCALL gettimeofday(struct timeval* t, void* timezone) { #if defined(_WIN32_WCE) t->tv_sec = time(NULL); t->tv_usec = 0; /* 1sec precision only */ #else struct _timeb timebuffer; _ftime(&timebuffer); t->tv_sec = (long)timebuffer.time; t->tv_usec = 1000 * timebuffer.millitm; /* 1ms precision */ #endif } /** * strcasecmp() not in Win32 */ EXP_FUNC int STDCALL strcasecmp(const char *s1, const char *s2) { while (tolower(*s1) == tolower(*s2++)) { if (*s1++ == '\0') { return 0; } } return *(unsigned char *)s1 - *(unsigned char *)(s2 - 1); } EXP_FUNC int STDCALL getdomainname(char *buf, int buf_size) { HKEY hKey; unsigned long datatype; unsigned long bufferlength = buf_size; if (RegOpenKeyEx(HKEY_LOCAL_MACHINE, TEXT("SYSTEM\\CurrentControlSet\\Services\\Tcpip\\Parameters"), 0, KEY_QUERY_VALUE, &hKey) != ERROR_SUCCESS) return -1; RegQueryValueEx(hKey, "Domain", NULL, &datatype, buf, &bufferlength); RegCloseKey(hKey); return 0; } #endif #if 0 #undef malloc #undef realloc #undef calloc static const char * out_of_mem_str = "out of memory"; static const char * file_open_str = "Could not open file \"%s\""; /* * Some functions that call display some error trace and then call abort(). * This just makes life much easier on embedded systems, since we're * suffering major trauma... */ EXP_FUNC void * STDCALL ax_malloc(size_t s) { void *x; if ((x = malloc(s)) == NULL) exit_now(out_of_mem_str); return x; } EXP_FUNC void * STDCALL ax_realloc(void *y, size_t s) { void *x; if ((x = realloc(y, s)) == NULL) exit_now(out_of_mem_str); return x; } EXP_FUNC void * STDCALL ax_calloc(size_t n, size_t s) { void *x; if ((x = calloc(n, s)) == NULL) exit_now(out_of_mem_str); return x; } EXP_FUNC int STDCALL ax_open(const char *pathname, int flags) { int x; if ((x = open(pathname, flags)) < 0) exit_now(file_open_str, pathname); return x; } /** * This is a call which will deliberately exit an application, but will * display some information before dying. */ void exit_now(const char *format, ...) { va_list argp; va_start(argp, format); vfprintf(stderr, format, argp); va_end(argp); abort(); } /** * gettimeofday() not in Win32 */ EXP_FUNC void STDCALL gettimeofday(struct timeval* t, void* timezone) { #if defined(_WIN32_WCE) t->tv_sec = time(NULL); t->tv_usec = 0; /* 1sec precision only */ #else /* wujg : pass compile first */ t->tv_sec = 0; t->tv_usec = 0; /* 1ms precision */ #endif } #endif ================================================ FILE: app/ssl/ssl/ssl_p12.c ================================================ /* * Copyright (c) 2007, Cameron Rich * * 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 axTLS project 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. */ /** * Process PKCS#8/PKCS#12 keys. * * The decoding of a PKCS#12 key is fairly specific - this code was tested on a * key generated with: * * openssl pkcs12 -export -in axTLS.x509_1024.pem -inkey axTLS.key_1024.pem * -keypbe PBE-SHA1-RC4-128 -certpbe PBE-SHA1-RC4-128 * -name "p12_withoutCA" -out axTLS.withoutCA.p12 -password pass:abcd * * or with a certificate chain: * * openssl pkcs12 -export -in axTLS.x509_1024.pem -inkey axTLS.key_1024.pem * -certfile axTLS.ca_x509.pem -keypbe PBE-SHA1-RC4-128 -certpbe * PBE-SHA1-RC4-128 -name "p12_withCA" -out axTLS.withCA.p12 -password pass:abcd * * Note that the PBE has to be specified with PBE-SHA1-RC4-128. The * private/public keys/certs have to use RSA encryption. Both the integrity * and privacy passwords are the same. * * The PKCS#8 files were generated with something like: * * PEM format: * openssl pkcs8 -in axTLS.key_512.pem -passout pass:abcd -topk8 -v1 * PBE-SHA1-RC4-128 -out axTLS.encrypted_pem.p8 * * DER format: * openssl pkcs8 -in axTLS.key_512.pem -passout pass:abcd -topk8 -outform DER * -v1 PBE-SHA1-RC4-128 -out axTLS.encrypted.p8 */ //#include //#include //#include #include "ssl/ssl_os_port.h" #include "ssl/ssl_ssl.h" /* all commented out if not used */ #ifdef CONFIG_SSL_USE_PKCS12 #define BLOCK_SIZE 64 #define PKCS12_KEY_ID 1 #define PKCS12_IV_ID 2 #define PKCS12_MAC_ID 3 static char *make_uni_pass(const char *password, int *uni_pass_len); static int p8_decrypt(const char *uni_pass, int uni_pass_len, const uint8_t *salt, int iter, uint8_t *priv_key, int priv_key_len, int id); static int p8_add_key(SSL_CTX *ssl_ctx, uint8_t *priv_key); static int get_pbe_params(uint8_t *buf, int *offset, const uint8_t **salt, int *iterations); /* * Take a raw pkcs8 block and then decrypt it and turn it into a normal key. */ int ICACHE_FLASH_ATTR pkcs8_decode(SSL_CTX *ssl_ctx, SSLObjLoader *ssl_obj, const char *password) { uint8_t *buf = ssl_obj->buf; int len, offset = 0; int iterations; int ret = SSL_NOT_OK; uint8_t *version = NULL; const uint8_t *salt; uint8_t *priv_key; int uni_pass_len; char *uni_pass = make_uni_pass(password, &uni_pass_len); if (asn1_next_obj(buf, &offset, ASN1_SEQUENCE) < 0) { #ifdef CONFIG_SSL_FULL_MODE ssl_printf("Error: Invalid p8 ASN.1 file\n"); #endif goto error; } /* unencrypted key? */ if (asn1_get_int(buf, &offset, &version) > 0 && *version == 0) { ret = p8_add_key(ssl_ctx, buf); goto error; } if (get_pbe_params(buf, &offset, &salt, &iterations) < 0) goto error; if ((len = asn1_next_obj(buf, &offset, ASN1_OCTET_STRING)) < 0) goto error; priv_key = &buf[offset]; p8_decrypt(uni_pass, uni_pass_len, salt, iterations, priv_key, len, PKCS12_KEY_ID); ret = p8_add_key(ssl_ctx, priv_key); error: os_free(version); os_free(uni_pass); return ret; } /* * Take the unencrypted pkcs8 and turn it into a private key */ static int ICACHE_FLASH_ATTR p8_add_key(SSL_CTX *ssl_ctx, uint8_t *priv_key) { uint8_t *buf = priv_key; int len, offset = 0; int ret = SSL_NOT_OK; /* Skip the preamble and go straight to the private key. We only support rsaEncryption (1.2.840.113549.1.1.1) */ if (asn1_next_obj(buf, &offset, ASN1_SEQUENCE) < 0 || asn1_skip_obj(buf, &offset, ASN1_INTEGER) < 0 || asn1_skip_obj(buf, &offset, ASN1_SEQUENCE) < 0 || (len = asn1_next_obj(buf, &offset, ASN1_OCTET_STRING)) < 0) goto error; ret = asn1_get_private_key(&buf[offset], len, &ssl_ctx->rsa_ctx); error: return ret; } /* * Create the unicode password */ static char * ICACHE_FLASH_ATTR make_uni_pass(const char *password, int *uni_pass_len) { int pass_len = 0, i; char *uni_pass; if (password == NULL) { password = ""; } uni_pass = (char *)os_malloc((os_strlen(password)+1)*2); /* modify the password into a unicode version */ for (i = 0; i < (int)os_strlen(password); i++) { uni_pass[pass_len++] = 0; uni_pass[pass_len++] = password[i]; } uni_pass[pass_len++] = 0; /* null terminate */ uni_pass[pass_len++] = 0; *uni_pass_len = pass_len; return uni_pass; } /* * Decrypt a pkcs8 block. */ static int ICACHE_FLASH_ATTR p8_decrypt(const char *uni_pass, int uni_pass_len, const uint8_t *salt, int iter, uint8_t *priv_key, int priv_key_len, int id) { uint8_t p[BLOCK_SIZE*2]; uint8_t d[BLOCK_SIZE]; uint8_t Ai[SHA1_SIZE]; SHA1_CTX sha_ctx; RC4_CTX rc4_ctx; int i; for (i = 0; i < BLOCK_SIZE; i++) { p[i] = salt[i % SALT_SIZE]; p[BLOCK_SIZE+i] = uni_pass[i % uni_pass_len]; d[i] = id; } /* get the key - no IV since we are using RC4 */ SHA1_Init(&sha_ctx); SHA1_Update(&sha_ctx, d, sizeof(d)); SHA1_Update(&sha_ctx, p, sizeof(p)); SHA1_Final(Ai, &sha_ctx); for (i = 1; i < iter; i++) { SHA1_Init(&sha_ctx); SHA1_Update(&sha_ctx, Ai, SHA1_SIZE); SHA1_Final(Ai, &sha_ctx); } /* do the decryption */ if (id == PKCS12_KEY_ID) { RC4_setup(&rc4_ctx, Ai, 16); RC4_crypt(&rc4_ctx, priv_key, priv_key, priv_key_len); } else /* MAC */ os_memcpy(priv_key, Ai, SHA1_SIZE); return 0; } /* * Take a raw pkcs12 block and the decrypt it and turn it into a certificate(s) * and keys. */ int ICACHE_FLASH_ATTR pkcs12_decode(SSL_CTX *ssl_ctx, SSLObjLoader *ssl_obj, const char *password) { uint8_t *buf = ssl_obj->buf; int len, iterations, auth_safes_start, auth_safes_end, auth_safes_len, key_offset, offset = 0; int all_certs = 0; uint8_t *version = NULL, *auth_safes = NULL, *cert, *orig_mac; uint8_t key[SHA1_SIZE]; uint8_t mac[SHA1_SIZE]; const uint8_t *salt; int uni_pass_len, ret = SSL_OK; char *uni_pass = make_uni_pass(password, &uni_pass_len); static const uint8_t pkcs_data[] = /* pkc7 data */ { 0x2a, 0x86, 0x48, 0x86, 0xf7, 0x0d, 0x01, 0x07, 0x01 }; static const uint8_t pkcs_encrypted[] = /* pkc7 encrypted */ { 0x2a, 0x86, 0x48, 0x86, 0xf7, 0x0d, 0x01, 0x07, 0x06 }; static const uint8_t pkcs8_key_bag[] = /* 1.2.840.113549.1.12.10.1.2 */ { 0x2a, 0x86, 0x48, 0x86, 0xf7, 0x0d, 0x01, 0x0c, 0x0a, 0x01, 0x02 }; if (asn1_next_obj(buf, &offset, ASN1_SEQUENCE) < 0) { #ifdef CONFIG_SSL_FULL_MODE ssl_printf("Error: Invalid p12 ASN.1 file\n"); #endif goto error; } if (asn1_get_int(buf, &offset, &version) < 0 || *version != 3) { ret = SSL_ERROR_INVALID_VERSION; goto error; } /* remove all the boring pcks7 bits */ if (asn1_next_obj(buf, &offset, ASN1_SEQUENCE) < 0 || (len = asn1_next_obj(buf, &offset, ASN1_OID)) < 0 || len != sizeof(pkcs_data) || os_memcmp(&buf[offset], pkcs_data, sizeof(pkcs_data))) goto error; offset += len; if (asn1_next_obj(buf, &offset, ASN1_EXPLICIT_TAG) < 0 || asn1_next_obj(buf, &offset, ASN1_OCTET_STRING) < 0) goto error; /* work out the MAC start/end points (done on AuthSafes) */ auth_safes_start = offset; auth_safes_end = offset; if (asn1_skip_obj(buf, &auth_safes_end, ASN1_SEQUENCE) < 0) goto error; auth_safes_len = auth_safes_end - auth_safes_start; auth_safes = os_malloc(auth_safes_len); os_memcpy(auth_safes, &buf[auth_safes_start], auth_safes_len); if (asn1_next_obj(buf, &offset, ASN1_SEQUENCE) < 0 || asn1_next_obj(buf, &offset, ASN1_SEQUENCE) < 0 || (len = asn1_next_obj(buf, &offset, ASN1_OID)) < 0 || (len != sizeof(pkcs_encrypted) || os_memcmp(&buf[offset], pkcs_encrypted, sizeof(pkcs_encrypted)))) goto error; offset += len; if (asn1_next_obj(buf, &offset, ASN1_EXPLICIT_TAG) < 0 || asn1_next_obj(buf, &offset, ASN1_SEQUENCE) < 0 || asn1_skip_obj(buf, &offset, ASN1_INTEGER) < 0 || asn1_next_obj(buf, &offset, ASN1_SEQUENCE) < 0 || (len = asn1_next_obj(buf, &offset, ASN1_OID)) < 0 || len != sizeof(pkcs_data) || os_memcmp(&buf[offset], pkcs_data, sizeof(pkcs_data))) goto error; offset += len; /* work out the salt for the certificate */ if (get_pbe_params(buf, &offset, &salt, &iterations) < 0 || (len = asn1_next_obj(buf, &offset, ASN1_IMPLICIT_TAG)) < 0) goto error; /* decrypt the certificate */ cert = &buf[offset]; if ((ret = p8_decrypt(uni_pass, uni_pass_len, salt, iterations, cert, len, PKCS12_KEY_ID)) < 0) goto error; offset += len; /* load the certificate */ key_offset = 0; all_certs = asn1_next_obj(cert, &key_offset, ASN1_SEQUENCE); /* keep going until all certs are loaded */ while (key_offset < all_certs) { int cert_offset = key_offset; if (asn1_skip_obj(cert, &cert_offset, ASN1_SEQUENCE) < 0 || asn1_next_obj(cert, &key_offset, ASN1_SEQUENCE) < 0 || asn1_skip_obj(cert, &key_offset, ASN1_OID) < 0 || asn1_next_obj(cert, &key_offset, ASN1_EXPLICIT_TAG) < 0 || asn1_next_obj(cert, &key_offset, ASN1_SEQUENCE) < 0 || asn1_skip_obj(cert, &key_offset, ASN1_OID) < 0 || asn1_next_obj(cert, &key_offset, ASN1_EXPLICIT_TAG) < 0 || (len = asn1_next_obj(cert, &key_offset, ASN1_OCTET_STRING)) < 0) goto error; if ((ret = add_cert(ssl_ctx, &cert[key_offset], len)) < 0) goto error; key_offset = cert_offset; } if (asn1_next_obj(buf, &offset, ASN1_SEQUENCE) < 0 || (len = asn1_next_obj(buf, &offset, ASN1_OID)) < 0 || len != sizeof(pkcs_data) || os_memcmp(&buf[offset], pkcs_data, sizeof(pkcs_data))) goto error; offset += len; if (asn1_next_obj(buf, &offset, ASN1_EXPLICIT_TAG) < 0 || asn1_next_obj(buf, &offset, ASN1_OCTET_STRING) < 0 || asn1_next_obj(buf, &offset, ASN1_SEQUENCE) < 0 || asn1_next_obj(buf, &offset, ASN1_SEQUENCE) < 0 || (len = asn1_next_obj(buf, &offset, ASN1_OID)) < 0 || (len != sizeof(pkcs8_key_bag)) || os_memcmp(&buf[offset], pkcs8_key_bag, sizeof(pkcs8_key_bag))) goto error; offset += len; /* work out the salt for the private key */ if (asn1_next_obj(buf, &offset, ASN1_EXPLICIT_TAG) < 0 || asn1_next_obj(buf, &offset, ASN1_SEQUENCE) < 0 || get_pbe_params(buf, &offset, &salt, &iterations) < 0 || (len = asn1_next_obj(buf, &offset, ASN1_OCTET_STRING)) < 0) goto error; /* decrypt the private key */ cert = &buf[offset]; if ((ret = p8_decrypt(uni_pass, uni_pass_len, salt, iterations, cert, len, PKCS12_KEY_ID)) < 0) goto error; offset += len; /* load the private key */ if ((ret = p8_add_key(ssl_ctx, cert)) < 0) goto error; /* miss out on friendly name, local key id etc */ if (asn1_skip_obj(buf, &offset, ASN1_SET) < 0) goto error; /* work out the MAC */ if (asn1_next_obj(buf, &offset, ASN1_SEQUENCE) < 0 || asn1_next_obj(buf, &offset, ASN1_SEQUENCE) < 0 || asn1_skip_obj(buf, &offset, ASN1_SEQUENCE) < 0 || (len = asn1_next_obj(buf, &offset, ASN1_OCTET_STRING)) < 0 || len != SHA1_SIZE) goto error; orig_mac = &buf[offset]; offset += len; /* get the salt */ if ((len = asn1_next_obj(buf, &offset, ASN1_OCTET_STRING)) < 0 || len != 8) goto error; salt = &buf[offset]; /* work out what the mac should be */ if ((ret = p8_decrypt(uni_pass, uni_pass_len, salt, iterations, key, SHA1_SIZE, PKCS12_MAC_ID)) < 0) goto error; ssl_hmac_sha1(auth_safes, auth_safes_len, key, SHA1_SIZE, mac); if (os_memcmp(mac, orig_mac, SHA1_SIZE)) { ret = SSL_ERROR_INVALID_HMAC; goto error; } error: os_free(version); os_free(uni_pass); os_free(auth_safes); return ret; } /* * Retrieve the salt/iteration details from a PBE block. */ static int ICACHE_FLASH_ATTR get_pbe_params(uint8_t *buf, int *offset, const uint8_t **salt, int *iterations) { static const uint8_t pbeSH1RC4[] = /* pbeWithSHAAnd128BitRC4 */ { 0x2a, 0x86, 0x48, 0x86, 0xf7, 0x0d, 0x01, 0x0c, 0x01, 0x01 }; int i, len; uint8_t *iter = NULL; int error_code = SSL_ERROR_NOT_SUPPORTED; /* Get the PBE type */ if (asn1_next_obj(buf, offset, ASN1_SEQUENCE) < 0 || (len = asn1_next_obj(buf, offset, ASN1_OID)) < 0) goto error; /* we expect pbeWithSHAAnd128BitRC4 (1.2.840.113549.1.12.1.1) which is the only algorithm we support */ if (len != sizeof(pbeSH1RC4) || os_memcmp(&buf[*offset], pbeSH1RC4, sizeof(pbeSH1RC4))) { #ifdef CONFIG_SSL_FULL_MODE ssl_printf("Error: pkcs8/pkcs12 must use \"PBE-SHA1-RC4-128\"\n"); #endif goto error; } *offset += len; if (asn1_next_obj(buf, offset, ASN1_SEQUENCE) < 0 || (len = asn1_next_obj(buf, offset, ASN1_OCTET_STRING)) < 0 || len != 8) goto error; *salt = &buf[*offset]; *offset += len; if ((len = asn1_get_int(buf, offset, &iter)) < 0) goto error; *iterations = 0; for (i = 0; i < len; i++) { (*iterations) <<= 8; (*iterations) += iter[i]; } os_free(iter); error_code = SSL_OK; /* got here - we are ok */ error: return error_code; } #endif ================================================ FILE: app/ssl/ssl/ssl_tls1.c ================================================ /* * Copyright (c) 2007, Cameron Rich * * 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 axTLS project 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. */ /** * Common ssl/tlsv1 code to both the client and server implementations. */ //#include //#include //#include //#include #include "ssl/ssl_os_port.h" #include "ssl/ssl_ssl.h" #include "lwip/tcp.h" #include "ssl/app/espconn_ssl.h" extern struct pbuf* psslpbuf; /* The session expiry time */ #define SSL_EXPIRY_TIME (CONFIG_SSL_EXPIRY_TIME*3600) static const uint8_t g_hello_request[] = { HS_HELLO_REQUEST, 0, 0, 0 }; static const uint8_t g_chg_cipher_spec_pkt[] = { 1 }; static const char * server_finished = "server finished"; static const char * client_finished = "client finished"; static int do_handshake(SSL *ssl, uint8_t *buf, int read_len); static int set_key_block(SSL *ssl, int is_write); static int verify_digest(SSL *ssl, int mode, const uint8_t *buf, int read_len); static void *crypt_new(SSL *ssl, uint8_t *key, uint8_t *iv, int is_decrypt); static err_t send_raw_packet(SSL *ssl, uint8_t protocol); /** * The server will pick the cipher based on the order that the order that the * ciphers are listed. This order is defined at compile time. */ #ifdef CONFIG_SSL_SKELETON_MODE const uint8_t ssl_prot_prefs[NUM_PROTOCOLS] = { SSL_RC4_128_SHA }; #else static void session_free(SSL_SESSION *ssl_sessions[], int sess_index); const uint8_t ssl_prot_prefs[NUM_PROTOCOLS] = #ifdef CONFIG_SSL_PROT_LOW /* low security, fast speed */ { SSL_RC4_128_SHA, SSL_AES128_SHA, SSL_AES256_SHA, SSL_RC4_128_MD5 }; #elif CONFIG_SSL_PROT_MEDIUM /* medium security, medium speed */ { SSL_AES128_SHA, SSL_AES256_SHA, SSL_RC4_128_SHA, SSL_RC4_128_MD5 }; #else /* CONFIG_SSL_PROT_HIGH */ /* high security, low speed */ { SSL_AES256_SHA, SSL_AES128_SHA, SSL_RC4_128_SHA, SSL_RC4_128_MD5 }; #endif #endif /* CONFIG_SSL_SKELETON_MODE */ /** * The cipher map containing all the essentials for each cipher. */ #ifdef CONFIG_SSL_SKELETON_MODE static const cipher_info_t cipher_info[NUM_PROTOCOLS] = { { /* RC4-SHA */ SSL_RC4_128_SHA, /* RC4-SHA */ 16, /* key size */ 0, /* iv size */ 2*(SHA1_SIZE+16), /* key block size */ 0, /* no padding */ SHA1_SIZE, /* digest size */ ssl_hmac_sha1, /* hmac algorithm */ (crypt_func)RC4_crypt, /* encrypt */ (crypt_func)RC4_crypt /* decrypt */ }, }; #else static const cipher_info_t cipher_info[NUM_PROTOCOLS] = { { /* AES128-SHA */ SSL_AES128_SHA, /* AES128-SHA */ 16, /* key size */ 16, /* iv size */ 2*(SHA1_SIZE+16+16), /* key block size */ 16, /* block padding size */ SHA1_SIZE, /* digest size */ ssl_hmac_sha1, /* hmac algorithm */ (crypt_func)AES_cbc_encrypt, /* encrypt */ (crypt_func)AES_cbc_decrypt /* decrypt */ }, { /* AES256-SHA */ SSL_AES256_SHA, /* AES256-SHA */ 32, /* key size */ 16, /* iv size */ 2*(SHA1_SIZE+32+16), /* key block size */ 16, /* block padding size */ SHA1_SIZE, /* digest size */ ssl_hmac_sha1, /* hmac algorithm */ (crypt_func)AES_cbc_encrypt, /* encrypt */ (crypt_func)AES_cbc_decrypt /* decrypt */ }, { /* RC4-SHA */ SSL_RC4_128_SHA, /* RC4-SHA */ 16, /* key size */ 0, /* iv size */ 2*(SHA1_SIZE+16), /* key block size */ 0, /* no padding */ SHA1_SIZE, /* digest size */ ssl_hmac_sha1, /* hmac algorithm */ (crypt_func)RC4_crypt, /* encrypt */ (crypt_func)RC4_crypt /* decrypt */ }, /* * This protocol is from SSLv2 days and is unlikely to be used - but was * useful for testing different possible digest algorithms. */ { /* RC4-MD5 */ SSL_RC4_128_MD5, /* RC4-MD5 */ 16, /* key size */ 0, /* iv size */ 2*(MD5_SIZE+16), /* key block size */ 0, /* no padding */ MD5_SIZE, /* digest size */ ssl_hmac_md5, /* hmac algorithm */ (crypt_func)RC4_crypt, /* encrypt */ (crypt_func)RC4_crypt /* decrypt */ }, }; #endif static void prf(const uint8_t *sec, int sec_len, uint8_t *seed, int seed_len, uint8_t *out, int olen); static const cipher_info_t *get_cipher_info(uint8_t cipher); static void increment_read_sequence(SSL *ssl); static void increment_write_sequence(SSL *ssl); static void add_hmac_digest(SSL *ssl, int snd, uint8_t *hmac_header, const uint8_t *buf, int buf_len, uint8_t *hmac_buf); /* win32 VC6.0 doesn't have variadic macros */ #if defined(WIN32) && !defined(CONFIG_SSL_FULL_MODE) void DISPLAY_BYTES(SSL *ssl, const char *format, const uint8_t *data, int size, ...) {} #endif /** * Establish a new client/server context. */ EXP_FUNC SSL_CTX *STDCALL ICACHE_FLASH_ATTR ssl_ctx_new(uint32_t options, int num_sessions) { SSL_CTX *ssl_ctx = (SSL_CTX *)os_zalloc(sizeof (SSL_CTX)); ssl_ctx->options = options; RNG_initialize(); if (load_key_certs(ssl_ctx) < 0) { os_free(ssl_ctx); /* can't load our key/certificate pair, so die */ return NULL; } #ifndef CONFIG_SSL_SKELETON_MODE ssl_ctx->num_sessions = num_sessions; #endif SSL_CTX_MUTEX_INIT(ssl_ctx->mutex); #ifndef CONFIG_SSL_SKELETON_MODE if (num_sessions) { ssl_ctx->ssl_sessions = (SSL_SESSION **) os_zalloc(num_sessions*sizeof(SSL_SESSION *)); } #endif return ssl_ctx; } /* * Remove a client/server context. */ EXP_FUNC void STDCALL ICACHE_FLASH_ATTR ssl_ctx_free(SSL_CTX *ssl_ctx) { SSL *ssl; int i; if (ssl_ctx == NULL) return; ssl = ssl_ctx->head; /* clear out all the ssl entries */ while (ssl) { SSL *next = ssl->next; ssl_free(ssl); ssl = next; } #ifndef CONFIG_SSL_SKELETON_MODE /* clear out all the sessions */ for (i = 0; i < ssl_ctx->num_sessions; i++) session_free(ssl_ctx->ssl_sessions, i); os_free(ssl_ctx->ssl_sessions); #endif i = 0; while (i < CONFIG_SSL_MAX_CERTS && ssl_ctx->certs[i].buf) { os_free(ssl_ctx->certs[i].buf); ssl_ctx->certs[i++].buf = NULL; } #ifdef CONFIG_SSL_CERT_VERIFICATION remove_ca_certs(ssl_ctx->ca_cert_ctx); #endif ssl_ctx->chain_length = 0; SSL_CTX_MUTEX_DESTROY(ssl_ctx->mutex); // ssl_printf("%s %p\n", __func__,ssl_ctx->rsa_ctx); RSA_free(ssl_ctx->rsa_ctx); RNG_terminate(); // ssl_printf("%s %p\n", __func__,ssl_ctx); os_free(ssl_ctx); } /* * Free any used resources used by this connection. */ EXP_FUNC void STDCALL ICACHE_FLASH_ATTR ssl_free(SSL *ssl) { SSL_CTX *ssl_ctx; if (ssl == NULL) /* just ignore null pointers */ return; /* only notify if we weren't notified first */ /* spec says we must notify when we are dying */ if (!IS_SET_SSL_FLAG(SSL_SENT_CLOSE_NOTIFY)) send_alert(ssl, SSL_ALERT_CLOSE_NOTIFY); // ssl_printf("%s %d\n", __func__, __LINE__); ssl_ctx = ssl->ssl_ctx; SSL_CTX_LOCK(ssl_ctx->mutex); /* adjust the server SSL list */ if (ssl->prev) ssl->prev->next = ssl->next; else ssl_ctx->head = ssl->next; if (ssl->next) ssl->next->prev = ssl->prev; else ssl_ctx->tail = ssl->prev; SSL_CTX_UNLOCK(ssl_ctx->mutex); /* may already be free - but be sure */ os_free(ssl->encrypt_ctx); os_free(ssl->decrypt_ctx); disposable_free(ssl); #ifdef CONFIG_SSL_CERT_VERIFICATION x509_free(ssl->x509_ctx); #endif os_free(ssl); } /* * Read the SSL connection and send any alerts for various errors. */ EXP_FUNC int STDCALL ICACHE_FLASH_ATTR ssl_read(SSL *ssl, uint8_t **in_data) { int ret = basic_read(ssl, in_data); /* check for return code so we can send an alert */ if (ret < SSL_OK && ret != SSL_CLOSE_NOTIFY) { if (ret != SSL_ERROR_CONN_LOST) { send_alert(ssl, ret); #ifndef CONFIG_SSL_SKELETON_MODE /* something nasty happened, so get rid of this session */ kill_ssl_session(ssl->ssl_ctx->ssl_sessions, ssl); #endif } } return ret; } /* * Write application data to the client */ EXP_FUNC int STDCALL ICACHE_FLASH_ATTR ssl_write(SSL *ssl, const uint8_t *out_data, int out_len) { int n = out_len, nw, i, tot = 0; /* maximum size of a TLS packet is around 16kB, so fragment */ do { nw = n; if (nw > RT_MAX_PLAIN_LENGTH) /* fragment if necessary */ nw = RT_MAX_PLAIN_LENGTH; if ((i = send_packet(ssl, PT_APP_PROTOCOL_DATA, &out_data[tot], nw)) <= 0) { out_len = i; /* an error */ break; } tot += i; n -= i; } while (n > 0); return out_len; } /** * Add a certificate to the certificate chain. */ int ICACHE_FLASH_ATTR add_cert(SSL_CTX *ssl_ctx, const uint8_t *buf, int len) { int ret = SSL_ERROR_NO_CERT_DEFINED, i = 0; SSL_CERT *ssl_cert; X509_CTX *cert = NULL; int offset; while (ssl_ctx->certs[i].buf && i < CONFIG_SSL_MAX_CERTS) i++; if (i == CONFIG_SSL_MAX_CERTS) /* too many certs */ { #ifdef CONFIG_SSL_FULL_MODE ssl_printf("Error: maximum number of certs added (%d) - change of " "compile-time configuration required\n", CONFIG_SSL_MAX_CERTS); #endif goto error; } if ((ret = x509_new(buf, &offset, &cert))) goto error; #if defined (CONFIG_SSL_FULL_MODE) if (ssl_ctx->options & SSL_DISPLAY_CERTS) x509_print(cert, NULL); #endif ssl_cert = &ssl_ctx->certs[i]; ssl_cert->size = len; ssl_cert->buf = (uint8_t *)os_malloc(len); os_memcpy(ssl_cert->buf, buf, len); ssl_ctx->chain_length++; len -= offset; ret = SSL_OK; /* ok so far */ /* recurse? */ if (len > 0) { ret = add_cert(ssl_ctx, &buf[offset], len); } error: x509_free(cert); /* don't need anymore */ return ret; } #ifdef CONFIG_SSL_CERT_VERIFICATION /** * Add a certificate authority. */ int ICACHE_FLASH_ATTR add_cert_auth(SSL_CTX *ssl_ctx, const uint8_t *buf, int len) { int ret = SSL_OK; /* ignore errors for now */ int i = 0; CA_CERT_CTX *ca_cert_ctx; if (ssl_ctx->ca_cert_ctx == NULL) ssl_ctx->ca_cert_ctx = (CA_CERT_CTX *)os_zalloc(sizeof(CA_CERT_CTX)); ca_cert_ctx = ssl_ctx->ca_cert_ctx; while (i < CONFIG_X509_MAX_CA_CERTS && ca_cert_ctx->cert[i]) i++; while (len > 0) { int offset; if (i >= CONFIG_X509_MAX_CA_CERTS) { #ifdef CONFIG_SSL_FULL_MODE ssl_printf("Error: maximum number of CA certs added (%d) - change of " "compile-time configuration required\n", CONFIG_X509_MAX_CA_CERTS); #endif break; } /* ignore the return code */ if (x509_new(buf, &offset, &ca_cert_ctx->cert[i]) == X509_OK) { #if defined (CONFIG_SSL_FULL_MODE) if (ssl_ctx->options & SSL_DISPLAY_CERTS) x509_print(ca_cert_ctx->cert[i], NULL); #endif } i++; len -= offset; } return ret; } /* * Retrieve an X.509 distinguished name component */ EXP_FUNC const char * STDCALL ICACHE_FLASH_ATTR ssl_get_cert_dn(const SSL *ssl, int component) { if (ssl->x509_ctx == NULL) return NULL; switch (component) { case SSL_X509_CERT_COMMON_NAME: return ssl->x509_ctx->cert_dn[X509_COMMON_NAME]; case SSL_X509_CERT_ORGANIZATION: return ssl->x509_ctx->cert_dn[X509_ORGANIZATION]; case SSL_X509_CERT_ORGANIZATIONAL_NAME: return ssl->x509_ctx->cert_dn[X509_ORGANIZATIONAL_UNIT]; case SSL_X509_CA_CERT_COMMON_NAME: return ssl->x509_ctx->ca_cert_dn[X509_COMMON_NAME]; case SSL_X509_CA_CERT_ORGANIZATION: return ssl->x509_ctx->ca_cert_dn[X509_ORGANIZATION]; case SSL_X509_CA_CERT_ORGANIZATIONAL_NAME: return ssl->x509_ctx->ca_cert_dn[X509_ORGANIZATIONAL_UNIT]; default: return NULL; } } /* * Retrieve a "Subject Alternative Name" from a v3 certificate */ EXP_FUNC const char * STDCALL ICACHE_FLASH_ATTR ssl_get_cert_subject_alt_dnsname(const SSL *ssl, int dnsindex) { int i; if (ssl->x509_ctx == NULL || ssl->x509_ctx->subject_alt_dnsnames == NULL) return NULL; for (i = 0; i < dnsindex; ++i) { if (ssl->x509_ctx->subject_alt_dnsnames[i] == NULL) return NULL; } return ssl->x509_ctx->subject_alt_dnsnames[dnsindex]; } #endif /* CONFIG_SSL_CERT_VERIFICATION */ #if 0 /* * Find an ssl object based on the client's file descriptor. */ EXP_FUNC SSL * STDCALL ICACHE_FLASH_ATTR ssl_find(SSL_CTX *ssl_ctx, int client_fd) { SSL *ssl; SSL_CTX_LOCK(ssl_ctx->mutex); ssl = ssl_ctx->head; /* search through all the ssl entries */ while (ssl) { if (ssl->client_fd == client_fd) { SSL_CTX_UNLOCK(ssl_ctx->mutex); return ssl; } ssl = ssl->next; } SSL_CTX_UNLOCK(ssl_ctx->mutex); return NULL; } #endif /* * Force the client to perform its handshake again. */ EXP_FUNC int STDCALL ICACHE_FLASH_ATTR ssl_renegotiate(SSL *ssl) { int ret = SSL_OK; disposable_new(ssl); #ifdef CONFIG_SSL_ENABLE_CLIENT if (IS_SET_SSL_FLAG(SSL_IS_CLIENT)) { ret = do_client_connect(ssl); } else #endif { send_packet(ssl, PT_HANDSHAKE_PROTOCOL, g_hello_request, sizeof(g_hello_request)); SET_SSL_FLAG(SSL_NEED_RECORD); } return ret; } /** * @brief Get what we need for key info. * @param cipher [in] The cipher information we are after * @param key_size [out] The key size for the cipher * @param iv_size [out] The iv size for the cipher * @return The amount of key information we need. */ static const cipher_info_t *ICACHE_FLASH_ATTR get_cipher_info(uint8_t cipher) { int i; for (i = 0; i < NUM_PROTOCOLS; i++) { if (cipher_info[i].cipher == cipher) { return &cipher_info[i]; } } return NULL; /* error */ } #if 0 /* * Get a new ssl context for a new connection. */ SSL *ICACHE_FLASH_ATTR ssl_new(SSL_CTX *ssl_ctx, int client_fd) { SSL *ssl = (SSL *)os_zalloc(sizeof(SSL)); ssl->ssl_ctx = ssl_ctx; ssl->need_bytes = SSL_RECORD_SIZE; /* need a record */ ssl->client_fd = client_fd; ssl->flag = SSL_NEED_RECORD; ssl->bm_data = ssl->bm_all_data+BM_RECORD_OFFSET; /* space at the start */ ssl->hs_status = SSL_NOT_OK; /* not connected */ #ifdef CONFIG_ENABLE_VERIFICATION ssl->ca_cert_ctx = ssl_ctx->ca_cert_ctx; #endif disposable_new(ssl); /* a bit hacky but saves a few bytes of memory */ ssl->flag |= ssl_ctx->options; SSL_CTX_LOCK(ssl_ctx->mutex); if (ssl_ctx->head == NULL) { ssl_ctx->head = ssl; ssl_ctx->tail = ssl; } else { ssl->prev = ssl_ctx->tail; ssl_ctx->tail->next = ssl; ssl_ctx->tail = ssl; } SSL_CTX_UNLOCK(ssl_ctx->mutex); return ssl; } #endif /* * Get a new ssl context for a new connection.(raw api)add by ives 12.12.2013 */ SSL *ICACHE_FLASH_ATTR ssl_new_context(SSL_CTX *ssl_ctx, struct tcp_pcb *SslClient_pcb) { SSL *ssl = (SSL *)os_zalloc(sizeof(SSL)); ssl->ssl_ctx = ssl_ctx; ssl->need_bytes = SSL_RECORD_SIZE; /* need a record */ //ssl->client_fd = client_fd;annotation by ives 12.12.2013 ssl->SslClient_pcb = SslClient_pcb; ssl->ssl_pbuf = NULL; ssl->flag = SSL_NEED_RECORD; ssl->bm_data = ssl->bm_all_data + BM_RECORD_OFFSET; /* space at the start */ ssl->hs_status = SSL_NOT_OK; /* not connected */ #ifdef CONFIG_ENABLE_VERIFICATION ssl->ca_cert_ctx = ssl_ctx->ca_cert_ctx; #endif disposable_new(ssl); /* a bit hacky but saves a few bytes of memory */ ssl->flag |= ssl_ctx->options; SSL_CTX_LOCK(ssl_ctx->mutex); if (ssl_ctx->head == NULL) { ssl_ctx->head = ssl; ssl_ctx->tail = ssl; } else { ssl->prev = ssl_ctx->tail; ssl_ctx->tail->next = ssl; ssl_ctx->tail = ssl; } SSL_CTX_UNLOCK(ssl_ctx->mutex); return ssl; } /* * Add a private key to a context. */ int ICACHE_FLASH_ATTR add_private_key(SSL_CTX *ssl_ctx, SSLObjLoader *ssl_obj) { int ret = SSL_OK; /* get the private key details */ if (asn1_get_private_key(ssl_obj->buf, ssl_obj->len, &ssl_ctx->rsa_ctx)) { ret = SSL_ERROR_INVALID_KEY; goto error; } error: return ret; } /** * Increment the read sequence number (as a 64 bit endian indepenent #) */ static void ICACHE_FLASH_ATTR increment_read_sequence(SSL *ssl) { int i; for (i = 7; i >= 0; i--) { if (++ssl->read_sequence[i]) break; } } /** * Increment the read sequence number (as a 64 bit endian indepenent #) */ static void ICACHE_FLASH_ATTR increment_write_sequence(SSL *ssl) { int i; for (i = 7; i >= 0; i--) { if (++ssl->write_sequence[i]) break; } } /** * Work out the HMAC digest in a packet. */ static void ICACHE_FLASH_ATTR add_hmac_digest(SSL *ssl, int mode, uint8_t *hmac_header, const uint8_t *buf, int buf_len, uint8_t *hmac_buf) { int hmac_len = buf_len + 8 + SSL_RECORD_SIZE; uint8_t *t_buf = (uint8_t *)os_malloc(hmac_len+10); os_memcpy(t_buf, (mode == SSL_SERVER_WRITE || mode == SSL_CLIENT_WRITE) ? ssl->write_sequence : ssl->read_sequence, 8); os_memcpy(&t_buf[8], hmac_header, SSL_RECORD_SIZE); os_memcpy(&t_buf[8+SSL_RECORD_SIZE], buf, buf_len); ssl->cipher_info->hmac(t_buf, hmac_len, (mode == SSL_SERVER_WRITE || mode == SSL_CLIENT_READ) ? ssl->server_mac : ssl->client_mac, ssl->cipher_info->digest_size, hmac_buf); /* add by wujg */ os_free(t_buf); #if 0 print_blob("record", hmac_header, SSL_RECORD_SIZE); print_blob("buf", buf, buf_len); if (mode == SSL_SERVER_WRITE || mode == SSL_CLIENT_WRITE) { print_blob("write seq", ssl->write_sequence, 8); } else { print_blob("read seq", ssl->read_sequence, 8); } if (mode == SSL_SERVER_WRITE || mode == SSL_CLIENT_READ) { print_blob("server mac", ssl->server_mac, ssl->cipher_info->digest_size); } else { print_blob("client mac", ssl->client_mac, ssl->cipher_info->digest_size); } print_blob("hmac", hmac_buf, SHA1_SIZE); #endif } /** * Verify that the digest of a packet is correct. */ static int ICACHE_FLASH_ATTR verify_digest(SSL *ssl, int mode, const uint8_t *buf, int read_len) { uint8_t hmac_buf[SHA1_SIZE]; int hmac_offset; if (ssl->cipher_info->padding_size) { int last_blk_size = buf[read_len-1], i; hmac_offset = read_len-last_blk_size-ssl->cipher_info->digest_size-1; /* guard against a timing attack - make sure we do the digest */ if (hmac_offset < 0) { hmac_offset = 0; } else { /* already looked at last byte */ for (i = 1; i < last_blk_size; i++) { if (buf[read_len-i] != last_blk_size) { hmac_offset = 0; break; } } } } else /* stream cipher */ { hmac_offset = read_len - ssl->cipher_info->digest_size; if (hmac_offset < 0) { hmac_offset = 0; } } /* sanity check the offset */ ssl->hmac_header[3] = hmac_offset >> 8; /* insert size */ ssl->hmac_header[4] = hmac_offset & 0xff; add_hmac_digest(ssl, mode, ssl->hmac_header, buf, hmac_offset, hmac_buf); if (memcmp(hmac_buf, &buf[hmac_offset], ssl->cipher_info->digest_size)) { return SSL_ERROR_INVALID_HMAC; } return hmac_offset; } /** * Add a packet to the end of our sent and received packets, so that we may use * it to calculate the hash at the end. */ void ICACHE_FLASH_ATTR add_packet(SSL *ssl, const uint8_t *pkt, int len) { MD5_Update(&ssl->dc->md5_ctx, pkt, len); SHA1_Update(&ssl->dc->sha1_ctx, pkt, len); } /** * Work out the MD5 PRF. */ static void ICACHE_FLASH_ATTR p_hash_md5(const uint8_t *sec, int sec_len, uint8_t *seed, int seed_len, uint8_t *out, int olen) { uint8_t a1[128]; /* A(1) */ ssl_hmac_md5(seed, seed_len, sec, sec_len, a1); os_memcpy(&a1[MD5_SIZE], seed, seed_len); ssl_hmac_md5(a1, MD5_SIZE+seed_len, sec, sec_len, out); while (olen > MD5_SIZE) { uint8_t a2[MD5_SIZE]; out += MD5_SIZE; olen -= MD5_SIZE; /* A(N) */ ssl_hmac_md5(a1, MD5_SIZE, sec, sec_len, a2); os_memcpy(a1, a2, MD5_SIZE); /* work out the actual hash */ ssl_hmac_md5(a1, MD5_SIZE+seed_len, sec, sec_len, out); } } /** * Work out the SHA1 PRF. */ static void ICACHE_FLASH_ATTR p_hash_sha1(const uint8_t *sec, int sec_len, uint8_t *seed, int seed_len, uint8_t *out, int olen) { uint8_t a1[128]; /* A(1) */ ssl_hmac_sha1(seed, seed_len, sec, sec_len, a1); os_memcpy(&a1[SHA1_SIZE], seed, seed_len); ssl_hmac_sha1(a1, SHA1_SIZE+seed_len, sec, sec_len, out); while (olen > SHA1_SIZE) { uint8_t a2[SHA1_SIZE]; out += SHA1_SIZE; olen -= SHA1_SIZE; /* A(N) */ ssl_hmac_sha1(a1, SHA1_SIZE, sec, sec_len, a2); os_memcpy(a1, a2, SHA1_SIZE); /* work out the actual hash */ ssl_hmac_sha1(a1, SHA1_SIZE+seed_len, sec, sec_len, out); } } /** * Work out the PRF. */ static void ICACHE_FLASH_ATTR prf(const uint8_t *sec, int sec_len, uint8_t *seed, int seed_len, uint8_t *out, int olen) { int len, i; const uint8_t *S1, *S2; uint8_t xbuf[256]; /* needs to be > the amount of key data */ uint8_t ybuf[256]; /* needs to be > the amount of key data */ len = sec_len/2; S1 = sec; S2 = &sec[len]; len += (sec_len & 1); /* add for odd, make longer */ p_hash_md5(S1, len, seed, seed_len, xbuf, olen); p_hash_sha1(S2, len, seed, seed_len, ybuf, olen); for (i = 0; i < olen; i++) out[i] = xbuf[i] ^ ybuf[i]; } /** * Generate a master secret based on the client/server random data and the * premaster secret. */ void ICACHE_FLASH_ATTR generate_master_secret(SSL *ssl, const uint8_t *premaster_secret) { uint8_t buf[128]; /* needs to be > 13+32+32 in size */ os_strcpy((char *)buf, "master secret"); os_memcpy(&buf[13], ssl->dc->client_random, SSL_RANDOM_SIZE); os_memcpy(&buf[45], ssl->dc->server_random, SSL_RANDOM_SIZE); prf(premaster_secret, SSL_SECRET_SIZE, buf, 77, ssl->dc->master_secret, SSL_SECRET_SIZE); } /** * Generate a 'random' blob of data used for the generation of keys. */ static void ICACHE_FLASH_ATTR generate_key_block(uint8_t *client_random, uint8_t *server_random, uint8_t *master_secret, uint8_t *key_block, int key_block_size) { uint8_t buf[128]; os_strcpy((char *)buf, "key expansion"); os_memcpy(&buf[13], server_random, SSL_RANDOM_SIZE); os_memcpy(&buf[45], client_random, SSL_RANDOM_SIZE); prf(master_secret, SSL_SECRET_SIZE, buf, 77, key_block, key_block_size); } /** * Calculate the digest used in the finished message. This function also * doubles up as a certificate verify function. */ void ICACHE_FLASH_ATTR finished_digest(SSL *ssl, const char *label, uint8_t *digest) { uint8_t mac_buf[128]; uint8_t *q = mac_buf; MD5_CTX md5_ctx = ssl->dc->md5_ctx; SHA1_CTX sha1_ctx = ssl->dc->sha1_ctx; if (label) { os_strcpy((char *)q, label); q += os_strlen(label); } MD5_Final(q, &md5_ctx); q += MD5_SIZE; SHA1_Final(q, &sha1_ctx); q += SHA1_SIZE; if (label) { prf(ssl->dc->master_secret, SSL_SECRET_SIZE, mac_buf, (int)(q-mac_buf), digest, SSL_FINISHED_HASH_SIZE); } else /* for use in a certificate verify */ { os_memcpy(digest, mac_buf, MD5_SIZE + SHA1_SIZE); } #if 0 printf("label: %s\n", label); print_blob("master secret", ssl->dc->master_secret, 48); print_blob("mac_buf", mac_buf, q-mac_buf); print_blob("finished digest", digest, SSL_FINISHED_HASH_SIZE); #endif } /** * Retrieve (and initialise) the context of a cipher. */ static void *ICACHE_FLASH_ATTR crypt_new(SSL *ssl, uint8_t *key, uint8_t *iv, int is_decrypt) { switch (ssl->cipher) { #ifndef CONFIG_SSL_SKELETON_MODE case SSL_AES128_SHA: { AES_CTX *aes_ctx = (AES_CTX *)os_malloc(sizeof(AES_CTX)); AES_set_key(aes_ctx, key, iv, AES_MODE_128); if (is_decrypt) { AES_convert_key(aes_ctx); } return (void *)aes_ctx; } case SSL_AES256_SHA: { AES_CTX *aes_ctx = (AES_CTX *)os_malloc(sizeof(AES_CTX)); AES_set_key(aes_ctx, key, iv, AES_MODE_256); if (is_decrypt) { AES_convert_key(aes_ctx); } return (void *)aes_ctx; } case SSL_RC4_128_MD5: #endif case SSL_RC4_128_SHA: { RC4_CTX *rc4_ctx = (RC4_CTX *)os_malloc(sizeof(RC4_CTX)); RC4_setup(rc4_ctx, key, 16); return (void *)rc4_ctx; } } return NULL; /* its all gone wrong */ } /** * Send a packet over the socket. */ static err_t ICACHE_FLASH_ATTR send_raw_packet(SSL *ssl, uint8_t protocol) { uint8_t *rec_buf = ssl->bm_all_data; int pkt_size = SSL_RECORD_SIZE + ssl->bm_index; int Length = 0; //int ret = SSL_OK; err_t Err = ERR_OK; rec_buf[0] = protocol; rec_buf[1] = 0x03; /* version = 3.1 or higher */ rec_buf[2] = ssl->version & 0x0f; rec_buf[3] = ssl->bm_index >> 8; rec_buf[4] = ssl->bm_index & 0xff; //DISPLAY_BYTES(ssl, "sending %d bytes", ssl->bm_all_data, // pkt_size, pkt_size); ssl_printf("send_raw_packet pkt_size %d\n", pkt_size); if(tcp_sndbuf(ssl->SslClient_pcb) < pkt_size) { Length = tcp_sndbuf(ssl->SslClient_pcb); } else { Length = pkt_size; } if(Length > 2 * ssl->SslClient_pcb->mss) { Length = 2 * ssl->SslClient_pcb->mss; } do { Err = tcp_write(ssl->SslClient_pcb, &ssl->bm_all_data[0], Length, 0); if (Err == ERR_MEM) { Length /= 2; } } while(Err == ERR_MEM && Length > 1); ssl_printf("send_raw_packet Length %d\n", Length); if (Err == ERR_OK) { Err = tcp_output(ssl->SslClient_pcb); } SET_SSL_FLAG(SSL_NEED_RECORD); /* reset for next time */ //ssl->bm_index = 0; if (protocol != PT_APP_PROTOCOL_DATA) { /* always return SSL_OK during handshake */ ssl->bm_index = 0; Err = SSL_OK; } return Err; } /** * Send an encrypted packet with padding bytes if necessary. */ int ICACHE_FLASH_ATTR send_packet(SSL *ssl, uint8_t protocol, const uint8_t *in, int length) { int ret, msg_length = 0; /* if our state is bad, don't bother */ if (ssl->hs_status == SSL_ERROR_DEAD) return SSL_ERROR_CONN_LOST; if (in) /* has the buffer already been initialised? */ { os_memcpy(ssl->bm_data, in, length); } msg_length += length; if (IS_SET_SSL_FLAG(SSL_TX_ENCRYPTED)) { int mode = IS_SET_SSL_FLAG(SSL_IS_CLIENT) ? SSL_CLIENT_WRITE : SSL_SERVER_WRITE; uint8_t hmac_header[SSL_RECORD_SIZE] = { protocol, 0x03, /* version = 3.1 or higher */ ssl->version & 0x0f, msg_length >> 8, msg_length & 0xff }; if (protocol == PT_HANDSHAKE_PROTOCOL) { //DISPLAY_STATE(ssl, 1, ssl->bm_data[0], 0); if (ssl->bm_data[0] != HS_HELLO_REQUEST) { add_packet(ssl, ssl->bm_data, msg_length); } } /* add the packet digest */ add_hmac_digest(ssl, mode, hmac_header, ssl->bm_data, msg_length, &ssl->bm_data[msg_length]); msg_length += ssl->cipher_info->digest_size; /* add padding? */ if (ssl->cipher_info->padding_size) { int last_blk_size = msg_length%ssl->cipher_info->padding_size; int pad_bytes = ssl->cipher_info->padding_size - last_blk_size; /* ensure we always have at least 1 padding byte */ if (pad_bytes == 0) pad_bytes += ssl->cipher_info->padding_size; os_memset(&ssl->bm_data[msg_length], pad_bytes-1, pad_bytes); msg_length += pad_bytes; } //DISPLAY_BYTES(ssl, "unencrypted write", ssl->bm_data, msg_length); increment_write_sequence(ssl); /* add the explicit IV for TLS1.1 */ if (ssl->version >= SSL_PROTOCOL_VERSION1_1 && ssl->cipher_info->iv_size) { uint8_t iv_size = ssl->cipher_info->iv_size; uint8_t *t_buf = (uint8_t *)os_malloc(msg_length + iv_size); os_memcpy(t_buf + iv_size, ssl->bm_data, msg_length); get_random(iv_size, t_buf); msg_length += iv_size; os_memcpy(ssl->bm_data, t_buf, msg_length); os_free(t_buf); /* add by wujg */ } /* now encrypt the packet */ ssl->cipher_info->encrypt(ssl->encrypt_ctx, ssl->bm_data, ssl->bm_data, msg_length); } else if (protocol == PT_HANDSHAKE_PROTOCOL) { //DISPLAY_STATE(ssl, 1, ssl->bm_data[0], 0); if (ssl->bm_data[0] != HS_HELLO_REQUEST) { add_packet(ssl, ssl->bm_data, length); } } ssl->bm_index = msg_length; if ((ret = send_raw_packet(ssl, protocol)) <= 0) return ret; return length; /* just return what we wanted to send */ } /** * Work out the cipher keys we are going to use for this session based on the * master secret. */ static int ICACHE_FLASH_ATTR set_key_block(SSL *ssl, int is_write) { const cipher_info_t *ciph_info = get_cipher_info(ssl->cipher); uint8_t *q; uint8_t client_key[32], server_key[32]; /* big enough for AES256 */ uint8_t client_iv[16], server_iv[16]; /* big enough for AES128/256 */ int is_client = IS_SET_SSL_FLAG(SSL_IS_CLIENT); if (ciph_info == NULL) return -1; /* only do once in a handshake */ if (ssl->dc->key_block == NULL) { ssl->dc->key_block = (uint8_t *)os_malloc(ciph_info->key_block_size); #if 0 print_blob("client", ssl->dc->client_random, 32); print_blob("server", ssl->dc->server_random, 32); print_blob("master", ssl->dc->master_secret, SSL_SECRET_SIZE); #endif generate_key_block(ssl->dc->client_random, ssl->dc->server_random, ssl->dc->master_secret, ssl->dc->key_block, ciph_info->key_block_size); #if 0 print_blob("keyblock", ssl->dc->key_block, ciph_info->key_block_size); #endif } q = ssl->dc->key_block; if ((is_client && is_write) || (!is_client && !is_write)) { os_memcpy(ssl->client_mac, q, ciph_info->digest_size); } q += ciph_info->digest_size; if ((!is_client && is_write) || (is_client && !is_write)) { os_memcpy(ssl->server_mac, q, ciph_info->digest_size); } q += ciph_info->digest_size; os_memcpy(client_key, q, ciph_info->key_size); q += ciph_info->key_size; os_memcpy(server_key, q, ciph_info->key_size); q += ciph_info->key_size; #ifndef CONFIG_SSL_SKELETON_MODE if (ciph_info->iv_size) /* RC4 has no IV, AES does */ { os_memcpy(client_iv, q, ciph_info->iv_size); q += ciph_info->iv_size; os_memcpy(server_iv, q, ciph_info->iv_size); q += ciph_info->iv_size; } #endif os_free(is_write ? ssl->encrypt_ctx : ssl->decrypt_ctx); /* now initialise the ciphers */ if (is_client) { finished_digest(ssl, server_finished, ssl->dc->final_finish_mac); if (is_write) ssl->encrypt_ctx = crypt_new(ssl, client_key, client_iv, 0); else ssl->decrypt_ctx = crypt_new(ssl, server_key, server_iv, 1); } else { finished_digest(ssl, client_finished, ssl->dc->final_finish_mac); if (is_write) ssl->encrypt_ctx = crypt_new(ssl, server_key, server_iv, 0); else ssl->decrypt_ctx = crypt_new(ssl, client_key, client_iv, 1); } ssl->cipher_info = ciph_info; return 0; } /** * Read the SSL connection. */ int ICACHE_FLASH_ATTR basic_read(SSL *ssl, uint8_t **in_data) { int ret = SSL_OK; int j,i = 0; int read_len, is_client = IS_SET_SSL_FLAG(SSL_IS_CLIENT); uint8_t *buf = ssl->bm_data; uint8_t *read_buf = NULL; uint8_t *pread_buf = NULL; u16_t recvlength = 0; read_buf =(uint8_t*)os_zalloc(ssl->ssl_pbuf->len + 1); pread_buf = read_buf; if (pread_buf != NULL){ recvlength = pbuf_copy_partial(ssl->ssl_pbuf, read_buf,ssl->ssl_pbuf->len,0); } if (recvlength != 0){ do{ // ssl_printf("basic_read ssl->bm_read_index %d\n", ssl->bm_read_index); // ssl_printf("basic_read ssl->need_bytes %d\n", ssl->need_bytes); // ssl_printf("basic_read ssl->got_bytes %d\n", ssl->got_bytes); read_len = ssl->need_bytes - ssl->got_bytes; if (read_len >= recvlength){ read_len = recvlength; } os_memcpy(&buf[ssl->bm_read_index],read_buf, read_len); // ssl_printf("basic_read read_len %d\n", read_len); // for (i = ssl->bm_read_index; i < (ssl->bm_read_index + read_len); i ++){ // ssl_printf("%2x ",buf[i]); // if ((i + 1) % 16 == 0) // ssl_printf("\n"); // } // ssl_printf("\n"); read_buf += read_len; recvlength -= read_len; // ssl_printf("basic_read %d %d\n", __LINE__, recvlength); /* connection has gone, so die */ if (read_len <= 0) { ret = SSL_ERROR_CONN_LOST; ssl->hs_status = SSL_ERROR_DEAD; /* make sure it stays dead */ goto error; } //DISPLAY_BYTES(ssl, "received %d bytes", // &ssl->bm_data[ssl->bm_read_index], read_len, read_len); ssl->got_bytes += read_len; ssl->bm_read_index += read_len; /* haven't quite got what we want, so try again later */ if (ssl->got_bytes < ssl->need_bytes){ // ssl_printf("basic_read %d %p\n", __LINE__, pread_buf); os_free(pread_buf); pread_buf = NULL; return SSL_OK; } read_len = ssl->got_bytes; ssl->got_bytes = 0; if (IS_SET_SSL_FLAG(SSL_NEED_RECORD)) { /* check for sslv2 "client hello" */ if (buf[0] & 0x80 && buf[2] == 1) { #ifdef CONFIG_SSL_ENABLE_V23_HANDSHAKE uint8_t version = (buf[3] << 4) + buf[4]; DISPLAY_BYTES(ssl, "ssl2 record", buf, 5); /* should be v3.1 (TLSv1) or better */ ssl->version = ssl->client_version = version; if (version > SSL_PROTOCOL_VERSION_MAX) { /* use client's version */ ssl->version = SSL_PROTOCOL_VERSION_MAX; } else if (version < SSL_PROTOCOL_MIN_VERSION) { ret = SSL_ERROR_INVALID_VERSION; ssl_display_error(ret); return ret; } add_packet(ssl, &buf[2], 3); ret = process_sslv23_client_hello(ssl); #else ssl_printf("Error: no SSLv23 handshaking allowed\n"); //TTY_FLUSH(); ret = SSL_ERROR_NOT_SUPPORTED; #endif goto error; /* not an error - just get out of here */ } ssl->need_bytes = (buf[3] << 8) + buf[4]; /* do we violate the spec with the message size? */ if (ssl->need_bytes > RT_MAX_PLAIN_LENGTH+RT_EXTRA-BM_RECORD_OFFSET) { ret = SSL_ERROR_INVALID_PROT_MSG; recvlength = 0; os_printf("we violate the spec with the message size\n"); goto error; } CLR_SSL_FLAG(SSL_NEED_RECORD); os_memcpy(ssl->hmac_header, buf, 3); /* store for hmac */ ssl->record_type = buf[0]; goto error; /* no error, we're done */ } /* for next time - just do it now in case of an error */ SET_SSL_FLAG(SSL_NEED_RECORD); ssl->need_bytes = SSL_RECORD_SIZE; /* decrypt if we need to */ if (IS_SET_SSL_FLAG(SSL_RX_ENCRYPTED)) { ssl->cipher_info->decrypt(ssl->decrypt_ctx, buf, buf, read_len); if (ssl->version >= SSL_PROTOCOL_VERSION1_1 && ssl->cipher_info->iv_size) { buf += ssl->cipher_info->iv_size; read_len -= ssl->cipher_info->iv_size; } read_len = verify_digest(ssl, is_client ? SSL_CLIENT_READ : SSL_SERVER_READ, buf, read_len); /* does the hmac work? */ if (read_len < 0) { ret = read_len; goto error; } //DISPLAY_BYTES(ssl, "decrypted", buf, read_len); increment_read_sequence(ssl); } /* The main part of the SSL packet */ //ssl_printf("basic_read %d %x %p\n", __LINE__, ssl->record_type, in_data); switch (ssl->record_type) { case PT_HANDSHAKE_PROTOCOL: if (ssl->dc != NULL) { ssl->dc->bm_proc_index = 0; ret = do_handshake(ssl, buf, read_len); } else /* no client renegotiation allowed */ { ret = SSL_ERROR_NO_CLIENT_RENOG; goto error; } break; case PT_CHANGE_CIPHER_SPEC: if (ssl->next_state != HS_FINISHED) { ret = SSL_ERROR_INVALID_HANDSHAKE; goto error; } /* all encrypted from now on */ SET_SSL_FLAG(SSL_RX_ENCRYPTED); if (set_key_block(ssl, 0) < 0) { ret = SSL_ERROR_INVALID_HANDSHAKE; goto error; } os_memset(ssl->read_sequence, 0, 8); break; case PT_APP_PROTOCOL_DATA: if (in_data) { *in_data = buf; /* point to the work buffer */ (*in_data)[read_len] = 0; /* null terminate just in case */ } ret = read_len; recvlength = 0; break; case PT_ALERT_PROTOCOL: /* return the alert # with alert bit set */ if(buf[0] == SSL_ALERT_TYPE_WARNING && buf[1] == SSL_ALERT_CLOSE_NOTIFY) { ret = SSL_CLOSE_NOTIFY; //send_alert(ssl, SSL_ALERT_CLOSE_NOTIFY); SET_SSL_FLAG(SSL_SENT_CLOSE_NOTIFY); } else { ret = -buf[1]; //DISPLAY_ALERT(ssl, buf[1]); } break; default: ret = SSL_ERROR_INVALID_PROT_MSG; break; } error: ssl->bm_read_index = 0; /* reset to go again */ if (ret < SSL_OK && in_data)/* if all wrong, then clear this buffer ptr */ *in_data = NULL; }while(recvlength != 0); }else{ ssl_printf("%s %d %d\n", __func__, __LINE__,recvlength); } os_free(pread_buf); pread_buf = NULL; return ret; } /** * Do some basic checking of data and then perform the appropriate handshaking. */ static int ICACHE_FLASH_ATTR do_handshake(SSL *ssl, uint8_t *buf, int read_len) { int hs_len = (buf[2]<<8) + buf[3]; uint8_t handshake_type = buf[0]; int ret = SSL_OK; int is_client = IS_SET_SSL_FLAG(SSL_IS_CLIENT); /* some integrity checking on the handshake */ PARANOIA_CHECK(read_len-SSL_HS_HDR_SIZE, hs_len); if (handshake_type != ssl->next_state) { /* handle a special case on the client */ if (!is_client || handshake_type != HS_CERT_REQ || ssl->next_state != HS_SERVER_HELLO_DONE) { ret = SSL_ERROR_INVALID_HANDSHAKE; goto error; } } hs_len += SSL_HS_HDR_SIZE; /* adjust for when adding packets */ ssl->bm_index = hs_len; /* store the size and check later */ //DISPLAY_STATE(ssl, 0, handshake_type, 0); if (handshake_type != HS_CERT_VERIFY && handshake_type != HS_HELLO_REQUEST) add_packet(ssl, buf, hs_len); #if defined(CONFIG_SSL_ENABLE_CLIENT) ret = is_client ? do_clnt_handshake(ssl, handshake_type, buf, hs_len) : do_svr_handshake(ssl, handshake_type, buf, hs_len); #else ret = do_svr_handshake(ssl, handshake_type, buf, hs_len); #endif /* just use recursion to get the rest */ if (hs_len < read_len && ret == SSL_OK) ret = do_handshake(ssl, &buf[hs_len], read_len-hs_len); error: return ret; } /** * Sends the change cipher spec message. We have just read a finished message * from the client. */ int ICACHE_FLASH_ATTR send_change_cipher_spec(SSL *ssl) { int ret = send_packet(ssl, PT_CHANGE_CIPHER_SPEC, g_chg_cipher_spec_pkt, sizeof(g_chg_cipher_spec_pkt)); SET_SSL_FLAG(SSL_TX_ENCRYPTED); if (ret >= 0 && set_key_block(ssl, 1) < 0) ret = SSL_ERROR_INVALID_HANDSHAKE; os_memset(ssl->write_sequence, 0, 8); return ret; } /** * Send a "finished" message */ int ICACHE_FLASH_ATTR send_finished(SSL *ssl) { uint8_t buf[SSL_FINISHED_HASH_SIZE+4] = { HS_FINISHED, 0, 0, SSL_FINISHED_HASH_SIZE }; /* now add the finished digest mac (12 bytes) */ finished_digest(ssl, IS_SET_SSL_FLAG(SSL_IS_CLIENT) ? client_finished : server_finished, &buf[4]); #ifndef CONFIG_SSL_SKELETON_MODE /* store in the session cache */ if (!IS_SET_SSL_FLAG(SSL_SESSION_RESUME) && ssl->ssl_ctx->num_sessions) { os_memcpy(ssl->session->master_secret, ssl->dc->master_secret, SSL_SECRET_SIZE); } #endif return send_packet(ssl, PT_HANDSHAKE_PROTOCOL, buf, SSL_FINISHED_HASH_SIZE+4); } /** * Send an alert message. * Return 1 if the alert was an "error". */ int ICACHE_FLASH_ATTR send_alert(SSL *ssl, int error_code) { int alert_num = 0; int is_warning = 0; uint8_t buf[2]; /* Don't bother we're already dead */ if (ssl->hs_status == SSL_ERROR_DEAD) { return SSL_ERROR_CONN_LOST; } #ifdef CONFIG_SSL_FULL_MODE //if (IS_SET_SSL_FLAG(SSL_DISPLAY_STATES)) //ssl_display_error(error_code); #endif switch (error_code) { case SSL_ALERT_CLOSE_NOTIFY: is_warning = 1; alert_num = SSL_ALERT_CLOSE_NOTIFY; break; case SSL_ERROR_CONN_LOST: /* don't send alert just yet */ is_warning = 1; break; case SSL_ERROR_INVALID_HANDSHAKE: case SSL_ERROR_INVALID_PROT_MSG: alert_num = SSL_ALERT_HANDSHAKE_FAILURE; break; case SSL_ERROR_INVALID_HMAC: case SSL_ERROR_FINISHED_INVALID: alert_num = SSL_ALERT_BAD_RECORD_MAC; break; case SSL_ERROR_INVALID_VERSION: alert_num = SSL_ALERT_INVALID_VERSION; break; case SSL_ERROR_INVALID_SESSION: case SSL_ERROR_NO_CIPHER: case SSL_ERROR_INVALID_KEY: alert_num = SSL_ALERT_ILLEGAL_PARAMETER; break; case SSL_ERROR_BAD_CERTIFICATE: alert_num = SSL_ALERT_BAD_CERTIFICATE; break; case SSL_ERROR_NO_CLIENT_RENOG: alert_num = SSL_ALERT_NO_RENEGOTIATION; break; default: /* a catch-all for any badly verified certificates */ alert_num = (error_code <= SSL_X509_OFFSET) ? SSL_ALERT_BAD_CERTIFICATE : SSL_ALERT_UNEXPECTED_MESSAGE; break; } buf[0] = is_warning ? 1 : 2; buf[1] = alert_num; send_packet(ssl, PT_ALERT_PROTOCOL, buf, sizeof(buf)); //DISPLAY_ALERT(ssl, alert_num); return is_warning ? 0 : 1; } /** * Process a client finished message. */ int ICACHE_FLASH_ATTR process_finished(SSL *ssl, uint8_t *buf, int hs_len) { int ret = SSL_OK; int is_client = IS_SET_SSL_FLAG(SSL_IS_CLIENT); int resume = IS_SET_SSL_FLAG(SSL_SESSION_RESUME); PARANOIA_CHECK(ssl->bm_index, SSL_FINISHED_HASH_SIZE+4); /* check that we all work before we continue */ if (os_memcmp(ssl->dc->final_finish_mac, &buf[4], SSL_FINISHED_HASH_SIZE)) return SSL_ERROR_FINISHED_INVALID; if ((!is_client && !resume) || (is_client && resume)) { if ((ret = send_change_cipher_spec(ssl)) == SSL_OK) ret = send_finished(ssl); } /* if we ever renegotiate */ ssl->next_state = is_client ? HS_HELLO_REQUEST : HS_CLIENT_HELLO; ssl->hs_status = ret; /* set the final handshake status */ error: return ret; } /** * Send a certificate. */ int ICACHE_FLASH_ATTR send_certificate(SSL *ssl) { int i = 0; uint8_t *buf = ssl->bm_data; int offset = 7; int chain_length; buf[0] = HS_CERTIFICATE; buf[1] = 0; buf[4] = 0; while (i < ssl->ssl_ctx->chain_length) { SSL_CERT *cert = &ssl->ssl_ctx->certs[i]; buf[offset++] = 0; buf[offset++] = cert->size >> 8; /* cert 1 length */ buf[offset++] = cert->size & 0xff; os_memcpy(&buf[offset], cert->buf, cert->size); offset += cert->size; i++; } chain_length = offset - 7; buf[5] = chain_length >> 8; /* cert chain length */ buf[6] = chain_length & 0xff; chain_length += 3; buf[2] = chain_length >> 8; /* handshake length */ buf[3] = chain_length & 0xff; ssl->bm_index = offset; return send_packet(ssl, PT_HANDSHAKE_PROTOCOL, NULL, offset); } /** * Create a blob of memory that we'll get rid of once the handshake is * complete. */ void ICACHE_FLASH_ATTR disposable_new(SSL *ssl) { if (ssl->dc == NULL) { ssl->dc = (DISPOSABLE_CTX *)os_zalloc(sizeof(DISPOSABLE_CTX)); MD5_Init(&ssl->dc->md5_ctx); SHA1_Init(&ssl->dc->sha1_ctx); } } /** * Remove the temporary blob of memory. */ void ICACHE_FLASH_ATTR disposable_free(SSL *ssl) { if (ssl->dc) { os_free(ssl->dc->key_block); os_memset(ssl->dc, 0, sizeof(DISPOSABLE_CTX)); os_free(ssl->dc); ssl->dc = NULL; } } #ifndef CONFIG_SSL_SKELETON_MODE /* no session resumption in this mode */ /** * Find if an existing session has the same session id. If so, use the * master secret from this session for session resumption. */ SSL_SESSION *ICACHE_FLASH_ATTR ssl_session_update(int max_sessions, SSL_SESSION *ssl_sessions[], SSL *ssl, const uint8_t *session_id) { time_t tm = 0; //time(NULL); wujg time_t oldest_sess_time = tm; SSL_SESSION *oldest_sess = NULL; int i; /* no sessions? Then bail */ if (max_sessions == 0) return NULL; SSL_CTX_LOCK(ssl->ssl_ctx->mutex); if (session_id) { for (i = 0; i < max_sessions; i++) { if (ssl_sessions[i]) { /* kill off any expired sessions (including those in the future) */ if ((tm > ssl_sessions[i]->conn_time + SSL_EXPIRY_TIME) || (tm < ssl_sessions[i]->conn_time)) { session_free(ssl_sessions, i); continue; } /* if the session id matches, it must still be less than the expiry time */ if (os_memcmp(ssl_sessions[i]->session_id, session_id, SSL_SESSION_ID_SIZE) == 0) { ssl->session_index = i; os_memcpy(ssl->dc->master_secret, ssl_sessions[i]->master_secret, SSL_SECRET_SIZE); SET_SSL_FLAG(SSL_SESSION_RESUME); SSL_CTX_UNLOCK(ssl->ssl_ctx->mutex); return ssl_sessions[i]; /* a session was found */ } } } } /* If we've got here, no matching session was found - so create one */ for (i = 0; i < max_sessions; i++) { if (ssl_sessions[i] == NULL) { /* perfect, this will do */ ssl_sessions[i] = (SSL_SESSION *)os_zalloc(sizeof(SSL_SESSION)); ssl_sessions[i]->conn_time = tm; ssl->session_index = i; SSL_CTX_UNLOCK(ssl->ssl_ctx->mutex); return ssl_sessions[i]; /* return the session object */ } else if (ssl_sessions[i]->conn_time <= oldest_sess_time) { /* find the oldest session */ oldest_sess_time = ssl_sessions[i]->conn_time; oldest_sess = ssl_sessions[i]; ssl->session_index = i; } } /* ok, we've used up all of our sessions. So blow the oldest session away */ oldest_sess->conn_time = tm; os_memset(oldest_sess->session_id, 0, sizeof(SSL_SESSION_ID_SIZE)); os_memset(oldest_sess->master_secret, 0, sizeof(SSL_SECRET_SIZE)); SSL_CTX_UNLOCK(ssl->ssl_ctx->mutex); return oldest_sess; } /** * Free an existing session. */ static void ICACHE_FLASH_ATTR session_free(SSL_SESSION *ssl_sessions[], int sess_index) { if (ssl_sessions[sess_index]) { os_free(ssl_sessions[sess_index]); ssl_sessions[sess_index] = NULL; } } /** * This ssl object doesn't want this session anymore. */ void ICACHE_FLASH_ATTR kill_ssl_session(SSL_SESSION **ssl_sessions, SSL *ssl) { SSL_CTX_LOCK(ssl->ssl_ctx->mutex); if (ssl->ssl_ctx->num_sessions) { session_free(ssl_sessions, ssl->session_index); ssl->session = NULL; } SSL_CTX_UNLOCK(ssl->ssl_ctx->mutex); } #endif /* CONFIG_SSL_SKELETON_MODE */ /* * Get the session id for a handshake. This will be a 32 byte sequence. */ EXP_FUNC const uint8_t * STDCALL ICACHE_FLASH_ATTR ssl_get_session_id(const SSL *ssl) { return ssl->session_id; } /* * Get the session id size for a handshake. */ EXP_FUNC uint8_t STDCALL ICACHE_FLASH_ATTR ssl_get_session_id_size(const SSL *ssl) { return ssl->sess_id_size; } /* * Return the cipher id (in the SSL form). */ EXP_FUNC uint8_t STDCALL ICACHE_FLASH_ATTR ssl_get_cipher_id(const SSL *ssl) { return ssl->cipher; } /* * Return the status of the handshake. */ EXP_FUNC int STDCALL ICACHE_FLASH_ATTR ssl_handshake_status(const SSL *ssl) { return ssl->hs_status; } /* * Retrieve various parameters about the SSL engine. */ EXP_FUNC int STDCALL ICACHE_FLASH_ATTR ssl_get_config(int offset) { switch (offset) { /* return the appropriate build mode */ case SSL_BUILD_MODE: #if defined(CONFIG_SSL_FULL_MODE) return SSL_BUILD_FULL_MODE; #elif defined(CONFIG_SSL_ENABLE_CLIENT) return SSL_BUILD_ENABLE_CLIENT; #elif defined(CONFIG_ENABLE_VERIFICATION) return SSL_BUILD_ENABLE_VERIFICATION; #elif defined(CONFIG_SSL_SERVER_ONLY ) return SSL_BUILD_SERVER_ONLY; #else return SSL_BUILD_SKELETON_MODE; #endif case SSL_MAX_CERT_CFG_OFFSET: return CONFIG_SSL_MAX_CERTS; #ifdef CONFIG_SSL_CERT_VERIFICATION case SSL_MAX_CA_CERT_CFG_OFFSET: return CONFIG_X509_MAX_CA_CERTS; #endif #ifdef CONFIG_SSL_HAS_PEM case SSL_HAS_PEM: return 1; #endif default: return 0; } } #ifdef CONFIG_SSL_CERT_VERIFICATION /** * Authenticate a received certificate. */ EXP_FUNC int STDCALL ICACHE_FLASH_ATTR ssl_verify_cert(const SSL *ssl) { int ret; SSL_CTX_LOCK(ssl->ssl_ctx->mutex); ret = x509_verify(ssl->ssl_ctx->ca_cert_ctx, ssl->x509_ctx); SSL_CTX_UNLOCK(ssl->ssl_ctx->mutex); if (ret) /* modify into an SSL error type */ { ret = SSL_X509_ERROR(ret); } return ret; } /** * Process a certificate message. */ int ICACHE_FLASH_ATTR process_certificate(SSL *ssl, X509_CTX **x509_ctx) { int ret = SSL_OK; uint8_t *buf = &ssl->bm_data[ssl->dc->bm_proc_index]; int pkt_size = ssl->bm_index; int cert_size, offset = 5; int total_cert_size = (buf[offset]<<8) + buf[offset+1]; int is_client = IS_SET_SSL_FLAG(SSL_IS_CLIENT); X509_CTX **chain = x509_ctx; offset += 2; PARANOIA_CHECK(total_cert_size, offset); while (offset < total_cert_size) { offset++; /* skip empty char */ cert_size = (buf[offset]<<8) + buf[offset+1]; offset += 2; if (x509_new(&buf[offset], NULL, chain)) { ret = SSL_ERROR_BAD_CERTIFICATE; goto error; } chain = &((*chain)->next); offset += cert_size; } PARANOIA_CHECK(pkt_size, offset); /* if we are client we can do the verify now or later */ if (is_client && !IS_SET_SSL_FLAG(SSL_SERVER_VERIFY_LATER)) { ret = ssl_verify_cert(ssl); } ssl->next_state = is_client ? HS_SERVER_HELLO_DONE : HS_CLIENT_KEY_XCHG; ssl->dc->bm_proc_index += offset; error: return ret; } #endif /* CONFIG_SSL_CERT_VERIFICATION */ /** * Debugging routine to display SSL handshaking stuff. */ #ifdef CONFIG_SSL_FULL_MODE /** * Debugging routine to display SSL states. */ #if 0 void ICACHE_FLASH_ATTR DISPLAY_STATE(SSL *ssl, int is_send, uint8_t state, int not_ok) { const char *str; if (!IS_SET_SSL_FLAG(SSL_DISPLAY_STATES)) return; ssl_printf(not_ok ? "Error - invalid State:\t" : "State:\t"); ssl_printf(is_send ? "sending " : "receiving "); switch (state) { case HS_HELLO_REQUEST: str = "Hello Request (0)"; break; case HS_CLIENT_HELLO: str = "Client Hello (1)"; break; case HS_SERVER_HELLO: str = "Server Hello (2)"; break; case HS_CERTIFICATE: str = "Certificate (11)"; break; case HS_SERVER_KEY_XCHG: str = "Certificate Request (12)"; break; case HS_CERT_REQ: str = "Certificate Request (13)"; break; case HS_SERVER_HELLO_DONE: str = "Server Hello Done (14)"; break; case HS_CERT_VERIFY: str = "Certificate Verify (15)"; break; case HS_CLIENT_KEY_XCHG: str = "Client Key Exchange (16)"; break; case HS_FINISHED: str = "Finished (16)"; break; default: str = "Error (Unknown)"; break; } ssl_printf("%s\n", str); //TTY_FLUSH(); } /** * Debugging routine to display RSA objects */ void ICACHE_FLASH_ATTR DISPLAY_RSA(SSL *ssl, const RSA_CTX *rsa_ctx) { if (!IS_SET_SSL_FLAG(SSL_DISPLAY_RSA)) return; RSA_print(rsa_ctx); //TTY_FLUSH(); } /** * Debugging routine to display SSL handshaking bytes. */ void ICACHE_FLASH_ATTR DISPLAY_BYTES(SSL *ssl, const char *format, const uint8_t *data, int size, ...) { // wujg : pass compile first // va_list(ap); // if (!IS_SET_SSL_FLAG(SSL_DISPLAY_BYTES)) // return; // va_start(ap, size); // print_blob(format, data, size, va_arg(ap, char *)); // va_end(ap); // TTY_FLUSH(); } /** * Debugging routine to display SSL handshaking errors. */ EXP_FUNC void STDCALL ICACHE_FLASH_ATTR ssl_display_error(int error_code) { if (error_code == SSL_OK) return; ssl_printf("Error: "); /* X509 error? */ if (error_code < SSL_X509_OFFSET) { ssl_printf("%s\n", x509_display_error(error_code - SSL_X509_OFFSET)); return; } /* SSL alert error code */ if (error_code > SSL_ERROR_CONN_LOST) { ssl_printf("SSL error %d\n", -error_code); return; } switch (error_code) { case SSL_ERROR_DEAD: ssl_printf("connection dead"); break; case SSL_ERROR_INVALID_HANDSHAKE: ssl_printf("invalid handshake"); break; case SSL_ERROR_INVALID_PROT_MSG: ssl_printf("invalid protocol message"); break; case SSL_ERROR_INVALID_HMAC: ssl_printf("invalid mac"); break; case SSL_ERROR_INVALID_VERSION: ssl_printf("invalid version"); break; case SSL_ERROR_INVALID_SESSION: ssl_printf("invalid session"); break; case SSL_ERROR_NO_CIPHER: ssl_printf("no cipher"); break; case SSL_ERROR_CONN_LOST: ssl_printf("connection lost"); break; case SSL_ERROR_BAD_CERTIFICATE: ssl_printf("bad certificate"); break; case SSL_ERROR_INVALID_KEY: ssl_printf("invalid key"); break; case SSL_ERROR_FINISHED_INVALID: ssl_printf("finished invalid"); break; case SSL_ERROR_NO_CERT_DEFINED: ssl_printf("no certificate defined"); break; case SSL_ERROR_NO_CLIENT_RENOG: ssl_printf("client renegotiation not supported"); break; case SSL_ERROR_NOT_SUPPORTED: ssl_printf("Option not supported"); break; default: ssl_printf("undefined as yet - %d", error_code); break; } ssl_printf("\n"); //TTY_FLUSH(); } /** * Debugging routine to display alerts. */ void ICACHE_FLASH_ATTR DISPLAY_ALERT(SSL *ssl, int alert) { if (!IS_SET_SSL_FLAG(SSL_DISPLAY_STATES)) return; ssl_printf("Alert: "); switch (alert) { case SSL_ALERT_CLOSE_NOTIFY: ssl_printf("close notify"); break; case SSL_ALERT_INVALID_VERSION: ssl_printf("invalid version"); break; case SSL_ALERT_BAD_CERTIFICATE: ssl_printf("bad certificate"); break; case SSL_ALERT_UNEXPECTED_MESSAGE: ssl_printf("unexpected message"); break; case SSL_ALERT_BAD_RECORD_MAC: ssl_printf("bad record mac"); break; case SSL_ALERT_HANDSHAKE_FAILURE: ssl_printf("handshake failure"); break; case SSL_ALERT_ILLEGAL_PARAMETER: ssl_printf("illegal parameter"); break; case SSL_ALERT_DECODE_ERROR: ssl_printf("decode error"); break; case SSL_ALERT_DECRYPT_ERROR: ssl_printf("decrypt error"); break; case SSL_ALERT_NO_RENEGOTIATION: ssl_printf("no renegotiation"); break; default: ssl_printf("alert - (unknown %d)", alert); break; } ssl_printf("\n"); //TTY_FLUSH(); } #endif #endif /* CONFIG_SSL_FULL_MODE */ /** * Return the version of this library. */ EXP_FUNC const char * STDCALL ICACHE_FLASH_ATTR ssl_version() { static const char * axtls_version = AXTLS_VERSION; return axtls_version; } /** * Enable the various language bindings to work regardless of the * configuration - they just return an error statement and a bad return code. */ #if !defined(CONFIG_SSL_FULL_MODE) EXP_FUNC void STDCALL ssl_display_error(int error_code) {} #endif #ifdef CONFIG_BINDINGS #if !defined(CONFIG_SSL_ENABLE_CLIENT) EXP_FUNC SSL * STDCALL ICACHE_FLASH_ATTR ssl_client_new(SSL_CTX *ssl_ctx, int client_fd, const uint8_t *session_id, uint8_t sess_id_size) { ssl_printf(unsupported_str); return NULL; } #endif #if !defined(CONFIG_SSL_CERT_VERIFICATION) EXP_FUNC int STDCALL ICACHE_FLASH_ATTR ssl_verify_cert(const SSL *ssl) { ssl_printf(unsupported_str); return -1; } EXP_FUNC const char * STDCALL ICACHE_FLASH_ATTR ssl_get_cert_dn(const SSL *ssl, int component) { ssl_printf(unsupported_str); return NULL; } EXP_FUNC const char * STDCALL ICACHE_FLASH_ATTR ssl_get_cert_subject_alt_dnsname(const SSL *ssl, int index) { ssl_printf(unsupported_str); return NULL; } #endif /* CONFIG_SSL_CERT_VERIFICATION */ #endif /* CONFIG_BINDINGS */ ================================================ FILE: app/ssl/ssl/ssl_tls1_clnt.c ================================================ /* * Copyright (c) 2007, Cameron Rich * * 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 axTLS project 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 //#include //#include //#include #include "ssl/ssl_os_port.h" #include "ssl/ssl_ssl.h" #include "lwip/tcp.h" #include "ssl/app/espconn_ssl.h" #ifdef CONFIG_SSL_ENABLE_CLIENT /* all commented out if no client */ static int send_client_hello(SSL *ssl); static int process_server_hello(SSL *ssl); static int process_server_hello_done(SSL *ssl); static int send_client_key_xchg(SSL *ssl); static int process_cert_req(SSL *ssl); static int send_cert_verify(SSL *ssl); #if 0 /* * Establish a new SSL connection to an SSL server. */ EXP_FUNC SSL * STDCALL ICACHE_FLASH_ATTR ssl_client_new(SSL_CTX *ssl_ctx, int client_fd, const uint8_t *session_id, uint8_t sess_id_size) { SSL *ssl = ssl_new(ssl_ctx, client_fd); ssl->version = SSL_PROTOCOL_VERSION_MAX; /* try top version first */ if (session_id && ssl_ctx->num_sessions) { if (sess_id_size > SSL_SESSION_ID_SIZE) /* validity check */ { ssl_free(ssl); return NULL; } os_memcpy(ssl->session_id, session_id, sess_id_size); ssl->sess_id_size = sess_id_size; SET_SSL_FLAG(SSL_SESSION_RESUME); /* just flag for later */ } SET_SSL_FLAG(SSL_IS_CLIENT); do_client_connect(ssl); return ssl; } #endif /* * Establish a new SSL connection to an SSL server.(raw api)add by ives 12.12.2013 */ EXP_FUNC SSL *STDCALL ICACHE_FLASH_ATTR SSLClient_new(SSL_CTX *ssl_ctx, struct tcp_pcb *SslClient_pcb, const uint8_t *session_id, uint8_t sess_id_size) { SSL *ssl = ssl_new_context(ssl_ctx, SslClient_pcb); ssl->version = SSL_PROTOCOL_VERSION_MAX; if (session_id && ssl_ctx->num_sessions) { if (sess_id_size > SSL_SESSION_ID_SIZE) { ssl_free(ssl); return NULL; } os_memcpy(ssl->session_id, session_id, sess_id_size); ssl->sess_id_size = sess_id_size; SET_SSL_FLAG(SSL_SESSION_RESUME); } SET_SSL_FLAG(SSL_IS_CLIENT); do_client_connect(ssl); return ssl; } /* * Process the handshake record. */ int ICACHE_FLASH_ATTR do_clnt_handshake(SSL *ssl, int handshake_type, uint8_t *buf, int hs_len) { int ret; /* To get here the state must be valid */ // ssl_printf("do_clnt_handshake: %d %d\n",__LINE__, handshake_type); switch (handshake_type) { case HS_SERVER_HELLO: ret = process_server_hello(ssl); break; case HS_CERTIFICATE: ret = process_certificate(ssl, &ssl->x509_ctx); break; case HS_SERVER_HELLO_DONE: if ((ret = process_server_hello_done(ssl)) == SSL_OK) { if (IS_SET_SSL_FLAG(SSL_HAS_CERT_REQ)) { if ((ret = send_certificate(ssl)) == SSL_OK && (ret = send_client_key_xchg(ssl)) == SSL_OK) { send_cert_verify(ssl); } } else { ret = send_client_key_xchg(ssl); } if (ret == SSL_OK && (ret = send_change_cipher_spec(ssl)) == SSL_OK) { ret = send_finished(ssl); } } break; case HS_CERT_REQ: ret = process_cert_req(ssl); break; case HS_FINISHED: ret = process_finished(ssl, buf, hs_len); disposable_free(ssl); /* free up some memory */ /* note: client renegotiation is not allowed after this */ break; case HS_HELLO_REQUEST: disposable_new(ssl); ret = do_client_connect(ssl); break; default: ret = SSL_ERROR_INVALID_HANDSHAKE; break; } return ret; } /* * Do the handshaking from the beginning. */ int ICACHE_FLASH_ATTR do_client_connect(SSL *ssl) { int ret = SSL_OK; send_client_hello(ssl); /* send the client hello */ ssl->bm_read_index = 0; ssl->next_state = HS_SERVER_HELLO; ssl->hs_status = SSL_NOT_OK; /* not connected */ #if 0 /* sit in a loop until it all looks good */ if (!IS_SET_SSL_FLAG(SSL_CONNECT_IN_PARTS)) { while (ssl->hs_status != SSL_OK) { ret = ssl_read(ssl, NULL); ssl_printf("%s %d %d\n", __func__, __LINE__,ret); if (ret < SSL_OK) break; } ssl->hs_status = ret; /* connected? */ } #endif return ret; } /* * Send the initial client hello. */ static int ICACHE_FLASH_ATTR send_client_hello(SSL *ssl) { uint8_t *buf = ssl->bm_data; time_t tm = 0; //time(NULL); wujg : pass compile first uint8_t *tm_ptr = &buf[6]; /* time will go here */ int i, offset; buf[0] = HS_CLIENT_HELLO; buf[1] = 0; buf[2] = 0; /* byte 3 is calculated later */ buf[4] = 0x03; buf[5] = ssl->version & 0x0f; /* client random value - spec says that 1st 4 bytes are big endian time */ *tm_ptr++ = (uint8_t)(((long)tm & 0xff000000) >> 24); *tm_ptr++ = (uint8_t)(((long)tm & 0x00ff0000) >> 16); *tm_ptr++ = (uint8_t)(((long)tm & 0x0000ff00) >> 8); *tm_ptr++ = (uint8_t)(((long)tm & 0x000000ff)); get_random(SSL_RANDOM_SIZE-4, &buf[10]); os_memcpy(ssl->dc->client_random, &buf[6], SSL_RANDOM_SIZE); offset = 6 + SSL_RANDOM_SIZE; /* give session resumption a go */ if (IS_SET_SSL_FLAG(SSL_SESSION_RESUME)) /* set initially by user */ { buf[offset++] = ssl->sess_id_size; os_memcpy(&buf[offset], ssl->session_id, ssl->sess_id_size); offset += ssl->sess_id_size; CLR_SSL_FLAG(SSL_SESSION_RESUME); /* clear so we can set later */ } else { /* no session id - because no session resumption just yet */ buf[offset++] = 0; } buf[offset++] = 0; /* number of ciphers */ buf[offset++] = NUM_PROTOCOLS*2;/* number of ciphers */ /* put all our supported protocols in our request */ for (i = 0; i < NUM_PROTOCOLS; i++) { buf[offset++] = 0; /* cipher we are using */ buf[offset++] = ssl_prot_prefs[i]; } buf[offset++] = 1; /* no compression */ buf[offset++] = 0; buf[3] = offset - 4; /* handshake size */ return send_packet(ssl, PT_HANDSHAKE_PROTOCOL, NULL, offset); } /* * Process the server hello. */ static int ICACHE_FLASH_ATTR process_server_hello(SSL *ssl) { uint8_t *buf = ssl->bm_data; int pkt_size = ssl->bm_index; int num_sessions = ssl->ssl_ctx->num_sessions; uint8_t sess_id_size; int offset, ret = SSL_OK; /* check that we are talking to a TLSv1 server */ uint8_t version = (buf[4] << 4) + buf[5]; if (version > SSL_PROTOCOL_VERSION_MAX) { version = SSL_PROTOCOL_VERSION_MAX; } else if (ssl->version < SSL_PROTOCOL_MIN_VERSION) { ret = SSL_ERROR_INVALID_VERSION; //ssl_display_error(ret); goto error; } ssl->version = version; /* get the server random value */ os_memcpy(ssl->dc->server_random, &buf[6], SSL_RANDOM_SIZE); offset = 6 + SSL_RANDOM_SIZE; /* skip of session id size */ sess_id_size = buf[offset++]; if (sess_id_size > SSL_SESSION_ID_SIZE) { ret = SSL_ERROR_INVALID_SESSION; goto error; } if (num_sessions) { ssl->session = ssl_session_update(num_sessions, ssl->ssl_ctx->ssl_sessions, ssl, &buf[offset]); os_memcpy(ssl->session->session_id, &buf[offset], sess_id_size); /* pad the rest with 0's */ if (sess_id_size < SSL_SESSION_ID_SIZE) { os_memset(&ssl->session->session_id[sess_id_size], 0, SSL_SESSION_ID_SIZE-sess_id_size); } } os_memcpy(ssl->session_id, &buf[offset], sess_id_size); ssl->sess_id_size = sess_id_size; offset += sess_id_size; /* get the real cipher we are using */ ssl->cipher = buf[++offset]; ssl->next_state = IS_SET_SSL_FLAG(SSL_SESSION_RESUME) ? HS_FINISHED : HS_CERTIFICATE; offset++; // skip the compr PARANOIA_CHECK(pkt_size, offset); ssl->dc->bm_proc_index = offset+1; error: return ret; } /** * Process the server hello done message. */ static int ICACHE_FLASH_ATTR process_server_hello_done(SSL *ssl) { ssl->next_state = HS_FINISHED; return SSL_OK; } /* * Send a client key exchange message. */ static int ICACHE_FLASH_ATTR send_client_key_xchg(SSL *ssl) { uint8_t *buf = ssl->bm_data; uint8_t premaster_secret[SSL_SECRET_SIZE]; int enc_secret_size = -1; buf[0] = HS_CLIENT_KEY_XCHG; buf[1] = 0; premaster_secret[0] = 0x03; /* encode the version number */ premaster_secret[1] = SSL_PROTOCOL_MINOR_VERSION; /* must be TLS 1.1 */ get_random(SSL_SECRET_SIZE-2, &premaster_secret[2]); //DISPLAY_RSA(ssl, ssl->x509_ctx->rsa_ctx); /* rsa_ctx->bi_ctx is not thread-safe */ SSL_CTX_LOCK(ssl->ssl_ctx->mutex); enc_secret_size = RSA_encrypt(ssl->x509_ctx->rsa_ctx, premaster_secret, SSL_SECRET_SIZE, &buf[6], 0); SSL_CTX_UNLOCK(ssl->ssl_ctx->mutex); buf[2] = (enc_secret_size + 2) >> 8; buf[3] = (enc_secret_size + 2) & 0xff; buf[4] = enc_secret_size >> 8; buf[5] = enc_secret_size & 0xff; generate_master_secret(ssl, premaster_secret); return send_packet(ssl, PT_HANDSHAKE_PROTOCOL, NULL, enc_secret_size+6); } /* * Process the certificate request. */ static int ICACHE_FLASH_ATTR process_cert_req(SSL *ssl) { uint8_t *buf = &ssl->bm_data[ssl->dc->bm_proc_index]; int ret = SSL_OK; int offset = (buf[2] << 4) + buf[3]; int pkt_size = ssl->bm_index; /* don't do any processing - we will send back an RSA certificate anyway */ ssl->next_state = HS_SERVER_HELLO_DONE; SET_SSL_FLAG(SSL_HAS_CERT_REQ); ssl->dc->bm_proc_index += offset; PARANOIA_CHECK(pkt_size, offset); error: return ret; } /* * Send a certificate verify message. */ static int ICACHE_FLASH_ATTR send_cert_verify(SSL *ssl) { uint8_t *buf = ssl->bm_data; uint8_t dgst[MD5_SIZE+SHA1_SIZE]; RSA_CTX *rsa_ctx = ssl->ssl_ctx->rsa_ctx; int n = 0, ret; //DISPLAY_RSA(ssl, rsa_ctx); buf[0] = HS_CERT_VERIFY; buf[1] = 0; finished_digest(ssl, NULL, dgst); /* calculate the digest */ /* rsa_ctx->bi_ctx is not thread-safe */ if (rsa_ctx) { SSL_CTX_LOCK(ssl->ssl_ctx->mutex); n = RSA_encrypt(rsa_ctx, dgst, sizeof(dgst), &buf[6], 1); SSL_CTX_UNLOCK(ssl->ssl_ctx->mutex); if (n == 0) { ret = SSL_ERROR_INVALID_KEY; goto error; } } buf[4] = n >> 8; /* add the RSA size (not officially documented) */ buf[5] = n & 0xff; n += 2; buf[2] = n >> 8; buf[3] = n & 0xff; ret = send_packet(ssl, PT_HANDSHAKE_PROTOCOL, NULL, n+4); error: return ret; } #endif /* CONFIG_SSL_ENABLE_CLIENT */ ================================================ FILE: app/ssl/ssl/ssl_tls1_svr.c ================================================ /* * Copyright (c) 2007, Cameron Rich * * 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 axTLS project 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 //#include //#include #include "ssl/ssl_os_port.h" #include "ssl/ssl_ssl.h" //#include "../httpd/axhttp.h" #include "ssl/app/espconn_ssl.h" static const uint8_t g_hello_done[] = { HS_SERVER_HELLO_DONE, 0, 0, 0 }; static int process_client_hello(SSL *ssl); static int send_server_hello_sequence(SSL *ssl); static int send_server_hello(SSL *ssl); static int send_server_hello_done(SSL *ssl); static int process_client_key_xchg(SSL *ssl); #ifdef CONFIG_SSL_CERT_VERIFICATION static int send_certificate_request(SSL *ssl); static int process_cert_verify(SSL *ssl); #endif #if 0 /* * Establish a new SSL connection to an SSL client. */ EXP_FUNC SSL * STDCALL ICACHE_FLASH_ATTR ssl_server_new(SSL_CTX *ssl_ctx, int client_fd) { SSL *ssl; ssl = ssl_new(ssl_ctx, client_fd); ssl->next_state = HS_CLIENT_HELLO; #ifdef CONFIG_SSL_FULL_MODE if (ssl_ctx->chain_length == 0) ssl_printf("Warning - no server certificate defined\n"); TTY_FLUSH(); #endif return ssl; } #endif /* * Establish a new SSL connection to an SSL client.(raw api)add by ives 12.19.2013 */ EXP_FUNC SSL *STDCALL ICACHE_FLASH_ATTR sslserver_new(SSL_CTX *ssl_ctx, struct tcp_pcb* client_pcb) { SSL *ssl; ssl = ssl_new_context(ssl_ctx, client_pcb); ssl->next_state = HS_CLIENT_HELLO; #ifdef CONFIG_SSL_FULL_MODE if (ssl_ctx->chain_length == 0) ssl_printf("Warning - no server certificate defined\n"); //TTY_FLUSH(); #endif return ssl; } /* * Process the handshake record. */ int ICACHE_FLASH_ATTR do_svr_handshake(SSL *ssl, int handshake_type, uint8_t *buf, int hs_len) { int ret = SSL_OK; ssl->hs_status = SSL_NOT_OK; /* not connected */ /* To get here the state must be valid */ // ssl_printf("%d %s %d\n",handshake_type, __func__, __LINE__); switch (handshake_type) { case HS_CLIENT_HELLO: if ((ret = process_client_hello(ssl)) == SSL_OK) ret = send_server_hello_sequence(ssl); break; #ifdef CONFIG_SSL_CERT_VERIFICATION case HS_CERTIFICATE:/* the client sends its cert */ ret = process_certificate(ssl, &ssl->x509_ctx); if (ret == SSL_OK) /* verify the cert */ { int cert_res; cert_res = x509_verify( ssl->ssl_ctx->ca_cert_ctx, ssl->x509_ctx); ret = (cert_res == 0) ? SSL_OK : SSL_X509_ERROR(cert_res); } break; case HS_CERT_VERIFY: ret = process_cert_verify(ssl); add_packet(ssl, buf, hs_len); /* needs to be done after */ break; #endif case HS_CLIENT_KEY_XCHG: ret = process_client_key_xchg(ssl); break; case HS_FINISHED: ret = process_finished(ssl, buf, hs_len); disposable_free(ssl); /* free up some memory */ break; } return ret; } /* * Process a client hello message. */ static int ICACHE_FLASH_ATTR process_client_hello(SSL *ssl) { uint8_t *buf = ssl->bm_data; uint8_t *record_buf = ssl->hmac_header; int pkt_size = ssl->bm_index; int i, j, cs_len, id_len, offset = 6 + SSL_RANDOM_SIZE; int ret = SSL_OK; uint8_t version = (buf[4] << 4) + buf[5]; ssl->version = ssl->client_version = version; if (version > SSL_PROTOCOL_VERSION_MAX) { /* use client's version instead */ ssl->version = SSL_PROTOCOL_VERSION_MAX; } else if (version < SSL_PROTOCOL_MIN_VERSION) /* old version supported? */ { ret = SSL_ERROR_INVALID_VERSION; //ssl_display_error(ret); goto error; } os_memcpy(ssl->dc->client_random, &buf[6], SSL_RANDOM_SIZE); /* process the session id */ id_len = buf[offset++]; if (id_len > SSL_SESSION_ID_SIZE) { return SSL_ERROR_INVALID_SESSION; } #ifndef CONFIG_SSL_SKELETON_MODE ssl->session = ssl_session_update(ssl->ssl_ctx->num_sessions, ssl->ssl_ctx->ssl_sessions, ssl, id_len ? &buf[offset] : NULL); #endif offset += id_len; cs_len = (buf[offset]<<8) + buf[offset+1]; offset += 2; /* add 1 due to all cipher suites being 8 bit */ PARANOIA_CHECK(pkt_size, offset); /* work out what cipher suite we are going to use - client defines the preference */ for (i = 0; i < cs_len; i += 2) { for (j = 0; j < NUM_PROTOCOLS; j++) { if (ssl_prot_prefs[j] == ((buf[offset+i]<<8) + buf[offset+i+1])) /* got a match? */ { ssl->cipher = ssl_prot_prefs[j]; goto do_state; } } } /* ouch! protocol is not supported */ ret = SSL_ERROR_NO_CIPHER; do_state: error: return ret; } #ifdef CONFIG_SSL_ENABLE_V23_HANDSHAKE /* * Some browsers use a hybrid SSLv2 "client hello" */ int process_sslv23_client_hello(SSL *ssl) { uint8_t *buf = ssl->bm_data; int bytes_needed = ((buf[0] & 0x7f) << 8) + buf[1]; int ret = SSL_OK; /* we have already read 3 extra bytes so far */ // int read_len = SOCKET_READ(ssl->client_fd, buf, bytes_needed-3); int read_len = pbuf_copy_partial(ssl->ssl_pbuf, buf, bytes_needed - 3, 0); int cs_len = buf[1]; int id_len = buf[3]; int ch_len = buf[5]; int i, j, offset = 8; /* start at first cipher */ int random_offset = 0; DISPLAY_BYTES(ssl, "received %d bytes", buf, read_len, read_len); add_packet(ssl, buf, read_len); /* connection has gone, so die */ if (bytes_needed < 0) { return SSL_ERROR_CONN_LOST; } /* now work out what cipher suite we are going to use */ for (j = 0; j < NUM_PROTOCOLS; j++) { for (i = 0; i < cs_len; i += 3) { if (ssl_prot_prefs[j] == buf[offset+i]) { ssl->cipher = ssl_prot_prefs[j]; goto server_hello; } } } /* ouch! protocol is not supported */ ret = SSL_ERROR_NO_CIPHER; goto error; server_hello: /* get the session id */ offset += cs_len - 2; /* we've gone 2 bytes past the end */ #ifndef CONFIG_SSL_SKELETON_MODE ssl->session = ssl_session_update(ssl->ssl_ctx->num_sessions, ssl->ssl_ctx->ssl_sessions, ssl, id_len ? &buf[offset] : NULL); #endif /* get the client random data */ offset += id_len; /* random can be anywhere between 16 and 32 bytes long - so it is padded * with 0's to the left */ if (ch_len == 0x10) { random_offset += 0x10; } memcpy(&ssl->dc->client_random[random_offset], &buf[offset], ch_len); ret = send_server_hello_sequence(ssl); error: return ret; } #endif /* * Send the entire server hello sequence */ static int ICACHE_FLASH_ATTR send_server_hello_sequence(SSL *ssl) { int ret; if ((ret = send_server_hello(ssl)) == SSL_OK) { #ifndef CONFIG_SSL_SKELETON_MODE /* resume handshake? */ if (IS_SET_SSL_FLAG(SSL_SESSION_RESUME)) { if ((ret = send_change_cipher_spec(ssl)) == SSL_OK) { ret = send_finished(ssl); ssl->next_state = HS_FINISHED; } } else #endif if ((ret = send_certificate(ssl)) == SSL_OK) { #ifdef CONFIG_SSL_CERT_VERIFICATION /* ask the client for its certificate */ if (IS_SET_SSL_FLAG(SSL_CLIENT_AUTHENTICATION)) { if ((ret = send_certificate_request(ssl)) == SSL_OK) { ret = send_server_hello_done(ssl); ssl->next_state = HS_CERTIFICATE; } } else #endif { ret = send_server_hello_done(ssl); ssl->next_state = HS_CLIENT_KEY_XCHG; } } } return ret; } /* * Send a server hello message. */ static int ICACHE_FLASH_ATTR send_server_hello(SSL *ssl) { uint8_t *buf = ssl->bm_data; int offset = 0; buf[0] = HS_SERVER_HELLO; buf[1] = 0; buf[2] = 0; /* byte 3 is calculated later */ buf[4] = 0x03; buf[5] = ssl->version & 0x0f; /* server random value */ get_random(SSL_RANDOM_SIZE, &buf[6]); os_memcpy(ssl->dc->server_random, &buf[6], SSL_RANDOM_SIZE); offset = 6 + SSL_RANDOM_SIZE; #ifndef CONFIG_SSL_SKELETON_MODE if (IS_SET_SSL_FLAG(SSL_SESSION_RESUME)) { /* retrieve id from session cache */ buf[offset++] = SSL_SESSION_ID_SIZE; os_memcpy(&buf[offset], ssl->session->session_id, SSL_SESSION_ID_SIZE); os_memcpy(ssl->session_id, ssl->session->session_id, SSL_SESSION_ID_SIZE); ssl->sess_id_size = SSL_SESSION_ID_SIZE; offset += SSL_SESSION_ID_SIZE; } else /* generate our own session id */ #endif { #ifndef CONFIG_SSL_SKELETON_MODE buf[offset++] = SSL_SESSION_ID_SIZE; get_random(SSL_SESSION_ID_SIZE, &buf[offset]); os_memcpy(ssl->session_id, &buf[offset], SSL_SESSION_ID_SIZE); ssl->sess_id_size = SSL_SESSION_ID_SIZE; /* store id in session cache */ if (ssl->ssl_ctx->num_sessions) { os_memcpy(ssl->session->session_id, ssl->session_id, SSL_SESSION_ID_SIZE); } offset += SSL_SESSION_ID_SIZE; #else buf[offset++] = 0; /* don't bother with session id in skelton mode */ #endif } buf[offset++] = 0; /* cipher we are using */ buf[offset++] = ssl->cipher; buf[offset++] = 0; /* no compression */ buf[3] = offset - 4; /* handshake size */ return send_packet(ssl, PT_HANDSHAKE_PROTOCOL, NULL, offset); } /* * Send the server hello done message. */ static int ICACHE_FLASH_ATTR send_server_hello_done(SSL *ssl) { return send_packet(ssl, PT_HANDSHAKE_PROTOCOL, g_hello_done, sizeof(g_hello_done)); } /* * Pull apart a client key exchange message. Decrypt the pre-master key (using * our RSA private key) and then work out the master key. Initialise the * ciphers. */ static int ICACHE_FLASH_ATTR process_client_key_xchg(SSL *ssl) { uint8_t *buf = &ssl->bm_data[ssl->dc->bm_proc_index]; int pkt_size = ssl->bm_index; int premaster_size, secret_length = (buf[2] << 8) + buf[3]; uint8_t premaster_secret[MAX_KEY_BYTE_SIZE]; RSA_CTX *rsa_ctx = ssl->ssl_ctx->rsa_ctx; int offset = 4; int ret = SSL_OK; if (rsa_ctx == NULL) { ret = SSL_ERROR_NO_CERT_DEFINED; goto error; } /* is there an extra size field? */ if ((secret_length - 2) == rsa_ctx->num_octets) offset += 2; PARANOIA_CHECK(pkt_size, rsa_ctx->num_octets+offset); /* rsa_ctx->bi_ctx is not thread-safe */ SSL_CTX_LOCK(ssl->ssl_ctx->mutex); premaster_size = RSA_decrypt(rsa_ctx, &buf[offset], premaster_secret, 1); SSL_CTX_UNLOCK(ssl->ssl_ctx->mutex); if (premaster_size != SSL_SECRET_SIZE || premaster_secret[0] != 0x03 || /* must be the same as client offered version */ premaster_secret[1] != (ssl->client_version & 0x0f)) { /* guard against a Bleichenbacher attack */ get_random(SSL_SECRET_SIZE, premaster_secret); /* and continue - will die eventually when checking the mac */ } #if 0 print_blob("pre-master", premaster_secret, SSL_SECRET_SIZE); #endif generate_master_secret(ssl, premaster_secret); #ifdef CONFIG_SSL_CERT_VERIFICATION ssl->next_state = IS_SET_SSL_FLAG(SSL_CLIENT_AUTHENTICATION) ? HS_CERT_VERIFY : HS_FINISHED; #else ssl->next_state = HS_FINISHED; #endif ssl->dc->bm_proc_index += rsa_ctx->num_octets+offset; error: return ret; } #ifdef CONFIG_SSL_CERT_VERIFICATION static const uint8_t g_cert_request[] = { HS_CERT_REQ, 0, 0, 4, 1, 0, 0, 0 }; /* * Send the certificate request message. */ static int ICACHE_FLASH_ATTR send_certificate_request(SSL *ssl) { return send_packet(ssl, PT_HANDSHAKE_PROTOCOL, g_cert_request, sizeof(g_cert_request)); } /* * Ensure the client has the private key by first decrypting the packet and * then checking the packet digests. */ static int ICACHE_FLASH_ATTR process_cert_verify(SSL *ssl) { uint8_t *buf = &ssl->bm_data[ssl->dc->bm_proc_index]; int pkt_size = ssl->bm_index; uint8_t dgst_buf[MAX_KEY_BYTE_SIZE]; uint8_t dgst[MD5_SIZE+SHA1_SIZE]; X509_CTX *x509_ctx = ssl->x509_ctx; int ret = SSL_OK; int n; PARANOIA_CHECK(pkt_size, x509_ctx->rsa_ctx->num_octets+6); //DISPLAY_RSA(ssl, x509_ctx->rsa_ctx); /* rsa_ctx->bi_ctx is not thread-safe */ SSL_CTX_LOCK(ssl->ssl_ctx->mutex); n = RSA_decrypt(x509_ctx->rsa_ctx, &buf[6], dgst_buf, 0); SSL_CTX_UNLOCK(ssl->ssl_ctx->mutex); if (n != SHA1_SIZE + MD5_SIZE) { ret = SSL_ERROR_INVALID_KEY; goto end_cert_vfy; } finished_digest(ssl, NULL, dgst); /* calculate the digest */ if (os_memcmp(dgst_buf, dgst, MD5_SIZE + SHA1_SIZE)) { ret = SSL_ERROR_INVALID_KEY; } end_cert_vfy: ssl->next_state = HS_FINISHED; error: return ret; } #endif ================================================ FILE: app/ssl/ssl/ssl_x509.c ================================================ /* * Copyright (c) 2007, Cameron Rich * * 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 axTLS project 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. */ /** * @file x509.c * * Certificate processing. */ //#include //#include //#include //#include #include "ssl/app/espconn_ssl.h" #include "ssl/ssl_os_port.h" #include "ssl/ssl_crypto_misc.h" //#include "os.h" #include "lwip/mem.h" #ifdef CONFIG_SSL_CERT_VERIFICATION /** * Retrieve the signature from a certificate. */ static const uint8_t * ICACHE_FLASH_ATTR get_signature(const uint8_t *asn1_sig, int *len) { int offset = 0; const uint8_t *ptr = NULL; if (asn1_next_obj(asn1_sig, &offset, ASN1_SEQUENCE) < 0 || asn1_skip_obj(asn1_sig, &offset, ASN1_SEQUENCE)) goto end_get_sig; if (asn1_sig[offset++] != ASN1_OCTET_STRING) goto end_get_sig; *len = get_asn1_length(asn1_sig, &offset); ptr = &asn1_sig[offset]; /* all ok */ end_get_sig: return ptr; } #endif /** * Construct a new x509 object. * @return 0 if ok. < 0 if there was a problem. */ int ICACHE_FLASH_ATTR x509_new(const uint8_t *cert, int *len, X509_CTX **ctx) { int begin_tbs, end_tbs; int ret = X509_NOT_OK, offset = 0, cert_size = 0; X509_CTX *x509_ctx; BI_CTX *bi_ctx; *ctx = (X509_CTX *)os_zalloc(sizeof(X509_CTX)); x509_ctx = *ctx; /* get the certificate size */ asn1_skip_obj(cert, &cert_size, ASN1_SEQUENCE); if (asn1_next_obj(cert, &offset, ASN1_SEQUENCE) < 0) goto end_cert; begin_tbs = offset; /* start of the tbs */ end_tbs = begin_tbs; /* work out the end of the tbs */ asn1_skip_obj(cert, &end_tbs, ASN1_SEQUENCE); if (asn1_next_obj(cert, &offset, ASN1_SEQUENCE) < 0) goto end_cert; if (cert[offset] == ASN1_EXPLICIT_TAG) /* optional version */ { if (asn1_version(cert, &offset, x509_ctx)) goto end_cert; } if (asn1_skip_obj(cert, &offset, ASN1_INTEGER) || /* serial number */ asn1_next_obj(cert, &offset, ASN1_SEQUENCE) < 0) goto end_cert; /* make sure the signature is ok */ if (asn1_signature_type(cert, &offset, x509_ctx)) { ret = X509_VFY_ERROR_UNSUPPORTED_DIGEST; goto end_cert; } if (asn1_name(cert, &offset, x509_ctx->ca_cert_dn) || asn1_validity(cert, &offset, x509_ctx) || asn1_name(cert, &offset, x509_ctx->cert_dn) || asn1_public_key(cert, &offset, x509_ctx)) { goto end_cert; } bi_ctx = x509_ctx->rsa_ctx->bi_ctx; #ifdef CONFIG_SSL_CERT_VERIFICATION /* only care if doing verification */ /* use the appropriate signature algorithm (SHA1/MD5/MD2) */ if (x509_ctx->sig_type == SIG_TYPE_MD5) { MD5_CTX md5_ctx; uint8_t md5_dgst[MD5_SIZE]; MD5_Init(&md5_ctx); MD5_Update(&md5_ctx, &cert[begin_tbs], end_tbs-begin_tbs); MD5_Final(md5_dgst, &md5_ctx); x509_ctx->digest = bi_import(bi_ctx, md5_dgst, MD5_SIZE); } else if (x509_ctx->sig_type == SIG_TYPE_SHA1) { SHA1_CTX sha_ctx; uint8_t sha_dgst[SHA1_SIZE]; SHA1_Init(&sha_ctx); SHA1_Update(&sha_ctx, &cert[begin_tbs], end_tbs-begin_tbs); SHA1_Final(sha_dgst, &sha_ctx); x509_ctx->digest = bi_import(bi_ctx, sha_dgst, SHA1_SIZE); } else if (x509_ctx->sig_type == SIG_TYPE_MD2) { MD2_CTX md2_ctx; uint8_t md2_dgst[MD2_SIZE]; MD2_Init(&md2_ctx); MD2_Update(&md2_ctx, &cert[begin_tbs], end_tbs-begin_tbs); MD2_Final(md2_dgst, &md2_ctx); x509_ctx->digest = bi_import(bi_ctx, md2_dgst, MD2_SIZE); } if (cert[offset] == ASN1_V3_DATA) { int suboffset; ++offset; get_asn1_length(cert, &offset); if ((suboffset = asn1_find_subjectaltname(cert, offset)) > 0) { if (asn1_next_obj(cert, &suboffset, ASN1_OCTET_STRING) > 0) { int altlen; if ((altlen = asn1_next_obj(cert, &suboffset, ASN1_SEQUENCE)) > 0) { int endalt = suboffset + altlen; int totalnames = 0; while (suboffset < endalt) { int type = cert[suboffset++]; int dnslen = get_asn1_length(cert, &suboffset); if (type == ASN1_CONTEXT_DNSNAME) { x509_ctx->subject_alt_dnsnames = (char**) os_realloc(x509_ctx->subject_alt_dnsnames, (totalnames + 2) * sizeof(char*)); x509_ctx->subject_alt_dnsnames[totalnames] = (char*)os_malloc(dnslen + 1); x509_ctx->subject_alt_dnsnames[totalnames+1] = NULL; os_memcpy(x509_ctx->subject_alt_dnsnames[totalnames], cert + suboffset, dnslen); x509_ctx->subject_alt_dnsnames[ totalnames][dnslen] = 0; ++totalnames; } suboffset += dnslen; } } } } } offset = end_tbs; /* skip the rest of v3 data */ if (asn1_skip_obj(cert, &offset, ASN1_SEQUENCE) || asn1_signature(cert, &offset, x509_ctx)) goto end_cert; #endif ret = X509_OK; end_cert: if (len) { *len = cert_size; } if (ret) { #ifdef CONFIG_SSL_FULL_MODE ssl_printf("Error: Invalid X509 ASN.1 file (%s)\n", x509_display_error(ret)); #endif x509_free(x509_ctx); *ctx = NULL; } return ret; } /** * Free an X.509 object's resources. */ void ICACHE_FLASH_ATTR x509_free(X509_CTX *x509_ctx) { X509_CTX *next; int i; if (x509_ctx == NULL) /* if already null, then don't bother */ return; for (i = 0; i < X509_NUM_DN_TYPES; i++) { os_free(x509_ctx->ca_cert_dn[i]); os_free(x509_ctx->cert_dn[i]); } os_free(x509_ctx->signature); #ifdef CONFIG_SSL_CERT_VERIFICATION if (x509_ctx->digest) { bi_free(x509_ctx->rsa_ctx->bi_ctx, x509_ctx->digest); } if (x509_ctx->subject_alt_dnsnames) { for (i = 0; x509_ctx->subject_alt_dnsnames[i]; ++i) os_free(x509_ctx->subject_alt_dnsnames[i]); os_free(x509_ctx->subject_alt_dnsnames); } #endif RSA_free(x509_ctx->rsa_ctx); next = x509_ctx->next; os_free(x509_ctx); x509_free(next); /* clear the chain */ } #ifdef CONFIG_SSL_CERT_VERIFICATION /** * Take a signature and decrypt it. */ static bigint *ICACHE_FLASH_ATTR sig_verify(BI_CTX *ctx, const uint8_t *sig, int sig_len, bigint *modulus, bigint *pub_exp) { int i, size; bigint *decrypted_bi, *dat_bi; bigint *bir = NULL; uint8_t *block = (uint8_t *)os_malloc(sig_len); /* decrypt */ dat_bi = bi_import(ctx, sig, sig_len); ctx->mod_offset = BIGINT_M_OFFSET; /* convert to a normal block */ decrypted_bi = bi_mod_power2(ctx, dat_bi, modulus, pub_exp); bi_export(ctx, decrypted_bi, block, sig_len); ctx->mod_offset = BIGINT_M_OFFSET; i = 10; /* start at the first possible non-padded byte */ while (block[i++] && i < sig_len); size = sig_len - i; /* get only the bit we want */ if (size > 0) { int len; const uint8_t *sig_ptr = get_signature(&block[i], &len); if (sig_ptr) { bir = bi_import(ctx, sig_ptr, len); } } /* save a few bytes of memory */ bi_clear_cache(ctx); os_free(block); return bir; } /** * Do some basic checks on the certificate chain. * * Certificate verification consists of a number of checks: * - The date of the certificate is after the start date. * - The date of the certificate is before the finish date. * - A root certificate exists in the certificate store. * - That the certificate(s) are not self-signed. * - The certificate chain is valid. * - The signature of the certificate is valid. */ int ICACHE_FLASH_ATTR x509_verify(const CA_CERT_CTX *ca_cert_ctx, const X509_CTX *cert) { int ret = X509_OK, i = 0; bigint *cert_sig; X509_CTX *next_cert = NULL; BI_CTX *ctx = NULL; bigint *mod = NULL, *expn = NULL; int match_ca_cert = 0; struct timeval tv; uint8_t is_self_signed = 0; if (cert == NULL) { ret = X509_VFY_ERROR_NO_TRUSTED_CERT; goto end_verify; } /* a self-signed certificate that is not in the CA store - use this to check the signature */ if (asn1_compare_dn(cert->ca_cert_dn, cert->cert_dn) == 0) { is_self_signed = 1; ctx = cert->rsa_ctx->bi_ctx; mod = cert->rsa_ctx->m; expn = cert->rsa_ctx->e; } // gettimeofday(&tv, NULL); /* check the not before date */ if (tv.tv_sec < cert->not_before) { ret = X509_VFY_ERROR_NOT_YET_VALID; goto end_verify; } /* check the not after date */ if (tv.tv_sec > cert->not_after) { ret = X509_VFY_ERROR_EXPIRED; goto end_verify; } next_cert = cert->next; /* last cert in the chain - look for a trusted cert */ if (next_cert == NULL) { if (ca_cert_ctx != NULL) { /* go thu the CA store */ while (i < CONFIG_X509_MAX_CA_CERTS && ca_cert_ctx->cert[i]) { if (asn1_compare_dn(cert->ca_cert_dn, ca_cert_ctx->cert[i]->cert_dn) == 0) { /* use this CA certificate for signature verification */ match_ca_cert = 1; ctx = ca_cert_ctx->cert[i]->rsa_ctx->bi_ctx; mod = ca_cert_ctx->cert[i]->rsa_ctx->m; expn = ca_cert_ctx->cert[i]->rsa_ctx->e; break; } i++; } } /* couldn't find a trusted cert (& let self-signed errors be returned) */ if (!match_ca_cert && !is_self_signed) { ret = X509_VFY_ERROR_NO_TRUSTED_CERT; goto end_verify; } } else if (asn1_compare_dn(cert->ca_cert_dn, next_cert->cert_dn) != 0) { /* check the chain */ ret = X509_VFY_ERROR_INVALID_CHAIN; goto end_verify; } else /* use the next certificate in the chain for signature verify */ { ctx = next_cert->rsa_ctx->bi_ctx; mod = next_cert->rsa_ctx->m; expn = next_cert->rsa_ctx->e; } /* cert is self signed */ if (!match_ca_cert && is_self_signed) { ret = X509_VFY_ERROR_SELF_SIGNED; goto end_verify; } /* check the signature */ cert_sig = sig_verify(ctx, cert->signature, cert->sig_len, bi_clone(ctx, mod), bi_clone(ctx, expn)); if (cert_sig && cert->digest) { if (bi_compare(cert_sig, cert->digest) != 0) ret = X509_VFY_ERROR_BAD_SIGNATURE; bi_free(ctx, cert_sig); } else { ret = X509_VFY_ERROR_BAD_SIGNATURE; } if (ret) goto end_verify; /* go down the certificate chain using recursion. */ if (next_cert != NULL) { ret = x509_verify(ca_cert_ctx, next_cert); } end_verify: return ret; } #endif #if defined (CONFIG_SSL_FULL_MODE) /** * Used for diagnostics. */ static const char *not_part_of_cert = ""; void ICACHE_FLASH_ATTR x509_print(const X509_CTX *cert, CA_CERT_CTX *ca_cert_ctx) { if (cert == NULL) return; ssl_printf("=== CERTIFICATE ISSUED TO ===\n"); ssl_printf("Common Name (CN):\t\t"); ssl_printf("%s\n", cert->cert_dn[X509_COMMON_NAME] ? cert->cert_dn[X509_COMMON_NAME] : not_part_of_cert); ssl_printf("Organization (O):\t\t"); ssl_printf("%s\n", cert->cert_dn[X509_ORGANIZATION] ? cert->cert_dn[X509_ORGANIZATION] : not_part_of_cert); ssl_printf("Organizational Unit (OU):\t"); ssl_printf("%s\n", cert->cert_dn[X509_ORGANIZATIONAL_UNIT] ? cert->cert_dn[X509_ORGANIZATIONAL_UNIT] : not_part_of_cert); ssl_printf("=== CERTIFICATE ISSUED BY ===\n"); ssl_printf("Common Name (CN):\t\t"); ssl_printf("%s\n", cert->ca_cert_dn[X509_COMMON_NAME] ? cert->ca_cert_dn[X509_COMMON_NAME] : not_part_of_cert); ssl_printf("Organization (O):\t\t"); ssl_printf("%s\n", cert->ca_cert_dn[X509_ORGANIZATION] ? cert->ca_cert_dn[X509_ORGANIZATION] : not_part_of_cert); ssl_printf("Organizational Unit (OU):\t"); ssl_printf("%s\n", cert->ca_cert_dn[X509_ORGANIZATIONAL_UNIT] ? cert->ca_cert_dn[X509_ORGANIZATIONAL_UNIT] : not_part_of_cert); ssl_printf("Not Before:\t\t\t%d\n", cert->not_before); ssl_printf("Not After:\t\t\t%d\n", cert->not_after); ssl_printf("RSA bitsize:\t\t\t%d\n", cert->rsa_ctx->num_octets*8); ssl_printf("Sig Type:\t\t\t"); switch (cert->sig_type) { case SIG_TYPE_MD5: ssl_printf("MD5\n"); break; case SIG_TYPE_SHA1: ssl_printf("SHA1\n"); break; case SIG_TYPE_MD2: ssl_printf("MD2\n"); break; default: ssl_printf("Unrecognized: %d\n", cert->sig_type); break; } if (ca_cert_ctx) { ssl_printf("Verify:\t\t\t\t%s\n", x509_display_error(x509_verify(ca_cert_ctx, cert))); } #if 0 print_blob("Signature", cert->signature, cert->sig_len); bi_print("Modulus", cert->rsa_ctx->m); bi_print("Pub Exp", cert->rsa_ctx->e); #endif if (ca_cert_ctx) { x509_print(cert->next, ca_cert_ctx); } //TTY_FLUSH(); } const char * ICACHE_FLASH_ATTR x509_display_error(int error) { switch (error) { case X509_OK: return "Certificate verify successful"; case X509_NOT_OK: return "X509 not ok"; case X509_VFY_ERROR_NO_TRUSTED_CERT: return "No trusted cert is available"; case X509_VFY_ERROR_BAD_SIGNATURE: return "Bad signature"; case X509_VFY_ERROR_NOT_YET_VALID: return "Cert is not yet valid"; case X509_VFY_ERROR_EXPIRED: return "Cert has expired"; case X509_VFY_ERROR_SELF_SIGNED: return "Cert is self-signed"; case X509_VFY_ERROR_INVALID_CHAIN: return "Chain is invalid (check order of certs)"; case X509_VFY_ERROR_UNSUPPORTED_DIGEST: return "Unsupported digest"; case X509_INVALID_PRIV_KEY: return "Invalid private key"; default: return "Unknown"; } } #endif /* CONFIG_SSL_FULL_MODE */ ================================================ FILE: app/user/Makefile ================================================ ############################################################# # Required variables for each makefile # Discard this section from all parent makefiles # Expected variables (with automatic defaults): # CSRCS (all "C" files in the dir) # SUBDIRS (all subdirs with a Makefile) # GEN_LIBS - list of libs to be generated () # GEN_IMAGES - list of images to be generated () # COMPONENTS_xxx - a list of libs/objs in the form # subdir/lib to be extracted and rolled up into # a generated lib/image xxx.a () # ifndef PDIR GEN_LIBS = libuser.a endif ############################################################# # Configuration i.e. compile options etc. # Target specific stuff (defines etc.) goes in here! # Generally values applying to a tree are captured in the # makefile at its root level - these are then overridden # for a subtree within the makefile rooted therein # #DEFINES += ############################################################# # Recursion Magic - Don't touch this!! # # Each subtree potentially has an include directory # corresponding to the common APIs applicable to modules # rooted at that subtree. Accordingly, the INCLUDE PATH # of a module can only contain the include directories up # its parent path, and not its siblings # # Required for each makefile to inherit from the parent # INCLUDES := $(INCLUDES) -I $(PDIR)include INCLUDES += -I ./ INCLUDES += -I ../../include/ets INCLUDES += -I ../libc INCLUDES += -I ../platform INCLUDES += -I ../http INCLUDES += -I ../dns INCLUDES += -I ../ PDIR := ../$(PDIR) sinclude $(PDIR)Makefile ================================================ FILE: app/user/user_main.c ================================================ /****************************************************************************** * Copyright 2013-2014 Espressif Systems (Wuxi) * * FileName: user_main.c * * Description: entry file of user application * * Modification history: * 2014/1/1, v1.0 create this file. *******************************************************************************/ #include "platform.h" #include "c_string.h" #include "c_stdlib.h" #include "c_stdio.h" #include "flash_api.h" #include "osapi.h" #include "user_interface.h" #include "user_config.h" #include "ets_sys.h" #include "driver/uart.h" #include "driver/relay.h" #include "mem.h" #include "dns.h" #include "serial_number.h" #include "http/app.h" #include "mqtt/app.h" #include "sensor/sensors.h" #ifdef DEVELOP_VERSION os_timer_t heapTimer; static void heapTimerCb(void *arg){ NODE_DBG("FREE HEAP: %d",system_get_free_heap_size()); } #endif static void config_wifi(){ NODE_DBG("Putting AP UP"); platform_key_led(0); wifi_station_set_auto_connect(1); wifi_set_opmode(0x03); // station+ap mode struct softap_config config; wifi_softap_get_config(&config); char ssid[]="SmartRelay"SERIAL_NUMBER; strcpy(config.ssid,ssid); memset(config.password,0,64); config.ssid_len=strlen(ssid); config.channel=11; config.authmode=AUTH_OPEN; config.max_connection=4; config.ssid_hidden=0; wifi_softap_set_config(&config); } /****************************************************************************** * FunctionName : user_init * Description : entry of user application, init user function here * Parameters : none * Returns : none *******************************************************************************/ void user_init(void) { system_update_cpu_freq(160); //overclock :) uart_init(BIT_RATE_115200,BIT_RATE_115200); NODE_DBG("User Init"); uint32_t size = flash_get_size_byte(); NODE_DBG("Flash size %d",size); config_wifi(); relay_init(); init_dns(); init_http_server(); //uncomment to send data to mqtt broker //mqtt_app_init(); //uncomment if you have sensors intalled //sensors_init(); #ifdef DEVELOP_VERSION //arm timer os_memset(&heapTimer,0,sizeof(os_timer_t)); os_timer_disarm(&heapTimer); os_timer_setfn(&heapTimer, (os_timer_func_t *)heapTimerCb, NULL); os_timer_arm(&heapTimer, 5000, 1); #endif } ================================================ FILE: app/util/Makefile ================================================ ############################################################# # Required variables for each makefile # Discard this section from all parent makefiles # Expected variables (with automatic defaults): # CSRCS (all "C" files in the dir) # SUBDIRS (all subdirs with a Makefile) # GEN_LIBS - list of libs to be generated () # GEN_IMAGES - list of images to be generated () # COMPONENTS_xxx - a list of libs/objs in the form # subdir/lib to be extracted and rolled up into # a generated lib/image xxx.a () # ifndef PDIR GEN_LIBS = util.a endif ############################################################# # Configuration i.e. compile options etc. # Target specific stuff (defines etc.) goes in here! # Generally values applying to a tree are captured in the # makefile at its root level - these are then overridden # for a subtree within the makefile rooted therein # #DEFINES += ############################################################# # Recursion Magic - Don't touch this!! # # Each subtree potentially has an include directory # corresponding to the common APIs applicable to modules # rooted at that subtree. Accordingly, the INCLUDE PATH # of a module can only contain the include directories up # its parent path, and not its siblings # # Required for each makefile to inherit from the parent # INCLUDES := $(INCLUDES) -I $(PDIR)include INCLUDES += -I ./ INCLUDES += -I ../libc PDIR := ../$(PDIR) sinclude $(PDIR)Makefile ================================================ FILE: app/util/base64.c ================================================ /* * Copyright (c) 2003 Apple Computer, Inc. All rights reserved. * * @APPLE_LICENSE_HEADER_START@ * * Copyright (c) 1999-2003 Apple Computer, Inc. All Rights Reserved. * * This file contains Original Code and/or Modifications of Original Code * as defined in and that are subject to the Apple Public Source License * Version 2.0 (the 'License'). You may not use this file except in * compliance with the License. Please obtain a copy of the License at * http://www.opensource.apple.com/apsl/ and read it before using this * file. * * The Original Code and all software distributed under the License are * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES, * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT. * Please see the License for the specific language governing rights and * limitations under the License. * * @APPLE_LICENSE_HEADER_END@ */ /* ==================================================================== * Copyright (c) 1995-1999 The Apache Group. 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 acknowledgment: * "This product includes software developed by the Apache Group * for use in the Apache HTTP server project (http://www.apache.org/)." * * 4. The names "Apache Server" and "Apache Group" must not be used to * endorse or promote products derived from this software without * prior written permission. For written permission, please contact * apache@apache.org. * * 5. Products derived from this software may not be called "Apache" * nor may "Apache" appear in their names without prior written * permission of the Apache Group. * * 6. Redistributions of any form whatsoever must retain the following * acknowledgment: * "This product includes software developed by the Apache Group * for use in the Apache HTTP server project (http://www.apache.org/)." * * THIS SOFTWARE IS PROVIDED BY THE APACHE GROUP ``AS IS'' AND ANY * EXPRESSED 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 APACHE GROUP 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. * ==================================================================== * * This software consists of voluntary contributions made by many * individuals on behalf of the Apache Group and was originally based * on public domain software written at the National Center for * Supercomputing Applications, University of Illinois, Urbana-Champaign. * For more information on the Apache Group and the Apache HTTP server * project, please see . * */ /* Base64 encoder/decoder. Originally Apache file ap_base64.c */ #include #include "base64.h" /* aaaack but it's fast and const should make it shared text page. */ static const unsigned char pr2six[256] = { /* ASCII table */ 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 62, 64, 64, 64, 63, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 64, 64, 64, 64, 64, 64, 64, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 64, 64, 64, 64, 64, 64, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64, 64 }; int Base64decode_len(const char *bufcoded) { int nbytesdecoded; register const unsigned char *bufin; register int nprbytes; bufin = (const unsigned char *) bufcoded; while (pr2six[*(bufin++)] <= 63); nprbytes = (bufin - (const unsigned char *) bufcoded) - 1; nbytesdecoded = ((nprbytes + 3) / 4) * 3; return nbytesdecoded + 1; } int Base64decode(char *bufplain, const char *bufcoded) { int nbytesdecoded; register const unsigned char *bufin; register unsigned char *bufout; register int nprbytes; bufin = (const unsigned char *) bufcoded; while (pr2six[*(bufin++)] <= 63); nprbytes = (bufin - (const unsigned char *) bufcoded) - 1; nbytesdecoded = ((nprbytes + 3) / 4) * 3; bufout = (unsigned char *) bufplain; bufin = (const unsigned char *) bufcoded; while (nprbytes > 4) { *(bufout++) = (unsigned char) (pr2six[*bufin] << 2 | pr2six[bufin[1]] >> 4); *(bufout++) = (unsigned char) (pr2six[bufin[1]] << 4 | pr2six[bufin[2]] >> 2); *(bufout++) = (unsigned char) (pr2six[bufin[2]] << 6 | pr2six[bufin[3]]); bufin += 4; nprbytes -= 4; } /* Note: (nprbytes == 1) would be an error, so just ingore that case */ if (nprbytes > 1) { *(bufout++) = (unsigned char) (pr2six[*bufin] << 2 | pr2six[bufin[1]] >> 4); } if (nprbytes > 2) { *(bufout++) = (unsigned char) (pr2six[bufin[1]] << 4 | pr2six[bufin[2]] >> 2); } if (nprbytes > 3) { *(bufout++) = (unsigned char) (pr2six[bufin[2]] << 6 | pr2six[bufin[3]]); } *(bufout++) = '\0'; nbytesdecoded -= (4 - nprbytes) & 3; return nbytesdecoded; } static const char basis_64[] = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/"; int Base64encode_len(int len) { return ((len + 2) / 3 * 4) + 1; } int Base64encode(char *encoded, const char *string, int len) { int i; char *p; p = encoded; for (i = 0; i < len - 2; i += 3) { *p++ = basis_64[(string[i] >> 2) & 0x3F]; *p++ = basis_64[((string[i] & 0x3) << 4) | ((int) (string[i + 1] & 0xF0) >> 4)]; *p++ = basis_64[((string[i + 1] & 0xF) << 2) | ((int) (string[i + 2] & 0xC0) >> 6)]; *p++ = basis_64[string[i + 2] & 0x3F]; } if (i < len) { *p++ = basis_64[(string[i] >> 2) & 0x3F]; if (i == (len - 1)) { *p++ = basis_64[((string[i] & 0x3) << 4)]; *p++ = '='; } else { *p++ = basis_64[((string[i] & 0x3) << 4) | ((int) (string[i + 1] & 0xF0) >> 4)]; *p++ = basis_64[((string[i + 1] & 0xF) << 2)]; } *p++ = '='; } *p++ = '\0'; return p - encoded; } ================================================ FILE: app/util/base64.h ================================================ /* * Copyright (c) 2003 Apple Computer, Inc. All rights reserved. * * @APPLE_LICENSE_HEADER_START@ * * Copyright (c) 1999-2003 Apple Computer, Inc. All Rights Reserved. * * This file contains Original Code and/or Modifications of Original Code * as defined in and that are subject to the Apple Public Source License * Version 2.0 (the 'License'). You may not use this file except in * compliance with the License. Please obtain a copy of the License at * http://www.opensource.apple.com/apsl/ and read it before using this * file. * * The Original Code and all software distributed under the License are * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES, * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT. * Please see the License for the specific language governing rights and * limitations under the License. * * @APPLE_LICENSE_HEADER_END@ */ /* ==================================================================== * Copyright (c) 1995-1999 The Apache Group. 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 acknowledgment: * "This product includes software developed by the Apache Group * for use in the Apache HTTP server project (http://www.apache.org/)." * * 4. The names "Apache Server" and "Apache Group" must not be used to * endorse or promote products derived from this software without * prior written permission. For written permission, please contact * apache@apache.org. * * 5. Products derived from this software may not be called "Apache" * nor may "Apache" appear in their names without prior written * permission of the Apache Group. * * 6. Redistributions of any form whatsoever must retain the following * acknowledgment: * "This product includes software developed by the Apache Group * for use in the Apache HTTP server project (http://www.apache.org/)." * * THIS SOFTWARE IS PROVIDED BY THE APACHE GROUP ``AS IS'' AND ANY * EXPRESSED 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 APACHE GROUP 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. * ==================================================================== * * This software consists of voluntary contributions made by many * individuals on behalf of the Apache Group and was originally based * on public domain software written at the National Center for * Supercomputing Applications, University of Illinois, Urbana-Champaign. * For more information on the Apache Group and the Apache HTTP server * project, please see . * */ #ifndef _BASE64_H_ #define _BASE64_H_ #ifdef __cplusplus extern "C" { #endif int Base64encode_len(int len); int Base64encode(char * coded_dst, const char *plain_src,int len_plain_src); int Base64decode_len(const char * coded_src); int Base64decode(char * plain_dst, const char *coded_src); #ifdef __cplusplus } #endif #endif //_BASE64_H_ ================================================ FILE: app/util/linked_list.c ================================================ #include "mem.h" #include "linked_list.h" #include "osapi.h" /** create anode */ static node* list_create_node (void* item) { node* n = (node*) os_malloc (sizeof(node)); n->item = item; n->prev = NULL; n->next = NULL; return n; } /** add item to head */ void list_add_first (linked_list* _this,void* item) { node* newNode = list_create_node(item); node* head = _this->head; // list is empty if (head == NULL) _this->head = newNode; else { // has item(s) node* last = _this->tail; if (last == NULL) // only head node last = head; newNode->next = head; head->prev = newNode; _this->head = newNode; _this->tail = last; } _this->size++; } /** add item to tail */ void list_add_last (linked_list* _this, void* item) { node* newNode = list_create_node(item); node* head = _this->head; node* tail = _this->tail; // list is empty if (head == NULL) _this->head = newNode; else { // has item(s) node* lastNode = tail; if (tail == NULL) // only head node lastNode = head; lastNode->next = newNode; newNode->prev = lastNode; _this->tail = newNode; } _this->size++; } /** add item to any position */ void list_add (linked_list* _this, void* item, int position) { // index out of list size if (position > _this->size) { return; } // add to head if (position == 0) { list_add_first(_this, item); } else if (position == _this->size) { // add to tail list_add_last(_this, item); } else { // insert between head and tail node* n = _this->head; int i = 0; // loop until the position while (i < position) { n = n->next; i++; } // insert new node to position node* newNode = list_create_node(item); list_insert_before(_this, n, newNode); _this->size++; } } /** insert one node before another, * newNdoe, node and node->prev should not be null. */ void list_insert_before (linked_list* _this,node* n,node* newNode) { node* prev = n->prev; n->prev = newNode; newNode->next = n; prev->next = newNode; newNode->prev = prev; } /** get item from specific position */ void* list_get (linked_list* _this, int position) { // list is empty if (_this->size == 0) { //NODE_DBG("LinkedList#get: The list is empty."); return NULL; } else if (position >= _this->size) { // out of bound //NODE_DBG("LinkedList#get: Index out of bound"); return NULL; } // get head item if (position == 0) { return list_get_first(_this); } else if (position+1 == _this->size) { // get tail item return list_get_last(_this); } else { node* node = _this->head; int i = 0; // loop until position while (i < position) { node = node->next; i++; } return node->item; } } /** get item from head */ void* list_get_first (linked_list* _this) { // list is empty if (_this->size == 0) { //NODE_DBG("LinkedList#getFirst: The list is empty."); return NULL; } return _this->head->item; } /** get item from tail */ void* list_get_last (linked_list* _this) { // list is empty if (_this->size == 0) { //NODE_DBG("LinkedList#getLast: The list is empty."); return NULL; } // only head node if (_this->size == 1) { return list_get_first(_this); } return _this->tail->item; } void* list_remove_node(linked_list* _this,node *n){ // list is empty if (_this->size == 0) { //NODE_DBG("LinkedList#_remove: The list is empty."); return NULL; } if(n->prev!=NULL) n->prev->next = n->next; else _this->head=n->next; if(n->next!=NULL) n->next->prev = n->prev; else _this->tail = n->prev; void* r = n->item; os_free(n); return r; } /** get item and remove it from any position */ void* list_remove (linked_list* _this, int position) { // list is empty if (_this->size == 0) { //NODE_DBG("LinkedList#_remove: The list is empty."); return NULL; } else if (position >= _this->size) { // out of bound //NODE_DBG("LinkedList#_remove: Index out of bound"); return NULL; } // remove from head if (position == 0) { return list_remove_first(_this); } else if (position+1 == _this->size) { // remove from tail return list_remove_last(_this); } else { node* n = _this->head; node* prev; node* next; int i = 0; void* item; // loop until position while (i < position) { n = n->next; i++; } item = n->item; // remove node from list prev = n->prev; next = n->next; prev->next = next; next->prev = prev; os_free(n); _this->size--; return item ; } } /** get and remove item from head */ void* list_remove_first (linked_list* _this) { node* head = _this->head; node* next; void* item; // list is empty if (head == NULL) { //NODE_DBG("LinkedList#_removeFirst: The list is empty."); return NULL; } item = head->item; next = head->next; _this->head = next; if (next != NULL) // has next item next->prev = NULL; os_free(head); _this->size--; if (_this->size <= 1) // empty or only head node _this->tail = NULL; return item; } /** get and remove item from tail */ void* list_remove_last (linked_list* _this) { // list is empty if (_this->size == 0) { //NODE_DBG("LinkedList#_removeLast: The list is empty."); return NULL; } if (_this->size == 1) { // only head node return list_remove_first(_this); } else { node* tail = _this->tail; node* prev = tail->prev; void* item = tail->item; prev->next = NULL; os_free(tail); if (_this->size > 1) _this->tail = prev; _this->size--; if (_this->size <= 1) // empty or only head node _this->tail = NULL; return item; } } /** create a LinkedList */ linked_list* create_linked_list () { linked_list *list = (linked_list *)os_malloc(sizeof(linked_list)); init_linked_list(list); return list; } void init_linked_list(linked_list *list){ os_memset(list,0,sizeof(linked_list)); list->head = NULL; list->tail = NULL; list->size=0; } ================================================ FILE: app/util/linked_list.h ================================================ /* * File: LinkedList.h * Author: me_000 * * Created on 6 de Julho de 2015, 15:21 */ #ifndef LINKEDLIST_H #define LINKEDLIST_H #ifdef __cplusplus extern "C" { #endif /** * The Node struct, * contains item and the pointers that point to previous node/next node. */ typedef struct node { void* item; // previous node struct node* prev; // next node struct node* next; } node; /** * The LinkedList struct, contains the pointers that * point to first node and last node, the size of the LinkedList, * and the function pointers. */ typedef struct linked_list { node* head; node* tail; // size of this LinkedList int size; } linked_list; void list_add_first (linked_list* _this, void* item); void list_add_last (linked_list* _this, void* item); void list_add (linked_list* _this, void* item, int position); void list_insert_before (linked_list* _this, node* previous_node, node* new_node); void* list_get (linked_list* _this, int position); void* list_get_first (linked_list* _this); void* list_get_last (linked_list* _this); void* list_remove_node(linked_list* _this, node *node_to_remove); void* list_remove (linked_list* _this, int position); void* list_remove_first (linked_list* _this); void* list_remove_last (linked_list* _this); linked_list* create_linked_list (); void init_linked_list(linked_list *list); #ifdef __cplusplus } #endif #endif /* LINKEDLIST_H */ ================================================ FILE: bin/.gitignore ================================================ * *.S *.dump *.bin *.bin_rep !.gitignore !blank.bin !esp_init_data_default.bin ================================================ FILE: include/at_custom.h ================================================ /* * custom_at.h * * This file is part of Espressif's AT+ command set program. * Copyright (C) 2013 - 2016, Espressif Systems * * This program is free software: you can redistribute it and/or modify * it under the terms of version 3 of the GNU General Public License 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. * * You should have received a copy of the GNU General Public License along * with this program. If not, see . */ #ifndef CUSTOM_AT_H_ #define CUSTOM_AT_H_ #include "c_types.h" typedef struct { char *at_cmdName; int8_t at_cmdLen; void (*at_testCmd)(uint8_t id); void (*at_queryCmd)(uint8_t id); void (*at_setupCmd)(uint8_t id, char *pPara); void (*at_exeCmd)(uint8_t id); }at_funcationType; extern uint8 at_customLinkMax; /** * @brief Response "OK" to uart. * @param None * @retval None */ void at_response_ok(void); /** * @brief Response "ERROR" to uart. * @param events: no used * @retval None */ void at_response_error(void); /** * @brief Task of process command or txdata. * @param custom_at_cmd_array: the array of at cmd that custom defined * cmd_num : the num of at cmd that custom defined * @retval None */ void at_cmd_array_regist(at_funcationType *custom_at_cmd_array,uint32 cmd_num); /** * @brief get digit form at cmd line.the maybe alter pSrc * @param p_src: at cmd line string * result:the buffer to be placed result * err : err num * @retval TRUE: * FALSE: */ bool at_get_next_int_dec(char **p_src,int*result,int* err); /** * @brief get string form at cmd line.the maybe alter pSrc * @param p_dest: the buffer to be placed result * p_src: at cmd line string * max_len :max len of string excepted to get * @retval None */ int32 at_data_str_copy(char *p_dest, char **p_src, int32 max_len); /** * @brief initialize at module * @param None * @retval None */ void at_init(void); /** * @brief print string to at port * @param string * @retval None */ void at_port_print(const char *str); /** * @brief print custom information when AT+GMR * @param string * @retval None */ void at_set_custom_info(char* info); /** * @brief if current at command is processing,you can call at_enter_special_state, * then if other comamnd coming,it will return busy. * @param None * @retval None */ void at_enter_special_state(void); /** * @brief * @param None * @retval None */ void at_leave_special_state(void); /** * @brief get at version * @param None * @retval at version * bit24~31: at main version * bit23~16: at sub version * bit15~8 : at test version * bit7~0 : customized version */ uint32 at_get_version(void); #endif ================================================ FILE: include/c_types.h ================================================ /* * Copyright (c) 2010 - 2011 Espressif System * */ #ifndef _C_TYPES_H_ #define _C_TYPES_H_ typedef unsigned char uint8_t; typedef signed char sint8_t; typedef signed char int8_t; typedef unsigned short uint16_t; typedef signed short sint16_t; typedef signed short int16_t; typedef unsigned long uint32_t; typedef signed long sint32_t; typedef signed long int32_t; typedef signed long long sint64_t; typedef unsigned long long uint64_t; typedef unsigned long long u_int64_t; typedef float real32_t; typedef double real64_t; typedef unsigned char uint8; typedef unsigned char u8; typedef signed char sint8; typedef signed char int8; typedef signed char s8; typedef unsigned short uint16; typedef unsigned short u16; typedef signed short sint16; typedef signed short s16; typedef unsigned int uint32; typedef unsigned int u_int; typedef unsigned int u32; typedef signed int sint32; typedef signed int s32; typedef int int32; typedef signed long long sint64; typedef unsigned long long uint64; typedef unsigned long long u64; typedef float real32; typedef double real64; #define __le16 u16 typedef unsigned int size_t; #define __packed __attribute__((packed)) #define LOCAL static #ifndef NULL #define NULL (void *)0 #endif /* NULL */ /* probably should not put STATUS here */ typedef enum { OK = 0, FAIL, PENDING, BUSY, CANCEL, } STATUS; #define BIT(nr) (1UL << (nr)) #define REG_SET_BIT(_r, _b) (*(volatile uint32_t*)(_r) |= (_b)) #define REG_CLR_BIT(_r, _b) (*(volatile uint32_t*)(_r) &= ~(_b)) #define DMEM_ATTR __attribute__((section(".bss"))) #define SHMEM_ATTR #ifdef ICACHE_FLASH #define ICACHE_FLASH_ATTR __attribute__((section(".irom0.text"))) #define ICACHE_RODATA_ATTR __attribute__((section(".irom.text"))) #else #define ICACHE_FLASH_ATTR #define ICACHE_RODATA_ATTR #endif /* ICACHE_FLASH */ #define STORE_ATTR __attribute__((aligned(4))) #ifndef __cplusplus typedef unsigned char bool; #define BOOL bool #define true (1) #define false (0) #define TRUE true #define FALSE false #endif /* !__cplusplus */ #endif /* _C_TYPES_H_ */ ================================================ FILE: include/eagle_soc.h ================================================ /* * Copyright (c) Espressif System 2010 - 2012 * */ #ifndef _EAGLE_SOC_H_ #define _EAGLE_SOC_H_ //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 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_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)<<(shift)) )) //}} //Periheral Clock {{ #define CPU_CLK_FREQ 80*1000000 //unit: Hz #define APB_CLK_FREQ CPU_CLK_FREQ #define UART_CLK_FREQ APB_CLK_FREQ #define TIMER_CLK_FREQ (APB_CLK_FREQ>>8) //divided by 256 //}} //Peripheral device base address define{{ #define PERIPHS_DPORT_BASEADDR 0x3ff00000 #define PERIPHS_GPIO_BASEADDR 0x60000300 #define PERIPHS_TIMER_BASEDDR 0x60000600 #define PERIPHS_RTC_BASEADDR 0x60000700 #define PERIPHS_IO_MUX 0x60000800 //}} //Interrupt remap control registers define{{ #define EDGE_INT_ENABLE_REG (PERIPHS_DPORT_BASEADDR+0x04) #define TM1_EDGE_INT_ENABLE() SET_PERI_REG_MASK(EDGE_INT_ENABLE_REG, BIT1) #define TM1_EDGE_INT_DISABLE() CLEAR_PERI_REG_MASK(EDGE_INT_ENABLE_REG, BIT1) //}} //GPIO reg {{ #define GPIO_REG_READ(reg) READ_PERI_REG(PERIPHS_GPIO_BASEADDR + reg) #define GPIO_REG_WRITE(reg, val) WRITE_PERI_REG(PERIPHS_GPIO_BASEADDR + reg, val) #define GPIO_OUT_ADDRESS 0x00 #define GPIO_OUT_W1TS_ADDRESS 0x04 #define GPIO_OUT_W1TC_ADDRESS 0x08 #define GPIO_ENABLE_ADDRESS 0x0c #define GPIO_ENABLE_W1TS_ADDRESS 0x10 #define GPIO_ENABLE_W1TC_ADDRESS 0x14 #define GPIO_OUT_W1TC_DATA_MASK 0x0000ffff #define GPIO_IN_ADDRESS 0x18 #define GPIO_STATUS_ADDRESS 0x1c #define GPIO_STATUS_W1TS_ADDRESS 0x20 #define GPIO_STATUS_W1TC_ADDRESS 0x24 #define GPIO_STATUS_INTERRUPT_MASK 0x0000ffff #define GPIO_RTC_CALIB_SYNC PERIPHS_GPIO_BASEADDR+0x6c #define RTC_CALIB_START BIT31 //first write to zero, then to one to start #define RTC_PERIOD_NUM_MASK 0x3ff //max 8ms #define GPIO_RTC_CALIB_VALUE PERIPHS_GPIO_BASEADDR+0x70 #define RTC_CALIB_RDY_S 31 //after measure, flag to one, when start from zero to one, turn to zero #define RTC_CALIB_VALUE_MASK 0xfffff #define GPIO_PIN0_ADDRESS 0x28 #define GPIO_ID_PIN0 0 #define GPIO_ID_PIN(n) (GPIO_ID_PIN0+(n)) #define GPIO_LAST_REGISTER_ID GPIO_ID_PIN(15) #define GPIO_ID_NONE 0xffffffff #define GPIO_PIN_COUNT 16 #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) #define GPIO_AS_PIN_SOURCE 0 #define SIGMA_AS_PIN_SOURCE (~GPIO_AS_PIN_SOURCE) #define GPIO_PIN_SOURCE_MSB 0 #define GPIO_PIN_SOURCE_LSB 0 #define GPIO_PIN_SOURCE_MASK 0x00000001 #define GPIO_PIN_SOURCE_GET(x) (((x) & GPIO_PIN_SOURCE_MASK) >> GPIO_PIN_SOURCE_LSB) #define GPIO_PIN_SOURCE_SET(x) (((x) << GPIO_PIN_SOURCE_LSB) & GPIO_PIN_SOURCE_MASK) // }} // TIMER reg {{ #define RTC_REG_READ(addr) READ_PERI_REG(PERIPHS_TIMER_BASEDDR + addr) #define RTC_REG_WRITE(addr, val) WRITE_PERI_REG(PERIPHS_TIMER_BASEDDR + addr, val) #define RTC_CLR_REG_MASK(reg, mask) CLEAR_PERI_REG_MASK(PERIPHS_TIMER_BASEDDR +reg, mask) /* Returns the current time according to the timer timer. */ #define NOW() RTC_REG_READ(FRC2_COUNT_ADDRESS) //load initial_value to timer1 #define FRC1_LOAD_ADDRESS 0x00 //timer1's counter value(count from initial_value to 0) #define FRC1_COUNT_ADDRESS 0x04 #define FRC1_CTRL_ADDRESS 0x08 //clear timer1's interrupt when write this address #define FRC1_INT_ADDRESS 0x0c #define FRC1_INT_CLR_MASK 0x00000001 //timer2's counter value(count from initial_value to 0) #define FRC2_COUNT_ADDRESS 0x24 // }} //RTC reg {{ #define REG_RTC_BASE PERIPHS_RTC_BASEADDR #define RTC_GPIO_OUT (REG_RTC_BASE + 0x068) #define RTC_GPIO_ENABLE (REG_RTC_BASE + 0x074) #define RTC_GPIO_IN_DATA (REG_RTC_BASE + 0x08C) #define RTC_GPIO_CONF (REG_RTC_BASE + 0x090) #define PAD_XPD_DCDC_CONF (REG_RTC_BASE + 0x0A0) //}} //PIN Mux reg {{ #define PERIPHS_IO_MUX_FUNC 0x13 #define PERIPHS_IO_MUX_FUNC_S 4 #define PERIPHS_IO_MUX_PULLUP BIT7 #define PERIPHS_IO_MUX_PULLDWN BIT6 #define PERIPHS_IO_MUX_SLEEP_PULLUP BIT3 #define PERIPHS_IO_MUX_SLEEP_PULLDWN BIT2 #define PERIPHS_IO_MUX_SLEEP_OE BIT1 #define PERIPHS_IO_MUX_OE BIT0 #define PERIPHS_IO_MUX_CONF_U (PERIPHS_IO_MUX + 0x00) #define SPI0_CLK_EQU_SYS_CLK BIT8 #define SPI1_CLK_EQU_SYS_CLK BIT9 #define PERIPHS_IO_MUX_MTDI_U (PERIPHS_IO_MUX + 0x04) #define FUNC_GPIO12 3 #define PERIPHS_IO_MUX_MTCK_U (PERIPHS_IO_MUX + 0x08) #define FUNC_GPIO13 3 #define PERIPHS_IO_MUX_MTMS_U (PERIPHS_IO_MUX + 0x0C) #define FUNC_GPIO14 3 #define PERIPHS_IO_MUX_MTDO_U (PERIPHS_IO_MUX + 0x10) #define FUNC_GPIO15 3 #define FUNC_U0RTS 4 #define PERIPHS_IO_MUX_U0RXD_U (PERIPHS_IO_MUX + 0x14) #define FUNC_U0RXD 0 #define FUNC_GPIO3 3 #define PERIPHS_IO_MUX_U0TXD_U (PERIPHS_IO_MUX + 0x18) #define FUNC_U0TXD 0 #define FUNC_GPIO1 3 #define PERIPHS_IO_MUX_SD_CLK_U (PERIPHS_IO_MUX + 0x1c) #define FUNC_SDCLK 0 #define FUNC_SPICLK 1 #define PERIPHS_IO_MUX_SD_DATA0_U (PERIPHS_IO_MUX + 0x20) #define FUNC_SDDATA0 0 #define FUNC_SPIQ 1 #define FUNC_U1TXD 4 #define PERIPHS_IO_MUX_SD_DATA1_U (PERIPHS_IO_MUX + 0x24) #define FUNC_SDDATA1 0 #define FUNC_SPID 1 #define FUNC_U1RXD 4 #define FUNC_SDDATA1_U1RXD 7 #define PERIPHS_IO_MUX_SD_DATA2_U (PERIPHS_IO_MUX + 0x28) #define FUNC_SDDATA2 0 #define FUNC_SPIHD 1 #define FUNC_GPIO9 3 #define PERIPHS_IO_MUX_SD_DATA3_U (PERIPHS_IO_MUX + 0x2c) #define FUNC_SDDATA3 0 #define FUNC_SPIWP 1 #define FUNC_GPIO10 3 #define PERIPHS_IO_MUX_SD_CMD_U (PERIPHS_IO_MUX + 0x30) #define FUNC_SDCMD 0 #define FUNC_SPICS0 1 #define PERIPHS_IO_MUX_GPIO0_U (PERIPHS_IO_MUX + 0x34) #define FUNC_GPIO0 0 #define PERIPHS_IO_MUX_GPIO2_U (PERIPHS_IO_MUX + 0x38) #define FUNC_GPIO2 0 #define FUNC_U1TXD_BK 2 #define FUNC_U0TXD_BK 4 #define PERIPHS_IO_MUX_GPIO4_U (PERIPHS_IO_MUX + 0x3C) #define FUNC_GPIO4 0 #define PERIPHS_IO_MUX_GPIO5_U (PERIPHS_IO_MUX + 0x40) #define FUNC_GPIO5 0 #define PIN_PULLUP_DIS(PIN_NAME) CLEAR_PERI_REG_MASK(PIN_NAME, PERIPHS_IO_MUX_PULLUP) #define PIN_PULLUP_EN(PIN_NAME) SET_PERI_REG_MASK(PIN_NAME, PERIPHS_IO_MUX_PULLUP) #define PIN_PULLDWN_DIS(PIN_NAME) CLEAR_PERI_REG_MASK(PIN_NAME, PERIPHS_IO_MUX_PULLDWN) #define PIN_PULLDWN_EN(PIN_NAME) SET_PERI_REG_MASK(PIN_NAME, PERIPHS_IO_MUX_PULLDWN) #define PIN_FUNC_SELECT(PIN_NAME, FUNC) do { \ CLEAR_PERI_REG_MASK(PIN_NAME, (PERIPHS_IO_MUX_FUNC<= 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_ANYEDGE = 3, GPIO_PIN_INTR_LOLEVEL = 4, GPIO_PIN_INTR_HILEVEL = 5 } GPIO_INT_TYPE; #define GPIO_OUTPUT_SET(gpio_no, bit_value) \ gpio_output_set(bit_value<>gpio_no)&BIT0) /* GPIO interrupt handler, registered through gpio_intr_handler_register */ typedef void (* gpio_intr_handler_fn_t)(uint32 intr_mask, 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); /* * 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 set_mask, uint32 clear_mask, uint32 enable_mask, uint32 disable_mask); /* * Sample the value of GPIO input pins and returns a bitmask. */ uint32 gpio_input_get(void); /* * 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 reg_id, uint32 value); /* Get the current value of the specified GPIO register. */ uint32 gpio_register_get(uint32 reg_id); /* * 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); /* Determine which GPIO interrupts are pending. */ uint32 gpio_intr_pending(void); /* * Acknowledge GPIO interrupts. * Intended to be called from the gpio_intr_handler_fn. */ void gpio_intr_ack(uint32 ack_mask); void gpio_pin_wakeup_enable(uint32 i, GPIO_INT_TYPE intr_state); void gpio_pin_wakeup_disable(); void gpio_pin_intr_state_set(uint32 i, GPIO_INT_TYPE intr_state); #endif // _GPIO_H_ ================================================ FILE: include/ip_addr.h ================================================ #ifndef __IP_ADDR_H__ #define __IP_ADDR_H__ #include "c_types.h" struct ip_addr { uint32 addr; }; typedef struct ip_addr ip_addr_t; struct ip_info { struct ip_addr ip; struct ip_addr netmask; struct ip_addr gw; }; #define IP4_ADDR(ipaddr, a,b,c,d) \ (ipaddr)->addr = ((uint32)((d) & 0xff) << 24) | \ ((uint32)((c) & 0xff) << 16) | \ ((uint32)((b) & 0xff) << 8) | \ (uint32)((a) & 0xff) /** * 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 ip_addr_netcmp(addr1, addr2, mask) (((addr1)->addr & \ (mask)->addr) == \ ((addr2)->addr & \ (mask)->addr)) /** 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 = ((uint32)((d) & 0xff) << 24) | \ ((uint32)((c) & 0xff) << 16) | \ ((uint32)((b) & 0xff) << 8) | \ (uint32)((a) & 0xff) #define ip4_addr1(ipaddr) (((uint8*)(ipaddr))[0]) #define ip4_addr2(ipaddr) (((uint8*)(ipaddr))[1]) #define ip4_addr3(ipaddr) (((uint8*)(ipaddr))[2]) #define ip4_addr4(ipaddr) (((uint8*)(ipaddr))[3]) #define ip4_addr1_16(ipaddr) ((uint16)ip4_addr1(ipaddr)) #define ip4_addr2_16(ipaddr) ((uint16)ip4_addr2(ipaddr)) #define ip4_addr3_16(ipaddr) ((uint16)ip4_addr3(ipaddr)) #define ip4_addr4_16(ipaddr) ((uint16)ip4_addr4(ipaddr)) /** 255.255.255.255 */ #define IPADDR_NONE ((uint32)0xffffffffUL) /** 0.0.0.0 */ #define IPADDR_ANY ((uint32)0x00000000UL) uint32 ipaddr_addr(const char *cp); #define IP2STR(ipaddr) ip4_addr1_16(ipaddr), \ ip4_addr2_16(ipaddr), \ ip4_addr3_16(ipaddr), \ ip4_addr4_16(ipaddr) #define IPSTR "%d.%d.%d.%d" #endif /* __IP_ADDR_H__ */ ================================================ FILE: include/mem.h ================================================ #ifndef __MEM_H__ #define __MEM_H__ /* Note: check_memleak_debug_enable is a weak function inside SDK. * please copy following codes to user_main.c. #include "mem.h" bool ICACHE_FLASH_ATTR check_memleak_debug_enable(void) { return MEMLEAK_DEBUG_ENABLE; } */ #ifndef MEMLEAK_DEBUG #define MEMLEAK_DEBUG_ENABLE 0 #define os_free(s) vPortFree(s, "", 0) #define os_malloc(s) pvPortMalloc(s, "", 0) #define os_calloc(s) pvPortCalloc(s, "", 0); #define os_realloc(p, s) pvPortRealloc(p, s, "", 0) #define os_zalloc(s) pvPortZalloc(s, "", 0) #else #define MEMLEAK_DEBUG_ENABLE 1 #define os_free(s) \ do{\ static const char mem_debug_file[] ICACHE_RODATA_ATTR STORE_ATTR = __FILE__; \ vPortFree(s, mem_debug_file, __LINE__);\ }while(0) #define os_malloc(s) \ ({ \ static const char mem_debug_file[] ICACHE_RODATA_ATTR STORE_ATTR = __FILE__; \ pvPortMalloc(s, mem_debug_file, __LINE__); \ }) #define os_calloc(s) \ ({ \ static const char mem_debug_file[] ICACHE_RODATA_ATTR STORE_ATTR = __FILE__; \ pvPortCalloc(s, mem_debug_file, __LINE__); \ }) #define os_realloc(p, s) \ ({ \ static const char mem_debug_file[] ICACHE_RODATA_ATTR STORE_ATTR = __FILE__; \ pvPortRealloc(p, s, mem_debug_file, __LINE__); \ }) #define os_zalloc(s) \ ({ \ static const char mem_debug_file[] ICACHE_RODATA_ATTR STORE_ATTR = __FILE__; \ pvPortZalloc(s, mem_debug_file, __LINE__); \ }) #endif #endif ================================================ FILE: include/mesh.h ================================================ #ifndef __LWIP_API_MESH_H__ #define __LWIP_API_MESH_H__ #include "ip_addr.h" #include "user_interface.h" #include "espconn.h" typedef void (* espconn_mesh_callback)(); enum mesh_type { MESH_CLOSE = 0, MESH_LOCAL, MESH_ONLINE, MESH_NONE = 0xFF }; enum mesh_status { MESH_DISABLE = 0, MESH_WIFI_CONN, MESH_NET_CONN, MESH_LOCAL_AVAIL, MESH_ONLINE_AVAIL }; enum mesh_node_type { MESH_NODE_PARENT = 0, MESH_NODE_CHILD, MESH_NODE_ALL }; bool espconn_mesh_local_addr(struct ip_addr *ip); bool espconn_mesh_get_node_info(enum mesh_node_type type, uint8_t **info, uint8_t *count); bool espconn_mesh_get_router(struct station_config *router); bool espconn_mesh_set_router(struct station_config *router); bool espconn_mesh_encrypt_init(AUTH_MODE mode, uint8_t *passwd, uint8_t passwd_len); bool espconn_mesh_set_ssid_prefix(uint8_t *prefix, uint8_t prefix_len); bool espconn_mesh_set_max_hops(uint8_t max_hops); char * espconn_json_find_section(const char *pbuf, u16 len, const char *section); sint8 espconn_mesh_connect(struct espconn *usr_esp); sint8 espconn_mesh_disconnect(struct espconn *usr_esp); sint8 espconn_mesh_get_status(); sint8 espconn_mesh_sent(struct espconn *usr_esp, uint8 *pdata, uint16 len); uint8 espconn_mesh_get_max_hops(); uint8 espconn_mesh_layer(struct ip_addr *ip); uint32_t user_json_get_value(const char *pbuffer, uint16_t buf_len, const uint8_t *json_key); void espconn_mesh_enable(espconn_mesh_callback enable_cb, enum mesh_type type); void espconn_mesh_disable(espconn_mesh_callback disable_cb); void espconn_mesh_init(); void espconn_mesh_init_group_list(uint8_t *dev_mac, uint16_t dev_count); void espconn_mesh_set_dev_type(uint8_t dev_type); void espconn_mesh_setup_timer(os_timer_t *timer, uint32_t time, os_timer_func_t cb, void *arg, bool repeat); #endif ================================================ FILE: include/os_type.h ================================================ /* * copyright (c) Espressif System 2010 * * mapping to ETS structures * */ #ifndef _OS_TYPES_H_ #define _OS_TYPES_H_ #include "ets_sys.h" #define os_signal_t ETSSignal #define os_param_t ETSParam #define os_event_t ETSEvent #define os_task_t ETSTask #define os_timer_t ETSTimer #define os_timer_func_t ETSTimerFunc #endif ================================================ FILE: include/osapi.h ================================================ /* * Copyright (c) 2010 Espressif System */ #ifndef _OSAPI_H_ #define _OSAPI_H_ #include #include "user_config.h" #define os_bzero ets_bzero #define os_delay_us ets_delay_us #define os_install_putc1 ets_install_putc1 #define os_memcmp ets_memcmp #define os_memcpy ets_memcpy #define os_memmove ets_memmove #define os_memset ets_memset #define os_strcat strcat #define os_strchr strchr #define os_strcmp ets_strcmp #define os_strcpy ets_strcpy #define os_strlen ets_strlen #define os_strncmp ets_strncmp #define os_strncpy ets_strncpy #define os_strstr ets_strstr #ifdef USE_US_TIMER #define os_timer_arm_us(a, b, c) ets_timer_arm_new(a, b, c, 0) #endif #define os_timer_arm(a, b, c) ets_timer_arm_new(a, b, c, 1) #define os_timer_disarm ets_timer_disarm #define os_timer_setfn ets_timer_setfn #define os_sprintf ets_sprintf #ifdef USE_OPTIMIZE_PRINTF #define os_printf(fmt, ...) do { \ static const char flash_str[] ICACHE_RODATA_ATTR STORE_ATTR = fmt; \ os_printf_plus(flash_str, ##__VA_ARGS__); \ } while(0) #else #define os_printf os_printf_plus #endif unsigned long os_random(void); int os_get_random(unsigned char *buf, size_t len); #endif ================================================ FILE: include/ping.h ================================================ #ifndef __PING_H__ #define __PING_H__ typedef void (* ping_recv_function)(void* arg, void *pdata); typedef void (* ping_sent_function)(void* arg, void *pdata); struct ping_option{ uint32 count; uint32 ip; uint32 coarse_time; ping_recv_function recv_function; ping_sent_function sent_function; void* reverse; }; struct ping_resp{ uint32 total_count; uint32 resp_time; uint32 seqno; uint32 timeout_count; uint32 bytes; uint32 total_bytes; uint32 total_time; sint8 ping_err; }; bool ping_start(struct ping_option *ping_opt); bool ping_regist_recv(struct ping_option *ping_opt, ping_recv_function ping_recv); bool ping_regist_sent(struct ping_option *ping_opt, ping_sent_function ping_sent); #endif /* __PING_H__ */ ================================================ FILE: include/pwm.h ================================================ #ifndef __PWM_H__ #define __PWM_H__ /*pwm.h: function and macro definition of PWM API , driver level */ /*user_light.h: user interface for light API, user level*/ /*user_light_adj: API for color changing and lighting effects, user level*/ /*NOTE!! : DO NOT CHANGE THIS FILE*/ /*SUPPORT UP TO 8 PWM CHANNEL*/ #define PWM_CHANNEL_NUM_MAX 8 struct pwm_param { uint32 period; uint32 freq; uint32 duty[PWM_CHANNEL_NUM_MAX]; //PWM_CHANNEL<=8 }; /* pwm_init should be called only once, for now */ void pwm_init(uint32 period, uint32 *duty,uint32 pwm_channel_num,uint32 (*pin_info_list)[3]); void pwm_start(void); void pwm_set_duty(uint32 duty, uint8 channel); uint32 pwm_get_duty(uint8 channel); void pwm_set_period(uint32 period); uint32 pwm_get_period(void); uint32 get_pwm_version(void); void set_pwm_debug_en(uint8 print_en); #endif ================================================ FILE: include/queue.h ================================================ #ifndef _SYS_QUEUE_H_ #define _SYS_QUEUE_H_ #define QMD_SAVELINK(name, link) #define TRASHIT(x) /* * 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) #endif /* !_SYS_QUEUE_H_ */ ================================================ FILE: include/smartconfig.h ================================================ /* * Copyright (C) 2015 -2018 Espressif System * */ #ifndef __SMARTCONFIG_H__ #define __SMARTCONFIG_H__ typedef enum { SC_STATUS_WAIT = 0, SC_STATUS_FIND_CHANNEL, SC_STATUS_GETTING_SSID_PSWD, SC_STATUS_LINK, SC_STATUS_LINK_OVER, } sc_status; typedef enum { SC_TYPE_ESPTOUCH = 0, SC_TYPE_AIRKISS, SC_TYPE_ESPTOUCH_AIRKISS, } sc_type; typedef void (*sc_callback_t)(sc_status status, void *pdata); const char *smartconfig_get_version(void); bool smartconfig_start(sc_callback_t cb, ...); bool smartconfig_stop(void); bool esptouch_set_timeout(uint8 time_s); //15s~255s, offset:45s bool smartconfig_set_type(sc_type type); #endif ================================================ FILE: include/sntp.h ================================================ #ifndef __SNTP_H__ #define __SNTP_H__ #include "os_type.h" #ifdef LWIP_OPEN_SRC #include "lwip/ip_addr.h" #else #include "ip_addr.h" #endif /** * get the seconds since Jan 01, 1970, 00:00 (GMT + 8) */ uint32 sntp_get_current_timestamp(); /** * get real time (GTM + 8 time zone) */ char* sntp_get_real_time(long t); /** * SNTP get time_zone default GMT + 8 */ sint8 sntp_get_timezone(void); /** * SNTP set time_zone (default GMT + 8) */ bool sntp_set_timezone(sint8 timezone); /** * Initialize this module. * Send out request instantly or after SNTP_STARTUP_DELAY(_FUNC). */ void sntp_init(void); /** * Stop this module. */ void sntp_stop(void); /** * Initialize one of the NTP servers by IP address * * @param numdns the index of the NTP server to set must be < SNTP_MAX_SERVERS * @param dnsserver IP address of the NTP server to set */ void sntp_setserver(unsigned char idx, ip_addr_t *addr); /** * Obtain one of the currently configured by IP address (or DHCP) NTP servers * * @param numdns the index of the NTP server * @return IP address of the indexed NTP server or "ip_addr_any" if the NTP * server has not been configured by address (or at all). */ ip_addr_t sntp_getserver(unsigned char idx); /** * Initialize one of the NTP servers by name * * @param numdns the index of the NTP server to set must be < SNTP_MAX_SERVERS,now sdk support SNTP_MAX_SERVERS = 3 * @param dnsserver DNS name of the NTP server to set, to be resolved at contact time */ void sntp_setservername(unsigned char idx, char *server); /** * Obtain one of the currently configured by name NTP servers. * * @param numdns the index of the NTP server * @return IP address of the indexed NTP server or NULL if the NTP * server has not been configured by name (or at all) */ char *sntp_getservername(unsigned char idx); #define sntp_servermode_dhcp(x) #endif ================================================ FILE: include/spi_flash.h ================================================ /* * copyright (c) Espressif System 2010 * */ #ifndef SPI_FLASH_H #define SPI_FLASH_H typedef enum { SPI_FLASH_RESULT_OK, SPI_FLASH_RESULT_ERR, SPI_FLASH_RESULT_TIMEOUT } SpiFlashOpResult; typedef struct{ uint32 deviceId; uint32 chip_size; // chip size in byte uint32 block_size; uint32 sector_size; uint32 page_size; uint32 status_mask; } SpiFlashChip; #define SPI_FLASH_SEC_SIZE 4096 uint32 spi_flash_get_id(void); SpiFlashOpResult spi_flash_erase_sector(uint16 sec); SpiFlashOpResult spi_flash_write(uint32 des_addr, uint32 *src_addr, uint32 size); SpiFlashOpResult spi_flash_read(uint32 src_addr, uint32 *des_addr, uint32 size); typedef SpiFlashOpResult (* user_spi_flash_read)( SpiFlashChip *spi, uint32 src_addr, uint32 *des_addr, uint32 size); void spi_flash_set_read_func(user_spi_flash_read read); #endif ================================================ FILE: include/upgrade.h ================================================ #ifndef __UPGRADE_H__ #define __UPGRADE_H__ #define SPI_FLASH_SEC_SIZE 4096 #define USER_BIN1 0x00 #define USER_BIN2 0x01 #define UPGRADE_FLAG_IDLE 0x00 #define UPGRADE_FLAG_START 0x01 #define UPGRADE_FLAG_FINISH 0x02 #define UPGRADE_FW_BIN1 0x00 #define UPGRADE_FW_BIN2 0x01 typedef void (*upgrade_states_check_callback)(void * arg); //#define UPGRADE_SSL_ENABLE struct upgrade_server_info { uint8 ip[4]; uint16 port; uint8 upgrade_flag; uint8 pre_version[16]; uint8 upgrade_version[16]; uint32 check_times; uint8 *url; upgrade_states_check_callback check_cb; struct espconn *pespconn; }; #define UPGRADE_FLAG_IDLE 0x00 #define UPGRADE_FLAG_START 0x01 #define UPGRADE_FLAG_FINISH 0x02 //bool system_upgrade_start(struct upgrade_server_info *server); bool system_upgrade_start_ssl(struct upgrade_server_info *server); void system_upgrade_init(); void system_upgrade_deinit(); bool system_upgrade(uint8 *data, uint16 len); #ifdef UPGRADE_SSL_ENABLE bool system_upgrade_start_ssl(struct upgrade_server_info *server); #else bool system_upgrade_start(struct upgrade_server_info *server); #endif #endif ================================================ FILE: include/user_interface.h ================================================ /* * Copyright (C) 2013 -2014 Espressif System * */ #ifndef __USER_INTERFACE_H__ #define __USER_INTERFACE_H__ #include "os_type.h" #ifdef LWIP_OPEN_SRC #include "lwip/ip_addr.h" #else #include "ip_addr.h" #endif #include "queue.h" #include "user_config.h" #include "spi_flash.h" #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 enum rst_reason { REASON_DEFAULT_RST = 0, REASON_WDT_RST = 1, REASON_EXCEPTION_RST = 2, REASON_SOFT_WDT_RST = 3, REASON_SOFT_RESTART = 4, REASON_DEEP_SLEEP_AWAKE = 5, REASON_EXT_SYS_RST = 6 }; struct rst_info{ uint32 reason; uint32 exccause; uint32 epc1; uint32 epc2; uint32 epc3; uint32 excvaddr; uint32 depc; }; struct rst_info* system_get_rst_info(void); #define UPGRADE_FW_BIN1 0x00 #define UPGRADE_FW_BIN2 0x01 void system_restore(void); void system_restart(void); bool system_deep_sleep_set_option(uint8 option); void system_deep_sleep(uint32 time_in_us); uint8 system_upgrade_userbin_check(void); void system_upgrade_reboot(void); uint8 system_upgrade_flag_check(); void system_upgrade_flag_set(uint8 flag); void system_timer_reinit(void); uint32 system_get_time(void); /* user task's prio must be 0/1/2 !!!*/ enum { USER_TASK_PRIO_0 = 0, USER_TASK_PRIO_1, USER_TASK_PRIO_2, USER_TASK_PRIO_MAX }; bool system_os_task(os_task_t task, uint8 prio, os_event_t *queue, uint8 qlen); bool system_os_post(uint8 prio, os_signal_t sig, os_param_t par); void system_print_meminfo(void); uint32 system_get_free_heap_size(void); void system_set_os_print(uint8 onoff); uint8 system_get_os_print(); uint64 system_mktime(uint32 year, uint32 mon, uint32 day, uint32 hour, uint32 min, uint32 sec); uint32 system_get_chip_id(void); typedef void (* init_done_cb_t)(void); void system_init_done_cb(init_done_cb_t cb); uint32 system_rtc_clock_cali_proc(void); uint32 system_get_rtc_time(void); bool system_rtc_mem_read(uint8 src_addr, void *des_addr, uint16 load_size); bool system_rtc_mem_write(uint8 des_addr, const void *src_addr, uint16 save_size); void system_uart_swap(void); void system_uart_de_swap(void); uint16 system_adc_read(void); uint16 system_get_vdd33(void); const char *system_get_sdk_version(void); #define SYS_BOOT_ENHANCE_MODE 0 #define SYS_BOOT_NORMAL_MODE 1 #define SYS_BOOT_NORMAL_BIN 0 #define SYS_BOOT_TEST_BIN 1 uint8 system_get_boot_version(void); uint32 system_get_userbin_addr(void); uint8 system_get_boot_mode(void); bool system_restart_enhance(uint8 bin_type, uint32 bin_addr); #define SYS_CPU_80MHZ 80 #define SYS_CPU_160MHZ 160 bool system_update_cpu_freq(uint8 freq); uint8 system_get_cpu_freq(void); enum flash_size_map { FLASH_SIZE_4M_MAP_256_256 = 0, FLASH_SIZE_2M, FLASH_SIZE_8M_MAP_512_512, FLASH_SIZE_16M_MAP_512_512, FLASH_SIZE_32M_MAP_512_512, FLASH_SIZE_16M_MAP_1024_1024, FLASH_SIZE_32M_MAP_1024_1024 }; enum flash_size_map system_get_flash_size_map(void); void system_phy_set_max_tpw(uint8 max_tpw); void system_phy_set_tpw_via_vdd33(uint16 vdd33); void system_phy_set_rfoption(uint8 option); void system_phy_set_powerup_option(uint8 option); bool system_param_save_with_protect(uint16 start_sec, void *param, uint16 len); bool system_param_load(uint16 start_sec, uint16 offset, void *param, uint16 len); void system_soft_wdt_stop(void); void system_soft_wdt_restart(void); void system_soft_wdt_feed(void); void system_show_malloc(void); #define NULL_MODE 0x00 #define STATION_MODE 0x01 #define SOFTAP_MODE 0x02 #define STATIONAP_MODE 0x03 typedef enum _auth_mode { AUTH_OPEN = 0, AUTH_WEP, AUTH_WPA_PSK, AUTH_WPA2_PSK, AUTH_WPA_WPA2_PSK, AUTH_MAX } AUTH_MODE; uint8 wifi_get_opmode(void); uint8 wifi_get_opmode_default(void); bool wifi_set_opmode(uint8 opmode); bool wifi_set_opmode_current(uint8 opmode); uint8 wifi_get_broadcast_if(void); bool wifi_set_broadcast_if(uint8 interface); struct bss_info { STAILQ_ENTRY(bss_info) next; uint8 bssid[6]; uint8 ssid[32]; uint8 ssid_len; uint8 channel; sint8 rssi; AUTH_MODE authmode; uint8 is_hidden; sint16 freq_offset; sint16 freqcal_val; uint8 *esp_mesh_ie; }; typedef struct _scaninfo { STAILQ_HEAD(, bss_info) *pbss; struct espconn *pespconn; uint8 totalpage; uint8 pagenum; uint8 page_sn; uint8 data_cnt; } scaninfo; typedef void (* scan_done_cb_t)(void *arg, STATUS status); struct station_config { uint8 ssid[32]; uint8 password[64]; uint8 bssid_set; // Note: If bssid_set is 1, station will just connect to the router // with both ssid[] and bssid[] matched. Please check about this. uint8 bssid[6]; }; bool wifi_station_get_config(struct station_config *config); bool wifi_station_get_config_default(struct station_config *config); bool wifi_station_set_config(struct station_config *config); bool wifi_station_set_config_current(struct station_config *config); bool wifi_station_connect(void); bool wifi_station_disconnect(void); sint8 wifi_station_get_rssi(void); struct scan_config { uint8 *ssid; // Note: ssid == NULL, don't filter ssid. uint8 *bssid; // Note: bssid == NULL, don't filter bssid. uint8 channel; // Note: channel == 0, scan all channels, otherwise scan set channel. uint8 show_hidden; // Note: show_hidden == 1, can get hidden ssid routers' info. }; bool wifi_station_scan(struct scan_config *config, scan_done_cb_t cb); uint8 wifi_station_get_auto_connect(void); bool wifi_station_set_auto_connect(uint8 set); bool wifi_station_set_reconnect_policy(bool set); enum { STATION_IDLE = 0, STATION_CONNECTING, STATION_WRONG_PASSWORD, STATION_NO_AP_FOUND, STATION_CONNECT_FAIL, STATION_GOT_IP }; enum dhcp_status { DHCP_STOPPED, DHCP_STARTED }; uint8 wifi_station_get_connect_status(void); uint8 wifi_station_get_current_ap_id(void); bool wifi_station_ap_change(uint8 current_ap_id); bool wifi_station_ap_number_set(uint8 ap_number); uint8 wifi_station_get_ap_info(struct station_config config[]); bool wifi_station_dhcpc_start(void); bool wifi_station_dhcpc_stop(void); enum dhcp_status wifi_station_dhcpc_status(void); bool wifi_station_dhcpc_set_maxtry(uint8 num); char* wifi_station_get_hostname(void); bool wifi_station_set_hostname(char *name); struct softap_config { uint8 ssid[32]; uint8 password[64]; uint8 ssid_len; // Note: Recommend to set it according to your ssid uint8 channel; // Note: support 1 ~ 13 AUTH_MODE authmode; // Note: Don't support AUTH_WEP in softAP mode. uint8 ssid_hidden; // Note: default 0 uint8 max_connection; // Note: default 4, max 4 uint16 beacon_interval; // Note: support 100 ~ 60000 ms, default 100 }; bool wifi_softap_get_config(struct softap_config *config); bool wifi_softap_get_config_default(struct softap_config *config); bool wifi_softap_set_config(struct softap_config *config); bool wifi_softap_set_config_current(struct softap_config *config); struct station_info { STAILQ_ENTRY(station_info) next; uint8 bssid[6]; struct ip_addr ip; }; struct dhcps_lease { bool enable; struct ip_addr start_ip; struct ip_addr end_ip; }; enum dhcps_offer_option{ OFFER_START = 0x00, OFFER_ROUTER = 0x01, OFFER_END }; uint8 wifi_softap_get_station_num(void); struct station_info * wifi_softap_get_station_info(void); void wifi_softap_free_station_info(void); bool wifi_softap_dhcps_start(void); bool wifi_softap_dhcps_stop(void); bool wifi_softap_set_dhcps_lease(struct dhcps_lease *please); bool wifi_softap_get_dhcps_lease(struct dhcps_lease *please); uint32 wifi_softap_get_dhcps_lease_time(void); bool wifi_softap_set_dhcps_lease_time(uint32 minute); bool wifi_softap_reset_dhcps_lease_time(void); enum dhcp_status wifi_softap_dhcps_status(void); bool wifi_softap_set_dhcps_offer_option(uint8 level, void* optarg); #define STATION_IF 0x00 #define SOFTAP_IF 0x01 bool wifi_get_ip_info(uint8 if_index, struct ip_info *info); bool wifi_set_ip_info(uint8 if_index, struct ip_info *info); bool wifi_get_macaddr(uint8 if_index, uint8 *macaddr); bool wifi_set_macaddr(uint8 if_index, uint8 *macaddr); uint8 wifi_get_channel(void); bool wifi_set_channel(uint8 channel); void wifi_status_led_install(uint8 gpio_id, uint32 gpio_name, uint8 gpio_func); void wifi_status_led_uninstall(); /** Get the absolute difference between 2 u32_t values (correcting overflows) * 'a' is expected to be 'higher' (without overflow) than 'b'. */ #define ESP_U32_DIFF(a, b) (((a) >= (b)) ? ((a) - (b)) : (((a) + ((b) ^ 0xFFFFFFFF) + 1))) void wifi_promiscuous_enable(uint8 promiscuous); typedef void (* wifi_promiscuous_cb_t)(uint8 *buf, uint16 len); void wifi_set_promiscuous_rx_cb(wifi_promiscuous_cb_t cb); void wifi_promiscuous_set_mac(const uint8_t *address); enum phy_mode { PHY_MODE_11B = 1, PHY_MODE_11G = 2, PHY_MODE_11N = 3 }; enum phy_mode wifi_get_phy_mode(void); bool wifi_set_phy_mode(enum phy_mode mode); enum sleep_type { NONE_SLEEP_T = 0, LIGHT_SLEEP_T, MODEM_SLEEP_T }; bool wifi_set_sleep_type(enum sleep_type type); enum sleep_type wifi_get_sleep_type(void); void wifi_fpm_open(void); void wifi_fpm_close(void); void wifi_fpm_do_wakeup(void); sint8 wifi_fpm_do_sleep(uint32 sleep_time_in_us); void wifi_fpm_set_sleep_type(enum sleep_type type); enum sleep_type wifi_fpm_get_sleep_type(void); enum { EVENT_STAMODE_CONNECTED = 0, EVENT_STAMODE_DISCONNECTED, EVENT_STAMODE_AUTHMODE_CHANGE, EVENT_STAMODE_GOT_IP, EVENT_STAMODE_DHCP_TIMEOUT, EVENT_SOFTAPMODE_STACONNECTED, EVENT_SOFTAPMODE_STADISCONNECTED, EVENT_SOFTAPMODE_PROBEREQRECVED, EVENT_MAX }; enum { REASON_UNSPECIFIED = 1, REASON_AUTH_EXPIRE = 2, REASON_AUTH_LEAVE = 3, REASON_ASSOC_EXPIRE = 4, REASON_ASSOC_TOOMANY = 5, REASON_NOT_AUTHED = 6, REASON_NOT_ASSOCED = 7, REASON_ASSOC_LEAVE = 8, REASON_ASSOC_NOT_AUTHED = 9, REASON_DISASSOC_PWRCAP_BAD = 10, /* 11h */ REASON_DISASSOC_SUPCHAN_BAD = 11, /* 11h */ REASON_IE_INVALID = 13, /* 11i */ REASON_MIC_FAILURE = 14, /* 11i */ REASON_4WAY_HANDSHAKE_TIMEOUT = 15, /* 11i */ REASON_GROUP_KEY_UPDATE_TIMEOUT = 16, /* 11i */ REASON_IE_IN_4WAY_DIFFERS = 17, /* 11i */ REASON_GROUP_CIPHER_INVALID = 18, /* 11i */ REASON_PAIRWISE_CIPHER_INVALID = 19, /* 11i */ REASON_AKMP_INVALID = 20, /* 11i */ REASON_UNSUPP_RSN_IE_VERSION = 21, /* 11i */ REASON_INVALID_RSN_IE_CAP = 22, /* 11i */ REASON_802_1X_AUTH_FAILED = 23, /* 11i */ REASON_CIPHER_SUITE_REJECTED = 24, /* 11i */ REASON_BEACON_TIMEOUT = 200, REASON_NO_AP_FOUND = 201, REASON_AUTH_FAIL = 202, REASON_ASSOC_FAIL = 203, REASON_HANDSHAKE_TIMEOUT = 204, }; typedef struct { uint8 ssid[32]; uint8 ssid_len; uint8 bssid[6]; uint8 channel; } Event_StaMode_Connected_t; typedef struct { uint8 ssid[32]; uint8 ssid_len; uint8 bssid[6]; uint8 reason; } Event_StaMode_Disconnected_t; typedef struct { uint8 old_mode; uint8 new_mode; } Event_StaMode_AuthMode_Change_t; typedef struct { struct ip_addr ip; struct ip_addr mask; struct ip_addr gw; } Event_StaMode_Got_IP_t; typedef struct { uint8 mac[6]; uint8 aid; } Event_SoftAPMode_StaConnected_t; typedef struct { uint8 mac[6]; uint8 aid; } Event_SoftAPMode_StaDisconnected_t; typedef struct { int rssi; uint8 mac[6]; } Event_SoftAPMode_ProbeReqRecved_t; typedef union { Event_StaMode_Connected_t connected; Event_StaMode_Disconnected_t disconnected; Event_StaMode_AuthMode_Change_t auth_change; Event_StaMode_Got_IP_t got_ip; Event_SoftAPMode_StaConnected_t sta_connected; Event_SoftAPMode_StaDisconnected_t sta_disconnected; Event_SoftAPMode_ProbeReqRecved_t ap_probereqrecved; } Event_Info_u; typedef struct _esp_event { uint32 event; Event_Info_u event_info; } System_Event_t; typedef void (* wifi_event_handler_cb_t)(System_Event_t *event); void wifi_set_event_handler_cb(wifi_event_handler_cb_t cb); 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_CB_ST_FAILED, WPS_CB_ST_TIMEOUT, WPS_CB_ST_WEP, }; bool wifi_wps_enable(WPS_TYPE_t wps_type); bool wifi_wps_disable(void); bool wifi_wps_start(void); typedef void (*wps_st_cb_t)(int status); bool wifi_set_wps_cb(wps_st_cb_t cb); typedef void (*freedom_outside_cb_t)(uint8 status); int wifi_register_send_pkt_freedom_cb(freedom_outside_cb_t cb); void wifi_unregister_send_pkt_freedom_cb(void); int wifi_send_pkt_freedom(uint8 *buf, int len, bool sys_seq); int wifi_rfid_locp_recv_open(void); void wifi_rfid_locp_recv_close(void); typedef void (*rfid_locp_cb_t)(uint8 *frm, int len, int rssi); int wifi_register_rfid_locp_recv_cb(rfid_locp_cb_t cb); void wifi_unregister_rfid_locp_recv_cb(void); enum FIXED_RATE { PHY_RATE_48 = 0x8, PHY_RATE_24 = 0x9, PHY_RATE_12 = 0xA, PHY_RATE_6 = 0xB, PHY_RATE_54 = 0xC, PHY_RATE_36 = 0xD, PHY_RATE_18 = 0xE, PHY_RATE_9 = 0xF, }; #define FIXED_RATE_MASK_NONE 0x00 #define FIXED_RATE_MASK_STA 0x01 #define FIXED_RATE_MASK_AP 0x02 #define FIXED_RATE_MASK_ALL 0x03 int wifi_set_user_fixed_rate(uint8 enable_mask, uint8 rate); int wifi_get_user_fixed_rate(uint8 *enable_mask, uint8 *rate); enum support_rate { RATE_11B5M = 0, RATE_11B11M = 1, RATE_11B1M = 2, RATE_11B2M = 3, RATE_11G6M = 4, RATE_11G12M = 5, RATE_11G24M = 6, RATE_11G48M = 7, RATE_11G54M = 8, RATE_11G9M = 9, RATE_11G18M = 10, RATE_11G36M = 11, }; int wifi_set_user_sup_rate(uint8 min, uint8 max); enum RATE_11B_ID { RATE_11B_B11M = 0, RATE_11B_B5M = 1, RATE_11B_B2M = 2, RATE_11B_B1M = 3, }; enum RATE_11G_ID { RATE_11G_G54M = 0, RATE_11G_G48M = 1, RATE_11G_G36M = 2, RATE_11G_G24M = 3, RATE_11G_G18M = 4, RATE_11G_G12M = 5, RATE_11G_G9M = 6, RATE_11G_G6M = 7, RATE_11G_B5M = 8, RATE_11G_B2M = 9, RATE_11G_B1M = 10 }; enum RATE_11N_ID { RATE_11N_MCS7S = 0, RATE_11N_MCS7 = 1, RATE_11N_MCS6 = 2, RATE_11N_MCS5 = 3, RATE_11N_MCS4 = 4, RATE_11N_MCS3 = 5, RATE_11N_MCS2 = 6, RATE_11N_MCS1 = 7, RATE_11N_MCS0 = 8, RATE_11N_B5M = 9, RATE_11N_B2M = 10, RATE_11N_B1M = 11 }; #define RC_LIMIT_11B 0 #define RC_LIMIT_11G 1 #define RC_LIMIT_11N 2 #define RC_LIMIT_P2P_11G 3 #define RC_LIMIT_P2P_11N 4 #define RC_LIMIT_NUM 5 #define LIMIT_RATE_MASK_NONE 0x00 #define LIMIT_RATE_MASK_STA 0x01 #define LIMIT_RATE_MASK_AP 0x02 #define LIMIT_RATE_MASK_ALL 0x03 bool wifi_set_user_rate_limit(uint8 mode, uint8 ifidx, uint8 max, uint8 min); uint8 wifi_get_user_limit_rate_mask(void); bool wifi_set_user_limit_rate_mask(uint8 enable_mask); enum { USER_IE_BEACON = 0, USER_IE_PROBE_REQ, USER_IE_PROBE_RESP, USER_IE_ASSOC_REQ, USER_IE_ASSOC_RESP, USER_IE_MAX }; typedef void (*user_ie_manufacturer_recv_cb_t)(uint8 type, const uint8 sa[6], const uint8 m_oui[3], uint8 *ie, uint8 ie_len, int rssi); bool wifi_set_user_ie(bool enable, uint8 *m_oui, uint8 type, uint8 *user_ie, uint8 len); int wifi_register_user_ie_manufacturer_recv_cb(user_ie_manufacturer_recv_cb_t cb); void wifi_unregister_user_ie_manufacturer_recv_cb(void); #endif ================================================ FILE: ld/eagle.app.v6.ld ================================================ /* This linker script generated from xt-genldscripts.tpp for LSP . */ /* Linker Script for ld -N */ MEMORY { dport0_0_seg : org = 0x3FF00000, len = 0x10 dram0_0_seg : org = 0x3FFE8000, len = 0x14000 iram1_0_seg : org = 0x40100000, len = 0x8000 irom0_0_seg : org = 0x40210000, len = 0x51000 } PHDRS { dport0_0_phdr PT_LOAD; dram0_0_phdr PT_LOAD; dram0_0_bss_phdr PT_LOAD; iram1_0_phdr PT_LOAD; irom0_0_phdr PT_LOAD; } /* Default entry point: */ ENTRY(call_user_start) EXTERN(_DebugExceptionVector) EXTERN(_DoubleExceptionVector) EXTERN(_KernelExceptionVector) EXTERN(_NMIExceptionVector) EXTERN(_UserExceptionVector) PROVIDE(_memmap_vecbase_reset = 0x40000000); /* Various memory-map dependent cache attribute settings: */ _memmap_cacheattr_wb_base = 0x00000110; _memmap_cacheattr_wt_base = 0x00000110; _memmap_cacheattr_bp_base = 0x00000220; _memmap_cacheattr_unused_mask = 0xFFFFF00F; _memmap_cacheattr_wb_trapnull = 0x2222211F; _memmap_cacheattr_wba_trapnull = 0x2222211F; _memmap_cacheattr_wbna_trapnull = 0x2222211F; _memmap_cacheattr_wt_trapnull = 0x2222211F; _memmap_cacheattr_bp_trapnull = 0x2222222F; _memmap_cacheattr_wb_strict = 0xFFFFF11F; _memmap_cacheattr_wt_strict = 0xFFFFF11F; _memmap_cacheattr_bp_strict = 0xFFFFF22F; _memmap_cacheattr_wb_allvalid = 0x22222112; _memmap_cacheattr_wt_allvalid = 0x22222112; _memmap_cacheattr_bp_allvalid = 0x22222222; PROVIDE(_memmap_cacheattr_reset = _memmap_cacheattr_wb_trapnull); SECTIONS { .dport0.rodata : ALIGN(4) { _dport0_rodata_start = ABSOLUTE(.); *(.dport0.rodata) *(.dport.rodata) _dport0_rodata_end = ABSOLUTE(.); } >dport0_0_seg :dport0_0_phdr .dport0.literal : ALIGN(4) { _dport0_literal_start = ABSOLUTE(.); *(.dport0.literal) *(.dport.literal) _dport0_literal_end = ABSOLUTE(.); } >dport0_0_seg :dport0_0_phdr .dport0.data : ALIGN(4) { _dport0_data_start = ABSOLUTE(.); *(.dport0.data) *(.dport.data) _dport0_data_end = ABSOLUTE(.); } >dport0_0_seg :dport0_0_phdr .lit4 : ALIGN(4) { _lit4_start = ABSOLUTE(.); *(*.lit4) *(.lit4.*) *(.gnu.linkonce.lit4.*) _lit4_end = ABSOLUTE(.); } >iram1_0_seg :iram1_0_phdr .irom0.text : ALIGN(4) { _irom0_text_start = ABSOLUTE(.); *(.irom0.literal .irom.literal .irom.text.literal .irom0.text .irom.text) *(.literal.* .text.*) *(.rodata2.text) _irom0_text_end = ABSOLUTE(.); _flash_used_end = ABSOLUTE(.); } >irom0_0_seg :irom0_0_phdr .text : ALIGN(4) { _stext = .; _text_start = ABSOLUTE(.); *(.UserEnter.text) . = ALIGN(16); *(.DebugExceptionVector.text) . = ALIGN(16); *(.NMIExceptionVector.text) . = ALIGN(16); *(.KernelExceptionVector.text) LONG(0) LONG(0) LONG(0) LONG(0) . = ALIGN(16); *(.UserExceptionVector.text) LONG(0) LONG(0) LONG(0) LONG(0) . = ALIGN(16); *(.DoubleExceptionVector.text) LONG(0) LONG(0) LONG(0) LONG(0) . = ALIGN (16); *(.entry.text) *(.init.literal) *(.init) *(.literal .text .iram0.text .stub .gnu.warning .gnu.linkonce.literal.* .gnu.linkonce.t.*.literal .gnu.linkonce.t.*) *(.fini.literal) *(.fini) *(.gnu.version) _text_end = ABSOLUTE(.); _etext = .; } >iram1_0_seg :iram1_0_phdr .lit4 : ALIGN(4) { _lit4_start = ABSOLUTE(.); *(*.lit4) *(.lit4.*) *(.gnu.linkonce.lit4.*) _lit4_end = ABSOLUTE(.); } >iram1_0_seg :iram1_0_phdr .data : ALIGN(4) { _data_start = ABSOLUTE(.); *(.data) *(.data.*) *(.gnu.linkonce.d.*) *(.data1) *(.sdata) *(.sdata.*) *(.gnu.linkonce.s.*) *(.sdata2) *(.sdata2.*) *(.gnu.linkonce.s2.*) *(.jcr) _data_end = ABSOLUTE(.); } >dram0_0_seg :dram0_0_phdr .rodata : ALIGN(4) { _rodata_start = ABSOLUTE(.); *(.sdk.version) *(.rodata) *(.rodata.*) *(.gnu.linkonce.r.*) *(.rodata1) __XT_EXCEPTION_TABLE__ = ABSOLUTE(.); *(.xt_except_table) *(.gcc_except_table) *(.gnu.linkonce.e.*) *(.gnu.version_r) *(.eh_frame) /* C++ constructor and destructor tables, properly ordered: */ KEEP (*crtbegin.o(.ctors)) KEEP (*(EXCLUDE_FILE (*crtend.o) .ctors)) KEEP (*(SORT(.ctors.*))) KEEP (*(.ctors)) 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) . = ALIGN(4); /* this table MUST be 4-byte aligned */ _bss_table_start = ABSOLUTE(.); LONG(_bss_start) LONG(_bss_end) _bss_table_end = ABSOLUTE(.); _rodata_end = ABSOLUTE(.); } >dram0_0_seg :dram0_0_phdr .bss ALIGN(8) (NOLOAD) : ALIGN(4) { . = ALIGN (8); _bss_start = ABSOLUTE(.); *(.dynsbss) *(.sbss) *(.sbss.*) *(.gnu.linkonce.sb.*) *(.scommon) *(.sbss2) *(.sbss2.*) *(.gnu.linkonce.sb2.*) *(.dynbss) *(.bss) *(.bss.*) *(.gnu.linkonce.b.*) *(COMMON) . = ALIGN (8); _bss_end = ABSOLUTE(.); _heap_start = ABSOLUTE(.); /* _stack_sentry = ALIGN(0x8); */ } >dram0_0_seg :dram0_0_bss_phdr /* __stack = 0x3ffc8000; */ } /* get ROM code address */ INCLUDE "../ld/eagle.rom.addr.v6.ld" ================================================ FILE: ld/eagle.rom.addr.v6.ld ================================================ PROVIDE ( Cache_Read_Disable = 0x400047f0 ); PROVIDE ( Cache_Read_Enable = 0x40004678 ); PROVIDE ( FilePacketSendReqMsgProc = 0x400035a0 ); PROVIDE ( FlashDwnLdParamCfgMsgProc = 0x4000368c ); PROVIDE ( FlashDwnLdStartMsgProc = 0x40003538 ); PROVIDE ( FlashDwnLdStopReqMsgProc = 0x40003658 ); PROVIDE ( GetUartDevice = 0x40003f4c ); PROVIDE ( MD5Final = 0x40009900 ); PROVIDE ( MD5Init = 0x40009818 ); PROVIDE ( MD5Update = 0x40009834 ); PROVIDE ( MemDwnLdStartMsgProc = 0x400036c4 ); PROVIDE ( MemDwnLdStopReqMsgProc = 0x4000377c ); PROVIDE ( MemPacketSendReqMsgProc = 0x400036f0 ); PROVIDE ( RcvMsg = 0x40003eac ); PROVIDE ( SHA1Final = 0x4000b648 ); PROVIDE ( SHA1Init = 0x4000b584 ); PROVIDE ( SHA1Transform = 0x4000a364 ); PROVIDE ( SHA1Update = 0x4000b5a8 ); PROVIDE ( SPI_read_status = 0x400043c8 ); PROVIDE ( SPI_write_status = 0x40004400 ); PROVIDE ( SPI_write_enable = 0x4000443c ); PROVIDE ( Wait_SPI_Idle = 0x4000448c ); PROVIDE ( SPIEraseArea = 0x40004b44 ); PROVIDE ( SPIEraseBlock = 0x400049b4 ); PROVIDE ( SPIEraseChip = 0x40004984 ); PROVIDE ( SPIEraseSector = 0x40004a00 ); PROVIDE ( SPILock = 0x400048a8 ); PROVIDE ( SPIParamCfg = 0x40004c2c ); PROVIDE ( SPIRead = 0x40004b1c ); PROVIDE ( SPIReadModeCnfig = 0x400048ec ); PROVIDE ( SPIUnlock = 0x40004878 ); PROVIDE ( SPIWrite = 0x40004a4c ); PROVIDE ( SelectSpiFunction = 0x40003f58 ); PROVIDE ( SendMsg = 0x40003cf4 ); PROVIDE ( UartConnCheck = 0x40003230 ); PROVIDE ( UartConnectProc = 0x400037a0 ); PROVIDE ( UartDwnLdProc = 0x40003368 ); PROVIDE ( UartGetCmdLn = 0x40003ef4 ); PROVIDE ( UartRegReadProc = 0x4000381c ); PROVIDE ( UartRegWriteProc = 0x400037ac ); PROVIDE ( UartRxString = 0x40003c30 ); PROVIDE ( Uart_Init = 0x40003a14 ); PROVIDE ( _DebugExceptionVector = 0x40000010 ); PROVIDE ( _DoubleExceptionVector = 0x40000070 ); PROVIDE ( _KernelExceptionVector = 0x40000030 ); PROVIDE ( _NMIExceptionVector = 0x40000020 ); PROVIDE ( _ResetHandler = 0x400000a4 ); PROVIDE ( _ResetVector = 0x40000080 ); PROVIDE ( _UserExceptionVector = 0x40000050 ); PROVIDE ( __adddf3 = 0x4000c538 ); PROVIDE ( __addsf3 = 0x4000c180 ); PROVIDE ( __divdf3 = 0x4000cb94 ); PROVIDE ( __divdi3 = 0x4000ce60 ); PROVIDE ( __divsi3 = 0x4000dc88 ); PROVIDE ( __extendsfdf2 = 0x4000cdfc ); PROVIDE ( __fixdfsi = 0x4000ccb8 ); PROVIDE ( __fixunsdfsi = 0x4000cd00 ); PROVIDE ( __fixunssfsi = 0x4000c4c4 ); PROVIDE ( __floatsidf = 0x4000e2f0 ); PROVIDE ( __floatsisf = 0x4000e2ac ); PROVIDE ( __floatunsidf = 0x4000e2e8 ); PROVIDE ( __floatunsisf = 0x4000e2a4 ); PROVIDE ( __muldf3 = 0x4000c8f0 ); PROVIDE ( __muldi3 = 0x40000650 ); PROVIDE ( __mulsf3 = 0x4000c3dc ); PROVIDE ( __subdf3 = 0x4000c688 ); PROVIDE ( __subsf3 = 0x4000c268 ); PROVIDE ( __truncdfsf2 = 0x4000cd5c ); PROVIDE ( __udivdi3 = 0x4000d310 ); PROVIDE ( __udivsi3 = 0x4000e21c ); PROVIDE ( __umoddi3 = 0x4000d770 ); PROVIDE ( __umodsi3 = 0x4000e268 ); PROVIDE ( __umulsidi3 = 0x4000dcf0 ); PROVIDE ( _rom_store = 0x4000e388 ); PROVIDE ( _rom_store_table = 0x4000e328 ); PROVIDE ( _start = 0x4000042c ); PROVIDE ( _xtos_alloca_handler = 0x4000dbe0 ); PROVIDE ( _xtos_c_wrapper_handler = 0x40000598 ); PROVIDE ( _xtos_cause3_handler = 0x40000590 ); PROVIDE ( _xtos_ints_off = 0x4000bda4 ); PROVIDE ( _xtos_ints_on = 0x4000bd84 ); PROVIDE ( _xtos_l1int_handler = 0x4000048c ); PROVIDE ( _xtos_p_none = 0x4000dbf8 ); PROVIDE ( _xtos_restore_intlevel = 0x4000056c ); PROVIDE ( _xtos_return_from_exc = 0x4000dc54 ); PROVIDE ( _xtos_set_exception_handler = 0x40000454 ); PROVIDE ( _xtos_set_interrupt_handler = 0x4000bd70 ); PROVIDE ( _xtos_set_interrupt_handler_arg = 0x4000bd28 ); PROVIDE ( _xtos_set_intlevel = 0x4000dbfc ); PROVIDE ( _xtos_set_min_intlevel = 0x4000dc18 ); PROVIDE ( _xtos_set_vpri = 0x40000574 ); PROVIDE ( _xtos_syscall_handler = 0x4000dbe4 ); PROVIDE ( _xtos_unhandled_exception = 0x4000dc44 ); PROVIDE ( _xtos_unhandled_interrupt = 0x4000dc3c ); PROVIDE ( aes_decrypt = 0x400092d4 ); PROVIDE ( aes_decrypt_deinit = 0x400092e4 ); PROVIDE ( aes_decrypt_init = 0x40008ea4 ); PROVIDE ( aes_unwrap = 0x40009410 ); PROVIDE ( base64_decode = 0x40009648 ); PROVIDE ( base64_encode = 0x400094fc ); PROVIDE ( bzero = 0x4000de84 ); PROVIDE ( cmd_parse = 0x40000814 ); PROVIDE ( conv_str_decimal = 0x40000b24 ); PROVIDE ( conv_str_hex = 0x40000cb8 ); PROVIDE ( convert_para_str = 0x40000a60 ); PROVIDE ( dtm_get_intr_mask = 0x400026d0 ); PROVIDE ( dtm_params_init = 0x4000269c ); PROVIDE ( dtm_set_intr_mask = 0x400026c8 ); PROVIDE ( dtm_set_params = 0x400026dc ); PROVIDE ( eprintf = 0x40001d14 ); PROVIDE ( eprintf_init_buf = 0x40001cb8 ); PROVIDE ( eprintf_to_host = 0x40001d48 ); PROVIDE ( est_get_printf_buf_remain_len = 0x40002494 ); PROVIDE ( est_reset_printf_buf_len = 0x4000249c ); PROVIDE ( ets_bzero = 0x40002ae8 ); PROVIDE ( ets_char2xdigit = 0x40002b74 ); PROVIDE ( ets_delay_us = 0x40002ecc ); PROVIDE ( ets_enter_sleep = 0x400027b8 ); PROVIDE ( ets_external_printf = 0x40002578 ); PROVIDE ( ets_get_cpu_frequency = 0x40002f0c ); PROVIDE ( ets_getc = 0x40002bcc ); PROVIDE ( ets_install_external_printf = 0x40002450 ); PROVIDE ( ets_install_putc1 = 0x4000242c ); PROVIDE ( ets_install_putc2 = 0x4000248c ); PROVIDE ( ets_install_uart_printf = 0x40002438 ); PROVIDE ( ets_intr_lock = 0x40000f74 ); PROVIDE ( ets_intr_unlock = 0x40000f80 ); PROVIDE ( ets_isr_attach = 0x40000f88 ); PROVIDE ( ets_isr_mask = 0x40000f98 ); PROVIDE ( ets_isr_unmask = 0x40000fa8 ); PROVIDE ( ets_memcmp = 0x400018d4 ); PROVIDE ( ets_memcpy = 0x400018b4 ); PROVIDE ( ets_memmove = 0x400018c4 ); PROVIDE ( ets_memset = 0x400018a4 ); PROVIDE ( ets_post = 0x40000e24 ); PROVIDE ( ets_printf = 0x400024cc ); PROVIDE ( ets_putc = 0x40002be8 ); PROVIDE ( ets_rtc_int_register = 0x40002a40 ); PROVIDE ( ets_run = 0x40000e04 ); PROVIDE ( ets_set_idle_cb = 0x40000dc0 ); PROVIDE ( ets_set_user_start = 0x40000fbc ); PROVIDE ( ets_str2macaddr = 0x40002af8 ); PROVIDE ( ets_strcmp = 0x40002aa8 ); PROVIDE ( ets_strcpy = 0x40002a88 ); PROVIDE ( ets_strlen = 0x40002ac8 ); PROVIDE ( ets_strncmp = 0x40002ab8 ); PROVIDE ( ets_strncpy = 0x40002a98 ); PROVIDE ( ets_strstr = 0x40002ad8 ); PROVIDE ( ets_task = 0x40000dd0 ); PROVIDE ( ets_timer_arm = 0x40002cc4 ); PROVIDE ( ets_timer_disarm = 0x40002d40 ); PROVIDE ( ets_timer_done = 0x40002d80 ); PROVIDE ( ets_timer_handler_isr = 0x40002da8 ); PROVIDE ( ets_timer_init = 0x40002e68 ); PROVIDE ( ets_timer_setfn = 0x40002c48 ); PROVIDE ( ets_uart_printf = 0x40002544 ); PROVIDE ( ets_update_cpu_frequency = 0x40002f04 ); PROVIDE ( ets_vprintf = 0x40001f00 ); PROVIDE ( ets_wdt_disable = 0x400030f0 ); PROVIDE ( ets_wdt_enable = 0x40002fa0 ); PROVIDE ( ets_wdt_get_mode = 0x40002f34 ); PROVIDE ( ets_wdt_init = 0x40003170 ); PROVIDE ( ets_wdt_restore = 0x40003158 ); PROVIDE ( ets_write_char = 0x40001da0 ); PROVIDE ( get_first_seg = 0x4000091c ); PROVIDE ( gpio_init = 0x40004c50 ); PROVIDE ( gpio_input_get = 0x40004cf0 ); PROVIDE ( gpio_intr_ack = 0x40004dcc ); PROVIDE ( gpio_intr_handler_register = 0x40004e28 ); PROVIDE ( gpio_intr_pending = 0x40004d88 ); PROVIDE ( gpio_intr_test = 0x40004efc ); PROVIDE ( gpio_output_set = 0x40004cd0 ); PROVIDE ( gpio_pin_intr_state_set = 0x40004d90 ); PROVIDE ( gpio_pin_wakeup_disable = 0x40004ed4 ); PROVIDE ( gpio_pin_wakeup_enable = 0x40004e90 ); PROVIDE ( gpio_register_get = 0x40004d5c ); PROVIDE ( gpio_register_set = 0x40004d04 ); PROVIDE ( hmac_md5 = 0x4000a2cc ); PROVIDE ( hmac_md5_vector = 0x4000a160 ); PROVIDE ( hmac_sha1 = 0x4000ba28 ); PROVIDE ( hmac_sha1_vector = 0x4000b8b4 ); PROVIDE ( lldesc_build_chain = 0x40004f40 ); PROVIDE ( lldesc_num2link = 0x40005050 ); PROVIDE ( lldesc_set_owner = 0x4000507c ); PROVIDE ( main = 0x40000fec ); PROVIDE ( md5_vector = 0x400097ac ); PROVIDE ( mem_calloc = 0x40001c2c ); PROVIDE ( mem_free = 0x400019e0 ); PROVIDE ( mem_init = 0x40001998 ); PROVIDE ( mem_malloc = 0x40001b40 ); PROVIDE ( mem_realloc = 0x40001c6c ); PROVIDE ( mem_trim = 0x40001a14 ); PROVIDE ( mem_zalloc = 0x40001c58 ); PROVIDE ( memcmp = 0x4000dea8 ); PROVIDE ( memcpy = 0x4000df48 ); PROVIDE ( memmove = 0x4000e04c ); PROVIDE ( memset = 0x4000e190 ); PROVIDE ( multofup = 0x400031c0 ); PROVIDE ( pbkdf2_sha1 = 0x4000b840 ); PROVIDE ( phy_get_romfuncs = 0x40006b08 ); PROVIDE ( rand = 0x40000600 ); PROVIDE ( rc4_skip = 0x4000dd68 ); PROVIDE ( recv_packet = 0x40003d08 ); PROVIDE ( remove_head_space = 0x40000a04 ); PROVIDE ( rijndaelKeySetupDec = 0x40008dd0 ); PROVIDE ( rijndaelKeySetupEnc = 0x40009300 ); PROVIDE ( rom_abs_temp = 0x400060c0 ); PROVIDE ( rom_ana_inf_gating_en = 0x40006b10 ); PROVIDE ( rom_cal_tos_v50 = 0x40007a28 ); PROVIDE ( rom_chip_50_set_channel = 0x40006f84 ); PROVIDE ( rom_chip_v5_disable_cca = 0x400060d0 ); PROVIDE ( rom_chip_v5_enable_cca = 0x400060ec ); PROVIDE ( rom_chip_v5_rx_init = 0x4000711c ); PROVIDE ( rom_chip_v5_sense_backoff = 0x4000610c ); PROVIDE ( rom_chip_v5_tx_init = 0x4000718c ); PROVIDE ( rom_dc_iq_est = 0x4000615c ); PROVIDE ( rom_en_pwdet = 0x400061b8 ); PROVIDE ( rom_get_bb_atten = 0x40006238 ); PROVIDE ( rom_get_corr_power = 0x40006260 ); PROVIDE ( rom_get_fm_sar_dout = 0x400062dc ); PROVIDE ( rom_get_noisefloor = 0x40006394 ); PROVIDE ( rom_get_power_db = 0x400063b0 ); PROVIDE ( rom_i2c_readReg = 0x40007268 ); PROVIDE ( rom_i2c_readReg_Mask = 0x4000729c ); PROVIDE ( rom_i2c_writeReg = 0x400072d8 ); PROVIDE ( rom_i2c_writeReg_Mask = 0x4000730c ); PROVIDE ( rom_iq_est_disable = 0x40006400 ); PROVIDE ( rom_iq_est_enable = 0x40006430 ); PROVIDE ( rom_linear_to_db = 0x40006484 ); PROVIDE ( rom_mhz2ieee = 0x400065a4 ); PROVIDE ( rom_pbus_dco___SA2 = 0x40007bf0 ); PROVIDE ( rom_pbus_debugmode = 0x4000737c ); PROVIDE ( rom_pbus_enter_debugmode = 0x40007410 ); PROVIDE ( rom_pbus_exit_debugmode = 0x40007448 ); PROVIDE ( rom_pbus_force_test = 0x4000747c ); PROVIDE ( rom_pbus_rd = 0x400074d8 ); PROVIDE ( rom_pbus_set_rxgain = 0x4000754c ); PROVIDE ( rom_pbus_set_txgain = 0x40007610 ); PROVIDE ( rom_pbus_workmode = 0x40007648 ); PROVIDE ( rom_pbus_xpd_rx_off = 0x40007688 ); PROVIDE ( rom_pbus_xpd_rx_on = 0x400076cc ); PROVIDE ( rom_pbus_xpd_tx_off = 0x400076fc ); PROVIDE ( rom_pbus_xpd_tx_on = 0x40007740 ); PROVIDE ( rom_pbus_xpd_tx_on__low_gain = 0x400077a0 ); PROVIDE ( rom_phy_reset_req = 0x40007804 ); PROVIDE ( rom_restart_cal = 0x4000781c ); PROVIDE ( rom_rfcal_pwrctrl = 0x40007eb4 ); PROVIDE ( rom_rfcal_rxiq = 0x4000804c ); PROVIDE ( rom_rfcal_rxiq_set_reg = 0x40008264 ); PROVIDE ( rom_rfcal_txcap = 0x40008388 ); PROVIDE ( rom_rfcal_txiq = 0x40008610 ); PROVIDE ( rom_rfcal_txiq_cover = 0x400088b8 ); PROVIDE ( rom_rfcal_txiq_set_reg = 0x40008a70 ); PROVIDE ( rom_rfpll_reset = 0x40007868 ); PROVIDE ( rom_rfpll_set_freq = 0x40007968 ); PROVIDE ( rom_rxiq_cover_mg_mp = 0x40008b6c ); PROVIDE ( rom_rxiq_get_mis = 0x40006628 ); PROVIDE ( rom_sar_init = 0x40006738 ); PROVIDE ( rom_set_ana_inf_tx_scale = 0x4000678c ); PROVIDE ( rom_set_channel_freq = 0x40006c50 ); PROVIDE ( rom_set_loopback_gain = 0x400067c8 ); PROVIDE ( rom_set_noise_floor = 0x40006830 ); PROVIDE ( rom_set_rxclk_en = 0x40006550 ); PROVIDE ( rom_set_txbb_atten = 0x40008c6c ); PROVIDE ( rom_set_txclk_en = 0x4000650c ); PROVIDE ( rom_set_txiq_cal = 0x40008d34 ); PROVIDE ( rom_start_noisefloor = 0x40006874 ); PROVIDE ( rom_start_tx_tone = 0x400068b4 ); PROVIDE ( rom_stop_tx_tone = 0x4000698c ); PROVIDE ( rom_tx_mac_disable = 0x40006a98 ); PROVIDE ( rom_tx_mac_enable = 0x40006ad4 ); PROVIDE ( rom_txtone_linear_pwr = 0x40006a1c ); PROVIDE ( rom_write_rfpll_sdm = 0x400078dc ); PROVIDE ( roundup2 = 0x400031b4 ); PROVIDE ( rtc_enter_sleep = 0x40002870 ); PROVIDE ( rtc_get_reset_reason = 0x400025e0 ); PROVIDE ( rtc_intr_handler = 0x400029ec ); PROVIDE ( rtc_set_sleep_mode = 0x40002668 ); PROVIDE ( save_rxbcn_mactime = 0x400027a4 ); PROVIDE ( save_tsf_us = 0x400027ac ); PROVIDE ( send_packet = 0x40003c80 ); PROVIDE ( sha1_prf = 0x4000ba48 ); PROVIDE ( sha1_vector = 0x4000a2ec ); PROVIDE ( sip_alloc_to_host_evt = 0x40005180 ); PROVIDE ( sip_get_ptr = 0x400058a8 ); PROVIDE ( sip_get_state = 0x40005668 ); PROVIDE ( sip_init_attach = 0x4000567c ); PROVIDE ( sip_install_rx_ctrl_cb = 0x4000544c ); PROVIDE ( sip_install_rx_data_cb = 0x4000545c ); PROVIDE ( sip_post = 0x400050fc ); PROVIDE ( sip_post_init = 0x400056c4 ); PROVIDE ( sip_reclaim_from_host_cmd = 0x4000534c ); PROVIDE ( sip_reclaim_tx_data_pkt = 0x400052c0 ); PROVIDE ( sip_send = 0x40005808 ); PROVIDE ( sip_to_host_chain_append = 0x40005864 ); PROVIDE ( sip_to_host_evt_send_done = 0x40005234 ); PROVIDE ( slc_add_credits = 0x400060ac ); PROVIDE ( slc_enable = 0x40005d90 ); PROVIDE ( slc_from_host_chain_fetch = 0x40005f24 ); PROVIDE ( slc_from_host_chain_recycle = 0x40005e94 ); PROVIDE ( slc_init_attach = 0x40005c50 ); PROVIDE ( slc_init_credit = 0x4000608c ); PROVIDE ( slc_pause_from_host = 0x40006014 ); PROVIDE ( slc_reattach = 0x40005c1c ); PROVIDE ( slc_resume_from_host = 0x4000603c ); PROVIDE ( slc_select_tohost_gpio = 0x40005dc0 ); PROVIDE ( slc_select_tohost_gpio_mode = 0x40005db8 ); PROVIDE ( slc_send_to_host_chain = 0x40005de4 ); PROVIDE ( slc_set_host_io_max_window = 0x40006068 ); PROVIDE ( slc_to_host_chain_recycle = 0x40005f10 ); PROVIDE ( software_reset = 0x4000264c ); PROVIDE ( spi_flash_attach = 0x40004644 ); PROVIDE ( srand = 0x400005f0 ); PROVIDE ( strcmp = 0x4000bdc8 ); PROVIDE ( strcpy = 0x4000bec8 ); PROVIDE ( strlen = 0x4000bf4c ); PROVIDE ( strncmp = 0x4000bfa8 ); PROVIDE ( strncpy = 0x4000c0a0 ); PROVIDE ( strstr = 0x4000e1e0 ); PROVIDE ( timer_insert = 0x40002c64 ); PROVIDE ( uartAttach = 0x4000383c ); PROVIDE ( uart_baudrate_detect = 0x40003924 ); PROVIDE ( uart_buff_switch = 0x400038a4 ); PROVIDE ( uart_div_modify = 0x400039d8 ); PROVIDE ( uart_rx_intr_handler = 0x40003bbc ); PROVIDE ( uart_rx_one_char = 0x40003b8c ); PROVIDE ( uart_rx_one_char_block = 0x40003b64 ); PROVIDE ( uart_rx_readbuff = 0x40003ec8 ); PROVIDE ( uart_tx_one_char = 0x40003b30 ); PROVIDE ( wepkey_128 = 0x4000bc40 ); PROVIDE ( wepkey_64 = 0x4000bb3c ); PROVIDE ( xthal_bcopy = 0x40000688 ); PROVIDE ( xthal_copy123 = 0x4000074c ); PROVIDE ( xthal_get_ccompare = 0x4000dd4c ); PROVIDE ( xthal_get_ccount = 0x4000dd38 ); PROVIDE ( xthal_get_interrupt = 0x4000dd58 ); PROVIDE ( xthal_get_intread = 0x4000dd58 ); PROVIDE ( xthal_memcpy = 0x400006c4 ); PROVIDE ( xthal_set_ccompare = 0x4000dd40 ); PROVIDE ( xthal_set_intclear = 0x4000dd60 ); PROVIDE ( xthal_spill_registers_into_stack_nw = 0x4000e320 ); PROVIDE ( xthal_window_spill = 0x4000e324 ); PROVIDE ( xthal_window_spill_nw = 0x4000e320 ); PROVIDE ( Te0 = 0x3fffccf0 ); PROVIDE ( UartDev = 0x3fffde10 ); PROVIDE ( flashchip = 0x3fffc714); ================================================ FILE: tools/.gitattributes ================================================ # Enforce Unix newlines *.css text eol=lf *.html text eol=lf *.js text eol=lf *.json text eol=lf *.less text eol=lf *.md text eol=lf *.svg text eol=lf *.yml text eol=lf *.py text eol=lf *.sh text eol=lf ================================================ FILE: tools/esptool.py ================================================ #!/usr/bin/env python2 # # ESP8266 ROM Bootloader Utility # https://github.com/themadinventor/esptool # # Copyright (C) 2014 Fredrik Ahlberg # # 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 sys import struct import serial import math import time import argparse import os import subprocess class ESPROM: # 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 = 0x100 # Default baudrate. The ROM auto-bauds, so we can use more or less whatever we want. ESP_ROM_BAUD = 230400 #ESP_ROM_BAUD = 921600 #ESP_ROM_BAUD = 460800 # First byte of the application image ESP_IMAGE_MAGIC = 0xe9 # Initial state for the checksum routine ESP_CHECKSUM_MAGIC = 0xef # OTP ROM addresses ESP_OTP_MAC0 = 0x3ff00050 ESP_OTP_MAC1 = 0x3ff00054 def __init__(self, port = 0, baud = ESP_ROM_BAUD): self._port = serial.Serial(port, 9600) self._port = serial.Serial(port, baud) """ Read bytes from the serial port while performing SLIP unescaping """ def read(self, length = 1): b = '' while len(b) < length: c = self._port.read(1) if c == '\xdb': c = self._port.read(1) if c == '\xdc': b = b + '\xc0' elif c == '\xdd': b = b + '\xdb' else: raise Exception('Invalid SLIP escape') else: b = b + c return b """ Write bytes to the serial port while performing SLIP escaping """ def write(self, packet): buf = '\xc0' for b in packet: if b == '\xc0': buf += '\xdb\xdc' elif b == '\xdb': buf += '\xdb\xdd' else: buf += b buf += '\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: # Construct and send request pkt = struct.pack(' 16: raise Exception('Invalid firmware image') for i in xrange(segments): (offset, size) = struct.unpack(' 0x40200000 or offset < 0x3ffe0000 or size > 65536: raise Exception('Suspicious segment %x,%d' % (offset, size)) self.segments.append((offset, size, f.read(size))) # Skip the padding. The checksum is stored in the last byte so that the # file is a multiple of 16 bytes. align = 15-(f.tell() % 16) f.seek(align, 1) self.checksum = ord(f.read(1)) def add_segment(self, addr, data): # Data should be aligned on word boundary l = len(data) if l % 4: data += b"\x00" * (4 - l % 4) self.segments.append((addr, len(data), data)) def save(self, filename): f = file(filename, 'wb') f.write(struct.pack(' 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) elif args.operation == 'read_mem': print '0x%08x = 0x%08x' % (args.address, esp.read_reg(args.address)) elif args.operation == 'write_mem': esp.write_reg(args.address, args.value, args.mask, 0) print 'Wrote %08x, mask %08x to %08x' % (args.value, args.mask, args.address) elif args.operation == 'dump_mem': 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] block = block + '\xe0' * (esp.ESP_FLASH_BLOCK-len(block)) esp.flash_block(block, seq) image = image[esp.ESP_FLASH_BLOCK:] seq += 1 print print '\nLeaving...' esp.flash_finish(False) elif args.operation == 'run': esp.run() elif args.operation == 'image_info': image = ESPFirmwareImage(args.filename) 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 for (idx, (offset, size, data)) in enumerate(image.segments): print 'Segment %d: %5d bytes at %08x' % (idx+1, size, offset) checksum = ESPROM.checksum(data, checksum) print print 'Checksum: %02x (%s)' % (image.checksum, 'valid' if image.checksum == checksum else 'invalid!') elif args.operation == 'make_image': image = ESPFirmwareImage() if len(args.segfile) == 0: raise Exception('No segments specified') if len(args.segfile) != len(args.segaddr): raise Exception('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.add_segment(addr, data) image.entrypoint = args.entrypoint image.save(args.output) elif args.operation == 'elf2image': if args.output is None: args.output = args.input + '-' e = ELFFile(args.input) image = ESPFirmwareImage() image.entrypoint = e.get_symbol_addr("call_user_start") for section, start in ((".text", "_text_start"), (".data", "_data_start"), (".rodata", "_rodata_start")): data = e.load_section(section) image.add_segment(e.get_symbol_addr(start), data) image.save(args.output + "0x00000.bin") data = e.load_section(".irom0.text") off = e.get_symbol_addr("_irom0_text_start") - 0x40200000 assert off >= 0 f = open(args.output + "0x%05x.bin" % off, "wb") f.write(data) f.close() elif args.operation == 'read_mac': mac0 = esp.read_reg(esp.ESP_OTP_MAC0) mac1 = esp.read_reg(esp.ESP_OTP_MAC1) print 'MAC: 18:fe:34:%02x:%02x:%02x' % ((mac1 >> 8) & 0xff, mac1 & 0xff, (mac0 >> 24) & 0xff) ================================================ FILE: tools/makefile.sh ================================================ # # Generate the certificates and keys for encrypt. # # set default cert for use in the client xxd -i client.cer | sed -e \ "s/client_cer/default_certificate/" > cert.h # set default key for use in the server xxd -i server.key_1024 | sed -e \ "s/server_key_1024/default_private_key/" > private_key.h ================================================ FILE: tools/mkfs.py ================================================ #!/usr/bin/env python3 # import sys import struct import math import time import argparse import os import subprocess import zlib import gzip class MKFS: def __init__(self, src, dest): self._src = src self._dest = dest self._fileCount = 0 self.data=bytearray() self.offset=0 def output_writeln(self,line): self.file_dest.write(line+'\r\n') def writeFile(self,path,filename,compress): with open(path, "rb") as f: fileBytes = f.read() if compress: gzip_compress = zlib.compressobj(9, zlib.DEFLATED, zlib.MAX_WBITS | 16) gzip_data = gzip_compress.compress(fileBytes) + gzip_compress.flush() fileBytes = gzip_data fileLen = len(fileBytes) fileBytes = bytearray(fileBytes) self.output_writeln('\t\t{') self.output_writeln('\t\t.size='+str(fileLen)+',') self.output_writeln('\t\t.name = "'+filename+'",') if compress: self.output_writeln('\t\t.gzip=1,') else: self.output_writeln('\t\t.gzip=0,') self.output_writeln('\t\t.offset='+str(self.offset)) #append data for b in fileBytes: self.data.append(b) if self._innerCount == self._fileCount-1: self.output_writeln('\t\t}') else: self.output_writeln('\t\t},') self._innerCount+=1 self.offset+=fileLen; #align rest = 4-(self.offset)%4; while rest > 0: self.offset=self.offset+1 self.data.append(0); rest=rest-1 def count(self): for dirname, dirnames, filenames in os.walk(self._src): # print path to all filenames. for filename in filenames: self._fileCount+=1 if '.bak' in dirnames: dirnames.remove('.bak') if '.git' in dirnames: # don't go into any .git directories. dirnames.remove('.git') def run(self): self.file_dest = open(self._dest,'w') self.count() self.output_writeln('//Generated by MKFS tool') self.output_writeln('//') self.output_writeln('#include "rofs.h"') self.output_writeln('#include "c_types.h"') self.output_writeln('#define ROFS_FILE_COUNT '+str(self._fileCount)) self.output_writeln('const RO_FS ro_file_system = {') self.output_writeln('\t.count='+str(self._fileCount)+',') self.output_writeln('\t.files={') self._innerCount=0; #make full path for dirname, dirnames, filenames in os.walk(self._src): # print path to all filenames. for filename in filenames: self.writeFile(os.path.join(dirname,filename),filename,1) # Advanced usage: # editing the 'dirnames' list will stop os.walk() from recursing into there. if '.git' in dirnames: # don't go into any .git directories. dirnames.remove('.git') if '.bak' in dirnames: dirnames.remove('.bak') self.output_writeln('\t}') self.output_writeln('};') fileHex = ', '.join(hex(x) for x in self.data) self.output_writeln('const ICACHE_STORE_ATTR ICACHE_RODATA_ATTR uint8_t rofs_data[]={'+fileHex+'};') #self.output_writeln('static ROFS_FILE_ENTRY ro_file_system_entries[]={'+','.join('file'+str(x) for x in range(0,self._fileCount-1))+'};') if __name__ == '__main__': parser = argparse.ArgumentParser(description = 'ROM FS make from dir', prog = 'mkfs') parser.add_argument( '--src', '-s', help = 'Source directory') parser.add_argument( '--dest', '-d', help = 'Destination file') parser.add_argument( '--gzip', '-z', help = 'Destination file', default=1) args = parser.parse_args() mkfs = MKFS(args.src,args.dest) mkfs.run()