From 441b6563d6f6ceec5a7e151e627a1c86b16fa08b Mon Sep 17 00:00:00 2001 From: Zakhar Panteleev Date: Wed, 10 Dec 2025 17:55:05 +0300 Subject: [PATCH] up --- .gitattributes | 22 + .gitignore | 1940 ++++++++ .gitmodules | 0 Application/Application.h | 18 + Application/loopback/loopback.c | 1029 +++++ Application/loopback/loopback.h | 50 + Application/multicast/multicast.c | 145 + Application/multicast/multicast.h | 28 + Ethernet/Socket_APIs_V3.0.3.chm | Bin 0 -> 1435546 bytes Ethernet/W5100/w5100.c | 371 ++ Ethernet/W5100/w5100.h | 1875 ++++++++ Ethernet/W5100S/w5100s.c | 499 ++ Ethernet/W5100S/w5100s.h | 3322 +++++++++++++ Ethernet/W5200/w5200.c | 338 ++ Ethernet/W5200/w5200.h | 2118 +++++++++ Ethernet/W5300/w5300.c | 229 + Ethernet/W5300/w5300.h | 2336 ++++++++++ Ethernet/W5500/w5500.c | 248 + Ethernet/W5500/w5500.h | 2164 +++++++++ Ethernet/W6100/w6100.c | 272 ++ Ethernet/W6100/w6100.h | 4086 ++++++++++++++++ Ethernet/W6300/w6300.c | 273 ++ Ethernet/W6300/w6300.h | 4103 +++++++++++++++++ Ethernet/socket.c | 1473 ++++++ Ethernet/socket.h | 736 +++ Ethernet/wizchip_conf.c | 1515 ++++++ Ethernet/wizchip_conf.h | 1348 ++++++ Internet/AAC/AddressAutoConfig.c | 681 +++ Internet/AAC/AddressAutoConfig.h | 133 + Internet/DHCP/dhcp.c | 1118 +++++ Internet/DHCP/dhcp.h | 163 + Internet/DHCP6/dhcpv6.c | 1219 +++++ Internet/DHCP6/dhcpv6.h | 162 + Internet/DNS/dns.c | 615 +++ Internet/DNS/dns.h | 109 + Internet/MQTT/MQTTClient.c | 572 +++ Internet/MQTT/MQTTClient.h | 178 + Internet/MQTT/MQTTPacket/src/MQTTConnect.h | 128 + .../MQTT/MQTTPacket/src/MQTTConnectClient.c | 211 + .../MQTT/MQTTPacket/src/MQTTConnectServer.c | 148 + .../MQTTPacket/src/MQTTDeserializePublish.c | 109 + Internet/MQTT/MQTTPacket/src/MQTTFormat.c | 241 + Internet/MQTT/MQTTPacket/src/MQTTFormat.h | 37 + Internet/MQTT/MQTTPacket/src/MQTTPacket.c | 401 ++ Internet/MQTT/MQTTPacket/src/MQTTPacket.h | 126 + Internet/MQTT/MQTTPacket/src/MQTTPublish.h | 38 + .../MQTTPacket/src/MQTTSerializePublish.c | 163 + Internet/MQTT/MQTTPacket/src/MQTTSubscribe.h | 39 + .../MQTT/MQTTPacket/src/MQTTSubscribeClient.c | 133 + .../MQTT/MQTTPacket/src/MQTTSubscribeServer.c | 112 + .../MQTT/MQTTPacket/src/MQTTUnsubscribe.h | 38 + .../MQTTPacket/src/MQTTUnsubscribeClient.c | 105 + .../MQTTPacket/src/MQTTUnsubscribeServer.c | 100 + Internet/MQTT/MQTTPacket/src/StackTrace.h | 78 + Internet/MQTT/mqtt_interface.c | 190 + Internet/MQTT/mqtt_interface.h | 270 ++ Internet/SNMP/snmp.c | 917 ++++ Internet/SNMP/snmp.h | 122 + Internet/SNMP/snmp_custom.c | 178 + Internet/SNMP/snmp_custom.h | 41 + Internet/SNMP/tools/OID_Converter/Readme.txt | 45 + .../net-snmp-5.7(win32-bin)/snmptrapd.conf | 33 + Internet/SNTP/sntp.c | 469 ++ Internet/SNTP/sntp.h | 74 + Internet/TFTP/netutil.c | 151 + Internet/TFTP/netutil.h | 27 + Internet/TFTP/tftp.c | 639 +++ Internet/TFTP/tftp.h | 102 + Internet/httpServer/httpParser.c | 430 ++ Internet/httpServer/httpParser.h | 157 + Internet/httpServer/httpServer.c | 707 +++ Internet/httpServer/httpServer.h | 108 + Internet/httpServer/httpUtil.c | 65 + Internet/httpServer/httpUtil.h | 32 + README.md | 140 + iolibrary.chm | Bin 0 -> 4728334 bytes license.txt | 22 + 77 files changed, 42614 insertions(+) create mode 100644 .gitattributes create mode 100644 .gitignore create mode 100644 .gitmodules create mode 100644 Application/Application.h create mode 100644 Application/loopback/loopback.c create mode 100644 Application/loopback/loopback.h create mode 100644 Application/multicast/multicast.c create mode 100644 Application/multicast/multicast.h create mode 100644 Ethernet/Socket_APIs_V3.0.3.chm create mode 100644 Ethernet/W5100/w5100.c create mode 100644 Ethernet/W5100/w5100.h create mode 100644 Ethernet/W5100S/w5100s.c create mode 100644 Ethernet/W5100S/w5100s.h create mode 100644 Ethernet/W5200/w5200.c create mode 100644 Ethernet/W5200/w5200.h create mode 100644 Ethernet/W5300/w5300.c create mode 100644 Ethernet/W5300/w5300.h create mode 100644 Ethernet/W5500/w5500.c create mode 100644 Ethernet/W5500/w5500.h create mode 100644 Ethernet/W6100/w6100.c create mode 100644 Ethernet/W6100/w6100.h create mode 100644 Ethernet/W6300/w6300.c create mode 100644 Ethernet/W6300/w6300.h create mode 100644 Ethernet/socket.c create mode 100644 Ethernet/socket.h create mode 100644 Ethernet/wizchip_conf.c create mode 100644 Ethernet/wizchip_conf.h create mode 100644 Internet/AAC/AddressAutoConfig.c create mode 100644 Internet/AAC/AddressAutoConfig.h create mode 100644 Internet/DHCP/dhcp.c create mode 100644 Internet/DHCP/dhcp.h create mode 100644 Internet/DHCP6/dhcpv6.c create mode 100644 Internet/DHCP6/dhcpv6.h create mode 100644 Internet/DNS/dns.c create mode 100644 Internet/DNS/dns.h create mode 100644 Internet/MQTT/MQTTClient.c create mode 100644 Internet/MQTT/MQTTClient.h create mode 100644 Internet/MQTT/MQTTPacket/src/MQTTConnect.h create mode 100644 Internet/MQTT/MQTTPacket/src/MQTTConnectClient.c create mode 100644 Internet/MQTT/MQTTPacket/src/MQTTConnectServer.c create mode 100644 Internet/MQTT/MQTTPacket/src/MQTTDeserializePublish.c create mode 100644 Internet/MQTT/MQTTPacket/src/MQTTFormat.c create mode 100644 Internet/MQTT/MQTTPacket/src/MQTTFormat.h create mode 100644 Internet/MQTT/MQTTPacket/src/MQTTPacket.c create mode 100644 Internet/MQTT/MQTTPacket/src/MQTTPacket.h create mode 100644 Internet/MQTT/MQTTPacket/src/MQTTPublish.h create mode 100644 Internet/MQTT/MQTTPacket/src/MQTTSerializePublish.c create mode 100644 Internet/MQTT/MQTTPacket/src/MQTTSubscribe.h create mode 100644 Internet/MQTT/MQTTPacket/src/MQTTSubscribeClient.c create mode 100644 Internet/MQTT/MQTTPacket/src/MQTTSubscribeServer.c create mode 100644 Internet/MQTT/MQTTPacket/src/MQTTUnsubscribe.h create mode 100644 Internet/MQTT/MQTTPacket/src/MQTTUnsubscribeClient.c create mode 100644 Internet/MQTT/MQTTPacket/src/MQTTUnsubscribeServer.c create mode 100644 Internet/MQTT/MQTTPacket/src/StackTrace.h create mode 100644 Internet/MQTT/mqtt_interface.c create mode 100644 Internet/MQTT/mqtt_interface.h create mode 100644 Internet/SNMP/snmp.c create mode 100644 Internet/SNMP/snmp.h create mode 100644 Internet/SNMP/snmp_custom.c create mode 100644 Internet/SNMP/snmp_custom.h create mode 100644 Internet/SNMP/tools/OID_Converter/Readme.txt create mode 100644 Internet/SNMP/tools/net-snmp-5.7(win32-bin)/snmptrapd.conf create mode 100644 Internet/SNTP/sntp.c create mode 100644 Internet/SNTP/sntp.h create mode 100644 Internet/TFTP/netutil.c create mode 100644 Internet/TFTP/netutil.h create mode 100644 Internet/TFTP/tftp.c create mode 100644 Internet/TFTP/tftp.h create mode 100644 Internet/httpServer/httpParser.c create mode 100644 Internet/httpServer/httpParser.h create mode 100644 Internet/httpServer/httpServer.c create mode 100644 Internet/httpServer/httpServer.h create mode 100644 Internet/httpServer/httpUtil.c create mode 100644 Internet/httpServer/httpUtil.h create mode 100644 README.md create mode 100644 iolibrary.chm create mode 100644 license.txt diff --git a/.gitattributes b/.gitattributes new file mode 100644 index 0000000..412eeda --- /dev/null +++ b/.gitattributes @@ -0,0 +1,22 @@ +# Auto detect text files and perform LF normalization +* text=auto + +# Custom for Visual Studio +*.cs diff=csharp +*.sln merge=union +*.csproj merge=union +*.vbproj merge=union +*.fsproj merge=union +*.dbproj merge=union + +# Standard to msysgit +*.doc diff=astextplain +*.DOC diff=astextplain +*.docx diff=astextplain +*.DOCX diff=astextplain +*.dot diff=astextplain +*.DOT diff=astextplain +*.pdf diff=astextplain +*.PDF diff=astextplain +*.rtf diff=astextplain +*.RTF diff=astextplain diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..a505ec0 --- /dev/null +++ b/.gitignore @@ -0,0 +1,1940 @@ +# Windows image file caches +Thumbs.db +ehthumbs.db + +# Folder config file +Desktop.ini + +# Recycle Bin used on file shares +$RECYCLE.BIN/ + +# Windows Installer files +*.cab +*.msi +*.msm +*.msp + +# ========================= +# Operating System Files +# ========================= + +# OSX +# ========================= + +.DS_Store +.AppleDouble +.LSOverride + +# Icon must end with two \r +Icon + + +# Thumbnails +._* + +# Files that might appear on external disk +.Spotlight-V100 +.Trashes + +# Directories potentially created on remote AFP share +.AppleDB +.AppleDesktop +Network Trash Folder +Temporary Items +.apdisk +man/man3/wizchip_conf.h.3 +man/man3/wizchip_conf.c.3 +man/man3/wiz_PhyConf_t.3 +man/man3/wiz_NetTimeout_t.3 +man/man3/wiz_NetInfo_t.3 +man/man3/w5500.jpg.3 +man/man3/w5500.h.3 +man/man3/w5500.c.3 +man/man3/w5300.h.3 +man/man3/w5300.c.3 +man/man3/w5200_w5500.jpg.3 +man/man3/w5200.h.3 +man/man3/ftpc.h.3 +man/man3/ftpc.c.3 +man/man3/ftpc.3 +man/man3/extra_functions.3 +man/man3/doxygen_log.txt.3 +man/man3/dns.h.3 +man/man3/dns.c.3 +man/man3/dhdr.3 +man/man3/dhcp.h.3 +man/man3/dhcp.c.3 +man/man3/dataEntryType.3 +man/man3/_un_l2cval.3 +man/man3/_st_http_socket.3 +man/man3/_st_http_request.3 +man/man3/_ntpformat.3 +man/man3/_httpServer_webContent.3 +man/man3/W5100.3 +man/man3/Timer.3 +man/man3/StackTrace.h.3 +man/man3/Special_function_W5100S.3 +man/man3/Socket_register_group_W5300.3 +man/man3/Socket_register_group_W5200.3 +man/man3/Socket_register_group_W5100S.3 +man/man3/Socket_register_group_W5100.3 +man/man3/Socket_register_group.3 +man/man3/Socket_register_access_function_W5300.3 +man/man3/Socket_register_access_function_W5200.3 +man/man3/Socket_register_access_function_W5100S.3 +man/man3/Socket_register_access_function_W5100.3 +man/man3/Socket_register_access_function.3 +man/man3/Readme.txt.3 +man/man3/RIP_MSG.3 +man/man3/README.md.3 +man/man3/Network.3 +man/man3/MessageData.3 +man/man3/Main_page.txt.3 +man/man3/MQTTUnsubscribeServer.c.3 +man/man3/MQTTUnsubscribeClient.c.3 +man/man3/MQTTUnsubscribe.h.3 +man/man3/MQTTTransport.3 +man/man3/MQTTSubscribeServer.c.3 +man/man3/MQTTSubscribeClient.c.3 +man/man3/MQTTSubscribe.h.3 +man/man3/MQTTString.3 +man/man3/MQTTSerializePublish.c.3 +man/man3/MQTTPublish.h.3 +man/man3/MQTTPacket_willOptions.3 +man/man3/MQTTPacket_connectData.3 +man/man3/MQTTPacket.h.3 +man/man3/MQTTPacket.c.3 +man/man3/MQTTMessage.3 +man/man3/MQTTLenString.3 +man/man3/MQTTHeader.3 +man/man3/MQTTFormat.h.3 +man/man3/MQTTFormat.c.3 +man/man3/MQTTDeserializePublish.c.3 +man/man3/MQTTConnectServer.c.3 +man/man3/MQTTConnectFlags.3 +man/man3/MQTTConnectClient.c.3 +man/man3/MQTTConnect.h.3 +man/man3/MQTTConnackFlags.3 +man/man3/MQTTClient_MessageHandlers.3 +man/man3/MQTTClient.h.3 +man/man3/MQTTClient.c.3 +man/man3/MQTTClient.3 +man/man3/D__workspace_CoIDE WorkSpace_ioLibrary_Driver_img_.3 +man/man3/D__workspace_CoIDE WorkSpace_ioLibrary_Driver_image_.3 +man/man3/D__workspace_CoIDE WorkSpace_ioLibrary_Driver_Internet_httpServer_.3 +man/man3/D__workspace_CoIDE WorkSpace_ioLibrary_Driver_Internet_TFTP_.3 +man/man3/D__workspace_CoIDE WorkSpace_ioLibrary_Driver_Internet_SNTP_.3 +man/man3/D__workspace_CoIDE WorkSpace_ioLibrary_Driver_Internet_SNMP_.3 +man/man3/D__workspace_CoIDE WorkSpace_ioLibrary_Driver_Internet_MQTT_MQTTPacket_src_.3 +man/man3/D__workspace_CoIDE WorkSpace_ioLibrary_Driver_Internet_MQTT_MQTTPacket_.3 +man/man3/D__workspace_CoIDE WorkSpace_ioLibrary_Driver_Internet_MQTT_.3 +man/man3/D__workspace_CoIDE WorkSpace_ioLibrary_Driver_Internet_FTPServer_.3 +man/man3/D__workspace_CoIDE WorkSpace_ioLibrary_Driver_Internet_FTPClient_.3 +man/man3/D__workspace_CoIDE WorkSpace_ioLibrary_Driver_Internet_DNS_.3 +man/man3/D__workspace_CoIDE WorkSpace_ioLibrary_Driver_Internet_DHCP_.3 +man/man3/D__workspace_CoIDE WorkSpace_ioLibrary_Driver_Internet_.3 +man/man3/D__workspace_CoIDE WorkSpace_ioLibrary_Driver_Ethernet_W5500_.3 +man/man3/D__workspace_CoIDE WorkSpace_ioLibrary_Driver_Ethernet_W5300_.3 +man/man3/D__workspace_CoIDE WorkSpace_ioLibrary_Driver_Ethernet_W5200_.3 +man/man3/D__workspace_CoIDE WorkSpace_ioLibrary_Driver_Ethernet_W5100_.3 +man/man3/D__workspace_CoIDE WorkSpace_ioLibrary_Driver_Ethernet_W5100S_.3 +man/man3/D__workspace_CoIDE WorkSpace_ioLibrary_Driver_Ethernet_.3 +man/man3/D__workspace_CoIDE WorkSpace_ioLibrary_Driver_Application_loopback_.3 +man/man3/D__workspace_CoIDE WorkSpace_ioLibrary_Driver_Application_.3 +man/man3/DATA_TYPE.3 +man/man3/Common_register_group_W5300.3 +man/man3/Common_register_group_W5200.3 +man/man3/Common_register_group_W5100S.3 +man/man3/Common_register_group_W5100.3 +man/man3/Common_register_group.3 +man/man3/Common_register_access_function_W5300.3 +man/man3/Common_register_access_function_W5200.3 +man/man3/Common_register_access_function_W5100S.3 +man/man3/Common_register_access_function_W5100.3 +man/man3/Common_register_access_function.3 +man/man3/Command.3 +man/man3/Berkeley_SOCKET.jpg.3 +man/man3/Basic_IO_function_W5300.3 +man/man3/Basic_IO_function_W5200.3 +man/man3/Basic_IO_function_W5100S.3 +man/man3/Basic_IO_function_W5100.3 +man/man3/Basic_IO_function.3 +latex/wizchip__conf_8h__incl.pdf +latex/wizchip__conf_8h__incl.md5 +latex/wizchip__conf_8h__dep__incl.pdf +latex/wizchip__conf_8h__dep__incl.md5 +latex/wizchip__conf_8h.tex +latex/wizchip__conf_8c__incl.pdf +latex/wizchip__conf_8c__incl.md5 +latex/wizchip__conf_8c.tex +latex/w5500_8jpg.tex +latex/w5500_8h__incl.pdf +latex/w5500_8h__incl.md5 +latex/w5500_8h__dep__incl.pdf +latex/w5500_8h__dep__incl.md5 +latex/w5500_8h.tex +latex/w5500_8c__incl.pdf +latex/w5500_8c__incl.md5 +latex/w5500_8c.tex +latex/w5300_8h__incl.pdf +latex/w5300_8h__incl.md5 +latex/w5300_8h.tex +latex/w5300_8c__incl.pdf +latex/w5300_8c__incl.md5 +latex/w5300_8c.tex +latex/w5200__w5500_8jpg.tex +latex/w5200_8h__incl.pdf +latex/w5200_8h__incl.md5 +latex/w5200_8h__dep__incl.pdf +latex/w5200_8h__dep__incl.md5 +latex/w5200_8h.tex +latex/w5200_8c__incl.pdf +latex/w5200_8c__incl.md5 +latex/w5200_8c.tex +latex/w5100s_8h__incl.pdf +latex/w5100s_8h__incl.md5 +latex/w5100s_8h__dep__incl.pdf +latex/w5100s_8h__dep__incl.md5 +latex/w5100s_8h.tex +latex/w5100s_8c__incl.pdf +latex/w5100s_8c__incl.md5 +latex/w5100s_8c.tex +latex/w5100_8h__incl.pdf +latex/w5100_8h__incl.md5 +latex/w5100_8h__dep__incl.pdf +latex/w5100_8h__dep__incl.md5 +latex/w5100_8h.tex +latex/w5100_8c__incl.pdf +latex/w5100_8c__incl.md5 +latex/w5100_8c.tex +latex/union_m_q_t_t_header.tex +latex/union_m_q_t_t_connect_flags.tex +latex/union_m_q_t_t_connack_flags.tex +latex/union__un__l2cval.tex +latex/union_____w_i_z_c_h_i_p_1_1___i_f.tex +latex/todo.tex +latex/tftp_8h__incl.pdf +latex/tftp_8h__incl.md5 +latex/tftp_8h__dep__incl.pdf +latex/tftp_8h__dep__incl.md5 +latex/tftp_8h.tex +latex/tftp_8c__incl.pdf +latex/tftp_8c__incl.md5 +latex/tftp_8c.tex +latex/structwiz___phy_conf__t.tex +latex/structwiz___net_timeout__t.tex +latex/structwiz___net_info__t.tex +latex/structtlv_struct_type.tex +latex/structtftp__option.tex +latex/structtftp__error.tex +latex/structtftp__data.tex +latex/structmessage_struct.tex +latex/structftpd.tex +latex/structftpc.tex +latex/structdhdr.tex +latex/structdata_entry_type.tex +latex/struct_timer.tex +latex/struct_r_i_p___m_s_g.tex +latex/struct_network.tex +latex/struct_message_data__coll__graph.pdf +latex/struct_message_data__coll__graph.md5 +latex/struct_message_data.tex +latex/struct_m_q_t_t_transport.tex +latex/struct_m_q_t_t_string__coll__graph.pdf +latex/struct_m_q_t_t_string__coll__graph.md5 +latex/struct_m_q_t_t_string.tex +latex/struct_m_q_t_t_packet__will_options__coll__graph.pdf +latex/struct_m_q_t_t_packet__will_options__coll__graph.md5 +latex/struct_m_q_t_t_packet__will_options.tex +latex/struct_m_q_t_t_packet__connect_data__coll__graph.pdf +latex/struct_m_q_t_t_packet__connect_data__coll__graph.md5 +latex/struct_m_q_t_t_packet__connect_data.tex +latex/struct_m_q_t_t_message.tex +latex/struct_m_q_t_t_len_string.tex +latex/struct_m_q_t_t_client__coll__graph.pdf +latex/struct_m_q_t_t_client__coll__graph.md5 +latex/struct_m_q_t_t_client_1_1_message_handlers.tex +latex/struct_m_q_t_t_client.tex +latex/struct_command.tex +latex/struct__st__http__socket.tex +latex/struct__st__http__request.tex +latex/struct__ntpformat.tex +latex/struct__http_server__web_content.tex +latex/struct__datetime.tex +latex/struct____file.tex +latex/struct_____w_i_z_c_h_i_p__coll__graph.pdf +latex/struct_____w_i_z_c_h_i_p__coll__graph.md5 +latex/struct_____w_i_z_c_h_i_p_1_1___c_s.tex +latex/struct_____w_i_z_c_h_i_p_1_1___c_r_i_s.tex +latex/struct_____w_i_z_c_h_i_p.tex +latex/socket_8h__incl.pdf +latex/socket_8h__incl.md5 +latex/socket_8h__dep__incl.pdf +latex/socket_8h__dep__incl.md5 +latex/socket_8h.tex +latex/socket_8c__incl.pdf +latex/socket_8c__incl.md5 +latex/socket_8c.tex +latex/sntp_8h__incl.pdf +latex/sntp_8h__incl.md5 +latex/sntp_8h__dep__incl.pdf +latex/sntp_8h__dep__incl.md5 +latex/sntp_8h.tex +latex/sntp_8c__incl.pdf +latex/sntp_8c__incl.md5 +latex/sntp_8c.tex +latex/snmp__custom_8h__incl.pdf +latex/snmp__custom_8h__incl.md5 +latex/snmp__custom_8h__dep__incl.pdf +latex/snmp__custom_8h__dep__incl.md5 +latex/snmp__custom_8h.tex +latex/snmp__custom_8c__incl.pdf +latex/snmp__custom_8c__incl.md5 +latex/snmp__custom_8c.tex +latex/snmp_8h__dep__incl.pdf +latex/snmp_8h__dep__incl.md5 +latex/snmp_8h.tex +latex/snmp_8c__incl.pdf +latex/snmp_8c__incl.md5 +latex/snmp_8c.tex +latex/refman.tex +latex/netutil_8h__incl.pdf +latex/netutil_8h__incl.md5 +latex/netutil_8h__dep__incl.pdf +latex/netutil_8h__dep__incl.md5 +latex/netutil_8h.tex +latex/netutil_8c__incl.pdf +latex/netutil_8c__incl.md5 +latex/netutil_8c.tex +latex/mqtt__interface_8h__dep__incl.pdf +latex/mqtt__interface_8h__dep__incl.md5 +latex/mqtt__interface_8h.tex +latex/mqtt__interface_8c__incl.pdf +latex/mqtt__interface_8c__incl.md5 +latex/mqtt__interface_8c.tex +latex/modules.tex +latex/md__r_e_a_d_m_e.tex +latex/make.bat +latex/loopback_8h__incl.pdf +latex/loopback_8h__incl.md5 +latex/loopback_8h__dep__incl.pdf +latex/loopback_8h__dep__incl.md5 +latex/loopback_8h.tex +latex/loopback_8c__incl.pdf +latex/loopback_8c__incl.md5 +latex/loopback_8c.tex.tmp +latex/loopback_8c.tex +latex/license_8txt.tex +latex/index.tex +latex/http_util_8h__incl.pdf +latex/http_util_8h__incl.md5 +latex/http_util_8h__dep__incl.pdf +latex/http_util_8h__dep__incl.md5 +latex/http_util_8h.tex +latex/http_util_8c__incl.pdf +latex/http_util_8c__incl.md5 +latex/http_util_8c.tex +latex/http_server_8h__incl.pdf +latex/http_server_8h__incl.md5 +latex/http_server_8h__dep__incl.pdf +latex/http_server_8h__dep__incl.md5 +latex/http_server_8h.tex +latex/http_server_8c__incl.pdf +latex/http_server_8c__incl.md5 +latex/http_server_8c.tex +latex/http_parser_8h__incl.pdf +latex/http_parser_8h__incl.md5 +latex/http_parser_8h__dep__incl.pdf +latex/http_parser_8h__dep__incl.md5 +latex/http_parser_8h.tex +latex/http_parser_8c__incl.pdf +latex/http_parser_8c__incl.md5 +latex/http_parser_8c.tex +latex/group__snmp__module.tex +latex/group__extra__functions.tex +latex/group___w_i_znet__socket___a_p_is.tex +latex/group___w_i_z_c_h_i_p__register___w5300.tex +latex/group___w_i_z_c_h_i_p__register___w5300.pdf +latex/group___w_i_z_c_h_i_p__register___w5300.md5 +latex/group___w_i_z_c_h_i_p__register___w5200.tex +latex/group___w_i_z_c_h_i_p__register___w5200.pdf +latex/group___w_i_z_c_h_i_p__register___w5200.md5 +latex/group___w_i_z_c_h_i_p__register___w5100_s.tex +latex/group___w_i_z_c_h_i_p__register___w5100_s.pdf +latex/group___w_i_z_c_h_i_p__register___w5100_s.md5 +latex/group___w_i_z_c_h_i_p__register___w5100.tex +latex/group___w_i_z_c_h_i_p__register___w5100.pdf +latex/group___w_i_z_c_h_i_p__register___w5100.md5 +latex/group___w_i_z_c_h_i_p__register.tex +latex/group___w_i_z_c_h_i_p__register.pdf +latex/group___w_i_z_c_h_i_p__register.md5 +latex/group___w_i_z_c_h_i_p___i_o___functions___w5300.tex +latex/group___w_i_z_c_h_i_p___i_o___functions___w5300.pdf +latex/group___w_i_z_c_h_i_p___i_o___functions___w5300.md5 +latex/group___w_i_z_c_h_i_p___i_o___functions___w5200.tex +latex/group___w_i_z_c_h_i_p___i_o___functions___w5200.pdf +latex/group___w_i_z_c_h_i_p___i_o___functions___w5200.md5 +latex/group___w_i_z_c_h_i_p___i_o___functions___w5100_s.tex +latex/group___w_i_z_c_h_i_p___i_o___functions___w5100_s.pdf +latex/group___w_i_z_c_h_i_p___i_o___functions___w5100_s.md5 +latex/group___w_i_z_c_h_i_p___i_o___functions___w5100.tex +latex/group___w_i_z_c_h_i_p___i_o___functions___w5100.pdf +latex/group___w_i_z_c_h_i_p___i_o___functions___w5100.md5 +latex/group___w_i_z_c_h_i_p___i_o___functions.tex +latex/group___w_i_z_c_h_i_p___i_o___functions.pdf +latex/group___w_i_z_c_h_i_p___i_o___functions.md5 +latex/group___w5500.tex +latex/group___w5500.pdf +latex/group___w5500.md5 +latex/group___w5300.tex +latex/group___w5300.pdf +latex/group___w5300.md5 +latex/group___w5200.tex +latex/group___w5200.pdf +latex/group___w5200.md5 +latex/group___w5100_s.tex +latex/group___w5100_s.pdf +latex/group___w5100_s.md5 +latex/group___w5100.tex +latex/group___w5100.pdf +latex/group___w5100.md5 +latex/group___special__function___w5100_s.tex +latex/group___special__function___w5100_s.pdf +latex/group___special__function___w5100_s.md5 +latex/group___socket__register__group___w5300.tex +latex/group___socket__register__group___w5300.pdf +latex/group___socket__register__group___w5300.md5 +latex/group___socket__register__group___w5200.tex +latex/group___socket__register__group___w5200.pdf +latex/group___socket__register__group___w5200.md5 +latex/group___socket__register__group___w5100_s.tex +latex/group___socket__register__group___w5100_s.pdf +latex/group___socket__register__group___w5100_s.md5 +latex/group___socket__register__group___w5100.tex +latex/group___socket__register__group___w5100.pdf +latex/group___socket__register__group___w5100.md5 +latex/group___socket__register__group.tex +latex/group___socket__register__group.pdf +latex/group___socket__register__group.md5 +latex/group___socket__register__access__function___w5300.tex +latex/group___socket__register__access__function___w5300.pdf +latex/group___socket__register__access__function___w5300.md5 +latex/group___socket__register__access__function___w5200.tex +latex/group___socket__register__access__function___w5200.pdf +latex/group___socket__register__access__function___w5200.md5 +latex/group___socket__register__access__function___w5100_s.tex +latex/group___socket__register__access__function___w5100_s.pdf +latex/group___socket__register__access__function___w5100_s.md5 +latex/group___socket__register__access__function___w5100.tex +latex/group___socket__register__access__function___w5100.pdf +latex/group___socket__register__access__function___w5100.md5 +latex/group___socket__register__access__function.tex +latex/group___socket__register__access__function.pdf +latex/group___socket__register__access__function.md5 +latex/group___d_a_t_a___t_y_p_e.tex +latex/group___common__register__group___w5300.tex +latex/group___common__register__group___w5300.pdf +latex/group___common__register__group___w5300.md5 +latex/group___common__register__group___w5200.tex +latex/group___common__register__group___w5200.pdf +latex/group___common__register__group___w5200.md5 +latex/group___common__register__group___w5100_s.tex +latex/group___common__register__group___w5100_s.pdf +latex/group___common__register__group___w5100_s.md5 +latex/group___common__register__group___w5100.tex +latex/group___common__register__group___w5100.pdf +latex/group___common__register__group___w5100.md5 +latex/group___common__register__group.tex +latex/group___common__register__group.pdf +latex/group___common__register__group.md5 +latex/group___common__register__access__function___w5300.tex +latex/group___common__register__access__function___w5300.pdf +latex/group___common__register__access__function___w5300.md5 +latex/group___common__register__access__function___w5200.tex +latex/group___common__register__access__function___w5200.pdf +latex/group___common__register__access__function___w5200.md5 +latex/group___common__register__access__function___w5100_s.tex +latex/group___common__register__access__function___w5100_s.pdf +latex/group___common__register__access__function___w5100_s.md5 +latex/group___common__register__access__function___w5100.tex +latex/group___common__register__access__function___w5100.pdf +latex/group___common__register__access__function___w5100.md5 +latex/group___common__register__access__function.tex +latex/group___common__register__access__function.pdf +latex/group___common__register__access__function.md5 +latex/group___basic___i_o__function___w5300.tex +latex/group___basic___i_o__function___w5300.pdf +latex/group___basic___i_o__function___w5300.md5 +latex/group___basic___i_o__function___w5200.tex +latex/group___basic___i_o__function___w5200.pdf +latex/group___basic___i_o__function___w5200.md5 +latex/group___basic___i_o__function___w5100_s.tex +latex/group___basic___i_o__function___w5100_s.pdf +latex/group___basic___i_o__function___w5100_s.md5 +latex/group___basic___i_o__function___w5100.tex +latex/group___basic___i_o__function___w5100.pdf +latex/group___basic___i_o__function___w5100.md5 +latex/group___basic___i_o__function.tex +latex/group___basic___i_o__function.pdf +latex/group___basic___i_o__function.md5 +latex/ftpd_8h__incl.pdf +latex/ftpd_8h__incl.md5 +latex/ftpd_8h__dep__incl.pdf +latex/ftpd_8h__dep__incl.md5 +latex/ftpd_8h.tex +latex/ftpd_8c__incl.pdf +latex/ftpd_8c__incl.md5 +latex/ftpd_8c.tex +latex/ftpc_8h__incl.pdf +latex/ftpc_8h__incl.md5 +latex/ftpc_8h__dep__incl.pdf +latex/ftpc_8h__dep__incl.md5 +latex/ftpc_8h.tex +latex/ftpc_8c__incl.pdf +latex/ftpc_8c__incl.md5 +latex/ftpc_8c.tex +latex/files.tex +latex/doxygen__log_8txt.tex +latex/doxygen.sty +latex/dns_8h__incl.pdf +latex/dns_8h__incl.md5 +latex/dns_8h__dep__incl.pdf +latex/dns_8h__dep__incl.md5 +latex/dns_8h.tex +latex/dns_8c__incl.pdf +latex/dns_8c__incl.md5 +latex/dns_8c.tex +latex/dir_fe682d1d76c251404f71241aa833642c_dep.pdf +latex/dir_fe682d1d76c251404f71241aa833642c_dep.md5 +latex/dir_fe682d1d76c251404f71241aa833642c.tex +latex/dir_fca0adf6655fb1759a15e5776097c124_dep.pdf +latex/dir_fca0adf6655fb1759a15e5776097c124_dep.md5 +latex/dir_fca0adf6655fb1759a15e5776097c124.tex +latex/dir_f841453af36a2df9a2123f87589fe4f8_dep.pdf +latex/dir_f841453af36a2df9a2123f87589fe4f8_dep.md5 +latex/dir_f841453af36a2df9a2123f87589fe4f8.tex +latex/dir_f10a527ab5b3936e2edf95a019a13ec7_dep.pdf +latex/dir_f10a527ab5b3936e2edf95a019a13ec7_dep.md5 +latex/dir_f10a527ab5b3936e2edf95a019a13ec7.tex +latex/dir_eb1463819d84903762eb6f59cc0c4383_dep.pdf +latex/dir_eb1463819d84903762eb6f59cc0c4383_dep.md5 +latex/dir_eb1463819d84903762eb6f59cc0c4383.tex +latex/dir_e5121bff4754a4ad570fa548a998f0c5_dep.pdf +latex/dir_e5121bff4754a4ad570fa548a998f0c5_dep.md5 +latex/dir_e5121bff4754a4ad570fa548a998f0c5.tex +latex/dir_b88037d6581d528000057b4eaec3e673_dep.pdf +latex/dir_b88037d6581d528000057b4eaec3e673_dep.md5 +latex/dir_b88037d6581d528000057b4eaec3e673.tex +latex/dir_a5a06f90a751e77147778694c516f622_dep.pdf +latex/dir_a5a06f90a751e77147778694c516f622_dep.md5 +latex/dir_a5a06f90a751e77147778694c516f622.tex +latex/dir_a483286db9c12f74c7364bdaa9e78c36_dep.pdf +latex/dir_a483286db9c12f74c7364bdaa9e78c36_dep.md5 +latex/dir_a483286db9c12f74c7364bdaa9e78c36.tex +latex/dir_a138ed074e64356ad02dbb8d94382c4f_dep.pdf +latex/dir_a138ed074e64356ad02dbb8d94382c4f_dep.md5 +latex/dir_a138ed074e64356ad02dbb8d94382c4f.tex +latex/dir_97b8cbb23222306012bd2d84398746c9_dep.pdf +latex/dir_97b8cbb23222306012bd2d84398746c9_dep.md5 +latex/dir_97b8cbb23222306012bd2d84398746c9.tex +latex/dir_6e6e4d5e89221ed61dd87b2954f72a78_dep.pdf +latex/dir_6e6e4d5e89221ed61dd87b2954f72a78_dep.md5 +latex/dir_6e6e4d5e89221ed61dd87b2954f72a78.tex +latex/dir_6de1940466803d61d2f9d1259cb01031.tex +latex/dir_5a912e51f6f9520965e8671f07512599_dep.pdf +latex/dir_5a912e51f6f9520965e8671f07512599_dep.md5 +latex/dir_5a912e51f6f9520965e8671f07512599.tex +latex/dir_4c7002aef9ece892c0aedd728ed93eff.tex +latex/dir_498fbcdef69ea105b96b8673d051b2e3_dep.pdf +latex/dir_498fbcdef69ea105b96b8673d051b2e3_dep.md5 +latex/dir_498fbcdef69ea105b96b8673d051b2e3.tex +latex/dir_46819ec1095f3903911c103f5ebbb29f_dep.pdf +latex/dir_46819ec1095f3903911c103f5ebbb29f_dep.md5 +latex/dir_46819ec1095f3903911c103f5ebbb29f.tex +latex/dir_4396dcc0e095a5bc10b1affe087807cf_dep.pdf +latex/dir_4396dcc0e095a5bc10b1affe087807cf_dep.md5 +latex/dir_4396dcc0e095a5bc10b1affe087807cf.tex +latex/dir_337e147d8ae2958ef29ccaa8e2f968db_dep.pdf +latex/dir_337e147d8ae2958ef29ccaa8e2f968db_dep.md5 +latex/dir_337e147d8ae2958ef29ccaa8e2f968db.tex +latex/dir_2c7bb40a7e5a6685f00216dd2909cd99_dep.pdf +latex/dir_2c7bb40a7e5a6685f00216dd2909cd99_dep.md5 +latex/dir_2c7bb40a7e5a6685f00216dd2909cd99.tex +latex/dir_2c1dd796c287ab9a5cf44281d8a3cbeb.tex +latex/dir_072fcb7a67163ce1d8f22ad4144c7e08.tex +latex/dhcp_8h__dep__incl.pdf +latex/dhcp_8h__dep__incl.md5 +latex/dhcp_8h.tex +latex/dhcp_8c__incl.pdf +latex/dhcp_8c__incl.md5 +latex/dhcp_8c.tex +latex/annotated.tex +latex/_w_i_znet___s_o_c_k_e_t_8jpg.tex +latex/_stack_trace_8h__incl.pdf +latex/_stack_trace_8h__incl.md5 +latex/_stack_trace_8h__dep__incl.pdf +latex/_stack_trace_8h__dep__incl.md5 +latex/_stack_trace_8h.tex +latex/_readme_8txt.tex +latex/_r_e_a_d_m_e_8md.tex +latex/_main__page_8txt.tex +latex/_m_q_t_t_unsubscribe_server_8c__incl.pdf +latex/_m_q_t_t_unsubscribe_server_8c__incl.md5 +latex/_m_q_t_t_unsubscribe_server_8c.tex +latex/_m_q_t_t_unsubscribe_client_8c__incl.pdf +latex/_m_q_t_t_unsubscribe_client_8c__incl.md5 +latex/_m_q_t_t_unsubscribe_client_8c.tex +latex/_m_q_t_t_unsubscribe_8h__dep__incl.pdf +latex/_m_q_t_t_unsubscribe_8h__dep__incl.md5 +latex/_m_q_t_t_unsubscribe_8h.tex +latex/_m_q_t_t_subscribe_server_8c__incl.pdf +latex/_m_q_t_t_subscribe_server_8c__incl.md5 +latex/_m_q_t_t_subscribe_server_8c.tex +latex/_m_q_t_t_subscribe_client_8c__incl.pdf +latex/_m_q_t_t_subscribe_client_8c__incl.md5 +latex/_m_q_t_t_subscribe_client_8c.tex +latex/_m_q_t_t_subscribe_8h__dep__incl.pdf +latex/_m_q_t_t_subscribe_8h__dep__incl.md5 +latex/_m_q_t_t_subscribe_8h.tex +latex/_m_q_t_t_serialize_publish_8c__incl.pdf +latex/_m_q_t_t_serialize_publish_8c__incl.md5 +latex/_m_q_t_t_serialize_publish_8c.tex +latex/_m_q_t_t_publish_8h__dep__incl.pdf +latex/_m_q_t_t_publish_8h__dep__incl.md5 +latex/_m_q_t_t_publish_8h.tex +latex/_m_q_t_t_packet_8h__incl.pdf +latex/_m_q_t_t_packet_8h__incl.md5 +latex/_m_q_t_t_packet_8h__dep__incl.pdf +latex/_m_q_t_t_packet_8h__dep__incl.md5 +latex/_m_q_t_t_packet_8h.tex +latex/_m_q_t_t_packet_8c__incl.pdf +latex/_m_q_t_t_packet_8c__incl.md5 +latex/_m_q_t_t_packet_8c.tex +latex/_m_q_t_t_format_8h__incl.pdf +latex/_m_q_t_t_format_8h__incl.md5 +latex/_m_q_t_t_format_8h__dep__incl.pdf +latex/_m_q_t_t_format_8h__dep__incl.md5 +latex/_m_q_t_t_format_8h.tex +latex/_m_q_t_t_format_8c__incl.pdf +latex/_m_q_t_t_format_8c__incl.md5 +latex/_m_q_t_t_format_8c.tex +latex/_m_q_t_t_deserialize_publish_8c__incl.pdf +latex/_m_q_t_t_deserialize_publish_8c__incl.md5 +latex/_m_q_t_t_deserialize_publish_8c.tex +latex/_m_q_t_t_connect_server_8c__incl.pdf +latex/_m_q_t_t_connect_server_8c__incl.md5 +latex/_m_q_t_t_connect_server_8c.tex +latex/_m_q_t_t_connect_client_8c__incl.pdf +latex/_m_q_t_t_connect_client_8c__incl.md5 +latex/_m_q_t_t_connect_client_8c.tex +latex/_m_q_t_t_connect_8h__dep__incl.pdf +latex/_m_q_t_t_connect_8h__dep__incl.md5 +latex/_m_q_t_t_connect_8h.tex +latex/_m_q_t_t_client_8h__incl.pdf +latex/_m_q_t_t_client_8h__incl.md5 +latex/_m_q_t_t_client_8h__dep__incl.pdf +latex/_m_q_t_t_client_8h__dep__incl.md5 +latex/_m_q_t_t_client_8h.tex +latex/_m_q_t_t_client_8c__incl.pdf +latex/_m_q_t_t_client_8c__incl.md5 +latex/_m_q_t_t_client_8c.tex +latex/_f_t_p_server_2stdio__private_8h__incl.pdf +latex/_f_t_p_server_2stdio__private_8h__incl.md5 +latex/_f_t_p_server_2stdio__private_8h__dep__incl.pdf +latex/_f_t_p_server_2stdio__private_8h__dep__incl.md5 +latex/_f_t_p_server_2stdio__private_8h.tex +latex/_f_t_p_client_2stdio__private_8h__incl.pdf +latex/_f_t_p_client_2stdio__private_8h__incl.md5 +latex/_f_t_p_client_2stdio__private_8h__dep__incl.pdf +latex/_f_t_p_client_2stdio__private_8h__dep__incl.md5 +latex/_f_t_p_client_2stdio__private_8h.tex +latex/_berkeley___s_o_c_k_e_t_8jpg.tex +latex/Makefile +image/w5500.jpg +image/w5200_w5500.jpg +image/WIZnet_SOCKET.jpg +image/Berkeley_SOCKET.jpg +html/wizchip__conf_8h_source.html +html/wizchip__conf_8h__incl.png +html/wizchip__conf_8h__incl.md5 +html/wizchip__conf_8h__incl.map +html/wizchip__conf_8h__dep__incl.png +html/wizchip__conf_8h__dep__incl.md5 +html/wizchip__conf_8h__dep__incl.map +html/wizchip__conf_8h.html +html/wizchip__conf_8c_source.html +html/wizchip__conf_8c__incl.png +html/wizchip__conf_8c__incl.md5 +html/wizchip__conf_8c__incl.map +html/wizchip__conf_8c.html +html/w5500_8jpg_source.html +html/w5500_8jpg.html +html/w5500_8h_source.html +html/w5500_8h__incl.png +html/w5500_8h__incl.md5 +html/w5500_8h__incl.map +html/w5500_8h__dep__incl.png +html/w5500_8h__dep__incl.md5 +html/w5500_8h__dep__incl.map +html/w5500_8h.html +html/w5500_8c_source.html +html/w5500_8c__incl.png +html/w5500_8c__incl.md5 +html/w5500_8c__incl.map +html/w5500_8c.html +html/w5300_8h_source.html +html/w5300_8h__incl.png +html/w5300_8h__incl.md5 +html/w5300_8h__incl.map +html/w5300_8h.html +html/w5300_8c_source.html +html/w5300_8c__incl.png +html/w5300_8c__incl.md5 +html/w5300_8c__incl.map +html/w5300_8c.html +html/w5200_w5500.jpg +html/w5200__w5500_8jpg_source.html +html/w5200__w5500_8jpg.html +html/w5200_8h_source.html +html/w5200_8h__incl.png +html/w5200_8h__incl.md5 +html/w5200_8h__incl.map +html/w5200_8h__dep__incl.png +html/w5200_8h__dep__incl.md5 +html/w5200_8h__dep__incl.map +html/w5200_8h.html +html/w5200_8c_source.html +html/w5200_8c__incl.png +html/w5200_8c__incl.md5 +html/w5200_8c__incl.map +html/w5200_8c.html +html/w5100s_8h_source.html +html/w5100s_8h__incl.png +html/w5100s_8h__incl.md5 +html/w5100s_8h__incl.map +html/w5100s_8h__dep__incl.png +html/w5100s_8h__dep__incl.md5 +html/w5100s_8h__dep__incl.map +html/w5100s_8h.html +html/w5100s_8c_source.html +html/w5100s_8c__incl.png +html/w5100s_8c__incl.md5 +html/w5100s_8c__incl.map +html/w5100s_8c.html +html/w5100_8h_source.html +html/w5100_8h__incl.png +html/w5100_8h__incl.md5 +html/w5100_8h__incl.map +html/w5100_8h__dep__incl.png +html/w5100_8h__dep__incl.md5 +html/w5100_8h__dep__incl.map +html/w5100_8h.html +html/w5100_8c_source.html +html/w5100_8c__incl.png +html/w5100_8c__incl.md5 +html/w5100_8c__incl.map +html/w5100_8c.html +html/union_m_q_t_t_header.html +html/union_m_q_t_t_connect_flags.html +html/union_m_q_t_t_connack_flags.html +html/union__un__l2cval.html +html/union_____w_i_z_c_h_i_p_1_1___i_f.html +html/todo.html +html/tftp_8h_source.html +html/tftp_8h__incl.png +html/tftp_8h__incl.md5 +html/tftp_8h__incl.map +html/tftp_8h__dep__incl.png +html/tftp_8h__dep__incl.md5 +html/tftp_8h__dep__incl.map +html/tftp_8h.html +html/tftp_8c_source.html +html/tftp_8c__incl.png +html/tftp_8c__incl.md5 +html/tftp_8c__incl.map +html/tftp_8c.html +html/tabs.css +html/tab_s.png +html/tab_h.png +html/tab_b.png +html/tab_a.png +html/sync_on.png +html/sync_off.png +html/structwiz___phy_conf__t.html +html/structwiz___net_timeout__t.html +html/structwiz___net_info__t.html +html/structtlv_struct_type.html +html/structtftp__option.html +html/structtftp__error.html +html/structtftp__data.html +html/structmessage_struct.html +html/structftpd.html +html/structftpc.html +html/structdhdr.html +html/structdata_entry_type.html +html/struct_timer.html +html/struct_r_i_p___m_s_g.html +html/struct_network.html +html/struct_message_data__coll__graph.png +html/struct_message_data__coll__graph.md5 +html/struct_message_data__coll__graph.map +html/struct_message_data.html +html/struct_m_q_t_t_transport.html +html/struct_m_q_t_t_string__coll__graph.png +html/struct_m_q_t_t_string__coll__graph.md5 +html/struct_m_q_t_t_string__coll__graph.map +html/struct_m_q_t_t_string.html +html/struct_m_q_t_t_packet__will_options__coll__graph.png +html/struct_m_q_t_t_packet__will_options__coll__graph.md5 +html/struct_m_q_t_t_packet__will_options__coll__graph.map +html/struct_m_q_t_t_packet__will_options.html +html/struct_m_q_t_t_packet__connect_data__coll__graph.png +html/struct_m_q_t_t_packet__connect_data__coll__graph.md5 +html/struct_m_q_t_t_packet__connect_data__coll__graph.map +html/struct_m_q_t_t_packet__connect_data.html +html/struct_m_q_t_t_message.html +html/struct_m_q_t_t_len_string.html +html/struct_m_q_t_t_client__coll__graph.png +html/struct_m_q_t_t_client__coll__graph.md5 +html/struct_m_q_t_t_client__coll__graph.map +html/struct_m_q_t_t_client_1_1_message_handlers.html +html/struct_m_q_t_t_client.html +html/struct_command.html +html/struct__st__http__socket.html +html/struct__st__http__request.html +html/struct__ntpformat.html +html/struct__http_server__web_content.html +html/struct__datetime.html +html/struct____file.html +html/struct_____w_i_z_c_h_i_p__coll__graph.png +html/struct_____w_i_z_c_h_i_p__coll__graph.md5 +html/struct_____w_i_z_c_h_i_p__coll__graph.map +html/struct_____w_i_z_c_h_i_p_1_1___c_s.html +html/struct_____w_i_z_c_h_i_p_1_1___c_r_i_s.html +html/struct_____w_i_z_c_h_i_p.html +html/splitbar.png +html/socket_8h_source.html +html/socket_8h__incl.png +html/socket_8h__incl.md5 +html/socket_8h__incl.map +html/socket_8h__dep__incl.png +html/socket_8h__dep__incl.md5 +html/socket_8h__dep__incl.map +html/socket_8h.html +html/socket_8c_source.html +html/socket_8c__incl.png +html/socket_8c__incl.md5 +html/socket_8c__incl.map +html/socket_8c.html +html/sntp_8h_source.html +html/sntp_8h__incl.png +html/sntp_8h__incl.md5 +html/sntp_8h__incl.map +html/sntp_8h__dep__incl.png +html/sntp_8h__dep__incl.md5 +html/sntp_8h__dep__incl.map +html/sntp_8h.html +html/sntp_8c_source.html +html/sntp_8c__incl.png +html/sntp_8c__incl.md5 +html/sntp_8c__incl.map +html/sntp_8c.html +html/snmp__custom_8h_source.html +html/snmp__custom_8h__incl.png +html/snmp__custom_8h__incl.md5 +html/snmp__custom_8h__incl.map +html/snmp__custom_8h__dep__incl.png +html/snmp__custom_8h__dep__incl.md5 +html/snmp__custom_8h__dep__incl.map +html/snmp__custom_8h.html +html/snmp__custom_8c_source.html +html/snmp__custom_8c__incl.png +html/snmp__custom_8c__incl.md5 +html/snmp__custom_8c__incl.map +html/snmp__custom_8c.html +html/snmp_8h_source.html +html/snmp_8h__dep__incl.png +html/snmp_8h__dep__incl.md5 +html/snmp_8h__dep__incl.map +html/snmp_8h.html +html/snmp_8c_source.html +html/snmp_8c__incl.png +html/snmp_8c__incl.md5 +html/snmp_8c__incl.map +html/snmp_8c.html +html/search/variables_f.js +html/search/variables_f.html +html/search/variables_e.js +html/search/variables_e.html +html/search/variables_d.js +html/search/variables_d.html +html/search/variables_c.js +html/search/variables_c.html +html/search/variables_b.js +html/search/variables_b.html +html/search/variables_a.js +html/search/variables_a.html +html/search/variables_9.js +html/search/variables_9.html +html/search/variables_8.js +html/search/variables_8.html +html/search/variables_7.js +html/search/variables_7.html +html/search/variables_6.js +html/search/variables_6.html +html/search/variables_5.js +html/search/variables_5.html +html/search/variables_4.js +html/search/variables_4.html +html/search/variables_3.js +html/search/variables_3.html +html/search/variables_2.js +html/search/variables_2.html +html/search/variables_18.js +html/search/variables_18.html +html/search/variables_17.js +html/search/variables_17.html +html/search/variables_16.js +html/search/variables_16.html +html/search/variables_15.js +html/search/variables_15.html +html/search/variables_14.js +html/search/variables_14.html +html/search/variables_13.js +html/search/variables_13.html +html/search/variables_12.js +html/search/variables_12.html +html/search/variables_11.js +html/search/variables_11.html +html/search/variables_10.js +html/search/variables_10.html +html/search/variables_1.js +html/search/variables_1.html +html/search/variables_0.js +html/search/variables_0.html +html/search/typedefs_9.js +html/search/typedefs_9.html +html/search/typedefs_8.js +html/search/typedefs_8.html +html/search/typedefs_7.js +html/search/typedefs_7.html +html/search/typedefs_6.js +html/search/typedefs_6.html +html/search/typedefs_5.js +html/search/typedefs_5.html +html/search/typedefs_4.js +html/search/typedefs_4.html +html/search/typedefs_3.js +html/search/typedefs_3.html +html/search/typedefs_2.js +html/search/typedefs_2.html +html/search/typedefs_1.js +html/search/typedefs_1.html +html/search/typedefs_0.js +html/search/typedefs_0.html +html/search/searchdata.js +html/search/search_r.png +html/search/search_m.png +html/search/search_l.png +html/search/search.js +html/search/search.css +html/search/pages_2.js +html/search/pages_2.html +html/search/pages_1.js +html/search/pages_1.html +html/search/pages_0.js +html/search/pages_0.html +html/search/nomatches.html +html/search/mag_sel.png +html/search/groups_6.js +html/search/groups_6.html +html/search/groups_5.js +html/search/groups_5.html +html/search/groups_4.js +html/search/groups_4.html +html/search/groups_3.js +html/search/groups_3.html +html/search/groups_2.js +html/search/groups_2.html +html/search/groups_1.js +html/search/groups_1.html +html/search/groups_0.js +html/search/groups_0.html +html/search/functions_f.js +html/search/functions_f.html +html/search/functions_e.js +html/search/functions_e.html +html/search/functions_d.js +html/search/functions_d.html +html/search/functions_c.js +html/search/functions_c.html +html/search/functions_b.js +html/search/functions_b.html +html/search/functions_a.js +html/search/functions_a.html +html/search/functions_9.js +html/search/functions_9.html +html/search/functions_8.js +html/search/functions_8.html +html/search/functions_7.js +html/search/functions_7.html +html/search/functions_6.js +html/search/functions_6.html +html/search/functions_5.js +html/search/functions_5.html +html/search/functions_4.js +html/search/functions_4.html +html/search/functions_3.js +html/search/functions_3.html +html/search/functions_2.js +html/search/functions_2.html +html/search/functions_11.js +html/search/functions_11.html +html/search/functions_10.js +html/search/functions_10.html +html/search/functions_1.js +html/search/functions_1.html +html/search/functions_0.js +html/search/functions_0.html +html/search/files_a.js +html/search/files_a.html +html/search/files_9.js +html/search/files_9.html +html/search/files_8.js +html/search/files_8.html +html/search/files_7.js +html/search/files_7.html +html/search/files_6.js +html/search/files_6.html +html/search/files_5.js +html/search/files_5.html +html/search/files_4.js +html/search/files_4.html +html/search/files_3.js +html/search/files_3.html +html/search/files_2.js +html/search/files_2.html +html/search/files_1.js +html/search/files_1.html +html/search/files_0.js +html/search/files_0.html +html/search/enumvalues_f.js +html/search/enumvalues_f.html +html/search/enumvalues_e.js +html/search/enumvalues_e.html +html/search/enumvalues_d.js +html/search/enumvalues_d.html +html/search/enumvalues_c.js +html/search/enumvalues_c.html +html/search/enumvalues_b.js +html/search/enumvalues_b.html +html/search/enumvalues_a.js +html/search/enumvalues_a.html +html/search/enumvalues_9.js +html/search/enumvalues_9.html +html/search/enumvalues_8.js +html/search/enumvalues_8.html +html/search/enumvalues_7.js +html/search/enumvalues_7.html +html/search/enumvalues_6.js +html/search/enumvalues_6.html +html/search/enumvalues_5.js +html/search/enumvalues_5.html +html/search/enumvalues_4.js +html/search/enumvalues_4.html +html/search/enumvalues_3.js +html/search/enumvalues_3.html +html/search/enumvalues_2.js +html/search/enumvalues_2.html +html/search/enumvalues_12.js +html/search/enumvalues_12.html +html/search/enumvalues_11.js +html/search/enumvalues_11.html +html/search/enumvalues_10.js +html/search/enumvalues_10.html +html/search/enumvalues_1.js +html/search/enumvalues_1.html +html/search/enumvalues_0.js +html/search/enumvalues_0.html +html/search/enums_9.js +html/search/enums_9.html +html/search/enums_8.js +html/search/enums_8.html +html/search/enums_7.js +html/search/enums_7.html +html/search/enums_6.js +html/search/enums_6.html +html/search/enums_5.js +html/search/enums_5.html +html/search/enums_4.js +html/search/enums_4.html +html/search/enums_3.js +html/search/enums_3.html +html/search/enums_2.js +html/search/enums_2.html +html/search/enums_1.js +html/search/enums_1.html +html/search/enums_0.js +html/search/enums_0.html +html/search/defines_f.js +html/search/defines_f.html +html/search/defines_e.js +html/search/defines_e.html +html/search/defines_d.js +html/search/defines_d.html +html/search/defines_c.js +html/search/defines_c.html +html/search/defines_b.js +html/search/defines_b.html +html/search/defines_a.js +html/search/defines_a.html +html/search/defines_9.js +html/search/defines_9.html +html/search/defines_8.js +html/search/defines_8.html +html/search/defines_7.js +html/search/defines_7.html +html/search/defines_6.js +html/search/defines_6.html +html/search/defines_5.js +html/search/defines_5.html +html/search/defines_4.js +html/search/defines_4.html +html/search/defines_3.js +html/search/defines_3.html +html/search/defines_2.js +html/search/defines_2.html +html/search/defines_15.js +html/search/defines_15.html +html/search/defines_14.js +html/search/defines_14.html +html/search/defines_13.js +html/search/defines_13.html +html/search/defines_12.js +html/search/defines_12.html +html/search/defines_11.js +html/search/defines_11.html +html/search/defines_10.js +html/search/defines_10.html +html/search/defines_1.js +html/search/defines_1.html +html/search/defines_0.js +html/search/defines_0.html +html/search/close.png +html/search/classes_8.js +html/search/classes_8.html +html/search/classes_7.js +html/search/classes_7.html +html/search/classes_6.js +html/search/classes_6.html +html/search/classes_5.js +html/search/classes_5.html +html/search/classes_4.js +html/search/classes_4.html +html/search/classes_3.js +html/search/classes_3.html +html/search/classes_2.js +html/search/classes_2.html +html/search/classes_1.js +html/search/classes_1.html +html/search/classes_0.js +html/search/classes_0.html +html/search/all_f.js +html/search/all_f.html +html/search/all_e.js +html/search/all_e.html +html/search/all_d.js +html/search/all_d.html +html/search/all_c.js +html/search/all_c.html +html/search/all_b.js +html/search/all_b.html +html/search/all_a.js +html/search/all_a.html +html/search/all_9.js +html/search/all_9.html +html/search/all_8.js +html/search/all_8.html +html/search/all_7.js +html/search/all_7.html +html/search/all_6.js +html/search/all_6.html +html/search/all_5.js +html/search/all_5.html +html/search/all_4.js +html/search/all_4.html +html/search/all_3.js +html/search/all_3.html +html/search/all_2.js +html/search/all_2.html +html/search/all_1a.js +html/search/all_1a.html +html/search/all_19.js +html/search/all_19.html +html/search/all_18.js +html/search/all_18.html +html/search/all_17.js +html/search/all_17.html +html/search/all_16.js +html/search/all_16.html +html/search/all_15.js +html/search/all_15.html +html/search/all_14.js +html/search/all_14.html +html/search/all_13.js +html/search/all_13.html +html/search/all_12.js +html/search/all_12.html +html/search/all_11.js +html/search/all_11.html +html/search/all_10.js +html/search/all_10.html +html/search/all_1.js +html/search/all_1.html +html/search/all_0.js +html/search/all_0.html +html/pages.html +html/open.png +html/netutil_8h_source.html +html/netutil_8h__incl.png +html/netutil_8h__incl.md5 +html/netutil_8h__incl.map +html/netutil_8h__dep__incl.png +html/netutil_8h__dep__incl.md5 +html/netutil_8h__dep__incl.map +html/netutil_8h.html +html/netutil_8c_source.html +html/netutil_8c__incl.png +html/netutil_8c__incl.md5 +html/netutil_8c__incl.map +html/netutil_8c.html +html/nav_h.png +html/nav_g.png +html/nav_f.png +html/mqtt__interface_8h_source.html +html/mqtt__interface_8h__dep__incl.png +html/mqtt__interface_8h__dep__incl.md5 +html/mqtt__interface_8h__dep__incl.map +html/mqtt__interface_8h.html +html/mqtt__interface_8c_source.html +html/mqtt__interface_8c__incl.png +html/mqtt__interface_8c__incl.md5 +html/mqtt__interface_8c__incl.map +html/mqtt__interface_8c.html +html/modules.html +html/menudata.js +html/menu.js +html/md__r_e_a_d_m_e.html +html/loopback_8h_source.html +html/loopback_8h__incl.png +html/loopback_8h__incl.md5 +html/loopback_8h__incl.map +html/loopback_8h__dep__incl.png +html/loopback_8h__dep__incl.md5 +html/loopback_8h__dep__incl.map +html/loopback_8h.html +html/loopback_8c_source.html +html/loopback_8c__incl.png +html/loopback_8c__incl.md5 +html/loopback_8c__incl.map +html/loopback_8c.html +html/license_8txt.html +html/jquery.js +html/index.html +html/http_util_8h_source.html +html/http_util_8h__incl.png +html/http_util_8h__incl.md5 +html/http_util_8h__incl.map +html/http_util_8h__dep__incl.png +html/http_util_8h__dep__incl.md5 +html/http_util_8h__dep__incl.map +html/http_util_8h.html +html/http_util_8c_source.html +html/http_util_8c__incl.png +html/http_util_8c__incl.md5 +html/http_util_8c__incl.map +html/http_util_8c.html +html/http_server_8h_source.html +html/http_server_8h__incl.png +html/http_server_8h__incl.md5 +html/http_server_8h__incl.map +html/http_server_8h__dep__incl.png +html/http_server_8h__dep__incl.md5 +html/http_server_8h__dep__incl.map +html/http_server_8h.html +html/http_server_8c_source.html +html/http_server_8c__incl.png +html/http_server_8c__incl.md5 +html/http_server_8c__incl.map +html/http_server_8c.html +html/http_parser_8h_source.html +html/http_parser_8h__incl.png +html/http_parser_8h__incl.md5 +html/http_parser_8h__incl.map +html/http_parser_8h__dep__incl.png +html/http_parser_8h__dep__incl.md5 +html/http_parser_8h__dep__incl.map +html/http_parser_8h.html +html/http_parser_8c_source.html +html/http_parser_8c__incl.png +html/http_parser_8c__incl.md5 +html/http_parser_8c__incl.map +html/http_parser_8c.html +html/group__snmp__module.html +html/group__extra__functions.html +html/group___w_i_znet__socket___a_p_is.html +html/group___w_i_z_c_h_i_p__register___w5300.png +html/group___w_i_z_c_h_i_p__register___w5300.md5 +html/group___w_i_z_c_h_i_p__register___w5300.map +html/group___w_i_z_c_h_i_p__register___w5300.html +html/group___w_i_z_c_h_i_p__register___w5200.png +html/group___w_i_z_c_h_i_p__register___w5200.md5 +html/group___w_i_z_c_h_i_p__register___w5200.map +html/group___w_i_z_c_h_i_p__register___w5200.html +html/group___w_i_z_c_h_i_p__register___w5100_s.png +html/group___w_i_z_c_h_i_p__register___w5100_s.md5 +html/group___w_i_z_c_h_i_p__register___w5100_s.map +html/group___w_i_z_c_h_i_p__register___w5100_s.html +html/group___w_i_z_c_h_i_p__register___w5100.png +html/group___w_i_z_c_h_i_p__register___w5100.md5 +html/group___w_i_z_c_h_i_p__register___w5100.map +html/group___w_i_z_c_h_i_p__register___w5100.html +html/group___w_i_z_c_h_i_p__register.png +html/group___w_i_z_c_h_i_p__register.md5 +html/group___w_i_z_c_h_i_p__register.map +html/group___w_i_z_c_h_i_p__register.html +html/group___w_i_z_c_h_i_p___i_o___functions___w5300.png +html/group___w_i_z_c_h_i_p___i_o___functions___w5300.md5 +html/group___w_i_z_c_h_i_p___i_o___functions___w5300.map +html/group___w_i_z_c_h_i_p___i_o___functions___w5300.html +html/group___w_i_z_c_h_i_p___i_o___functions___w5200.png +html/group___w_i_z_c_h_i_p___i_o___functions___w5200.md5 +html/group___w_i_z_c_h_i_p___i_o___functions___w5200.map +html/group___w_i_z_c_h_i_p___i_o___functions___w5200.html +html/group___w_i_z_c_h_i_p___i_o___functions___w5100_s.png +html/group___w_i_z_c_h_i_p___i_o___functions___w5100_s.md5 +html/group___w_i_z_c_h_i_p___i_o___functions___w5100_s.map +html/group___w_i_z_c_h_i_p___i_o___functions___w5100_s.html +html/group___w_i_z_c_h_i_p___i_o___functions___w5100.png +html/group___w_i_z_c_h_i_p___i_o___functions___w5100.md5 +html/group___w_i_z_c_h_i_p___i_o___functions___w5100.map +html/group___w_i_z_c_h_i_p___i_o___functions___w5100.html +html/group___w_i_z_c_h_i_p___i_o___functions.png +html/group___w_i_z_c_h_i_p___i_o___functions.md5 +html/group___w_i_z_c_h_i_p___i_o___functions.map +html/group___w_i_z_c_h_i_p___i_o___functions.html +html/group___w5500.png +html/group___w5500.md5 +html/group___w5500.map +html/group___w5500.html +html/group___w5300.png +html/group___w5300.md5 +html/group___w5300.map +html/group___w5300.html +html/group___w5200.png +html/group___w5200.md5 +html/group___w5200.map +html/group___w5200.html +html/group___w5100_s.png +html/group___w5100_s.md5 +html/group___w5100_s.map +html/group___w5100_s.html +html/group___w5100.png +html/group___w5100.md5 +html/group___w5100.map +html/group___w5100.html +html/group___special__function___w5100_s.png +html/group___special__function___w5100_s.md5 +html/group___special__function___w5100_s.map +html/group___special__function___w5100_s.html +html/group___socket__register__group___w5300.png +html/group___socket__register__group___w5300.md5 +html/group___socket__register__group___w5300.map +html/group___socket__register__group___w5300.html +html/group___socket__register__group___w5200.png +html/group___socket__register__group___w5200.md5 +html/group___socket__register__group___w5200.map +html/group___socket__register__group___w5200.html +html/group___socket__register__group___w5100_s.png +html/group___socket__register__group___w5100_s.md5 +html/group___socket__register__group___w5100_s.map +html/group___socket__register__group___w5100_s.html +html/group___socket__register__group___w5100.png +html/group___socket__register__group___w5100.md5 +html/group___socket__register__group___w5100.map +html/group___socket__register__group___w5100.html +html/group___socket__register__group.png +html/group___socket__register__group.md5 +html/group___socket__register__group.map +html/group___socket__register__group.html +html/group___socket__register__access__function___w5300.png +html/group___socket__register__access__function___w5300.md5 +html/group___socket__register__access__function___w5300.map +html/group___socket__register__access__function___w5300.html +html/group___socket__register__access__function___w5200.png +html/group___socket__register__access__function___w5200.md5 +html/group___socket__register__access__function___w5200.map +html/group___socket__register__access__function___w5200.html +html/group___socket__register__access__function___w5100_s.png +html/group___socket__register__access__function___w5100_s.md5 +html/group___socket__register__access__function___w5100_s.map +html/group___socket__register__access__function___w5100_s.html +html/group___socket__register__access__function___w5100.png +html/group___socket__register__access__function___w5100.md5 +html/group___socket__register__access__function___w5100.map +html/group___socket__register__access__function___w5100.html +html/group___socket__register__access__function.png +html/group___socket__register__access__function.md5 +html/group___socket__register__access__function.map +html/group___socket__register__access__function.html +html/group___d_a_t_a___t_y_p_e.html +html/group___common__register__group___w5300.png +html/group___common__register__group___w5300.md5 +html/group___common__register__group___w5300.map +html/group___common__register__group___w5300.html +html/group___common__register__group___w5200.png +html/group___common__register__group___w5200.md5 +html/group___common__register__group___w5200.map +html/group___common__register__group___w5200.html +html/group___common__register__group___w5100_s.png +html/group___common__register__group___w5100_s.md5 +html/group___common__register__group___w5100_s.map +html/group___common__register__group___w5100_s.html +html/group___common__register__group___w5100.png +html/group___common__register__group___w5100.md5 +html/group___common__register__group___w5100.map +html/group___common__register__group___w5100.html +html/group___common__register__group.png +html/group___common__register__group.md5 +html/group___common__register__group.map +html/group___common__register__group.html +html/group___common__register__access__function___w5300.png +html/group___common__register__access__function___w5300.md5 +html/group___common__register__access__function___w5300.map +html/group___common__register__access__function___w5300.html +html/group___common__register__access__function___w5200.png +html/group___common__register__access__function___w5200.md5 +html/group___common__register__access__function___w5200.map +html/group___common__register__access__function___w5200.html +html/group___common__register__access__function___w5100_s.png +html/group___common__register__access__function___w5100_s.md5 +html/group___common__register__access__function___w5100_s.map +html/group___common__register__access__function___w5100_s.html +html/group___common__register__access__function___w5100.png +html/group___common__register__access__function___w5100.md5 +html/group___common__register__access__function___w5100.map +html/group___common__register__access__function___w5100.html +html/group___common__register__access__function.png +html/group___common__register__access__function.md5 +html/group___common__register__access__function.map +html/group___common__register__access__function.html +html/group___basic___i_o__function___w5300.png +html/group___basic___i_o__function___w5300.md5 +html/group___basic___i_o__function___w5300.map +html/group___basic___i_o__function___w5300.html +html/group___basic___i_o__function___w5200.png +html/group___basic___i_o__function___w5200.md5 +html/group___basic___i_o__function___w5200.map +html/group___basic___i_o__function___w5200.html +html/group___basic___i_o__function___w5100_s.png +html/group___basic___i_o__function___w5100_s.md5 +html/group___basic___i_o__function___w5100_s.map +html/group___basic___i_o__function___w5100_s.html +html/group___basic___i_o__function___w5100.png +html/group___basic___i_o__function___w5100.md5 +html/group___basic___i_o__function___w5100.map +html/group___basic___i_o__function___w5100.html +html/group___basic___i_o__function.png +html/group___basic___i_o__function.md5 +html/group___basic___i_o__function.map +html/group___basic___i_o__function.html +html/graph_legend.png +html/graph_legend.md5 +html/graph_legend.html +html/globals_x.html +html/globals_w.html +html/globals_vars.html +html/globals_v.html +html/globals_u.html +html/globals_type.html +html/globals_t.html +html/globals_s.html +html/globals_r.html +html/globals_q.html +html/globals_p.html +html/globals_o.html +html/globals_n.html +html/globals_m.html +html/globals_l.html +html/globals_k.html +html/globals_i.html +html/globals_h.html +html/globals_g.html +html/globals_func_w.html +html/globals_func_u.html +html/globals_func_t.html +html/globals_func_s.html +html/globals_func_r.html +html/globals_func_p.html +html/globals_func_n.html +html/globals_func_m.html +html/globals_func_l.html +html/globals_func_k.html +html/globals_func_i.html +html/globals_func_h.html +html/globals_func_g.html +html/globals_func_f.html +html/globals_func_d.html +html/globals_func_c.html +html/globals_func_b.html +html/globals_func.html +html/globals_f.html +html/globals_eval_x.html +html/globals_eval_v.html +html/globals_eval_u.html +html/globals_eval_t.html +html/globals_eval_s.html +html/globals_eval_r.html +html/globals_eval_q.html +html/globals_eval_p.html +html/globals_eval_n.html +html/globals_eval_m.html +html/globals_eval_l.html +html/globals_eval_i.html +html/globals_eval_h.html +html/globals_eval_f.html +html/globals_eval_e.html +html/globals_eval_d.html +html/globals_eval_c.html +html/globals_eval_b.html +html/globals_eval.html +html/globals_enum.html +html/globals_e.html +html/globals_defs_w.html +html/globals_defs_v.html +html/globals_defs_u.html +html/globals_defs_t.html +html/globals_defs_s.html +html/globals_defs_r.html +html/globals_defs_q.html +html/globals_defs_p.html +html/globals_defs_o.html +html/globals_defs_n.html +html/globals_defs_m.html +html/globals_defs_l.html +html/globals_defs_i.html +html/globals_defs_h.html +html/globals_defs_g.html +html/globals_defs_f.html +html/globals_defs_e.html +html/globals_defs_d.html +html/globals_defs_c.html +html/globals_defs_b.html +html/globals_defs_a.html +html/globals_defs.html +html/globals_d.html +html/globals_c.html +html/globals_b.html +html/globals_a.html +html/globals.html +html/functions_y.html +html/functions_x.html +html/functions_w.html +html/functions_vars_y.html +html/functions_vars_x.html +html/functions_vars_w.html +html/functions_vars_v.html +html/functions_vars_u.html +html/functions_vars_t.html +html/functions_vars_s.html +html/functions_vars_r.html +html/functions_vars_q.html +html/functions_vars_p.html +html/functions_vars_o.html +html/functions_vars_n.html +html/functions_vars_m.html +html/functions_vars_l.html +html/functions_vars_k.html +html/functions_vars_i.html +html/functions_vars_h.html +html/functions_vars_g.html +html/functions_vars_f.html +html/functions_vars_e.html +html/functions_vars_d.html +html/functions_vars_c.html +html/functions_vars_b.html +html/functions_vars_a.html +html/functions_vars.html +html/functions_v.html +html/functions_u.html +html/functions_t.html +html/functions_s.html +html/functions_r.html +html/functions_q.html +html/functions_p.html +html/functions_o.html +html/functions_n.html +html/functions_m.html +html/functions_l.html +html/functions_k.html +html/functions_i.html +html/functions_h.html +html/functions_g.html +html/functions_f.html +html/functions_e.html +html/functions_d.html +html/functions_c.html +html/functions_b.html +html/functions_a.html +html/functions.html +html/ftpd_8h_source.html +html/ftpd_8h__incl.png +html/ftpd_8h__incl.md5 +html/ftpd_8h__incl.map +html/ftpd_8h__dep__incl.png +html/ftpd_8h__dep__incl.md5 +html/ftpd_8h__dep__incl.map +html/ftpd_8h.html +html/ftpd_8c_source.html +html/ftpd_8c__incl.png +html/ftpd_8c__incl.md5 +html/ftpd_8c__incl.map +html/ftpd_8c.html +html/ftpc_8h_source.html +html/ftpc_8h__incl.png +html/ftpc_8h__incl.md5 +html/ftpc_8h__incl.map +html/ftpc_8h__dep__incl.png +html/ftpc_8h__dep__incl.md5 +html/ftpc_8h__dep__incl.map +html/ftpc_8h.html +html/ftpc_8c_source.html +html/ftpc_8c__incl.png +html/ftpc_8c__incl.md5 +html/ftpc_8c__incl.map +html/ftpc_8c.html +html/folderopen.png +html/folderclosed.png +html/files.html +html/dynsections.js +html/doxygen__log_8txt.html +html/doxygen.png +html/doxygen.css +html/doc.png +html/dns_8h_source.html +html/dns_8h__incl.png +html/dns_8h__incl.md5 +html/dns_8h__incl.map +html/dns_8h__dep__incl.png +html/dns_8h__dep__incl.md5 +html/dns_8h__dep__incl.map +html/dns_8h.html +html/dns_8c_source.html +html/dns_8c__incl.png +html/dns_8c__incl.md5 +html/dns_8c__incl.map +html/dns_8c.html +html/dir_fe682d1d76c251404f71241aa833642c_dep.png +html/dir_fe682d1d76c251404f71241aa833642c_dep.md5 +html/dir_fe682d1d76c251404f71241aa833642c_dep.map +html/dir_fe682d1d76c251404f71241aa833642c.html +html/dir_fca0adf6655fb1759a15e5776097c124_dep.png +html/dir_fca0adf6655fb1759a15e5776097c124_dep.md5 +html/dir_fca0adf6655fb1759a15e5776097c124_dep.map +html/dir_fca0adf6655fb1759a15e5776097c124.html +html/dir_f841453af36a2df9a2123f87589fe4f8_dep.png +html/dir_f841453af36a2df9a2123f87589fe4f8_dep.md5 +html/dir_f841453af36a2df9a2123f87589fe4f8_dep.map +html/dir_f841453af36a2df9a2123f87589fe4f8.html +html/dir_f10a527ab5b3936e2edf95a019a13ec7_dep.png +html/dir_f10a527ab5b3936e2edf95a019a13ec7_dep.md5 +html/dir_f10a527ab5b3936e2edf95a019a13ec7_dep.map +html/dir_f10a527ab5b3936e2edf95a019a13ec7.html +html/dir_eb1463819d84903762eb6f59cc0c4383_dep.png +html/dir_eb1463819d84903762eb6f59cc0c4383_dep.md5 +html/dir_eb1463819d84903762eb6f59cc0c4383_dep.map +html/dir_eb1463819d84903762eb6f59cc0c4383.html +html/dir_e5121bff4754a4ad570fa548a998f0c5_dep.png +html/dir_e5121bff4754a4ad570fa548a998f0c5_dep.md5 +html/dir_e5121bff4754a4ad570fa548a998f0c5_dep.map +html/dir_e5121bff4754a4ad570fa548a998f0c5.html +html/dir_b88037d6581d528000057b4eaec3e673_dep.png +html/dir_b88037d6581d528000057b4eaec3e673_dep.md5 +html/dir_b88037d6581d528000057b4eaec3e673_dep.map +html/dir_b88037d6581d528000057b4eaec3e673.html +html/dir_a5a06f90a751e77147778694c516f622_dep.png +html/dir_a5a06f90a751e77147778694c516f622_dep.md5 +html/dir_a5a06f90a751e77147778694c516f622_dep.map +html/dir_a5a06f90a751e77147778694c516f622.html +html/dir_a483286db9c12f74c7364bdaa9e78c36_dep.png +html/dir_a483286db9c12f74c7364bdaa9e78c36_dep.md5 +html/dir_a483286db9c12f74c7364bdaa9e78c36_dep.map +html/dir_a483286db9c12f74c7364bdaa9e78c36.html +html/dir_a138ed074e64356ad02dbb8d94382c4f_dep.png +html/dir_a138ed074e64356ad02dbb8d94382c4f_dep.md5 +html/dir_a138ed074e64356ad02dbb8d94382c4f_dep.map +html/dir_a138ed074e64356ad02dbb8d94382c4f.html +html/dir_97b8cbb23222306012bd2d84398746c9_dep.png +html/dir_97b8cbb23222306012bd2d84398746c9_dep.md5 +html/dir_97b8cbb23222306012bd2d84398746c9_dep.map +html/dir_97b8cbb23222306012bd2d84398746c9.html +html/dir_6e6e4d5e89221ed61dd87b2954f72a78_dep.png +html/dir_6e6e4d5e89221ed61dd87b2954f72a78_dep.md5 +html/dir_6e6e4d5e89221ed61dd87b2954f72a78_dep.map +html/dir_6e6e4d5e89221ed61dd87b2954f72a78.html +html/dir_6de1940466803d61d2f9d1259cb01031.html +html/dir_5a912e51f6f9520965e8671f07512599_dep.png +html/dir_5a912e51f6f9520965e8671f07512599_dep.md5 +html/dir_5a912e51f6f9520965e8671f07512599_dep.map +html/dir_5a912e51f6f9520965e8671f07512599.html +html/dir_4c7002aef9ece892c0aedd728ed93eff.html +html/dir_498fbcdef69ea105b96b8673d051b2e3_dep.png +html/dir_498fbcdef69ea105b96b8673d051b2e3_dep.md5 +html/dir_498fbcdef69ea105b96b8673d051b2e3_dep.map +html/dir_498fbcdef69ea105b96b8673d051b2e3.html +html/dir_46819ec1095f3903911c103f5ebbb29f_dep.png +html/dir_46819ec1095f3903911c103f5ebbb29f_dep.md5 +html/dir_46819ec1095f3903911c103f5ebbb29f_dep.map +html/dir_46819ec1095f3903911c103f5ebbb29f.html +html/dir_4396dcc0e095a5bc10b1affe087807cf_dep.png +html/dir_4396dcc0e095a5bc10b1affe087807cf_dep.md5 +html/dir_4396dcc0e095a5bc10b1affe087807cf_dep.map +html/dir_4396dcc0e095a5bc10b1affe087807cf.html +html/dir_337e147d8ae2958ef29ccaa8e2f968db_dep.png +html/dir_337e147d8ae2958ef29ccaa8e2f968db_dep.md5 +html/dir_337e147d8ae2958ef29ccaa8e2f968db_dep.map +html/dir_337e147d8ae2958ef29ccaa8e2f968db.html +html/dir_2c7bb40a7e5a6685f00216dd2909cd99_dep.png +html/dir_2c7bb40a7e5a6685f00216dd2909cd99_dep.md5 +html/dir_2c7bb40a7e5a6685f00216dd2909cd99_dep.map +html/dir_2c7bb40a7e5a6685f00216dd2909cd99.html +html/dir_2c1dd796c287ab9a5cf44281d8a3cbeb.html +html/dir_072fcb7a67163ce1d8f22ad4144c7e08.html +html/dir_000020_000002.html +html/dir_000019_000002.html +html/dir_000018_000002.html +html/dir_000017_000002.html +html/dir_000015_000016.html +html/dir_000015_000002.html +html/dir_000014_000015.html +html/dir_000014_000002.html +html/dir_000013_000002.html +html/dir_000012_000002.html +html/dir_000011_000002.html +html/dir_000010_000002.html +html/dir_000009_000002.html +html/dir_000002_000007.html +html/dir_000002_000004.html +html/dir_000001_000002.html +html/dhcp_8h_source.html +html/dhcp_8h__dep__incl.png +html/dhcp_8h__dep__incl.md5 +html/dhcp_8h__dep__incl.map +html/dhcp_8h.html +html/dhcp_8c_source.html +html/dhcp_8c__incl.png +html/dhcp_8c__incl.md5 +html/dhcp_8c__incl.map +html/dhcp_8c.html +html/closed.png +html/classes.html +html/bdwn.png +html/bc_s.png +html/annotated.html +html/_w_i_znet___s_o_c_k_e_t_8jpg_source.html +html/_w_i_znet___s_o_c_k_e_t_8jpg.html +html/_stack_trace_8h_source.html +html/_stack_trace_8h__incl.png +html/_stack_trace_8h__incl.md5 +html/_stack_trace_8h__incl.map +html/_stack_trace_8h__dep__incl.png +html/_stack_trace_8h__dep__incl.md5 +html/_stack_trace_8h__dep__incl.map +html/_stack_trace_8h.html +html/_readme_8txt.html +html/_r_e_a_d_m_e_8md_source.html +html/_r_e_a_d_m_e_8md.html +html/_main__page_8txt.html +html/_m_q_t_t_unsubscribe_server_8c_source.html +html/_m_q_t_t_unsubscribe_server_8c__incl.png +html/_m_q_t_t_unsubscribe_server_8c__incl.md5 +html/_m_q_t_t_unsubscribe_server_8c__incl.map +html/_m_q_t_t_unsubscribe_server_8c.html +html/_m_q_t_t_unsubscribe_client_8c_source.html +html/_m_q_t_t_unsubscribe_client_8c__incl.png +html/_m_q_t_t_unsubscribe_client_8c__incl.md5 +html/_m_q_t_t_unsubscribe_client_8c__incl.map +html/_m_q_t_t_unsubscribe_client_8c.html +html/_m_q_t_t_unsubscribe_8h_source.html +html/_m_q_t_t_unsubscribe_8h__dep__incl.png +html/_m_q_t_t_unsubscribe_8h__dep__incl.md5 +html/_m_q_t_t_unsubscribe_8h__dep__incl.map +html/_m_q_t_t_unsubscribe_8h.html +html/_m_q_t_t_subscribe_server_8c_source.html +html/_m_q_t_t_subscribe_server_8c__incl.png +html/_m_q_t_t_subscribe_server_8c__incl.md5 +html/_m_q_t_t_subscribe_server_8c__incl.map +html/_m_q_t_t_subscribe_server_8c.html +html/_m_q_t_t_subscribe_client_8c_source.html +html/_m_q_t_t_subscribe_client_8c__incl.png +html/_m_q_t_t_subscribe_client_8c__incl.md5 +html/_m_q_t_t_subscribe_client_8c__incl.map +html/_m_q_t_t_subscribe_client_8c.html +html/_m_q_t_t_subscribe_8h_source.html +html/_m_q_t_t_subscribe_8h__dep__incl.png +html/_m_q_t_t_subscribe_8h__dep__incl.md5 +html/_m_q_t_t_subscribe_8h__dep__incl.map +html/_m_q_t_t_subscribe_8h.html +html/_m_q_t_t_serialize_publish_8c_source.html +html/_m_q_t_t_serialize_publish_8c__incl.png +html/_m_q_t_t_serialize_publish_8c__incl.md5 +html/_m_q_t_t_serialize_publish_8c__incl.map +html/_m_q_t_t_serialize_publish_8c.html +html/_m_q_t_t_publish_8h_source.html +html/_m_q_t_t_publish_8h__dep__incl.png +html/_m_q_t_t_publish_8h__dep__incl.md5 +html/_m_q_t_t_publish_8h__dep__incl.map +html/_m_q_t_t_publish_8h.html +html/_m_q_t_t_packet_8h_source.html +html/_m_q_t_t_packet_8h__incl.png +html/_m_q_t_t_packet_8h__incl.md5 +html/_m_q_t_t_packet_8h__incl.map +html/_m_q_t_t_packet_8h__dep__incl.png +html/_m_q_t_t_packet_8h__dep__incl.md5 +html/_m_q_t_t_packet_8h__dep__incl.map +html/_m_q_t_t_packet_8h.html +html/_m_q_t_t_packet_8c_source.html +html/_m_q_t_t_packet_8c__incl.png +html/_m_q_t_t_packet_8c__incl.md5 +html/_m_q_t_t_packet_8c__incl.map +html/_m_q_t_t_packet_8c.html +html/_m_q_t_t_format_8h_source.html +html/_m_q_t_t_format_8h__incl.png +html/_m_q_t_t_format_8h__incl.md5 +html/_m_q_t_t_format_8h__incl.map +html/_m_q_t_t_format_8h__dep__incl.png +html/_m_q_t_t_format_8h__dep__incl.md5 +html/_m_q_t_t_format_8h__dep__incl.map +html/_m_q_t_t_format_8h.html +html/_m_q_t_t_format_8c_source.html +html/_m_q_t_t_format_8c__incl.png +html/_m_q_t_t_format_8c__incl.md5 +html/_m_q_t_t_format_8c__incl.map +html/_m_q_t_t_format_8c.html +html/_m_q_t_t_deserialize_publish_8c_source.html +html/_m_q_t_t_deserialize_publish_8c__incl.png +html/_m_q_t_t_deserialize_publish_8c__incl.md5 +html/_m_q_t_t_deserialize_publish_8c__incl.map +html/_m_q_t_t_deserialize_publish_8c.html +html/_m_q_t_t_connect_server_8c_source.html +html/_m_q_t_t_connect_server_8c__incl.png +html/_m_q_t_t_connect_server_8c__incl.md5 +html/_m_q_t_t_connect_server_8c__incl.map +html/_m_q_t_t_connect_server_8c.html +html/_m_q_t_t_connect_client_8c_source.html +html/_m_q_t_t_connect_client_8c__incl.png +html/_m_q_t_t_connect_client_8c__incl.md5 +html/_m_q_t_t_connect_client_8c__incl.map +html/_m_q_t_t_connect_client_8c.html +html/_m_q_t_t_connect_8h_source.html +html/_m_q_t_t_connect_8h__dep__incl.png +html/_m_q_t_t_connect_8h__dep__incl.md5 +html/_m_q_t_t_connect_8h__dep__incl.map +html/_m_q_t_t_connect_8h.html +html/_m_q_t_t_client_8h_source.html +html/_m_q_t_t_client_8h__incl.png +html/_m_q_t_t_client_8h__incl.md5 +html/_m_q_t_t_client_8h__incl.map +html/_m_q_t_t_client_8h__dep__incl.png +html/_m_q_t_t_client_8h__dep__incl.md5 +html/_m_q_t_t_client_8h__dep__incl.map +html/_m_q_t_t_client_8h.html +html/_m_q_t_t_client_8c_source.html +html/_m_q_t_t_client_8c__incl.png +html/_m_q_t_t_client_8c__incl.md5 +html/_m_q_t_t_client_8c__incl.map +html/_m_q_t_t_client_8c.html +html/_f_t_p_server_2stdio__private_8h_source.html +html/_f_t_p_server_2stdio__private_8h__incl.png +html/_f_t_p_server_2stdio__private_8h__incl.md5 +html/_f_t_p_server_2stdio__private_8h__incl.map +html/_f_t_p_server_2stdio__private_8h__dep__incl.png +html/_f_t_p_server_2stdio__private_8h__dep__incl.md5 +html/_f_t_p_server_2stdio__private_8h__dep__incl.map +html/_f_t_p_server_2stdio__private_8h.html +html/_f_t_p_client_2stdio__private_8h_source.html +html/_f_t_p_client_2stdio__private_8h__incl.png +html/_f_t_p_client_2stdio__private_8h__incl.md5 +html/_f_t_p_client_2stdio__private_8h__incl.map +html/_f_t_p_client_2stdio__private_8h__dep__incl.png +html/_f_t_p_client_2stdio__private_8h__dep__incl.md5 +html/_f_t_p_client_2stdio__private_8h__dep__incl.map +html/_f_t_p_client_2stdio__private_8h.html +html/_berkeley___s_o_c_k_e_t_8jpg_source.html +html/_berkeley___s_o_c_k_e_t_8jpg.html +html/WIZnet_SOCKET.jpg +html/Berkeley_SOCKET.jpg +Main_page.txt +Doxyfile +man/man3/sntp.c.3 +man/man3/snmp_module.3 +man/man3/snmp_custom.h.3 +man/man3/snmp_custom.c.3 +man/man3/snmp.h.3 +man/man3/snmp.c.3 +man/man3/netutil.h.3 +man/man3/netutil.c.3 +man/man3/mqtt_interface.h.3 +man/man3/mqtt_interface.c.3 +man/man3/messageStruct.3 +man/man3/md__r_e_a_d_m_e.3 +man/man3/loopback.h.3 +man/man3/loopback.c.3 +man/man3/license.txt.3 +man/man3/httpUtil.h.3 +man/man3/_datetime.3 +man/man3/__file.3 +man/man3/__WIZCHIP__IF.3 +man/man3/__WIZCHIP__CS.3 +man/man3/__WIZCHIP__CRIS.3 +man/man3/__WIZCHIP.3 +man/man3/WIZnet_socket_APIs.3 +man/man3/WIZnet_SOCKET.jpg.3 +man/man3/WIZCHIP_register.3 +man/man3/WIZCHIP_IO_Functions_W5300.3 +man/man3/WIZCHIP_IO_Functions_W5200.3 +man/man3/WIZCHIP_IO_Functions_W5100S.3 +man/man3/W5500.3 +man/man3/W5300.3 +man/man3/W5100S.3 +man/man3/w5200.c.3 +man/man3/w5100s.h.3 +man/man3/w5100s.c.3 +man/man3/w5100.h.3 +man/man3/w5100.c.3 +man/man3/todo.3 +man/man3/tlvStructType.3 +man/man3/tftp_option.3 +man/man3/tftp_error.3 +man/man3/tftp_data.3 +man/man3/tftp.h.3 +man/man3/tftp.c.3 +man/man3/stdio_private.h.3 +man/man3/socket.h.3 +man/man3/socket.c.3 +man/man3/sntp.h.3 +man/man3/httpUtil.c.3 +man/man3/httpServer.h.3 +man/man3/httpServer.c.3 +man/man3/httpParser.h.3 +man/man3/httpParser.c.3 +man/man3/ftpd.h.3 +man/man3/ftpd.c.3 +man/man3/ftpd.3 +man/man3/WIZCHIP_register_W5300.3 +man/man3/WIZCHIP_register_W5200.3 +man/man3/WIZCHIP_register_W5100S.3 +man/man3/WIZCHIP_register_W5100.3 +man/man3/WIZCHIP_IO_Functions_W5100.3 +man/man3/WIZCHIP_IO_Functions.3 +man/man3/W5200.3 diff --git a/.gitmodules b/.gitmodules new file mode 100644 index 0000000..e69de29 diff --git a/Application/Application.h b/Application/Application.h new file mode 100644 index 0000000..6053690 --- /dev/null +++ b/Application/Application.h @@ -0,0 +1,18 @@ +#ifndef _APPLICATION_H_ +#define _APPLICATION_H_ + +#include + + +#define SOCK_TCP4 (Sn_MR_TCP) +#define SOCK_TCP6 (Sn_MR_TCP6) +#define SOCK_TCPD (Sn_MR_TCPD) + +#define SOCK_UDP4 (Sn_MR_UDP4) +#define SOCK_UDP6 (Sn_MR_UDP6) +#define SOCK_UDPD (Sn_MR_UDPD) + +#define AS_IPV4 2 +#define AS_IPV6 23 +#define AS_IPDUAL 11 +#endif diff --git a/Application/loopback/loopback.c b/Application/loopback/loopback.c new file mode 100644 index 0000000..a199755 --- /dev/null +++ b/Application/loopback/loopback.c @@ -0,0 +1,1029 @@ +#include +#include "loopback.h" +#include "socket.h" +#include "wizchip_conf.h" + + +#if LOOPBACK_MODE == LOOPBACK_MAIN_NOBLCOK + + +static int8_t loopback_mode = 0 ; + + + + + +#if (_WIZCHIP_ == W5100 || _WIZCHIP_ == W5100S || _WIZCHIP_ == W5200 || _WIZCHIP_ == W5300 || _WIZCHIP_ == W5500) +int32_t loopback_tcps(uint8_t sn, uint8_t* buf, uint16_t port) { + int32_t ret; + uint16_t size = 0, sentsize = 0; + +#ifdef _LOOPBACK_DEBUG_ + uint8_t destip[4]; + uint16_t destport; +#endif + + switch (getSn_SR(sn)) { + case SOCK_ESTABLISHED : + if (getSn_IR(sn) & Sn_IR_CON) { +#ifdef _LOOPBACK_DEBUG_ + getSn_DIPR(sn, destip); + destport = getSn_DPORT(sn); + + printf("%d:Connected - %d.%d.%d.%d : %d\r\n", sn, destip[0], destip[1], destip[2], destip[3], destport); +#endif + setSn_IR(sn, Sn_IR_CON); + } + if ((size = getSn_RX_RSR(sn)) > 0) { // Don't need to check SOCKERR_BUSY because it doesn't not occur. + if (size > DATA_BUF_SIZE) { + size = DATA_BUF_SIZE; + } + ret = recv(sn, buf, size); + + if (ret <= 0) { + return ret; // check SOCKERR_BUSY & SOCKERR_XXX. For showing the occurrence of SOCKERR_BUSY. + } + size = (uint16_t) ret; + sentsize = 0; + + while (size != sentsize) { + ret = send(sn, buf + sentsize, size - sentsize); + if (ret < 0) { + close(sn); + return ret; + } + sentsize += ret; // Don't care SOCKERR_BUSY, because it is zero. + } + } + break; + case SOCK_CLOSE_WAIT : +#ifdef _LOOPBACK_DEBUG_ + //printf("%d:CloseWait\r\n",sn); +#endif + if ((ret = disconnect(sn)) != SOCK_OK) { + return ret; + } +#ifdef _LOOPBACK_DEBUG_ + printf("%d:Socket Closed\r\n", sn); +#endif + break; + case SOCK_INIT : +#ifdef _LOOPBACK_DEBUG_ + printf("%d:Listen, TCP server loopback, port [%d]\r\n", sn, port); +#endif + if ((ret = listen(sn)) != SOCK_OK) { + return ret; + } + break; + case SOCK_CLOSED: +#ifdef _LOOPBACK_DEBUG_ + //printf("%d:TCP server loopback start\r\n",sn); +#endif + if ((ret = socket(sn, Sn_MR_TCP, port, 0x00)) != sn) { + return ret; + } +#ifdef _LOOPBACK_DEBUG_ + //printf("%d:Socket opened\r\n",sn); +#endif + break; + default: + break; + } + return 1; +} + + +int32_t loopback_tcpc(uint8_t sn, uint8_t* buf, uint8_t* destip, uint16_t destport) { + int32_t ret; // return value for SOCK_ERRORs + uint16_t size = 0, sentsize = 0; + + // Destination (TCP Server) IP info (will be connected) + // >> loopback_tcpc() function parameter + // >> Ex) + // uint8_t destip[4] = {192, 168, 0, 214}; + // uint16_t destport = 5000; + + // Port number for TCP client (will be increased) + static uint16_t any_port = 50000; + + // Socket Status Transitions + // Check the W5500 Socket n status register (Sn_SR, The 'Sn_SR' controlled by Sn_CR command or Packet send/recv status) + switch (getSn_SR(sn)) { + case SOCK_ESTABLISHED : + if (getSn_IR(sn) & Sn_IR_CON) { // Socket n interrupt register mask; TCP CON interrupt = connection with peer is successful +#ifdef _LOOPBACK_DEBUG_ + printf("%d:Connected to - %d.%d.%d.%d : %d\r\n", sn, destip[0], destip[1], destip[2], destip[3], destport); +#endif + setSn_IR(sn, Sn_IR_CON); // this interrupt should be write the bit cleared to '1' + } + + ////////////////////////////////////////////////////////////////////////////////////////////// + // Data Transaction Parts; Handle the [data receive and send] process + ////////////////////////////////////////////////////////////////////////////////////////////// + if ((size = getSn_RX_RSR(sn)) > 0) { // Sn_RX_RSR: Socket n Received Size Register, Receiving data length + if (size > DATA_BUF_SIZE) { + size = DATA_BUF_SIZE; // DATA_BUF_SIZE means user defined buffer size (array) + } + ret = recv(sn, buf, size); // Data Receive process (H/W Rx socket buffer -> User's buffer) + + if (ret <= 0) { + return ret; // If the received data length <= 0, receive failed and process end + } + size = (uint16_t) ret; + sentsize = 0; + + // Data sentsize control + while (size != sentsize) { + ret = send(sn, buf + sentsize, size - sentsize); // Data send process (User's buffer -> Destination through H/W Tx socket buffer) + if (ret < 0) { // Send Error occurred (sent data length < 0) + close(sn); // socket close + return ret; + } + sentsize += ret; // Don't care SOCKERR_BUSY, because it is zero. + } + } + ////////////////////////////////////////////////////////////////////////////////////////////// + break; + + case SOCK_CLOSE_WAIT : +#ifdef _LOOPBACK_DEBUG_ + //printf("%d:CloseWait\r\n",sn); +#endif + if ((ret = disconnect(sn)) != SOCK_OK) { + return ret; + } +#ifdef _LOOPBACK_DEBUG_ + printf("%d:Socket Closed\r\n", sn); +#endif + break; + + case SOCK_INIT : +#ifdef _LOOPBACK_DEBUG_ + printf("%d:Try to connect to the %d.%d.%d.%d : %d\r\n", sn, destip[0], destip[1], destip[2], destip[3], destport); +#endif + if ((ret = connect(sn, destip, destport)) != SOCK_OK) { + return ret; // Try to TCP connect to the TCP server (destination) + } + break; + + case SOCK_CLOSED: + close(sn); + if ((ret = socket(sn, Sn_MR_TCP, any_port++, 0x00)) != sn) { + if (any_port == 0xffff) { + any_port = 50000; + } + return ret; // TCP socket open with 'any_port' port number + } +#ifdef _LOOPBACK_DEBUG_ + //printf("%d:TCP client loopback start\r\n",sn); + //printf("%d:Socket opened\r\n",sn); +#endif + break; + default: + break; + } + return 1; +} + + +int32_t loopback_udps(uint8_t sn, uint8_t* buf, uint16_t port) { + int32_t ret; + uint16_t size, sentsize; + uint8_t destip[4]; + uint16_t destport; + + switch (getSn_SR(sn)) { + case SOCK_UDP : + if ((size = getSn_RX_RSR(sn)) > 0) { + if (size > DATA_BUF_SIZE) { + size = DATA_BUF_SIZE; + } + ret = recvfrom(sn, buf, size, destip, (uint16_t*)&destport); + if (ret <= 0) { +#ifdef _LOOPBACK_DEBUG_ + printf("%d: recvfrom error. %ld\r\n", sn, ret); +#endif + return ret; + } + size = (uint16_t) ret; + sentsize = 0; + while (sentsize != size) { + ret = sendto(sn, buf + sentsize, size - sentsize, destip, destport); + if (ret < 0) { +#ifdef _LOOPBACK_DEBUG_ + printf("%d: sendto error. %ld\r\n", sn, ret); +#endif + return ret; + } + sentsize += ret; // Don't care SOCKERR_BUSY, because it is zero. + } + } + break; + case SOCK_CLOSED: +#ifdef _LOOPBACK_DEBUG_ + //printf("%d:UDP loopback start\r\n",sn); +#endif + if ((ret = socket(sn, Sn_MR_UDP, port, 0x00)) != sn) { + return ret; + } +#ifdef _LOOPBACK_DEBUG_ + printf("%d:Opened, UDP loopback, port [%d]\r\n", sn, port); +#endif + break; + default : + break; + } + return 1; +} +int32_t loopback_udpc(uint8_t sn, uint8_t* buf, uint8_t* destip, uint16_t destport) { + int32_t ret; + uint16_t size = 0, sentsize = 0; + static uint16_t any_port = 50000; + // uint8_t* strtest = "\r\nhello world"; + // uint8_t flag = 0; + switch (getSn_SR(sn)) { + case SOCK_UDP : + // sendto(sn, strtest, strlen(strtest), destip, destport); + if ((size = getSn_RX_RSR(sn)) > 0) { + if (size > DATA_BUF_SIZE) { + size = DATA_BUF_SIZE; + } + ret = recvfrom(sn, buf, size, destip, (uint16_t*)&destport); + buf[ret] = 0x00; + printf("recv form[%d.%d.%d.%d][%d]: %s\n", destip[0], destip[1], destip[2], destip[3], destport, buf); + if (ret <= 0) { +#ifdef _LOOPBACK_DEBUG_ + printf("%d: recvfrom error. %ld\r\n", sn, ret); +#endif + return ret; + } + size = (uint16_t) ret; + sentsize = 0; + while (sentsize != size) { + ret = sendto(sn, buf + sentsize, size - sentsize, destip, destport); + if (ret < 0) { +#ifdef _LOOPBACK_DEBUG_ + printf("%d: sendto error. %ld\r\n", sn, ret); +#endif + return ret; + } + sentsize += ret; // Don't care SOCKERR_BUSY, because it is zero. + } + } + break; + case SOCK_CLOSED: +#ifdef _LOOPBACK_DEBUG_ + // printf("%d:UDP loopback start\r\n",sn); +#endif + if ((ret = socket(sn, Sn_MR_UDP, any_port, 0x00)) != sn) { + return ret; + } +#ifdef _LOOPBACK_DEBUG_ + printf("%d:Opened, UDP loopback, port [%d]\r\n", sn, any_port); +#endif + break; + default : + break; + } + return 1; + +} + +//teddy 240122 + + + +#elif ((_WIZCHIP_ == 6100) || (_WIZCHIP_ == 6300)) + +int8_t set_loopback_mode_W6x00(uint8_t get_loopback_mode) { + loopback_mode = get_loopback_mode ; + return 0; +} + +int8_t check_loopback_mode_W6x00() { + if (loopback_mode != AS_IPV4 && loopback_mode != AS_IPV6 && loopback_mode != AS_IPDUAL) { + loopback_mode = AS_IPV4 ; + } + return loopback_mode; +} + +//static uint16_t j=0; +static uint16_t any_port = 50000; +static uint8_t curr_state[8] = {0,}; +static uint8_t sock_state[8] = {0,}; +uint8_t* msg_v4 = "IPv4 mode"; +uint8_t* msg_v6 = "IPv6 mode"; +uint8_t* msg_dual = "Dual IP mode"; + +int32_t loopback_tcps(uint8_t sn, uint8_t* buf, uint16_t port) { + // by Lihan 20241119 + check_loopback_mode_W6x00(); + int32_t ret; + uint16_t sentsize = 0; + int8_t status, inter; + uint8_t tmp = 0; + uint16_t received_size; + uint8_t arg_tmp8; + uint8_t* mode_msg; +#if 1 + // 20231018 taylor + uint8_t destip[16], sn_status; + uint16_t destport; +#endif + + if (loopback_mode == AS_IPV4) { + mode_msg = msg_v4; + } else if (loopback_mode == AS_IPV6) { + mode_msg = msg_v6; + } else { + mode_msg = msg_dual; + } +#ifdef _LOOPBACK_DEBUG_ + uint8_t dst_ip[16], ext_status; + uint16_t dst_port; +#endif + getsockopt(sn, SO_STATUS, &status); + switch (status) { + case SOCK_ESTABLISHED : + ctlsocket(sn, CS_GET_INTERRUPT, &inter); + if (inter & Sn_IR_CON) { +#ifdef _LOOPBACK_DEBUG_ + getsockopt(sn, SO_DESTIP, dst_ip); + getsockopt(sn, SO_EXTSTATUS, &ext_status); + if (ext_status & TCPSOCK_MODE) { + //IPv6 + printf("%d:Peer IP : %04X:%04X", sn, ((uint16_t)dst_ip[0] << 8) | ((uint16_t)dst_ip[1]), + ((uint16_t)dst_ip[2] << 8) | ((uint16_t)dst_ip[3])); + printf(":%04X:%04X", ((uint16_t)dst_ip[4] << 8) | ((uint16_t)dst_ip[5]), + ((uint16_t)dst_ip[6] << 8) | ((uint16_t)dst_ip[7])); + printf(":%04X:%04X", ((uint16_t)dst_ip[8] << 8) | ((uint16_t)dst_ip[9]), + ((uint16_t)dst_ip[10] << 8) | ((uint16_t)dst_ip[11])); + printf(":%04X:%04X, ", ((uint16_t)dst_ip[12] << 8) | ((uint16_t)dst_ip[13]), + ((uint16_t)dst_ip[14] << 8) | ((uint16_t)dst_ip[15])); + } else { + //IPv4 + //getSn_DIPR(sn,dst_ip); + printf("%d:Peer IP : %.3d.%.3d.%.3d.%.3d, ", + sn, dst_ip[0], dst_ip[1], dst_ip[2], dst_ip[3]); + } + getsockopt(sn, SO_DESTPORT, &dst_port); + printf("Peer Port : %d\r\n", dst_port); +#endif + arg_tmp8 = Sn_IR_CON; + ctlsocket(sn, CS_CLR_INTERRUPT, &arg_tmp8); + } + getsockopt(sn, SO_RECVBUF, &received_size); + + if (received_size > 0) { + if (received_size > DATA_BUF_SIZE) { + received_size = DATA_BUF_SIZE; + } + ret = recv(sn, buf, received_size); + +#if 1 + // 20231018 taylor +#ifdef _LOOPBACK_DEBUG_ + getsockopt(sn, SO_DESTIP, destip); + getsockopt(sn, SO_DESTPORT, &destport); + getsockopt(sn, SO_EXTSTATUS, &sn_status); + if (sn_status & TCPSOCK_MODE) { + printf("Socket %d Received %d bytes from %02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x port %d : \r\n", + sn, received_size, + destip[0], destip[1], destip[2], destip[3], + destip[4], destip[5], destip[6], destip[7], + destip[8], destip[9], destip[10], destip[11], + destip[12], destip[13], destip[14], destip[15], + destport); + } else { + printf("Socket %d Received %d bytes from %d.%d.%d.%d port %d : \r\n", sn, received_size, destip[0], destip[1], destip[2], destip[3], destport); + } + + int i; + for (i = 0; i < received_size; i++) { + printf("%c", buf[i]); + } + printf("\r\n"); +#endif +#endif + if (ret <= 0) { + return ret; // check SOCKERR_BUSY & SOCKERR_XXX. For showing the occurrence of SOCKERR_BUSY. + } + received_size = (uint16_t) ret; + sentsize = 0; + + while (received_size != sentsize) { + ret = send(sn, buf + sentsize, received_size - sentsize); + if (ret < 0) { + close(sn); + return ret; + } + sentsize += ret; // Don't care SOCKERR_BUSY, because it is zero. + } +#if 1 + // 20231018 taylor +#ifdef _LOOPBACK_DEBUG_ + if (sn_status & TCPSOCK_MODE) { + printf("Socket %d Sent back %d bytes from %02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x port %d : \r\n", + sn, sentsize, + destip[0], destip[1], destip[2], destip[3], + destip[4], destip[5], destip[6], destip[7], + destip[8], destip[9], destip[10], destip[11], + destip[12], destip[13], destip[14], destip[15], + destport); + } else { + printf("Socket %d Sent back %d bytes from %d.%d.%d.%d port %d : \r\n", sn, sentsize, destip[0], destip[1], destip[2], destip[3], destport); + } + + int j; + for (j = 0; j < sentsize; j++) { + printf("%c", buf[j]); + } + printf("\r\n"); +#endif +#endif + } + break; + case SOCK_CLOSE_WAIT : +#ifdef _LOOPBACK_DEBUG_ + printf("%d:CloseWait\r\n", sn); +#endif + getsockopt(sn, SO_RECVBUF, &received_size); + if (received_size > 0) { // Don't need to check SOCKERR_BUSY because it doesn't not occur. + if (received_size > DATA_BUF_SIZE) { + received_size = DATA_BUF_SIZE; + } + ret = recv(sn, buf, received_size); + + if (ret <= 0) { + return ret; // check SOCKERR_BUSY & SOCKERR_XXX. For showing the occurrence of SOCKERR_BUSY. + } + received_size = (uint16_t) ret; + sentsize = 0; + +#if 1 + // 20231018 taylor +#ifdef _LOOPBACK_DEBUG_ + getsockopt(sn, SO_DESTIP, destip); + getsockopt(sn, SO_DESTPORT, &destport); + getsockopt(sn, SO_EXTSTATUS, &sn_status); + if (sn_status & TCPSOCK_MODE) { + printf("Socket %d Received %d bytes from %02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x port %d : \r\n", + sn, received_size, + destip[0], destip[1], destip[2], destip[3], + destip[4], destip[5], destip[6], destip[7], + destip[8], destip[9], destip[10], destip[11], + destip[12], destip[13], destip[14], destip[15], + destport); + } else { + printf("Socket %d Received %d bytes from %d.%d.%d.%d port %d : \r\n", sn, received_size, destip[0], destip[1], destip[2], destip[3], destport); + } + + int i; + for (i = 0; i < received_size; i++) { + printf("%c", buf[i]); + } + printf("\r\n"); +#endif +#endif + + while (received_size != sentsize) { + ret = send(sn, buf + sentsize, received_size - sentsize); + if (ret < 0) { + close(sn); + return ret; + } + sentsize += ret; // Don't care SOCKERR_BUSY, because it is zero. + } +#if 1 + // 20231018 taylor +#ifdef _LOOPBACK_DEBUG_ + if (sn_status & TCPSOCK_MODE) { + printf("Socket %d Sent back %d bytes from %02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x port %d : \r\n", + sn, sentsize, + destip[0], destip[1], destip[2], destip[3], + destip[4], destip[5], destip[6], destip[7], + destip[8], destip[9], destip[10], destip[11], + destip[12], destip[13], destip[14], destip[15], + destport); + } else { + printf("Socket %d Sent back %d bytes from %d.%d.%d.%d port %d : \r\n", sn, sentsize, destip[0], destip[1], destip[2], destip[3], destport); + } + + int j; + for (j = 0; j < sentsize; j++) { + printf("%c", buf[j]); + } + printf("\r\n"); +#endif +#endif + } + + if ((ret = disconnect(sn)) != SOCK_OK) { + return ret; + } +#ifdef _LOOPBACK_DEBUG_ + printf("%d:Socket Closed\r\n", sn); +#endif + break; + case SOCK_INIT : + if ((ret = listen(sn)) != SOCK_OK) { + return ret; + } +#if 1 + // 20231018 taylor +#if 0 +#endif +#else +#ifdef _LOOPBACK_DEBUG_ + printf("%d:Listen, TCP server loopback, port [%d] as %s\r\n", sn, port, mode_msg); +#endif +#endif + printf("%d:Listen, TCP server loopback, port [%d] as %s\r\n", sn, port, mode_msg); + break; + case SOCK_CLOSED: +#ifdef _LOOPBACK_DEBUG_ + printf("%d:TCP server loopback start\r\n", sn); +#endif + switch (loopback_mode) { + case AS_IPV4: + tmp = socket(sn, Sn_MR_TCP4, port, SOCK_IO_NONBLOCK); + break; + case AS_IPV6: + tmp = socket(sn, Sn_MR_TCP6, port, SOCK_IO_NONBLOCK); + break; + case AS_IPDUAL: + tmp = socket(sn, Sn_MR_TCPD, port, SOCK_IO_NONBLOCK); + break; + default: + break; + } + if (tmp != sn) { /* reinitialize the socket */ +#ifdef _LOOPBACK_DEBUG_ + printf("%d : Fail to create socket.\r\n", sn); +#endif + return SOCKERR_SOCKNUM; + } +#ifdef _LOOPBACK_DEBUG_ + printf("%d:Socket opened[%d]\r\n", sn, getSn_SR(sn)); + sock_state[sn] = 1; +#endif + break; + default: + break; + } + return 1; +} + +int32_t loopback_tcpc(uint8_t sn, uint8_t* buf, uint8_t* destip, uint16_t destport) { + check_loopback_mode_W6x00(); + int32_t ret; // return value for SOCK_ERRORs + uint16_t sentsize = 0; + uint8_t status, inter, addr_len; + uint16_t received_size; + uint8_t tmp = 0; + uint8_t arg_tmp8; + wiz_IPAddress destinfo; +#if 1 + // 20231018 taylor + uint8_t sn_status; +#endif + + + // Socket Status Transitions + // Check the W6100 Socket n status register (Sn_SR, The 'Sn_SR' controlled by Sn_CR command or Packet send/recv status) + getsockopt(sn, SO_STATUS, &status); + switch (status) { + case SOCK_ESTABLISHED : + ctlsocket(sn, CS_GET_INTERRUPT, &inter); + if (inter & Sn_IR_CON) { // Socket n interrupt register mask; TCP CON interrupt = connection with peer is successful +#ifdef _LOOPBACK_DEBUG_ +#if 1 + // 20231018 taylor + getsockopt(sn, SO_EXTSTATUS, &sn_status); + if (sn_status & TCPSOCK_MODE) { + printf("%d:Connected to - %02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x : %d\r\n", sn, + destip[0], destip[1], destip[2], destip[3], + destip[4], destip[5], destip[6], destip[7], + destip[8], destip[9], destip[10], destip[11], + destip[12], destip[13], destip[14], destip[15], + destport); + } else { + printf("%d:Connected to - %d.%d.%d.%d : %d\r\n", sn, destip[0], destip[1], destip[2], destip[3], destport); + } +#else + printf("%d:Connected to - %d.%d.%d.%d : %d\r\n", sn, destip[0], destip[1], destip[2], destip[3], destport); +#endif +#endif + arg_tmp8 = Sn_IR_CON; + ctlsocket(sn, CS_CLR_INTERRUPT, &arg_tmp8); // this interrupt should be write the bit cleared to '1' + } + + ////////////////////////////////////////////////////////////////////////////////////////////// + // Data Transaction Parts; Handle the [data receive and send] process + ////////////////////////////////////////////////////////////////////////////////////////////// + getsockopt(sn, SO_RECVBUF, &received_size); + + if (received_size > 0) { // Sn_RX_RSR: Socket n Received Size Register, Receiving data length + if (received_size > DATA_BUF_SIZE) { + received_size = DATA_BUF_SIZE; // DATA_BUF_SIZE means user defined buffer size (array) + } + ret = recv(sn, buf, received_size); // Data Receive process (H/W Rx socket buffer -> User's buffer) + + if (ret <= 0) { + return ret; // If the received data length <= 0, receive failed and process end + } + received_size = (uint16_t) ret; + sentsize = 0; + +#if 1 + // 20231018 taylor +#ifdef _LOOPBACK_DEBUG_ + getsockopt(sn, SO_EXTSTATUS, &sn_status); + if (sn_status & TCPSOCK_MODE) { + printf("Socket %d Received %d bytes from %02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x port %d : \r\n", + sn, received_size, + destip[0], destip[1], destip[2], destip[3], + destip[4], destip[5], destip[6], destip[7], + destip[8], destip[9], destip[10], destip[11], + destip[12], destip[13], destip[14], destip[15], + destport); + } else { + printf("Socket %d Received %d bytes from %d.%d.%d.%d port %d : \r\n", sn, received_size, destip[0], destip[1], destip[2], destip[3], destport); + } + + int i; + for (i = 0; i < received_size; i++) { + printf("%c", buf[i]); + } + printf("\r\n"); +#endif +#endif + + // Data sentsize control + while (received_size != sentsize) { + ret = send(sn, buf + sentsize, received_size - sentsize); // Data send process (User's buffer -> Destination through H/W Tx socket buffer) + if (ret < 0) { // Send Error occurred (sent data length < 0) + close(sn); // socket close + return ret; + } + sentsize += ret; // Don't care SOCKERR_BUSY, because it is zero. + } +#if 1 + // 20231018 taylor +#ifdef _LOOPBACK_DEBUG_ + if (sn_status & TCPSOCK_MODE) { + printf("Socket %d Sent back %d bytes from %02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x port %d : \r\n", + sn, sentsize, + destip[0], destip[1], destip[2], destip[3], + destip[4], destip[5], destip[6], destip[7], + destip[8], destip[9], destip[10], destip[11], + destip[12], destip[13], destip[14], destip[15], + destport); + } else { + printf("Socket %d Sent back %d bytes from %d.%d.%d.%d port %d : \r\n", sn, sentsize, destip[0], destip[1], destip[2], destip[3], destport); + } + + int j; + for (j = 0; j < sentsize; j++) { + printf("%c", buf[j]); + } + printf("\r\n"); +#endif +#endif + } + ////////////////////////////////////////////////////////////////////////////////////////////// + break; + + case SOCK_CLOSE_WAIT : +#ifdef _LOOPBACK_DEBUG_ + printf("%d:CloseWait\r\n", sn); +#endif + getsockopt(sn, SO_RECVBUF, &received_size); + + if ((received_size = getSn_RX_RSR(sn)) > 0) { // Sn_RX_RSR: Socket n Received Size Register, Receiving data length + if (received_size > DATA_BUF_SIZE) { + received_size = DATA_BUF_SIZE; // DATA_BUF_SIZE means user defined buffer size (array) + } + ret = recv(sn, buf, received_size); // Data Receive process (H/W Rx socket buffer -> User's buffer) + + if (ret <= 0) { + return ret; // If the received data length <= 0, receive failed and process end + } + received_size = (uint16_t) ret; + sentsize = 0; +#if 1 + // 20231018 taylor +#ifdef _LOOPBACK_DEBUG_ + getsockopt(sn, SO_EXTSTATUS, &sn_status); + if (sn_status & TCPSOCK_MODE) { + printf("Socket %d Received %d bytes from %02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x port %d : \r\n", + sn, received_size, + destip[0], destip[1], destip[2], destip[3], + destip[4], destip[5], destip[6], destip[7], + destip[8], destip[9], destip[10], destip[11], + destip[12], destip[13], destip[14], destip[15], + destport); + } else { + printf("Socket %d Received %d bytes from %d.%d.%d.%d port %d : \r\n", sn, received_size, destip[0], destip[1], destip[2], destip[3], destport); + } + + int i; + for (i = 0; i < received_size; i++) { + printf("%c", buf[i]); + } + printf("\r\n"); +#endif +#endif + + // Data sentsize control + while (received_size != sentsize) { + ret = send(sn, buf + sentsize, received_size - sentsize); // Data send process (User's buffer -> Destination through H/W Tx socket buffer) + if (ret < 0) { // Send Error occurred (sent data length < 0) + close(sn); // socket close + return ret; + } + sentsize += ret; // Don't care SOCKERR_BUSY, because it is zero. + } +#if 1 + // 20231018 taylor +#ifdef _LOOPBACK_DEBUG_ + if (sn_status & TCPSOCK_MODE) { + printf("Socket %d Sent back %d bytes from %02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x port %d : \r\n", + sn, sentsize, + destip[0], destip[1], destip[2], destip[3], + destip[4], destip[5], destip[6], destip[7], + destip[8], destip[9], destip[10], destip[11], + destip[12], destip[13], destip[14], destip[15], + destport); + } else { + printf("Socket %d Sent back %d bytes from %d.%d.%d.%d port %d : \r\n", sn, sentsize, destip[0], destip[1], destip[2], destip[3], destport); + } + + int j; + for (j = 0; j < sentsize; j++) { + printf("%c", buf[j]); + } + printf("\r\n"); +#endif +#endif + } + if ((ret = disconnect(sn)) != SOCK_OK) { + return ret; + } +#ifdef _LOOPBACK_DEBUG_ + printf("%d:Socket Closed\r\n", sn); +#endif + break; + + case SOCK_INIT : +#ifdef _LOOPBACK_DEBUG_ + if (loopback_mode == AS_IPV4) { + printf("%d:Try to connect to the %d.%d.%d.%d, %d\r\n", sn, destip[0], destip[1], destip[2], destip[3], destport); + } else if (loopback_mode == AS_IPV6) { + printf("%d:Try to connect to the %04X:%04X", sn, ((uint16_t)destip[0] << 8) | ((uint16_t)destip[1]), + ((uint16_t)destip[2] << 8) | ((uint16_t)destip[3])); + printf(":%04X:%04X", ((uint16_t)destip[4] << 8) | ((uint16_t)destip[5]), + ((uint16_t)destip[6] << 8) | ((uint16_t)destip[7])); + printf(":%04X:%04X", ((uint16_t)destip[8] << 8) | ((uint16_t)destip[9]), + ((uint16_t)destip[10] << 8) | ((uint16_t)destip[11])); + printf(":%04X:%04X,", ((uint16_t)destip[12] << 8) | ((uint16_t)destip[13]), + ((uint16_t)destip[14] << 8) | ((uint16_t)destip[15])); + printf("%d\r\n", destport); + } +#endif + + if (loopback_mode == AS_IPV4) { + ret = connect(sn, destip, destport, 4); /* Try to connect to TCP server(Socket, DestIP, DestPort) */ + } else if (loopback_mode == AS_IPV6) { + ret = connect(sn, destip, destport, 16); /* Try to connect to TCP server(Socket, DestIP, DestPort) */ + } + + printf("SOCK Status: %d\r\n", ret); + + if (ret != SOCK_OK) { + return ret; // Try to TCP connect to the TCP server (destination) + } + break; + + case SOCK_CLOSED: + switch (loopback_mode) { + case AS_IPV4: + tmp = socket(sn, Sn_MR_TCP4, any_port++, SOCK_IO_NONBLOCK); + break; + case AS_IPV6: + tmp = socket(sn, Sn_MR_TCP6, any_port++, SOCK_IO_NONBLOCK); + break; + case AS_IPDUAL: + tmp = socket(sn, Sn_MR_TCPD, any_port++, SOCK_IO_NONBLOCK); + break; + default: + break; + } + + if (tmp != sn) { /* reinitialize the socket */ +#ifdef _LOOPBACK_DEBUG_ + printf("%d : Fail to create socket.\r\n", sn); +#endif + return SOCKERR_SOCKNUM; + } + printf("%d:Socket opened[%d]\r\n", sn, getSn_SR(sn)); + sock_state[sn] = 1; + + break; + default: + break; + } + return 1; +} + +int32_t loopback_udps(uint8_t sn, uint8_t* buf, uint16_t port) { + check_loopback_mode_W6x00(); + uint8_t status; + static uint8_t destip[16] = {0,}; + static uint16_t destport; + uint8_t pack_info; + uint8_t addr_len; + uint16_t ret; + uint16_t received_size; + uint16_t size, sentsize; + uint8_t* mode_msg; + + if (loopback_mode == AS_IPV4) { + mode_msg = msg_v4; + } else if (loopback_mode == AS_IPV6) { + mode_msg = msg_v6; + } else { + mode_msg = msg_dual; + } + + getsockopt(sn, SO_STATUS, &status); + switch (status) { + case SOCK_UDP: + getsockopt(sn, SO_RECVBUF, &received_size); + if (received_size > DATA_BUF_SIZE) { + received_size = DATA_BUF_SIZE; + } + if (received_size > 0) { + ret = recvfrom(sn, buf, received_size, (uint8_t*)&destip, (uint16_t*)&destport, &addr_len); + + if (ret <= 0) { + return ret; + } + received_size = (uint16_t) ret; +#if 1 + // 20231018 taylor +#ifdef _LOOPBACK_DEBUG_ + if (addr_len == 4) { + printf("Socket %d Received %d bytes from %d.%d.%d.%d port %d : \r\n", sn, received_size, destip[0], destip[1], destip[2], destip[3], destport); + } else { + printf("Socket %d Received %d bytes from %02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x port %d : \r\n", + sn, received_size, + destip[0], destip[1], destip[2], destip[3], + destip[4], destip[5], destip[6], destip[7], + destip[8], destip[9], destip[10], destip[11], + destip[12], destip[13], destip[14], destip[15], + destport); + } + + int i; + for (i = 0; i < received_size; i++) { + printf("%c", buf[i]); + } + printf("\r\n"); +#endif +#endif + sentsize = 0; + while (sentsize != received_size) { + ret = sendto(sn, buf + sentsize, received_size - sentsize, destip, destport, addr_len); + + if (ret < 0) { + return ret; + } + + sentsize += ret; // Don't care SOCKERR_BUSY, because it is zero. + } +#if 1 + // 20231018 taylor +#ifdef _LOOPBACK_DEBUG_ + int j; + if (addr_len == 4) { + printf("Socket %d Sent back %d bytes from %d.%d.%d.%d port %d : \r\n", sn, sentsize, destip[0], destip[1], destip[2], destip[3], destport); + } else { + printf("Socket %d Sent back %d bytes from %02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x port %d : \r\n", + sn, sentsize, + destip[0], destip[1], destip[2], destip[3], + destip[4], destip[5], destip[6], destip[7], + destip[8], destip[9], destip[10], destip[11], + destip[12], destip[13], destip[14], destip[15], + destport); + } + for (j = 0; j < sentsize; j++) { + printf("%c", buf[j]); + } + printf("\r\n"); +#endif +#endif + } + break; + case SOCK_CLOSED: + + switch (loopback_mode) { + case AS_IPV4: + socket(sn, Sn_MR_UDP4, port, SOCK_IO_NONBLOCK); + break; + case AS_IPV6: + socket(sn, Sn_MR_UDP6, port, SOCK_IO_NONBLOCK); + break; + case AS_IPDUAL: + socket(sn, Sn_MR_UDPD, port, SOCK_IO_NONBLOCK); + break; + } + printf("%d:Opened, UDP loopback, port [%d] as %s\r\n", sn, port, mode_msg); + + } + + return 0; +} + + + +int32_t loopback_udpc(uint8_t sn, uint8_t* buf, uint8_t* destip, uint16_t destport) { + check_loopback_mode_W6x00(); + int32_t ret; + uint16_t size = 0, sentsize = 0; + static uint16_t any_port = 50000; + uint8_t addr_len; + + + uint8_t* mode_msg; + if (loopback_mode == AS_IPV4) { + mode_msg = msg_v4; + } else if (loopback_mode == AS_IPV6) { + mode_msg = msg_v6; + } else { + mode_msg = msg_dual; + } + + // uint8_t* strtest = "\r\nhello world"; + // uint8_t flag = 0; + switch (getSn_SR(sn)) { + case SOCK_UDP : + // sendto(sn, strtest, strlen(strtest), destip, destport); + if ((size = getSn_RX_RSR(sn)) > 0) { + if (size > DATA_BUF_SIZE) { + size = DATA_BUF_SIZE; + } + ret = recvfrom(sn, buf, size, destip, (uint16_t*)&destport, &addr_len); + buf[ret] = 0x00; + printf("recv form[%d.%d.%d.%d][%d]: %s\n", destip[0], destip[1], destip[2], destip[3], destport, buf); + if (ret <= 0) { +#ifdef _LOOPBACK_DEBUG_ + printf("%d: recvfrom error. %ld\r\n", sn, ret); +#endif + return ret; + } + size = (uint16_t) ret; + sentsize = 0; + while (sentsize != size) { + ret = sendto(sn, buf + sentsize, size - sentsize, destip, destport, addr_len); + if (ret < 0) { +#ifdef _LOOPBACK_DEBUG_ + printf("%d: sendto error. %ld\r\n", sn, ret); +#endif + return ret; + } + sentsize += ret; // Don't care SOCKERR_BUSY, because it is zero. + } + } + break; + case SOCK_CLOSED: +#ifdef _LOOPBACK_DEBUG_ + // printf("%d:UDP loopback start\r\n",sn); +#endif + + switch (loopback_mode) { + case AS_IPV4: + socket(sn, Sn_MR_UDP4, destport, SOCK_IO_NONBLOCK); + break; + case AS_IPV6: + socket(sn, Sn_MR_UDP6, destport, SOCK_IO_NONBLOCK); + break; + case AS_IPDUAL: + socket(sn, Sn_MR_UDPD, destport, SOCK_IO_NONBLOCK); + break; + } + printf("%d:Opened, UDP loopback, port [%d] as %s\r\n", sn, destport, mode_msg); +#ifdef _LOOPBACK_DEBUG_ + printf("%d:Opened, UDP loopback, port [%d]\r\n", sn, any_port); +#endif + break; + default : + break; + } + return 1; + +} + +#endif + +#endif diff --git a/Application/loopback/loopback.h b/Application/loopback/loopback.h new file mode 100644 index 0000000..6be2ce8 --- /dev/null +++ b/Application/loopback/loopback.h @@ -0,0 +1,50 @@ +#ifndef _LOOPBACK_H_ +#define _LOOPBACK_H_ + +#ifdef __cplusplus +extern "C" { +#endif + +#include +#include "wizchip_conf.h" + +/* Loopback test debug message printout enable */ +#if 0 +#define _LOOPBACK_DEBUG_ +#endif + +/* DATA_BUF_SIZE define for Loopback example */ +#ifndef DATA_BUF_SIZE +#define DATA_BUF_SIZE 2048 +#endif + +/************************/ +/* Select LOOPBACK_MODE */ +/************************/ +#define LOOPBACK_MAIN_NOBLOCK 0 +#define LOOPBACK_MODE LOOPBACK_MAIN_NOBLOCK + +#if ((_WIZCHIP_ == 6100) || (_WIZCHIP_ == 6300)) +int8_t set_loopback_mode_W6x00(uint8_t get_loopback_mode) ; +int8_t check_loopback_mode_W6x00(); +#endif + +/* TCP server Loopback test example */ +int32_t loopback_tcps(uint8_t sn, uint8_t* buf, uint16_t port); + +/* TCP client Loopback test example */ +int32_t loopback_tcpc(uint8_t sn, uint8_t* buf, uint8_t* destip, uint16_t destport); + +/* UDP Loopback test example */ +int32_t loopback_udps(uint8_t sn, uint8_t* buf, uint16_t port); + +/* UDP Client Loopback test example */ +int32_t loopback_udpc(uint8_t sn, uint8_t* buf, uint8_t* destip, uint16_t destport); + +//teddy 240122 + +#ifdef __cplusplus +} +#endif + +#endif diff --git a/Application/multicast/multicast.c b/Application/multicast/multicast.c new file mode 100644 index 0000000..d159972 --- /dev/null +++ b/Application/multicast/multicast.c @@ -0,0 +1,145 @@ +#include "multicast.h" +#include +#include "socket.h" +#include "wizchip_conf.h" + + +int32_t multicast_loopback(uint8_t sn, uint8_t* buf, uint8_t* multicast_ip, uint16_t multicast_port) { + int32_t ret; + uint16_t size, sentsize; + uint8_t destip[4]; + uint16_t destport, port = 3000; +#if 1 + // 20231019 taylor + uint8_t addr_len; +#endif + + switch (getSn_SR(sn)) { + case SOCK_UDP : + if ((size = getSn_RX_RSR(sn)) > 0) { + if (size > DATA_BUF_SIZE) { + size = DATA_BUF_SIZE; + } +#if 1 + // 20231019 taylor//teddy 240122 +#if ((_WIZCHIP_ == 6100)|| (_WIZCHIP_ == 6300)) + ret = recvfrom(sn, buf, size, destip, (uint16_t*)&destport, &addr_len); +#else + ret = recvfrom(sn, buf, size, destip, (uint16_t*)&destport); +#endif +#else + ret = recvfrom(sn, buf, size, destip, (uint16_t*)&destport); +#endif + if (ret <= 0) { +#ifdef _MULTICAST_DEBUG_ + printf("%d: recvfrom error. %ld\r\n", sn, ret); +#endif + return ret; + } + size = (uint16_t) ret; + sentsize = 0; + while (sentsize != size) { +#if 1 + // 20231016 taylor//teddy 240122 +#if ((_WIZCHIP_ == 6100) || (_WIZCHIP_ == 6300)) + ret = sendto(sn, buf + sentsize, size - sentsize, destip, destport, 4); +#else + ret = sendto(sn, buf + sentsize, size - sentsize, destip, destport); +#endif +#else + ret = sendto(sn, buf + sentsize, size - sentsize, destip, destport); +#endif + if (ret < 0) { +#ifdef _MULTICAST_DEBUG_ + printf("%d: sendto error. %ld\r\n", sn, ret); +#endif + return ret; + } + sentsize += ret; // Don't care SOCKERR_BUSY, because it is zero. + } + } + + break; + case SOCK_CLOSED: +#ifdef _MULTICAST_DEBUG_ + printf("%d:Multicast Loopback start\r\n", sn); +#endif + setSn_DIPR(0, multicast_ip); + setSn_DPORT(0, multicast_port); + if ((ret = socket(sn, Sn_MR_UDP, port, Sn_MR_MULTI)) != sn) { + return ret; + } +#ifdef _MULTICAST_DEBUG_ + printf("%d:Opened, UDP Multicast Socket\r\n", sn); + printf("%d:Multicast Group IP - %d.%d.%d.%d\r\n", sn, multicast_ip[0], multicast_ip[1], multicast_ip[2], multicast_ip[3]); + printf("%d:Multicast Group Port - %d\r\n", sn, multicast_port); +#endif + break; + default : + break; + } + return 1; +} + +int32_t multicast_recv(uint8_t sn, uint8_t* buf, uint8_t* multicast_ip, uint16_t multicast_port) { + int32_t ret; + uint16_t size, port = 3000; + uint8_t destip[4]; + uint16_t destport; +#if 1 + // 20231019 taylor + uint8_t addr_len; +#endif + + switch (getSn_SR(sn)) { + case SOCK_UDP : + if ((size = getSn_RX_RSR(sn)) > 0) { + if (size > DATA_BUF_SIZE) { + size = DATA_BUF_SIZE; + } +#if 1 + // 20231019 taylor//teddy 240122 +#if ((_WIZCHIP_ == 6100) || (_WIZCHIP_ == 6300)) + ret = recvfrom(sn, buf, size, destip, (uint16_t*)&destport, &addr_len); +#else + ret = recvfrom(sn, buf, size, destip, (uint16_t*)&destport); +#endif +#else + ret = recvfrom(sn, buf, size, destip, (uint16_t*)&destport); +#endif + if (ret <= 0) { +#ifdef _MULTICAST_DEBUG_ + printf("%d: recvfrom error. %ld\r\n", sn, ret); +#endif + return ret; + } + size = (uint16_t) ret; +#ifdef _MULTICAST_DEBUG_ + printf("\r\nrecv size : %d\r\n", size); + for (int i = 0; i < size; i++) { + printf("%c", buf[i]); + } + printf("\r\n"); +#endif + } + break; + case SOCK_CLOSED: +#ifdef _MULTICAST_DEBUG_ + printf("%d:Multicast Recv start\r\n", sn); +#endif + setSn_DIPR(sn, multicast_ip); + setSn_DPORT(sn, multicast_port); + if ((ret = socket(sn, Sn_MR_UDP, port, Sn_MR_MULTI)) != sn) { + return ret; + } +#ifdef _MULTICAST_DEBUG_ + printf("%d:Opened, UDP Multicast Socket\r\n", sn); + printf("%d:Multicast Group IP - %d.%d.%d.%d\r\n", sn, multicast_ip[0], multicast_ip[1], multicast_ip[2], multicast_ip[3]); + printf("%d:Multicast Group Port - %d\r\n", sn, multicast_port); +#endif + break; + default : + break; + } + return 1; +} diff --git a/Application/multicast/multicast.h b/Application/multicast/multicast.h new file mode 100644 index 0000000..ab4e9aa --- /dev/null +++ b/Application/multicast/multicast.h @@ -0,0 +1,28 @@ +#ifndef _MULTICAST_H_ +#define _MULTICAST_H_ + +#ifdef __cplusplus +extern "C" { +#endif + +#include + +/* Multicast test debug message printout enable */ +#define _MULTICAST_DEBUG_ + +#ifndef DATA_BUF_SIZE +#define DATA_BUF_SIZE 2048 +#endif + +/* UDP Multicast Loopback test example */ +int32_t multicast_loopback(uint8_t sn, uint8_t* buf, uint8_t* multicast_ip, uint16_t multicast_port); + +/* UDP Multicast Recv test example */ +int32_t multicast_recv(uint8_t sn, uint8_t* buf, uint8_t* multicast_ip, uint16_t multicast_port); + + +#ifdef __cplusplus +} +#endif + +#endif diff --git a/Ethernet/Socket_APIs_V3.0.3.chm b/Ethernet/Socket_APIs_V3.0.3.chm new file mode 100644 index 0000000000000000000000000000000000000000..35ed51287ff1af9b935d50349eef01ce1b344340 GIT binary patch literal 1435546 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

wcjjNQ;~YkJO=G|paL=bF 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

#~PVDa^W#ms>jj?2D-%Ld~ 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

$Y4k_*+h>Sx!)+qIX8mr zrN%vjUc^2A33hy4U0mE;Zo=NZY*hu$^P%#aOJ%q4kFBHuRE9xvPrlX|7w-hnB3z>w zkVV~PCY$+rU8fdB@t?Ia>gDEKn+|0Qu;|EK-SrmH5-aEW-T=egF!-55z4cG3dK^j! zfSwzbF0FTo7oE^fx zUSY@ls2)6AbNq^wk|2@-0>MutQsSMy_mPwWq%1;zNQ?`$ygKLDnE}+VK<7BKPI}l% zQwy+c2+et|N3rPpDXh00&)`JJOER=7>ELQ;|K^nuPx(3OlWnV-RG3ODU=zRFUeICF z*ekJp#!}}5K*zjec`x=TDX0wDN(!;5Y>PvaY);!vtTdwh!IND&%IX(L? zPM&R;a=&zwAB*iFKZ6a3#D6Adlad>rqNv2tP;e2qLSvwaRNUx17Ol%ql8 z6JO#q2kM!`nz2toMo)27&rdwd^UdJq+vhe5{gYI{@+mB$uQ41RkmnDH9??#QUdGTv zNH73i(KCgToFD+NXyuraF+d?J6wKFIV$M+o5~)PyM3`nLwetM5&?VtFoF`K>V{Ft9;HNCj2yWzcke*{+Cgob2^6u8ZQtEd+C-K^z50loCeiOGD3 zs>7eWf!Bz`{x?5P-5K*b2m>&g56M+dx6kZTlqG7hPzkFR>RGqNO8->!IIT)!COCk?e6mlK56CTw05^YR^?wA7EmGn+ z0o61DsMvtQNiV=IGffyM4LL=*j8XX?E5UzV1X)H6*(&9;bAAS^cFP^{Jy zr-0E-9-|ZyKOt9z%F+%R>jy@x)wse#t2{1^lJBTM$;{#XVc2kKVPr zNy?=^-vdn+`^z5wM|uE*#;IFuYZU+Z2Y9>aOctY4@4&(XHtos zdm;|Osp8C4qP5>hdwuB?Pxl$Gwb$jNqyR|&fQC&Jtat@uabD_+*ZI3jiomoP434X$ z_Kv&Y08js{h5{h`0gc=e;i3oqQpz`=01nJMc*v5y2r?(G180_U<-WtbsG^W40`#Sn z&_!TB7_Fj^jl-m^8A&}~t4ZUO2xo)aOarUEsD~iEv1~om`rJH)B*fHoJ18li3f*vb`E@~h)HV& zp@t^oiw^cs9EaD|rr4g(*V$5lh;RzlBHF6nOR@~komx-aUYYla?GXzY?hG||Q4b3P z7X#mz*Xu`K@8Z1zP&l=qfE@||C8SUapkx)B_nKAWb=j(=4}dUQjTNoFJI$;KpLqqq z0H;t+7VyAQVavQ#{YhXCi`-^ioBsJsOPW_x6C;-+nGd+qD`Qn92%7MI+J1V09`_ zj!u=5QDg+zgVIP>fSsRnI85HxOQAEsGG2{xj=&*&h?TG6DAait-O};7~Y$L-i0v zz9(netkbNwua!ZFI$i;+ukXlKOV4J4gn_&?AOR>GB8Lb_2_kSM91GE+v=3T0_b2~? zP)#C2W&F-OfB%Dx2Z!PPN%pkfk{{x|-q1zBLr0He%Ovkg6C=#e4B#o>hU89A5D=jR z`io54S)*l-O{22!sR7OHn%s@hMHk4dIXc~JH=E(#p0&aZ3tEJsB$@2qvM2}&5&<3t zokjxnibS3WANgFJzl7Q$0YU);5{HBmfFs@>?zX5?CR9vhyc}Z+uHeDI7ehR9h+9*XdndSEXNdWqw$0YuCyu z?(}}6Wd}pS+_4bh5-0;YI;l6G=CtN)B-iq&``v%6@J%H^`W_^`$hnCpaPdi! zUQkC%1(31paXFzAWY^##Zn&~!!;wz(40|+7=5-yjjI1%j0%XNbEuJ(}Pv*o|*djqd ztTtMkpAuHa`mqF$h4}ITTPk~G%nqv(4B4RqWH4D{%U$-rsI1`5sxXl|&Nsx7mEvlZ z#uum@V7Ww0N4Dk$9oMhdOj>l6*#n{|3-c1FY>>I@^b#;B&3aI_LT8nYlp3#>((MTx zA;7XQYNFz=oW^3PS_B%NFd=a(WU+`~s1MG6t{DH$ zrGE^yv$?d4xiu7XN0(mLkfQVSS&~>Nnb8xM2flC2Ws=T+{NY!uB7r3!NwqRo;b8$G z+{`7`TS2iS??*@_n$0*cKGe$EKf3cN%hzWGSgD0Ze>G_{SwN({>Ip^)b1m~+P{#R8 zaj22@bcG;a%dxeB)l`W} zh1LZ8a&!L@Ky)0Su?w)`^n>o6fU}k^`jo;9bVER06_bl-E&4;ohZ88KiV!sjO+|BK zdnvEg%#M{`@KTi-WQG9hKtLH;hD3J94g8E-MZpwoBe>IBOPfmQ^*-wU z0sHe|A?BuR0H&@EkwXM3h8XXBefEVSQb~|o8Au!yY2WqHU_`|tYP#VRfu|1Z z5o=r+v=6=cJyF?6IU00j)EO9{OTWSDGmBLcS)4R)sPA)Bj091!-^`)9w-;7xxNDuw-pu!0dZDX^uPVHZ-6eLx!n5f%P%Syt$aDP1 z=9F_qV09RP6d*-kY+m!$gy;;>OX(XYjzbk1Dk-x4<7as&tcL=(DZKrGP6PMId&OtL zQ_wsF5<*66R>Le{;+h$P!!3Z}eo0%%T!sk$p&hD3T+g`(DX!uXfNmvWv(066SqWQL zaRnfLZJ;Du3lF$uC7go^fo#HR2y6ssiqTtW+9kei%Fx*z^rIg+S&SG0sQ#-4>M( zTR9>sPMq@izF8uXu_z{s5j|h&(;0jZOV*uwFW7N_Re^uW*uV%ME2{TDvwyo9K5%Na z7320b0N`#r9K`iHdu-_hYB`cI3#85hrXgZ%n4e46vEX{ih%y3oa+pd(g%#cV9>oJ= zCY}hnz9j0gSn(40-PH947ZFgCl}i2sETh5*i1qb3y&S-qdG7?L%sUAPLNx@&8 z2THciBO_2Vmt2AfmYCD}2wxOVAyWjHgFMk>EP%Su2s2*k6d1znOgg27ur>WF&0e-X zhm>6*XVOmol9qta(G$g;MOJhT5os^OEU0SybkW z62{v!c!Hzbu!B~2SsrYlqIy6%B|v5Uz>HRb*a#}>2Q#$gSVFKCR40(2(uLCzKwnYc zw!P)XWb6sdS+v74ju>ODKv2_Y*s4m<-_l!v;SFQ-#*73_& zt%n6fQkn#~{kA=501>*(DZOPOMR*P{o%C&OXLS5ERkUK+i~=L`NC9|eX>rwKq6(%@ zOT86?qz0WUwF(nKWvWgB_BpdM!!4FECxcv{4K3c?8zKTKBn^`=`L<&z|0_N$5s9A? zART$4wC-D=;)=>U0>OBpDt@8n!3KN{@AIEkeg)|HYY0#F{-Uz(hIxcp}q0acWLJ ze8d3#6^#`^L{*KfsMWuOnyLi#+JNeHD44xO-BAL715qH9K%r0qMuSmN@Rh(Uqspct zpcbeFRX17-nO)kc`L;mHtQ!3>8VXC1l@t~wpv!1tBnqf#iH+NyEt1ci6PL8#R&nXj zeJX??*61b3?PP0v$6*AK!2E!((EXXAdyUAf@W}!+qyOg+{5*Lv+}i1)6J5vH&F1S> zQUJw^T&E<+zvoW0@%KxH%^Zge#X1?{VgSGp5CZ@Q03$;LHvj-nWqy?x@NN7>V|ZhE zcLcgZF#<^zA|b`|5NaCkuA{;$l3;8bWBvCT{{RpYIV&OngoFdqYuSWSY!kW3Is3_A5j241{5(A1VB-I5I#arlKMEv z#~LX!-Z6U(rbXRZ=YBz{2fypq`A*~Yc37AXTfITw zz>LFd{ck6}*?fm0MAWQ;Uv7N`7yg^A{`hZK9CSLyrEL%Idgw)gMw4~&vHOGWlJWyP zqrtXvgywAn55a}Uzqh0A+x`Yeg)r~1FoWSSl84SH9N|&jZ-Ixk?Qs9napLdTcI|ti z?=s$r2iH(g86qvZX9-0zTqK(4KQuSeJhX5zD#5+rELgFqh# z1jS>@F{DXZd;Sr0&H`8DXTX^GPaV4QhrBs6?x))-z-4rTw4}sF{_vOO_UK?0 zYAnq5<6n-!=j*$E{r(n!pS5K$?rO#x9|tmjc6Qpy3mF+Osu^!HKe%nI{0$CdMFm(& zhPTmaE7LW(q9yu7+{&TMZ|@9MbQGpmkWC-{v0r<-a{=whW>UzOmM2AAOjlTDOKf%I z=J4oeFr{W)#lF``&xQbX0IReTTdZ-<;&)~{SIKJwE8?38(Ttz)=BKc}Z$2<^Y$cCwFl?2FsA{r~lSXWFynUttsfuz~IF*I)N3M%=d3-{O)jfQVc_b`TK> z*-{D)lh0RUA)`;oDy5JzDSi+lK}iCY4v3km)05XCCU@XY6Gv7*mcn7OA)u?V9X?92 zxbpAs0nc(Z?ZvP-GS2S{NJmFGi`Y&gswrpywMwygI;iJpu37Bq@z1>)b#rXV(d4-j zbs=KqMPWB<@=ieoEJ2DOU+z#HX*wlvxk=)^-h4HAcHZ<_sXTGER(KqB7$nDAVdd2W zqc8w1e;^nCXFoTR*A7Du=b8myPw~PHEa$ID2RnBmIIbqallNoy|SJ z=^~Y?VGjRnrJnh_^$(19$boHIl)y;%!+6xgUq>$wJHol>;z@e3-{4W}`XtS+LOFLw zN>=?aS`%OaR}y~(2Khu_KEoMDHwKr&c2#vFFeNYr0YF)*d65Fs3(w~uq!U5fPiI^l z9oh0WPgPGG;NvbLnuo##$X3)qimq4hU(Vkh-f`E#z;}EOypH24Ha!I$Mon7*D!5*% zCKg*^0rXqjYSRZHCsImhK`gF+cG_Dt8g^PKU`(+fMC&Q7HuRp&fw0 zgr59AtaE2Rlc2bXG8m4#})NX-S%eOksi-hJ99@kfc{ud(6CeZpeunSBnW`4sWn54UvMg* z$eNBweS`$BULGw4Q2GNFQaSuy+A9*e0MF6A;rQj1epp)&1*H_(TPQWLz`SGuQr2P% z-=Gw-SR-z}Q&S9M0lZcz6|uk;bu+~|6$MbKja}^oNXylkl0Oqjq47l9=7FZE8W3*Yj+jwpikN;73hwmZmB|fe#d1)xhe@E^JYc5Hv<9 zg)vD5h9--M(TfGjXX!kUv8S;y`#j_?N#GciQm~imL;3c{u*eXU0uZc%-OLs&kS|%} zS&Seop!aF8jA<;R{tJkF8g8|mVNzgkl>}u1!j??n%eg#@Y4)EbHu98=$o^=OgKwj|i$4nlT&Y+q2amGp<~N{c>yY z6;DD*a#9Lpk_!w-78NxuqPheGK-{!~eoBEcQVa%N9$2`e$w{1DOE5@3C-N(%&o`}$ zxR2rEINa~!~aWn zX7pD*WGUUfAv^%3*PZlqLX%6HMU1Lalpx}Z|By2qoZkNbfIDG}+K9?rX|lzpl@#j> zAV?Npcv*AKV9n;|KD>|S_e)h|^2`ag&MOsH$^EE|Q~2JcANs20T2fX(J#7_7(8%;X zr+%9jaw!D|Ngs;!yZ590GOa;p_HA!w*?q^Sw?t_Qh__POi7?VyET57k`+=k+ZN>te zsdsig#}zp+Q-P9NO8i&_82XA@esDCY2M;ZFhbf~1AP)k5o>}zZLY(!d=oY!6)}&@b z0)QIBD#QaUuXSCOCFb%L1|ZZ*DZfm27MNKKg6#l~;K#(cX@-Bpa6*MmW}-bzERnSX)PAbh%0Hz^0m zT7ytqZO*wI7*D0iN&dDb&6tj9HdMBs&Y+ZGO3?~FU;Esa^@F%9Wtf(1X4_lxE2SJ% zQka$x8&7bh6g^X>6%&UO+$q~*X^{E{3B3RD=Gyv!2^Bz=nIu1%V}bV0)YHtssvj(- zw{{VlyuxOJ&I||}mtE##1u>SKJ(72{i0Go^r8#cfahs#}Be;;fPiB)s^sLm0>!fdK zJ*((+-p?P$c}d#s?P2|+^R)zRK>fxZM>!;JN|L!--#(mhk9u=Xxt>^V6 zxKh3hn=p$9^U|$4Xepk8n`MGdD<$^H)vNRZH<`a~U@cAPBcK|H#KZBV%WvNPv9LVH zsX&?67TJ&Bo*A3VO3Pwuf~4_~VKNxTs`{+dc0A1i6qmO`DqQ#idd^E>E!^DDw(A&xRc;YIp=yLR6X14roXh_-FEIAn`zuK$u7Vp zrUds&nxa-S&YfBWx5|u@R`axC7bO7muUu;X5>F|?Z4xW?l;9+~o5KR$=+2uA2x@dX z@lC`J(Fnu(p6a=cCV!rttL`y(=`-`rId}!Z7rX7UuYC^6n{EPU08ntH47WY^1Xs!( zd#IhNo(0Tnx#z6dS0)JKL)R5HLHoskB$x0A=MP<;Z?8+)IOR-bx-4a0l`1a&QZ2OX zxEp`kb$e{yO~&i{ZoXZa#VOn3g7bywrZ{Ef@jnk@ou$Z`Ap%s8Ke{ZxpY7XwuR$)R zD&VR)uI@@Sbf~U>*qq^==wjBKM~<;-dVS}GSRomQLj2yqSKb$Y|9gGS_n>)(fa(G* z%TZ^zN}4OuQh(h9(X(DM{pBwdhAf%OTcHvIF1&J><4VK*tJkhLN&^M2xwc_*E(y|8 zOYh^{`Mdh(N%=n#eM9xeBROxh@Z|(dPeGP!6!Qi4xn5gy!=Lc1NR8Z|5!&L z2m}HUHu$spAJB9_VM`ZFyC0(S^B9-d=*fV$6#|=9=MuddXg4vtI;+z5N^|>!+4W{n zz4HuMR?bSf+Hi;u2cA8Bg-Z}4Mq;^QYVlz>4RVTu7#wV}@vlc6x6huZWwqWyz#ssj zJ0Oi05};`SHJ4USc0ZC)o{2HAluVxxgxEX?Fx6_K#crbP2GWNRp;plBgsR5=ldaTU*EFwZkx@Xbw| z`3tj6gZBpWpZjeqv;##HP$Q)^5MqIy$;8aIw|12iFNj(o8OVU5DZgVnbXjcTJ)Po! zgky*f!A6Xcfih1Q(~YnJT>bAZ5`3Bq7z>ogrz0LPIaDeuu``IQ8mD)(*%)NAvV#4k z_Wxn62@(K)K!LwS0w5IxEq%0e;Sdx+yE0R~t53A@1(+(@CpB=uum|AK1BfdkcC*|> zRKO9)w@wWyj*36$Vu*;MgC;y0d&{n~-mlY}SK3eNyzu?0Z}fAQlfg)ZC;a$fe+l4^ zg1;s?x*xcI{$+~eUN*fM?;LdwYtaHAhy#HDW@1#*Kopfy-KL4}(i4FBq#AyO{DNrf z1Di3X;7Xm06Xn+2>&2jpN5{Ppyw^VCHoGF`-*9mp%Mcnt9A;pGgQEF3h&ub^l^yQ& zuh;INS-TsSFp7*aeJrI82ZU!uMka)fgc_l8Sqt~zlp&QUY$vQ{>r1FF0aBKf+^`g+ zQlOcX>%W>yGhYDX;kMKrLD`}bAJ>(J#fjr$j29j7^$=<}u~Ec)s9iDS4n`|4Ag0HS z;BpxAG(x9f2c7?8@H-IDj>5T*Va&2Oi8TB|1y-GsMkgmk>0G z(=oSW?Ayj_fFki0st5-PbSb)}3i7e6l)mWxv#Vm%Z$%bCI#h`-SJ2}X4skibqe_TL z7yf$(<_^27G!`etjX|CWA}fWQBE1lb6{U-Yem!^3+qgaL{xx^kCH>=b1z4{16~+(- zr4+r=Y7s1(^3X~c(1?t~7S04u!gp&dMG;LHc;^_r^+CxTi|0q)P@#@Fxsn@X4-*R> z4Mi8}-LW=qO`G_gD#T!mfni~oZ58uWw$z2dTS<@X(MW8=MqdIFIZ4(+J%u02B5Od* z5Ht25yA?yq3>4DEEx%e&xI~N@&>0rf90TGgexQ!m>@!Jez$g(6yn4i3-~?(9;d22^ z0w8NEQYX>}=j~4-K=~IGBHD1V#%pr7FMk4)j}j1MMUjPKq-~VfH_{z zMG;b}HT`gSIuo3R!2t@VlMLb=4|F$%B3c`vqm2pHg(-wNuF`q+u;K;kYFVd;Tq!-tCS%A@1v_ibf?0|jP5d6~cJvt3qa*+~r&QK%>)jHNktk_*cyOmwnI|HPlh&ecTF0BDMU+O}o3>GC z9j`m_-5bZ=Rc|S08W0>r7|BN(X=WrjO#`=mYwcScvcQ3oyrv}UNPw?i9>_${0Y{Nv zH2rV>FhK&KjsxCliTnge;nqyir;FNIwKT9A#Av9{FU_08(Go z?~x)W3Z$G&rgpmEfe95rhg)qwR6}#IdHO; z={-?=YeU2YN;MoZyk;!o_KzJq)V{J7tO3q}1yDDyW^rEwq)9>>(ZHs4Ktw+G+K#=l^m$FDJ zw^G}DBvN7l`^h1v8=!aBHV=&XSCd6G!LLdephQY3?nn1E&aD}3?cWKq8WI(|krE25no?L<2$B{HBEANxi3em>5JD0U zicYoj@M@4DWT0)Dh}#BWJi9DMjVr(*x$dbPk^r%Ei97=&HA!>XNLrExv1=3)bCDci zI*}HKhAa$3pu<^%Eog6Kh4o;jVrYmh{GY0E47w8 z5wt|ex=<4%f&-2g;Q;;(_s)NH#pyZf*7eec8wcD!(1j^ydx;{NNkNn_cXh4ZU+==d zkoP6>l%N67m;v)J6buQF!VH)PrGQWX6lTRdECs>>W5@rp9LU_H3Q7?{D}=t5M^jj1 zjq-AFfgsU6?Zv^JahbwkHUn0>NiWiXVqg?Z3nf%^#MUWLq1GLz9C;?0Trne*?K&!d z^u<;5H}5@`XFWW7uFZngVA7g2KE0owIcgu=cjdesA*(Ei^nd^UM2n*Kp>fkSnoaD^Z6Y1iDB>CRGI)oI!ty?-98E|ucn`q+<*EWZ}w_n-50e&qF=Jx_=MgteV zQU^JJuS&N6?H_17juap}EoC$1N1}1T(TWj9h$^OtUVi)5vU6L002*ASJl3N(pDI1 zx3T8kTkcV97=ZXhKnm)zwVLkoBJ7aK`V_(pSLyG+==cDD&CFR10KfwrmZaU^vs7}v zI|%WY{xXXu9{32UAveAx+T4+58;&Adc)hoG8ae2mFPIf;&4$OQRrlK(jil&!a)C*; zs4;+I9m3 zc8i7D0Kw@awF^RuLf9k)q2@Kx2LjMVHUdePG|hgJ(iAjlPm`a5B;Qs+YKhE~h z*ZwQoI|ZwTjM-GY-s$w)E-zj0!h3VXVgsbH|W^;{p^v>7o92 z6hn?4!q7u7LCCzgkrYF{K1M=fsF%f4sEgwgacMyGBY$OIZtVZBltw*+ih_;N3&LlB z!71}1^f-j5@<&dfKtNUUDmt6!l#TCYQ_;<`aI~|0Jj)q2f8mKldN6rS39|{}}xPH!0#E$@JE9i*FJqU3Q4+(Sd&ff^L}b zIUTb60@N@cTuD~zykrf?76To1AgexsWPS*QX404WynOxVx#d?Xb(8TAgaO4E3>M<6 z;Dd*9jhjE8VU61}_h(X;0VOOQLcBzIV%CIQ43PQkkdcOg?F`fvvH`TsPIvDTvKT4< z_t|+?XL<@0

zN4|N-RK8|5emTn9?2l5Y2@epR+;*3F7yLJU>g;cqo--%2I&qmN-oSfqn>k&DSPFkyy^eJGE0rKL1SK; zoR(*?5`A?;25FG@BOyv(v>Z=jLe9A;z`_2v)6Q>k?Y&7m`?iID=e}kujju?5xcy&} zM!!pE%5FGjWfQja>r%ln#en3I@J~#85IuS`v>bj~-j+wSsd(ktk`mzlD zU)aNbXL3`4(mgn@wvLU?yzF0=jN7;9WHV`h&Bt=`AV57#iWUC_Vby1ojZ0q&9VU+i zcu!1P@Cqb_02p+Psi3$(uJJF5ovIj0SwCme?D!kM$N?gj=wVToNpwTxCI2i2Qz7Jv zNfXc-$n4`OV^Jv$+{_M8=vkQ%rt5!v&$j1jz2^Luln~>H z*ZwumMsto_l-pe56|iEY!7G4-=Pv)^&SdCXnU;`-~~tk*(XT zg#X{0ZJdh+zP{^{GWgyRB~-#|CQ>moFN`KY`Iu&Ug#=QS%pQw( z4Ed@tL+g`GPgr*1yDZ#I+upuyyPI3V_U_O7?i?9>-_1nZx%fDNJ~Mj1_1-M}xcm~W z6WJyMbQ!X@h^5{#vV!X_RI*_31v2D0M?+_- zl3##7{C=^(C#~X|;SH$e2q*zHN}cK#Oeo?;NZ-@lt6FFEMXA1~x??L_p>JX!N$T|3 zeV^-c&dx<<5Fo8Vv;5{OV>A+9bjwHei1S=H>(qRreHSLrc-q}V_ zjX!77eP<*uQqc>;Mve%p@$9Shd5KGyVa&hGOySG@@|m9%`lk*Ajs&pMuAU7Cede|j zuCwPEx%iWS+#`&TG0P>KNe87WRZ>q}ivIRDjq)|^KjrNoNT>S#I;4SLr8Ja_Ivt2w zUs4}<&3p0`@-coO^rLGq6&u8`(U9E$DhoD5ISKm7F>_S(`VVwReTN<)Yo(0tY;$8c zP4Fh(f3H z(5|>c7A^CoYB5A^P_jWJZ{52#B52sF6OV({?GRn~^Fenu+8Zr@pz&!y}iDZVS&KfbhVB~NMp z{U+O(OPkP3!N4)6)q6*^-Wlqqsb5nfdtn$sQi!J-zkn3PjQMsR z-qWOEBrukCy%m`{(3_Dbml{YHsa5d5s04Ehem>XL9av*Z#bIC#$eh9>d$6 zJAc`G`*0&(Is4L_VH3ivw71HyG5PYDp?R51y>pqjEcUqg`pgw5sY^{HNfDMwJ-ANb zmh)G!49M!QW)UV}w4OHRkztvr(no8*-Ghrz-5d7D?I!zo&fWCe?dJRU&7I{qciffU zTUKA3=I!%sUK%ZX6R(+vxpS1I2A3HFo-Z90X*T zQ{h)wTSXO}(AjgdC=CKMxr)JULJpSJFU~nH)1Rqbt5||e6*xk&R-JKsAVuBemO~Qi z-1a(uc-nUnCUrW0RolW1E2XH)WwdaCeD(&BV|Q52O>`Mqrwa&_q*++u)=$+Ewvhn| zW6^@55HT>l(I4l)*5`|l64zL+sioHl(A520_`dpDDKQ;l3WeK)U3JN-%h zN*_>OlNZ1|We(Cmb&Pjax0h+044ly7Whqe0S)ya$X~HWMD?#pB;_8%~(dP$%(FPad z6NgzPx~#0A-*o8B_E#hSFLGrj&N}MfdVISrgXM2Gq*xJ&_b@!liH#)lV;1weANQEWC=meT7fZYTo@QF z`JBUT_(0qLacy}w-Mw~gc9WfZ&dz6) z%kgYk^ShLC0l2HvU;8+xd-a`tr8IeqI<<64a_Ql>oTb(;ZANV^;M`l*(1Xa04p$V9<>hRhg+F`e^WAl`%S%<8-JaZv~pC zaG=`3LlJRxpVRBL_eZ<&uP%El_1IqbcE(4#zm;Ek0SQd2gEzcc0b*ygwhU!K4qj4x z=oLplkrhqDMC3Q;Bu`i@v@?>6<5JOpkT^d+|zjT2v4z z1{QuUrDni%12qZg%g{qFeo$dOxpYPfjg3>VWlST8A=(G&T|w~%dH|K=5a!oPLwRkDYGpI5$*&n24XqUHlv zK@nhLChq65eHo!6Nd~Qv`jbhH4)5x7fJgP!tcnx{j}vIUt1n7Gd#eHch^}$h--^U` z&UN2KunbiQB>sEpX4#IR zK=ZH0Y2yIJ8X0PMwe%KAqPmF~F9zRg5Pq`LXrkVTD=Jdexf}bT>+dt^_v} z-n}Jo1hd)j%r+E0GswqQnPI7%GDsxKhALiik9cxc5zR45A5WgUf&;{x)V3XYz{8KQKKt?py zdFc=dwC4mfJvh{ zcQ&ejD$?}RLt#*B7i9p{)@6wc<<&a9Ih&fXpVo>S1}T?m%fJq&Te(YkqpWX~v=x*>q^AR{1~3 zXwre+rEJHpG**eoTp&(8#z(fW$-CQ$Fj9M#5`%S9~6n=$)hUqIfwzfXd>pSk9ZQJp+WzlEHOB@kmxf{CSX|+ua zI9|>3kJy+}xMs3CM>q44j;R>WI`W~3)CW2t)#3{vUn_!kC^0*f4spay_c?wX+#Pwe zBlR35I}9c=Mb*6qb@(yW$t1lVQDdpoT8>A(u0l$$-fXQ+!vvM+-?{f}``f#jeVe%7 z8Krk@G@C!Dn)D4g zaao`~C4?GED9V~my@sgu6%m21$am(mtZHJTDk+J3(yJXrI*2526AZ}=d^)&>70$)T zJv)v;#>to_w42=Au~)r6sBx4|!xJf^x>k8-Yv4E&SGEGeu@{N1~zh?CbxOry)oGeCcCT&Y-XUt|woL=40t3#Ze%T zmMnO|#(K?4wK-x3Bp1UB>smmQ%TEVRISSM@i78^u&1!(69$9_W!y^}^a_qFdp01*9 z{o7`-*WQk-QV|9Bl6`RBfr9lgfPK$D1ep@d1J(1^*utryvlTE3HXu4-!1@z?zVB+Y zUbNc|*If)aS;c~SFnlbeYoiK)Mspi}gvvE9BOO{bHF4UdcMxB@yjpbf_dsP!d^wF z)(K*6!1w#_3J+tOYAKc+aY8l)$#dfAqdu$^Nv--I&E5*=O-^V-^LUBdPSO636N-di z*|blJl0W_A*%F3lluuroWXgEn^%$%q=@97(1ZJsMRnudXA%j`(9F`Z}ztt$15hAP> zez|#xd(b>l6*R-;9=IxLoY1gRpAJsr(O&B*6d^^D)O^I8OLC&Jvi9gXI0!#p}MJ8SD` zTA;8VlUiiY>G~9;b%{_OyY;_pSl&<5^;`Qy+xKy(xNgM#x)1g1imM-bK+J)N6wN!f zH3>AxQ2)p<%Ab!l`bzJDQ_Kt#EVwNl=uUU5_*6f;We19{{*;crAOb4#&SXtWk63l{ z45iKUw^nK;S#MzPjnuzEIW?_bVy|6XL=AO|J; zE+VfUQ8{z_b>naTm!^+vT$f1i-_j%WsooUlYd~e5+O_;qsBaRavAn5G0~=P0qbuI; zwo_mG!p=?1@H2^S{zbeX!GBU$nP)O*W$n*01QIT(!BzC`^3m97tS#T4;GuAmB^AAH zX3e3OgIH$Qpd49@Fccg2&OI0254t-PUWFb$Q<+jk*-N#=*;72ucU8fpF$nolQ*64c z@Osrz-P(t7F-Bb-r{6*)L4NdCC31>{o3?q?{`cg!OHN1MUhrAnTlZi()nsjuh{#HU zJ@hV85nC6gnCqJKFWlBVJrR9kc&pHDD@^f+7VFwhzv8SEHOH#b`m^B+&$BMVC!B!% zl+sj&E4J{9tGlH$Tf;>dW{^s9dPhz0HA7VH!n$1)_FKl3dv0_cj}h~IP3d%{L1#dz z$sge;aMF)mD={F}iHNC(>g>RzL0(Y`6X>p2kK>q!yYzAM?pgWJ)zeYc?pC>_7wwBs z?zRBtA%kd8V}LpqeECqJV*tb?6k@S<6JT1C>Ll31c)X)LQw-oaSOw+wbV2kQb77SKODs5F01?7 z&fvM>*VKH$ifyW=B^ssi)D%nWuT0HND=mnOJr*TXFyKR!#wznEm4FL}$OCirs3BNJ zP3lp2IZ%1UTIh$mzql@y1~~oOe*j@Vd)XKM0PxPNSIJw~Ybou`NB)y{^}PFEv&QN| z0okyOG#eZj{ETC8=qQ9+nA1|LXB-}YU2v2G&t}R6LBok(uKR2**leG*30^AO-2HJ? z{j(%stbsfBlsVk)vu ziE-V#;7$E(+s3eYK;B0H4Y`UbjjAY= z7At^U&z`=2ZrInG8>Y|(MX(r9M}$*F4GLdD_KDj0q84xJss{)iKB}-2 z?K99)X2=LkvpQ$Fg)mfmiSrY|v(l)f&S8g!f=>2FwdHj9|9FNmd2bU}MlBGWam@%=`_0jFc-)A0@H+ znaPN4* zpr2>s$Ci)!!gcy2D~zOr_-?LV|3Q{sWUk0!sSIweo3I`_7-Xja2786$2`%tD0_*0^ ztO2Q?RY81RiL&qawxzz2$_~_WRNV&e0mUgsndYP_34$F^cm}`j;!%e;$}>pIcjlMGeg3n^ z?50fBjW1>cNcdR&5s+|)gw7a&DI(=){j?nWl5!U{vNz`^Mo09-Z=){5Ep`6%TOntD zK3}2g-}>^6X5+$=yOH;zi%}06P&^UF^;B_9jMW0Ii44wjptvdu*WFPf zRf^9e3df#j;k8sbrn(dg6N(2{=Fn@8A6GewAcjH-5*rzlQYF#UFNK_8HDHF13K~!R zg0~&cO(+?+|0YKfnPI)`rC_t&n6qUr+_g7tnzX7yaeP{!i+c?q0|SxBek$Nu zB+3f~UI3+Wu#xxX1~j4o_pLj(_loX5>Nj3ZbPfD{uUYuvcn(~O@56e4>9h+ZSOY4@EEalAihfLQFn3^0u48#{cpgd zXFc~mHtl)|Qg&|4zP2-En50jyKpIjQQxSeBwH$J0F(n`v1Swnztc2{-01%M36Qo9x znQ~Y`9N0E;k0o0Dm*;n$4||@fDP?F#tezqfj|7=njCf2~g;yvI_1+9Ak~xGCpH4nH ztxB||j}N(j*taCUf$k2=Z_(;2Wk(AXiyjm-Wd0-uYe3GH(pwNVc`5)-JeHXHoV{Y4 zM^=e>_pMpql^4GS5YWl1yD2-<5pM{6a~;~ejeGjG_+o#LW9Bms7fhI5XND;s*^6A> zS8dwYv7{mCW)lN?zOJmKz+%{@R_t01eticI9wR9HawP?hAdpfaot71;^PS1XojAtz z=h{kbw?CZ@Gh|=RSR0?Xd4HwG5vpP!WK?KZnu$bOaYg)eLa~h)5op;?ieA9+s&vM; zOjpg;Uo2|yg_aPcNFa9gp9;(|9kEIWWCj6=2nd9fFrrVRf-6~~3~ei@#uVu#mu}@W zydl^j0%vuS&E#n3dtdtrLnk8tWADrvPtP@=t9_q&hwyB@3 zx>f(iXDz+I&F8tVW%i&D^+>ji;*tQP9ruQuD3Ne-5vC!7pibWj6s=IysR-!UTeP$a zUmApWU`RboIWCtIJffL%Hd@s@=IE`#XW2?UU9&uj+h_C``+6hUEYP zNMOVE4lwM_I0iEoEtwJkJvM3KJ_<2t2iR=dGXltRc#U+4X z53E%yZxvRNRp$$xFgIkuW`36$=-#|3`&SE_sFZErR(JUH3g>GFOvHHrkNiwaR&Kh$C!N&%(SNWw7C#Wl<_ z5rJWDQkl7}l`3p8OTX%Nz@sKqP9#SbWTcnADLWwt@hM@q*6WU35* z5k(p8bp(Z#26?=p<#Wc*fW@cQ7EQs4ClJX>o%LA&v~#ZiQa0kjmeRj}9d+yM#kfI0 z4%ae%@L$KguH5%Co@dtyVeIp9N%H}j1Dss40#nz{T37x)^;K)v;Y%g1J@^zXUrV{t z5SgqAb?u{V1N>fRt(W;)o$6n|tsAeepXtTbT6&G%2ry{$*KuXAB-S`JEH^+eXO=9m zfs8}N`US7a3BIW0MNjz*y|j>cpsfcgmEm-sn#`95B_!jq9$~Q62QTcJC7n`Ya$)lf zF(w)o{0ikyWka`a>*1Y#hNEL;^w$H0_Eb=P2lP1zan@)FhFF0TP+D;93a4osSJ6wnkR<}fSqRVe%!5|&1V0()~K4= zeBwRC!7zv&rY%*p zSV6*-^gSA#?{2z(*_PuvtB!lYqNVHnCK%39;8oXkxjdtF}Tp@R6Z?ZY%mtd&UPFr4;ug|^t$8$oK3EbLg7;FnnS z%@IIfQ2Zr8%GhV-0hN+^86r`{AWUYY)?u`PP$;M#MNQ;DhR)Clx#seRz$DnBo6ar5 zT1rt;q6r9MU{~f$WT473Y$(SO2yi|8My8zuN^Yrz*HF4EM>^5%5 zN_Z7<#Iq_SR%%))^oNTT#zl=+wSqY&9li=|(%?kgU%NK8ETSn2zkP{Jj7fpid9T5M zOQDZ5DIAp^wJ>dcN#^gwY_9D81O}rGK9;=)U=LDCsU(6*A4PyCIqAD3zjc(Pgyrx3wYTzAEe;MBUY&Z#PPtVIxTGVGZ>l-*IN6vC%0|0jNLHJ58+zJN$u z!~PpUjG%Z}Eu()enE7twfW&j*$F@=EEN6ZQQpQX)fu%?d0oVx*f_tPQPzz%iNu6Oa z6gA5NSo40JORA20TJx1}{Txf;B|!r+lQsBEiro_w9$}qAI>_|OVzn4^tmOjfM1~MK zik?&fx^#A1jy3N&0(<{^-TZ}L>@Tl>ly@nxId=O|mH5M=hFGmoq8uAoMjsj*0u!`H z{&u65j)>k`5CkI*M9w8B5@x-l!Xa9@tEi%LJGr~MgV>r?pFRfB6#-PHg(=|_jzfe; zW9#x>-hkX~;84T>CfiB9NRG<}#YfXC(S(OJ6kwz!L1n?x z1dxC-u#yBoF8)1!eg)?z!d_ZD4vPFDrc;4dDj9`&JvCLFbHA{biW#dfKr6H7*k-D2gW?EB*X%Q zMaGqz6-6N?mFv@rPy^2dY7Y<1^Qy|hf1>78u{|HsqD5KI1zO2#fS=K2fc|5l#Ywsz>VN zL!iRe&hapiOKRrdVURV93JgvV)KvHn_lsK&(Muc4pDNm{a37tzU~f>Xk)>&#kF(kW ziuXfI7%+)2AmxD1j018|)YL!}fhu}y8OakTxxOsy{+#~@k38%UoB^1*1-mmR*t2Kg zw%u3hOuY72Kbz0WQ|vtm1g7m1am3U9=>P1MKCGai(1$nhfm(!p&WQb##Au-^9UM4| z*aNlK1SB2{o!BTWQdkuOGABU>r4bZ<8J9TiG=L@=R#0CwXoyntOMD^oAX?+2bbHKc z7&}sn{L$p&3M6bwzfNDfrw0w|#>deHmB#V>nY41ated-wyL)%f)}J#CrHbzn8Xznd z6Q&)B-Wr9K?8!f3iZ-x?mjFg=TonNQopB^E(|Wcb273ur5y0aL?=gZ2G$cETq1rAj zm-hf*5D)_Z1OPHq1U3KwUu8bke1Vh3Oj3J*ZobHofv_q`L17#PnQy+B?p|_*-j-}z zj|0Dt`tM+LW&mhp;H(Y+hynjrZf)0RXB2I7XDC%VR4opUl_Y0mv0XgJ1mwjXDpJI;ZDpbzJ?N!^?riy7 zYOjD&(Gt?L?rfI!xxQdep~?a{Tp>MXFyV$oCy{r1Y2|b6(OpgZt47zN*UK#IhW%ZY z`30S}!ZeEiTDe;0J#NKxmiCp-uG^=5zYmIn4fD~UiNIIE*G3!%WQZyT_*)!o>;-d3is%76@Qu^ciE^l;fjlX-Tk}av2 z2H<1x;@n^$09R0Ig3!Sk###}wm_bvp^~hB6W3wg{BpD#wcIVCz7o8+~x|PO9%_l5! zj{0AcVMQ-z{l2lQ_OduM+m&;(I??Fwl_tuo(gV86RlDWgJJ;DO)+z~m+ge>~uDqd; zm!IpMcabIA!%))}8S}KWH}C#tgT6%5?t(WvP54ydXy5ImX=}o?m)V;FOeM#_6n>OOQ9mjLtm306z?)IQ6^X`rfj58tdfW!=gb zXLYcvR`$9YG*IhyHJ@EIyV`Z8H?NCB!?yURE2H)06+`v@4$2AF+cEsybl!m7W}z32 znG3Js1X1oew8kJbM$V>bFY6e7D!GZsl|(KbEMK?C9BbtVrdp+i%ym%jxCN zC1tcRkDK5rG~4alJx`s6^>&FqE&eir*X}{*w|8~8N)Dr4C!d|OU^f&7sU4+l@wNK` z{fm=At*uy4nIl+;8<0Z!9b+)Vj_38_802n$CmgY&tE?9o`tT5!y*6ywcxv3xs4kql zsD4L1(_e+ighzO?%s@<5bG^b6>Wz<{kBoUb5n}N4aiNb7Ym2(PwU?f`*#)jeA=UDA z5)OL1&6QFS?;(=32vsK zhvTVz8%_VS4+%MjmFFeLQPcs8!Fp(n|FU8MSp@0kHzMw5A2IRA@}J%OUQSiFr>frr zVYhK8`v&ei@3ruuG6)Wav~Rpthv)p~L>i$p8*f}ftgDTlY+`D__C#VCR7Z?CUr@vn zp*V$YvyLQR`y1vzHmxF;jX8d{fB!AbK%|7L48j%mQpL6@Z-u8ThA&!p=Zn?kTB%a^^_L~ZHqSC zv7(=Z7s#~f_0szqhaJ0I#>_ZX&0~^t9=>(+T!Ea+Oroz<-;MzM#9tqJK=M4Q6g?a| zDil|I(_bdYCuC(4$ zM%wM$`?fqRFll9*XJ+{L?8y}*8F7|SBf zi8Ke&_^-@dYrc^^-7bE+xvPFpQ;XEC`&o5Ou7pa#Y}Xxnj$KxwM~nZAJxKpWXH%7_ z`s_VBuV%2gSta}9b#1i!@o?6^SQg~KW-x!$doX@IZI_(!+a6W_-O=mzKIUz=V(%0A zU)%4u#GfH~_f3QBcHtXYcCPA^i_do1i;v1Ph2@W0b`Q^vB#>XU`S3HpwGHgwJb#|e zE>|Zeu|L(b(P$<;0VkgQV~^3Nv*B=QXsm13!ia3F^f~MH(l_IQ{s=B8-8A*0@TvU4 zfB$e1cirf?t|+DzVU=6RHaAYwo0cg=4_gEI)yi603i8Ci;I4aK@d0>@T^^CvP?;2X zZJNn^-%c(C+pxKY&#!+mDL3-RbT^#K-98rlwI@they?OaYhN73c5YAlglj>3fA4rZ zyDe{fcHd&%2r|pr$>;`0zp`=T*!yYxAOGt+r%br$ebIb99@$8HiS}_ zKc})E-n*6lzJ)C_P5QZiTi^NgZ9fHGTxEXmcOpZ5!UJYpZf&} z)wu>Mr29)hmAM1+RpQe+vt`P=QWBdAkG9N;mIQw9MmRueU}X*^8) z{v&=@I$lybxcs`RWi=_HDAK5XW^LNgT zwd00M%;bK%KMzvO*m&pVl$!V}JBs;t|1&cX-bsr6yueQ7Q>$Or&2K)Q3dA4O4&}p( z^u2a8RgAv1{r#a0fbmiM&VF!yPy20>moDp^KYN~X+zi8q02FJXOBQet5-i7xv1Ux? z1d#lpA;?%@6D5#1vRnlNs)yy`U)PeAWXAOFKbx{&vcQ}qh13allu<<BG%1*Ra7@LZQL& zk4Q?eb31hD@v&o5sAEKfM%)96Rsn7cIZmEhiM&UIF?tF>y%zHTgyX1q;OJKeY*s*W zO0aI4Er&2I2c*X>ffAPh%=VW_%XTohAn(h;UJ1n%nx)7W>OOUBGX6COg-`uELCNXn zG)pvT3J<-RGaWP_Ek%$2a=F>m0XT%7Z(ttDX=t*s$nRmq^+G94e|*VbLSe)cfJYd( zKlwW#x#pATS28(_I#bAB`_E1-tg|@nDGF(-BUU1aC098n6L7)}@Bpki;rADMT-f!I zsy$TAMMa21FQz3}Fj_WFm0R=AXaD9KLgRo#ARJ%#vm-V2^IU(u-sRm}-t)GNeE+E* zjK%@UTumdyT@WA@QHY_e;v(@W{NC8Ekku`+c&OGOxCehhPc76&f4cEwZP{A-H(SRC`wHFmaoyNL zKvEGBsFSv_+;4qG-Y1_2$G5*^u>7S3FBz=zDqkh-89xJ@h5z3@U-}d2=+0@%q|yM{ z>Ut?0={=QTjd&EEqrS0o@f3DTVSx50|d8$`85}(wwJreAU{Oh#cB6b z)L3Ymn3zM-S7o+_(g>dJ}5T={I22?@|JUryyP^ncKW;for=a@Uor)l?}f49m+n zBMK@`&{QBXjmU2UZYqdWHt?J3dSaP%@f5lIdINSjrLPogV8o<=B@hyFOtajttpO?I zvm@79^gKel1O(CLNEyJ&M&8e8Z$@0Wfrgx>H6`r~;LZuL|aWMEPuJ z6>#|6e-+QPTQK4TAfv4vKn`!Tmd~^RhBA7>s2@Oc2pV*{)QAIk7{}N>H42{7)=PFYdmaT?TC z4tfs_9H`7W8yFRJSh@@V8z_5ujc(s>z^^53bb-B+y`|CT{rUC&=)agB%Eqes-WUJc zeOs#{0FHchV`~%>F@M4&!5s6=wu%qtbTIN3F^`Pz8*fpPf2en95l7%L4-Y^j2_gYJ zli|~$A?#-^bhaV6HUH?bN^vr_YG@o*YXWmJ=}&CO^GD1fo$Hw|uPpn|HTpmP8R5mZ zJRJ~-0D2$Aqb44}CKIFr?H*!g`Q^7~2>g|Q7-9JDptQOTmiMKd<#g{>cY-s7}*M=gUm-eEYc?4Z>}{ z_T;vb?3e8`D(2F-NmMZJ3{%tHYW{gq2IZCLeZoo*|f={1o{&Q(a-N;+l3zA6u(OLXkB6CcuHWkczWF z;4+MyBpGHe`wLW@wXb|fKv9wkQd>bh>UzoYLL@mWz}O-MmMgIUx7hxiAim;C^O@6C zs$-?jTYSW?jk}L^D?57Ag=w&eb4zDo(x{3?0F7B_aqEy*h~}sqzWY^Hq??#n6D8YT91>3s8~|fLoWFM(+m;Ih#v2M_ z%Vw3d#anJfP~DI5r(}#PJVD2G!qV9$QZ2q(o?kx7;B!|5?$)}6q#=p++Ut#l7j6O5 zGEupI%qmL7mRfq7ef(Y|mQRH!=xVfhRlS*w=4}6Xf8gI+?G7WN8k&iO$Ti zdM2DBktxpBYoLyXU-Y}+qXJADa+E4zJe~xzT5pf^P6!Si^!^#cf1dE1YpauXl+H@+ zTHjoM1L%tNyaFi`v)O725@s|jn+Lp%&~q%COU~mfT9=1uZ#{V|2%5=%7~kmJE3NJP zE|Li@Efw{j39>ko8`Rq?n4rsMN9*6;)6*;@HBj7)U?6^;;$r;775W%FwRiM2JwYAT z6#QGoaHjOmvTK~45S#{LQLL%sGk9$bU+o<(Km};T!B-p{7>W}eu$fNkpCU2%9vk9w z2b*B(h6;QkshElkc;lz5#Vg}Z%Q@j@VtAhVhEhhCcQ`dMSr1cZj9eNb)8z3{OdwY{ zo#&~LP<0t|d_xL61ng(go18{00E*>m#u-hamV~CN_^9A5uk*N-Wc9rL;}6$Ul0Av+ z{;1Q%oyosCc5$i%CmL8paU11nqfLOm7e;v|A5ky2tR3XPtp}sZKRy6_MhWn9|LoRo zv-fr0NYmB{mxw;rI9Zb)%sAPPqZhw4Vi*L%0Bt{xiU5j^Pz$p)&r8nDxvZ$|wUF}b z<=k`MP0u%qMgWILINasBFUYSCre2lGd--GS${kmU?MMLaM=JTVtI$|rIU+M!a@;Bb zH20vyw#SF?r}F5~14F$B4@{7@h`G2BsdEZIaUSG*ZvA&J98!-nug)_(4O&aFo<*)c znD3o$b6en4DWSrI3cW)sBYqg(xQy8vxlq4T|KHe?D`$&g(lvaC2$mm{2du6)XEe#Z zNN;Lr8&3SIc5$IXtxn~hDDw7)Wu}^O6i6j{rbdvDzqK9N&FZwMCtjLXB_~-0E-&3m zR*Z$!ms?=jl@amN`7I*yINqmD*pK1k-1Bl3AOUcfesLwH;O#O5i zk1yZwsdZ#>J|&g4$wxe2*?dbs)X>sV|ASsQ$5J98xjATnboqzo!b$#{^Ku=G{^ga` z&F$TCKF3vfLwEkNl(ijlo|j7wlP~f$9Pp>LKw_d#J@3YLW`jJaCqeiBxVckYGN8OD zhF{K8jn^X0k>f54B77T@X4r3cp0NuYGOcRfyh9W!ypC^|36;iqjyKZ;+1krQ$cKIa}QW;$1J(q ze!jE3QjHX?5=1OH&Od!ztAfdPmo(%^9f4^@~eBKv14e!#)Z!Yu4t zS8ZO%DKsvJ0iu}CfRjikG<+6A#qz@UF$CpNuCl-c1X3!s(?=pY4L9{Xb?785^XaJT zB{u997MOJBXk2Sdial8cHhldg25UgemZaw(Z1PkAoZKv({Dy_j*y^^*#zw})_0Vtt z^!*PaMmdlYttQ0dkx3{JfmtKfn;V+0WB#`X$-zeh4eTuR4Tr!r{DJ1hqOu_=Ow>V1^UdNq)69uN-D;uVLW87`qoCppP zdNC=uo8D_MU{Yw~%!SRM7j93QLklf$Buvr4Yo@ug*0||!msTKKdcfJwYw?C1i^cKD3J!Oac zU59`r<|jgfl=MCr2fmUOQ9w*ma{ z!`^nv!(j{X8N)~bJ46&>feMc3ub^Nga2O6CN>>8@=K62-*&1-KsEfZ$ybLhzV&Yt5 zvdlLG4#pu`IGZBfB;0*7UgWLmC6;si*S>gng|~-?NI}zCFS}KsAA{7Xp{4f#&sKh6 ze5Rl)whTiMp=TsFB}k(8=qY~@Y*gNBB~ri)EOCgv%_X$Pa(x#T!19sPz9cOqfl`p{ zX-Fm&{S7EeQWZsEV)qWixtm)WH4JxGNIDG@be$tbZP}M>IM%OPHf^moIjw2%v#!Vj zt_-{~MDk{$j203JRU)MTM5?h)4%C_vezwk{^D2fu+pE~@k;ZcoQa~*t#O0NjI|+X> zSCuK&)$OBoj;*Lxp#u5anyWtG+QyopX-njE+|Et8m}{ibf(Zq3G1heIqjio=yfF!_ zY3H-Mif6{LuR3Eu1j7_%{`j~JUHre$ff~DbHT!XHITLl!f_grL^y;2gOksd%aQVjLGP6` zoAm`l0E`=)#9JxC6nh(1o2X+m$uxqC=zVzqapIXcFoIs zkQG!0touX78VAi4mnTN1KR06mM> zKAy-K)*^=%UTcZy1Pk+kC5fk6*UM%EnDW}XzNstpj zpmSF0h=nT$@6iplzJLV)nvRh4wynvO69lB-dkKbMM8g(Bu^I^pL0r9~TirU~VF(KY z;#GrfsjzskfCVk&0Glyf5I@zXj1fd8XS6(kXVy6}zyOF*+)1^-61W7vi;S6rX?BzC zt~1Kit@Y{7f8sbBU{-Cjs+<#zP(u_m3f22DXcVV1d0&48fe;V^A_|{*LkNoj!_UgO z%f&~lIk{ufmmAEF$`X{200&W_pCHm)AQ9v!19?Wtp(a_C#7Koe5*!tWDXO0G#hdZM z?S`JwW0~~U?A;fUQiPb%$e5VEMgsUuB9SE!MF$j&mt0k8Zd@9O&pfH$f7?&`_ ze5APmAh|~=4W^3o?!x9p_Vg?p`>i}3cD5F;hg>D50Y8SiMG38*sbkRD(YjQtabn7XXywCLR!O+y}n8K?IGGeu`ERT3#Rk!zdmepPpN6V~LQW$)VN=eI5MFs9kxPaLPRN+lK&wY6sL>(V zs`ctJbSPw_VK~*j;$cw#i;m;zQYglup$Uudilw368zH4KhcH6ZiA^UToc6RyQTC#pdhuuq2CfCHT9SR#E z(i@4jRzfhDCo_xDeUD+Dhhe5eWhJ9La3XXY)EN~EG+IH9c4YwN&%fEv^pb=`+hPWL zlQKE{ZSho7;=aq`|9*W$ExxD{z;132`nSb#UfTF z=UE|;9Oz~%1>6F?Q%mQ8jbOAEYqhsyFUORw@b9XeL)X`44 z5nB(q3vKhMA$u=ZLTCmUY9JKkpEW$6;_R8`-5mD85+twnaXRhVGC_l1c(9JMA|K{Vf+;3ZL7uJ zwo3|6*hXCELucL2$Kr-+-Kk zB60NFnSa*g`G5Q0&RNNq%}KMwkXg0y$*kfr!Xf-ZP81%X0DRq)c5{GJ9sn=|8mvSZ zBw=16sRSw1b$w<#UU5#2z|TC_Iv_a;S~S|)c`(wMqf*89hz*by3kg%3#J5IarFU{H z9G^L+ngODj5R(Cfx}t|Hrzz%?L<0wuA&vBNOlqdv2^cmsyeRWHA6w_${x4tkEYvg9 ze`WhR2Z1R9jnk9Xdc8(!?lV9Hxky=@#86Gr9xfcX7l?{m=hUov^mdIfWr}6e5km%M zM8dSKqQ7i@o=dx|2X^ zPDA<}CENYNk_^0v7+`}VWuQ|0l9|y84qn346`kF!RpNlo=}gi0_|X1j^7w@Qq4C&{ zu-IyV7Z2bgpOhF(n4U4sWLO>Bp?r#5+6Q>~iLlot=TRU;6CKu2fRUC5l?F=?Kmy9a zN)rIsJ=@`Yid)@+MOMBOUs0yF(5DGjF*u|E&$JZal#FtK*<`nFhw~}gvV+Bgl|-@% zMFW5)84x42qX3J8oCuINDr?=A-MAggr>v67W_e<+9&nADiUwK1To4lROsg>=Wyi-j9rkDTQ&1J~SGe!voF?iB?TI zLb9<$Ni_-m)1b*XlK>=B{UO6(-Dg0ZeL&8LKqv?*MYpeHbn*WY<#v~1Oj#j-)C-0Gj1PNMlKK&`#Q@SrQ4~vI&j#j-ZEt%l9P2mtj z5Do%V*XEFH1*LlU@mP44Y3qq3qCQVZcKxdl%l)(Z+1B#Kc=$~S;y%_p=pO|$S zfT}w>a&1p^9EWofbQ;%W>njQFj#RS zLW@GRy30#*a}stW-0zjZNdLZ+e*lcg5Yf;8T!8_2^!;Paqo8MNEMj$KNrlg!SM35= z5{s@c9*lH>C0iKBvB)mAJ%tPru)vmei40`Ao$d@F-L^bRG8(k3oO3t+l~xYt7#l0g z$qu%#a&p9`yH`#*K&DtCXB8!;NhQ~;i2#NG0AyysXs!Ue`)~WHyAWvZ+p*oSwj6=G zm{1lr#=thMR!4GaDQzs)mbROcNWV^r3Ys*eY4FqFC)!V`pWi>B_wUAa4Qw6SG~Gh` z+HRC?Z6aZ;9otL0ibuDtSzABrs9Yl5o?C<@9%oN>)ZQuX?zy(>W4Hc?i`7#O-}c&XT{`(0&I`v|YZ-hF>$$~A_gRc$WbX^Z=(zmV z?t82Dix|V-CE3#;bvP^Bun|ikE^UGCd(sN2ZWv?6pSY<1cDXT?hF)JRNc|_Fy16%Q z*0*lmR?A6yAgC>NN0KhggqFDOQq4(6GH?!@v=FAavM`V$p0aI+y_xuf$=<%$S2cjw zh>(P`4#zGdjkaPBPsGOjY5W zexNhW?8}TpTxw5T;cQe(*7BDp+ zLKth^FpF#iYg?WZ=>rEy>lb&YeBOyeT~|Evlh*2pR4krDTcxt3Hd6wd@!py`aBj<0 zq6sA0riqoc+!027Tfc~|T}V6Zgtjd2mvABM&EhBOe`BN~FeX!SN)tfFC(e=ECQ=z3 z2ZIwj9)+rJ%OdyP=ob7g2$V{8c$u2zFvKcEu-NF|t+)h5I;<%~iu90VF|f!l;8VGy z1|ji091qz`sdpQNT#TLF7=SpUw2U_|M+TFS`z>wq7J=_$oGpQ>;|i$V>Lz_{X_H`E z*tb}Qi&*A!ngrDIgV4M$!8I>fg5B=*jpd#yEZXAZ+U9pza6n3ya;sm}U9!!%cyE{W z=a6*;@?y3k?vZu){9=K=1>NNy)8g9x?nm*=AZ~*>w-m~Caw_!x@rju3YjAHo^7y;K zuO|BEM=Hro;UY{?3uCEI5u)tAZJzZ8Cb2^93UTXP@DWR9EnqQg!{-(>L^3h3H%0PF z5H@9u+cKoKBakK#G>f_2hW8zLj19`T+xbv;fV@*aqpPO@lPn`MO)b(SAfLCU1Rd$e z0cJotq}OE>0!bL~#Hqjt6J00#HIhumMz2MM)QLFOP3`k$Ab+L94OIVLm;>V)#5g!b zLV~qXSxHg3;*-c2A_hueWCd|T8W}kas01?&NNoE_5)*U&(AwlA9;R;3;~`_n##D)S z+R+&(WV%_};o1;4E|&_zaspn$VPfq5jvd>Ap!pTaB~u$nqC|-XW;_9(yv)d497Ylf z??_9XI0(&ak}c~j9JOh6oBhhEEQwa}x=gsF_9cWzx4sQ|!q#n+V9mcyU6~0GQ)2{# zTdU-jckZ_W&^0E$0_G;`7rG=^cb&=ilGc|tw$@fX3FQ!Bx1R5^|IRMR8g0{U_5ek4 z;DPDPXwKe4-^VBMHaKr*!8CWokOJ&t@UvVJx$55iAgf}Fm1gXaT>>Ho?rKr@Nk1oM83r*$OWhrwj z+ANvbwp>i9(x6OG%BBbg&UI)d&-?3~5;v|5PAu{SNpN50ElRLAPof#dzlbO|WaJ}R zjW?1}gwWbeYfAIu!hzw&<-viOa6*y`r* zn9JuTOXUZZSUP{W9J7uim;vF@+}@RPMCdY~(*lOcbo(RxMZP4U`K+yb5>w_wxtQId zNE_NC&JutJXylnIP#jGp#UGYFNT++Uy?S89+OxG7M=0|(&YwG)6o_z!B8el5LKiu( z%`91^wGMxh5>wHfwb$naiC9K&n#R5>+qrE<_|_H)-tSMbgbbX}*yuS`?i8XnAdzh5 zDq??U1O8@OPqz|+^ISDSWyaTC2=L&rR~5g%@%Qf3^o7Yw)A$)IL>`^gY+tnms6~5k zHsh>iijO%)nc>>=8Z>>0G5i0NT<>P4WAe9rNApZfQGdE`{fef<(86)`qq`m~{ar_Y{{FABh3qdRr z1}u%ET85m6$sGLIT__NoFXL$43B(9MQ4HPZ%n2~oJb>)3C_Y4Jb;$aKRLL#W8l<8o zS>}-nuz!z{yaz3U8yRcMD7s+POhG`Al@Y34-J=U-EiB9r$rlnYQ@=7Mkv0Rk&*oge zh2+YV5Vpv_NEf3hp|(T{uz7Eqah(W(!)HVjI8bt(W?^tFX7a2OmU)c%Mf!sgC>P0a z^J$pi3Ms)P*f`eRS`uwd4%UWc!>|iFg~!|?AVwrQl}rnMp()HNk5_T?$Kgpc+k@_D z__5>o%UO%(i^JIJH+(!!J%BA`++{ipU41UfqvtyinMk4yV}T#c9nC4EVi%}w zxiw<9(MSck8h;}=f$m?z-G#Mr?kWWiw@}33Kg5ON6*=a8QicgNpqEn312CAm^NE2N zN}U0~)?D6GcaZehc}`xt4hmgmzu5Z&dI^W^%>&f`+mqYPuIiFWavLFLBhY|j+A zF-F%Z&m%9vls%DTmIs*htslJ444A0ty{nFPpWBu@>^;;R>tk9yvf8y9bvwi`=zOQ-LGU~zMp9kwMl8v2XSKmf z6xjK`>X#R0Zt%-6MUQQkJGzI@KcwS4?}z=n*SYp??rAsohtQ^eRZv(hlp`#jXJYfF z+5S~P2-8h>O6vwChce)afGbo9-x`zZ@&l9cSA*^O!Y1ectl6&@O}~{SEauf-44`D| zEQgtg^NS{Eq|%nmS)|u-10Y(F7yLW+yJek8p+0EAJve`pmvJ=}*1zOG_q4F;G0=64 z9S1emD$=a7lc}k#+<=h*(;E$Pa3%gQO74frxv5-nC1+RS(Cc!;_FrxDWs~ne?l+?Z zk2`JEnzAsh=*w^&%9?jT@hIXW96jhNgC{|1SE1t{FAjHfL+QcN?~E48uA1Y<4sE|XW096|p0&BT zo%*$TqS>@aWaqq~cNsc{Nf>cSfzBLa?hcwd-y>i&pK-^SQ>+PouSuYZ6SwJoS!&md zXr_auMFja^m-N;+3)Uv4+IZQ^Ptz3Bkba(c(X_eOU-1&wVn)*I-{*-LtE$U+7DA!X zEZVd+oLdt%$GC}_Ayf@%g{ab_ypQrIU|a;dxY2IeoS?^sP5t9NmbQn0^v=W6U>6th zDf43Xt#7db)u6s@%yD8=Da`-o_-!8TZNIl2epv;YWu>*Hox8!f`})4#^S?~BkMEv0 zwU*R^%)9=SqH#)xaKhl+vr^dtmEDRmF`u5qGIsX0yTt-+l(`Ql_Ies4# zbACat9#L-4^AI3r z0olhz69>;obP4W`=b=(7ZM(KNdw;lOwhm{Nv_4VOa4hkW{#Sg0mw7f*?8SdomD&l? zg1dTQ6lpj;oYea(daLH1YiXwtv*;C#eu&gx)L8uO zH~!0(iNEg?QcN542tq0BZyXhBmH{IhVbM&SbN}M2pBV7x&LpHk=V&e%v^?}i0_c3A zSI%n9%#U-EKmdtt*W0!kdtHu}X!MOL!zJ!rADkjQcs#2o?L_6-T59N_5zw^n(>~KXdaU*aisk%E5fcB_MXlD`<2Ht6yu4l!Gx|n;^_|`{)4i$BK-_K znk-;(ME<$K*+@{kwKIiUw=m4ky3#!xL+ZuQPU59RvMsjh?FH zzxEA=tA2*(&o?JFg7u}U!oXBaifO(Y`^jK1Ijquf<{DiOvhmAi40_En`v?=i8oal1 z141nA&LjDph$;&OP$f&P|MV;_=4Lv`17%qnJ#8qNu4Z+J2aN0xz=QOoEN>`M&=$;V zK9jyVPr*#X0lZVBwOsh+;sPfj(unfgo-91$f8)YEHU47(5F25JQIS}PcgVF!x9PZ_ zic|_I-2p9ExkWR2;<--{%Gpd0>G?O`=167rpJQtbxR9k~ZKf6{o~5e41SF7W+PJxT z$R2sOZyOL52SG+*yz zsc&iF`l^)ol2sj7Q=YmOv&|Y!8;jB8oFo9undZ3$d6NdH&K!5T$)!bHs1Wq+Y;KNR zYy^7W^Nh_;f)a3o491c@`k)+#-Y+T}nw7YRKHIZUbX zVin!mB6sR5Or;FA3r$!C{}r z6bA5^pWiP26uqEI!hnC7U#Vw<&QSy`@kBn*)aH4BBPl!aD-oADrSj}HS$?q-I?PV~ zqUUoSdT=?X8z$E#Sz)~J(cBY#&>jLDzY>T511X|6nsqRJ^YCw+4)g1Q9s@HC+uEMc zi_>E`lXjF~rDm0>je^opRreIDr8S5+wO3dEj=%P1iT|xC!pd+)bplB>kEq(rWmXuq z5sfUW2HYKW^m=3#By-`o+!JAiMfPcN8HsieJU{6OxWdBJ zzSg7AXvW9kbT~lOq97`H%>2Yisdx+93o5=@&idSmjyFI^Ae@!8QSHo7EU7t$?j*R$ zSLh|jSiBS~d-@v0myi49UvHGNjU%&1_4NXYa;%DVxN@8N%g2v^7lL0(-`@=#-d-=7 z?YL^Q%Iyu%Q#1|*EJ05;pe|j3vFBMw$Fn+K&dik;A7t*>>521{NXqJ8&$nl!vN`23 z%zoQ_N~Y%imY<&5+xSx{>2sE*LB!-#eHWhItYTMdxIxy05(=hAE>E0y z!rm&$Dx9j*TQCzvb!Gi{0%{}Ic|@=D^sht)OGg79s3|Q6k7+eO8y&2>F;kAc$f$V0 z`@HSHMSg>C+}K-L*u7_c2<4UgihCNkS2>II7FApHbyw!7nOe@gIFgC8BBPj=FFTy^ zm%sJQgXMqa{Y4(}6~E_miS(jA(7A^#*y$ka$={ndF3JkJ#$&q-2omUQZ$DLgM3(`| zWJd7v(`|o{13}BeLyGQrFXQ|uGQ}9{)$n`B{s0BSCV%uy{KU=Gkv%< z4VXKCYBB<>QM4avX=u9hc=d(ZBhy@K4&8cI*q{yjw;PPqH?W(Ji$^Uwj2R~2S#49q5A|0zLK&(!g- z5glLBhT|6PU$!e7wtYP|g&fR^{dsdXR;g!8T@1j>Mh9z2^=r8M)1`s5vod0YQ7I_J%cJK4s;dZ*?d=$nowtdG2xm;x z1kzQh?<&mck)aZIYs#iIZ~J9XTJ_k%VQ1zkDg3w1g+CHcLuKi7J0S1E?0^=Hu*td_ z^a>;CjA23w6-0HAC_pEWfT8T)wtJx}Ch$HYJG3=(ik#rCdy}4HPqDYx*;soLTC$Us z?JZl+z6WO^L(3HP2PYkChVhpK1x7lZ+0YQWped6pMlJBBHfL%Gx(W0Enzrn1yLN@q zhHA^DH$J(UX0flJvAPfw7Zh_qPu(PPyQIfti-|cU@uJsm@Mb^CQwKjbh_Fgge`nPw zxFB$d6Ndw66Ot;v1Id(fkmI(AjC)FYH1`BNmaQ!hSL~BpT!HnA0mbq>P{Y zZ%r?z;6c~HLZ+HK!GHUVKCYoKS|Xf`L6}l-hluV{29gTuvi1~IOyGTTcbJR&8%V`3 zUHBLlB!Qw^jaL?tM;f^Urnba}J;uUM3O-L&SZAIog@}+UNze@941o^vmT>(XttzG| zK;`r3kuDRWm2;iR;lsQd;+#;=2A^88iXPq7(p(H3o#CH-lMLyS-2edxD?0TH_vnKC z#zZqiQz>jBXlkPz-(V`u?xA`8Ub}E18l|?Xr{ZB9*cO zI-@8QDOwhz1G&5$eBR6<0F6$?7b;Gp-HkWK3nwpxJ&-LCEPt-9Q}Ra8ox=Pybo43_ zaA_w7mqrE|L!H)YFr#*H^nnwuwyv`Jmf4;vF_0>b`5pOn6}@fLmo+eRoR6c2s(o-= z@d`)*5hFZi43NF1uXjMAN>(-CZlvQIPoLzz(s36-D%dhOWw$J=;(Qlupfz_w2Zhmu zl}c@unE+Y6e`zgUK`)*iUaOt3!=_#R56;xz-kQ8EzYvF5A<#xrQv|YlINn+%q2j4( zjEreMCDI7Ax^RBfOvCR=9FZLOv}2{@0IpN`1Xn>AFj_|daJ zl48!CLqjajI9~mRqz#N8EWFecH4;XGP|C7#85)aS83^0zxjc->`nI`Pi@wAY#*By?i4h;_gSxl!uZ{?Eq}07Pb<3*Vp@u@P;0^DSdw4@u(+)tF5_AO|XqQA=`9jv6Ovr&7}``d*o zEZMv+&=&9(xEJW^91;x{xHa7_?M(r~g#fALLy?pPv>MZCmyRbrk*^yX=3R7px+P>7 zmwc)yUOlUKT7_T(39eHLAf{#GKq5wB3fic9)=STlfq%THqiDn8Y z+p~h6KeDRTBU*aM(Jp7+2+=yR5~lcl%6K5Mh1w>_2D#!(i^DyOak&hC-kIn*g3D&r1LQ5|aTk>;r;m50c2L2^7!5Yl%< zhcSj10)|3F#!B8>m(&mh(W{mwXdQ>EDOka`x^uUk-lkuS?$ooX)JY|A4nwKXWx^pT z6!aS?P65u}CdVD>2A7n`OiP+@V?l!pnq{YrPF0}gpy(0T69k8kE>qGGY`!-(49=+i z@B4eZLu&V@$iZ|s|HSgD>AKXWpPm|4*ymZ0w7WzMBrln`;D~POKPq&U4rZ+tu_scu+LZO3gIcsY4ijpl%gLnH{1z)loSv_29 zEsOhnRh+!{arB>af4+8WF7Jf6yiE%uEO2R%F0WLP5OFQhExLQs#7{e^LCD5uR3IAw z%Ay@c#Tr2Z_{%&bAv{HAY~$1wq#0IN<#mR|WM}5`8~w0OY2!eHt*Y<_NpKv`%DM3% zTXmlO{g76Wdos>Q;*`>o(d}C@(H!bdaY&iaNwTM-Vgv8loA58H!3U}5e?Da^x^CF` zKOfxeh7Y&1Qf8IW(<(U(DCX39@yhWF)@{{byOCuXT<*+q;-qN$I2V^lYGDFyJZ@sbg9CCuin4O)8FEL z{f545>I(F@X__1~kEMS$F{&romn@|#`igr7jCfNu? zA)PVf$7D(=piUE*e?X7Co;0P-#|PYSzss1~2tIXW-IP_e^sJ;{qA-c8!AMAX$8@(2 z>n#M+lBzt@MsqTO{R$X>wEGo?8Gu;gSO?kq{lNa=3@a)-)^@UO?Z(a01O55HZVC{X z1*)`l4vU6)dirN7wq8XWPQNp>tiML-^X*)})rrVONR^oOC1J1G1s^?(v5CMxc!oX3 z4^NgauHVb8<3X5z36PGn#-t8`oa*m?NUfEHTi#Q`e#>n22XR{HJVRY%NO0jJ!WnHF z0x2Ug*%lCsS;@V{zTQWc2!HFI0%f`9c5{MC8x7kLNw9=zf8z5-)L=6PN+5K-$d!q4 zII|&a3?aBzxW}trO0H+w+s0{@bK_VUZKYF09z~^LWUeoxz^Yjn;S*H`H&a_Ch@<&| zGRhpFQ$Qkh_yM%Wwz%~7qvnlrk7d(Y{4GVM)7SNVz2AnjUmNtpxBa@Fy~5V7yUW_3 z*Ope(VvN+0G{Q5oA^?FPD%Hf4;f$1y@MP;G3p6`M=<^uqi5gWZ(72Z}{aIPWMeouT zD=K5Ek-V*rt7xNpdk4Jh*6!{wt_%!s>%}YwyS3sgyKB2mZ39M?Nm=Mw+N<)a7k=f- zAhg!zS#nmI!0 z1&hKuZFGUDrbtl0-NWX-ZvEO5J-JnZS@k$tRn5X=B+OQp(?vRyRI2p{{q!XX7%Zcw z1<%T;IRY1eDt@|SBv!ZzT44%}kkYg{Sp-vK!Y0xknX{X)ua)+guCoOt(`)~Qev$aA zXSQ3SaAmJM8uGrp%5-nyfJynI(JvfV`;$A z4wgVq8;(~~m72z8-HZ#Y4Amdyv?VWB#Ran#`g=-+mbo(AQ@n&n%pvq35uv)L=!1wMia$sfGExa0XkXK zLdd@9xZV@DvZtAUw-Ur7EQ4qN_tn_g>N8Yy+QO*f`o@P|IPLvT#Npg&56e6rhAIT( z;&aF1xy4;?$ie=%f7Ymi@}Tv1jr8y(WF`u4T)HR?S457a-y`giiVx@*_Fbr!zcvF44__8Jo=%+|Dc$am_FpLpBa zFs<&eBS}utaPfWS($U^~_@!%-sT3AjaxQ7TeYIiYfERvmG0&!)6nD7qdt&}5c{{d+ zUACXDv9x1YO#1CF?Xf0m)F1K-+*dxf6vtdTb%EcbD~_D{#oJk+>i+gO zBl-G>749!v7BR>>x;2rNh#Ci*k1ub%`$)hFl4;`S_umC9Px%vxyUn0CR~=vOS=kS` zA3`3uFG9`lA)a*z1oHBuB&)yCANFzhG5qt*{J5)eFVu5R ze#cM8kD==Rfw7r>o^w>K8u8pX5%yP?hl3 zHZIYOPGi`a06XgWRNi$B27xgWem)!?8+;g~%G%m)ZcL?aA)R*>Uw-@T@8Ngf)xk=2 zR>*|-zlfO^>JD?<;~XWH@1s&z+_>il{%DE7xBFo#zv$P`dGmt4+qAMTITfbdw|YM6 zv&xu@Vu-n7L17DvODx^!Ed`!jzewyVewbuYZhq=v;Vy~5s0+@Xg=pp zY|Lrx+B<)RqqcZ+4N-$z9-C~UZz(Pl6Xg{%XM9%($D!+N+QU~|fX~L9nTJ*6uzH8q z=lWCTRC;N(D$0&48}?YfPAM|^-|zuA9k5n?U~xo&Gvl+*Lt9!nTx@$NTPND$bogQP zg67bAbCRX$&-Rx*cD^!?In&!P>Oa?}g|l7G{5eM}f7$WPGyD`z3C8{}llO8SEfQXr z7uHu~T{~6OaLc{D+}z8yzt&>giM594#1Iez00jU-WHdAY0AFQS)ulj6J5rEM1~%CO zNlEOsjjI^=#xUObvL?=Mwzuy0mHmy3ndt(5SM=Y&=nw(T$N&@+00sg+ZiJiY$zhvV zBFmB$pZHB4E}5m9!JV7n0S~C?aBfYhdIOfFR|n z!s-BPvOzgwvl*~P%GKU_WU%U@0xAQ|2I#3@meP^{03!fJGXRJWXWn~u@3rk`*S}l6 z|JUs;Td`%mo9^1Z_8BfqVbwbogE5kkc4ARI4p)8Z5c{)I9y7h&=P{vO zTF_5ls@2t>baEDLik9AWjsjQ~Lt6W1xTau(QsIJ?4=j+B~OzFuo6B z)&99Zt6EFqPvojrXg#yn~*&sna>k4B8C)^JpzjC8fw2^`+2JTS>{n> zd*l1VhMDO4c40KFn&(rP`ud2XDjSC1fA?|OFLfWphw^&=xtV51@*k!)Wcj8w=_Y@O z-_+6k%rl!CzEk>wZK=z+tWB7A>_E-n27$}o9#9P}@&11N4Q}Be%e(NcC)=*#oAc&H zXveMB>W}uVs~Xd4DL!6gL#X)=k!f|SDzal3RH4*+_E7O=v#*e_0@&WkcQki)AsuU{ zntazENr;M!gj~nCtJ)-$%@QF9_db6P^*j7?>Zm+_sU&w-N;7Js-5mBazYe$*Zjya6 zqxUFV|Mnr-i`pxb-wSh-eBvTw>{C$O4izTHJ{1_Gub83eZsv#do^m@ zRgW=H!-KNTtqfqkLhfwTa+?E(-D77`!S_lWyj#tgM>pOHS&ip9+a3}5pILZpuM8&x z2(){$p;#4bwyjM0W;Ve*+@^BOLM)S`tP{|IFL{KdQ!mjMtlL z*vn(QJx+ThFx$0N{nma)$Wb3r$$%LWe65B@^$mWdmNLp5zAfXeJ<(+TlPF0(fWFA!jlij&~B4! z+M510Gwp{h91Q34LqeQ&6Y}@-VH6Voj}11y#BIxUFWwP%-j7xBc^PiW7H3yz>Henc zL?yq2(z>e0>yQ0?Lo*%M7AsIVes+Jgl9lav*lTA`n&JGt)zvlvUtLD$n(O)Yi@sKH z5BQ7g>*rsxoc1%P*``_%p7vfX-7oks(wo2U|9#H$iaqQ(LvGZIg`svJVM8l}TKoTF zYV?mEiYQ&5R#nWq{pmi9|K0`R&xykCexfB z&_>|?b3lP-<>xLFpYMSAXEguj!}}L^xxA%fe~r#qWEziMLs(@cRY?}E65tg^ri?O< zCCXi7o32BDlIa1W#8lo)TLSm7OKuwZxNrO)AQQ?1Zoz6c>88rbF6>#|nzdK>gtaHM4E77yeCN+edZoQpO3}n zkv(fwO^t{5aPE7W7TVv&zUoK0BO@*AWoRwSuBgt{;+-I(Fn|f*db7 zLrK+#A)t6S_+NXJAF##iVKBH^?PjL;cD_^l!0=oK>ZW_Lu*%k2hF#I3myr|(mk&!`bJf*a9J&8R^_E)QQF<- zAKUU?`wdk$u9YUCM{@^mbiic3Y^`P46=Zq}J9Q{cQ-BfGr419KFg?L(NI@)@OSvn+ z?8A`A;%%Dkd#p-H&C?#!Jj5H~!_L-=MG!05D9dUWT1S`Hm5C&($VRLvS`CXZ(Lp5a z!UZh2m;i)lo$Wdiu*lVT({#T8=F~`hvI$QY8@h#U;LU4S;#vZN`EcU9!2p~ zhks~RldQpW;}zokm79sQ3IyK?7M9hxiYKvb5Uql=mStBL=0YY3;5ye5?C;=(C0uZr zz>J6pY)i`5m-flX2LB@q7Y>KsllTvB@-~PW#><=j@-7h-SWeTyQITUcK}k2HHM((@ z?X^sNp@>PpW-(ZqkSbLOcTG{K6NSZ9WfoqLrBevjmn10SFseVc#H}7UcDh~l-+n68 zsOs(RZf2L^)mI(|f-VCnjwDWOq(DK(h!l!zmrbpHO2J%L_wFN&u{ABiYfA9q9>x&1 zkho>?eQZbow{#>OfbzZDk~+&79%*iUYgh6&V%A?#w! zw=|DXo(o*sMMouRc8(+~mZ^*A?RGJ#x#b6W`DCBCm$#02ZgIJD;5@U3M&;S;fw6m6EKSzNd=oN zldn0?3XQiCZhtK*7jeg_|1ff!YyWvxd8d-m<)sGnj~OmL{U@rCqm39vD!{`-{Ljy< z=okR@{X>% zIv!$-){Ph9to`<4^#@OWi#j8laNRWao+9IYM-N#H;>PB`d3jx*pYOe6M*Ytj(XMxIS`GeG+H~3USZJ)z%Dq3Bp*9 zGmhr_iaVQe8`-0@Cgg;we=}2Ij=ILq=9zzx>(-Z$FA}2%i>Oi0QB`ow>2PQ#ohHsu za?V_WAg+#keZ5!@VrE^^XYk}KF`M<7x51I_;iJney8yUlNi zA5jmVyp7ov=jK{oUff@{Ced3x_JhvZ7R8_uc1*M#2MW^L2&wjv6!Pv~+{^Ket0q0` z4L4?LKfJN1KmILUFHRjOR_AwpPUU39Yx@+AZQaLqK3Vy{>XTmc-E(SCaJy!_zo^*$ zzv&Mkce)#PwQ${Dw&wg1kI(oEA)g}E!^u!3M2RFA>pLdRD3UuXHs$ci5oZBTfWSXv z9%>RwGfFncYmv9dQ`M<3bN4rsss<;c?`99MNWQa# zfIdkfzzW2JD+U1f9{3Zkv~Pty>v9*PJc)hf>|2J{6YBQ-Chv7PJ3M&8qESl(;ojNR z(0`uQ>DKk{Jf;abM>U;ev_G#$&t2S_7 zxwSA5UA5zVyocgMy0h3=-i`Ri?qw$QhIWdI z$$msqc}qJdLIG9prl3W4bFowtT)XU;QeT;~hTbcVVW}I_*F8AA> zYrZK7iKKM%@Y79LB{dZtRxFwB`i!_)gnOLSwwZ4O@<`|Cs$!_$pRkdi6b(vR$r$#w zr9w{7P1{o&z4Q0V+EXrC-R6+)+5fxAc9+l4slw-IePMD}b~@|av}CTi(c=HrHf8(C z6c1FhS`+ym#oXf6(wpnHKVez>iQT59QqZ!yF7f&~DjLrzR0C36?P!Yo_3Yc7;P0j{ zbBA(UyKDWO+;WJlWj(T>yspp&c1KBbM@_K4-ptZrm|U8+Yipjf`vuh_AU>Q;ZRu<; z-p8)}L(+o%w50Jq)?_X0%PlrY^U!+T8|DbP4Vi{^Tgwgg_D)5C(e-ttxf;crUa;NJ zS$F@uwYPsa$*xJai}hKMyykW(J!hP%+R<|wed^ff@2%bjn>BsWKJM9*{=Vj%E1~bt zYo#ndhZ1KW$lJWubaFSmvBx}jdVSc_1lUn6&uKF)J;&aC&Vz9PBruzw$P+)m!xn4) zT=MoLvtxRQtHf`Rm#6y?s^MYw3H9{vd419@d$-ssM26Q@vyuN?f7wlR^#6p(ZB6IH zlM8z>yc5j{D^$H-RnH4s=p3=E+itS(zt_zV{=!?&aq;(t0@Cgx`7sTNLT=@IW6KNq z_Ngp?ZHOk~p>6)Wtz&ELiNkkm*%H;q%PdY->*V{K{TZSkXIC>~G#e6?+0i$^KhIIL zeLaP{)2W)>@F~lP7Ads<-%$@K*!p+>+Wb$iC+p0Ii$2b;{yXuZxg02dnJ+`)@6|19 z;dQ;h((Vm);l_(s*j2BC4Tg`0=ycB57?|M-*GsJL1_O0MJ+rzXdikDuZVVh@dd_R< zzn_dJbp=&iOFsfnO8fnWcZ4=y{0>+-&sju3D z1!yb7x%#Fxlaswk>P0});hI_XO`E_Hq(`j1kP{^wV0x15gBk8V193K` zd`CFq|4R8I$We(IoK{!A`eN?7s2{!Y!X82f=JUbaj4MgR1Ij3tdY zis@d-Km!IAu~DNEoRTk-bi*&pyKSYD^%8rR@nEl;S#I9Y**+b@a^=#o`8~C_0pV>W z`@3hAB6gZqZbfL3q#v@Zs+9Slb4p`nWm1tTg_X%of+g-VFXxtd|I5@`y|2O@)ZO~U zX)noiB#B*kr!asFu&PptL{vAwmu^SUsCasddBmS~89+uFNFnr{D{d~ruLvAd1_eQi zVn{(K$?n~c?rv9R!~$QOZ}V}SpjbeTh2ciUqp-&!0%nr1hf?j1=^0vI*}}~@54oMK z+TOVt;QIFW7aI4PT*5PYl^1DyQC)V@qBq(zWZYJd6rX&>1@5^!e7Qz1)Lp!kuLR61 z$-OKE^86Hg_Do=DQf>0U%O_2^T5oVK{zCZ3FJ@!bw!QyeW0CtNY!`n#x_Hy^Fm4m` z*9`ewUy&!#z4a?!x9&@qyi{$!Wo_mXGF&Z@@H4JtEM&R+0b`~r23l6#uLJ0yMi6OV z5fKhN3Y&ewxTky>f^=M8;h=V$_9)h)6Kr?(=c8!nGI6O$lU=n9&AJr1D_LQ%&vtTu zInf}_;>Cx0JoT?a>7#`>N8L@lT;DGQF^4ex$Nbb*`5;HDK!t zUqgK!6N_8I0q~ue=EAnlwKeuo2U&F+GE$lr{w&NMk_nXxFt)EwU z+ED+AM>bStc<|jH3QSd?r~*J01*$M#v)IXGcIW&f+k*=$^38asOkE}qwTrJj;I-TM zqZq7=%1Xs+U@FIdgg97pHGl#3lNk1nK)DElH6A>gd6|_NNa9cBHuAU48S;TRznQEzs)HybCNMz` z+72kP6@jk&uQr!iqNGvb5MY#uNProOo?==Ws=_+LSlOb7c;?1-+1gR=a<@j*2yEb@ zwT#LLJjnAavbtwb_FLOLWeRjO3k^JF<8wkyK`H|(#++$XMgc(tRjN=I9g3_>=}0?s zYjauKgvnI&+Klu@T7zYS_&f_)OMpS$8?qM{#kDWyPJU)c2GHqEUCgyJ#QclQrxGqI z)DoF}D;h#Grs)PI3d1suxFm^6h|ICZb_}2Z0!Pc16=y|f?nZzH62K`4`A&R#S(TMB zk6Lfa(6TSH7RHsGoGkfurST`g7Ck_T2ok3}2TPM1948Y;Ze@~GXt9;8tVCc26{6Qy zA^|sEVpyV3k_hHHL`e_Ft2wfXmD&4EC`z22M{{r@T`$WsYdH<;uBgiWs?Yw^ZmF)~ zA={A|v!Y})MhfZ64+DB4bNX`87buyoncX9@Nx2MBtqo)*TWH}eum}h{3Xw@-7*h}| zSmsp&0AmQMrK&8I90`ukY}u#E=BF^UDKtm`@*oABe4U6V4wcF(chpEKv=GWx1fn)|m8#R+YPvL6D_TeZav{>3e2wNluSR>> zlx&g8O`)pbYD^Ljr0;{g6h_NUESBWu6kg7=$REaI!nTX&hw3#)>OPQO38eF4FWrvI>9kh;i6_bw9JRJ_3vKl>6^gOaJ|xR&iiDW1 zR+BjzaR_RNQ(~Jk+h#xeTY&V^Fy0qS>5}q&PMv>O`vCL(>IK&27GGJTQ&OS?&3$5@nm@r_L2xJ6ESkYXi&+tesBUS(k)EFCv zW@DgHo~DDIr#VnWf&>{0hrvVo{`UOSIa_tC1Mv#e-^G%6RpY#0Qn;{78x~^@I5ZX- z>16>dbg+m>ppGe3iOjl+sLE6X2_uOoFHW{>bJhYL-=F1t`uuGy@Ar(x?&RZ_*b%71 zAFky~^=jO6>c{DwR$O2cM$Go$nT2b53V_OxWtB*iSs)!jurdIna7kn%sqq%1wb}J7 z?mrDa7Cq0A_kJNxrDO{}n4%Sounk37R1y|R!0-ZBNaqj<*CPOP!;<7ZxDgvJu`W`b z8+2tYE!J&wwi(a@FSAl1UP(0@9W(DUhl7L#2oguS*%B~)eqYTF zZnJX<4Xqsoyg%@9QG{0P_H8FN-z> za;an;5>{bhA$5+WFjG;tSnqVd?~lKFX&(w3P(m%lM5F8^fC(lE0~LaOh(!26Xhf$e zy4{_p_n{}-MC8R%zo#8utmVP@Dl#wi2AV!rkvf2ib(;6N`h}dH&)S( zp($Tx1AdfvoA$Hz%H%}^0@5NPR6!=HQaDw``C zqNJRfPlB%TGpUpUSR?=}g-Me{U|BT{BGs%*7G(|+wQujz34 zPwB=VXmqqW$3>?(2L3_@C26$hF1d2$>r^6i$mP3GY()yX8Wv4Nf;56P6#+dznJnmWf3Pr^jrltZkvD%E2NqD63Wkh#7;JPs$Jr9qLSlI>gDEsDqWJ(YRi= z{&A|VOJ9-+8^&j%pe>;xUS`;3L?BA45G?!LQ%SWd35*|#MPRBV7FpWHRL5*sg&Mz` zVCax^Y9T2X4a%`E74V+5is4q?Tl&ETgx}0dkh7Qby_CJo&CJaGxJC=E4xm+2g;si* zqUuvs5Lt<^0fbVC6ona-xkeJ#f0>}S)|$83b;9%XN~&&G+*=q~)B=|sy>R4QVS&HY zQ^>bw*V>B=7|WCRs>tU4-mi!L&edQ_80E~+Drv(_rL?oEewP^B5~GkI`*1)8)pZot zTug||x}_Fd)mmli{PRIB7AP|~J>^t|BtR^bhc%4dPN1wHnu}Yh*=8bef5QcjN^0qI z_NY9wZ8%TEwe@d<4DK6OAYEpXibl}PRAh=E)xc{yaGjc>A}KJmY7k+O*3cad3MT>gnl`bhwsbPv?Ko@>!j6 zPHMl0l4__@#U?h6p&?#o5ONw}OlA#=l_0`1ghLrGDiQ!9sZyJu-(DRAy(ob}ij&rM zkGIq*PZ!Cc;7s|rY*gvJI6)NlrK@Gu3$67sx5heBZmW{SisZwqjVX$RCsF*9jjG$S zEm^Ao7ANgDRd(HzS5jrSIu~Sg>uiaWO;XuxnVb=Qd&=(Mhsl4_JOJ1KT6C`QBvAyR z5}1WlgjFKKKqicIsT?M+tyXBm{(_N?vVV`(yxYRALA$ z^6%IIfBxh5g!!4@(XLPP!O6V z35p0)v1Aqrngm70m{lO}b)4QxV8rEtWJTnl$y`L45I}U9MAD+j4?|*HJuoC?XLo2_ z*4r?At2~gdiB6J^r${%*QO9f>R?$)0Q4QWD>_2-|9(JWm(Q_3VI1*({nZooT1VB2L zI){TPOKV=RmY#)nH@kHwl;tVHx~i~Alm%2>JJdu3PT<`dM8^v$|L1!K(?04*JpsDl z2A;IyEn}GlK??FTt`b%SE1+el5I= zggM_cfNVA#Bw{2Bt`iwcvQ8<$QHr1{M3Lm-nU!9;`wc0)-H$YTcATt@s`E-nhRAIU z29v55FeFWsuMvzAx3K6ZePEu81qnbn;IcqrQ?Rt`2nhogVJ_J&ppWR9^j-Bh-hz2# zw_+*{X}V*oxS}P-OLb5YWdSexEgPAQr$hD+njS~c7q|1c8F+x#Q5p#fDI#)j5 zer}(V&n#UrXl9qGDm-8t38g3wc8Y``KP1*%GKg*Ao zfjqUBp2%4w|622#hJ(=jT)w^6?CX|g7NHE&>vBk`O8)MdDa9 zFL;dVGS*H7-9hK4UQmet+89yERCVeKH7qlT5iF%c&M^^S*daqg=lthx%-hUCg>cJd z&t;GgQKMuSi3u20X++6{gm+R=&A{$+haO@B(J>bgz#4=}6^xZ3naH`zf+Cle!3S+$ zl#ODCx)uqmKs5gp$drhrB}ieIt3nC?+R1KL?x-ZQFiCW-%JmGRo3Jkff#o6*5u-Sh z*$DQFWt}~PwM`b9vJNUIBEi_O0a6MRDx?^JaIDeso7^YzXlJM9-uN0%oP;uO1Xzv( zvJ4|8!3z%9Ugc-BZNav{PlS`0kUF6n9j0&k3G%B%) zMTebF+wK3l{5eC50A&zZ=HMeu%m{EB>{10JTh>3r%KDW;Mc3y#{HPk>jmsQD9LiOO zfF*);f-Nvbx(4YYSGhcT)Kj-oE92}@c4xg#N*VSmtS93@U99!2+{^v;ZImnLF`0&y zXto+(XK(1leh0~-nqaGDlm?L z{|5kC5D)_Z2LMA(9G6PpM1_1YP?!DdabG8?m{eGR_TCwuTyJy|4uG`r*uSAx; zTWSCpgn)J-GAacW64nh6xt9c$KFL4=@CgPG1^iE7pM*X+CBmcr^N0EhleL1~!Lwe~lWu{0H0P(nld>r)@#p5Co z!l=@=Z*yt}rllQyw8CX`$9fBp>^?qgkb$&Kaz*s%Y>Y`?kvJWwh`%n)^zF4xfW580 z(-t>Dj9{m#kj0+$<9If-)Au5)o@3Fv{GDExxxMPYcO;wLx`kc7T9a+0N;c{C<>S)V&^7d9oj2~e)o@l6H@uGRw zQsEal;0a_|0+q|F1ca*$3qM48y?lvIOdZ_o$@iGT=RJ>nFKyvpG!}u0}xHZ=wszH~94CpF?Y3b6Nnd)ADrtfk!O=EhB{obGfJ6FAPQW*j4k6Qe62T@$j2~e)qiH-jV^%5P1{^=ec`g9z_R&=} zLK!tP5!{X_W3rU{F)fn~x&0F(#t*R@0A}qa0}E8%AnV!MB}+L9k%(a`?S@I>g~#0x+#aE@==HvICx zyDU;$zq+uizB@k>jAKQWz%L*ch}<`KQVFZ4@p zb#LI7mRy0m&Dj^vYKwGqkIaX>f)*9C9X*Q<^#%DR692c)*8>jN5B*(US9%7gmAjy3TsbFidYTadxjSb|F_Q2#fkHmz0>vJr%T1&ALt+c zt1Tbhg}T3Bq40II@Y-CE+>bCs9m3J_%I5p;MwE?Z|7C95iylDJJiHx**Th^_Z@Tyr zyau2ryNtdM*{jZ%XEL&atl$t}&g;#Ra<88`HMt4nD|jb-I1iWBrCWH3`u)yVg-7!O zYJASoV%@N!zqfAC0h1e6H>-yFU5G>ORW!Tk9$6 z8*8e34OeTcr8vO5CwBq9oLGAIjSs%N`1XEHUoxX4kr|wW;sp-axqS*Mi~b%4(}>cnYHicxS6KZYxlgv+2Z*j>X51 ziN9|?QXgD(DS$n-rP;RAh^oChs?>F0JDzWpP+8 zw`fX>;7e&QULvB-uPTfBstQf1TT!g4n~r7gE;FK@X!@%9@ulAuaY_Zdh+0mg26KQI~hTze7`~E6=umb1|I3H4z&2 z_j-O8$Q@BXTU+K&i)#Ib|D9cN#Mu42#rzQVj;@>ZA3rI67H}Rz)9TjUW8MR3l8D0I zg}b6*!@|I-eK9XJw1Z{-v-^Fvm=LRzy}Tat?Qg1{+ZXqy--o3v3&DV21=2jZz3vTx zq{MbiQO~b;g!((Gt?*ItZK}E+B`hAW+x)X`{)N`|Rvw1Cr`{~xXR+X;h)Xwh{S@Jy z{;A=wihZ`<`8GDK&8PU|9%A(uOgYo#VxP(Jv5znG#lBmuA3IXN?ez_s)Hi=HQ(o=$ zopn!FxzfaHZ#?bJrxug-&ojw)A~-yBCuyRy#t2LZpj);C0o5V}WRC!vAb<~%ToQYo z%h_6Tw50PL5M%kE+}{43%l_VzQ0`?sfL~M}f1dmwo5cH;CazfZ_NEVa5XQ-WwD;595+QNAjWbYe`KkgZ^XCNA_pQ`_AMx5z8wxYd}un3FCs+}#h$uQ|WV2)4@>|bl3Ep(K zE4O>w+()*e`8bULwZHyUSO}W()!akogJ50t5Pw&!;84Dk+ISq1$(dyVA}+TJ_N5(o zZ5*M1wfX6<@$DL)rHTJUGV#dd(yOr)#g>F800T)9pNv6YUIo1-B(qS(N80*06wm& z_gQCDK*{@DZp53_mIU=f%M&YBP7xC*161T05g4T!nN+n*np=d5tjbl_O=UnX)X3fX zU?w%*$9ni2Py<#|6^HrdG4JvCY$<*c^{LdBpvFPN7?4w?1~6RH5+hB7v}+fh&GNRF zQ$ycc(-)he>U9Kr^4~+u^A@cd3NpaU%+}!?6dt+{Aen+LBgjWKPq=<8S$$Vwd^Qd( zQUCj9Ix`Hlmz*bna7auv8{O+{>sdVHeU!%L-^o;1DA=FDF;ouD0}V%CCINsX48{nQdKN zR`+)`IQ*`rVQFlOe-;lQ*bh6y8CW`pi-L?Q|Lsx=3Ze>RL;)4c(iAKdX3sSRZB^zB zEY6=K?fK2`Th|73BTx5ii4)!#1({{fqIGz>bIdncDt1XHpV3Pe1{sk(Odb+^!^X_&%eL^qc{utUETLn;Lx^Q#a$bz z-Dpffp`#_M@tD`5%oTn(MWK~K#|3gM5}=fdOaxIRniVYUs;Sha#6SF-h9*t6T`Z0b zQD0`*iPR8;_f8*XQ3*I9-!Y_t>w-ltL(vl|*)v`vmEwiPID6Ejg@0G>x0Z{0zsF-o zD3{BM0P{au!=Jes>IN3XD_4tLk}4o{%A%YH+=%GUX;-E1i*IO;+5;rs_RMJxv|FUG zIko_6M=ZydqX;_gDRZhI0}uk%Es5wd6u`y#ih_h$h#6ivUw>U~y_hN=S_eJOH>yqd za(0b2z0a((bgvLQlfM`xFl*xNs>kF`NJ3C0ds>sHG1ifzqLPRNY%)K5#9R{5LE&l6taYrF^qAVo+P zLNjdZ<0yddf1|j*2y+7S6CTGLC{N4pHZ^NG%#m4rg1`F-lU~sea=zSW(@}Y3SgP4xvqYi?O|3_k1_Zzr&PA*Is{~O&-zf>GrzJ9IFVexOfQ%x za{uTUb{prod#=@7U_Mt5d5gT3%^t8-kS<(RK|}Ka;h>6MO^@>kaVM@(0hrdCI#3FG zn3^~fsMhJJmU{J zyzGVfQaZ&>oYRfBQgoNgbK)9epU0S9t*}NjKV5Wx-`s6N3tQ@AcCS2D@YvX>sb;}B z*|joVga4aFll0drDd*Rjie!r@IAbTf9K$6p>M9m{AKPrOPW_*ce}wZ=_&8Fre^3GIUzFXQJJvqPDuOoyUkU0x<~S zN7aEbT~F>M+PIV@P@HOG2UMtXhsl|#TJ~^)A#b3ixFu#-^;DKZ!BP@V+f>yhtovN_ z2llBRGzkh3nPu^Qi=mQRms2vVF%;bsMJsuso4N{%4X0|XIV*ej2gtg$1^s!Cg3 zAW+K~(vTVyXc(d^G>j!pw1`7c&2(wec;Pjb?UW#LWor%nbASZa(rAU}@(`FQqsd8q{ zFDJ0k5g$)0OHJcm&rZwlp+WFu+JSw3Ppb1je)!~U-`inGubOQgQ7JYAW(Z`h*61TD zaY`+709u=tf1ci0TyPfzlK$LZ8)`p2d)yYgq=1j+T6yPuJOL}JK(YsU_o1xx`I>_O z4JK!+?UQMk{&+nG?1)x#%(2K-=L(1rx1g^_n)tyCN!O!bJ3tW^32~57wyD;x%_c*t zk|0<-ZzaU;6Mr~oEr){+3M>+I85m?Zrgintf=!=U3SAsqsnr!Lp-%&9KSLQT5sEs& zkx6v}LKdnf*%Ha**Z^WyLdVUS9a^KCaT64zF+Wt$OlGOeCyYue45Vmt|L64~A|B6z zP#-yVsj~Q#;`czUbt#|*sG5Z#6&bTJP`6odxPm!I5b~={6KKZjPc$FbywiW3^wK+B z@O51mzstF8`)r5bSnn0(-02#qNx4W+q8_44AS{Tg<( z(e179`eP3vlBEp_p1ThQS0S9A^t7&#<|*_At2*&A=%hs49hcb|3-mg+g1J~MZFOjE zW#$u|geqfKS4NycRA92r*?{GC!k7!11LA8)lA2D@N!L&brMxD)_QuSfAGxF9Ud$sL zxjG_mOBWmjE=8hC^v-?{uxI=7J3&RZOo#WcMo1f-R zgS+2qrF8vtZZ6>VKYcSz$=Ue0we?rmg_B41i(;?-#r`kus+N_o2JT0fxCSrqw5XUP z96x>TQSbr zw0v!c-`vMi-S_x29dwjM@&CKTo#uPmD{4qfsExRb;Ya>RT?W}!>Z^$ksV-BG=Qru3JcZAojMcE|9vPR?5OJ(1#zD>=Al&y)DF2Cqm zhCj}hx~vzj^nEu?e1QXQQou+nAhn-6^X>8i@7Z_B*JKC(oQ_l!wDmR4)pd6VsEeI3 zQ$1s98nh2dk?OjpxYIkQ)U>O(ysGE1zc|zNMc*!l^)6&ZWq{2jK5Fhz=^Ng4fh(W? zqyK%RBjWWhO?+GI>#3Knd=MY)}k@lvNAJuOmzYWa(E(8C z;u+p0$HPXwLYtR1N*%*)u}2kO54s+NUVej{ciqycAZPEmK9jXr`hwDf`A7bDsF%;S z@R#qkPwKrAUX$YMgGFH6k7L>+h7 z9msShpW_H`v1!&!Ld6&U!0Js$C|0*y6|M)Dy=yW12zMKo)`~ z17#ffX-0jOjpi_1g3IICGv=lP4#A(sr<_oswvLZcIWswvmkMbz`<{*H~dqA%sq zfQY4v>LFAlMAC{WfeKw0EmA57(tzAI*6&HkyELG`Da&IPbc;a|p$ner7X$<%IaXE{ zlRn=X+-P2Z!|Vg!M4!aAophc7P0nlTg73}uJDz(=zgpPP%k+#p6TaVeX}srd+JFC1 z;|&z$QFljT+ct)$<`gTM=dM=}_^y+uX4aFBu9}p##6dQqT7|b@Irmt+zyeX+6TDXZ}C){F&y@xqboqwAXdBN2iQ_Az}thwY77|>NbgKoBpH)-?jLCsumZZ#l?h^Pkz zM#VQWNdwViA_6@>1nZVv$aw1kouNkp|2c~!R zOkpGSC3YE;H3XM2rAG-J@LrzF9JEjdP=w7(PR?sddGl6?wBy9+ZyHg|_9JNr|9ZuD zM`Spsf7c&`yFKz#hrsGLt?_k7S^5&A%Sfl51jUGXM-b&XaJn{1OrXaqVYt&JL0O4i z;<+73Wmx*VzlpnT()(6M6%;5`6ig^j8qvWBDU$B-MVU!;Ed$z*lBoS!bm;2M9yKlX z@p-8;rT|2JcWpmz6h0_zOBoGX;h~&t<-NYUkxP}HCGnXRNc+afV;ktMR;MZ6AsG-R zGmS+BSXP+`BoNn_I6R`gB^f!cY_7kstf6PoaBDL%F7LYEZFEl`AiVeWH0K)wQ1L&+ zz^c?*k{YleVDu`s{qE^0ipP#%$YWr6MdiUj1VM0EMVf-oRyl^amZUbnrnbJO#i3D- z?VD+-+v(2esyRO-9Z#qGE;6w@eEzagbhex~C(vVdA3%10mfd7rIe>quV4NO-r}=O?J5(~zH@6mh-PLXgL}5eUI$ zgalaAq9~FCdq&qVTJ&paCX}Tx1{B>e1VO5ZN{FPAA_ORc0gobLW+2z+wIteX%(LF` zmZB7&OvMFS?F=6=?Oq-^bK34=Z|Vif%(LRPU5Paaph8U()>9iKQD#IcAdg>DZq{tc zP+ZDe7#GEb`kxjZ^h_C@*updaain2c6G?g)*)SP}0#!zeIl~Ysl!9Hu)pKA~1O(TmE7YA#Y7`nMA8|gFcn278YpB0;@3%V%WRqASq@N6 zDaK0H92Qz-faqL4zJct^xohFS!(969xG>j%2L3I`0sqJ!RP)9oytUt}@i) zsWL#75Csh1jF14h*n(70ixQ|JbUrGY3Hc)5ddPFiF@_UKdKlR-B!v|zqgYJCsWM=h0{$1^ zlo{Xw0tu=jTnv7`up`O+vO%W&2_|X(i|HV75+!Z5=;#deHlBcb{9WkFgZ$gSX(G0AMg4geupd)&)|2I)GL&|LP)oJ-Ta%GJtJJ>qX5l z_K6Im4;YXFI_e3KomHyDm9h2!8mgk^W6Op266Ni+n5(JhQhqjodM%S-3H^`+9@ne@ zyI>O-s8pIDF(EyWDnbA;g7m1ez{j(2v?-MDwn~_50VGm>9Dss&*L->Gn=Opy)e;%7 zZXp0X!Kg5HVg*DfK$l6yj1j7*YPvuOh7l5AYZ3;$D^c5GFsQi(6M<5GMu7h!(%Nve zyt=7?(XAl~5X%cjfUy_}Ac*G(LKv-UHO+X;l1h(2B9U!^M0^q@Ew(Y-N0BJwVubV` zi5U6hxya?fi`VV#8sM!aN{m<#Fn)#I0-2&NxxoU8RwZ*$BqBM68qHKj&4SR%UDGHp zv6W13LDrvz(2kI{EVpZUCHU?($FTP?k^}Zej33Px&|5ANcmfs=;1jEqbCOXYh=dY? zDJnY$ptY8y>aFtYz2Bp=8`6^ zvHRcYpp-QeYh@*55<-HaE~`?pivm$?KwT>VjFD5hb_UZ@cEu>Ou9a}5IL|gEF*yL` z(RpWYx@#6MOl>gN&+1UhlMDM1s`D|AuEy*%$38C}sWPL={0OhK=L9ZJGi7}G| z4S|&cFLbhek3=lP%CMd+PSk5j{$V;Wr%h{?4k%-q50!Sy$vtMk@fZ{VQI^tW=t|&- z9Wm7-3|0UIvyrN@s<-(0r;!ngL^;K;Udw`Sbv1lr-ui&;oZ9V+xZp0(OJhW zub?XSi^k$_4R1Df1*4Snk-HGyq8K9}$e2Z-K!8=EG8HE4&5cJ?m5(*k^3q?0vQ7V) zAAr(?o%^2=|5qXp6D>8O-?}m+c+MKx1h8$?tmh;l0HT)|%RB%Qp+ulU3#wO?`B`bD zm#zwwjryPMAowQy)|a_1LH*L^b{t8Om<%<7&r88yD6>?+6b!yVi5^H4%JYDVS0I)d zZbfFEZ6A~!_A2ky5&RQ=`&_isn$h(98s_8Hnq>5sYTq_X+CQ+3u4zIPJgk#3YD^^! zsvxf_(E1d-BM%l|Ldk8f+sgl1lG{6eSn@x_Sq9es`Qozskt~P34dYqZTm~X)!)gHG zZHm^E14Il`7l2>5!S;hflV729wpY}rPeTRU zaTn}@#$cYE3$lV9MIg~TsjM85Whf8SEApwmE;UOyMT{{FjpG{mUZK zfon+0oo84A3r2yl1wnN};m#!+5j{5#nfKq-BxD3+) zRJAMaCZB6g)`3k;Z+Z#V0jow0ckEsK1ba1w-PiUTRYA#zZ~yEu4^nA~nkG`IlGW1t8fkN^Mxk^w3j z0=VU~ySthFE_2uFzrUGtk&r+by(`|-YjcoXWFYR%45$b~2p|XqMGSzD2>7=IOU(Mp z=E?CaFAyKYumDkhp~%UH*!BV`g3`q?f=HotFyjIa2P#Sg5IgrJ1)e7M5(oPFzxOHk zH}DwQ|C{Y^P=c>}nBsTeoasuwGIHNN-gtRWkvrFpJW~X6zyKpZ{=Ox(j^doJw%WG+F3;DKM(C=3s0Pw|2B9Q}J|gN69W#Ho=_hlPie`8qJT62~ir_6xq7 zKKh|SJ~qN}pvVQ?UUZ!@{n79BUTbez~|@EkUM1DrsG40yY&9YYn74j<=u-<$jRcT5oaZRb=txVnxXag zwX|=Avp%Vmt)&O}PzxZ!>gU6&MUeT#8vmGn810>$nI6aN9{PBv%HIie=*G6ML1(cr zryIk}kNW?6Df+ZnJ37jTdX_tV$P4;aH}Sle{#)NHrx=~6ttT3O&JL`+wSKH#`=)N_ zYS8@m&79h$voitf?7I}igl(=>5W0)04TMB^TvDL10H3$%NIT|L@n5EII{0^eOfp)I zAAQjut>91`u1+XCHpLI6+<3f*0oLnn+r|~p^%C>wvM-X z$UEj$@ZbFC+dj0Un?_jwv4ZpO{~H{rHhu~5Hcy8sXPd8T3ORISPI zcnqe3aJh-_52a#2vjKK)tB~={I4~bOpeLe0o^<%R<6je}sv|i7gFt-0(Ky{Zo0vZS zxa>@Kja|3<+QQaT36MEL(M`WHS46pSVBsTLS{>CVv^5!6};EJ31TmF zqP3p8|8~-Z#|k~g#>B#%^W$0bD~4!{kih!;Zq-6H2!^zMwjdH*Fsp}Ec||3y>P8H0 zdeYE&6?)t!|J3`FPUY4fem_3XRYUCZ*-1_>2?ngO@9?U$RWNj|!%*1e?ak}f$OylH zSA@5>ImkrjRq|eJuk?RtIVYWduB{h!TWsIN>`l;6}6`tU>td8q^w87znIBCToP zp^ZyN#xJ1~eOd?5TM5;6oPzq~G3ixdb|npHPLxz|88X>J?CXrY%w_Nhr9?CnPQ36h z(K&;jTzaz6S#{#BA7=w_@4dAMqE_p$V5-#&VN}$IY&boM;n?LFkDJ%UmzKJql!_kW zL<_%4ta;d-Er-(T7SmaEBCelj11s-y7G9%3DYZqR2*xwSg(Y3iCcAm08faOKO!L|& zE>g>=NJOL}R$Q(3eL6)a<9Dae>0QLtKRt`H73{gF!cG@*@H}#5y~zz_Teg{XN3>!C z`V4Eho=0mmVmeqZyrE_~QNGe_kP$M0{4S4M9jQh;I zxx2K83dM=-f06l9e8|OW)I6_8j{VRZaLY;xVNbpV+~M*$q{VAN%TdJ;5jx;#vNguv z=F@CFs}H=e>Ae#szq*GM{)+FT(ne&l+AnZS?frh8Bz^ckt~E|(35aG@|L|8n3k1h# zCF=DgVQ?(m^20`eHX7!8Rzy2zoLyga@2;2@AJ6(rXo><5MBM#MY}=ak*>zT0XD>v- zW&$t#S(XDhlF!UuAST+Tie4w{sCMGK$hX2Xs-a~!Le6Wszu3Glwi<}f-Js30#6+TQ zTaCBcfbZRy7%*6`t}W>!<;`aB07}SeLAfIVn#pPzC7suSt+m<2ZmSJLaxH<82US4t}Dgr~{?awvr|D;V0gQJ@g1P1s|)&YX&iOLLjM zDk4R-DTf?x(#l*O(Og;pq3pA5baL9Y_S-9AHFIEDwoFSgp={3({MFl%U9Hfy8`!?SBK#-elrv@-JcCq2!jf&YNc((iJx#sN5Ex zW&wrHA{REgJCpJ24@tNXQwcqFWn{adX9)%htn%Q`!T8B$`k)&>xi*c(CTwYYKf zciQbS8Ega}M$)g5+icWJEVBSN><&Cg$gb_6$A$_Dn3m6&-&F)23D?}xlDE*c8(ikN z@|U-ESL$sc5ia)$yPEhgKYY5-dRakdrnniomPAdBhPK58s2aCY+Re&k`qk}a4iP3o zdtl#)q1G7}jZ&mFcdS1xwC%>+dG|T@*LGL!Z3Hnz?s&w}>Dc{^SBn%(^{1cgKlJ3) z16`yed7bX=n*-ZF^KQp=Oir4)0eM?(zv5U-f+8*a6_l;~XBnyk!7t~Se!RV=_S`!FqMl-*wTXFLV$ z!~3wo*oCBLUXfXII81 zU!b;SrHo#f6q966jnP9bts}RLI;iV?pJsJ3KYJiEaW=jaGt$}r+j0_IvSsb^<654U zvodzrr(_{Cv+YQ!Z9uR4EVVdxqJ^F8NP@Hg-s(chR)iUB`y@i8X3^Ny8NK;=NKGxG zfjN=FZ&CYqK3I<;PfB;ne;%K#_x{d{PePN$b>!`A>{Wb4{O>He5$ng1 zHoKSiG4QO25g|1o56^=+S_4}D1X>fJlOZttn|Ms$$T15#a zA|J8#iuLO_ccv?`hZ^40MZUMT|?;Er!-I9G)UKI z36EJ`qr7)fqok-*W?!fL6BkrQrUDN^{^ z(PM0r_VXZaN8ePn8(7rb;NefS*+e>S5#=-%^(i>y!j;P-R%^?!LOu&g&99w8JERRR z&iY!gek_~cy^0ULl?<-Xk{he%_1#^Uc&+yFKQ|(LuGAm9RgrIXLL=vDJ6GjsNLSuK zrMxXk&yw|IEVs=XTwXR`(soL-#cE{#Y`fjqWf_#$8C%c&`-|_|;ZnB~#2B&gKTUxp z2dm275y8R>5X?TrDO~lgb`IdOe}h0I_aHFrL$%|9Ek|lII-;)pttI{!*ME)EZirgc zDrZi)_Ej#9XesT0#`ak&=oXx=5?g!Q|8cN71hC+LsT+ZD?HlV@RlLSe@3*QBY!5^# zV)mylGYC~Ij;L6cK#zTd${T7?3^2R(gkGT#%h3mP#z1>%NC4jZmyJ;K`saUJt#5`C zL=wCFBIVXnrL7?%)dG~V&jM6zi5?&$c#dF=sxsz`A1m%VoHbINu@!YVD}dZY#A*#w z<0&mU(n`DFXMGmXj-b3kkq!uFK_a|KB`Zut8Ww;?<-hURUjOGC6*q9#V37#?7H(8# z$&pE0%Q0G6fJpYX+UG6tki<@l1ehs%@~8_il72y*QL29XO!m3qDmp?SB5`XEqlR5J z=tXug4`h}c`L*SUp`Qf=WKl^j%sk@3z{MfR5rM-9tMI_ds~N@5*W6DY45$}^h{Y?z z$tCU*vs7M<_^Yb{j@V~q)fcb89VUcG3Nh7N4N-$iQ}5HBYqT83Cwcwex9;|p``W9L zPeh8n6Ss7Ku4Wm^OChOwhe>6&07~;OjUW{ga#Dv(NDtWzQ8TR3i)PxnUEBlLZ&FcU z&PYc@d~Or{ASx;~L_uu<+SzAj3#?(a%=bn(?xmETl1T8F;>prCQq1eVy12i3@Q?3X z3x14IlLiqL%j}D-l{~ec?v4ND-)fmoN5J~~EI|!WA`sz8V}t_h41hVxyfK!>CN9&*Q*Y-1F_ChXs+jSh-E<^;gSPk$xeH#R+uqXI}*iff8W)M#F8(9(rS+Gqqqv z3>LX(Bsg1q!M^*o6x=8gQQHJ!iB;vEBc-+gd+f86$MhVz7n2Q4t&=-tQi8B*XiFCu zCA`kU-*xXrQPJQ95$4N?Q}tb0fI#*{%qO(B4gu=FJhqh#Jp^+^3S^lWr&iY#Wm2Jt z<}rvg|L;Nqtgz3}oJ)S@pMcK5nN}b<*0mhskeOu&1h3zRGktM^e@k(tmIW>l5t~&G zf-+V6IS(oppqhOH#4t8VEg&6J$ZlWFD1pvOvki#a0rT2^{PlwcyI( zWclHpGYyL#v~-rCyvJ$+jr>`55P-3TOA1QlhhLyD4yVNoR|GshGdp*Go{!P$oS7x%m_W^1SO@jcEEat1&U)2XS+30 z?_=a~S@5jVs3|Ho5X$ZKR%2$g5ql>RM#Ih`PJeJ=FyxYuW4qx~;2jJ<%UFigY6{_! zmIW=Sc?eLP8mA0aiSGRv)m+wmOcX9yxkZNsB6GL!wEws%u;4BxI*h}DoKZeM;6%p`|n1eY^YL4U}mIkTp20MZE8}IyFW6$27zj1TG!jculaYJ;y_>P@a_W@&403&>~49)$!Ge!`(RP{ z$Qv?=L$LlljP8D>L&iOQ`_q$wHYo6odw=}jV?WKbxN0>VV!3iB1TaW$sX#C=5^0H^ z!p&cQBi%dY&OOR4c#&ZLwC3;;T`G57@^6GAPFb?;5eAHceJ@E_bvnE$aEd0CDe$`}1m)^$U}wVF7g zrdgt|;k(ZAz1O=vrbZg54NLE@?41nFHPhJzq_0{{x$>PIZAm5b3?RfN&@L%b54#0g z%^5HQ&F?GauLeKMZ#<_frxHw=47{Q!mlq-IV3Q2cdN$>oF00!Fj_A@5()%mfxvpOo zkj`ELeBkdbM|cN(6@}zUq$Wt6I$jT6s8119Z|N-*!Gn*_uj9TxcutQ>MsBA6sztvt z%}U+R?J0R!8YD#tE^iz`KvTV+?|X-)@3K9PylvdSo=#VbPV8pV?(G79*JqQPfp@UO&Qd$j+G;K4^XgSwyXznj+EyZ1Xx=jA&mao~1qL3Z`^ zrs;RSAcE>P?}LEU2h6)rZg{Oj+Lt>F_0!HgNEs-L9@ZX+sg?#%Mi*I;E z`=wWrV}YKjlaz>!N@}Z=oQ5`t$(n}B%h6}<*G!;}aS^K*!{7U&Uoe$FBX|AQcXoAW;J(#FEoqP_iu)iD8R zc^VPAcOjGt$ISA{?2V9nYhmYj=rMKwuvaeGl6dz%ndXb|>;lr+?4aU*7bygIi+UlI zmI&rGw;lm-xQSL^A>U>r;lbd~f7xG~-QUY2q#Qpvt-W3?ARzmH7nBBgz+#B;K`DUJ zQk^teL?H9SE8oiCBjw2S&v1Kgre?K34t^~6a|?mR8t$;b2s#1cl)tKG4;ODvK?uC4e~+UdTFiy5H~uv@m#I?S-gr3b-aK%Ri(Jr^A9LioN1nc)+_P5gvDn~9 z`fEyHJ%1Oy03HlIcf8{mfL$joJQyH04`_aOwu$*11oqiY`!$c5zRmg0Ghk})m&RbJ zQ%Q~R*wq<5lskHUvwMEA`ONpUd+UquK9wP9{8j?;Yzy#$zi5)xR=_C$hR$m^G)PEp zx^i-T0$k0fb5aBkKH;-{;ug<;9me}GM0w0}LU&0pcS2f>ZR&#m5l<#oZ1!3 z-h3o87?)!Cn*K^0tm)m1Igxg1Yilf(g^cKGca_Dv02TOi!Gc`IghY2hK;<}vrwWLM zb!;WTZxEz!bNz4Z7!`Ur-cNwVV|fS&diXy(#=T<7~0bkGa8x~V!Tl?*tFx@D68vc|F^wgIu4{e z^db99bshHN$O|{nSB%`bcR*g}YU(#`=shGl2w&cuW3|{1g+nn+G3S89@ax`vG5`P& z5CZ@Q05U^VH2?r_b-(Hhc!`J)G$sf4?(V%@?UdXRn#+fD1HeqM~PJNPvxPv}h7Hn5fnE z9w&`9d+w4+*4jNE$xW;plTNr%D;lq-MvWOW&c2ZlB%1N#LenOx#*GgQ5`bp?!wUG| z2fio}0RR9Q0V|pVz;{5myIXCTV&7}M-&gx+OHTlSqbFq!=KH*LFU*8*R8lN^o&TxqI-b%TGo#y-Q|Ip5!%Ojq|Oasn4qXgHlR z{S8*+@%-I$ZD_{_AUk8Xw}qWb(Y6q>Lojip0fHYW;{!8pY^DV^gnpY7Qr;%t&g`_h zi{RS>AMJ4rI|qaNXB5%XH8M6oySp~OxuKwczKD%LBMLkCODqF;CL&10g2eZdsWY4H z{(Wtp-Pitehuhl6+WNG^B7pAm_{Ha1|1H{=Jff^Pila`Cyj z6VQ!mwi_jbuie1&f8?~nW)y*+s>9p+uu&qu@9c0StI zt?!dYn-%h7>>^|G=HPeE-(!c-huR&F8kW6&>4dzC@mYZXIKB^xLLc|GFZ<5P`+O5& z?jwEM@OS$g)HvmUA|HyVN;{Rp@9c|!BxK1M@pCiz!-~(B(*BdzH^5LeisbpS@vs*< zM&DgFCm6zVyd3aL7gSVqN;8;#ifCk#b4}hhQ6!o}q(mSL@Rdk!DP?Jkyp!ukh_*s* zt5^C!&9ru1cv5bV6cY^6uy+6h(GB+(eQ;=+E zBX!J`H-DlcyQ-~%113jbJ&-)nEQuLV+oGFQdF7pa$u=y=(9Bnv9(ojHx0;asC0r1E zITuisi@M?#>5+RO@gJ6eTY;l(5b+Fb91Z5P8ZrBMSHS_vb=l#oM@eqOx1zzBWX!F^ zopD(1Dl|+dw-21d{lpnYDRWEl7kA{1xG(MYB)ES`jOVw5 zMz8QckF3ZzaIdVJdYq&tfJJY$feban(b>AtOWWeTd$hQ7kHTw*vwbXg$ch_FlDHzj z;009W;;wj4x*$7eQKD-atb7=PlG|XQEO5HaNUqcYS<6AP!*AfUtwp-N7~u_6N;Lgh z+&~!1s5~)=@WnXdXdXS&jBoxOsO970S_uzd!w-Hn4ge}gLMzvG#lh0}!ji;d8jwlm z#M>nVppVmFz|tzod4mAMmuru-!IJef&d=jZhjh&CSIYS#GPpdS&TxZUP4uuMa3(-b(lQb_&#OPyka)ui+NLR z5Rezs5*u9gEuXFP+Lqo6zY76GMP7WH0X3- z3Jr_q#z^<5yc$ zu6(OmbrAi%T_JgO1=CY5yfe3|n39u36byV%ppCI!KvV{Z)?>6{y6Ufj1DETsR~6B9 z(1hNt-lvi`izI|{Rad+!T})vngbkU57{Dn|t0@$%+(t+#)j#nA!bgH@b01dRMe(l= zmrHHatk(EN>rD#?2NX zhFSLwGV7RkQhEf-a06Hbl;~<%b<^%@9UOxE9~TcY2w2zSwAjQO;n? zH=(yzR3W_DTkiZ1^0jV+e9*Yb;e~jl%Ex`zn-IS^MInd;LwW4mi6*b5zsGV<9h#bc-Tg! zH{6If>?`stPUuuZrPvF}PhEJUZcQTw9c0ndnfa?jjZB&5XFH66XP~wD_|dmeK;eCP zYqGzTw{fIiOJ$gCK4Tby*JsQF7~oGM8v{fFe_=AT^t~!&n7eat;&*D#0A#Q3b}J8t znHsa`X(1Hj%rf>3gWDc?d$FwgNh+TMnZk;1e zntW0meq7&B7l1VMpm|Sw^hg~67j?mqQ~wrBl)&jM>ibY2C4H^blL@{s_Bv;SRWVwp znhNephB~&65IkQOGBUBf64xb~Q!!(fo#8uBhofHaCzAx zA(iX8;y~#ebF(**L)tVFk~A@E#hC@r(0aYI@;Jc@4xFmFfNFUGc#2T-vZ60u5IkD9 zE=DyqR}X`r6(O;>C|t`@(;w3sJq{tkqa08<60v&Jhumt<5AiQjH11r{Yrn=J8tjQ7 z=UdOlWNM6JYw~L_W)az-&tEBU~)pu()b zj3EJR{CMW3&OGekHZUkRxEmK^5$faw#9y9fEUXO~2M`;@Z^2-Nn=ul5yHk z7kFG)xjx}Rs0e#c8?6hM-}Hhrz}Ef!scK@>?m{FI7yyh+S|BE`i=Ha(a

z;IilBWVW@J6W5%PYxu`iYP-!$zeyo+lV)enCOuhs^fxa|ZP;K9LPn&*<8kZ6 zTuCz%c=(`k4h&Ol5DII)?wGjGZ$)b}E23{ffIj;cd059(mjc^AL|oyo9W4d_C4>-3 z8|O>bg=gd%O)rgJ%ZXeNN_yQ^3knMLPx2eEM-Kf#fcndy;s|&#`;=Q2%ex0-_l$>IRM6Y~!{$v49cn)!UGd&HyQ$v?w+3!iHTHM*;_SINJg48yHOGOdg9$ZE z$LotVW!ft!nJfz;osBDrFiyL0FwZn9DA+N9Whrva*o~rgT$uPq z@JE0zZ;2#K_GSW}HV9G<3T$4iY(!hV>RM&NzS&X8bz#K>Rc30nZ+w*hl0rD7U6UW{ z!mOYn2qjCvZM6YrHpN_RC;%CXA<>pSV@0@5Wb1)ebsNbrNw+Fh$BGz2rWWuW_RLO$ ziMXVgiRRcBA4dDk0ZLA6Tl!KmWx)lM{!8OZRVtHTX1@W74gJD}P-rME zXzxtN6}3PMsk$4zm;6?vN|G(Mbf}ctKo)cgbBQpSu&~3_*@2*N0|QLP4U|x}cT8VE zreRQ(M^*h*zWiQgC6#Pfy(95SLMvBw#TD?|#>OxV7f9RTaDy>vh%~X-z-n+?S4=&} zCG|l6{x1zmvBap#Qr`mUtRbfb!w{4att70jTD;xoqBE zdIbE40yY$w5Pv}-u1h1ZEzD*cz_|fOJ{mg$Un3eD?8M;PZlq1QgiN5-s)S$vxbW`db=j>$BJ6jP9`3~nfe z)YU0Uf1rT3!q~5(FEY9?y^i9Dv#i|+WfPc{Dxp&>20kDzJRiDbdm|G7DX^QGtuLPyKih0^97QAtQKnqd@5g-8PkFo5F_NV~2;%AkO^!uai8Hm2q- zy%eOltte_k=k0d$j#MoShC~o>S#FW#yvYov;^{Sbd+5__j42hvGn4WINrm_3*5C-r#M_ExK?I;OC&^Ue4CzdcnEks2bXWx!pP?VJ7g+r|?qsR$ zjRvDHB8Y%!)s`3@sVnk61mdFnwg5xA7FT@Mg~;a27N`;&Z7?iO{z)g{N~axTXl@OL zs0IOe6iTRu8A#BN2W^VBX*c?*DNTIoHuE(%P~2-jZ?5 zCE}IZul_Stc^Y=!c!aFEz^oCBkcSHq_j4)s$lV&U_QZ5i5ilYfW0JUvo*68#f*vVa zjEV7h$iwj2PQw1GsKDxd|0bWnq`?v8bcryO`7I@X_o1bNfKx@^h zyCw#ILIq35H)Kpn7RG+hE0NC)FV+Dys)gt7)*86NuGJlFKD-XR!^P7;qhS*_qvz?` zsio4M28Hg;0TYCU$K=+hAxQ#Eim*~yHXL;*0Xf?#8D|_FVd@jDeZt?bG_a?32y`Ot zUBAV-o#p4INIX}E^)h2NhXTqZ!(&qtDffh(kqcxRLcs)XPJ8d+)@-THASlAZdvogw z0(6W-6`UYVagZHM2$luf21r?<>xHpxvhE-mdiW-Tl6l32@Sj zFVlI-*8dW?1H;nLM$;T6n=a`%x0pk0=rQ9dSmu;YD3ro%f+HlaW`*YxFm@j8Otv2t zUljm~f6Ecvvo%uwfo~aw^3_ytwc{%lfFWJNn|JF;zsn8+YBmT<{1AuQmY87>Ds-Q2a|k6FB&jHlvvpgmSp9`C;j30s0d1Wd3cuRhm$S|i+Ke4-t`c^S)^Vq;_;20m|YgKe) zeHw}50r;n#p`;};qN%7Nd$@IU_l;ioH9JotbGTWW^zmFgHl#{9c?fj`7_TL@hvd-8r`?ZHcjeR?NfhPOJ zoP~3ZgW~d8lKI{#%kQ7R#ve(mP`;hqo$G7F`FA?}J)F+YYx#Ad&KY3~rDQiL^Seu2 z-}=7bGHCyd98lf1v_n7s5-{&DLYhv@8u-wSPTJ%1i}c_ZRE^C)*~$5&@Abl$+*{Te z$qle>`kK3Y5zChG|KXPJCU52X!7N4or1c%`hxe^q)?X`Sch(+-+r<6ZH}EX!FUXaS z={{KT9^SmP^qGe>J$;1N!2s9bd&TMn{bw&V(U9^~`0EG2TKTDsa8uRfyi1+px zU+E`!xOY##I1+`ONjYCc(iDipT+j!PB(=YdxNUKdz1iB@Tkl34F1Nk4xLV#LZ~bm; z)a`Dzv-{zDtM*+y{{3wOw_6#d<1ra9zDMD1Bb@*n3}%F$(U3$-$M08(tS*)090awoHi!3BY9*Fb@j7RHXZ8 zWqtbcw-0KZ|KBm+7-P3HQWd?)PXG@;u=s->rLGN^{2H(^qRj(>_fs;0Dux7I6?rv^(HxOxe3FOv5AsiVneRRBhY2xvwCz@PwN-8%EywmsUic(GKgB(Ct_d1G9eS!>2|O_R7M zR?51kG507ebZLeoY&zG4!8Nd;lTK(bkl3n~6WN5w%Hc#Ib)tw1h-Q1-mcUmLJ_G>(G3P`1gdgRA80@bGk=8*56GTZ@Wl|Sn zj0jvlN<}wl(9sK7i%4li}d*l4{FWhHS!wu zzxct&%75;kc%EM8_$7vYWvbck^wEFPN2fWdtGA|U!TxH;N7MkH`62kHJfKWc6drzR z7Yy1C+W*k)c7#)RVD#MQSMKOISy}>R!REIEC65(BkoaD~&UaO+m^_ zHKS}zR$EP0w=q`GAYSTLS9<&{)fKMa+PAwM4#g#_+dXexf!|+k5GaW3U#THs+jjpL z@bg+-YTa0{!c_gtz?pItc8U^&#ZIbOqKHuvIL^5TzCJh(nYDCZbwfkZrqN)kl5UnC zG{YtMnpkm`-Nm&`SDWFcBoq$-uXkt6^Lh|G*q!?!yNB!V%!Ecdwwhdo8U{FU+xYDXzHzpvZ|bCn&6+D2PiWu}*}F zhVG>|>~YFtdB(yr$~B3JRyim4f0OSeO_hcqP9B1$ILwc|M(>&dvZsh#*;R2!kx`dK z2Wv?|L5Tzth6Gihk4ulyqS91V)uy?9qeat6NkCCG;_f4h=&8ym`rXz2qTg5D@%T+! zzkac&x8Luo&5l7!?Uau`;)fRIHAS&T!6G0JVA4E1)(lOsSt9!qqou2o44ChY38j-_ zXn`0&62}!dj>^YZ(e9^nb@8S6ay2woZnLI*_!_CKu1V3LC9&0*fwsv4$4sU`Xfo^} z2=y_A6@HCPRIdgl`=j-RLVO!xfH`^)Qm!j#4CU(LSe789LLoTB5N%cjgsoF48{sisNkXLi_BS;C!;nCwfd|)xR;G-E<(ax^!{Su&p+n$DYpV#$wT6(~S%A z>fvNX(i7HK+ythAfr#F+%m|?tz@rL{ghv~m7R{k7RjzJ6IftRq=j3QZ{d*kj+KAhR zvQQGL!Xzrk96=%~kT8XfBnF;?zk%mLvBI|gKVIBa&H$oO4(XZ9@de}Lba4l+I!^|@ ziP9Ax3+G042a;E#&hPf2zA?D!e@C|~OFHYk+EI#-bX;f&3qfp3wLq4!01=I=Tq3aS z13g9!Kf4=&J*>R*DiT?KxEKWM;5h}!C;~&N>db=@f(X^c)le5osnb;++pNdNnVQGkT%0rzPPO0g&^idTzlxl)7&Pql0m1|Iu8yA`HWNbilFDw!P z@{IlDoFcjr(`a(HjO~6!B}H9RO(tqSqC#b!GM3-^@6(SXF&*n?xOW0e9a}~BT9=r& zzPN3wI&#e$X8*m3OZ-_qC|ubm-9_MtvbZ)Bw}i!ewV*6Gw%zjW@8#**dIp{Co;~}r zeGE^sxUc*!ZSy9g-7ZSJnqb?&nPoQahRJB+-MTFsLWzheFpO0u zRK!oSfZz>QGRHD@X?~op!qBHx#vf>&GMe;Yj_>r8Z1QnZ-0nTsLv(@I4A8g+J<_}N z*LIYx^WGZ=sCV=Ff28{nmOE#}f#Od4D8CN7db|FBD~Iww|JdTL*gFVJG6a<=hpes{ z5_X%jTO#Bxt09JsGuKD;dZ%a0KN~Zzkt)TJ#kvPTXl>Aw4PU=f0GwE& znl8K-#QaT)QLo+6c+&XiiDd<(wB+3c^<*=t8$8Pon7{k}+q2Ks2iTyPqw;%kDS!6A zx)LIn3pl!Zmu_5Fcf0ZLm8;s(8}IdnV|=-*6YLsWaCUB%pxXYc-SP2704t*TM+0(* z^fJt`Lq(R3Y6#!9vU4_65K!a_th!?$W|{*?Y60u$15{&;e6vdtvH7x%G1&75+N?3( z@Kfne{bu7wBLGCoS>TA8lOUTlN-ts=P$WArtaG?{84IN)D<$bm%+%b`RcYy3v@|!l za>`UnJ>fAlhdb^yzJ|3mltW{a7%BXR^QT$>?_QTXyj=I)_pMy&(OGzRcYr&NC9AyV zU)NL&S=YTP`i+a!=IsWHMe0Km!zET=a2_Vf93mpIMr78CXNCpHLaqd6TqGy36PLmn zeYj?@3^bS7)UH^hkEM)XwWBkUM?UE->+faw`&IVW_=~ubd$21@hDNC77?PTJpO9-t zR1F9dK8BaBWmsNEX}P58xxq`q&W9(2m;A(BC}q!SpdD5^jjO^j!hg*Gl*xUS-8$Ti z^DjIL@cXIPM_1W}GjqGYns6vy-us}=-`uU9w;#p4Ypu%Oe3r>_+7w0a6UD~Z39cQm zfIY6hH2P5|%^9+Te3O-k<^$9vCN+9_GxE9IBKfd}oKc5QztY?x@6e(5tYht5Mv6l$RLeBVsr zI`_Ds2xzY zBH2p0RuKvmahJrfGOwx9tIcCQI!!IuEMw?jO_62)!UOZCK*g&0JhpGjqW&kxL}~7; zg-LkY&1uhT&1~oZuiNtR-!_T!j~irL0BjWr;0R${fkoN~W|drzDU=#q;*BS6n2xGc zo=$wR!$Y_I`p}GPQZyx%DCuUh@I9pgaX*Xg9@^&@^Z}bS54@*^pWx=R*bT=oFN2ue z6C-h(@C~crZc$Zl?T(e+*B4z1qy(~-E^zbQ0OJVS5~SOf0+f5>0`Uk#wpo+M^qfMfn+M`2%LoqiLT zyz7rHuPc*p2%^}Jen8ftfQX!A@vof94WDb4i zNYT;tenTyhjd7fohgtD(uCUCd{S&mo+O`izFoqwxcGMA$l)#wry@Hf{Lom4j>U#j!*;jH~h z_C1(%$52_$yJ8sZ1Eu=?4fYAxPwg9HYZ34~`!-oEF7ej#j+^Jk;n4A*O zquGVh30JNJ+yv)*pD)J~N(ICZYxrd<{WrVSN9$BSwjGINjf~c><$N6JfL=}&j|Y<- zIp%Dlk*h|w8JeM^Ns3A}sd2;yzoe!gm!>I{b#8dC78{jGqRF0f21W5KX>+S_2*=yF z35mLYlwxrc^@+C5{I;0>7xF1cmieAK2pARvwZ8ak2ky#i{ej-odqVtdU2SDu8u`& z)5SjOgma6)9ZdPI$2>S!PyNH8xxX3iygn(SiYcr0Qw}xmwM6_=oa~CtS!tDxb7C&z z2yVoeRo?u|%&@HiE8t3&>IvLqUPr4~J4^C3E%IW5)dP=rI^Y3pYCWv8OW?*9cusiF zkz`{I@6R2TM>>VQT*KcFH=_bXUmrn(RANoQ_{t>X-;)4VG_y2pO7f0dS2#p z_|Ip}($Kp3p02K-`JmA&x2T|TNBsm$4R}tg)ywmpJ*_tbfC)VK__&5giEa5(oHn%y zBm+YyG|m-MsLli#4}_J27%SYHfFFt0IJk)$#6%$Y?q~3cEgWmEM=I-8#EmF-KesLX zn(zOQ+Sa1*VFE|xTl6(s2l=fWbr|I`MO6w5<{HKZ7O#bg>_)}8I9Rv;2Iqdp6vyfw z?g=_)=0jx(7Mfbn7PmLYggj^Rxv>6*TxB67E{&xrf4Mj)PRB#nU0&Sv$_m)?deXbu zYDmCL{DYQ-Bs)VKV12q~@`IU}M@N}#*&DBvcuxFhype5zyDqiuoy3IH%+lp(_bZ%Y zgZhB{`|p}CmwQ*07Ea* zQmJU9X@*+x39#Dy*4D#D@CEQ#gM!><%8&&ZU|&IHGzQDpAtDihF3gw>t$JxU7o-z% z+$XomQ0d{|^&^e1O-V>(zR*u#_Uv_~kKlDc^{n3>)*XHNYIl)9vQZ&1E{rM0yFXLr z#iz1nx4YdSJ|pF8Wu-ml_}Yz1Z@zon-b85`RW67jm;W{eZHa(;US^FoV>E6K6ZyvGBrDMJwC- zSC#*~yI0&Qo?&R_U#ZC)1m2RijPj{6sH8A%y}QIZyEZNdVvm*zP-o8XeGH{0;U2o? z_;(1nh?sdf!Z~~N(j$9$N=|X5^rVkPX=jbzqUl5#I!)LFou(mNJ zS51B$O4Sjbu$jKNhV~88fL_*|+%YU7z(emX9MCdXz*sk*Vbktkvl$N8yT=&qN7&PK zDu2VnUEYWLXPU^cB_GcRsQcHq)PN`b&L1DN{m~nl;2QX5wbjAkF!H@Ur`~qvYc=~G zko?034&~FFbAGN>FnvD-RC#JTU`>1!=YKF=c|!_J6inFJ{fhn|(+TqmPq>LdhMxK* z{6!%byvjGy#3xJaf_|DmMSV}SenOtgl);J+z-q4 zNqmTmQWKaxrj~jbPLJJHY`5pnpkciD{B0nzN?yPBl0W6maX0sGj9wLwDHvW=MjYe77aVQEbG{fY z7Ra}A0sk;wYP>&NMsc?v=!fs+;D@5m_Mqs;vTR6X8W~w0x5GREJ8{!-GCpyi9{$o-H4(wB^Xt!h>zucj6Oy#d%oi=j@m%*VE-La+l^`8a%@rNU?8o4ux4qor=D;xx&ra>w&De)L@?9jX&{t&Z0H%R=uPPY%c_ zq4UkBWAENndH(?+00c24l`uoMFhbat7`Zz%SOIxp4<7Ff$R_pZaAh4Dx5U zNlx>!oEc_k9bwNOBtaV%L`Ov!`W~U<0?u1zili^{1STz?k@Oal>c+L&&NN)X#hgf}b;BRs}i_+xN?3Fjy zK)w_lZ9PS2p5^8H-fXI;`O^H`%{pRbP40W#Fuqf)lWYtu5h9JnCL~CT5h1Z+ki~^$ zgOp|TU)>2Z}<9k=T~n!dTy!vLiSkL zjlSHoHPh!qF@|_4@@cJZdCi1@6+r6$u1%Wzp+9s!0t+d$83b+e&3&unBbhuw3s~=Z zD)EuDFTAMZU0%n7a8_Qbm2nAQ%{#ZW`51R}qb4B@esd*cI`|HB;G1=Y^ww^ARD6?9 zn1KtLF0VD&u{A+R6%&30fNt)RHwkpWq47rP$)u&++8Z@T>^SJ;ciOY%t`!ioN_t+I ztw$H|F>3W}vcGcOENCt-{eMm0_>yl4U%9<~1w!!ZaK-x&1QptWz*#oG}st6_8Sdl?f z=Ni23_fRb)UQoBf!r?3QcG_+vy~Mbp2OF^RM}2jYc9F%CjZxxL2%WBxAX4h+VWt5x zu3(687q&m%7vUheD9IIw9-tm8xchbx?wexUeS( z-R?g7;4eifEEqXJ?$5 zSs}elCgyLBcC9edASeKe5~@^X697sAL4hXF!vbIPcZ!HGT3WV+T`&z#>j}QXoXJ&} zjX|1Gwk31PcwA|QsU|)SyA@>m4*TDK`I=i`cwf3{wP)tuS~-U^&u43C)+N%08NxSV zUc>TmEPLLNi+Yaw{h@8uWS4*XrC}A@@+dc@YJCU&S$7}pW+z*J7{uPLK>zja94n5$vuk5bMW0k5zjx_>7OzE9E}M}B9@3_yt(~+ETSMk_NI3) zku#E}Xm`*rBxWKOc3p}3;|E>x%7QZw?A##VM=K$~MpZKUCTqyGL1diE9%Z-6gkd^? zg+{`T2Jm4O9bvFk1(7BoO}nI?8u2Nr{%F{I_uUH6A1ab7<@YNbquR-ZV$GZfYm3sw zgKs9?wQ0F4 zSI81|_d@xU$DQ^u9_0Gplq4+EVS!yG7Ime8K4xajCL0YQ0R)svi{D5&?=qB=DszF? zC@i4|Y+M8#i~+DvaQ*;-#hrHH%E@J>eboOexC*s8a^-{>Z&2l5Jods#)P2UQ<75^N z*2V`_!LF07#N%_^jm~+3uz+VSs!q4k-92JE#U#SHC zo4-8&Eu8u?Bc`1xdtA2y#*YBVf4$e18o2?mk&P_d(%}2F-L*GkLa`S!l1gH^v_r}MClB~Mh$<{hlfvVDVipVgCN|=a> zf<~j5WVGITHpgsybRHF9wx`VF91ca{yaJ7mph zR5D*rY};!Efou^RM8PBzfhX0eU`9EKLJWZ_ole*%T4pCIIXawisc*@mkrkJz{rv?Q z^pp-)$%<6x2IYdOsVH{qgg1?C>15sN2c;j{4VohlTYBaD2?Q!n;vHwdwSvHOt==Jg*)eFVPlH~^em#2)Yxn7iH`JV zf)#A92mu47Feso5!GbCc>2j*iv|u^E)40@g7d(uij-zX5-P<795&qji z*vHsk))+mn!ITuvWy`9)h8?|b>F08F^x6B;F$o5QW~rS zNG4NNrJ0*>3;{w7Rvmdt=s7XoHhI!J`q+0p@SGRp2dgXRTrZC3B9?mMD*u2&U4^nh zt|KNf!Q2B(f+_=u)Hq65&S$5E(mu{8Eal}VRs$Te)zTV?$!RyTGeL6}*ri#)VNljF zRZ$~AjD%{!?3_f1(nw5^l$<+!onzt3+Gr7^`fYRO6ybBW%xDdCq~Imf-|WEH?xsw1 z{bp+sN-}4a+?%-$60^_*>=x(v_URc9xgJ3Y>x=A~aRzf{j$*7|aUO?s=SU6_$AM&P zFrqk-7ae*=rw*In%@;hho6E`4e)Fdi#D~$+ghkRLL)PCN^spw>1MkH~z^1>RZ^%r( z9vkz1B$4Rl_p{67{h!PvL84`jVO5Y(0qhN9s&mg=D$WSU%qHH7Df_MEwhHdTYxnbh zXx>lbXRdxdCcdzV-l@A~Z8d`dUR*-tKsZ!Q|BiS5`o4DGTbO@XwP~|3{Jk`V2adXY zJBe-u5qW#i_rKpW?)v9F=mq3GcKy)la`6A1{EXaQOJOHA*GmAFvJ%2YtTczZ2@6OV z$gvEfC;?xnI87}dplWAIqgiy}>|@wvyZgI}>U``0$@l)B`6%6;myg_+PS1)!3)}dT zeUwGq8WYCAR8WiVWpjAFZ+(`&)G=_MZ7&l?js zwoMr3TDQtSb#H>L2zDwBFcKv)C_)RkUWE{Lf@Fdc1dZtoHJ}fNk%>)dh$h?A;v6`R z+MlDe-}X7lluk|Y9L*5*jNg)YFJdckNi1WFiCOKvPWDZ{{^0Ol;5?+pdvfPmVxCDB zZ$K3^!FS>@cg^KP?~%*T;7bddR~m|u#^*b&F4g|_T2xz4Z)sqSwds{}<2t<21Z_Rx z?lMVUxH%_?t7RKTA(t6dOH^(f)Jy&>A+Zc0r0Y^+Yzfrd;qA=uW~SRfHu6|Fw#Uv+WR*Ee7YpjrlT7HL&+G%=%{7 zvH`mnEn9H$%z7&%MFYp5oBOAtCQ%ElG>dU|vzo3vhRKg#%dlX4*x8rotL zIMg@Gr}X~;VewIHKIj&grgHHk)-7^hyoOKz^xwX)?^jGjmor+O^=h`dNx}gd#Jndu zSeyK1CJA{v71i0CAwUvAhWCX!99bb9w$%qZ+zKHOv4dhZ?>ITT=%%dWi9T!h^6!1& z-9Kw8+XsVUY=niCX2?WN6qY)+K*1Ct%*VzbafTO9`e`2>uur7M_>=+LiH^#Jwn-WG1fSxPk254y`dd1 z8ZUG90%u=Y+G(K_z(oarbj4M4RW(p_>o}yr@_h;1@r2E? zaa?ULk6xi)T%9$8-sSQ@==Ku#(+KU!8M$nh#aGLms{iVeuh~I5px`L%CH~0_07c9q z!=&LVL;%gOa|#Nk_UB$@EO&OK{T(GE>%Pu@DJ5JZZ-3FwQeZlMH}$n5_cGfO2KuPt z(^_Xk{MUGvKYRveJnEYEw!R&*iY;h3tRz9v`~9}^VuX7AWOodEE&i~Jy+E9Q|J7h? z$$VL`rz%PSLMEXxR(1?ID1wDFm2$Wu=i`w&^SwHUS)*yfuZ&`+R$aOB4XUjw-cK3r z+Kun2b6Ib#klR^*+!vtiHlq>a!>e^p6|jC>gWVlpBhGDt1azjXWsDbh=IL8LV0g|# zD=sUmA**A*G3J94HCh;!QX+`g!ZdT1)}^rRXbV)9r2=qamYqOQbd{KxHNeyPHCca$ z(#~OT>{$AOCU_>frnuvycz*q}MX%Y%kYPuA^*q^6>fMF@|4HY!9HQcvOX{cMoq3_I z-7Yml9?)=-N4pk|IdC6*81$ti6S)!2h6`{%!e5BZe%$UOOEMMS{QNPU8FFjJnwU9D z@Y76c69FSASpWfID3S!Zld(Dn+vx&LBxN<7akaS*Kh;}1`b4oGg&3Lbn~W4GU_oF$ z&>YT`0t*AYd|jW^I9DBGi(>vwLr?`=5iuRQiDw8kT;h6h5B*~}a70`adp7vFOr88L zaw_L)Y+*m@4-nT^>a=Z15q2xJz!C+12YU&qB4cRJk%^4o6Ys%$THOkAWYe~wj%$oK9xe6 z4XqV3ymxaP=@xCZZ)JCtS-?p{?Vx4={O@he zO7tYjRSQn~*j-n~6c?LYlDp(aDwp8ydj9dZtRWB69-) zh(CPMSO-S{M5EHPKtSB;Ybq`v;%ap&#jVordnR$SYrl_NrQKexHqLAKz9hOD3s-9! zv4(~<$FMZR!;9NiSi|ArZL4fyVIW1CiSTF=HckLw0TKWJ5&)VZfV00Uw=G?klK)I* zzQ5AvxyUkun@!SfT3*dT6EbaguDh5kF}(~F6wrYl0-~G%1k?nGW0DVmdQjA+1RuhE zx*a0y;uMZsKOCraHMq#dy6=CDQ&?>;V{+M^K3RdWW@G00tKgJ~tX7_4DZUTh-nDncM;3XmCvmFo=y##LN|SRhPF zPDXV29QTNa(_z$n4|u4HVo;Dl+I(tU>@(ym`#1NEJbBtz{XMN(-jsFLo=I^c z!m?upq3@?PuZj26tG%4L5Ylb@QTR*o)l|EqcgVx?`_}rmGuzEv3j?ZC)OT5%S;MB- zW8n}T=XRV!k~8Rscr5lPJ;D4?a+ZssnIWl|OC0RSQ zN4#+xcYZf`ZDn=Wk07cy8i#I7_DepbqKc;h8BD&&CZ4rdVOt8s8=A33uLFB02fnezHX;g}%fBzt`Z4yj?dq-S@fs=*B!+n6#a2 z-dQ0nrb@Q@gR@?J=k7b>U%VSpDVa2AM$}UHk}6GrPc>r^j8Ot|d7@2HWMu;1VIn8_ ziWo@YoJAO<#8*z3VcKz5Z*eaZ4zQ?KQ!O|9Q7O3$g+o{|?t zrZ9>&nFdus2wa$7i&ru)+@^1*w28vqLUDFCrj30&ePf<9#H2J+Y1ow@Iq?^_09cg> zikVP@Do8^PG4%d!$h2{8N{WLx(c_f)T@V}fE6vZx!=B|UmXY!jaz zsK4T^Y||g|+o)pKZdIPmMs2j(YV70Uer%5BR}a*Zi`X$PX@Mk`U#Uhq$+M)X6~6t~+PwFHv zCp*pDo;h(Wi(_6NhhpE3$<%Q&{xdPy?UN#C@h_R9Gx=5Xk|wWGNh>s-t)>)t2Gt8*qh-|7hG1J;K2$=r4` zZ>?n6#w}ERX1tgrvC^(dVBd{zvE(528gsnfJGeRt2$^;H4(hfSZ& zetNFf4?kM+V%sEom(FsN^EMGPcK{K8vG{drb5zg`00@t4q=-DhvWdPTqApHLs$w$3 zR%Hf@jP}xZW%54M)$@=GocAd;55n~K2~Xe?g8_^=3s9ONE!+_3~gC%GP2-<&ANXGfaK@L{*z)s|1lJz%rB^Sh`M4Ze_yfE zS>)MWPm^OB714gl5ewjt?kS3Qmf$O8}83Kt#1HE$<4ePDmwITo+h$v^T$F z^(T#j*h$Ni2zq3KG@O+O1wrovmIaq@zq|#{#()&mcilZhIZS}_E&a1*2X*@{!@V^+ zcOf3qupCOF7^G`Ix)bj1%Kprk{R52}YIZ3wVqx%xavnPr+kxWc8C#A!&_`HOwu0uH zd%Tg8JUGrs^}V6UB-a%z+sQir&-tD#<-_vlJcO{hiPqP3wQGCZY|We8&5fL-aBI^V zHeKnwk6Sz|Z740ScpEaDlji@8T?*PT@I?+$tLd5idLv?T5l zXMaz}ikQZ(2CB-|?yw#8vt?JbRE38@L>Ez0KImbJvJB zZ*?{-KZ=g?nRq6`KRf7YehfK z?Buq`ejgM)&wf=k+`@b7emF~)p1(UT<}UB&s3baV-3FD*-Y8Bz?(>$uMqeL?(?d;3 zb=Bsm$!u<}=%RZ;JBZnAYh%Ql54h;73uIkx7?jO_`8xd_XD;zKjVo|ic&{JIi_XoM zJ-m$o*v;e@qkdPu;@R{K&icRbM{uR9UW5?fN_X17<$v)1v-&>kqiA z9p;mIhQeaoJ7SG#!EO4eKgY{KXY31mf4i{(kZ;MYscUN-q3A`e|HX-6=W1SG`#3)9 zhwP1M-nB{p+#M~jW~<=3HdK9Gzc^nMJ{h$Lt_rax!`FPQ3dDYp0 z=D{VYEZog}P1}1->}Fdb-E5=dDHD9{)9k104hw#U4JDhA?#eR^r41FlZinR6npb1t zb3)D&<~Vz^*AjQjeZKJW;=doa?+;t!=krz?3510-FlL@1^AurkN0XRzIpdwJN@Zju zks$sRe_xQx5^ed*CXJpdg@Pqb>2qU{wqJ{qmLrjESqTqOZ;sQluG^5?o z5pv6xxaZjq`qg6IQR?%uf*dyejsE$qVRA?KhL{~0qaFp1eu2@VKH>#cdDr{j=?(I| zhwyP}n(4{?rp}$xM<^6`cD(wPL7%!+eAq6 zO*!uHPK<|3?FBHoxzJZFgFZNZaYwT@cJ{~))w7U;5d$Czpc2;V` zk95@@*;rp~*gc@^vK_9mpOB_sl^pSV17Warz}fGyp&tI@Y7P@VSngR9S=n<*`uLDW z>}#H@pYR8QEYiyeT>W8vT~({IY>K>hogrgku6(DzIIt!YzdHUNBrl)vby~oDwkqLW zuz6j3JAfizu~iRy)g3RmGkF61+0Q!ruIQ9q%KH4p@s^ZX_4o8q$(y&P31#&ecUd(vDKXy>K#dE9|B)s+G^`d>!~%lUAs@R2h0bcIb`>GKh{;J|9lKmv#J8rF7 z&zGa)opafuRMsqw*8y4C_q`q2xHE>Ru{c`)#jz}oV{sgd;#i)?-5tionOjr8Ptdd1 z%lbc#M&02%K_TOZp6dlZzaDSHGrGf%6)@#7DL_bLAaZ4sFBMBZMsZVP6(2odnDRv~~+6QKb-09}ZbZ|D$^ z{~1pyxE1buvg>>+-uu(qZVIe`2JgPxs6NbF(GBfvvKroZX)45NHgMjBrr+=*26gN3 z{b$5m!v0{-{qdeGxC3@JN%xg@9f0m3HZD8`7jLA z22DbzS5=9Qg`nko06hjj#6G0`E!#_3%lKJ7S+_02W>hADj6!6Jk1kS1!4d1?C>|Hs zy->L^ep+qPtd{n+@yApmA^&+rr)0fr-OpL^>2WvEEeE=G0r~qMpIQWdVO!~|j#@hR z<>|E%%}O#INGOgHuX)9ofENtPUFGR0#bmN6{RA7aSuN&Esv!4abj(sVL9>ns!FWs; z(zB#8vKo?vDoS5rp$n>?Kd(k?UdzPS_D6kBzlG(aAB!dGxIaxfB3IJ-wdZp7jrc3( z;GPYytR^hjGy?M5X-h$ojHkZwjOF_AU>Ff*v{SB7q>o9c8en4Ha;o{hS~tHvGm3%Nn*fn8eS z%$~Zr<64Iqvik3&vgmc4T7JyF3r$jHC_6T`D>6Q!8=W-~wD|~;E(j5Ti%gXs$t`Ca zVy;&QUtQSLsA_WAxyv&&Cpy!Qt2xZRQ0UG57=_a@+s^$mZ|*~3(*Ol(nwX^)@=Qqq zsMI^BO^=V=H#az~QHn;8CnwR4v@(r0dN%g}>+1_2{?OW(vEfo9^cRZZw zIO$i*mD$PdejzCpx`IgYY@c0(4E6SfLC?OC1`9^dFIAM);=gQz{ zMyT!Dw3`uTj!qRgCo)$Qe5algK)!B`Se#reNf?F!-tNy<-(I2e z*Ks>KzQe049W1(|B%!u{>TV^!Bs?BnE3SKnBb$jCv!Wt2)=aA2m@|s0FotoOg0xw_ zc#dg;QBuC$maSg2JM4S-(NTBen;+SV=AOpLXkyQ-8(x#*bew9=ah1*`0WL3Mq?96o zIiv+zc@|Fj`^4Xh&q?@SNpq+^D&)S`yUsp_K=xyMNB3NI&_jR4s<%pXR?Dv_Uk@14 z-nZXgCvLvfZP#Bld5j#nxy_duq;&2s{U6^2@5*biaay|h9?-fk`bjW`?r8GLXAQr= zY4GfKs82syaSZpVJBBa+O2!JrEI5tnJ8fR3_4|8FpZO-g*kq{?n16Y<;Bbl zU_h&-%Q-tS2_4&#d+6JH7b+bZ37599Ms(cyuIj?+%3OF6nzn%F{V^e}f??8DOkJBE zghfA9cOh3Ha;D}kNyCBhZVzuy!e=qqjMjg5X8*b4S@RGaG zX*Evvkx?{TBE6f2H1S^Wo|@Chxds6jr(?Kl)o^>W`d-}4X}40aw$=Do&Bn0S@~daC z<8?W~9@s!=5+3^iKbqf8kgEL*#%p5rUw z)!NE23MTDYUzt=IIJYjiaqj4}#p+i!8?$yrRcVYQWq@HJ5E-pXg606g;|Q*xld+2i zHY!4XLhh5T6v$w+O!c)CMQi_acx82U@m2Qs%b!zCmL3;ojiYM)rhMMmzSMek0Zw9c zH>9$2KD+vrmE(abQ9?<@jqGR|q=Az_zE4bPIx)j_33ohS<%!02+{LxJ6pVJY;hJ&h zaPLkFR!6(ghCL!YG)dBdp$lk`>1NhM%?PXgS&b$gBxQyCh1|zpzfElVqbyUK!CF5{ zFEe9EEPrXonm<0fWjismFSJIb@9UvMU4>>Qf<$mVnB$tMjrBw@6(m}t8a_YWcOh0G z2Fe1Q%UuA`OGQR@k$LQ{?XXkx(_Dc&7M!Ec9+TRIiC3Q1MBurYWBWH6k zeJeHGv}~~9srGu@0EdD7axgQ;{1)na;qgQIZmt&Y+jromG7~jOcA-UTE)t3q5TNKP z6`3#wAee>-<*8K(9s?RKbh@sYp3`&9oxTrLrC^z#{*}3NPivPEX~XcYpXgs(r%vI} z%n}uCrP-b#k*OkGf-Hneg~<>CjR*)bMJ3WwLa)_uh2FZ{u&BmzFKP8Xg~_2mHu$A9 zb|$;f3^j!Hh+zPsK9!34rpOOOlNt3~L=ZJvOUz#hL^XBr?$uhZ4z%Xo-Bh2brlNgHfM9yO64ozV8=JA#A*~#pT*OE@`;dj`$1qgQj!j!T$5iFEmA^Z@&Uk8RoJ; zpeu+HNd+ha>#8&fYA;QoL?&@(!;!XEW2zW{%@dNQU*hi7!MWV=hL&csTE<0Dx$9`| zOiqS)R5S<(k2OVH6^if}RKXZ4)pu5C;7oW|j`d&xHc$GD`oDHngp1t&u`M!_E;L5X zHz1^|7J!Jyh$?xWQ;=yME@A~F!BeyB7xEQy$#Jot2EoD!q=xs;sr^T{?h*|hZA5*+ z;7IOHYI~6rHIYG*QzdmhOw$pHBNZwt7O4j@u*Ao`hKszf_Ogvvc|$BJ_z5#x{xAK( zkol#eYOSwqHfHRKQqmzCnq*9%Dq!WCATcQd2pZiMPc61$h@X(Vj;mKod9uKhn~-?| zrnWb>V`TP1vL+7`(oon`oYEPLcA-3K9>|Cwpzsp}7{OhYM-r@yU7{RH+0v6W7xC3_ z73Q)%g<}F!ws~FB{|aQDJ5*ar=@~*v3vE)fNrNXarqmFkc>L*`jOrw-o>9jX!c%k5 z7xL9`6z2ZYP?y0TQaGAaAK|M|xt{INZY*jIb4PQ>(BH6}4DuC8#&jwWB0*1~@mvc> zD}Yfdod%&~SHpj`!I^Q!(&04e%yoCyE2AsR&gGM0YzsU;PEHo_9XgH*}()IKgL9z)YAjFWZI8GWMrl zmW)qhHM5O;w!u4hY6r6mQP_bdZh+*au__}-h|E}0k!vLZ-R~+^em3qxu0m`%7YjV} zbfw`w{GaxZ7l4j%t?E8t+4mpkPxtw$ZJ~&*PHk!-BOQ*7vHF!P_1q`)85|%H2vAj$ zN=3_hbAcrw0Y>!>ryaIR!xffS0y!tU6?p_UYx8VL_a=3y)ZSLBc>2^1C*snf*jkk0 zlZ)&^P}GSc5ey`W8w*HC78AX{>jDH33s5c|z8bIF&`)XJz*vQ!GUGA6jtzELpbLoU z`)ljl>Ct9hcFSmE&8}D>BB35gf&|hSDB_AQ=zj@2HLlm`TpxKg>c!a~Yn^!lro0Ea z4(*H=Lq{~~acoIW&=@tlc_5@7P32Xxo}yMUsS72!b1~hT*9gJmMH5O%jL&WKw0; z)o>Z+tG>LUEXd{wC*Q%W!w7jU{C;sV{+yvh>p5(I4VeqgQnM_p5fIQlQ;GuAMdFq; ztcv5B0V<|a+r=37g`DPHC)2fo1Qu`eY*C;g@A1&*`Gctsm-YeoIWDIawR@&0w zIj0&0?1B~c7(jul%mdjgOyreIgCdc96(i|0D%Uk!WqH1oDlG}D-sa_+>PuxvCVDwv z3oS_}v0*vAQzh&|y40k|(nG`u;6ihy8r1?KMu_UstrML(f z6BVl>Pz6L^(*(#+fF=sk7&O&&%TB}Fd#%6h2MTz%MY|GMZpdk_Wb``G)2XohV)tl7 z?W}4j)TyHH1S()}qY=-91W~>eRU};%ObQ+J8%nQdv}>-h@M02JbjZu5+Q;)7y-f04 z)WOT7r4`&2TG1Dk)@X}NZmJT9K}0k~6jx)mY~#%f~dF#0#pTQEmBN+GQ&y53PUP8nP@3-#-w$Z?I^vT<+Wpt zlDAclEP+WE@oREftu_748k#9}#gd}5mRs72EmYIM6)AdG1fZ$_p`t1(WGEGhgc|!+ zxs%wic-QOk(zn1u1(vpw&%58y%VRsdp0(=H{#>8?M%iu45*)BKhr6}ygR5<+HEbJ` zq48;E0$r#JWv5g@y;Cd4%_ZTLRR$PO(U4DPu+eO{+iS2rcB^pv5*YNr;AU+HeyVFv z^15Kl7+p2DwxS!2HJCI)Dba|!sQ4wslmcN{D~!4%t0=)!POD|5I=tPzSk+e8J=e^t z;FSWGOez}8Q>(NS2IxUzUbzBjC1#fFQa435Ei{%=jYJkT0lgDcW(p8ZlAfYS5>+-f zM6wE57>udoY*g*_Lwz#`-9r{E#Gy6g?eC_#8nRRjcz-o7#DJ)0wH)|}6EKWyDmG7SB~!L?m&v-y9Kj{W~h ztq<(1ZEipJb>gineSqM&XrG!{u}l$+h>TGfreGv7Zxlcmi1aE0yL(%gSv|^XX~($i z=K)z`pq*LPW;=mD$%&Koe|YC+}TL`ev$$Rs_VrPr1Q;MWyOE0PCBgpt-LP#HQ;byeK~_q0|%U(fxp-RkD)+>Lg?XIz6tDr1Ff|L>ap*%>QeQ?2&R)a!t) z$ElhPW)>Nf$OD80QUnoIL@GqUfn&@@fP^}^6RfGjY^Ck>XzPRCz#{pU08d*mAEm99jhMMI*f~GRMTrr=@0{~sTyuNm@rA!XfXf=enTKd001L%M??j1w{R{q z+&DA0-)g_V*>@jdB!#bG<96GfDz_K`dqSG9>0Hu*Icj0MWa^}MQ zL6Alnib~?#kREF#Sk7?lr$nHsIm^JE;pVS#xAJ#aUiWYY@2Ybt(K)*B%>nsi}GH(FD2f0XL*kNc_$tEN8eNF?uxN`jTQgZi_&VZ zYy8Ze`M})U{8nD>UoDoK{Y7NY56K*zZmc(=`gQJ%itI{uVGN_3WNf1VU+RV%$j)`x zey@FOlvB%<1<$;is!x|9`-eE^e~x`wdc&Tn+8GZVoWK9~y~*cGbz_;g(9v|^cq&~b z_;HtaQ{U0Y_a~AtoN)JaIdo$!m*$m0W@W9=%!vxHh`}-KRuxV|bu_8Oi?Jgph4y9D zxMrUG4K9c7U=4_Pde-dGSo zbdU6LQUQVEvU%cXn|9PQX4As1EV4w2c*gx*<>vMQwUwOFQ;S-f}!HgTRvqCYd zs}*k)%n2KW{Y@C@*s*XcaguY-r<{9SJ-+qz-sSTQ5;{nlLB;I(t@*own(W5vM>bYo z1~YBM*$SwVG|Ff(VQf$%y;LKEQ-Q#%i7x?Fs2xFuv z7KPBD=-oQ6R@OsOI%sGi=R}rXj!le7&fFD@y&|yeR-e4a5{;p zco>sEYR@3MV5v0t(3kXkj@LVXyRyg|>6P&@(|+bNrxMY^>oUX!3ThJJLOWmTGthQJ?d6>ACBR1k`fxJyOE8u!kNP>@&X*K8Q6b!t4 zngchb!UN5hn&`p+7 zl&`LfkF0TneSZV@^p^Xc+oFzw4^#OqxNn8?m!O-MG?M z5wSVW6~OF(r8b2K%`ssmDX}UW+UxgO=F~Jjn~)M>{wm+|t7{A!%vpBI9UT^;RD{Y5 zF_1W>P7MvK0WUTNSyj-ox%IiHQ*w>3;(L(#&Gj=UL?Or@rOE$)El{cN;tM%+_x4=9 z{EQJBE401~s9g%ta8_^`X0ga*uj6&DCFkIcfO5@ zkxOOa8SB%P5G_V*tr!i4Ex-y-r-E-W%sN zlOJ<~tw|L~1F`*?Pfl8yy+a&_g=ik3y{c*9GIJA!!DbM|0_v&4$ogO3T92yQHOl+P zRoyVnAUUW#pDN7Kl=(O$LbVd15n4t^tT8!l{DzyRv~zAr`cU53XSW>*xhGRXKd$TF zA6L?w!4yUR^SMYWLCqVny+Z$$x;EAg`}OfFiLO}}t&!u8^h1YsBe5x4wAY@gZQ~K+ zHXtU&d8VY3*f*bXT8KjtO@g>;1hLNunrn#grM1maAKLi5C71F>xUPE~|GsGdh1;Kz zP^$__&LQ#H$Ru%LW7M<|p(2gB2w@qLP7O`X?U=nH)OEJn;0#LcWsLbcH|f{6I=DNt zrXv%Qgr@t_~eI7NSyw`o`sDT&i579e(!hffs9a&as*z6-bq8?>1BMjg?gO_JUKWOQOI+d}cTr z(m?&O;pWMt_v@V21>0)LNNy#u+d2!tZ|{@1qs&cpDI@~9$i~D55F6~a%46n6PiGPRA3W8Z^(+hjAo6_XlB$q1MgXTkSifwq&=sV6W`br-0vF4jGPC@Wot!sNe{vQwa3U$_W4v+bf%;)Ap_S6n-G zT(X7(Jx6DvTITxlRBjaXAvD|tq4s)+C0(UTdp8*KbebAVNDQ&%J7X(G65T>!hlMyD zp&pZuG5WGkTeRtMw4UWT(S!32te|D(mSr@1U3^GQj=?-0vJ+B-Th7vbT1n(>3uU@3 z#O(;i2EVz;28UxDYwD`8N5&aSFQSNBq${$kjA^fv6Q{x;pG`<-2tF+&^1Fp9u0qU; z(AC}sYpDE#_Hc7-Z{0I>SaB+(P<@(`s9dw!d-i!&37e1}BK8d~1$k5A^N>gs#+F1> zgb#yX*~m_9OQr_DvR16!JfVDMv_9^u>?(EI>)lAt&)6fG2zLpsY4^p4AHBo9yW+a_ z(iR-C@(z9juQO}iDQa~V;y{Fv655Hyp-%@v!z_2EJ4eZG(Ec*pIGfsCW%h9^CYgO; zTVx=&2X0E&zuGFt?nOPEyg?3hdpIW0l7+EjOKc8*1UyQQ_8@S-7haL zKXRL9@3h~3|14eIUE=ye%5dGHF@zSkKn42?#)NgQui0YPFDB575qBGlI#Om%3FWi! zd2?z{{U;vOWZvZ^QcsvX?`NRUE?qW=Iu%;!;TpXO)hBFMwR=Mh8?Xnmh4*a6Z=GGg zlb*l2aO!L`pB+56O6|jD%26f!U$sm0C%-xWRDaA#uPFB9X0wAE>-LQt;YrNp_n$l5 zbv^gb4I_3N3vk{0CH@}t3EGRjaxkY1dVBrlXRQYwAA@jl*3)^XqhFjO(My5S-cIS} zJy|WYr|y6opWD{{mw#c)U&=#|E~>QUeiikX6>wzi2GRB;r~~o~tbIOaf0ZX(KQ4TC zS`WH1MTf!RMjTx<1qymXD3~e8jgKPs6Y{1<$?@C?T-3Ot-MVmiDxuo9#{XSPH}V^( zblQVxqaWb$LvF9P#X-BK=zTB`#p@Dz(GBaWoO?N~DWF(0<+;dQSa<39Mq~cdf+xJv zS`{z=3E;-#8;s70mACfaTg3yyym{|GJWQbf@Nyy~ojDjcx>rmz*|-tR9>4yVVcG>$X=7@%HL#1Pikivv69s4W@;;P-c2mnAA((X&A3?RsQ^YiL%)=L;|P z3Iru*2B4m*xI{74*OG=LR*@0fa?o2TdJUF-E++@{y>WUAdOf0lR*PPC+@wATKu{{u z)IqIA(RO@G2m3_f>7~Kr#*;05l?@ z@$3R}I4`vrYm(BTKey?Ge?gew8IT1;MTqt(XOJo-LouyND zI+ypOhuGoL#&h{Csc*lVioWRwk8p+EE-oH;A(dE!wMht5Q-w0zV~>zHP=qtIpkFjH z;fKMi4!%Ae?e#rq#3MsTR=BDP7Z)Oqg}^bTLI)bc?<`r-84`1aGo z=JV_-cJ8IjRr}{a$}aK1fjgm6r$RWc&fVN;tz2TVv7sv{Dv0$KUXcWkz>(=l1QZUg zG87jF4L_STsQkOa#2ydl_GA;MQ8&{=J?4A~r)<628d0@F$_7Zv=*}W`_dkyUpFNBY z^yTWm^^kA<$bzfrR`K$}3#i2-;FqYHzLv)DKXn4zE~kgl*_rHE{|eR) zuD5Nd|8|~0#h0PsGTadz1|>>`V9eC|$mO#Iu@{^9xeu1@PqW7R@$k@Jy8~EBT!Yxi zp)=93`Uk8WT%p)R*$Xf549~rSN$+?N)(;e_L2BWoLTjME)tKtzLEzu8{U#pTHvFo3 zLifCC#6Is8g8C^XE9xCk(J#ag3kZ}MhsOYgJ)?}um1jrzjjZRI18JnDVG{Qp{gd;?WiDCiBwXD{7n#tmh`b>_`R>g~i8`xsMpW{}?-3ZJ~Wu?3~X zKvW~O1NM92ko2G|Q)(ZRnZ<<-{sRAx_p5z2^5Doh2`HISeWt)`D0@(;7tO=Ss^RGC^nRgWr~Te7Drn@2n%AgZ z=Wh&8xhJ}!hB2=#u$&0gg;G(IIIWdxT!q2H05AHP^TlBJ(q8-Y4S9Tr`G(H<--H;q zmISt91o1%XIT$-Qcgq8-E7)Z=;~ef@8Z>6=4@Bm3A@D)m%-1Mf`Gpn>5yrxdHINvr zgw4)~A~gjeYisHktg*eC3q=pXGWLfof4%&2blHQM9xvERz4BI3HTL^L*UsA|P{0$- zQ6$%!w=A9>O7NWVM?eg_S?c_-=cW5aWrf=w|UqCREad zkp>86r>M8aab~f*#LCt|Kc?s~Sj+#-@_PP3IVa$KQD^E$9k$0UxZ1o?6$LzY6{eZU zW5>iHLqKQL2}_)A1QRLWQ6t!cmQ2xhu+Gj0`+1A+@4q|5-IGMA zvqJddF-|MB5pm?D4#EkN2mz#OqR|6+`r*;86E}t_-1B@<(N-OtJ{9GMv5Q@VIStdDETm}g@IViZzc_D>j70G4#mo-jExgx z(M1A@8Aubmh7!=++g!jsR_!l-Jl zsk=I~5NR3L8#32}Wd+vveZauF!Q{bC;0x1z7X_5cr9?}|6r^sEng#5$Xmfgv3hz}ySqyOAChOS;&6uM3 z!Ry!j{xg^RSMB^DZfWU7+U|+oji6~}A(T2j6$_6dYaGYLE?>BQou?X|?)!uO)bWd6 z<8X3H@$a4cJ5F>&Ta+erTEc~lyIx00J^ ze-mqxWqQ&CU5D*Xp0000p zL_;P301stn)wzI{MjoefO}F0Ox_R9o5EO@Cl4C)~rr9kpv=a+}mwl5VFPFdyXut_U#_W z#kt*mZEBgDO_!Feieh|t*(Awpy5m&`E2>R0-a5uIZfZKyK@Ct48A!r@1^{6I0GSay zqbvY-2ij0>6RaxxdG;KZ#5S zmTAF`p~rN@j{;Zn`0p;b@7nLkG}i&7@7`XQb#z8$C7IJ12A0b9TS?&oP%<{gDQ!&C zhJSM%K5u_)*tE?Z>|?;RXGog4M{VFsKj5%?us*{AI!?#f{E-I!iSDuS?H+CQ&apQi zz9($^d-KTbd(JZYBe1T6E#uaY)QiIsxzE_`Gei;Y)7fc`faKEwXbNX!lotAriTkJq zPibwCw~hOEd5m=l%=?BNz44y}8u9O}S0YB=U5h3?V)j%L|2v%{e{UC{asF<3lgqG0 z;K2btb+K`CXX9_{qu*nGY~NPtx@kvnN7>c7`{wS8{`_OMf6GC#KAFC3>2aWG6HTI; z%pow{rvEG2-V1xh9qy*y=EBb8%MXVG#LwRckLM>?`U>D!S|+Gr4uJjurUm588FqMT5wb(=I=@Oix=A%Uy9 z;vVFxQc7-0W(N3QhKyiUU5)j>!)Yh}JoP6s)nIyL88b#c znPBJbuk!fwuowMGa^n{d#i-P^pz?YOLZ8G7Ph+hgAj1SbpHe|n?g6KnO+gYyG6Ym9 z4xs)nIC;3=zE(unffH`EdWuQBDIy_(tGeRQ%=4w`eDiqKpg`9 z6dVxv5uAH{*SR;pzJ*h}rAdZY@n;!~d)ps zEsbBo<(Eap1ITsV2Fz$;m`-gYn3r+t*`WfjQ-?|l-uLVjFg6(fm380u7DL1r&ez}W z(M{zo2t8fG<5=r0cqPAzf37tUf~P5Q0tgDY`e=kR@dC~UgI_e0=d4d~A^x*<&gRUo zPIR0xtiU|s(VP4=d2dA*#;@KVL~#Z1WEF%wTD2}w(|p7WBz~v_Ax`5)Vwul}Ufw&4 z*!~n85c?6`t-ZBo#r^#`{UWjt0#+Zhj8GQ-ay#X5`&HgLzE;#ALZj0 zXOs|KBs_3jS8j?boL_CMlS7M#qDdQ^#YN!~MEkkL@RT?O2inrv&2@oZyd(upWMpo0 zY>0nbbpE12d{vJldHdD{lYW~Jn-zW}bHTMPxx)K`$wlWU`k67)C(b0-gB+lSn&D^= z^j-oMb8Xvew2M1Un~c?HJ|Np`>|y~fD^zQ$n9}nip@HkV;-%zGBMu!h=jlV-RH3G( z%J)O3U;tWVSAaIbpxm-oSQ~PDqw;EsLuV5jL**A-*BTH2e*zWXz>v6JyoF|ZS6m!- z?P{Cwz3VfeZA>_LjVgcI85ED8*l+yzlgpDgW28&`9V18 zdY%wk7fIjdCzP8LpErr|Wr?7H0Z;Y%e4jr4vN&L>E&=)ZZ_GswoLP}J%OySN?c6SX zDj6JQ&emWvru|h=fvechr!s;=w7y{6oq7}3#hNQH1JiEBiL?q^EIX(h{Nw0eDngUh z&=s7)0f!&EY3-8!-jz(yz64BprAk8);Xbh^r!*r{<_G?vy1xKg$}bBvilz2OfSfjg9&t8|V2H|B@nb zqD?wv08}8%8K6VJu{5FSjOJ_(!=Di;rjcL5n?ww+f~^atYC6cokSmR)wM}<&fR&!j z!pfA7bhFB6G7AnKu4s>nfX>hYjT{E_aY0OOMDW=XjjN)k=L|xiXYkV2x^SA20&+HB zC^R7mxWR8fltzbVr}QQp*c5O(7~PoqGQGiApOb*|&tOi>+Mq#Of(t;$&^jB`rUq>z zrl%>gQw?qNanmwB<3Xr2eWwl9h0L}_*GmA@;%SY9i~Iw;eRuMpaDggL(E%fL!K=1~ zd$-8z1uamD!(%m~7Ur@^wXcdQJuVU+xUMTjPObtVk&{qFq@8qAcS2g~6oN9Ma*DXp zvwon*4^}4E_SzOnZu6Ucpyqh57KtjTR}K*y`?gF{bzAEF8+s_5coOGHTQdSUs{0Z?aK7$~>#IpX52Lakw>Ian*WQlI=;D>Kukr!gLZ z+?W8DUoo$sMU1y!T!QfE+ILabg`c!DGSos^XlgAFttWzZ?m&c8YQU5;u>=0=g0}_< zVE7hoPSl^jFCU6mId5f_$ypHaXx6&i+5Dzbs6Rn%qvX7vyG~)yg%+Tskhqoer{I9Y zkF~gS%_8AU@_BMLxp{;q*rpZv%+d^~j|^rQl)QJQHOg7f%Xjz?E47?Vs#{Qe#gS0J zWnJ-Ua;8aFwMqrZoJ__pts?~5bSbt=!wysSERcQ|98+I6|M>fCMSCT_a6kXiH~j`n zkqGCWE%To1!uVVywAlYtNa7M7iuKF0L)4&CmKC5`bAa%{p!K(#`^`OT%wbQOXW!qo z1G329Jx#K}SiITYzgs;RTCC|X>13MGQCyI@)QLc$3oFpg|tGdINN(E1ipt@_d~h z;259{FM~{Wl{6KaTP>h|%c=&5?EjODrP7GNeU5uEvi@IGPJNLMlMj!=uE056aJ*%= z%A;fjSG6XBnd%qj>zo-o7?jNjg|16MgI#!-ai(6(tkk!*d5-hB;i4?>H0?~Jjkwu%>98IIkuldLRNb?skmWs z8A-weS9QfV;@v`UoUH_;A02ci#e?4an1uWNez9r+HGbi8@Q>}_caj)kj^jal2TuySNwK$?qq0Vn5vJJY`YP|Ynd@%SF=p9Weh^3Yo5kl z7tHoxlavh^q2_H|XmVGxsnkkHB zS(gOVAdb*b>XOk2XNnT>S+w%W)vzmtk@3KCUC1`c6c-ZF63Yu5n$jS}iB7fklFqbh zxdBCW!9o+hnx_76i&kf+j!1^P^#!BmN2wN7G1Kz~p{P20JL|#-SPgX{qzsc74dE?v zK;gE~kPIE8>mjD8e5ZXsYFEaC|-MkV-6rksbq5OE}Q^aNUdnuxGkoI zHt-Xgb(`EEl)A`iq+rVi}k>G@hOIt#ab)h28b<AD9|Ct6_5Z` zAraU(;Qc=BlQwt09?ecES65W37S^?ItAdceB7}s5*LwpSS+V49dWzMs69Ml{O8)@g zBYv?wrgKv08+X0|2efiyM@0Fsdg@d**5zA*;y137++y>RbR z)vqvw;q`@y~vh0#tL2*}<6Mhym1#O4|q!R1*Bn={`lwc=9XO4b7Fx?(+4>(0O?-uH0MOVkY^ z;Ke6}%}N@Q?_FeF-*9-{d0WnZ=Dd}kXXgURlfLlyG>+j9Tj5ucYoBbJcp7hc9C*T! zHmVFXc4+tasp(e(+?u)@wm&Axz0r<^ z+KzeZR5L;)zOVqQIXx;(drn=o8={VR3w7bDuS5n%(Ni_wJqJ~(5`DFA*Sz+B1q%u4 zeNDVV^`g&cMD4=0YL1E4pHSfGFa}|7kQF!Q<*CO)d+UfAMZ&{h>l#$1H$#^`Q&xw) z=`l6Y=;;J7!**V#dX=U%IA|~&QKad-k-09@P%MEi#lo1!ARIX{0XZ9DMm@OlRH47O z_6URT&#)(T2=ZOD&3|iiE6U4Ik8$pGz|UsJR)~O8Wie!gQj_7M&6aM$9NszP{`?c*XA;0&S~=FuMqil0|e0vk7TV*84?$p zHiRHHqzLGsV6}|KH?_mblhvsKn}b6oalkP{Yf9N)t=Pu~AWzoe8Lf38(SQwffpw&C zCOXP@P$F6xSwu`xb=)5G{05|HhwOKnxqOqKi_1l+sh)ck<*&z?fYkdCZB`fY6QTXx z>F&GbK9C7;(v2_9dC1oP61D@q&(TKp9QII!hqu;u3XV>u6P*!~Q_jpWhHP0YCD(3Y z{sc^whd-0-N8#53qJFQ+5w?44ru+lnG8J}jRNiU?PpSY6=@;JpT1vXMaUh@@q!LLn zhv>$nM#z{$)2U@@pFsj+ZklhUcFJwJo8?$IE!RsT+HmdyHUT{&&)rmM_LWCMv6xz@ zFSL)l&=;P+THW9O%w!K|LcUA0mp!KQ9v%Efv!B23vMQg>H1Ik1F0%aX|EJ>=-F)wm zHP)W&Lu$?s`R(7lH;lF{Ze=YpzS|fHa;{JBESmozFE4DBiO-JNLU(tlgS3%-?2O;H zS*dy+7#O?gn%w|8gWAN1Wu##3QC z%^|0W9C%OLLDh$JU0dWB5i7;##28yf;7H(K-&y}XEc4vlTB6;Z`(u6De-Av-&))Xu zXe#61$C?+;Yk!9};B`#cr}DAcJ)tqL{yCH0;cdQgYs_U~Df)QldohntPB4G3y9)ZP zCE4b&LEZt)2l*Pc97SJ0B0NCGd zc*dZXvt7Z-Ubshic`NI50uGjfrY|mfQA>*?7%z3fD z$kZVtX`(dP^~l`rQlj^KUwD}~9$Xygg}yyPC;#fUmV{6aa5b8vnH=&e$6wTepHR!~ zZ?lc_f5y`bliAsU^5h%tI=iS#?*A{X=1sc7-`n3}{X&-Rek1zU_Ivx+4Kepz zSX)}YZViz$_WL^u^7P_JeilCb@POXOl%Bf6a=1Rx>v#Zi!ugk83Zl^BYw)2DY3t+F za(>1>DK%#8NC-2wJkR-)ew_0cJmTwuaksEz zv%kEn^v1r*(#g)RjmBi1A8l-Xx4o6$rf_lM#@E_g4JG0*DH#4--F9%xyKal@^&>1f zc=xbd?rau({n_)K#`dt>8SU;lZN?A21-Ko?noZ_T)LomD2%93XRbuIhzmx9`>zvH|czb((^hHt~~k_cPPDM>5MXYjd} zXEr8l^Wz%g4+CBH_SV)WUihizx3M_yo{L+zbQkd_@0MLSF&>@;`B};t$1%2AV~uzd zrccZB7S4CruyFHo?_`W&O;3o#?}op(dkM*&#quOEWPan)=YD6mG9Tnw#miwE3#2K) z%W-y^T%sSZoGe`)UszK z@}A;@+e~Fg7XLkd^KZ`^%4@~AW4Q6A|D6+M{i)Ne-}*|)qLa4u?20yXi`3=>eL5fe z5T6JR*UUdJVFsM8)@~wsOpL`TcU5J-#1q-uv9I~ikA0Dhf^f+!=Pa|xlnx03*o4Xs z$^bWrAoRfB3r4VeR@kQ{fB!+o>5Fl-A5y2jGpDK!zOej%KgIV29{*0_o9ANn@Y@)l ztG-F;T(i}7zyPD@Ke16X+>YV?(Ob*s^LtT$?qMfUm$TUkx2?3Y-W>3mFg!ko?BqkhvHWqW*l^u59uO1$wo<{rK^-$iudma1FcJVLI z@|g)hIW(k@5ta#+APdD5ZE9n6atODNWYaI+=FLu;jPjOoe}!-d~Rbu?adU|)q~o&RVB$ATxjg-eWM;d9rPLI$mkg6j7s~DeR87S z-@7q(-+2Gjdl142*Ey-kQZNjXoIC1pN)bkM8&jfXMJB~pTGQz~jr-c4%1%h9_f--? zIpLcpH$^L2B0^J60rl+-+@rtW9;kPypQd%X5F; zF7w|0U?v^i$C;nyaR@JRveJ=b7|c*j+qE4+G~l?QL~R7notri4(~ZHeC3_-))b%*` zzOTJYU*4VV$mzHF^nj1@UEPDzcYpE6u}ZB@wSAdl#&*>+N#M?@&-gC2;oy(^@z*@} zY(J0d*j2Yc1fSMtS zK$0e)GK(`2A^^h32zqHeZLh_`%6Sp9SRrivwG9>#`N33iuiw#JeD&y787Pn#-Lw5~ zA4iRWs48&cVq7C<5-Rg4iVzy%)RfAPe!4me=mJ+G({gT3Jukkfw(`{G@re43eXfOa zZdWYzwQX)&2N&eR$?Gq^aeo#}HlPrl&4Ib@S)d3m1%a3jb*2TAz}H3jxhiuvD(d7I zwzSS|*2r5_t^f8LHJ;aIFyqiXHimwqzyrBG`qQ}OgJfJ90V@9 zlF0v8=}G?pHV_a400aO-Q$!^I01s8?D!aha$P#Rskh!^=o87jH#9IQn>re>G5ovt4 z(04OC2&DtPcY`GT|CLHge`vh{z|2tCi~s-v7=6%V*wblppRaP4Bwnj6Nfkftjw<(; zduX}l+UK#9IVO_ZSTX788wPQy*)=4`1|xNXfl5yZwWxfI-w3S|WGXWmLL6C8m6ajK zk))MXCd$Z=tWKG_kv5mT*wfqq3;+PkjDXRZ0q?xGJKb*n-AmfETyUkhX>3~(aums9 z-R)|UtT7T8>yY4R3@;PXXlN1$NzFhluF_y00X?eE1caJ>hES!x_b&U{+~SYmWb-}A zvT|x|w&m1{Dz(%$73DJ>Gj~>%Gp%L(Hr4Riz_oVQk+B~3>24_nVq1V!)_YfUzd!+Q zxq52re-4Z=-UJs4%>R1!SN)UQhjyu+X(*pQ%j?t>*;=jDRajE-DlJo~s2ZuSIZ{`8 zvz2C9GxhfV6qM@Ns+xuc3z2gYB+Lnhu>!aVf~T)aT(jF}o|F9jo&}wHCY^=z982+- zn4O!Uo$ku*&6zY^xZnT%J>5B3m$a$-4?FDOIjFHkGmo;(E0|T!qmiBGpHfZi`)HSy z)xV-@Wj)K&&pcIaP3;`DW~$D9?X!1nx{RpaihIvxXRmN6v~HsyE%fuCjcSJeu@v@L z=r<^G*pk|!$)4<qYx0$hO z9H$UrMJs^_7-Dzj5fuWH9D_2}U3A9wd^B@N;byqKc;a)L?xyD0=V~Il3{!@`wOw?X ze>7BgepS9KtC+o21FC0gb>NVUz8}+jv)Z#mlRTP;GapRYje@$<(#kBWsL*wq&>?8& zt7vCnA?$t|IAuo(Q$_{)@tx*BqD#yBm1hE+cdpjasu`%V&vKZlqh*;%v~S;#X)=Ck zr<$Q2eq4XHN?g#u(!K*Wz@i1PX>6-X`*XVYU8*$nJwuCTP1KgAzE$<#_GgJT6$*7p z-zeq?VQY2W$M6MvvnW~oe`cwxaa#&zeelw(Af=DOI2p3lDntM>2DqdF3KE?K75m6V zq`cXp6{M-q&BNW_%zJV+&G(N@$L>sS+EcH@>_dW!ipSghe5t0)x9U$fOX_uTa~DHE zRDQPCzTA_nn)iaBey{f0RCe3>+iDTdi?(FEtZG5i@nU=x>^5c=?g*k5ZT@HA;|2BE zqDQ5p$XY9VU2`*!bMX`IT6U^#@poTi+aYT$J|gN3+I^(8&Q^<8`HrM?yJ$m&-mv@H z(ptlYrF=v9v}90>KfSx%$L_s!S3Q_*`&{q=)7#t0RWDu(`n<>mOimE6x8~PNR5LD^ z!Rd+=5t4*-tH$2S|KP1PZ?FH@wc*$R>b*6;hUhY=zBH{XYY}2~%9>0ghhet) zBv8aoY+<9GoJwI0i2K9+;Ym9d=Jc&+q?8ZXh$FwM25XEzp#u>##k$j2%mCbY0zL^nU&_;>SO`kYzT z6PR7M)Vt#L^nQ(5gjHQ`TcSZ=xr_36LF8VI7TEH3GbXjDe{GYN?;2b3Eh|%Up zj|OmrtLHFr&lzxQu?2>ITKvhwTxc1ihtiNVZX`;`t*eDm351jsQA*vYl$xp}>BTWX zm$uG1bD2Lg&5@j*lxI$U&$HO_pknobX!cki1+SAn>yN;@hL;bsWfp z89i$ex3sQP%jJSM`SU_!a=Vpj!L+Kxj{%WWOuv-yoJU$k2|#Q_7>Gup2-z#$5eR0&_Eh~d*mV2ccbQ{ZOFOR~M zC{_E?C1F2YL+X-kCG%=_wk6zau?YDWPd|gx-j9&>ayy*9?&V8Q+pm zYZk0}Hd?1+q;Q(9L538=l9HfRBph(7H5m>m@*@!^nGQh=s2_`@!JO-e{J+U?^z~7G z_SdFbr(>kdm@=AzI1?{|GKR-eHB>LH8C_K5NU#BEBzKWYF8jC7-k|3G|tgTP*04y>)6I^e?Y7-3J%v-GbjMG zK+Z1KlMRy~9?~>YMcN7W8msq67Y%zz=+KVqy?`5=wh>=(G)1A>S1>wYwaIei!ZBBQ zVSwb7G)4;SRYVNSWH$}0peX3`W-QDu9D5%?{P^{C#?_d&)%7?@5 zlVoH++;hu$%ywR44#(T9X*F^Lja;iW9DZVyxsArD@zSn zCgg3ii>#79eiGqNdUC;%Ed!5hJ4a+F?jshapwv1`1p0IQ z{DY_jJbNoNpe5%;mFuX=D(zOFa+RSD7;un6t@RiECFUNtMmKhOLwna8!YF5_C*}31s4~R=QlTiDkk>KWUvhv3DKid^I5ZCq*%w)qmO<~Vo=xQLeuAW%e8n8-;wD}hA}4^Val6c#FB z>?Q)J?_c*`W)rMd_o0~Q%UPy3e#L}(00fE;J?gu+x8a22Qzl09{p3Toqt*AI@(b+j z|Kj%(Tdl^wu@J3WThfiaMkq26RW-fpJc@U4QP+&UGU!w&@ONyFwHvWJT<;zZvl(HF zrmN>Yyx-;asrCx%_@(Bb`59o+x)%*)$1DEzFS@^>B=-kGqtwFgLH+H#eZBuE?&jCu z(*Ra^;0IsS6Vch8>H&zgnH;R{>eh@dU!TcbGx+n3H{TGon>H?U$X__yylte@ z-=6ops)6qEwoA1Uq5hUXXcT^(|7N`Id{bTaS+z_n{@+q--o^JuOaR{P#&aIS@AIXD zfbG`r8H!lLN}qPm-S|;km$@iVe+{q;%k_0DIRe)8I-P$Vt$23^uh)OI0-nc!Yix7h zZ<2c0dFq=TyXWtBr(kisZN9@0C`+Y*8n;%7 zSQBrZ(TQ(q;r-XpHmd#%uU*kac3Un%+;FhBCQKc}1sI;(27vG8k9T0(q+a1kK{Y#z zp`cP~-3X@+k@6_Fhz&XFVgqC|J&r00lnV-BQKwE4s>FD$G>H6TprmLuWBfGb^r##z z%MOdiQAx49;!7?))41U7wR$ z{--;5m;TD&gsETnbl)6{mkw=x*0#HXZQ^R)%*tA1t9${chs>r5a{3)Kwo&>#=Rvw_ z{k2seZIJ~qxFeL0YRC^G!5VuNT@s-XMH80U8wLir)Y&#~ZDIJH_;-o&+EiX(z4^Db z@`X0|$XVm4_=LwGRHlRXcC~V)`#$ENO>fyTVFTB_%?=lO+sj)D;?{N)|J}#aW9u1C zvab;@z`(hVLExf({BEb>_W7;Y4L!Jie|UY?wJI-eVj5}Wns9q~Y4M38@O%-$fC-#) zL+@2MaTC2gWE7>#-9{jo!eR*YuPbp-xLp~&maf5X`TPsB(>0N(`8pi_mj6*sz0c%) zo2Pglv0v7%&5LOSWT za-DVN6d!X+D-`l}8h)OR*7|h#NkiuEaui}^_WZ}ZBSD43x;)L#7z^GD^JPCD*36O} z$Klyo&v8sXLQH{n_0;B|p99)4tJ>jFW!j)j zvnLRnH;3c%LhGCYzK<4}Mq!7?UzqiwQ zG;v3Sb4mm3UR`;(d?-0;34uY(eD`1AG0s1&T%l{it^P?GHWEHJUWw7M@tGV>YLNr| zb(Ip{+=G8|8Ky~2(LLt0rFrjM33g1frNd<>rWABTDokCKIFKT-oRy7`7n1>) zrtNs;511j{5*lrvoQN)-g4yif?HbRrn40u)LVEA#ji z*oZVSJwW<9-)>Z8SL>q|a=L`E{K5C|#r$lR5{j@G!AEuxM4S7tX2Ug>i*zWu&(*VPptdJrCmv;5vnJ+`YS zFs+Cg7~Hz@#5DV!nd2AniJ#fom7XEp^+A0g;HlXP13+gn)`_BXlqFHa(+^Nh+Q{L4 ztuCB2Tix?p^1HGllZ^EP7lk4`#^4n&l?#Ac(4Cld?vM_IgKrqn2!h-hTJhenNMV8b z5c(3u=~8cn0nzzQk&+eZ!@3J4u^7@b{t!>)GE^@CQvZAvDVbn5OfKqY2XZ-=rP(tf zUZ9gaZ~3E}<`-Vn|IY;=Y?B|mp!NqHT5{zt+hBPAIeBMXvFs%3IeeQ6if{Tg1X5c3hci6eLFw= zJNdEVCVV4BB~il^UG2q<4o@5kUJjYV(8C8yGQFsUlQCYb=NL|`m!6)Apfs@#rpZ^1 z>#lm@CuPmqrN4Nep+`TGWV{75dhPnL=_dULP~@$!54QZ9ljTBol5d{t)n9jwm+kq? z9o+zX!grtMI1G9NtiPGOf~ZT;--u*8BlC4%XkT!X|A`MFzBot1<5v({1}R_PfeM=^ z9)yX4Ze?J+AtenfYI=Z=t^PX*Ue8c`PIw&O&dteOsG2LIk2#+s*@MdWmwuBJWK!eW zp`q?_%RGZao%fP$_rB`2I-s9R=Kt6$V=$Y?8kEIHW96eqEOk%;0`MWBARvp*!h)PH z5hKhoR0YCMkB;0{pDfa8d&47*>@O1MfSaInt@Fv%xT++=*koh40GZP>0Q=+xFy}Zc z_SpL%%PtK)K=iMJ0l*85zsStcfz7@5;K#}ArTowwc-?BRTcaQ2+V1EYa@2?rCdR^y zR6c=QBt3uWqxM@Nw4$5j>pebmNkV|Oa!rEh5w?t58*rV45#j&USu&~_R!`NVjp5`E zPiM1duES0BA4{C9Tr`)tMD9nJTp61Lj1lpG417TdHpwfJ@-OiH3Ps_Wyj7SG;;2bc z#l)25R5-*KUR9u~tw3y;2Bj;7$zh`W9(QO1S1#@>;VjJfk(k5?W^A9KhoP0O++oB5hfUPrLeePv2|-{_t9BIethf@7SM5Dqg(u(Rnpt4-<&>w%yaWe zY`>=TyvziIxKEVT^c?wNNE8jik$Iqk6O#70`~b*K5FCne=co#uNyAs8Bb#T=o@i%B z&m`#nzzb9tU_8rW>FV-2Pna*xzQyZ`I(pA5s}ez%Aj5jAraGonR))(OcnL?knW z2@oZ$kqm5csTdHMn@YXC^^&gOl0h}jIqbiw%tTTQmfB00xNw@D%IdBL^W5JrEoV$ss z%-ig1*--K8z21lJel_}_xXXUC-cRH42crXJ{*qPWLU{hj_BE(Fv>Z#iE(WTmb8ezz ztc3;gBmKTz|6+sG*B3Oo4XlsjP}Opt;Z`xdGO7+#1Xl7AEQ69YwlvK1V9% zk^+mw46sXlG0~uVP&VcXjUjLBE@}tZF3#|B{*M7GB2gy(Q<9!ozv{o90z(z~DPV+5 zFFK3F^A3lBk{&FpVD)~Gl5d7t2ylI(STds^vH28D5B0IZy6MC~XkSP%j*D*svu

    +j4{cTaX@S6dt0=)HvGX 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�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 z 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

    pO&K{Q(vYO?-=}qRr6>D0J>3XAa>Xt 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Ξe!Y}-fv6N`c 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

    vSz>;>Vf&|_e~D&|Q4#qbF#=k` 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

    l-~9 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]+%MQP- zQI(^w&C(&;W`r3|X+a4TK-$gwqs#hQL5YPYiAsWlmD`fT1J4>F-h`$7c4TK^!Ez)TQOTU=?|Gvnfm}IXx3kY zL##uR_f#*oFvgKr*~c|6XFX3az!z*vLSK=FzV*_Hrr`a6*M={}}{9jXr?0|?c3X`+zNZjFni4`%Gz2g3lUJl-C1|(U+}7ZSdRkwytDWVAhZ+_62AG2W_^n?6|qY zTaCenjhF6XMSoEz{!@l;RWo-v2k!2>0^AApOREKml+cM@yPPauP5r~|d&pT7ypwngIPlTE8!&x1vX&DrnWk;2`l~$7>X4;oJWJR((CXs4 zz9Ih~L3R7zJ62!64y1sO8CvwZfoo2PE`jgN9@}_2us8P^H6@lu4x&nHd)&{g8y|81 zOje1X{}25j;k|>I4ca`9kn)Aax7h>qJhfMc)Qd|=I(|DHq9&lk^1&Bfr2Pk$)3o}} zb=m}0pUhj>Ctg)A?;G#jS&0510an(tU4S=g<@nVqr=~+Ci^_$CKZL?@;RRoY{Ib1T z%^0ESUJBZm1%7;@w!i#?F3)~*RG$61*YG%5n;zs&itnM9vAYPe(pQ=T?~Hm@zX;*q zOf9>}*&0LHAHb4(u%*Fu)KN5(T&?a|XjxN_JajP6p(}!TjwT=gY|VYI)7vJhkFy>}E=Id++z$H6PVVn{EHz!OCKuD z`jiiZ*Y=0^#v*eT=(K8#Oyse=a5n7m5%@-V?~xi3MglZRwkB9GV3AFy`i{2-V!*pi zJ2?%7WAJShkur+Q^iHhkd$|62awoc^UAO&GpIW>@&q?Y?C*_%0Z_eJFTQI5?#oXf6 zc$@GHyVsC+q069#q_$vP(cXd#s`nCJf@SoYiZ>GB_Y#x#dYX#9v^UBp;UEIL@9E1; zUNHqy#tr|Sogs8ZUqa@ZtI)IA6grRM>O^6H!FluIXDVFK1!1|i8V)kH-ZSoj&CKC}0M*KPqI$ zKF%0HdqW13H3gDwUB7f{M+s8f`3SiHu8*zPSI$%Cg??YXaisEFY}nltJ}14I=4d%h ze4QMdv{-ob(rZgvCOM;;kMQWdMiFPqxtx%wC3qURKwXfNDUtzl-*A4-4z=B8zc^tHjvx(1mDnt*TEEMM8*5q_6DQvp^B5X9Z4^+uefrs5WxcFAeqw)!Kirx*lwUd?^FqRJx z*B!Vh8KqL>Fhdekp*q%sx!qtN@F!h5XV}Ixu&@^ucDJ(R6?%@1b1AeCZX-NOtA^Ip zEc%kuZSVcY?6;|a64EqQ41o$L+wiKe_tpQs^M2~B#!#madi=+Kioh4GQk$L>?A;dWM zn7O$(YHjLr8pYbbzp~WS|CoA3%QQVG+Q}VL&j%CZ?BZ+bR<^`iQvC zR~q31nhJpiMjEc|z7b*0y`ngb2vX?=MEAfEk!l*2ahc2B70E7BT}6pc9;WJ|JbB}8^hWJogF<_K#MdOxw>NzqLsdaQikyI$-H?gwuD|2Qymjn zKdXG%X!>#7+=vB025$AtO1!IS2a?{f_~Zl%K@1UhWroripRCX~mb>?4PB2MgTtmSDaEzNW3_&D)W{ zVzN;}uhX!>+!(X?jiwEqdRa#mw$#i)b5x;1lERx>r=Ow1(g_nSiob!g9lWYFn`~Wa zdq&%_P4~n?xD5^6mrj)uce9Kcsk4w^j7oRu8RUgs5k2|YO6_*(unXD>ck7Po{@H1v zw;fNzj6%YrSQQ8if3eL2WbQGx; zr(e0#g0x861*hJAd&Sj#s1;a$0`S(jd}@I^a4UnzSd9vALpOM?oT>41s7qgXJpMSD)wb=&kW|+-mw;yZJq!WFYT}(HTx1I;Jzgdfy10#7Pl7 zF!{cq+OelyMmz-t>Sw39$bRV6KhbZ1Wl>9X_2?S+3e>AuBXGdn;k2#6G9ya%Bf+?! zAvZ+1JQx2RA+8{_f-$s93x`X~QxqTCf$DROm+~BIrmd@B9YmK?{acxhwwC>J#3$kCOP#`5%LQ$^5NLmw{=Az97Dju?H@I^d?vJUEJlAF?cev z82G8+gz1cQwK0nkpvjb&$R}o1JVSrHg$qBXc017p63CpkeZ&|l=0!Ia2aSMOVGeV! zu*{(t{iEr*_OV`yf8ybTQIdWe+&q3H#EYOF(w49A>t}w-WUlQeLlAICPqQd$(!gf!-9p(PB@Q#{~aAczyHy1^^_2Wn12SSr0^%^bbxH^+Uj zuoJtw*WYXd4iHpp#4>cp!MT~|YaiosoXap@mXW6d7 z`Pzh-2{4<+_6>ur8i9jXSXFw-)yH9|9YFBPdZZK~2#6k4JS7CJTaMmIMP$6eV#IME-U|~o&h5bA*`>#J)sE#v znm*3ah1rMG=9*?kJ)@EUyucMvTKM&adIwBTmYJZ4Zl&HEagCtMtyUF#g0fPiLR>Uq zCDt~JB8?lmieXv+O(=J2g12LOXQS(*buy>@`PS}QBp-|EE$a2T>W^7Pkh)L+&T$g< zTP^H^GuFDOh<(!o%?E`mgxO$*!_2|)^&V_%Nkp}38Q=gr%5M?OgV{mXt#OTBz`+7H zz@c1Bbs5jg_lmhv*d+zh7TvbBP$iBEHl??|7q{bE$?p6sV@noFs`oDY6e6j4VQS~z zaHDdwmb73Q@7$Zw8(j*+Ij0JB)p(+&6&*uy7S1`1EZfq~@nn=BZ}WG}57Q^WZn5yB z4J-e>$XvxP?SvBD$g%LCEfEdW^5cH8JPb1{-h~LA4a(!&4*W0=E@($7HZTJ=ek4|w z{*i7c4-X&U8dh%j+0iR8$C-xKdh8=224VqGOBMKalo#TONn`4jq|HL$b&yfuoT4U<2{E zjhoz%dVNouquDEX1MFDRWYWWhLQneS79|6(4K2OwHNO)1#17#l89lndnH+t<(d&1@ z^T_3@s%J44mO|IaKRT0uWOa-KL;3o8wkLi>WFya_mvR62%mBk1w*aw`oJoX9-dBSC zQ_hFqbUC^rXP-2t2*V(ihkyuiLpF<5Vq{?M_vUKb!k9TiaK!R^@gJGYQT-`78qqJH zCN?G!CzWX7bc+S&_TN<&{pHh_|Fwi8Aw?lYhvJvc%gTo#S5*5Rx|$-B+le6-tXHg> zbe8AQ$*%dep2)K6p%Y(ErvdnCho6$X?-kX0yo@OGqQGdY`WbI3*1GHDCFImbzDzdQ z%eF*Cx%}pqx(|H1TyPjW4#J(;+{rg1h_+mgP4;Cr8fdjNS4+q0Ilps{k|)UzUkKU_ zkF`Q**Y=-3fz(A?g5JBBt?xM-bn|x)=dk9+oS~HA z(YV6n$7KJIOA^lr4XWo=5J6T8Le*X9RBIfCo825sO}Q!UNv^dVIsbPhn+|azD!$Vq z#g&#dxcQr}{OA`d`e%oiVf)DMBL&MGz_6@;aR!}XPtH+{5HmPRW1!2b!j zO?;oqkw(%bir$}TpEn;gB|$XlM)b<|W^>~L)V!1kXlv>;@8ShCpK<%gbiU2@F6wlJ zT1+TUo`oNg%&qJtHg-h+-zC`>&A{ge<;fu>&YGuy?CzS46`&Cr%oI7U zMqGn=Rr!OZ?{ab6dMP_@(aNb{6MKcyB!I$!X>9@IKFSxr&nh&$&KbH-Jqvv;@d*lw zYjbK9(ahZv4jCb=nhEuz-(k@U_Pnw-N6m=|ALM5sb?Tz12`6~J7P~;@#Y|ZV_1#E> z*-nY!qkJTAm(?)GmrJAuC_o~1n&&rl!M;5u^`Q-E_au#!kmU;g9qn`&;#V)d1tFG>X#Ll!|{03sPc_`b5|`&O84&=~>5bml=0Z4Zg{nxwiYn zTS{_ymkz1*bRJL%*l!cNYimu-opBDn+!+Wwp?z{Lh|pc=7M0swr%d8%8NE>k-qsNQ zkpb^gJPfUubb#yscPgai&c-b>Oh=@XH{&dtaw^Lp6Ni)GO(xPOM9h@};6nx>mZucR3?{T6m+WuaMm=YJyaCX^ZG@OE6s4M}YH{d|8`@lCpfN_{P&<8rs{LUi%`P0+I=Gw1* zJ4>kwfJ1fc4o`|IK;S9cmY+fAa9?+#U|~&7erp;4BgNFtrI&y$_RjI7+GIUWgi^8e zsYP+hn#WWIVRpRo9*PerTo48ISg{|s)VNs>Q|M=$X6{YV2jQdI)+l$Ok`y5&8APT2 zIW=hs!4_B-W8?z2UvooXeLW^6mzQ3cI&04>4z9o&$=IYF7m5=L@gh$h2`3a96AcwT z0zgWb$NasPqnrt?B?n}8uiFu;TzM2uVuRfVad%8JWu@tPq$3OSOnH!e1LC(@V9Fb> z{KzX#aUVs^r(5I%F@PogGe!Sx5E%CZBD-w5L@A0M+fdV%+-3 zeN9``;qx`%3oUKe95RY}_SPxWHvi}0Cr56q#9OkaEXdp#+%l^0wZ?p@I%*KCS;rJE zo9^}3a>+bv?$@Q@X=ucnGwJ9w)nL;e zoG!7^Lne{olA=x7rczTq-HKT_HnGBeGrD~%*z<2{W$GSu}8UU_afzGOy#{%Kwqdt*D9QfqBi(t z*GmYh9Qez4F-#FsRVOLQ{mt3*e~IlE&0)m22@Z4f>xKCD`qh}dl^salp;e>~_-)wT z^B-nvSIT{$`+U28adU@rk_8^S&%FWnIDKKE;?0A+A+K}1#H)I9;lM`vmAU`;d7;PZ z+j;Z@`66#lA-e3v=G(R?3$pfCg{FwM8?m@GI!XfMv1M39Sx9(9a_3tHJ z#yPuuxaaHQ-9`GM75nN@g&l5r+rA2?Z7xWsR2u_rcw!zzGV>$G`qT*r7lFBALtrz~ zUCBD5p^6$XS)U3!)%t;sm?O~&qd zngMJ41}gdj0y593q=W`iOsP6iOLlENZ;^mk=H#H)bQgE@(3Hj7=@3nD57S6&tDi6` zym`1zQvu8+?WCTrT9vA?;r`$=Nr5Hj)r|3o!0OvP+upf}!Nn53HsqhyRWWDx$0a5U z>G&D1y`XCx7DHDfTL|z0@mdaztEXUxZj@L1t$%^LU8Iy~oxU5AbZ6ah(AyU5LE%&Q zK^bIx#6AmqUUSAL>KsyHn|0@(cQ%9+&2(72oZD#nI=dMPCr_a@%V=e(T>h%XMKN%|7L3wCS6?YX7%IKVjbA~-3n>V%T$yQxJ4f6Rl%49` z`#+Liv7z1?-@WaqAgoWeNC+oRK6AzG0Ngni~E1Zq$BrN8@Isjo$^bQI=#~ zE*`Ley~LbED{CNGyq*F*mJGt#qeIUnpUTH-KBc4N0^a_t5+oddrLoP3j4S#O}byw;#I&jl7H` z22b0RA``Z|yj=u8&wJVcDN9jj|Fp`(RkR+)zqqa(BH|r|*GrPyI_#u&?z_!Du$xst ztc2O{z$N#P@OQ;_oA>Ie#eH!uuZVh@JKU{hS&!?j?khwQq(amJ`UC2#--HJ^QGO5f zZO~;$`f7iwKA5fv;FP)H1IJ%|xF5Q&klqWEcU3Ab^H$ZNE@IXYf}4|^ku#i_=BvOm zCg2pPykT4mFGz}?(>n86s{8Tdg_rsX@wb5t?W9#+P$0P7I8K(D%nLmSwxvj}^b4|E zU?weJ3y0>o{)N)B*arq%b}y-JgdZWM)$xrNZ+`8T5IFQWU&hC}I|(_@cSB+hlNcucv^5M6ka>ZP$BxgrBU zECX%)Rr#ReyH^k?6!axj-3K<)6-6O`*?=8oToTz{J4zT8;mcMLUv9%HRuEbszJSclihWEo+^hM-A0I$Z3HS64v6FwaNm8b01 zsFUa89`>RD^<33ZDiOiZ9S)bI+{g>Hjpc<524@0a*Yv(otOb56N~3qoj}rFQ3KyUL z)a+SfxZ)lhFk!tu21l?{X32653Fw16ze=o)i@S@+3{WQ`)=wAwB)F&LlE}&!BX+%?gNQq`G9t_Ya?OeGwMQ*)>z{zaCH}&40oohoONc#ty&v?Lhia zICit|=0E^paA&WcdblhiwlOs~-M99@;?0QdWVe&FQ)J{+BhnyN*knYZBb+1Hjotf} zp*HbGq)2P~1SuN~gOL&guC=V*H+obnA?#3+v}d)vYvI!cgBoLFNb~OIys^GX9z^s( zlVW42Or0&KVbrX}F)*bR_-R6H{cx-@d;d5d6rh5~HPST5FaWYY8Ms`E-?nIk966%nLGG&n;I?gtst?s>s5O2LP;dq(Z|7k{7W++>1 zTdFa_#wV!wcS4zgbc@@!HIy3FX3%GoN}sx8SvYUUX`_sm?APMf%8k%;%@u?@EUzL@ z<%Ab;k@Qdo_>C`2l={vjT!;eR0;=(j>TS$juGu`6lHbnINUmm}jN*cbvY zzdz?FU6&B}b8h~nMgA`9|Invgr#Kc{7H~%5Vr?NT#|r(U2Ob(TDIG`1ARZ^dZclI9 z%w{mLi#)bnTeY#_&LrkxG2K)Zp$g~Mt%1ugtNS0P?y46o?f5@L`*Dq)7m{*OR1cumeJ(xPy!8 zxYM=Q=#O`*gz}Dq&|K&4_h6J8CYp$(MJwq^F=tQ>9uyxg{?ftM>FzCh+E6F1HBF1- zdqyI-lQ1eco%0M3Hx@C`{g@VG@o=0?Uvkf$Jb>*z*i`b@e6~|EPR_?lR%(gy1f&1& zFh3vENE3TS=vz-EYBV@v+I%~{0mw;2hRVvVu7fYHF(oe!dM28fjv5~s2FLaR_=jJ{ zYh1pk^V4ynNiL$#QH_^PFq8_7AwD#}n)~FC$(17S1+i63zy1_&toW2YznwZLzF|%o zceyLhZRd3}I39^=VOHte1ViO1_m1-&Vb#69Y5COlDUUP?9A+MCoA`Y1l|>Y?(bJVl zJ6t|rJ3*zf2i0DEna&OT(X_rDDqm}6nR_uY(%{w;(~vce_yDWA=cr+&Ju?uBT3wqm zx+%wXLwAUhvSKGvC7K`#<(~vu^CdYpvdaMGr@0!;h+8NHDT(jvX?8xkkfE^ge@}dT zZci&K80*9FWiz^wwU0z$2*d`U+#4w0pCkM3mG!c%?Mc`^lm)i8?#}G4>%E;Mc4IJ25&&Np(>xQ$;j1~w zwwsZerB!5>06{ZifHb`QXX4aW0&p=4F>qr~s9p}cd!T=i^=WyUnOvjI|dW1#`2XFV>4mAoS6wrX{6YUopFo4Ufjrwec`*K%s^fs!olu`I{&wYnAgu(4 zBOQTR1F+`nN&S~;4S{I2A#RW?@F{EBK~R?Fb}!m!J);q=bq4b}*#~BXl+HOwjitoH z(b9^0Fb&pKoQhG5I+SBL;yAQ=_~-V-Z>b^@<;Mk@z8lHJhwBolSTV?v9 zIh4wdL@0FUP66u-Ryh_=wz7q_j)uI1!J3iaYFY8A6IzpDG0z1StOzTT-9TIUfgb*) zU#UbHQY3I-{Bt^f=k~gn@*UaleiX$%$_lhld(DXn>hLFaD0whVOiEM?PxRwmp*I~4 zXEo?{I#EA1HgO4jW}Ni|!t4E?b2u7vc4$&0#Z1IXJT&37e4f7#z*b|Cu?(XzKKYC` zLRjgd-8N@;a<3)&|0LDj=wT{?pgn)_jUg7MCcUTf*I#nO@hzmE*O6nm0IKB$z7{X}G=&25%X2=hFCd4eT#@%F7n*ZA zvC_ka18Gzk!S+FiRcs3CLdf?5br8l_^ypD3?yS zuL&nkP+Wu7dM+l)+Gu(m`V4^VbY0_@e5C+<9e>hLSO;@95qrwoY74RI+$gJdAgPPU zrs~TWZ53J}2Dg$L>^<-eY4zR-Yyu{RRiYt3U$P{g|IlyJaCk3W{&c}nVG~(!8pv(} zX`#h=VrmpDc#@AQV~g6FJt3!6Ev1pG{H?OE<2plD_y9<}3!Wj@4VM)ag1A==w%)Bu zV*L+;wzTk?s<`jNIjvU|Qp^EvndqI$qW2>p`!7^u>y;nR!f`*_Ydw<=y8V%ourWrJ zSwL<9`uh?D&1#IJe_YC zI4?)kTnSg%w`&v_hhB@kuw(eC>HMkaW8c0byAhdsw9Fx?+>6<}-B>8Vs3*Ft{}CTw z0lupr_~UC3_}wGeBKZ3agS-=={dv}C_`{6eeX7NCg=Q_;)KBu z;(ylFeo&zu%R!3TvlFuUpp1Ccz&>y0dou!!YfH0=Saz>P?9CHmN4QFM7<~=Y$bSZe-5k>4a09i&v6I z*pz}(o&5KJEJ2jtPRge1 zKrL|}RzCc7&XX&S)+hxJSI3~n>J)1FU_id8m;1XY0uAf=&a%JKSfo$FI1|G}=%xw* z)NKcv|0#nS%he)KlM(xtu1qAipwHd`6I8?3#&;rLKVP_~+6E)^D2ULsB$ZF{P0nVc zRFdTBtkG-#`C3*+yEPKo7OX-i3)O*`gn932xjG&gl(O5W1e94_fQ&t^^Ru>D`iN2Z z`Xx}@*z@C#4SB7e<2@CeKY>=XBSmCjpPb3ZVS;ucZpmn+ts8G=RG%_VU7dhKB}*YUYo zayXu7*AYh{BS+keWu=Cn{S5~7#ZIAy1Yb^aH@ih7*`Y}ft{ilfgy04wQdF#kRei+% zAyaagKL>OCt)V#*jl2XUgf`A1QfAv;!J-GgS#jkhdJ!mG0_qJcengsNX)seB*m5V7mX~kjAxVk8%kC*nu6F8v*xPfbqP!MgA-SiNuX?)U^M?3Q zP1VxD*?pD3|eRt8-OP)=F!DIb~rh{ zY}Dp4=ppT+=YI%MqF(g;3(`a(Lx)%K+h8j!3YxFUdI!P^@9f#0Us*Ex)7_yO)d?b_O5L)`#Z8CCGl~W3bc`V6VV^&!MV9yt7JhVa5MyD)p^mpBsvC z3H_b5pD~yn583>Zjv9R%HO_!LPSLG8wM)AuQYgZ;NI)ci*adVh-;Vl>tzA}3wDSnB zS>X0sjW=?}27mkGDIY%-s-HuLFXaY%`iHgS@Od=syQE5o+ef(MQd1`kUb3jzSfHL- ztMiO>06v5D;V-9o=B=vC>id3Z(N2&*qC$z+#P#w`*uZ@k?6>JTep_c6s(%xH8Jp1# zmg;D*o;bIy?VpNApZ3o+_Pt}-aj!oVGE?3^pje^&Z?1)Odt%TjGxKwi)<>qLtYY&z z+3OJ1yeT44k0#i_VIN$(${bs*I%7TUwNc8p4Qy*x_Te31Y*z5YDY_UW;U8!c#4E6dgp-P2LiO6BwX)C?JkRaw#7!&czSJd$k~f$ zmZ>y3n5-(B)L?}YscsoB@2bq%(_mR|;_A~$HW)-r?T!eAY#fTSHFXxan*eyJtna+-7;OOr!cp)k*`UZ!s;oH}6ZLD0E3-WJTQj;5Yqq zsm7a(s?2cWnC;SO;k)BE!6H7qRS#X9C6YE4&YbEsAg1nh&rQ6hB^jK3xDsR{5cZMX zLUJawtN0106Cwqxdf*>nt9w%Gff;QcnX!`O^3*Uq#paD75~;PoWVi76IIEUC!`=tr zQQ z&qbU5;4>oFj+;L*xV`_^;n4_dR%En8jjq5waBfVVCa*O}qJ=$mDU%_QY-u7tKRGv!dZ>EP>JPVE-2b9RZbY3MDc;LJe=7qRTT2OHHvTB^D+@TIiE;OiR-! z8az-@(k0by!-2gbBX7EipqF6}1A*mKU;AJ&WtkJNcO7QPlna!Eig%?T^g(Rpq|+|p z^9>L|6Sgl}Cxi51A&jc88KlI2uPJHKQKJ2^i;cb+2%C<14@8fUZcSADlJZ9}vPr8G z+uv=Ot-lOMb!Li@z-7=-1^866l zdKiQP8?6nrk>rvJJIfP!o?LF42zPh7NsPw94QFINJJ{j;nimXzxFmz8puD0PqmEzjK&T;GMQX9xEXVX~7?7)hueq-bf zZh(9v4uoi#O2-{Zf|M-KvAg=YJQ09$L)5Z{%zHWTk>uEjs!$rTEvYAOmpP%xDrJ~0&u59*OH*%>CXrD(3MEYxf( zeV!xe+^Ksofb{-R_tJc4UQbSyjV?6i8gPIn=RpV6kd0;h`;4yUO;sE{L7n9dh+YAD zxTDb-t9oExw9W2HyynZ0B^dcP|2(1@-6oa1lrQ|^hB-Mf2km!MAghz#T`kjIc`t!R z*sBg9leS^2vCAgsVVEUMg(U&#nL%MUgBS=)Bhv=8Q1JX0KdmT%>F*m0P|T1`0$>>G z0R@j1F$1KcNVo2l(ZiDnV4o=Z+(!e;D5)G7D`Q~^tz7SfL{s%Cf7JoMvu!>KJFKg_Y_b7?_SikvA@DcZRZ)>WE^`Z@gXzdkUy#vU}%UU~+fgBr9C= zlCdNySk^GyrNkz;G1QJS>NQT78bZ4{XFt=ubHgX)k{XA`7;PMm%uf32t5TDC8L=E6 zNL~^uw#Wu2K`ILUEzXzB7yWwP_#&>0Js4LSr%f;zFX3>)mcbC7X zjFU|8^K80NjH zp0=v4Fa_j`mx`sPpQY$}Tzo1&m8IU4{pin{u{JZ|QGoj5(2dpw{m|U6!1p1w+^IOl zEp`Urs?J;--CS6tyIn)|O7*g#ubvFExQk5ha!9?~}WOGN~@>!!4T`VsLh zeZswRn!?YjnqEx#fy}eg2NV%|6|i;0*I8`B@qvH;jis(iPt`}aimD z?zssitrI4w{1k5^fo+keIqXbE@w5s^Bi=I>Z;c6;p*zFBz5l}e%mzc3VRVE$X7!{v z*mW?YF-Gk(;yHgKP{qww{fGJFAwo*ibL~+mo7_>9yu-35yA;`ce7i`DcBzepraZWQ zIh|RGr1ZWUlHX))%3qnpVfbL|=hm>Pw>e8Ln{Un}2Ms&*RHgq(nkPetYHeC}J)c_V z;txIrf;442`ngB+bUeD@@A{tDrbYE7Y_)c z!7z{d{KQRt!Gn<#a#lLZt@|-h5~f<+E6$;lNDZQLC56kS8h?m90E z#SxCbV$9EMGn~d(w}}CASE=+7of1P8f6|O+UMkl+cb>+7uM+mzI+MMXRDB- z?&N?Lx$&-YYi*QS`;LYavddwRNZ6-?vClWE=zYsU!`)^7-h+)%YOYZ}o;!%#m7A+r z0vrbVv&X2ZCd|6M785j#tLgZjj^k#oZ%I~ynxl;=Un`VFd>86_gR(!1wyPV*lqh~v zrTS_q>8lU>J1u>r_>D;v8*c!JLXpTGv<_I-+obsIoja=n0K4SJ4RHNUe&6bmD*2P{ ze$y>q)*LC3#C1mH&M96h|4Fjs>ar2}-tH+(X&l59BpKy49XlTI4d4@y)wZSa!Hi67 zBFj8Qns5SEmirqT1Mpi~^n@I09E%cKr98qdmbw9P=!brG1RUCqW-eoT6(kO(cKgUC z8KZ0{#9#qRl?&fWciCc?*~KLZP-tQrjNdbjXF0!%Mz~nU>}vv z^rMmB-S>7Bh~`eA+*2Q4fVG50nEc}^Z;EI!n>9C?t_K5^$%UJCI$O0V#1NoQi~jh* zaFZ7}7K#6^T_-puNRBw6$U_{M0p26(|BAm=dL&p4UUK>%xGh@=pFJ^O<6vI5$Hc6j zB+5lr&v#%t*6L0#R2om}xnnFJTMpYOJr@U)N%2UX*7J}k?3bF!`wj8b?2R=YwXdTe zI}#An%RB-cFe#<{7e^oF9786ImBzKHzUE5gO4I3h65iBEO|0m1*c0hYg5tl6BjgS~ z%0VC1P~Jv3qw2aAS?i9aPC11vd-?qx0XS*MnQI06qdp!rZiodNaMJ;JKIWW*SSIA7 z(n)V=k!O*x$G7rmldxk5$^?gHvtdT!vL~&5kpM_5N8+qjFIFu%h;;MGkMT}Ej8Dpn zGel~RF(@q}ibC>@Sm14J6O|#*JJs=YlKWo{Qdu;|oJ_nHu1jg&vAzrsUcyheCw7vE z>X(8s!{Bu65AjsXJ>PfyX5)`+o9Lt*UX-?$!s+t705a>^;;=_`Xj+?!4LsYdA zfVcdr^?QhkS^bwyt~f!>uemDx>XB?U+l-$n=4ss6>o81 zOcP8FxJh}(44WwcHHfis*GSaPKGAe7MeH+7s*5I`&SziZfFdoo`pJ+JrN$`T=pYELHb8EnL;@|PI=zjHq9AWk6XA>~A+Z)XM$>U6&a)kvEQy8~A696Og*(tGu3K6|s zwOawU=~E+X=4tyw3B9b6-eq`!va7~06|~x3+wYPLl3+4l|Mf_xkfApBZpeN?DQ#5xZ zY}$y<3oiAiy*WoC{9H|gIV(r+I3oh3qURy0f6_S8J}9LAuSYcy{v_^D7-X*y?W0cr zb}+61!TaCN6g>Bz;}Kw2CBi%VCKr}xj+G96JzgX>VFR$Wao9p8OjMx1H*AQo4%#(5lTh58rT&526J)GpAzg&VCTr z`g;|^8XUiXU!@84csWnFc9=jk*0ZY8*Ex78VuL{r5u1CY5zlsv5? zIcsS(({8?OfhB->*FlJ^Ims*en(gcvvho^4$?Lwba z#q)n?8V0toV$=&!-r4n0CqP)Y&;5}RQ5U#y2l6bHvS`FHuqsPf%2(U>E1wwah}W$l zTjf>L*l(xp8=N7mepM<#3!+sWhipHtm=FbC2$WvV$cpKJqK6^<_vuxzv*`05WYaCo zV6n<3R-LnR>o5_iM!iUqeuX&0tph@3J`hU!K&s>LZRL$Gdemg?lqCJrnJChA7 z?;b>3<4Ls36p4(FJn+d3!=(hIV9-Exw`y0ZhB^oPmkl1`AvnHHZL)d zt#r7C63yD)-K0Val!O&ppAZXMGy|h8mj>isP3FrOD3m zTPt;!JRU#bj(!~C@!zm_SV5g77TaWlDRC(K{R&ui?uOn&;1Y_^by=sCl+*g-t#Kk^ zV(f<2u%2xWnm-90ad;7BIbMp`C1ruB73x;Hs9(>oU9+1k+I zyWaYW8-slD%jtZ{pqwu1NuPueM*#uf0ext@-;Y>u4m4utdQt-C(&9%HYmZt)7IP>rGE%Fm;ew%GKN9 zNlMmdkS63c0f3_viob}89??s;RvUYAX)CJb^|yD#oFOG8%(pyP?axeZI2)znaP?BE zxcdI%%WxqtdtT(=BJXGM37?pH?imCKt}|7K$Ol1HOtOKwK3l|AZ5IWlrr{C zv$IeMV7?u$0$aYI8kt1{%3acS%Me3mTwM&hBg|8p&sSWe$3!>)XOH)AE?d4v+KE#U znJ4__KgyEb0$C}gN~^Qn37#Lm5ogRz-DPu{i7cJ=1((lTW0UNi2}=E_ZH54F7t zK`?xv>DVvzh=F)}N_&BsEVk3%Tk-qK`7vV5wM)nK+2HirnJ^E-CiF>YAJEGO+EOvp z!j-r{1=9saFKvUWO%K@Wk-MCvuiZA+(#Vs*`4pdcAYIpRrJtX#!_S@Df25~srA3hc z{P~aT&&EvCL(7MRM%|>#%EEwmzK!}y?LG4NTrnOFY9=j*>UJ6cX&*7u%&I%6VBuwJ z_)m!4<8P;J+xR53mIfc3=XfPD26hd+1Q>0HX>AzSQfVB^sRBhJUr;^j8@ny3 zLd{|zNKtbRtkNU+2cSngLGQ=ugmcNSuh;s@D@>cs9esY{a-sHbcW^b4cw0-TEcfQ& zO=~onISPi_@wM_>Dr)mLcq@0S9_j1H4>c+oKzWF_ZR|uDX;|!_fY1=ttYB)kMxP|6 z^W12{#i;-vZJ-~UEM`sOu4#=m8Q8F<#^I&IDL_zd^X=j0>1}X6e2v5CuZ`Kh&N9zr zFT)P2tW3QfMIKqw`UVHr?Qk~a|NF!ZwOeD}amNlgNz^tNBJ&O5eS|&IRs1fn0LYsh(&SV(iFL4L3GZc=hv*sD6A- za{DsOdz-GLRgdubQ8_+p{DTZ-p{5HhN^qes)z0gB-%XKuMx!XfGk#g9ovb@B*g5n9 z6}XjxAzlj%rIj1z4h(nc_tgN=I+-}YK^fgw)Bla)$_{=?#P&Qni56%sntPT7@fPbr zj4)623|a0%JiClv`Y-^pnq4`~=p_V!h!o(QNG0LK@B_8NY=l zy1A0Oz`G5C@y4cfhTRKh{J7*B%&5Fh6Uha$zS=Kc0g|pT#;W|mIJPUcx6rHN10NfC zn-t7SvlXark0R;2V+?;o4T#{kjO7tf*_U(n7Nk`}%S)Z6wX3tLWP;*=9wWY_==)Wi z2}gLLdfI=gtCaSEO5~tdzET?8!(VC3h?c$?|43b7(<ku%o!kv^w+wfUFng<6eYW*19D40xTa|Y6_1#XdXICf~&T48Nz3_;P&R{;Xhf&$T#TNF9p#Vkh#k^y7qS@KbY2&`!yl}5*+ z^+*g+PfO!u_(43zz9^5sXtm<|lT}()+5kU3$0a>qqH;hiLNqeeh~M@0%G% zIC7ngw&(1t5Ew19*P+qMW^XoX^I1h#S?k!EnIo*+qcvP#^vbBxu+bPU^&5yMmr*{n zsxyzOe|C{ChowBT9GG~<|5nmKx*+lj&sQwl`P+Re7d5HX_?FN_>Zsd%*uk>Ruv>4H ztPzInbKu~V(1sU-*9W*%;AAm*a8^S7u-RlGBQhc3U<_`B;^GI!2L)#>G78INSEDar zJvVg`VSglVawNIk5Rch*P*mrhXI|w#y4>f+nY}HF14eA`IE6{(-d(+@0StN9#SWNe zj?x*yk}^$H91rhcw+z5$>^aUq^^Mk->ufZv9XR@eKLTxrYaykgsI{H6h(o>S zV(usm{XU(DS_%FFIi*iC0hoi-mZ?d8PImC2@xai$%a)p(^8=vF6{?sr=44U7HsNVc zaz_dt%bN{H-+I(aUY0YBs|$Tk3%DQ5#sC^351HUzV`SpuAqjNQuEIr}QZ2X?cW2&= zE-68wj-i&rY@5&HKNyOm1A*c#D1G2RTXDA#GrRC$#rB>am&~Wdx9Mh!UwDjgFO_*DHf*K{G)KE$q@%2EDq`j$z6E+&<0$$& zfxO#P&(CON9AEx-rC*G9W#fj4;CvP5oX4zw>-L>VEqr&!>_*e&aL0v_TMGv@p_}=v&@H!Vu*@Bh3XRK z?GL#>pQzPErI)v_wegdMgPhx6l{&7LyuVM zEsv(JaEVpf1^3u4nfTO#Rj>I~f9a%H?~gj%)(TTv^rn$$Q8Fe{cXQA{l;a=$y~vX4 zZa)w}UiMV{@XuXoA>^H*Xi~TwO{pS`&d6fa^2TrBGR4tlC3I;Gi(OOP7*AEN zaKA6117Z0`|8};myP5czbV@Q)w9}I5+1KS*aGJ4|_E+sK^lYTnYm^qJwPedMMmlaHbxAw^xqS*y zzj9Ns%AL3aB%f{R(;hFj32vMYhRp!$&YF@cw>ot zC#G`s;QDsjneU7+15dRH0b&IP_%ZB+DD0OAxv|=G>^#Z2ucsAye&Fsrd> zfh4(`N9d5y!!F7^aj-w~;9w;0V_MW#+d(t+ue}kyolTTvDYO-et@NakHk4q*5KZHqNYdjuQ~&w2rXdOO1F2DJK5e6=^x(E zgjAUFIQGuvPB@YGUYyav>W1yEW2P>5@=e&rHWnJ){sspX{2qjg->CLwLy%p<$j^-> zW3HKrhlwKPi}_m2?m5Z;IY7q0W`k3gt^1`b00OViN*y0?MnG{C{}q0Y4xX0zzK0tc zy77#*tTzUoCAt&z2PO9$Ur;;jr^9(_B~Rpgxcv^&@QRZWopK~8dlaY}XQU*NMXm*@ zCH{=Jj_MyhCi?=hUw_IMjq|AijC7L6)n z4X&q9&TIQn+Ats0#1VJG!`=cp)P5iU+wo$UtiRQ+k_y@Q`>dnD$Gr7aFJ7np3IAoR z=kn!%-c0Ug6FwanegUaS3zXPiT+mqvD%w+lRb{uM6M1}VF}IOrZn~epu@|JNGU_n- zf<{X*5hHDM76~1;)?>C6H{hEb3ndd*V-)4D007!Y(S#r8-X~+fo~rKLMk3q(*{7=- zpApq%-O%Y(9sK@?N5u4JnlRmraAX4mL3vNy1&WO)IpjWp4mB69$VQJ2{PTcUyn2Sj zzAKPWGlWip^vjD%3J5A%x-F%k6y(mOG1|ZPuVmuULAbbe=)Q5J#f9F)oMx89UV5>c zsB~rFB~Ng2IpTGFOkPY!#QRJS1ftp7oH4xARu-aDIfwlAsbmRJu*@nfaGXsNGuHOj zfO!QpG+HTe;)>%-O*_Zm(AOIc$F4T0WnpM}Mm2rzP7njV*JUlioIT@6+Lrr2G*(F1 z2sr#dy#9J%)KG|De`y-olV7-jxTs%EMz*MTJ8d_FNpRo`uPV-ipkS@dQCWY&VJlA= zv)q5ow7Elm^U*)XHxe&Ewr5h#x;a@qMxGePlPMS`3{4DCL+9PnppwHCAvZ30>Wme- zN+aqeBjQj&?fQxgMzl1;yezpY!Pe(}`qT){#l`&MWY%BKtF`BS8T%G5mJT$*0Vi;5 zb2wK~fT&n>ca&k%Gr>`%oxx`5-$07CVSYoEMRk31ag8HM`k6Dwcs6+$19IxQW#+q@ z1Gx08oRLCSElxBykLn6)#q`YED0e*F$(r=^8Rz;u*$J1}d01bx|6?JpUKZuw?+gJmOno@*zqGNCZKQsIjBo7{)8)z`r?mTsXp20FlSbEa>CNNtDq zG@g}a@ev#q&?bnVVw;N}36b9j?5bC8RaNGl-L^JTxtp+lTiEqSSVAx z4Zeb6%9(hWtT*L_bG*hx$!V*L<%Xj&&!kQNgO|nx&9JQZ*Ha&BzbdbGqt_Fz4rz+9GUv>*=r~KN_a~guTwX)gz4=_JfR?tY$-HeRf#0j4do~~hLIsxdYJ_${*{SeB)nBd^%Z~gH``;y^jjt2-V~Dw*#owz*A3hk zz_mhgA8kH3f7`z5OzgKO0-MQ*S<Ivx-b#>|>v8j80{BO7++tLyWY|)S<5cYZi*rbo36vH+2aAEnwXxKYG!*N&kS z{*D~qVKTFbBx%DNL1s!}&Z{sDarM4;!F9$LzfcTmbxDpRpLBe=nXMwVS3l(PILLjN z?QZ(TxfWV|mlG0_8`<5J8n8LY7DF%hFvNdFK~q6#t|zT5Q9EE3wWLQdxO(B>cdzs? zJksinqor8PqJknt_AP|HnH_!m)cB&1-t}D0Noa1^?Qk>s*VMie5)J!=e(ub86Y<(I zV*AFElF7HN;AOdB*5&8^M`>Sk*uorS>%01Q^TrnwbI5p%Z@fNli5Ma5eoHYi^ z2xyVpwr;O>HGNz9E8qFo;TLWdGC4&lsFza73^ig(XUcpe4)aH9&I|Z6Mx2 zwx-BUtzl~TSuwFOs?G=Qc{EJ%^JC<{!vW{H_) zF4J&1w)t=2!iy-=PCKgnY>Z-8lVg}MT<-6JSY(M<7f9~epIw;KrDwz{qK(Z7L z#WGQH-hQ+7ly5*WNMCl%5kI(V@MIs@W^r|W#xtrZ%`V>SH3FM5f%-K&1jbe9q9%diaPJ;cgt~Am~3qzrp`6TR7@_tU7 zUW8N5wj0-<(`0Tv03l(0P+i) z{qbpY_e<<>r)-~ZV{>uBvvqoq+%FlEiO*LKycFoX{AEAMg;!PCljZ2S@cKsmGv@xN z!8NPhoO6;DOfY58!stlqdM#|&WrI{FV-{13S=v#Em#hN|Jp4eIwiJ=gGc?MZwJ@=D zHG)F`t5|IVZL=e;#D968ogg1?`9kOJ>4{xHbKu4((%69okhyCv@dmBy9fLD7l?I6K zxQ-NVlBPe{oJB;0j6TU%65jJA5KT^^F^L8;EnjI=VyAXmVvTj^X=ZAP0;{^Api>!L zdWxPd)qcRp-cz0uE&@|#cP8f(0!J5+(MnL1RQC6B`6@miSx;F%FS|5HuQ8X52=*55 zg@#;>WkvvV&BErhtRzSJ>w{IR|7#2oBZJ)j)Uiy}=7;lOp0-1@8X0Pia5BpU(WB1c zeUK)_>2`O2$RNG7pV`zTk^oi#da)d0{*46fYly_}sClK$Omn*K2~aL5NR65qmP$Cr zZ|^$7gT;M|@#Mv4Ri@5LzCam7?$@+kvt5EZswG9SbN%K|2)=%@V5ZXcyn{%Rt<5#C zs}DFS5icPMo=>OQ*LF%mC==~E)e~5OU`h?@X^aCgK{HE%=)Q83WoSzjtc~BIr0Wlypz+iU0|q%JN-O=i&}Ks zvn9-c(&~|FHmW}|6|(JU%jDqIS*h|b?pHifve-yk0`zv6U+VKI_B-KT6aj z_Mcr6K-VPDSJ*>RT0udZ>qYs82j2(0njL~c z3=Q6e%gW4|vWh3sCRo%lN3xat$``RAUca?(@8H8wrUi2v8Lhn88v#f*2Xji zNeI*Q)pE&1(mcy!NEK_?6B30}V+r(1+!d=b8NJ71tN$xZdMIE*_`)N~2 zvkrFGq_Wib^5(o$UI%*#lHnW>ZKQ2<#l_)nZBZ|(6eqDHdxJ| zuezoWZ+T(CY&vkixCX&mr2i|PP9XFskfwA;(cNXpXTSM!zbhbU+hdw0$vcDgY-iG< z1jdg{U2NL_;=87i!jYFd)Te~Zud6A7DXL^a20JB|rjaT@+p6t7X#XH1qx3Ij z89UAOt|Ers?$Ak0Zr=58&C*NAhN8^lZ&4q8OG@ybcdDIe)*B^WG5DxI!Pi1)&v-TesdS zYFB0#2-=q>y;FBzEpHH&FIwdU1Mg>lbbheAQ7*CX9qq3=v00UICu>RWJr*2Vd*o*B zz#EfKX}_yPhM-`saSTyWzgp6mC4>%r;mfa=z3zenlnJ}riMn-(-b}wehlL7Qo`OcU zH(=^ODNq4FgUwb?U0dM^vpuud06ehTXW`mSa^6F zETn_P`Z59u5zINJVzozr9)sZP0B^a@be;jN-K>ySW{gaMt6a~|(yxn$XS@(5iBbjR zRrJwa!3%CiL`?GA&AGC)y+QPcgj=5bUBUGd$SY}tf2~{UX^PMN-8CUnAjPSX;ouW= z1UaSJ>d=lqH^aZ@rS~&tC+itxWcg>UEA17lvC)rYld}7R@oGjoUwd$G{Eh&*PgJI{@1jHoGtPu^QMj8S7CHfcFH3EHFdYR zuSO9N;0usajy%H!1LRzPLGi|K zak{MQkX;bd6Y{&)QEjXW{#}~VBkxCNew02C>W|ggIOG-{*>bC_0kIvgEVjQZEGiB9 z=A^;f+bNw!JFQBLZ8S}Ywys^GvmT=nO(BBF1rcMpfrJQZN8x#i@x>jn^+47-sO=C#CySqPRR_Z9KUIvdW zOGxPb|FS4+Yc+E&8=bY(()BFmvd)=K=K9I;b0K+=M+DS^M@4czQF#?+JnXjU1Xio3 z87M|6Y^FK9rg07j=p%HvtJK7j)*b>Jw>=RQg!pY9I!5F*fL{=r;|8NhdPT{gt?jqp za?p0PR4S8luZKJj+Y@j#&c4n4*c8klNVDEcOQ7gnR70Ck z*4JV^5|sq9xI@v_fH~O}P37e;p{y;RIy|@_#a6uq@J}Kwo~SVIcshk20YX&jLKyaq zuFCdu;%#vjs~@DWvLq>SSVR@tOT6B2!kL-C^bhwig~0AcmEy_fsMh#GXpx<1=KPpi ze4_(2JX;0fS7?stlD%XO6Snj^kKC$c2R`Qex&IzBOVlI&+U5MJwZ6_ zI<-k$R>C*+-^y@W6eYK;2`(13PCK-(4#M`37L+P1)Wp@=7xD?kj4fFzo~{+K^S8PY zW(T$ zPql(|S5?;SL#k?YbF3Ryn|ytP`YNQ#_|Z^#e{L^F4SXqGom0s8zho{$5C>sEjLs<` zTIx2G1P}@{-K#<&p_HC#|H>)WOAs8m&^X=JqB`ROm`tMlUWMfxJf6LGwxGfAMT6GU zMNe}zNFb6c6i$yiG~JsQ-+V4UzQzec0Dff4+;C~Sj_%!bz-CcX)2E%&AgC17D^fKm zzGk9@D>SchZXK_h!6_fNd94u}wgYBSFN%DgI7H{PvJ%d%HHNK83E5{Okj~^YH#UwI z6yvz~%$nRi+Bjpq?e~sM48!&w^LLJX!dpK&c;b{%nl9VmAF9*}uZuX}&ZhXtj7kipv7!|TbM3`aJQCS@Dyn>64 zT}^m_^HUtAvR#%pG-?(dY`qo2hR#yKr>VeiS`T^pNixahWdP=Wa@P$BU0vmj0kjwr zvvIp|-1(B(sHxID-nWI-YZDJkhb|;Hfc|q-Y@0JLV(a9#G`{mT-B-{8Q`gkj_eLHm zj2I_g|A8rOI~hPk-1EnC3o0r{|O@gH?l~)f}gY?f=FPR zMg$zpBl-nrCv3ii`NY(<%&kpRgrRb~AEm&Xn$O0~D3@NFeqqJK-fLuHnK zRgxUZP5h+vswM|FnpZ(t2a|)4fpQXP1c(hDHa!d=ulHDZcTe^PjrN>v_kn)pb zB7k#aX;g}t^WZ5_vl2;){#y&stl&HRgZ7DqA$QU2vPm<1-?Z;s5RvdMza%dzAbS+tQHIS&SQ<4Ko$z9-2Z$8_AGs?P+!lmg*0P>B<+$TQp=x>G2x~dFfpEh& zn^>D$7ojy{&nL!G?z79{67tqOjlMS}>f)B>PK42rE8FBu6A(Z9ep{Hd{{ZR#=`xIE zF?mv(ce)aY&R8)3X+ls4n`P@%(HUhqeu?W?;!bh6OF~1RgAg>Ze#A%AT&RxU`U>%S zUXgF%&3zzz8qzIsPK7L{ErFn9r-ihJjgGLx58;h4W14k)zT@6qyIBYWnj#uGx>`p- zWS=D|zAFW{C_vpbSYS-LY?8%HRvyBb7`%jU$^JpfR-GxD0yy5Krs(>1qacZ~Wc;N@ ze+m>UBW6@V0RStS&Yp7`g0Q-`Z0wSl8TCo*W@+7DItd37A5Uk>t7FFNmhV{N)Asn% zG`@7By25P$DD&li%^J~h545vwl3Q-?lMjC??RIs9b;X}__jdejHsEzE2UvhuUtu2~ z22|16fA7Eq`nO80W1uJ>zH`igOV|Oom6P4-bnL5bN8kELmU5=gR4m*T?kK+^woK3v z=V)@Xdw6RJPajLP&Kib<<3`Ib3Vd7J*O?s;=?2bp`j~G+R=&t#JE~wcbu9TpF=NrQ zDRstDSX3V5!nJW1&qCLkya)MG?8DW#iH`e0OKDB3Z;3M-70Lc^dNiF1VHa=NJVqhg zwF-EdMCjAVcjsXZi`MfjKA3SlcrSuvNk7pQ*x0t=2!fQEO-KR+Yf=aIB|uodAD3Wd zA1cdIv}Loh9lPLjf@}*>m_b%aP;k{2Wp{ZY^{go9eKA?x%j$-vd^2z zbyMbr<^Ytbo{jD38)L2SOQyv7r+ofxPew1MfRw$Nh$wgae%2mPmA7M-R9(@3v+kus znijEX-jfv(Q@`&!k@|nry!HvboyamFc3l8Rij%EtKfC>*;GDefN*u`)bzpmLrbA+E zB5iuj&2SuI{BIGY1=p_~e`@NmY-nE;-HtrEb_pAVVXw%R>m`(kfhV;^4h;O>Huw1O7&S%M?xRqLbRCm(%q|t8F3}PZ#8xaY4=Y0vA@9YR31xat z!*{m1r@jKe(^vLBcXPsbbB5FK0GN)@7uu41&+zLoKg)y;Oi1v85{ zEET6mw$}CxKsb!o^#<^ygJtyWnW5$E6enn@OW7VYR|@J~>Q?mGE&A-l0f_2Vt=&hw zjPok%Ws0qhlwEfX_kCu5GBc4?`Kt}M^-#KP9k4L0y3HrCQFB|g{l{FWfb}k`AQ<(M zVbWr6q)!$u6!f(K*%1XPJoBEY`ZUynq~iGU>X|!7d3a613f|H1@Pe_teIqezr^)Wz zX^{x4?skzKs`$ed+M-`hyD~V`@tYz!Vds==C&3UwRM1n*YBQ7#$uTzC_%1w|Ww}l^ z39ECeuTU>H2Z>*;cw*?xz$jnh{#v&yT;ibq;Ko800^Q{uKL}pH?7T>gkiPNY&W|LA zQV+4GM)Z7XdMp&o-q7?^{NOAPv@xhD!?&Y&!l=bZa5VUJdlvG~{#*58zvmXZM-<_+ ziX7?sx%%$Axr7L!3SHV6$On6UYoX8C9F{C*-<=3X$sbrF_`1eI4?^^so_Ek+VKaxQ z-UI?y?Wn4iOx`AGy(<3yfATIHD?6|{`7>Hs3N@fm@YG8XuCMIOzFV|Pp8c2A)kq~L z)#(T-5NFco*?&>2|Ab3XDpT-pui2fUs!TzX6Fo8V7O-GJZ-pJi3o3*9vx80x)E0PK zC%X71Gtz__+_;bOfZC@*CTJth#(N0w+y6{-{{Ghn^B3jI;otcDCEola!Pgo3qg&7} zcB^zrOa89pXmj0=Nkn|MrF&00dk?$9%^eP7!rQLu8thx!)vWDhOy}BiWbOoog)o~4 zcZWPd#3;pdi5y4dLo!< zJkN!hO~pOXuGBh?5M^=cEX+X*wTxobR@~-lqub(qo{H{2hmoYnV*t-kG+rYy9x8!- z^jvZgv|nMlMoFJOmbmog%Ow>lo!HE3bNkadqrnKdk=dc=6&ZE<)v(ROwy)-B?*E}F zdkiQM%;tkuXPsXO)vbvfZMN{Y5&2si<9OiO z3|HvR&m)yn4z49J3|{%xb1@k4kF~sm1iE@mQ(*Y|(EKrlaxUpa zri71MDsqGkbt=$r6|0{!8i>KjtLtr7VA!5PRP4@%v#@qLXK>t4PhL)}((9Y+bqpw} z{;XFdV*~3NPG?CdFb`q_5?Xug+f~*9|RP-q-^WetsY8MLsH8V>%3Lkwq+&!JR9h9UNti-e<>dy|e-C(!S z23K6wquJ(Qi<7ba*I1AIy9Q`Cu8j*aGbO|r=jmqjLD|jEl0B_9ajKlkuvO-{sLMpa zh>i7BL;NsTnGW2cOA>epFR8XFaF>YSBRZ*N(y<4&=?W84bw#*KUsg}JviI}YpiIDw zNGmcKx>*idIt9PF>zpfONl5vnsHRdXz43& zUjhC9yV>w5Q+6A>XtKS?_eh}DOUv_WXM+n$grESqFn;vsHw;|^W(miTH|5$bW@&0w zoRAGa%oeS5y`sL&9PX=b{)u0>o9oA0Uv-v?YOU>!tAJybC6IHu@+pyc2SbCip^!da z<(KLBxf7gzuw0bQ(-K)e*(IaSv}13wB`CNC0|MHbwOweI?2zCP)|2izg(FA7 z@>)6vldnr+vBh;cYC6F(!2P^p3jBAc>@dPVjS1{C5#;+d9nbg3?&)h}eN3*){*XsW zAkt46SID8S$Hp%1C|UXrcOqc@r$V%?B*t369FY{7xKY@$(HPSOpWXs z1+$hW#+q%nkYfotB*Q-!_02JMK? z9}V>{8fjnp5LYdH14(uM?o<-RZkcKFoPMZOu9obv)9r(eyr1WDOuA3ITmOdLMt%H$ zQz}~D1?6FL^m_sqJ!ay_!*0LI&Ci4+TieV*>*8;CX$*#|yz2;80HSI|x5f?2hT4VLr=uiLjT+572OZN_zz~j%Lv4C4vB*))fnfm5`Tqpeh zWDnd0-UxhOzNvdv2?qDVmYQ;6VP2gI#U=cvM3uvn1L<1tl`z3$_0KQavSW9do8uU&00<*GgY+ zIE1290jgHlukPFSFxfh^Xvj{3;R43cL)*6S65#{z$9>ENW*NG6Yt(!b+2;@13{bY$ z3HgvSk)Kw5n@YyI>|3d{;TQDbV1#8tZYgJPV-3iD0TR#mSwl_I7uy$W5C55FjlyVT zIp?6A{Y?v{u!c1YzxGD0!_-5Sc5OKt6ro?C@%|zb)S{4u4vH6%EDrN?N!!cKOQYXT z*w$v)<+1H)EoU6WoHaTi7>;1(IfUAol!li42-r-Hj-IVP^ z)wU~(h*95Z<`chmU|||P0z}r|2sh$ z+$`I(goCO`5A%bJ3fy*CY(M$Pfs6juL8~F29Z`DjaXY$vudEBnckj*tMeU60ru#^!osR` zHdWDtk=#$%@cE|Q#4R{qlm4;DASA3Bt9(W^gjORALU`*kMwQ!NyX+Bdl20^uslRvcQWI$J zz&Eu6?WgwYk@py7#~763gIeeavJ?Q*%}?P}Vnol+$O6yNQO>TUM8MTfEKoLotWQLh zY)$}uHc4l^9Xn1)L?oLF=oy45lP?lqaA$AkgrrXrwVzJwZ~pIg@M=)&J*2`%e-V)| zgWt{6S+ZQ!RgOy7m!SN*_|4JggZ!gi0|RBz9+GmWJnsL$?tbt8eV(=Cg{bsJe|KmBt`B9(_#5dRBAhQa+VKAdM^<((XIcLLHGk>x{nt-(|5f<^6QHZFwSTw&61c*`|M#=8 zwv{&7dR*M)zx8LZwuk;I|Cd8%{I;Lk+V#ITnFIFXFE%$1wqMAn@|zov{@efh55(R0 z|Jt0(yRLsV&GY~IH}CM(`l7<`um5}hzEZE6n<^EorZF}Zx&An58Q1^zNB<`IuK2QZ zZe4CO|LdyjI{e4}*Z-40pH=YR_1WON|NkZ*a?bt#kH2BC-PwxIS6G;rO%2XYj}DmE zSI^j&&(6&lPXA3D(w(rIn;)NlGVSF1FV>-^78cj;KQa!m9#H-~Iy_-HIAUX8WW@Z$ zZpMCoZ25cST=W0Ofm8QijX#HMM&SP0>G=0MEt~ws;O&U}i1NXL|26jQ|BMIcOU&jT zOn()+xZ1+_*@wX-|M+>I}HAV>5KawZXFHnKc<5QABQK0j7O)-M(pNCOymE?8g0fA z{#Oo9&Q6&B&$qaV|C6KlZ%zl9O?((I99e!gHev8d`N4y~al-f;pD>>>F`SzpGI4+Z zcV-jEPk+rH+&g3NKK@Z>F^B97?2SKDe}5h`gQIf@znVYT4i3+_Kf=D%nS6A>) z?)-qQ6(_3hwf}WqVPDVkwV#Jhp*2u7vME7=ND`r7g=&!$E66jUbA4#vmjl1Q(w$** z&)c(8``ieIkc?C&RS5x}4oK>L*>VWgi2jrQi!?R8vt7z(wii02i^c#^;qnFyBn1!^ zB#@|UW*|?R?A&`_@7J-}c~%M?6oJMNX$6%GEDMB$r>$|VX!jVeGPY|q=eGmZ+voXM zhY{x?2c-jyN;^oaBOxe5B&$#YIYakP_|M#hl|+*t)?iVH#E6l#)5hhVLJ3g#*TD3C z&N}>^i{)^nR!U$M)Or*$31@Uxstq7W2ss+*9?fZ_fGCw&gM=j1gOLK&Yv>4;1`b)J z0+;LTwZ8lQC|U(IwejMtpj4=IkP6u^rR7L(T4u?-+J%Vdr<{6_(kkSpz(5!BI$os3 zwBZ5{01x8*SZ9wVcXGI;;p9vPni!`oIYO36C}jc$cI7#WK@a^De`~kw+mEf}JLZFA ztkMw`RUD*fqe<$!sd6V9Z~q;0uKL(5OT6r9UkhZEU^7HX9Ux3Q!gZ7la*|=W!eB9ujhE4?T1J&o&P-5jLXn?rV}Y%(4?wOzW6}ZW-mQBs6x@ z%&&Z5fWf;rgt00{IWm~dPFkm0rWuNucK_$iGizF3Ego**VEOAa5@m<(u(pgN=;0A^ zI=h{_|`|8esfZ}|DR+3eia-*oC_A4}@z zq@R0Bb$h_7v|q*%)<-pD>$ZNaKh%+Y`RCq`Kw5QvxVhi2OZH1DDYKWm;3!}6dHL3X z@om?nFYh1v#UmSv_lB{RMU*WhvPx`(=MqPH8y=Kd;hmSfWt>rMP6X}M0?CY#L#evS zK5c@*g)-jt-ycUKFXAx}n@C0x;w^icBdtLb8G@BMLeJLiZqgQ}^P=-zO@x|K$WTihS`Qrre_?G?tl%9l$kxmD8SutDH$14P_~tzde?D=0?Uc_X-ysKNqQuyDip_0X#1E29nqpoyGs(;GJf45|aVz5!Wjc%%-HO(b z3I@u=UI8KZQC5{}*`Al8KX)IUx6j-Vm0fVj1<(Z~ZSzG4t(K+OaS14W^;p~V@qR=I z2_%{(_-O-_F%c|t~1QX22>#4ATy{0n4eUJMKJn&;O z#KG$~2~?Qgqr67#l2^^lx>ef9tGf)w5<+f1WF57my1HYVNv)`h_uKpc%m+m+34RDz z4N*Cpd4@R{5{1pS9hDQW>uRz8MMLBTkh3-g#_SJSZ& zI+A(m1dHmA-d1Eo%2-_6byv1fP;&MMxW8@8W)tt&q#WJ$o1oJPD z8Cn_p)iuzH_v{NiXWqyy6EX%x46;X|-AK4A!Ki!qEN*&FGpp<;$j`H&f(Q#Hd(3(V zmVvD}!)Pi3E#mer2GU>u=7ZAXTz}M_*6v*P)vDRp?P1>w=k8rb1_!}V0*Xb61jwC| zB-vXBfe%<)z<8hjwJ8Yz1n2HHK32>wnZi(?8;#ILq_>oiyHy57-U~Rpb0HV)Klgg6 zjmWnKZwEaq0ExO`Q?ZkTjt7gqSBN2SFupY6KR$#+(-i}-I{~1G$vBwE%@c;>r&5Ic z3W*Q3@s9j_rfXtAQPwAia1FQ6k*hH9i(!eRIN4SQMK$uM{^Lu|bQF9LRf>+MpI4o6 zlLIks(CG=TN{$qr_;Ai^AH@axQogn0HcQlKc-Wx`P<&R(1sYr%o2w)l*Y+Gh)yynj zk3N=8R^CsC&gVV$p_C~Wr-25KtApp+0{)n_#uRFQdsD*V3iBdRvByZg4)mWRUWK(d_V55-wgl82IL049B!ySo23| zH*tL8WE*8Tk0#-3p(_N%V9(*yB-VQx5wJm3+p#t^^K?_|@&o)GIoS7Frhcyv z9TK{wRTo|j%Bc%HWsLfZJSuP^o1+6`H?2-UHlzv*&rb`!J@vG64RAv4a(2K#*`5xu zH|(38dRAY7%Do|s`tLNt^CV2Zt)3kY$B2n9u)J)WrLutQ=0ZvwuA*A971z1mxj&z- zL*JH#-{7G&2q3chv2y~&#aZ9TN+`v!d_WU#Sj}Gb zAoIYV^A8Qx=?q`qpSRuhR|7*^Z&wPJD(nLD8$SRK#*L@znNZnA5!*`vf&DSOdlkin zyu z9Yd-Sh9EU_6mGV&GCg<6JlCkJ&HJ^JbfuXg3Jl{=E)6%LRF8|gz}EVo=giQ*&Gc)} zJ~fo-6h7$95}}E=CeW4eaN(j;v3M_A2j|f%Q*AF32KLFY9l*eOT2#T5q;EzG`75BX zQOjVqLkqL-TcKa-&~#(wqH3a{FWJs9Ai5^20UVNZC&O!?v@4R20R>oh_ZEKxcIw9E z=A%q|o~05zU|M8pD(w__)wm9~FkMT1$}b+0doMVlCx^r3`Jj{{SOL*EDo`c^RP}z5uGqlm)7QW!ZP_C(U@x#_j6rP+_cA!B4)a z>O=E4?ZwSFccymiY5r9=pKpjvr!s193 zW#IfW@+@)!_TP7g1q33o1<)!jYD2o&h$i^8K+<;h`(FWcNz!2H!e@cT!a75z0_8nZ9Zb;g#TkN4p^10wFS;Wa?=!-n@<*M~oMqTyR!BQxl|LT&B# z#SqyUJ)^TFjr|%aAvL0T3}fhTitbSb+R~wi;oa zFO3Nt=araIAL^?G2WE8-Aw?{+zGv4bcwET3ow*;2@7aC{ex4IQz(LNh1PVBJ#=r9b zaPHR+4}ATCW5(NOC+~U=aZTs!p7z<|o$%4TiZ7;`;%Jje5Zba}T z|64m~v$zfg2WQ_T&rm*oarGyr69%`_A9w!``3;oaAaa6pEs!710w{30S;&8WKsy_cM3muG9uV2$5uT7N)KbhW(m zg(-MBs1NbkH8oWW!0>^pF z+}GufeA}4JBtAMJXzIqBr zD?ruYkoz`+ZCEYhNLBN+BiYvSk}qpdK9o*nHuU4NF?{@An>@q9qjE-^uz4u;42z|_ zh#SpN%pmHwFKfZpef7o}`aM}}EUTAb@st&6Iw13FVxMDe#&!Oa z*0Jx`OVR}Z8Liapu(+)kJ*Al_)_*}L(9gZj-Go4)zrrlW|8omIvhz*on|Jk-C&0;G z3bO-0`>}$^pUeIKxLQ)D?n3Z9|M&^!=kH_E23nv@lHHfIPVgni{_2*&K(nZrGXQ|6e4;elm^_teLdn4o4+gc~SYyI5!c0!WxQt zOYJOQu{W<0xvM!c-L9x9^aE<=^vIvt_y&`V6^5NY;+?g9dd-gaP5bVWjNpha(5Xlb zwy30d>oyYkCUAS6oO4s%Y9CYWvwHjUyQQ7JK7V!d?NX(knYW!F#`h~ykLv!6Dk^YBB_M zLNlul$d>a-qM~*6B9J@&JkRly#n{%W#at~%S2*`YsA$}Xq!59ZqsrN8IJV)U)$*GU z=5`eVk*1b_T6Eo!fz~#@uvLX^d;D86S(7@yPdau7_>y(ET7?Z8TDBCZxFqQ=YECQQDFf(Gck&9!qOlj8Fq!{CP?=+M8^B=D-kj}#LiLm3*} zp3P|%j&h>PnE_lLiwEb9bA<7PW7HeXiEBvIA-a zyyGD`l|r&dM2-kG&dQo=OFnv(DfHRQ%2q*A(*RmPrN6Ou=4Cm}gPlTI3EI)!600kM z*Ff-c5WO@s9r^x(qMRY-ZiE<~!kyWuzAo@p-ooy;ufm4lULSZlW3fEVxVqXJUY(v` zmoO<+V+lT1uPA zOE+ycc#CN#O{JHsfpAtltpz%51|>t|SzDMoG1r7?ucAA5JB(2FYpB0Yh!m1C@ET0N zhzU$SG4x%!ryR1)2c2}BQ36Y|GegA><)eGaxB5@JA{6l)JKK2n&sRRjtC5Jz(eJK( zI0B=QwHM`YMH_YIigO`?^=D3Z!`c^y$cEcAA)vs=etNqSsekZWEg7Yu8#i5mM6a z*_@c6mJWef_h}?XpF(JJbx%86&?IRu4caqpoFMa?`d%)-#9df}E$bHKo>+fetrgWQ{+U}r#gF=l|-?fW8m z*7y%5)E0Xg5q12WqmJ3<*A|*l(L7zMu3CNc8DM`MmBi}G=KXq#R&NZ;LMv{Zi!d_A zA?bSBat@3-LYb4JR>zpD<=AMhk(?dUk||L@{93RCpw#Y?@4WPGq2>UpU3hg)zTWX~ z@E@~~@iq(-85No*Mo0&c5sLMVOOWw*N!+=r+X5Z$%&AMGCd+vj zWer6o1qW_`KhpMN8k@x(vN)Q2M=x}oilv4h%F&<# zZwDo&-sRIeshg3CprI;cq8y0CY_6fYXPo#3dL{s3<5lCYo6(xmDPwF6wws3%8#5r$ zX>Gn`fi;yAZ}K=de^awolF!ocs8a!l*h(Y)Dw&U+32*uw!UG*IjedR^Psh`t%B6Rg z^jx;TDUjPd8*u{CJoTr1%Qs4W5u&b;6=g=-I+hMBga+gEZx&cU z_Q9q6&zIYLn6LGH>E>HK*7X6m6SBeMv+^>K@x=Y#os4{pIv@(0ylc@t zCFQ6Km93E>UOj&eZlIcKmmd;xVRqlK{6)j*TaNA8h66D1HDOJ@*;-?Bg>`g=?F4x+ zlcCsR@?>ZKPiGD11IT#HPVW$E%bP)M=CzVS*hW7Gc^>^^w>e{+nl}2idNz2u7u~nb z4hw0z4FNU0G1%DMvcqSs46rNFZ98daTfH0+yU{&5z9V21to^9$i57i?f-TyY|Bio; z^zFUzriq+0ni5a9lE+rgwEP4X5+uZO95iH+^1YjHG&Whv`sdaLYyNVgbxpmsj_k_w zdQv_DlP?y3&&=~(IB;}VY{b<%DC8O(;k-mvAEKJ7q>sHMoP5n@(vZmnM&&xhz1oBn zrYf55<*+fMzgNyU8WNNdh?po+>t*Qai$_&Wk3EJAWoGPEyiHlaqQ>7HM zlxd|Q|Ko@F)(lYs*fJh}*{yGX#?;)*RiD2O);AF=u+Ad$mb%xW1=s`qKn1GyW?d)0 zRTuBmjD?miIFI4#K=bKxm?$(N@3QC_vEWP&Lo?g|zHE7CjXnFV!2SQ4mE^p%%$32X zc?MkauX+mx;?e;M)c&sAF&$b-AsdLAQr;;vPg5ljMR{AE#tpgQA|l>9l#m`cF!zo` zjep9|I63y?CMG=ednM%U(lF&8>z9!yF121~)2=n5zxfT32k16iHE(i2Nf>%BI8iam z0NM;@LZ*^LH1p@;>{_-`2Xfw(d3g#VdsYp~FzZ?0rH_zg^_#DbRUmet&gejog=;V4 z0U+-+Xhsk;2#sJ@Izaj4`5D2$j*U|tAhHIavqJ~%lEwNn8) z%?Q;BPraq_nwM$*MuOAtArP<-rJWMy_qxa?=f)^uApJ9fo8xXCCu%hpx_mo7y-6lZ z=ys=&K(jYWySxLxCLvP2xFoF?z^`@ z{cXOuW+9Jjft`a1J0c;;gEZ-l2rwHC2{dN*nm9bItU`LvIc=4!Phk=ofR>xDh}vY` z+-pG^Qt`Y{j6!%m6P(?E(uHbPQmfmEDGs8pqNIv1j1S-vwpOa z&tQ#e2kF$A<{OV2xEZqzZ=0s_rAvk^mW0ZfxjODoBzc#PF8KmceESqPsAQ=3nx3)O z=<`Eqz6r<#rG=ncU??UxgN#P;UMl8CFc?T6YXr@3;;d;TRuz;`dW-Z&YlcM+9vf5p z&CB10GMccS3ALT2V`P^KwoR9y+%24crXy-y0HqGo?S- z@mgJris@{Jr(y$)^_`Z&GWB`8hZgy1m%C39a&~7v5>i`5qeY`;u$mJkba0|Kj;)1T zR=Pkg42(11TDbd02NkHmO}E-WM{!($ac3(1$`DbY5MJx0*+x3h>?>(69H9Cq5JKgD zJ|cpT#rC8(8dJM({Kd2TzH_rRv;7oc0^atUzbTu7Q@{#%&~N^xSO30ipWi9YMZD2A zv`ubP+Y~m1P2p3x6mEsvh&S=3+Y~lMP0{E1000mW0ssa8Btry70AOEb^VBSWex6OG zt^2p%s6nk3m8)(W%*-TXvjE?{RAL)dC0Tz?;-3J4GzUaP0B2ADs0*GQ>Pa!9FeH) z`S+bIAX$kNmxDv$O8=|-doxB#uv-Th$D9+ zEx$yTA(k&;PVZ{fEYJ`m0xUqR|KAhkGR%NCGv+hv`|AA=ncvo1J@r?Q?4{JZz4TKr zv(wOe=&k+qdU%G`&^h$!k@`LMdN+^$?)2A}NI~3Bp8BP~fAv}Wh=~zKKw2qADBDyd zSesxysKqbM`OG)o&#InTGncT_)&6?wtxP))^w`*&%=drh{df1^=3hMY-hX-L{~G^0 z&z$k&-Mq0)AN}i@2mkJ?zSr27{`F69ve6Cp{_6ZK-TCojmtY^`tFNoCTm9zgj{1k| zWnCeY0opW8>*QR_xsB{K3VB?0Z2s{rd6oWjk=LwU@b{cbO?L&ce*K*VFzsigbHzgO zD|RZaSu#mjjOSQNne9Nc6B@bh;C{7pfjjJ^Ji5%@Wx8jY9;i)o$ztW#girc*mzH8S z{fLsldv@PE%Qs5solOKZCX17Wx!<2N!g3N>y>s20JPqx(IrO^Po!UDOx^<`6FfNmy z3Ck$0ZyXwHf>DSTo7=sC`l@wz>g)M)Zqjh3)J&<^Rknm#+N-eJc1Vb}j9|5f)T`R- z6?0ok3sW$aW8~S|+4pSQ5q0${^!WL6UcQm1>n7B8pwxo!z~e-!BKwh)yrxOXZc?<{ zP9@*7$v%aa$DJ7hxsZgN`UZ37K6L9)t!7}ax*J8s+)MceP4-5jX#@iB_)AN*e4vGP0#l=P)(_jI`$S@(NgWN{7Lcr(Eqol1pY z`$5!`_?rk&>jjDTWbA?bwU^z>D;ld;EDjZhGKbb;U|;#Br{85Vf~wLw0(W1Iy8dp` zPm|L&9&gbMV$dL8bP7DtYldOo9Y;=zo#uufysp@!Gg(m6*C4>n*%Ba9+H&=xo%_Tl zPvBcEFGVB6%gt*_faFkq#xN-7!}qhncw&h}YVv&YZ_c}A$IKjABK(fxr0E20n_0zy zV%>s(NL*_QUQ1xpKr=#^$ZWbcV?KT8Cv3IHe`&%ElgH7ic9Z2@=+RqXej$E=Sux~9 z|C+tL9P55=?Nz>7%(rLCkEc;9V?0p+7Oh1XKc@$;w}RDfJHH(rUUPO4XuzCdQyHwI zeKOuoDFH)9)p|wt2E;ECp~7psropy)epiW*e_`x~4~{|g*xDu~SRf3943|MpAIEyu zt0(>Dj;C-l<(^5pvQLOu*Ir4@dyvE`fSb|gcTbJl;~-ZF`L~*}4ZVbZ-lT!!1RhP? z#Wyo%L0yHrvDm65ZhFLr!rtRlrAx&bn#*M#cId>E$tjqje_^X9E-H7P#6 z_e{@ST6;l-_%}~R%(NCFKT6^N47F{_J$66VCUZ4iT3sJewku!8GEdcQ83Dg;MoiB%uE^G$ zzu7@f<^JB4wRD+$yGhX2zP}eS&e&wvc>K0FSX$KFl-Gz)J`}^Bp})L=3{^CSz>2dm z@85}&6Sk&-CDZNkl~MaZ_a|Si=4DG96+{qRn>Qd3HgNplx?|-w7>_^j$>h)MOv2)7 zZ+bn#K+^UVGQ6Mfl+RHAe4X5TR{J{kAK_J`MD%5fyzOTzXT*6pv=(>Ul_ zW>{-Rr2GdLEx|X#wa59V21B_IDP3E)t#C-T8Rlk$O-6UX@%SHQbkR6NxI@1d&n8zZ z<(o~)g_D|W5@n`+#J}8_85=tLbMBkdb6aNsOKZnoDO&0Iu%qIe2hr#5k%hJp$3~`b zjv)X4_P_i&qu)ecDCR-hl)`RCwiR)EH;Fd{J~EIj<0Eg!*OL2`h_yez4e>&%cNsUy z>+RLs=S`$^D^7=5v&ZLKPRgtd_QunApnar%yTKK{)l~Y=-r3*pf43^HN;n^bWQ+K5 zw|hvawna2}W82sq4iVhVM}Os|mtwzz>hxt*%Y{g&w#SIL`2?e!OR)hyRz-rZ@lu6+ zU5l7~rpLHe($B1b1yi>_WsY~i-EH=(emu8sbqj@8z5Q;dbrs=rp&gJ@5Z`Cq>HWRR zl;&$(pw~5cR(PS46g15UP*+J=6}i6_1reuUxthxBz& zLp%7Ix?(9W6yjjz1kk9k<+tCkZy1{|(ky!&q)y?{!Gyj!!-)koi!$K`iiZ*I>;3+D zx;%_!94Kx!XaZAk8mPwf*rb5rXKomsTW{UWBhTnF$KxVvWMC3-+RE$|GaZ|;Um7@Y zeZkb$%jm8&JndAAAz0@bOYolr3X*i^5PtDVlQ0*QcX7^bEqEyK3Ql)GsY-$d3 zJHM;RG}-3XJ6bciVl7g5s(0oRneV9I#+%P)4ol>uJLb@s%2spi8!32!chC{l@NWwk z6#}4WBAm=-O3L^OMh9g1Dfy;H5T8|pmoN<2T?f?w?I*8A#2PHSBzU9{_MmOc-%t7# zJDBs`B(N2?naS0=G6`t&GozXXe<{XGUy0rR?nK^Sy1JRa-UafHpDOz;ddgAb1N_NP|TgQy~1YN`l$Ta1C{bWESv z8$n_m9y1_N>zE7SN*#U$CBbqyOnUJ`sPDqDVXM0#%F-8mquX1RRx?tN;$rw&2fKA< zp8RzKpvkx6U17+5MAdr0Rw!#9p{}bCw*tW6OE!~H@L$#HnL+8#Cxw%b|1_v8q1fC=F*Wm3_7|79X z(V=-R->cS9n@fv25%+A54c8#S@=Tm!2*m8^MOwy6JO1|6OZEO z9RL_-4D(^lHNgRI0C%%H*1{@ss5i36n5=o$ag(dXVMEL<&3^YCh*2yoE%AzkO`0=d z@5DN}jR02IQzQgAxF;G9hSqohh3B^`e@@iBW|L7hnxGz9}=n zU!CS~rViosk6}_j9nM8L!r^cCJ>GFc^p$t3ZCzoa$Lx&d0rOlqUtjpx{9SWw?bQl*1NVVE$gwfHQ zUQLj-^cIsq`6#^1GoR0hU$al6BRX%(w(Q{h0~WiH4)iR-2acHpV^}IuExCOPMF~R4 zKJT>L9?dE{@5_sZ6IBKf;u$>$x$|7)8}q`7m!7iNv)+=^Iy!1@T}-yy%F)jKK4R9q zDB(R*B?~J!qUZ&N)oaB zu6j|yVJenHAu*kjv?rRp9mdFIA-)3>oPy=6Ml7jFewJ?nZ2`H@ZyaaaI$deOsUZ%> zYZpLOO`x399evQ^QF6hMKs_>4JpC*f_4(w%~jUa zeE*-zsPW~NS^xR-iI2TuMGj?3ng6fnm6*IJy=-3&*r{9H2-fb)PIKz9uYG{U$kJZ^ zJa^ggch}KNxD0O~&-KT`$>FVWE{ptA`p&#sZ|*LWKXu|nnZP z+6p!+%OnjShJL25I=>cO{WdQ`E~76b{+TuivuSn|l|I~)KAN^od2q`H7@Ga z4(#jy_9?&e(hRlr<^CfP7?M`Ip1|V!#iXfG=;yv_rp z`=LU3Oix(4geSi-3?B8bu#8FNX!`$mBZTg^CaPwnhyHfqHtc-Y;G|U^QEBp&j|MmZ z5okcivoYCrd((_j@vz=dLlMPYTa_%;%sGX>lyYULj{$#_zRQ-WRn(WlC&46K^XwGB z!xHF{&qGu8wuRkCch}Q7Iqyp}-m3SDvfSB}cxY!fMfbA0_|nxqn2hxHWH}sxv)3WU z+?CW>(leUFx+s;G<;IkPBs}o+-pHdiZ*R+i-_=SQr_#qUib!Te>)L#_$tSPdKZW4i zr~BOd88XS;L!Gg8y@Xs>a(J3QV=a_7&qAJg!;Gk)wy#<2nor#Dr|0aAeEnwHJ?m#1 z+%?9DFQ_DN=`+6g)i;Yb7{{-sYT_pTeXm;F{rm)CtD6zD{sK#go#SS|a^i)yd2NX! zdf{!)ve;IqL}5u$-`_48%W=_e@lr15e?_%Da3oDWH3gV;sgD=nZ&ISyWd_{o^z zv{zz3IKuk?Ra#7I3NDV-hP?rWyKEjY(mFlsQHMGFKQRCt?XNWX6&;G&f-GiUMTvXI z6jO*~z$h`W4AMKqY3-|3bXF#o9k)K;hKh^c&Xy3V@*+=X`LiT6wrem45ty};N1~FG z&Qo|tAye_~_+HjvT9p~P+8Si$l?N7O%M`XVOhu?|L78_Uu2%}>xOMI#g79SH^fMc@ zwr7V{PaX0h9E2*Zw6%nZuy2HFcOsDu3lPe7CbV88!%-ez<&Ja;*aU2%O6&~u_!TY% zPl-?zMf}PtnxOiVuhwr;g|8lDHP{d9M&vaKl8ZEgx4Z6Wr%X5?Q;z_a6vK43C?XeC zCl?W!#0~8&RcRKhrM50&*+W4T_Jo&6<_a9(&JWFl=TrC9D*IsKXCXSGPl zHS+#@bqzeV%bufldwCKFekV?am}3#EckW+fhd9EbJIfvUW{$W*9&T?)XR z!?ru`=Mxh~uer~a^Vi+vk|Nfngh0y#QY%3YxKP-(07`6`J}|$Jk5}ZYDgAOcmNVB} ziZg0%rSsX*4r2rIk={7*vUGQ=f;gm34nZ$F+-ubqr4I>W5rM~w@ZIEZb@a*ng*T|g zor@FucuojLph$b?0gR4r0h^Xg9=>~ZJ28Qh=Z|sTK^Wwt072awZakQABqp~SJem8l zhdr1A*uYOjCkVj0oEcjnWB(>c#pfVd2XbXop^JWiGy^?3lhk~BU=BWI3u|QC2|Cs* zG{tSP6Sab%nMm<5h$HWNQ?{pOrkLKNt-KRGdr1XY37U4cy6A7DX(gRg2HH8k{_ok@)EgI_uSR&HTDwT%|`&pSCPB zU(M&cQ26v|-ed(I;F+yhddhZIEkYZx5OD}BaF;CGp2~wFD1@Ec+gm{>LmaGcV7)i? zwZ%Gtg?Fm@SPJp>HEtp92+Ik0EA3t+MpabG3o$}4nnV88h;Id=fH>3^S!N3!2_W0b zo1bke?zSEdr&igOp_fO%N43%qFuv|HeAC0{=VeSIVLW`>b)2hZyQ2u%t{6#5@x&>{ zjzOu2Yymr#a<_Kq=4D!O00?qB5PdHDHM6YTBU(mn?M9`$!ag3dN)x@Pcra-(USU+u zxdxG-aMPOo(?9Jdx(I04VnM)n+Z9&F4F;%cD6v*md4kY~_H zB!Ajgdr-B zr!?9yAX=WZso(|K%f+<4!An3^kV~>dblm(-fv&O2`}`AsN-;hlNCiQIvWisGufc)u;{p`d;Li6xllINFZVvq_@B>EI(j~KT_5I@s7D5V=5$5 zwNrq`E;dp;7ABF1YR%}}2%LtHasb9u`z0(yDFZ~M;|kERy+~r=SSDsIRF0Y_w3rmB zYUd;paH9{!MmW*T5^*i$VDbF4JR=nFC4tEtNHLLw7;S5%JQC~9wHD$Ef8o|;p&I5W zoO?PC#adn1RGi5Wc4X(Eki?nN++@<`H)|sBa2GeJ} zXf&-h5LnawCfSh(Yqt%-N$+6XRGqZQr^ujDG1C*lteAF$W9t*hWcx_zysRlBkg1Vq zTTV(+iRBej>LHS};eqrHWw|t2Kcq1g^6bYcCS_Rzq=CX%Q2X* zfY)1#nPw)%k@d?E$pDxCrfK+TThribThS;KyE!yaKR7F=v|t3m0(i>;C>;)N4X&^i zj=VNleIg;4g{X*-3^{@5;B5=xt{x5zT9lE*lfsH9)H<`bo|HpN)!+*tblbI`1)Z{W z+tfL52!`y3)s0{!_09IW2jW+2hXzPVM!lYEG;`D(f}AM~x7=mLR0D{G_SHSKNV7m? zMIz;;95f?Pzl>eF2(a1hgC(UiBLEgaj-E@=gw7riO=3uVAn8*Hv*# z4-E&ExFApratGfnjoMVj$*Jkd_H-w&d1U2J#*Pm)+s|?fnC(g{y&CT52SOihNMe@bzJVXt`fU00CJ_WqV4Ta ztTY-0t+X$r{uJ!xs)41JrhF2rKVq{oM5GdanDxn zfI`a}I1&?yXhXkqEGU@TX@&3$tf$oES1vgiYXpMDFj79 zIJ1>b+rqVo_aF?i0K`m{L^^YdYn`GMA}yudFedNz%86qrK;F9TrBcU<=X6v!F6YRD z(bw9|Av-1pfi6;-`)TJe1yqqkVo(dk+)01==b#71 z1x!ptm0HB9MHnSp;sqf|BUF(+bWrQ88FGUM2#FhmnF4eM-BJ8?hDo71+!2S4IT5`e zV&DL!gQOtDPZ8zoDXr}%0$Cz$3amwh62r%|5F|elMIl%mOD%s&0BTm<88E6yKZ)K^ z$~zQzyN%W@g~KPe+sDQqhB|F{MM~U4*do#k?@QsEiv^LRpkpmW(uG-ohG!&{Ayk!u zrQF^ZF2ZsqjzV|9-7pwtPm+*TG9Tb7MVD#EMUWDduhNWV5jah%;2DG1&%aQPCwmWa zn4~r`w%*uu1*49S*mc474H{B`L4@GUoSrUEQ7Ov{4*M5+(=kaC|O5d_peDnI*psrA4`>tl10kX!6yjqK5Fwl%Ishr)hIkR|{CngOC20)SMY+wwwM zFhGfI#x&gmWVQ~$`|fPlT(%gKm!!F5Veb$Rp6;8wrCaIL&;Hi6 zJ@?qZYt)viJc1U{haAB$T=2v|VFN4PA3yg?_4KDlI1Q{fSJ{mtBnZlr)pFt9_pG(w{A)IBxacP*H&E73Nl-;5r~*kFZ;1pNL;U-mZPbV-!b`S4O1^(y#x z%a*3z%@c|uTZNX8&^d}NW^Mn$E=X|b0~G(iG|~EVZ4#Mf?Pn@f7inB>5%)$0-W?Bu zYd1HG?@p^LrepnNPwVbqQl)nv19541Gm_fok=Jflf2K=2otbCsC3ER*VY=_c&SANg zAxl*25LcegE6bj@wH5RwYQ6VKjS)(>vFWlE;cl5dO015A2tN`U{#Ba`!)=inQl2## z1SGZ9yU#9BZ+c{3NS|#Z9+s}852RByHO5K-ba=l8I|ccHG$BRCcVeB+!JpW_Rdd2L zMCTHhno&@7!cfuNDDEtOr4a%jH6)xvOE`}f?m4D_|HT?R((ril+*eELU6ukJhpUeMp_pEb0zyP(8k=5g?HN!w?(LX2`0I1?$FJ zR~r(d-@c0l8QeD<>MtO4t&8pvFJI8Q>oPTG?=t|IUm2!e6}Ne=p`=jyl*jqTdjnY4 z+$!p?Rqnh+$5X5_x^5xrb6OAY*yEkDqX(6&U8bM!=K2& z|8?-Owqjq2j5a-*Ev@h3>&8t^G4lWF_hWf8xm@iw8pO4xu~h4tY7cl#wkwp`F{{9v zc2K;eq3&N5v)-P|)v&?b$Vt$xK>Df{j``Ca`%BsxIU4@_n{-xtQud{)MuAFd;U1*rL!gN*e~Q;C520#`N} z-S)5U5EYly8!J~eviPkgt`7GZG$G~^L@)g@2nK1q)ndAtLCt^3whxs&M9rcfSof1= ze#5hJDsx}?re-O(ewAV3-E-+#VgO0aFsM9)wNdAafXB=5XI3`rjVAv8^6FKg?F%%H zm>1pI`^3qKR^)4Ho^mF!>2~DIVnLMRO59X!N(hY_x6Mhk+ws&eoH2yzb;tGs#$6Od%B_PxTB?;`GC>w(5R;CrGzo% zQ3L}CE(kbTW<}v?ls@xu78voY@|@+i6gDo`P!TDGOCD$?mJ=Ao;xjVoedU_kao#XZ z6I$Y8c$>)O13ln;!rZx)YMldkk`4Z@UVE>%wwY$!Z{LG2$%Cd3#&M6o&FS{HS;K#` zlDk)KHC>qst&8y6&7i)F@H)~+E_i;j9lWn0KU*fD&D@p5?DlYtDY*HEQku$kjpgXN;@xIrDxl%=#w_?hg>l0>bN2hFTpZ1Aw zsY?14-q?Ta?$G96$b@x0B#O=5;9|@FI2z-vmZs9K=;zzYi+5aCpZ7+?(}i|p z6kW~0>b|DDu8f@=a2a2;goivIH7r66KW@}qLeV}AL=IB7R^&zhE{(NjqN&A~!f^AT zdp7O-ZejSyK5rY4)yN{?)a#X(1h*5a{8fjIiut10?~)nA)|>fQ#Bqz)fBKC*#Sg=W z^fdo-I(O+-pLb@96xx?>jN!p(n=wmTifvAt;O!M>%9=q1wC9 z(%Dc$Bj5Y?B`>At)bU74^fZyCBfB(zz^b5o-Q4CZ0ygdYe@Ra|H(9F$YVzKbN8Z)B zymWWjMl{@Heqd~fr)le<+e(t=?q^ge^Wc0TO?37yyB2mzj~GvcR>H2%{>1~&3ROG> zhiN8kM%L_jBkXWw6gN4s(dyT?TslcF5=msx&hVF7uZA1QG0KyL{dI0dWZA+0QX^5~ zCyIxMTboNv6SPNGEUhcKYm=LZnx&W2^U`GQ^DrnH$F6?O z+1+w11UWs@ zX?nS<6))6MotI+A(J7m0o2<}cEi4+>FX9!h{Z=?5w{j0ZGehi|ZD}O8rOo55AaB#v zJHv>X^&^{q%flR8Avxtz&y7?4t;jWYKAE_C7E-qFWxQe7j&KKFCfgSLRnF$^oucwJ z4A0XAc56N9z|{WVhj6f|)vp!r@%V?W^!KOVcI}DpkADKNet8xQ&MwwSgN54S;NJt1d~o-c zqY~%O{uA&(lfI?UqTn;khp*|CH7>eb1W^-jKJl{X3oS#x@t;+YW_B=aTI;ZIzUOdy zWo<+nn-<_cODi29QJN9E*txe?AqO(K)43p0Q!~|ZShXqMkpJHdT`0mVlqScE6C#Ep zR}^1e^94gIcPB4g1QZ3xlz6``vclh_C5YnkGrssGZ(iG`9_CD~$!5toA4%eNJ(pPa zD2PA}8}~e%g!AdR+o0jOiDBX3Ux_Z!{KlD6yl^9uI5bmjz8uU0HAi@w)p$0aWn0KA zx~Z{pis}BP-0#l#*Uah)GAz4o^a~h2ENv617TNC^&!GnU-xmuUggecb!w@781nHI10Up5-fvwBr?7aZ_Ng~2ejD2@xGp`Z z*`zl`wj1*XZ*XqQb>SO|Or%D|?Pf5=+LDnspEIlWZ^U}LQDQ_3ffCCuaNb;NLCx1l zyj#vKuC^J!u%hA@qfB55w|olXl;7PhiPifv0nW;%M@dh~Qko;Q8Oj=(J&8-)ik_m7 zg$Az=HVLqI@GQTGvynWpBa~E(UnTO#$yQw*Z>-t>{9H5m-;>!t*aVcif=#^NNHFX zVy)vX*C3dR;l$*KVH`rp9#Bnzls0yCZtywX9Hw<})<5_TV!Zd}TE_q07FT;A(F<5E zbRFNg5|=_7rQ^4ZJ`DI@1))&T1#ggViM?@67*cy*TA|&j4%q$iK zdl3r;9xzQ&7ED}QZ)@?`;WO3dU+A7$$ZjVF_Ngojh93Yc>o7XHasFcg_|+EH^vc>Z z7(QYl`S#$`wGmO23Lp6tZ>q#Z4;VVbSj(bgF68_(urE{aJ9|*EvdD8^^BCuK>?LpW zLF65`xhC&I2}GeRsKDJ9(TutZu4AnV#J`ep$j^I_tcAhw0~>?fg9emkQZXEAbBc4} zVaI%Sz7zEh5+5e{`)vACjpEYD5TN)`*;T;{QNof=%3o1xAoJfb?Wk)7s4Ht27luU zeWLu|u8yw%jM@9@+RwoxavU07gI_kjQM&8Xd%*kaFZQ_g%!{Q9u9Az7)Sw=^HFNBn z+*&y81}6)oLPBATF~v}5=w0U0jZBp|qqw|-QQR+7K`CfS=;r8WQ^;c$_Yy*%Q@6|` z6Vu6TR%S<*Yq&#APH$wL$_Z$M6rT)uA0=sXd$wckjk`SKRMCQ2fZFvU+x%qwzaw`)n+52FH_6UBE{uAdeVTh|{-)Ow@9FwN!e1l5|8D+` zzv!;M)_?SL-(3qmO*x5%tjFXD(K8e* zIg}Kugv6L@5QUgp5-Y=wxU}_j2xJ?eGHjDrZM_~;6yl>+f03N?!JVZ)M<9RNC)RAg zmGd*D%h;hzY_1FpWRFNvhCg?C_;=~jy>zGk*1enE)=?Dy{ce4=?@{?X-!zreZ2`bN z62_5$(IUD7VJf@UBt4*FxlcA&FYRRc0@L0TlhsNamm(wx0j6Qs%FZOzKoS#dH6Bf0 z2)~C;`L%j8IGz6OKG3!Ak8fS*v%kOdeJ5>PF*QK6WMu_?sB+=IdBc#(Ct-eJ7b zd~PCvE-nyyGo>n#7#R@2rXX)YtOY;yUagGp2_yxkr9Cad9YC?^y)W#LaTBf|oX$ zk{U3Ygd;Fsm_gb2I#1h;lTrpKr1G_tpQ-=Py4fnpFR@;O9Hu$Md(_2IWyB(kL8xI| zr5LW@w}vBW0R%zRwya!(g%aqToU$pF#-pjYS0PMc4BcMttDoo0{^p1p)Iy3VK@6UG zSW_g9l2NTKUh!VPzX=Ik{gPAF)08KkP-^&xrTT!em}r*{pSU@2wRb;f%9YO1)6(b9 z>t-1sITHm*kSy3B%EW|43@ny?#Bmw7tC0SuNAEL*KX>U2)iH7rEyi7fp$K{mXv$Q9 z-j+2|%&2Ai{{M8bdXNN^D=@;yWR}+nFaX9B=YKbYS`e&E^*=4FAtb34JO+_%78uFH zoLO;9f`BTWQ{$HFJ*0|1GWn+V1_9}%EUtN`5>>eX2ddISAgRvrK&|D zrQ%#c?Lss*A{HYrEDF;LsmV++35>^AOg|j?X^y!JM=8Wc9N7wwlY=}$C${9sRDBhr z7eC0@g5;xAI~CZ!>ZI&L&!#{22Jdcabzl{B{P~PWbCMM z4yreYLq`UI2$T?%)d;91NFFiC=!JrT6UrAIAFxvTaF~!fqGd=Wu_;KjLRbu#Pn&Tu>^r&0i%5Z6BUtJxZQGmLGRb4g_Z-}k z(rU0RAaWJb<1IZhNt5;nG=0|I5h6-Udkd%zBodKjFA)78f0yqWLqnyXme0`2g7L6M z*MLq6EOL+q7DKzfyUEj)B_)&=!Ibfde#1aPLAN06sGMSRG4lf-^8_mI$mx*6kyNd} zqHPPY;8H|KCL-EmZ48!Gyq$7xHdaX~tYJJW3s@N|paXclh`nn=DaMGA#yHtkfRU8W zpp|p$V+^&#(t=3W6~Y9q&Lkgvh{2LuyP---=hhw+TaW@FA}FQ9t`0G|3~abx?F*;c zV8iXnj^^&W&)(TPrGNIH= z_Y`rkiMD#^L9$B@vEn8BVaJnBmBmEY%|V`GUX|~_#QgJXO7I0lB~V)hRNZKi2)eRR zg3B>ZxMJHd7ww;!5F|aAVrvW(tpY4dr4AnoYF)FQ!TnC0Io0g^M+up@@$Arl&N922 z$R$r<=xL2CxM5c?=5seE&Yyhc`JzZNWjRl3@d3+z7;B=U=De=7PDI{ypET}hI*)dg z_03ZDC}kXiHJE_h1{zp9n3#+K#Uleb{TF0bWev~zm1K@zTkMbxxV91uH*4XhDcw-1zh9A1k=bVhA`T4{P4orfh=jinGo zu()%K>VbiH7F(XcYLKNuy?gbzL9vtjkV5ZoaZ^2pr9N+63+>ORdGy4?K!p!-4|oW!t`_vQ|t4gGUFL z&O*J#^B@e_kFod?h4eC~ys&icYmjsZQVHuiOiCK0i4MRDePloL>UZeDH1krpJyZgQ z<{_Xewv)KT%P8wxd+$t;5(kbJv8DZanGKpuAtw>f!9!rtj;M*WP!N(W-h-vdH`)&6 zl#V{70SL70+G?btWU)sI4-!)=ylN0fIUiT|ch2eP1tGCC97GUNR#LgNQos=H{*5E!QOUa{Ox z^l*)ZtkR3=m*1u8usOv;Oo^@o>PpoN0CPZ$zsH$OQ;+sP2GDPcZ{b|ymly)BreYkB z^ECpH=mDb&GoZ|bEu*z___(uSQY98*LKT-2Pi86JOTb0!@mkpA-I)RjB)M^Er(pf`*!o8|OhBMgp_MwnSO1M}m;sH@p#KO{TvA}ra?(E4cdG5w5 zW&=qSoVchP&6yD#5`D()g}zT%?B5l4&@(HUKY*+NADFg@uU}!qCyPB6jI8yMMM0*`;5i-~;JNN%N{)Yd_^vFOKt*WsD*R2@~2jsz6 zG48j=;(xSsl>IrB9fF-xR*99!dN_5yB3(s4DMVJ;nOqfE$?k>#U@<1+{tDLxSsjRnzz7r;wBXSJR0-^%fG6b3366Hazy7oRw8Atz z_+jU`(hxAJ^lt~AjUZ~_P-;1s(UQ9W!*Z=u)C$E4B&5hht3ehRcrJ%V-ycoq+!$|4 z@6MI6Rf#J_7El9&F7X8_3z5POUZZRu^qaeMDv`8VW9k}O5!r=IMidp6q<#&`17m)) z^RskaJ>RBwUmH*lAAu1rR=`)viazIa+9HA~l@ncO<+Ssh{n^dtKq7GR*~Xv&YBG$q z-t`fAZr_Tjui4+3onJl#X~;71$Kgo;`##VGytE`Izj}i+K~y=3f7zKm?YILLEk>SO z>IL1l#k^)w5GD)gGJub>^uweLDYg)0Jx(E+|7rVFoo|4$+{^1+O3lnI9m+iE{m@_k zlU`YDwL}F6h$4)A&spfZVNugzf*6C9Fe9eZ+!j|whid5siV`w2``?VB#b@v%7z)5R z)8eV<``&^gD^+5#HBU1Vl$G+}MljCcI>yu>F0374QHt-?%IihaaR#hk$k;L0GlkOx zY+xaga4#l#h&6o41%*=CSr z^VpMwvDgT_mP8JxSc$A2dpXfO`(tKMd-ZZErNfdXk+q16spw1~5Ji}YDmbgf%x{0o zmrjxd*I=o84)##uBoW8Z04yYTWwQwfyP9AaE3A0z&j-9=#^^+yFpp0X+sd(V1;ff6 zx?~-Qv{Xt1)?^f>toeJ$3{mlyl+rJ=2&{IS-{bPI7#ukR2sW0lHe8CqJ+%bN4C4;N zO7*jhrbZg9GEBt|2}njF8=|$fg_nu$)PFfvgB_C)i%fZv*q6Z58bvk$VjFO5jlmm= zF+o7X-c3Q31VYOqk_dIe5f_8Zd_GzF?CEFbXLIK0G#NB$+|QUGL(QHFv+IWp&A3|C zw1e`Zn8RL6G-vN{@zBcA5gFnHA)Y-CGbdh>OQTd{legX8gOpwW82R+W*jp_Q>e)Ev~PyX=8=Wi=5l2O{bj`$SzqowCclYx0b2x`R4om%Z4oj5eF)pf=ma zeqEWpHp@Y6w#J@KS5U+4atDo-v82%))MLBsOLS#*YAy%W*cp2oT|w=(%l$O~Fc1&| z00savQv@{tU|v=CDKS7OE@zhJ{w-jxAS1g{+6zl@YyqTmPuVuxq>*E_B>%4JzW{+W z2Sh{wXHWp14BH0=UP5K%ukve9>N=J~N`RGUMdKdP2>aCvtbLNBfR8<%6 z{OYg%G0ew4^ZvruxA6A($LC-9=u5vpL+DfU|NhKAhcbu4rj!13=8OOQ*V8%LfBfl} z{$Zyh?flmpoOS2O&pPGlPjl(?bQiz#0%ko2_Bio<)mxAH>$>{&?N7bdQ*8CaUi#`T zeLdGAi`Uw^^k`jweZ5srKhfOQ;DZi}#O6qwZ~`x6XDLqEddmW>P@{6SKF(xbN#<}_ zt3x)0vAl%l!jO05lEjX2y<49(n#?2>^^(>DS(mLKFdC`C4BuQS1f+J>XO8A}ev+h2 z18C_^aOX2*}h*?X5weGcc{30{$GivaX&lE#?PzIL_B?fke9lo+AQc%#URmPnoYSK2= zzor2xZgQ3-xR=a=*bOY>-)&>h7{Rxssz8!2kalm7SjXyZLcWlNxeKl1`>_;N8>*8+ zZF`oP1B-$Hdr>eNP;M_2uoJKtxBIVhnleb|h&*J)It4L&c|HYY2A2#VBHPUyYonj3 zrT7@-LRx}0kX||swv(cvJcDNKm67wGF|vw4b^z|Z90{?t+GR&*aLiNIZ$LxmQN>a#=%e%OYHtbsBXPvCpj@3M#=VM^w!7NGGl?Do^ z&GZV@-EO;yRtCETta2U17-6T~6mxNJZWMeG0o5EtlOY;VtOjFkmbMrm6(L*NWfOkk z_BlLfeD&iRG&))_nwyUfZ`BtjFaXF2SeKYexxjcqHYybg##kNY=&Wj!Dt9&`tym{Y zgn$Xfz|FB=%Cd1=5?$uwwD=zE2uoAzWwaEZmpBKwxnhxoGChc`8{?XHn=rNi9JTMx z1&huk)Xl$$tke<$n>S+Z{+ya4$yGZi2w-}&(4wauslCniVi*z>42$npUwb{I;AW=| z)O-mpfS?AQc)*Rp(bR#{CbV@Py@zgBH>Xa})yL`vEc_!PcuWIm+?#tHA%ck>EW8i8 z-1j;2ejIu{shR&&9bNh{#kfh*g+-_dmCdWfF6-y@&o4c(Kpym7e&XV z_fHVJMLGdpF&2Z2vHAmHw@;o`hJ=~s$l2Dno#QktiC$Uy9_=>X&r;CG>oa$JRT<}*U8*sfZ}qi6YFUW`Ix9h9Zygt=Ll+CM(E`nW}8EuuSD-swfBFPfizABx%dUamq*mO(c zv=+8UZ22V^#j?j5mN7CRDHli>a9uij-m*K>T-fM8Ql$gcI+Ww^5{!cFl3>8I^^AAb z{6&)l`hNna1{ayH>gy2q3MX2rh2UTR93QF5>NX@-6EAj>W>^_o&!i^B>Wc&b!oe-8 zc&8sOCBh?p_Hc8HKV01g>#~T>yM*wYHl@9&B*eXjG9QTG6+QJn&&3Szko)Zi;sCm_ zO3KkVnXt{6LNUkK%-=8uL2bNYYcknUBd9-9xBqni`E3JgB!R9v7 zviqKO6C|PFWi_gUFSRTn+kXOc8|+(u20_JSKQXp{Y0LY$_TIUXjNQs-H&O>ofM%S2 z&6S-L*>1{0$(?u>4t9xUq>JSZHi(+Rr3&v-z+=1QUSFmnzWCUu+uS?;G-I5J=;@{} zi?wIg%T|=#_*mMqr|;42`j@vEsXDqzN3MuAaG2Y*r)YuO-wJGFK}!)G;2J$wpU*$f zsivEDhB6+v%WJRe4W8buuPq-fsIPM=tw}KNdD-ujtj7q}VlT}@7~MIew^OA;Q*Jn9 zWeK(5q>)dA7T3@lCOFk%A@P9)kHvOeozz+5a7;ltO)~`55G=>S&~PU% zXS>;%9B@;+5-K%nKm}M)i>9GRJk(q6)pKBck;r0tZeU#(+*VV52 za@%Xp!W>~=>UN935zW8gN1g22o2oQ~meSrlQv3wR-^hvIy7$n#N~!Ld?wj)=AJpHo z+WaA1xih%%`sq#RNx$?}JhH#n#gi`C+dV1Hj>f>*G{IXHOiHU>&G>FdB!W4v`%$!^ZJN?Rr)OY ze6F905ZopP7)4L1r2C8n^q$X5=v9xYbCeo`?mPbe$;-C@ZlLXrvahHVhvc&gcpFuB z_bMPC8xws0|K~f8%&V94=5sWh{#Re>w<#YLx%|>5XIYJui}-p)JCxU#B|L1ZJIU!o z>mx1_FXSa7H@?HA>|_p@_@SH;#e%kVUmjg6S3^%$Q#+?eKB>l@L62|Idb7;kzQvKF zY$>vwwlU2shS*ZE|J@WwMEV`zWw?XgvP^Ik8$q#bv7D z6MR`TY4CYFm60>&2f5w@Tqu=gJT*kMbdn?Ai5Gv%%S8r->TP`yJ-dmFrOIWsfhdj` z56@^Pll>4zq2R5mP&Pq{Ss{RiZ@HjR5F&iDdF(>F=uJAtJ*x~>;)+Y%mO*?|_FRsX z$*1HX;hJ5r^VBxhf#W@ZR6bs8djL|%sI)MsDnt-Ha`vT7GO$2xcr}D}PBW*_L*~#GM=oUsP`t_#wu+Z*p6t`ZlKDt8 zQyab#ZWTU)G^RLPHcI^;?JKh}U#Ah9#Sdi_&&x97BxrN_&Qt$WPg6Ump;jDSOOo>G z)MTQ{;j;3gb}d0e^x>Jeasxw~Qzdtw6O$IDks)uCbxVvQrp1e&Jbkr{iil#n=G+59 zDsm=UGTVmMr5l$-lNw*jxBPlW0j)4yv)*~9(g#QJ(0^s%d331vFPx&9B`ax6Qi{c{ zndZ3AE^#IJNx2Q?5_Jlbf}nz=RT?S$dhW!o*{-i%belGUPV+3JF$bAPp5!*(NHa~xr-U3C_>-_79Db)6*h zbfHO(t%3RBhiuZXd44R_E~(!$pFyY|NZX!F%03Iod1e)^@nQVt1EIdVs0Us1MDa+h zt%X|E$V%dp{Mo}x3vY%=mGYXdMW3p&XI2}CU#w+RQ(Ic(>n#8Qp%R0(=`wDbdj#qg zcWywoO?7>BH#ax{E{KLrO`Y{_H6}86e4_}G3RyWO4xH3@mlOKNRvfU972meB z{qQ~DJ550HHd8Bdh35czOq^riPOgxA2aA_OVCM30I#`IFu#b*MGDXwirExvr_nI=$ zcKJMrp!@&t1e+XwK|I+u|B){Wi(i6x`c;J^Fus5WR{4?DXxXgoi|+%CbRK=j6<~+${1h_KBhZ7q6+jJ2V zYkEJ;G?fC*IH|$p{j{ERh_f>9$vjZU8~)ZShJrgGoX6{e!)Hpo+y(#E*~Xi=-tonLIC74O?$Xr zWy)XY1QaFJrXhz}ED3piwfW*nTSe{dgNyer22e|);Ix5)w(qP2;P2)&vts@?^x6}l zu7aP}U=~kM-laF14&oZ&fxD5ceTN=XGZ=Nz#&G;IFI?UwQZMrjlZO=ZO*eHed`M`u2V|r46qX4Q(P4m?Xy~}M*zL_v2P;y>J^CAc%g|~F2f!%_ zCI!vio``w-KjMcun2+E3qF4ydKs{hVmn({ zT5PzID?w!}r1TDFz0($OO?~oNhF3%u*eygcf@TKwl-|e%T_GQb-05)KOVwXu2xipSV1S4LO9o#+KgAqeY}ZwP5Ai_LKmq%gtC!B8JN{PKcm-9eYk%V=&J#>rIX` z-AL&k`iOJFAn3h@Kq0|Urzw#c89m zUhWKxI6_V?Wbxs}fJd;n1}VZvMp*)tX<^Qo2xnYm$fr4emGA#=Bm`oDS z78n?^WzQW%Gt({GEsr`=&FWGk80Olll+q~-nw?X}d})oKTpg7XFo8tRtdwKG_LX+;lnzhJnUD9i+bNYO z)@mt)g|EhKG94m;$ScmiCX^GW`%&mT#{1r%Z?LwS8prCjx<~AS+l)cPZ5icspfn=N zr_QP9)otevtPDmE*NB0bMNw+h5>23EtqVwL+QZ+KonJoqvXO|pDS6Te|HT<|*DKDA zYjWzJu-X3T|J}?yknVNdmxobR6e+LqU22^@LG#f_fUVtei)3+U?P638{gC&$q?<{r%mXMj& zX&8XV5UFinzOuz__z{dSTo_q92gA@UIYfE_c(@j25hmpK@8L}t<#8SGtOSFtG6zUK zYqTJ#K~7;3jz0d}>BcsX0ftH>V@Pb0kgyrKvl0+ul@nxGjGX$8|2wtu>|jHjqj6^B ziX%A$IW+i~9taI#5ce$1Rc!wCQ0^s{aIpY}4UmF})Kl&9R;`yzzOrvF=YmC|4&jKc z2ZCqE$ZiOrJ3w^XmBr-VeJ)>iD9*TyglcTn%&!~-Q>9uq{~5-5CCxLo>v=LbD>W|prx_MOYk#@0gks|(e?)5nH4lHV?<_08fu`+a1hrq!DtWL zoX;JEoVVI$GVbSIL{QP3TRRA&n*Dt#OLYoEwDGy)(0wH{R(og)nix|Dif}Q88Nnt3 zPY?;6c$sxWvxw}ez15(iB%mO?u{q1off2J;|}p6 z2x*%G;muW$94mvutF$5R3Sj|p56&PQRJhh6#ST+-GGkR$pUpAGC>mQ>+refT>cbA; zow%{cexteIlHzi2_5?a9QxMBq&o#DMWM){Xr{*KG(!T1W%+M(iSdt1zs9PEvXD7_$ z2yr#p_NlNehsD?mpfdJJ0`f!!!N*DqbBNYyC<(?`RiVv@3=j-8@mUK5ZN{>|c0o)7 zkl=3IP^Haq$$dYMSHS^M@Px+VK!p*W1UJrWC`eMK&BtVjHW;i45?>RT26Mo|t)>DI z2P_yq$Lu}w*|A9Jj9Y0C;?`V6jRDN!>|~Z{FiAm&b2=wuKBB`0(uz6_K~S&= zJYfPP9;ZWHL5eQ_M z;b=v`o`7{pi}>J>FH+gutzPdL!YgM&lnAcMgQ_w`)rN`Q5Mr!Vv~9as>)bK)ND7q( zDGK*l1P84L8S`=}6?%D9e>Mr51Wf`afs?>VU~}ChSF%Cdi^8bNF(fkvh>XCIQ)prK z93=ygY5>ygY5>yga5>^sa z5>yga5>^sz5;h5&giS&xp(Okg)&zLMngCB&li*2f5%#x6jppvkYut{(vxCH&-o$x3AB%6dy zf+oQm?#e5pp27;s2~kN0SPt=E=59b8KMyMO@>7QX9aNBNv`l#rba9X**lsKuKy}WW zm5W2fyS-!79N*$jk7l3ir`rS0pk zmH@N7Gv?3qFESw^If7^i-Z?2((f!li?@s$&_kHbeFE4F<@DDxOY3kCyee!93_tKw^ z`w#xww;#a$Bd<>Tt^WL{Zh!CTd!m2GZlzo6{KxsO`iGWJ;2-z*(#QY5_HW)_e(%Lk z{n>l}vR}aZYpZ(r)aei2nNGrgV^K%F^mfSf|B+06_Eg<~DL~oO4BC;dZNKC*4??q% z{eEfL=l%EKueGB)%KaPh-fC3%GtGaH`}?E)JF2aI$gVsY=Qa8EO?_<7KEn0&w`0wE z@~iD=?1z8rn`r3i>NWLleV=AlKk$yeKQ`%R5JlLCjtVXbFk>8U1c9S#+{3x{QBG5^ z)0FeMO`#0-D9zNhmCG@}KS!xZSVg6Ls`JUYbQ=BiQ@pyX-^pR*V(pTcX#tt3Ju(tb z=G#t|qPi{J6E&F%9_y_Ta&kzRl4mN$mMOGwQlLUj^B5h~D|G1jG@AMyx@}GahX!U8 zW*QUHXxFl>Bak*WwA~gNEviNP>W&`{eg3ZOP}0L$SlziIowC#Ml>MZVysRnCWaw=z zwMz=c|CcVAKkv?xtHkd*X~yIZV!O%#fa)(F*c=}reUeX2h#Ln18^&k9e}*786|Yl zHEoDe*QUA2fw7I?b`jgtL!sOnom8BLX~j|R5W`I<0t*Q?=bf${mv}PC}^WnXZy>%Ba|oZ-e8PrUH)8 zPWHF~VVS%=L7_1{sHuv0Y80^UVwV~?dte@WOO!=|-`rplVrch@MLDKmN@I-{SB{p} z;=l|$`?m#}POqC&g0V@HRDFpGk^4n0o>?(X&s_l@Q9%)KZ}WvhyH%{z2xj9Au1LNS zRJ&4>YfX!RLj(0A{O+{7&>$62<$K*BY7|~aDZUEJZRT`}f5vXUFdde2ws|JR=aj<> z*;l1`+F>?qol2oPT}HU2mu-hOoDQWl0M}JnOf_j*L@8d%@=enh)rV7^WxKO`Ru|T5 znvUlE@te=Zv70)E@&J$Nn%iMaXR*|)_FT>^ zqj~@zFR2>QB=OusI}sN;1$J1=S+9v6lSWJG&1LefWYfBn(nl#AVk@uiVvhf7`IJHm&WD1^`;*ayoY3K3AV#1|bqWoisq>M_ks z*)vj&X)KUcA%TYQ+b)-P0$}7C!~DAYN!FBUMH;cX&sHuSFY$`nk52g{F?#xApPxr8 zVxZk$XQm;oUKOUCSJaHAvN2MhWhRu$5%cIMHFU0k2L4SQ~>7zC3y@?rwec6$ErcuA&L@ zz+?4EJ#fy%cP^pl3ddy<6>pR|p8?xgEa_i#tXt#8<>*Kk| zw(EF=nuASkcT8VdbvI>^*TPUfJ5PtLQ)on~S&(@VM)nh4CK}~i>@=FQq_LqrU z1RkC=^^V;U5NmLyD1B<#XM*v!#&dOo1XXK!9o0>3^UW5y^;-HJdZu1CmYM-}hJ`FM zUIS-xx*qbc5+olwd1tNwgmfC|gLmxRd;YO|DHHn*g9$sU#O=&_@!QcI_=Wh4FpP_Y z_@0q%j>3panR11DHY{=q z1{!~kZ#7S@nt{hOr`GpLkbbzoFNV+^ROzVmBc@ABr$;jFrC-*i;l=I=j+OPgWV4l6 z<9ge2_EjsPE!QI-SA1aIwLEjg3*?csF=V=@#oHGNlxalrgLp-R%hL#omAeyD7FjI0 z28|Hr#9t+me5X=R^J}YYOJO6`?%UtyI1plaayG?dvd`>Iy>(@^7P2?oAQ)$CcjNEM zoh71)`p|oL=tQ3)8{#r>gjh>0gD3X1b8a-9#meXm8$+dq5Quw>Cz?*e+ChA9LSeDs z)8yE~z})dwRvblB8}Kg|)>klMOIF+27Op-skM*S$ya2=F}uKBlR0J#REruKXUaiejP69c~;2eaW4gvJ>OIPu9CQn{1sOa8yUea zQ(2)L$MALKMxHzyA=Nv+Z>X$fw;eBWsb|~gtB~#5-m+R227oi9J9O&Bu4am9YTq~= zZ8U?Us#?KDmS--zNF3IrH z?ECr`UIV_ilc$Ot@7JyNd$RRu*wsb(>}_Oh4Ei8k8ja4i*qEtn%D(HvJ!)XGP^3K} z|5J{wWbvpA3fJ>Zn{!)@ELNNzsLimOYp*Kw4p30bE_}jU@5a~+|G=?U zOso(V)vFw6wJnt)vG^(QbHokweRI@9E-U}X7H4W2KLF; zId~Ozw`$_TvaP|39TEBoz2bFPHaBMwl;m7<>3h9&4g_mPFfiagh9Sl zkqu7CN9Z{e;LpE8$w-kqevM1wS2K>6}PD$>;d&DykxD4?=xo1mE!w2(o{t0af4c zgFeuL6f;8g7KPYtZH}2?-71cT;c2CS@uAB) zIo>=9g>zHt;?l>##o$7keA@oCh#tLY3)?Xj&}Te^AxwQ8Fhq{^VFxl^L%ebr`lSP%5s?jU(6UDtFavW z{9f_M5yt-2PIu zO|ybBm8RDJWpS1?@vvBPgdVn12FsEroAcgPHvrtb-vyg)v~PS z>u%emTmhK|$kUcG3Ssb&>3R3Yp5yvi1}}W$#__nc;^sR$bCS=ELD8-R;r+)P7;VlU z6yUiX(u`SxOUgiPs9b)na)c9>#O!Q>yB7I~JdIuZ$g1$6Du}%`8|urLL#&ppmdDKD z0S+E+p6Yn&>C|RUM~1_iam9~W(bfQu%)3*>f0b09mG=m!|99?6N1KN?y!KUW-66jX zTFUu+pA)cyyN~~46VqJkVbSo?9dI5xw}-)9VCS;M1TmaBNMR5b_3-t(f^WP!aFlxZ zJm{x82eqYRc6z=+0E--Gpm@W2;w1fjI{D*Xy;G-m@WT^ZO*vgAI(%d~$gg7iGD!+1 zW?2U0GuV=cPLnz(v#_wJ*&R}R=IWDzW4(+FTR+jrw)L4zZv4&k6OpOo%m(1%KD6vl9K9Kc=?j>O*nw}SBS1p zoTX%U4JogcIjNX2F*I0j0oD;>^y)|X^E~=C3;oO%yW^@1w#JvsmEtbYN9Z&= zU-A==a7zo*z4CV%=MbB|N!M6jF>c1kvXCH{Tbm88&a@-sKZ$QXQGQ5Ceftq^-YLbD z_GH9)mlf65cCVb~cj_|yma$y8FY{(0GyhbIHRDv?TO?!<2S1RXF=4;D)f=U0c$O0B zZGq-~P4;4xHOZ~E5EjOKW&4gBe66M8AWeK1;8ydc-4KrTdEGlL;rv0zF)Bl{Qum6p8fj!kidM@J1*)in#O?D~S zxWb!`%>9QQf2&_d!&~d}xG#FxG%_%D&dLvj`QFF!IgH6a=b6l}e(G9|oy2S>W<{1Y zE9iUnI^~mDHtnDjoUlQMv16f3F7#vG9-z8c$N9Wgek}9;Y)=-C2E5>d)8991F|KlQ z)#Ys7w5wi@hMtsJ0mr2F`XV>zP zJ1XzL2!Hrn(2TU@=UaHua*9b8jeN&jCY|om%z5GHb^DBrq(7wWkS;SdU5iU>e_xzV zhQi5Ca(d}a9rX?6VUH8xFbe%v0ue^`#RqybWhuU_o-xNKoc<$uOb(fhPJ^$td7mt+ zK)D4^0;$bk^L#Llbn`;n-#(O5$Fuy|8|DVdcggG?yC!OsRzazlEcBdL$b|(IcYu#*U48&I60B3|GQ%Jkj-x`Cwp90=gDA>jW)LxeUQ2(TSP~5 zer43YNuG<9R}Ze6V8J3^_nWwC_HBmI@-ERcms3xfSH@?D`FO3VDcW!YK-P8NC*=d9+$8e0IPp+@_<;X}`PjY>7e1d1rY;>}TjB816V3kip|XXYm8^x9KK$#Eu_4U!(< zYAVBn4TPjPc2V@q?O5C~{86iA;P{5lcz!BZ|2DQy$$4jmUOvDSQB!97r`@ zlZ9kxzQx)l{P~^aj>e&an&Dx9*u+Z`VR;g8A+;n)j7oYw^R#2udd3x$N;J2#8iJ`o zcoj0OAgP5%?3MuT{XYshFDS;rGl3vmE999lu%fmlr&GRO@V^P5=!@dkj85%|D#xSJ zdN#I_?&esJs@&NNk1>}+M<7|9fNR8_LfLukfD)29eY}gW0sw=jPi#$=noa}KA;>~Jvj5-?n*^B+X zs^sNCGQkuhzGM%lkW{EUo`3y4eA4^#_Xg+CeZ7Qx?_aLlZ@-83?4S1t!k_PaCNkoh(91nZ6eI5j zF$t1mXy$??A81*CGqr5tsM4VUvW;B11?9+llAts& zl~WG*UZ{;ETTQ^Z=Xwd4-PZiT@D6f1h3XS{d*!^E>~Pdh(a=iUgcz;Fy#ooGKsg~&mT@%ogEn&lebCCJn%1D! zAUNTdBqJ%c5~v+ew(~0HkWuSi$1^r16MZqQ%MLrqXnHCrn4yb&$mSCIjFtvL*g`Nk zco@)YQ({_-(i9==pf_RJz;Cp#)eww}0HHffv`q@!1F6u03qT?H*FHT2N;IKyQQP## zRmusHF=Aq2t%DZBnt{HxrVEY$+L)Y3Xq2FoikRraP>xZ0^D|3)ew^Nb??>1v07Q`9 z24P%k0P`YCtxDH^MYeKk9cVal(My;TA;w4p35LlPpARw3Q7*90W@G|Q=tSVVWr1A% zHtLyLC$$+s7D?(Gc#bx>JLDL|sZ@bD{RQy6u@-VZlY2hljAnBcc(5%9hex^~e3@rM z3mXmFAQ$Qzw!&il2rOzV-r8ay#lpbMjte`cg?$#hwvcgiJ$Pm_7m2W)U^`JO)*^xu z^`=FT66nZsP>>a(*51u1)b>amn)2z%y#qrt2v+SWM~wTf=*mXif^Xvz%ptl_qfzc!nbec~Ag9 z@jI{}-uJ27vrH|>5Yn6LQ$?-Xn{`&qtV$+`M93}$nPt0FYR5)hDFmKSil>`6lv`Me zaVA$0eh5@aP=avI)Ez+7`np--lu8%lFTm+og>P@}1pC5X*p5luU3sc9)=B(Y@<^be2rfP=`=+KoS2)V*BXsWgL@ z>3rNg_gdcxjX<2_C03q^`a@5|cD}S@CMDfVdMG_K_cRUOD`FqrJ z66cvPN+q@(N3`A>#Iyt86afTUD3UPdcDyyq&d_I-J*Ww;!-~KM4xwp91~Kc^nBYN- z27z(ARi3}#10ihW;nG6FV}*a+V!N$dB}otkjx4~`8oXHuBUl{0#-36j$BWK|-rw0j zY~hg24cwm{M*AMT+$DpP64Xk7bjb4llVU_(g|>2Po!u-(>e|VomIDaV9bKQ6w2XJ> z{6j9j&q;cr#U?go1QH|qBP%(~3mnVIZrY#WeeY=5a|> zW1?h|9yy)Q_MV^<8nspc#??_o0eb>7LB1QSWZS;Ir^*+i#nkSX%I>&CJ^H#DN0Ki z5dj>Tmcw0Vk5GiU&I%&zN-3evK;kkL2!_c@=mi^(R6L2*rsJqhwXshKt*02XMh+uOn%^+GnG;5Y_>SVTm3o(3KzK{JtD z;Nz0?{J)xRLYdS+Du*S&SoV%~#R^ztl^=^%z|=aqS@e`#xTu5RoJV#B~`cX)PZ1Yy@L?lmt zxS2nLafJi}GOVQb;LQRu=bxAVtd>;hlI}IKE%x5VFn&Vx1HmK_50dk1g8f|< zM&_kIYq?<|iwqO5EOsQA6w;$Nd$Fxh;y5t>#UH|c?G`JwY@(JR8ORfZ97}eUK5hs` zq(Ryk7lCY|9KrZPQt_ifD4b!_k4LQ{E>i~eR8ky}qV_PcjgTcpif0m8fZbe5pSz?X z36UTL)eMrkwL}duSiJ-L1PN<(x#g&w!bO=Fawwg(vXN#C;wOxZ*y2vw5A5cP{?HVi zo#w!l6K%H6oKjpAbBQgWOFo}?8&uv+sCxlgM@?D5RxIKXz3&ABGb90J}Ati zPM#(tATro$Dk2@(e&TjAWV13hn#Cvr*9_!MKuA=G@=UlO_9Q?u0vI|b-dCAMd7vcb zBu_?}L?tPbF#V-y&G|XN?pqJyv+d^A5K|flrX1|$>_mM)zK`{qsJrE#C1=t34Ug{( zjGuwPrqdKf6lI0E6gVyIO6c+K__QQY$N{h&wMf=XgFp+cyz<9-kkh%UKU9K{Cq)B5 z>_&KlLm9pZ!Dh=dD8J5ENY2Imxgbo$g{rSUCjcD0X_d5CW1uwLJ>)usvknC9%8wnYZ3M!vWhFPl414 z+BpXm>A#NI8ey%5#m_11jWAWWP}4ARfzRPlwFoNEQ6PV3CSo%+j<=G&g|1HH?luXMxF(7s)4VM#@#fiej;VV%0eujNXj(c|&*ickZ4c z=3elx&fvKe|8EJMf)OYY+#EY@f}YgD_&;s1sNOUGx9srk(b{ud3`bBrP!R~cC`0e& z5@8{@>0j4X`zHrHzvdZ`MC)L=>~XOZew;i7acdtb#YWj${aOxk{9*_(*H7Y!wlWEG z&1c!HK8ATld0Fj=6Oi1$h}w*`TUn5yq?mg*xEUDK+SYMH<>;Z5Ye-Troyis#2p}>a zWb7a30J5eNs#c*i$k(9C!7_*n$V`G;ha`}SdiW)F=J$A6T81&m2;g`Uh)Rp^iAW`w zOgurKhlfA^*~TQ>%dC#?U4y$-*{TS9CTvMuOs&NUq&fs<)Y%Dn$a~H)uH1*#*tuwG z=q#AO!Uobv2X{?!bn@5OrWv})IQV$dsE`? z@oYMdHWiq1NErYlMoTm-2%E$iT@0S3PNN?s|0HCzs?cjG#cGKLNUONy7(l_uLoVi?)2J24Z6UFYn~=2kc&rDR%YoPQq8_qs ztYj%)O(Z!6hCKaNIay6D`;P#q5D)?Y1OPNc1TX+lUR7SHg#c1r``769uqtGZa?Ht` zBq7qq5J27CBIhP$iSbI}{qBGN1j-En6;YTG0RTHdW(W*a5YAWbHi0d?3$Ma&@YX893bbjEOO!lbp7W#)KHs#NOVT$Iyt~<~aPBA9GbJF#001)sMl%Lr&0rwOku<713mOy=?*UmmKr4Bl*mZ8xW3Xg{%d$Wl z5Q`eX4f*%Ix^;p^O9cP_xc{(sM<0FYeYdoa-XA&oxw(G%Zl11=W|m`D{^-;Ho%Vh9 z`q0fD<5%6ed)WT1FNr1YCL}(q@4tS1vG+gr<+`M-RyoAvI_wNVY>6Bb@bC(sQ*?Ow zn_WBXGg#OD@UTDoN|wJA{*i~4{iV$OPrd%%(B~}wPoFnCzrudbdxw4a$*cDjwPRF!l<6TEW&WEl`q=Ujl;;#ya?sua-vK!7lf!c21Iy`6d~ z*2O*hwcl#(!|m+59eZZq_O)9>_SgIUn*H+Uh0kZrVKy7>C>Ebu6VsSF3lHlImm)z; zf_K*btW*to*r?f=%+Z<3={im1juG0)1k9S;l?-XmJ@;rSL42-rAg!H-zf0*;EbgY& zHh7wC2U$J+Jm|wTA}T1-l@8`LczWSr<1%kG7l?U?^E732@MB@&iCRW8vP}-U7|z2I zV{Nulc(=_w)X&V$bM>V&b6f!}=$WUiGM)M{JZ8Lk%T6gC=!(0h4!e2AOR zMrrXxXXi(DFB^G2T8ZB#I*fbf9FCoVB5ZQ&CB+uR6(R(K&So_3Fz64`>FRK5WI`FJ znB8W!@J#Az`Bb~JApLx-jP@9*^)e>l){E5C_qq0EXRdaSg>w?YvL;0{pexkT?agrJ zI$6eMQYoq|P0|Z!ahCwt_(SkbkYoC_ygk;gTyBJ`HLBN>DY9oa1s`sAKUE0OZ#K%l{9|C*(8Cr4ev(}H&3sz3|UQL#|~dN>QDCNQhO`1Gk{Sbb6GMY z+y~LQxC5_`%vtg#MOWtPX=&)@%4g=tlN?IARFV^t?>Bgk1y`#!K+UU7vBi94dKpFbVd>Ut>o-j__gb$x6xak! z=_D^fG7TBb_PVek9(%b|nd+s9CW6PD^>lt`R9lb-mUGi!vDa6($c@Tcr5I?GO=RM^ z?uu`Ae!R*bO)Wo|a#+PxI1}@oQEi=`Y5G7SUQ2mFZNX(!U3^cEdMl0)%%sZVZK7o= z2`&~R%Av?PxtSnmyn1F)>*zw+do)1{U0#CD&8?c8L%5oL^Pt9Ieml4*XgWIEnSsoB z@OvNyAYnQ|%VL+FM0m~i<16XyK=DJzxeHX^V`#8*n&0*_S(7G1{DS%e$^fq!xN@G`$vGS5gtf7g`yYJ+Pl6LXVJB2!2y3~C z;r0fKgR^gK)ztCq+(1O6%eJn9>1_NE>@!j}>jKt|kk=oB`f(zQ&Q=v%VEGK77OJ}t!;wnj6 zgri<^c3Q3xdcrLp+w!P{Ib-R{-&p*1pJTr_p_kd8 z#rJ3L3611Ug70bNbL<~ztqIOOv89ZL$frA4cPHsH{Jc-U7=fBpVPOeZ4}E+MnT5zo7*D)?yf1isBgQw%Bbnw;uoUCHjIRjC(VTd65}PS{Ps|24Q4FUn3S~z zQb-Ld{NV#$6bSQQIpO~kH^|M$7!ouc$-qA@-a?x~qN7pr7wUX8ttA<}h|dk}-yQ;? zlTK%|6A1^fB$8I@%ft%C0Jasm?@J;L$6M;n{iJh1QRn7I@mRmru z8tp1v8Pjmjv8kd*ac&e16S#83oW0Jg5}CB&VNwLJrr}|rF}D%Dey^RDIB)V?E%j9? z#-f(KTn)eFHv&ytjE75X6>z2B|0U@w%IhEUF#t-U3{Z$$X!?eB+_6~-3Men3cQrea zy8&&VoFb(0vjwo_=>$#%CCb%OSbZW)bT)IhBT~ z^tLR46-u#9A8${JM^E~(GJ`6WX!4=k??!)|G>{1#CH5k^Q`J{w?!Lmm5|>p4?LfVC z2~DcjT`Ti~f%#qe1?EI}d^P7t`e(YD`Wc$?w*CRiZHaE|l%cr-f}DxlZN(9U(1f?N z?9t8fQCUQ%d1CJ>=h)IlNLs_%C}aFo#X;MfYo#Pt<0WU`%ARDNoqHt>o49?S*zKFM zThQRUS|yG00ouDu+dH;kSNPb?+PCMeyf4D<|5YX6oHv+l5OC*9@Y%HjDo*Wkm8Bqh z$|Xyg3BU>Xyhh=usu*cWB}e3z39W&!ziCdf21zU8lHY2fnR}Vql(IDFR{n_ML@jmM zk$DuN!ZNJDxNm}f-|pTCUY4F#rKeBh(GSf3Qwx4LI)vW7E81;;_GO0JIM9e6 z>7o%w*gj*~gA+I4sra0~f2S|$=Il&fq*Xwp0^n@hu2Sd7$GY{C=KStv=uvex&H4K6 z2wX$QK{=MMO|;RupDx7D>V>|%D9g@^YH=TP79PL;>)j7b=LQW@^ z*1&k*pW^JCO1b)9gRXWDB}kQ^sdUc;QF+8!AH2MUZ7~czQ@>AF1XJw~B=UxUxSbv* zUk=H>^I-4+55x!;x5=QgY)NOPfY7G zbK-CgLiXs~P7@8&B_n4sQ09`@!TuLY0M5cEzHdDpI7y`Vw4tfsrKM?9iIU{Iyp60< z?$(w_fB6L<`{#w-=*ML0FJ8pOwMS zweje^DT^4NQDd%(vwjHSar{{q4Ls}}Sp>y^1f z#;Kf>w;T!>rRgKG%A!E}23{7&3BL`t1Sd0E`E{zwGEn9;pBH?WllLiit1-}jZE?%l z6%)sso9!}8-{?P>GM?0%+cjA1!ofg#R|NzQj^t!jO!>)WjY`-ExyXqkjj5m;Xe}Br1JS@zn|8CnDNFYVxQ<@fMc^-qqiU9^UP3EgV-=DnC z^Y1%zW_TtJrsF7R^J5I4L~mv3+_k97Tc|(cCW{JHKXEl?@L9CF`?5+M&S6B2ZLSdE z@E4gMsi*0cwr_d*jh*3ih&QH2OLO7-WWWnw&`IJ{^_FtWoPGV=TVIJQbHI=E2SfSB z3O$>hqS%tcFBQzdrAK(4MjTeqymX4-|t%j9r_&;XQp9&C_ ztF%kk_i*OhmqxxGUJXPbH>A)nec~=_2~Ey`&|RNiK{)_3Z_${%5$n7$&ZI+1TKn_v ziszayW|a2rl>3}n2*wARm=7<_nUsj1*ZxOqF~{bfrnvq&V(YvO@=x2>*k!roGcgGH z`48vL$;oZ{c;?qEehacp>6Ny53Tmv z-eLUpsypIC=qC6k;C!Pp(M5?156piN`*7gT8Z*<Z!f8a( zrMP!F&+lMCRU0a@_&|ai=`hBx946RxZ}x%{S654^1{)5WAZK-3s-=V5^mht_R(Q~+ z&&G_6qWGH2#{z8LmLym$smR&<2xbxi?D;E|u<2++hG$~0q>Rt`@!oZws-=9=`f?sk z-Re-?`RPeeFKsqG5#0c<)vAh&U9ZfRH^jN?9lZFd28UiWcfTd5dox&1NAWEO;x?RI zWP2?0bkBt<5M*y4C zB$WaEzz=mYrlrxcQJHE=7o*@RzXN+6iK5#no4zZfHI9$$JYi#*0`LPQ2l3Q>DC8JZ zi}fK$eAnkIZva#%(i*Vr&G(zqQijMFi<)9$X0Ckvus=D0uK6o zHNTGhq%yqu6XG3jbx;%aYjCnl-N-`s(~ZDGs&$4x`dRE2#xi!{;gz%F=t4hFTfMq9*EfBi*0{%*l1h?jjfBd`xdZoZD*kqy}C z(7bx^Z8Q0}NsZ&Av>Dpfe5=LpZ5?f<<2aX7i(SE}aiZK!PcYKt>g;xOc{+Bnu^D6e zGz;ajv-0v3AbEL+4U0tc#H|>MZVysB<=MPx4Iy@Eepw@@>?s&i-EEBFAc|?rhATg` z=LYGQfMeI!wrb@`d20-!5(^lZ%lc&swV5b3wkRQbkju}cT3Uqf17VDr)N5oG2y(sX zUFi00`2&K@bG7p%ld!dK&pUvz8V%C%3R6dvgq)0GL9dNKYia7e*+!Py2%-)tv*1u| z?<|}(iFz$I$Xu(m*u15D-%_R+6bR!frvv$##4KJj>IIqtmeyFSK*VW@MNF=(3G*^I z8mIzzUIjmbtae&tY|`Sfsr3_4%%m7f>q-tmoM^G7)KhaxEv=(g^`onW4k@*kSx^NL zTsR>A?yRnTB0G25xQWGLW8g%CTFBxaRST@;2n+@XTtjKSwrYbfqD+Gop%NesExA~6 zQJ`1MkafOAMeeq|8p{yZQKj?$0fb{>&Y=ZSYe`fV#_^K5(tEXRe}ERh4LBVIt*x!V zet1_mdewMBGHktPnUoQM`2{iSWuz=px6S(%h>d9uiu!dI-K9l=R6_8zR8R-PYb1yZ z)f}-3ibEVKVw6m}%*8~5XdEJ#6{8&snWvUuY@|U?{g>SQv6;r#t__nyP4n#dtp=RLBvU@LdcPU zmSA}+bt0Fi{coSiT(XDwPFyU7h_9qHSg=8m!>j%lt}Z#Uv}UloL=`E<^U%f}Y+(iV z8dF)34#n(M%p&NE&Fi30!jvyBxS6l06*w}{?%~)6I5SePPRl9}b>cw)T}0k|j920a zczmc@@ZK_v;xFQ`auW{~c2XzGz8Fw2Q6XylSrExfmKV5Pq(oFx9Q9DiSb^nwrBI5H zfJ|M;YCB!`Ljc5K@F(1BOEuVg5yJNgIR~|{#?%$`)+5iCff3>gPYl8Wr@v7i<~A-9XD5)J5`*canU>B7?BB&V<e>O(pq@ef?oNR z>X0}sbG5OqZyi!K#fnVMF+x^@it&4eR8N2bcR?2(d|5g6P>QAV2pLnM+R$2|5?}5y zM+GB{YAvkmeODTmBPIyOU@Sa!00H8&5#rShE zu^3LhfeKM)KA69>#hh5ntvVs?_2A{8 z8iFvyWE$9{WKEO*_)B>^Q(wFzs5%mE3C zs}yq~!yoQ1w!%zRhWd~sgE&M`BOI^@drF2=KD6_LW;WmJipf${i$x0*PAa9E!XcFM zV9jntPg~oB_8!^%s6t`^DzWz7iJVAdfphm2X6wz{9eB*vbe;dH+Q=y;S!oAZ$GH(& zKw)x)2Gz_VQEy#}x|~hvmoG~5_yWR38O9W?1i_9m9aIErLIzL0>$w#Fhr%7RyIAhL zu?l#eM8$eppdQy80t|XE238zH^SD`sYi40c_VzV&wUAIH+*>?%R9g{iVa`^RPcaGN zNhz;4?5%6}s&c%Kf(#@S7K?#|6~#N70u^))PjCHK<}UJglT1lhFS_=R`gvb!gQ!618ULW*Z4(mS<6VW{|6 zOo6XFJ7V}R4Bvafgc6ou@ex`hd@T?jt#T?m0u!kaiVV*`;RE~Le;n`*S{SZ~fG7kJ zJ{60lYgZcNFwPx=9q|1WnRmfA>(uw8-jVt}hfp^Lc`l)@r&>X6G*@=0s!RQ&mJ zF!{I&Nj!O7vIvQZG6t9cv|jwiZr18d%Ds_&-tI(AM8wfa6|qxA^&;RQw$nro%mH8P zxp07b*T3Y~`uhI=Cuc_^>DR?35GgCFwwonq4FMR1gS9_euGY)u8aW=ikfb%AED50y z7>JNOkddUeOOJGxt;1|v1eIO-Kh3?2mmr$U%Jln!@;B-1 zhapT;7N#T+Q(%C>jmXM`v6agrTG!Vf9YQTFDGi7r7gVeSAfj;#r^*hdR9tP8I{DBsEBR_;A+;_(A(s?iAg9{%qxoAIp`fh9Sw9%5Nf%XTkivr(X@de<{Sk; zQRUaVox@O=WX+M}`3Of*X&VD0s}Y!6!juK9JT>{2-g5d&x%N;bLkz4fPdUW}a!eFe zCz*j3htw8&cKzmIvb2;$meqPLWStyHQc|+~YWxHc8ANQ$me*bK?3~uFJ-R8?kRhy- z&j5pfLvLh`m;u3RRT`|J6$m6MbXsRQ4=J?N z@K2jno1^NVd*$NkfpZa6l8L3lE9XXH8UY%1dJxLmV43cp-VlpOW+JGbChpDJwFN>6 zVd4dZ!^u{fQl*bQ4JDtMin0oVy`+|P068hv@9oy9QVcNW7<_+Hnmv)!y#iwi1KkB0 z89}rdA8bS@J;*IZ+w0ih>JR1UH&-FD3OkACL?Dcch`1sUE!HAM^Pu&jf5%s6Q!|{? zuHLPO94C~9fU7Jn4q~xl6iMnuPI-~ipq=f$dz5~X=j!g)}N7gsq6AMLo_^LbR?0#tLF7hLmuT zJW$IIxov^}W%=+x4niM>!Q*p3dp~U2I*uT=rS>}!@?KcPx0;(Ej|N|%Q!1OCZK0p1bS|#}lYzI; zG{)N)7DckkCZW?ya2V5C0dy3i>E`ljaLhxQ%0T8 zti1l*hglM2J)?YRrA8`buutJ?3Lc~|!py_^2bJjM^memzB{cvtK}CBpD3(05LBvK5 z23UMAW{;Fbs06b^*_*%j?CK9mo^p$A*hj6Tp(5gPo>k_u3cyd$;&H6xNYBgIX>F*6@<+DhObuLEEh@D8?1brN{qD7cBurUf&?zOQmtdM zt4_nu;rzYy%<1*be|KcC>tSec6d;&F)WCooKtkC(5AuBEyU9ODGyUCtnt+(o0!Wc_ zLmpK85l2~sDaP+|B`v4m68o3f=6}Rd4Zt8WMH~MwGu8_t)coYva6kXEyZ@FEp3f~r zL#M^cXf?i25(L7c{P^7v)LHZcz_7oPpQ(Sf8`F`q+;N<>tnJuZW+c?n)~82GOgSq! z$&Z))zo)6|y>x-*pHguN=i7#a*$V0TL!>R*=k z7Zx`+30UVEdnJMlR>}@4Tgd(;+0fW|ULdA^M+4E^rsKO6IE>5*WG>MSRUb$xYDGb4 zW_#giTvVXl_&(2Gu=u)YSFk3=q<|NU;rEILhrx2K|2?4HpFX?zT6v~^!0vRW!cLDE z!4pD=B--r+wVALB!5@YG{cgTOiY|x&Tyrp&uZ&7Hi!~({5{r1@UUj4Q)jzwr20bYj zbnA0W-ifKmN5BAAS{k924<0=&UJXlx^^}fF@wx_!LWpv>EhZ32HWjV8SHUX`(!lMb zPE9~cW4TTBj9M|(gUp73i%k&_zyhi66*l?&?o*zI!M-s8*qGy;!edb`Vhk&x$Ws{P z4LP;{)7$UYjRoP1t20D`u9Z$XjsE8%P|=Qig4tN4E~)5qwJ)2S3Xm7UqjYnbL-%>Ki#OdG6DgNaIa&;;#aButPgV zz+WQl#RXgjA(0W1zFz}>j7YBczAK5l-kC+R#ic4`t%*a-#Ev^9JR%f(dz>^Pi0#%> zry+)Fv6hf&0z#vt5&!@IGXOO+0B~eCR6V@T4R{b+ zKM61MFfed&1wLv0F#;PEB|=n{61OX>f1(D_jFqH1+mQptd57V9gz91CkXFMJX&0nX z7Z}Zf)a9#H%Mfpi*%gMB$1jng;X|}^t-r7Os@D?j%gBlJ zbHxo9;8G+xrNV@25R)cGmT=#Wazr(U^v-%gc5m@CWXC57+XxOlAN1( zVj5A<9fZUVO&X5UN*HF1iKQGFt+e(*%CA)AZU$S$C0Fp+%tDu*Mq|ZnBtJwIvP_uz{DJn?95v_(~tlE!@`2##spz+9tvnJ;m03o%YthtAZS_9NzFf`7o^ucDH z$7CZ6*#iY6=)@xdmWYj9v4emjcA<755h;h@KIuVxV{|u$5*64mOP99NId;tRXKf*2 zlVpVzt#RuTk&H95xuLvgMBy6gk#+%&q9o{LB~cJtRWlI+g)1)yPqDwyrzaGhbBjaV zk)Q@#E2hqNQl(g)S+(a7JcjcU``|qcyQi=oC7!XLuwvl=SbPYv(UNFcH>RZ5e`6mX z;Ugb2u_K6`{lg>EUtizU>eB%clKb38I|sGnoeqH*)yhHXE#1m8SdVgF8laS1GG_@| z4id0fAuZQOV;&x0ay^bF{wA3Y+s3m+95R19oMIr3XJ2eUHdUv?DLx1un)!^0bhpYJ z2rg)ZF{Y z9C=b-awo2wYQt5`>=yKEF-JLyuN;(Vsd`{W%re20ZA>5AzB^YwQJnI+5CK@Il58N6 zu>sU9w4W!jM3|Y`mn$C6+0#6IrjLH*nnrEWm_nK`P{vY;SzhgT)J3H9R6$17WzeWm z)bAT}ZLj^siC<;iC{Y<+DXBaG;2 zITD9M?hqoF(jbeQywp;s6ApA!fE$hn5sdAf&_>Adm!3{5c8~-&klvAJ_Ts0_2DaqC zV0~v~S%1?$nuzLwN+BAsj}9QX8s0m(@1(-<)BY0GKI}$@nnoH~NGLQSr>|}%)6!JQ z-e_JSagSL48KaS80U;Bcm}4&?Rz@}(^j)aU25#$h8HBHb-|bFs`H<4LPf81-A~S6# z+R*e~fjvTrSts1C2*?X-f@QQn+Y}tQMs3dJd_1q5i53!vk;02yN`*?zPs7rRUOhEj ze_WZ{et3>O#1u2iKtgd0nG&HNm|zK#nghtZ+UzXR$36hK%)T8th%D&N&{p!K4eXtp zMzRVns3nZzv7@Wb05{ncopr1XXpdzk6hxP2C{dD(K?sU9reUO9`HJefHbkomm9?3K z$8)m;eOTNBHGRpE9WK*ED7H(+geBm$`L$)Fq{eHyT$h*TbFAiOR|Y+2US{=#YzsX; zqNnchPlpuOQW3zH*Hka3>#wft4N#$%QUlV)&_ zUpwErKlQk65bin3B9|bfHpz9_*YcMylAOf_Mw&?XQ8+8@^p}0tI}B!K1~9Tz$8wR_ z!DXl6PO(;R`i6;|?rwV-QT)Nt4iU6MO&juAGV>aR6qO|naK$MB=Fu;UTQPcv2~Ts@ zk@?TXi}(-^vWWNC**|rT+a#ztV!dZ{l8k#scxAHAv#>>Wtxlzs;?ghLuT39@>ejvV zi+5x4Z#3*IGA$uQ6`e4pn}X8-Rn7`+OC^IX+0mbm7X(!ndWT2uZ3m*8`Ml8Sj?;uo zuf`p=zFtj)>6dU>-2I3>q}XM8oDe$3Y%FS(%pKivPMO8EI1&IOHNu71%fy>R@Sl_@ zUQ5oUn$}ts#lj5##ZFYU*FYjY^dWe@nzgfOabnx0jI5GJaJLJ#LJN8X96KariSLm}$=$}0T zmeTE>#;}9O$LFSl@Q0xsw+s8z>=ZD!py(E zgQ0_k8-Jva&_IEtG??_ML5cP40qS5Tt3^aZ(j$|9#m&c!DVF-HGf)*-xMA4NJ1iD_!tCI}u^+<{0RZoHX zIcsS{*d*ATVV36XTrt4yN6{=w7z~izW-3R5?h+Txxc0I`HMqkxqfPzk4bYlB9#r=w zH!?&bspfnuiYEzmJ}tuHdU$i~J%`jPB+H_7K;^UU-Eu=Qv>cV&?6>O5`iw;(IyF_; z&@uXo6*tlpY!Y$&069-A&X02eJuxFOL6VQGbzZZL@)mo{LjPbDY_iYP?kE6S+lRahSoYN`+u8U$m z*s6XRSc7-C_xA$S+X%r`*xzUuKGUwnzB0E62;5;I1LH&pTmcpCgvmWNGV8iX>e#CA4-E*=;fC_@^B{E)2U?$cln+q~P3s zvkYg#H~>?osk8+lyOVb3L1==GF}S0)85X#j-FABe$K~{fR_gZK$<&}v9;P}M z690K)%!##)Am_1-+*KC?8+y6Yq(`E6WJO|%3`KQ*sqgL@n=FaR+pZ200L+p|9G^z` zKec)vQ|bb4Ba^%*lolg18Ex{6UF;XcDcriFyMq~H1(dW@rnYns{{TAsBQBkYZd<^a zUCj?^Y_D5jyQ^6}T(Z+J9U4sRh6+C(dyx*To;MsIl*en=bD*gwXjPGwlzk%MF_y4B z{lTyYnO$;$QCy!uEVf>e1f&T+!7EI__z9<`4>*5e60*F1H};|U(KwF|>z*xXKgJLOA;#*BB&AMS*#{_G4ERas`%H-chu4qJ72H zq6vAg2i(Ps#=iltI;wY?Er);M9}2-~9^oqRzloe|v8-QL*{X^)2hYL4t-uZA3#zBf zdtAo5v*q(W^_jNQ$+~`*rm800tW0n4{|2-h8Y>h3n-h(PKw5YA?AuhZ(t#7GrRRX# zwwRofpG(oQ+CvA=<-I}TM}JW)0C9M-V7P>41{|FHD&Th-NLxwwtEC@2_!lw5mpQ(e zX&qey+P(H{cEN@74>kSLWuQriaOM?tw>u%wkXz+4MA^W}&hGJ(Ms=LoASXhJs_9cG zhG=IseS@q}4r~)=sqM_7!okr{a68N=YK2nmZvBt;=@HdbXWvyYFm3?buur)iCyA?f zI)`$28R7d7F2qi1FwWnveGNcbn*%4aV}bj#(_Px>e*k`ZVI`$!;tAGLdoa@ab2-uq z-~*yr+B@aYzVLjNu@4U5$E;vRDpuiag0V38;a_8SJvLK9R&e^Q7cz;}fd^@-BG@P0ttMUwDJWTU^N^)<;yS6S zxc}}nwnSnya^XQmEZx?KKX``o&deTe$sI>R0lO|725*(XFW0W$p2yIoXcpdbo+7g% zJi5T7eT0%WlL{a&`bqc~w<%>)fK9C5em1 zCuSYft|_;0RTS^W%+T5$@#J26KvwDmrh&)V!8X@kJO8jlI}Qtxq<3JR!1^8h6&K@s z#>P-en>**CU9^nPtA2vE+Z?YU!7!AUoqOwG71EXs;Qky%@{oug?IHbp?sZbhIl6_mg$nEsRk0e`HnIL!Lt~A zr!Psol&bSC*bPm3UD-!qDNv=3x~e-OM3MBaRW=q6+K?T`-f``&u8cu$xxleG>2R~p z5|HLDyaFl+^xQB*Iy~$gTrQ?(l{yJ~0wR}WW+$(<@?Cp_ufAb z{tDQHna_iPNqO4c6(tmyO|hoP9K@D6$TU^Km=*u?p2sJbm&~N@_7h));$KkX;O1ZA zUfxys45S>5RQ-TCx2O^ANcXPeTQjscuML>4XeS0X+aE8Qw>;mqR)Q~NuX=tG-w^9X z)~={-mU^m_l}a)--gg2hJnQWjP~u1{lLFy7mof=w+MU(s*rnT~3;2785(<61n#j4N252vCxk+}?6yMCG zc!a42l)C8~EP!Sb@~~2$y`5g5dTf%QgVdUST)x^K?@s|tk)Y4+i{WXTZ*hL?*Pgi> zkB^|i6?LiGzQO~TBf-9E74>}tadD^!VUtc)q9{$A=Wc(6+CP``P;P|>fX4o+g4`?pXtm|5pJUPx_;gbI&|(3Tg}(u zKJVD}s1v(GDm)EQS!bOFLI&HH+W=nz-vD_65AXt?AaX<==m|bR353Atj6UfJK0pbS z!0DVm$_aUZCr|+{VeaN&JU|o3fYeBR;}btX1RC)8#}EF1ss#_!>?_t61De8gRMAPO ziAUsBeJN1~p=#~QJC~R^aNf@~sfBm`g=kCv_RqCyd-Y5^3-^YQd9{r@T^CwWsVON5 zDdt(3nl;y$-#+E;3w>ofghVpYwhFrOfsa0?bl$G_n9)!G2FX3;KRXE$^7tS{M2JD)jdwiVZE1ZAtJn?QU=x4$&!oKg*hkwX_ zocKPBCvO^nkKFii2Y!Kpjen%dV_$qYuO|9$@b^J81*U$oPa$;$Gm zGP9Q*L-Q0JUis=;1p1ErU3|0ol^AcPL3bNhS8S~7KJ1a}u5jCV`N&Cm!@ShM=syh4 zZ!rmc7N!(fzXDtN`^Y>G95(aI)bpZe(yKv#F_d5F*H~(4{R_qVrVJ0zXT}-SSzSXd z->Ub!FLW?*VKFUMPv<*a-8J_FEge=k98^OMq=tl`hB+7#EzdPBcFha?Ia>+K8hld# z;2;1noVF{iGJ;|SUV4;Dq9Wh7QfGG&vAtsiLHhdHHi&vau(072mPn0-YH4s1rx}}T zjlU}|x>)@yVfKGE-yzteV2o7gg#rUiMUo{AiW9QFOP#1V`>*U=8{3Hf+|D0f>X-Io zfqo9G7F25CflZ~9a{;CZEHRAHT@S=ege1lSn?-LqB5yI9!-+yyrGX4XoHsZIb5aCS z45bSNO@}io_Ld3oXtQ!VQ`5L+KLp+)SCozsJ&S#kCX_(S&8>y3aAxFt%NlPk4CZMl{#F*MEjJ>ll14$L1E_jg|4*b* z{Puf&cAR|J+8jvm{t#LnkKQMtVn1dbM^EdcuC#vBMno#R@|k=mZbqG!Sft{fj13TQ z9kU8b$DXW(VR1ZPW)2M{W6OMaUOxW(zy5wc#_Nt)zL;sE077&}9NO9Md<=@I5f0`- z92|oqv(2v)F6&<&V)po9aJ0m1@tgi=!*G7Ns~uEGo;ppu(pd^!DydFFjkjY&WB}-q zhibK)OAO52NRH)AOdpMQ(WAs2<>+#wT8^V86q-kWik{&p8->czJrWS2hCr_r=+U=K zu7Cm|sD(CSZ+8qDn~*-r?U+X!JEGBvM#~)KO|&#e{wO_*VZkNK6j zurGJWXt~sLEz>El#8PhvjtCxQ;nMWy`1y>)F^nk6V-)}hB#pN=F(f)jQ;NxMZus}EZudvienKK(`fy(YBL(w;>6FV9M?6$zMK&y#_bp)a; z&`7jrsU-J`D5!Kf({Os68~g%`Lazi?qXZNK2;d{CRuC>dgdV9Osq-I}R=P2Mqf%oy zRv{sx5X4jvZ2&zjN~UU#I5oP&7B&tY{#{`RYrCOD)VB(Z541o+jM5rlfiL3%KXEubS%n^l#+8Khx)z|f=V9tVj1lAL&2T(L8cnW$@6lyFw?^m^? zKJ+;?LgoY-l9H5ku6eTS%b3PXI=UyG!{U!>VNP_8M4Vm&zrl(%09%OaU`>ohS@^%A z;{y6Co%4_)>Yajf5y@wi~z_H(2cz=uGXX_l|+3n+S%Yi;#aMSG7 zxUX*D8n#+h1mEB|%XDXr;cUO+h>bY zCz**;TMa$&{`WyPzP(`?9glR|VLlDL#fRRzwQpgx%p|LCAZ|jyj~pIoCa@Qtt)0$3 z_N>1)jElx5u#Eblo;>Ex5RHX|Cp3UzJP~VRkO(6TGf<0%^@GjfE`FO3G75*nxA$j; za9AE#9M9fpEzo1mQJRmXv#38#F)46{?zz;?)6l$gn=mp8hr<2nQS`q@1;?C0)oW@U zlQs|h)rt(JHvh?w(C>}aIO@KGn7iQoFmehzKJvq6j^djZ1ooJ3yPfcPkJLPeVkpzt z>oC+%r?)CZN|B5}AQTVF4;%h1#0E8}idn|(2%Y@_?`aGCw-9^AK^Y&`ZW1;==&wN7B95-N=WH^807>lyPCZ@$JysO98-8fNn9 z$Umz&^YV_q`ZeA9>yZ2Uk=^xcyZP54d-Wl^_E)=oS0n%HLw5e$!hm3dBv5ux4+@}g z6ztI+{6P+iLBWpwfen$sK*3TClgO!rj7hywDI&zF9y^}~4p>xo25LP=8}2RI3J4q5 z(#rL7HBOBbw>w}zYBa_QpqXA<6?8$Wm(HPtsUkqYfQCCCHL809w$4r&#$&XgQD~hW z)(fz<8|j_d#`;U3P)Lz>Fyj|ij)cZ)AhJQK6Ao3FDE8}Bc%N~mC5-*c3k#Rj`_IU< z1n%aU@gJ4SZh_t@rSqr8V6+x%wYOt0$CO#oM1ChWmiz7&H;dN@V;n?il+;=*rD+Cp z)28GeLWx?=-B163^X&Q^hSI3)NJ|5q6M_y1TzAg6#ZaA60&EM5|59SkZZzS!3Luyw za%1OA2Cz44`OypK^~!5e^L*WCh*`*mAoi!+b?3we z&o~H41|)DY0!%JW17K$qge9S1r(Ki=Tx=_AYi_0Vl^RI6f9;XC7=%2P(k12fIo++f zkH4yZ;|^VS899Ca$Ht7#Q+;0BZP%*!-KEb{jNB!$zRz?;??Zz9F!16V#k@#6Qwo{>q)wb6QPdFTXD> zc{XgWp8iLdH@E!G?~RYVpSF`pw%u)+Kab3(l7Sd0> z5DVIFdNO4GrgEy;mfhWdUF3zOztA%l5yx3^+Rs?OCerz0j;aI~O_mNH2{EmM>m5N-2aHLwkMeA|0 zDzcQ#rmj;(VctBX>b7tAYvm?A$dU1y9yQUCi)lg^uXc+DP{YmzQ{UWi z)|u4xnvR|^=@FgPi#$eV_GaSpLFB}|p?Tw!Xf5NSo-s+VJnw=u@3T6$UUh-n)qIWo zkIj{bn^iBPb;CR05UB9$ky@}^5%l@|>g4{@(}EQpTQ~px8`VWFYe%nNm8yBm=iPJ> zZ*PTKZ{E%(Wvf&~Kyo((-@;kBgoF(naiW>Bx5fEEwug_N<}bfA1qW<(0BuPKPUphW zC)TCbEX;^$0JwiCj|Wo6c}tqXT~E{nvQ0D@HCQCc@{_tJIAdDI(L}5dm3XMD3)ey| z_I(Yr4BgjYHi$*CTgI6LGfO8Tq-97o8VFaKb#68F2V?7KdFaZ(;HATAvq1cNMV8bi zlFyVR$NE6@CpL4~UsPu!$?01%2$jf|e77^~&I@5Ys@)$2Q=!&Rn zxWe2MNSm|SI=N`cc9zC?Fcssp(CQ-VE46jh;}J(Uy=e76ape76Wx~7A7tQX7H&}_2 zO19Fq_O!0WjHunvukyXL412vS z<7)q`^~^0S;THQoMozkL3y>W-#Tg1Y%`c2vY_J_Uc)Bd-lra5169WpH@OWFCWKw}8 z(Aj0BMK=;D>5*q`Yr!8-j@cD!MzX7=8HGZ}>>}tn4A;pwBz$bkr$Ffnju#$CC@HEh zf?iXXBVsR7hmDdT2#b%k(Ht*~l{M(qbbF8DB4L#&;NaEzngIxnc%BO?Q3wcCVwcB2 zlw9JC_CleYKTFmH#c+VrtS*5|ieGo9t4F}P<4|%~h)na1oEp-lNy9=?kyfE|B`QMa6?F#@* zgZ2}~>0acJVmzDG<3cP$iqRcW7dV$Vj{4uRD z6yE_i?(6F#pO9r%!V6+^^NC==3^NTT(7~#^ilEV<7l=BRuRxf8X9{H+VafSU(G0%O zt;)@8`sfK0!8&4JQXLrK+0F>y{TTf%ZQ2yx^?9}#Al8`fVl(8FB6>CzJ895LP&s9Gd8(ZP-$PypLdTnpiZR+K^d}!>1+&#cK6#X1G zF=sR@6hDD@cOp}PCL*!+W6>JgXJ^|sM`mtguIfMN10FGz1aHuNo;ib$t9FtJ{E|OBQs`$@CU(+>Y7CxRsq8Ki@;h=|RQV?hA=I z56QUo#pz)|?lEOX%VAe+EBWM@yanMbjdSxG+bwkyI~^Q1 zY9=;%$n4tcXd|BL7&6hJP8+c{+qI7?t&kN*%M4l2C-{%9Titc*sz`zI7lj8!gh_NC zIVa2{)@_K+AYaR6VKsJHZ@x`Eb{&MAq{am0_icAnt}Cs03X_!JWTG>4)uFCI=(Qwc zYiA@~zBZwC1|kVcAcL3zN_j_P^$gd#@iMna`qQPk8zQ#JZvE9pr=$98M$YtooRCnw zfZ_~g3R47vNTfi-P{h#G^T%FVl6zl-ghJ#avTi;VM{Utoxj%kmb=hSp3HuM7gP`%C zFs|LeuD)5)Kl6>sNF;P^qQhW?2G!qiPMu$vFE-If0w3(gB?h3d4MV2@TLUqMA_T<< z6HuiP#1KR#lpF`ep~%0Yc;A@$+BDo%!=O=-HF#fg=q41RA8kuB@nMKP-uim_!Z9gC zn2jp*gl`x!RdNgdK@hyJ+&APEt8YGGeHeyGZds#8N4EFl;aADk)=f419M*uBAj(~z z#ann2C^$ndY_uACH%^Z~4_vFN-LO+ewNm3kcQ+MICP9l9nqbpUQf0SqLo4- zh=j@o?2JohnUO3+dUuNHoSRQ85;NwVZaG(R8Q-SEBPG=SQS{!+{Y1aWI&*nm{aP(c z$cPL#!hyIQh}Onhs}ij{Z4p4udrr+md6+Vc69rV3ZvYl5U5WMQpRBEue5o52lO*jn z4MiFFYCQ{S@hW9YY$)a{4*vuMfco}U&VGgO&z2aXNC~mPn-~gY6a**NbA>uuJU8{S z7u^UOG5bGtYio2&L)S0HNSh^9pcnFXvnPK{%35h_qG*BVQJER%?Oe%MvP6;anWE|2 z7bNPH$xC5gnAqSqVMxy1lH4dz!rbh++tgAyxB|FcbDV9XHzP9sWD!MxcsC9BYY)x} zw8!1tY>93{?*3dAG$;?SAwzz!^N?0iZ;*!dn6V>M6e^mqBZW1%rY%{^uqz(S`O!0< z&y`{f3{s&|Z-}`wgJN)&?#+Gr1Vlb>lhA^8WC6cUfg99-*=MN@SRXjQYa{+U3|p=Z zL<8TK3uI1iO>$7}5-Ije0X5om#5nx(qk`6895luG4OfW=LWRMoJvINunr3_9gB7U= zley;D-cC@b_R>tzYknbUk(;bzSmZN1QtCJ-HelsGM%h-r_RgX#zgsH&!rm2x)f=#z zWKtMDA3YQta93#HTuqq`(FgXd?FvP62Up=*=rONN4@Q&LK74J-f~gMhd6Y67Q@r=m zRa z*;&mp8?AKRCzX_|7$s3XcuO{d&?<9`%&edoMSBoncFhCg~ zSV#|S5cU1(3lgpj(^Tut>2gb*d<<*+?y0UOJOesa^&$ z6vSgpI{)(Zh|UTH#z>HLHu~2%&ycpGgrc@R z9F}FaP#(&{IYOaf09#fVIK`9opn&mVB0{6jUkBY_hY_`4S5z^o#F0!IQF`8)R(J!Q zX2%WLD$IryE)bt1vJE>aUy{Y3l~VYhj&BQA!C_bLkI*!LqpdO0G>Qn8EMdalv6#$U zHTobLCrLO^X^`U*G|*HmAYllN4|30t9y2nQOUJTTC7jVaaR`wWtHGr+T$dG|bTaYC z7~hlXfFap|c0%d^1q-D_(SRz}jfa?o$I@?HB9{D3StBB#^1`>jE-Ap_olRRYxrJVUOd|KV{|DbNi|MKA}q3ABX-t}C! z{l0o_>3s6q-Spz$LWjMswtT#94zAf-%}XRlfh7*X{lRm}89e7al9cVd6dUs?4>jzG zz5DHct6RtRYO{}>^6TfdJ^B0nEw_uR9mXFX<`o)-{LJAM4I~Cw2%vD+BN|R*fMm=y zP=_uJ{sl*;+0GJ-4!4Zwt@t*c$BquMeY5->TO`S>!nB7UCzuKhE|ew>0a#x`MqRuQ z^|T$){i!HW=zHic$%8Q1#DTIw-3=3{b1)R0L$+lC$3K<6@6SA-_NvW5t0pAUMCaHq zX}LHtN0RM%x$GCl2fGw`Coj1l1thv(aMxNn+EwLsd516PaNBoR_+oBP0TkKiz`&b~ zf`rV%hyp=6`m|qe3N%$ca^Vm(ep472>c#!6wH1|vet_;0u|5O|wJ|PoSi7TVT)0P@*9dCPe8n73DSDlRlksV2) z3X5V$#u5C4EP_j4!&NzSkYCxa@_lH_2cCrk&1ollAV@?-juFq9XlkJHh^?q3x`ebK z+vOmCPR>V_oPbQA#K9U}3{#qSk_VfHrB!0apgrjvz)31E+OP?xfXXi?4Jo-)NK_nv zz*W;RhLhc%kNQxc$`oYnA(KLM$Ft;xW4^z^%)^COcBH;nA$cSJRRP;!YN2V(G-}B)J8bOe2sK*5T(7|TOblrX2K2vr6g~^K| za$R30%PIHy&&-KJ%Xwt+FZpf*2|rnjOFg&lL7wATMijhmkmWEW2~OjUGStAh@U)hQ zESm7FgswXaxVbNnM}Sb0e$5)X^@kc?XItG*diH+!c1_GCKRmz9Q*I~+I!TKC@u^yX zeIcwZE|dnvCr%s&KU?Z@21y%~N(o3Z&FGqvCo`P11jk{vib09UCI!D#4;0i)IF*DW z7Qh1_)?y)eFEtrS+B4D$l8)qn0Biw56|-ofQZzF#Nr2{3%*+!pC#NrV#OAYk&Syzo zZlVu)5Q}!EJtYu~Vv>0_!4|KSirCjy8%272X~SMGMZinRFlMbdpI9txmjv#_B{-wXi6|BQSHi^8P=>$ z5BD-sRMm5R*8MsjbnqIko0v?rEWj^wM!t4Of9Bh9oM}J-mP7QHC_VP$E z-F($0?K^+?x~Hf85Ehjs_Vy4VEEC^pB7=XSfH}LqztOi}T>=p5hPM!}80icAhScn^p3^w0zXF{qTWjVSp1O zB0&aeNpZ$Im#ny%z<29P{lmr!u)u;#p=lw|EO2bwmWfY8vd@yivkhNpneZ6LC&{g8 zDFxkn3raSaJG0e}xW2BYSSMzmrgVXOEH!!2m%nhhI zM6D2-#7eP*Xq{sVZzLb4-brS*=Y?(Y`kVlgxuiQCn5w3MC{c=LlKX$5V%?d z*Uuk%O(nazy^iXm4dPJ~j_jx;Hm2{~V0MF|44qMs50mxJQF#P}4+%~|>2B6DbDQ1|oM{GGxdvf^xfQ?5zW?is9uRdne z^lgFWY{_)R>0k2v$x}2WD@stwautf?UbP=g=jkrfIK7|>u`GdyYys8)R7_Wdf}UZy zSe+PgEs2V{MrA@ZlAD)YyH$^;^O}d+n)oBDc{l5y7Ujli?yj7jCG$r^=V|RN+?A#E zm)V_}4K+C~a+90k%n~zsr$?gnwU&m73)b$IASL> z>pM%Ovb^$qW&rX3Y3=_eM*hor1&~+GqZ|cL%)O-(WQQ_pxJr^vP2F1qo$KI6J`!@e z*U~@y{RMgk0Eo1h4+j8v_xBQ{j<5R22+-hw$wvFTx8-0v))LRw9y8fTCzzNgsoO$Y zd2rS0Rmk(Jjmj8LlERcXlF#~vl?=ICU289c@fT(@#CETN^3fCeZ9q-|01yBm1Ct?> z8lVVp3I_t^GGJpn`@-LmfWLMYcq$wjh(=7#Y&g3W3f9)VT?>Iqk4i4ijiw_e@)|KqHY<^#le zNGMpk5GE`FgPTIt{~s@4qzTR_w%mp6p9LI@h!LzBm)O&~L2sJ6_oGAkafY9_mHDkE z!xHc6$Q~cOq&^`pp`fH_d~NMR=leFh$J##kGY7+i|Kmk{mgi$vGsB#f|6ZB-X2tRo zzG7+H^P|$I)c$tH{)PJSwhhnO*FxqdY(YvPQL7Ts&lWQiH+R!bwTMC$C!pr*#N^cC z@YvO&CSX33_()!5y~!15#HRFuv%0&msh8twK5KHkcx-<|>75v}h0!JlG6XFZZ!o^- zR~5}{X7l6X9V4gRnn6?Y)Zj@bVwSKjp^~!UPt{-XX2b#l*3Yb*$+h$8WBX96-y2(J zn;<#oC|57^0779%hr;M%kGY%O%zvIeKk*6Dcy6TCco} zn1toHRIRh6=)5>F(6#{G( z?d>{bI^yW9MK6D!s&oI)kgUugP$9^AvPD~V!6#$LoyyZvCIo*F~Da&dxTIwH>|0%AQ#23Ye)xaLj{{20-JWL zPkGTt9+J%IMA$YaXjRn*cSEQ8dhAE@X3VXTyy{u7MUQemam7MIQf}*+fg3D?T2~9n zLRB=NLY2C(9-$UFdg5GRmG2bbV)knFPEE6SyJ0xR56 z0n4vYT#cCQN8EkK4F(9cRQ7uw){pE0cYmrtQh2nz)2!$I76i{aREFBb5>iABeVttsL z?z|1|mcuX8H+*Ub3Nj@3qQ`n|J9zcA3ptrwIGH8PdLJ7g3=)y{otvE-UtS}q+-MM(kN$8I zIj&%1k+IfNs(T^G`XZ|3DzIl_F)5eP=uz}D*~v>F5N;g%aET~Vkpqpb%#2NpytiDA zoSf+dSrbE*ghMSK>A08TwhRd>`(e0r;)rO==>*nf{bLi&IjCQYF%n{t8-10GqjpoP zBL4yTOYbZooQ$Pw5BDe<6`pV2!8B>XeI@*cN+lS7k^;d|V)eaFB=ADEaYhx#d8x}T zs^2wg?HC5jUP&ROQvxdVl^5oETKe7>QD@rWJis?^)rXF>hMnvdeAl3uDpiAN&}AcK z&GgjjJ3)e(-;^+@(0ZnxkY7Qxxk27!o7)uC>JZFFjfeR2Ti^1U&Spn%RYZyni?R8| z&%K(kzKPl^MgQrA3zRFCzB~U1Q^>Xm4sk(~;Wnw3okR=-N?e_dMU*sfr9wfD(YEHN z%Z-)=XV`GoOd>`aG)erNG`h{x9bc9aVSn)WZVr8lK9M6>(*5{@r?$JK9yTLa#%s$d zHOlG>n*y+N64mvNh0n(%Y^d{~yiHH1gi+F7MLNow*S{Y-s@3;p-Dzznc7m@`9ltXj+Q;ND#J_;PvSmq|C(DgytEXwo zC~!aezm1G84GnKN^Nj8=@QfS45T8gg_$a}UN$TPojXUetclYOWPLJ!`iXT@x8;q2p zN$Mnm!V`NvXBb#AwqJ!3((#wi<1b&R&p=mPbKRq=&z;_?bxB5yhJh)%=clV;qhpEFv z5nL5#qV`Q;Fo&=^%34NCxfpQjj&>)#(zRO87bG{tbAp2hlb>0+jm|yX&b$C@ z1;%ZQ{T&XQ`2a!}(d_JNLItlKvQ(K~@pE{B-_k-jTwlDjy{T_%Jg95oa2(B(FCD}d zhu}uN2qlm1c2mzw)2jW|d9fz$8@*)P!O6j}i!!#^vDqt>Hv}K}>;6a4r<0>9_GuQ> z&3FZNjdb4@f%pJNP({x`=1p}T*6fYtyf?4h8bqT&ZOCk-mna-R-9wL66*pr<#~=!L zg=G@j*1pdpeXuVrO4sp?6+E`>0%^F?Ze`fjGPBnB^u&>o&E|x_cdeWIT=%sP!da5IllbCEd}B zN(N81fJq(i-5F!D0q0y!SwAo&sedA;m$wmfe3I+V|@ z?vkHB8mwN)tZ5lf`#{~;KI86d(cz!!ftjFa={;f=Q8pFXfwYlr;ei+tXMUTT75p{c zy8(K{k9bqo8Z}UI7S;4J{06`L&-hT`Mkq1YTgZxi>;vYeNNleb376e79mvxkL0eBc9;w~-jUp*dNEuGL*@62iLx9wek+snhtA3fuA zYH!b#yydaN%l>yuk<1cp_Z-T}WmkblPei5JBqXlkt0u$`9vE?nqL+ z^-%>rl7#Jt!=04Eo^pM{f3l=0qwN%=_n(*bEBCAUDR$@eh~Ccg-T9gx+eammK@oU+ z1KFI3Ei!))XIA!=K5FsO1w1+}B{!HvN20u<5IpZAmO8&BZy^%wyIiquE>v$zA3`HD3r8~FE&-J($G7k%syylFy@`Kd^JP) z;ALMQ=O4Tpr=VC#1W_}QMA~bHL9zmbP|-gzS?J-r3Ly)-J|A<6!wNI0OXF?(Ic3YD z)Nw(SdCQ4~ry=^QqblES5-fC-Wb7*P?hKumgC$-#iP|lcU|WmlgYf-<9Vl0Qxm-+* zqe|>KyTbt+udrVXf}l@|6iQg!p)7V2H)gF|C$YrOf#vND^m~zy)0$I%j~mec@L1@j zM1n|yBqFsTUfN$$n)IGWng>E6PpNR#aeCe`*9$5N$V*fkJmDCcZyYA-y&+exTOYtx z70)p^UJ6O{T~7Cu#Ha!U&it=Hzx>mQiA8SSN7W0c8y`NT3NP4G_SWvz-)7p~ttN8% zIq|WX+%^%5j~s&veBOLATwWUT509(|hFSdX_s6mRg7@Vbuw%2y2`_Rz3Arn8Ok1dB zG4Ql&QGZD!TGQkqUh|idKIs46P={xK`3QE9bC&Q6;h-|@Ve@WELa-LUF22n!R?|nn zO&b2F3h+9@Acfi=RPM>H9PhnQQ~fFbQD}$#jL&(KY}=TubaP7_nIb>M+3#O3BQLa1 zhoCmr%wHnf19r1QEMng>zUHdh<7{93Rt@bfQhPF$9r`2B&tIY7l?Vv%AZ2ylL%QJb z9>(R@yvwJCrK#LC=XG)~C8c(&#zCJok6kHpmCI}_WXw~J1XS*AL-4uwh&DH9j`GPyX&H28#Fpk9l zhs1^XL~%6>A_9JT5LnD8lU1 zjyqW+k>1Bgu)skIDvG~?G{-r|k*VTsDze1-YOj7RanrqFC^&qY^@*_G8i<2I2@7m47SI@l`-)I?&0_Dq7b*Y!t-0INC@0I6^Yz&B-rt4bh} zGC9%~ajGK{l*`C8g@~X?7cSkFf#BbzqQAaRfvz znp0isF$k!^22#ziR{5b)LN^A_5V4cQklG-ur5B^N^*QV+iPr`a%#lzq$oSQ0aC*05 zV=Bep1Id3Ql28A$b_q$2D+XoGJ*g&iYre_brCLZCikK4<&VmC+|i&`g=6uel1>}#p8wF@lDc4g0X?6A&PP46f}nrqH0=p@&xW@n6Z{mOZeV>LovU7r#cI%_K4H7R;x$BCS5b@{N3T--@ z2=RVpX>bV63iZ)$l?R(3oh8TLd#wg&XA0 zXzhOQ8A5}02JQ=rK!8*kA%wE+i^nk(hg0 zLL_uOUaKB}KfiDT9|=Do4FA;`^0`i8pM*%4EK2zO3=e9v4HJnD5n@C1m{1NzhT5ptOBqdn% z{L&_R0YK&f)-n78008gkI{AM4fXD~d2iij#?{4<1i@gxg&DouSvqHp>#->DUUo+U3 z2HtsQ)%N)AAnkxPB~Cne|79u&L2U;-3aRa>&bSMJ5~MTE000mHU}5@mgHT&*Ft~w* zQbkp__GGy;@kc!IJHkA*)d+B>>o#P14K!dNVeG+}jESLNhdKv6_aXR`(+RlwvyZ;r zDn}d)M-GqnXnA&Ty!`mlMw;>o)uwIN=zm^z8VR8Uj0HRjpXA)T#`aUhS z3g5vE7Tj*_TqyH?*w;SI2l89v|E$T&)AyF{(zo!!>f1J>aq!R=+>Rv0=6U(W{6K`| zewJ*n%j9^A2n*Tn+)8v1*^GK5oZ_m23J?`9%exw1p<(XcmUTq%wg#Un7Tlg8R9w9!OtO9T{@N-Nqm8p-J)2o# zq{F5_41*}kwGd#6%Q(JPfoz>$5AgRJj14r}=Z7ZLUx=P!(I?W_B+V3Do3rJpO15<$ z$Xp&wqD+lxm7_$7)!r+jfGgALuo@YP{*`Icd3fr$z`(>&L1By>5rI?; zq(Kzz52!YfQYB*1Mky|7lUA?|m}|?mj-2SMge~RD!s1HRVzMk}Fye@zL_wj?o{)2F ziU@rEHG-*iyZgS^rtxDgMFZrI9kGLbhwYmfm7rB#KJq4RA3lXbjh8&1NULoaI>xng zj+x=R*hM8N-KFu^)C!iMMCB;?d#fWegQY17V#*?NV{vX_^{kn~-ZwRGLm`+NUT9Dt z%lgI1dhdp242qL5gR9%>bcgH%Z9g&q2}(P%Ke^<c#ZxLxfqDrE=z`LRdZY; z7V=tU^O!--?1NpCUQb^ewVF56JI-Jj2%0iRk0zAfoBzNN{-a&)GcId!GT&?axIEbT zS_0X-0?EU^8ItIbt2{)3g-AMuB#)B3KW@uJ1@V5hi%E^*@O%BSBi+Cz9!TS~th?k6 z>gf3M4%g>s;-K)~3K~l3GJ$+UdBj3rFyp`-J3H1;F${0hiK;ir#vRwv=cx%zl&;#z z`^Dk_2USh)KNlL*#?ZHhU79(kjlu{_@Z;7f7EUF9I!$j}msyxN$|;RdVzN=>=$j@2 zJs6{)w{T!LydX5@S=Evlh<7uWDatP8&m~Jy#tb(2Pd~0@b+34ym>=L6*QW1jA=JHz zP~m*IwVq6_wV38=DX~+EIt)-o%j6*MNa2&HFmltQQDMZ@REQfI1y7EN=XX+|>v4P3>L$O&I{=udcv*hnNoZsmoQ? zr4+Z*Cl?Sd3jQmFe|RJ@&tYuW4eysTrQ~sHXcSn8s5mItxA$10_8D(iC1W@h1q0JT z{l%mr>d3n&f?|I|2)8zB+)wHpDhU}WA_CedZDx^@=WV(+9adH!g?*Ux_mSA`>vm$` zLAFpIMqSikL~zkOr?GL}?V>-^I1NOUs4!5|qVdNHSg6IX`B#h8hPPE6tq)mf3nQfC zJkikc7bn4(f~mTbpSYV|RQ~nx4ZFMk>xD{si!U4nvRbc7 zD14_2MobQzFkUvw&*w4YV_$iyD82%)8hoLj5I&R$Y}J(*;J*v5h|#%w_G>DvJSAsy zy3}=wBMMW<_}{lA(l4Avc^u{6ZGes&yJKNSW($rB!nya&R}&6p#ZvlZ#>(}W41-Cg zr2svL7Ia$^r7bQGB-ka2GnrRgVxzp^M6V3&TmR^$*8*o18k9~XI3G@7kSbgFP|%lL zC(2GrFN9n@?leDoQlW1v`0Zt}6q~ZBwm4%+8WakNrZU|Q9rqZ?;Uy$^)GVN+EkH-^ z3-@}!Pf(=k&J2EiWrMo}W6mfVSg4jDtrYO*@mb!UY#8#10WN{ABRmmjPjz@r5~G_; z=F(*nMP^t2eos1U;2jNgCuoEi9R&WkcYUPBi0iXFW<5=Z<7eu)>qtA4O7~v7J>k{& zLOC_u!kvRMN6#g7!=sU+4_Cb|6aRvIH81QWXdZ1^AUVzUNb)ajyCl=$f*WWd*8ko> zjUs5E5cCj(C2N+4IatY}LsHy;1r6!Z0K78PvDVxQba3*1%E=FKSznYv;@vGIVC0P1 zK?o6`1|dQ$s5>efknGZkAcjYJ^7_REsZ&s71lwpnkt3QZ6fGbaG{c+Qqo8+Xxoz1< z`_g!17CtXKL@jRwNzH-Yu#DJ^9DRos_gbOp+2>{p=#sgvwv!5WYF-aH8-B^eK&5K5 z*2sO6SiH3v4|5K%G5#wPNzuK_`1i`7K`T^{xF`kSuDu2uJTpT(NoqiW( zG7HBG4gaTt%;Wx|b<(%*6cdjv?;LQt`Mn2Nx!eL%EK^it2Pl+4IU|Xc7#M!5-(s-7 zUDV|w{UY?1s!NePt!|>P0^NCO{ATQ%Ki^h7<`wlG+?4(3y4}{CI2=LEQ37EK_i%Vd z6lZ73S>LxO3Jo+@cOOglqNn=gKL-=}adFn4tuzs9j|1zW?dQ$ib7uicS32&@VCsA= zWVFO~JWxAMQupuakKO}=>WAWyCsDqnlO1< z>XeB-6ii~5IW4iAI)F3KxPje0VSj!;_Hy~Vea!MgKkI#ZwU%=I0=>+ip)oTwV7n5j zcp;*Iw(nf?$Jm?As&9O5_Q?Ot_P`oZen0n5qWoB?DOHmt+pwJJY4wTFP#gl&&aib% zG&KHP^Y3SzIBRLw(PC!b(}(0&&y}X)vCgyQ zK$y;?VRSzBh;~tZX9;T z7Z5EfriTLEpaKjkRqhW=t>(2RX3oyP-|VH<)kbdB)lc;ygR0V!c+XL=K!vPCVtAQ~EYA z0BOd`-C6`AnSfEAm31VLAJN*C;}ye*LBC!yO46e^STSI;j5)&dtR|&KtLsO*P?-v- z?uW0Hk0gy|s#2_>fa@lgMrE@2B3?XKpil;3Ya$>FO30>W4ee`Ow{SvUpbG`)GGZhY z!ssL=tn18c3>fv;<3e!5*4j1yp;eYP+5v>?~_VsO7pA| ziPya(G3;m=FoWuG=Nc6@WR*y|CIR|oTGF85qs30caoZqnwLN$F8@?_Gy;*LA z9iP)|z7L@}{z?7SixMh?B%j|XFhL9nmOD~1r_KyW`ex*{iszYLXLgg8=39K}J*M7W z$|&}F0q;bn_y_C<%5`tX*~#AJRlmDUH%rWHhDfS9YAjS`PCOrC%r5Kq!oDM|pTjMV zUJq*-EsfT%Y-NhvkCl*kM#H*NIi|blw)LdH9MHDFI#8-n=i_OHlJTWu}Nsde}}A zorUXaDuZxlGx=m}ySl=rd3#uZI96p8Ri5-1YR4y`Hy9hD?vsB32z6&><@NU`~y<8L~6 zKgA18g_3-d1jB@4YpkK*MZ-Z(vXrV3OqW*B@yA9neVawmla^7#s)^C^n?$J^P4kid zVn;?Y&#(qMGPeEo6h!$(EMw0sFDxg zP5=u3+e!a_9u-s)lTG|IT3VTUK=&Itm{tiVBgs{b-(P`m0DmGZW+DIpFbeYi5cAn@ zHelK=wtKp+z4kX(9sL%;9>i5rwGh?BM6I8S-bkX?-!vGLyUS$8De=|(69VTsx$+3t zroXOo)<_ALS6U;%!lrwu5%#3H00@8p2?hRDb-+=sT`iI5w?LXZ+UjREzXRWl2;Lt` zo}JgKWZu@ZomF@uSW%lD*qDD5WxDF7(Eaxm^7jC6KS?-#f1bp~eE^K1(^ndayL~>exY|eGPeB9*qcMa>uKcBdG6>t4?aXbFFE}?cj#dV(grazn4 zJ}r*)G@rf+=vuhs;Cp>~%HzJ8*DuLNqY(rn`2ZgchgUF_NBDwC_ye!0HH{d@x9r+Hb&r{gn+j(8Zk1WbvAGanuX%ocz( z+=~|D^)hn!drp8pqrfer41o8`tr-iw_eK8({WiW3M)(y}vS+z3&#SvzS&DBISA@7b zDTm~<1ad$H!l+Q1FQ=`lRVHUc^jLKu$4k3!p0)mF1{^$~EpGuA+K;$0FFEd;vyEER z2we6A-zY8f;gj_z`Q`BXvxh7T1NRXs7?B0wZ<7ioWfX^&9%-`EC18P!(!@+wZ;@z#zM(!QDTY1Tf<8u07#u;h=g?OY61g2X^f_q%IvS${)kUXJ~@xd9GQi~g6bkzUQ39Eo!cvBR=T6Z6$u{Z{DzfIO{U})!#}v4Fq_OGmL=@ki#*!| zmS(G!wg(L@;nqRz5a9{Is=R%TwPTjcse339FI+ELc_2Cx2`Tf?a~X*N%C|4blNANw zo9eV7OB*Y`#%eOZNVmJ5BP7L1j%nWt;>(>qHPr&{e)q<;4lX9jO;AYEbx&8$=EF*) z^@bU()Wm*Qx*Ad{S(Sbc8B8-(jpcOJwIEJhT|*b+GRbJc>qHxF!r7VGh3PTflLpUX zJQ_%^wB2Cbt?1H|_0O~FD%$1@oZtNu{>8@S>gRkn2cfhRRFV{I3E^HGIQ5i3O2G|q zU#Oa!)a(!Ll(*|IjNZ+~57~F0Qr(i|bHP)I*H;d_{;zKnQ|IF+%V#$(_hKv`oBXW( z_1o*BZtsOb&DWZJKF<3-t*brjSaGz9l^qffmH|4p+Q(y5Z+kSPaWdt%t92YIxEGc{ z)~awM7Ms^KyJ@4%ZL|&y3n>o3ZE_sfhs(5bwLwIhk}c!<^;2cQ=xgF=9YJ;*Y<3Oo z+1`8T-*p;cHvXy4@z9up408^`K;T?Uu)#h{u&llV_#M$pG&3^%`fAoal-PE+=u-qu zM@3!z*X^w&)s$M-9Fx?f^t2EJ`!tlS+e$1ls`Nqm^`STHH1wHCPu0!D44sY7*d_@W~NK*!2jooF0eiJccry&Pzx9RJBQEgajwntcew3t8!kO>v;|BDo5w z@-+dnn)a@s12M~@KoZM~*c{JIdgJlM;QQ)8%gwtl8Jd%?Uaj@};f{==b1~OA*vTz4 zKWqiu9K^Vg;w|9qO^AHLJ9s?$30}R@cnL)Q{x>O4cr=+(2{EF!#_YFmo&w9K{5o`e z#=m;_EJ2Su3DdWwE=5b_@L-IUZ7J|tHrl&c*NnUGe`uLzWYU8}oeL}~t~_?@(+E$R zjhvjBvT8V3fhBHfL{7r#YsLDRNY48|QDwW)EEI6DXi9GBph!tu-~+|c`+9oXNF}5k z)1k7#ZqtRNwbqp2LQ`EfzLBI1S+XITzv^Zvx|C6 zah{x+Up`tiH*r0>V|u4mFQzq?bR|-(`5V2ewsOg;pCT_sw3v6cbhZ5TQ+21K({Mm` zFxmv9ja?j6-VU#BvN$%rU~$heGty!*6!{}>m(($WonIqq+X>J@MY86+I;XuyuZ+m< zeMNmK(Oy{I1K48tQ;uG#rtALlV-j%lf0+8`=uVpN3lxrR+s?!j+qP}nwr$%^CeA0e zZB1+^6Z7WzeeZkM`%kZ4t7~;tcbz(?u+QEZcIC9@mP`CcvvJ&wa%9`PsqIvDFofXF z9rSb_#+`{|!Qg~eIHR?7CMLO#Ayk3hiWNn)Ap8><_`BsmRz>WL{iV|9sb|M078XYX zGcP-s5j}3sYFDcI(;2|HQdj3dL3WNr0fCpf?sDt$@eH(M%NqioI32Hmb-N^NRa(FN z$6=EUUdL9v5e2p_*FoI%8tl|{&(p1oOeO2B_QVuW%02hk7Dt07;To*h$u`#mSB=(` z+4UY)RtCpI^Is(=ZGt!Y+Oci7f$W2ut+GZR3l>C$C}jv?KbnMr@m(=sEm-{t?pg=w zYNaR}Q};Nk$dTcH6FUinS$kI&QUQTtriGIKc?AmaVAtK>!G^oP4`kgt3}wGH+7}AB z_GJw%inyM&`U14J(dmWp`2d+G6LV<*ma{?V6pGv_HBNrMH*vwAK@@86y8s_)101AB9dAL|xBWye|(kRvHhng=TE&?Ok zQE&L)nS*?EVV`s2v#*gV=6aywADtgux)+BmfJbTQ9zr9VX*)OHT}wqjR3%^*1s7?A zIqlgAgTq1k&~>2eu9Yg@=Sst2NWaHD;Oij}eAq`Y>S*8EEI6L36-qY%L3Z;x#JrjLW-xE$SE!~o;E82SW z!@<|3ElV5uJ`Q0z+omk50*F`mLMp?o=?g-KZyR0_G$F5jK72#wPs5qS;W5hZqtDx7 z7>j~_lJ1>7bc+Sl$%C{YP&Gsrr;@deW1q-9aoDDMWP?yWQvBuf`B-K{pbg-~+%7n$ zvy_WJp@k;dpoy!~e^0)L%R=~i8gE!wu!#YfW$pd))8}PQG{>jG*ntNoJDGVWtS?z7 zIPh^MfnTD?OI1vIlScHEkQcy@KJ)q`utv7Gy;*N!@>lD&C);Gbc?PBOG2S4y^&YE~9HLfg_|4UZSW3CA{slK&v^GCYNU*-v0`M_O{CPt4~ZSPuv>>8_oAHga< z19sQuH7pLs1++_dF^AD;ss;i9H=kB2!$*GnlZWk&?5%YL8&srndW!*W4P^cda1-Y3 zvlFGW5dhmV<3hG6_<6yxq|S*p+W15c5_9w6cAj|)=j0un1(3bQYPqb@_FzQ43Z=Vg zPH)uI_L@brlLG+Rg0g6lOc38R^zhhuX|<5TpnR7f(_4vHy#)1f9K z#vjEmzAu>^TFVZmva<2N-S{SM#ydF2LGWmyojhpJCvMNy48u>7sqJjKSi(}IuJh@2 zhBV)z-VJuz-n$!6mx3o`u3WH};Cub4>G{O5{OmiCi(*d4M*)DS>L^;^EzbM7YzexZHH%^;TN4vxo zh@cuk4JI)`_IQvfrk9jLed<3`Hp*4vRVu-|vIu}9wQ1D)oWqFPcH=OAgldL&GIVjG zPxJk#v%AEw6}6>H{@5qY{NLPKJ4XpC#9$wBHMf`BGf$9+;dHS(M9H?1sf%bHdBd z0TAdZV%049B<8ZyFbejdG(3z3%qhQ&1F#-NK71%nV?SEHMmgaz-H-IqegQWDZR2Me z79h|UiLioNdV0mRf8ZgUL4W(A%ZMey@m$J=IXAC*tgDq0#Q!37^2r(x&vckSZi$ub zL2oV;9x?rc#t`lGg_t+BltVfl_@?K11>UQ{@h-cm=o{KegWqS}^}2jFQFJ%Fmx`7B zrK$P(kxvWKgli@nXSRSUPoO&g2Ik;KOFz(Cu``0V<(=M?cmynq&5sf0WQFK?Li9#S z-TSUeh{2SI!`gVar@ypm>rwLrSfvRSYf=)}}AOcK- z^;zzO!0lf9&~UL~S7B~$?P&q^PBXgol{gpk%@#U5eP0eO3p}vdPnW<_Nmjo?@+Inm z&z?Iub8TbKf7SaX2UIayD>xm3zGBQ{Omv8W#@*sf)Er3gbP-OAh^Pv-V+W| ze8u1!BTG<7Sr=3*0WCQ}=FUUQr^eMQ)$>2s_uQMWM(bMpPgFf>il^`NUg`6f%BPDb zrUutngET%rqdQLy(^U90t3O0HPw;2h8iqFXvU^SQoRu7xw7VVL*pho2+eSUb7?rnhEc}HJ?3@0 zSgwBirrX-WYA14nK*{-}n_J|JN)CW*ros0~eG*u2SzG=*q;j{tup?U1=;}iWzR#KZ z0u-UBjAA89Aao;fFi zHzOb`|1#tl_7#IGt|v7B-;#{j)jX#R2`J1`*xhbH$|!=4rZ!_AfCgKVf^tIvRSf{K zt7PZu+l0TMjR&UI`V(Q4Mw;`(iO0%50K=O`lz9j`j3U$#mi~m(UKS9Ep74Lq1-L_p zIPG)TQdRqw1JDR?@sQ;M10CRMC5D)!;pNJmM*g4}L-&&ox}(`3EpY&mv$@a~C~XD` ze>vhl7O#W@&oLr{NmDVaNEYbOqBYx)tVM>O8I6#Wm1mSgC@G{wW})wgUBd;@W-_6a zwZv&DE;Iy*hN+PmWspOaE6&04N*IT-GDSN8iBxDAMLdv_B3T!FEd|CI|eth*_T`pYzvH#fU!#fyLcH=UxkatfJj<+=wcmDvO+!=TK_&H5y9@g<@H%d>%KYJP$%m?EyYkr z>fR&8Fyh_weuAE78N^x#3D`u`Ix^526|>c}yAL{pu>&{;6Y+{(%#4zKpPiT0*@GY( zp<}QmO$2YniRjibz==SRc#_^dg{?$_=JXwHcno{gd0c#%6`uZmeZH*Fa3{hsOAw2cq)Uq5K0tTgbw&o~vPMI+ zw2{@A5Bs;FQxGJei5zGpeuM?fn10v#qe_gq<%-n3UIIh8W1YewOOUkdq{|CaUZ)6G zBnCGZ^8@}AK>JN7#};CMktQUQf~V(%twky@9y4M<0EZz%O5p#_Vl9U)A9wle1rT8B zHP71}z`cj=yvo9iT7EW2Wm<*Z$sI*g5Z5WFf449q*%iNsLoJb%K#EVw*`$yL9XbCw zF`k>+k&U5kxsZ{e`Dpf{jS$-|#|o`8m;ptDY8G-tMlUIT#qH>1m+!>jKdZ<@9?qg; zir@&qM5zf0Ao)|uO9UM#!-2M25(^;l>SV7jN00oP&**`|5XyP99#I@AA^IiYNS%cy zj6^FcvG`A5#CY!4j_gM1lF=&(F4P>zSfs1&0Xlaitrtd2!5=*=L7c37Iau)N!^N+~ zrKRYdMhy1MFbnRA2e^eS3fw{^Sh6yxLIuIf1Zc(qVBwJsGVl>Ad}nH6Cy_r{URK0R zzX{!u9WHwEt*M%`RfNOv;VNX$IEqxvL$yE1yw?(30}jHz=>q z0RlKcBqWS~h=2qj*7Dv_;d40Fa|q-Z>M@%_A46@C7=F1&Rt^;^p^%q+ZYQ%0)V=M1 zYr?+v;gY=$sVl%t{rYFZ8p7IE784j9s2zmLkrPQI0|dkjuEqimbZjuCh;o;WZrw&^ zijvotJj(zvw!j&(Qn_Lye!jgmb!T+TTmmv}TD*E;YTYJ?`vL(33%U*I{r-(F<2~W4 z+fmEtt|YWl2D9S(Zkzf3n4>#E0M+mJxYFD4*0z0i?dHi1eXZg4 z%j)C9{?7AnrSlE{2jAn)@wM^J7i0_TIPwehnGslHNgVZn+}Pu9-7h$2)|+ZV!uZ#w z3EHg-KNG8#_)>6fgt+S3O84epLn^5{tQ{;4D<#UyVUKLtZ}2dx&Zocp?lKbQDd#>s zT49`jOaOI3R@qAl$hy%oBV$EV0Zh4HCQ>cxCJ*N7@g0Zgi$p}4xggt4%B@x2(*zoQBxere zUq6MKoW_4fjM4gsB1m1kipjN~FE3f#(KYu`@3i}Ius19d2}k96q#J}y8{0HGSKre& zTy8T$j_owvLB-j)=#FHbHO}_I?mNwAQBp(}9C&JBhKaaDr>(!V(`xP}-s_tu2$S`N zzF&1=uIKl}f7?ZjT00H1h)t<0@+vt2@ev)Z74yFTgO$;thF+UCjsjz43JM@HN|I6( z7lLAHPcQ}=sSjNfPbiEwtVY;7P<*nhgK~f4!^bNF8zD>!e7WiS0+{NYFLyvdv;Hcl z4_?Lz;CXg%+7m5&yYo4Ij!8MtL+)bEF0>OoRbQ@qobJ!pSj-Jh)yHR$W5lZi8^KNE zcsZm%)yn0BJ+B{%#Kdse3+|+9uGPE^i5Di(pNGKVi^FmNRL*z9D4ec=?$dc(KOD1T zwQC^Jy0CLnAMdL-(%;-GBa3N>PnzB^AgbANxHx@^ecgG3?(A;#5;n@FS02XvTdaHf z($!bW<2|~)@>b&88t6GWn@Di{hj?1sapwTjfS&le&?)Ax-n#=P9G&T0xMHYLO3SFB zJ`iP_Ge_O(WR$ly34LEcryn@UW_qHG8I=hKc9hF6tC}wB(Ut1_%;{9`d={k#JUW}s z?m}&}6a$44G$aWk8VOB3geOh{nZlE#{hHO~9LiIyaKf+IGh~Gtt<MC z)?hUP1}$hr23#~0l42A`j12D+de`GP;ct4Pu7h;*cJGNvebilB9<8lzrVslaSjkz6 z+-W9LT<~ju;eshXi;DQuHqWs#GJEEo$)p78`N+Z+TVBB?E}UjSx2lClht)YNt*f!H zvS+$U)QeosrWtP5vw5rj&0n=3N7su_+ybs6Am)Mp66sIE6gZfEwX943+oKVo!`3(i zW!5xT)EcXC5SS#0NTlIYoDZ_mjHiwiYXYx?3@tiwRVCMrc{?Y&?E>j{tezrd>Cf1p z1rJ?u{<9nQG5JuvFFa=Jcrq3emlsmi+ zHJSk45JWV>hY~A(M#-4jCW-Q{Ox?7>j8QQx-m6L%kUv zxp;o*gy*h%QA;i|1-gk?j}uYyHdQe=_(fWIG?nj}6*7bY=kkhl>;PccDZ50=Skz+w zJHL;?USKAca79%}H$;|F6c>VQltWT~*eTN?ZB3Qqd~(N0Nm3Ha8W$PeJ(~9K+b5KH z_xklR><6oqg(WDEz$95pMM@l!VgKUC$V1n>`MGW3IV05dD)0poaTz z1cI|76QY<)$^4-(yY|^Pijzck4bK@IcsUw9{AJ?FaUdJ4G$z6iKui8xoOIkNumA%w zm;`?B#WH`LnGI#Y({q6)82k%>emgF-0< z+hq0(Va0gg%F%hKxzIvm#^&@ZHH6GIBru>8Sn*Psouqq0>$k>U0ZqOTLw;i{X zni%m#6(^UF6p0B;X)5WtHu>)tq&ik;XL^%Wpdd-ftgC)P5ZNgtnv@Fm6>s1P#0+6pk{0}V=U`Q(3Tvj*jod`Y(r`(G%CK7wz-JW zwb3e0e}w88wR3VAR-OZ61qq6jB+z0hKZHecW{g%cjFL)G6OD0}s#J=DcT$L;=)2kJ zSXQ_>c7`r*hG!iJNe%K%IhIDfewcT@r?`rvSn04^(Yp zNH~NSbWdhC|DV^QfJP-3QJ-g9t(t*Cmq<`b@+lgVLIy$9u)0EY=y zg^`doiOr!-41_4njg1J@vW4GUxys^6K_lr89URe$6q+n0Ol`mlfm>Fg9$qOKTwj@w z_d33NZ471orS)JyAT0$CCpd2*Ed{Jd8ta8E$KCpl3)}oJ6jebmL27&mx7k>d=bK8= zsnaONpzbhV=>bAH_$NAn1PucMBcJtM8U1c&5$HX&-}~qO{luWc{3Y&oj1r40S@N6# zRt|eBQQ{J5%?kwc5kdL(Xi=cCYPH0!`0P<%Hjz{s_5wb+yZHpY?nz zOb+tM1r!>=(Ull}tFe$OAr_Jytd7}KG0TpUQHsw)Mp_(c78pClV%DQmSo;FHs zkJ(7w2PL^{*UYPv^KE`E_$_R4O=Wxy!Qfb0q$-xt_Fkq_CI7V7ktl<>>a`WV1^11M)_2DIF4}ECN z{R0KFK~~||@wsb_I6}xpf-Q$oj;RxS*3Bkg3A_0aWob~{Q~&e}!Z-@&HuroY^b-ci z!9N4Laq)U`MbpRkXJKi>0FVBFknt3whB=K1iyg@g8oOz5W1CYzrksE_4iA1SL0eC$ z@KVC*%IjNO$~L=~;<{3kVu*7(nk&;VwnQQiFEnc@-BVMGi}fv+cQ!yd&Kf8aj|M)L zwL-z &1X&IK3J;eqXG+%yq$|WjU+g{|0txR@rG>=X4p^ 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

    d*0pj+1HNKoW3u}+t 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

    MaQ;5KaT?cvM6%8$ba|niI}*h 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 z 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�NxHX114pJzJPD;&Y4Q{Sv8YIDq4;|BTb18 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�&h-1l`@Ge(+BT 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�t%(IF~%v* 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 O6rcutwvI%b4iU672*Za#4->>t`-n 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 t^xU-haIDAoE>&R|V~ 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 z0KNbK00000000000000000000000000000000000000000000000000008^}007b! B?zjK| literal 0 HcmV?d00001 diff --git a/Ethernet/W5100/w5100.c b/Ethernet/W5100/w5100.c new file mode 100644 index 0000000..2863ed4 --- /dev/null +++ b/Ethernet/W5100/w5100.c @@ -0,0 +1,371 @@ +//***************************************************************************** +// +//! \file w5100.c +//! \brief W5100 HAL Interface. +//! \version 1.0.0 +//! \date 2013/10/21 +//! \par Revision history +//! <2013/10/21> 1st Release +//! \author MidnightCow +//! +//! Copyright (c) 2013, WIZnet Co., 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: +//! +//! * 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 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 "w5100.h" + +#if (_WIZCHIP_ == 5100) +/** + @brief This function writes the data into W5100 registers. +*/ +void WIZCHIP_WRITE(uint32_t AddrSel, uint8_t wb) { + WIZCHIP_CRITICAL_ENTER(); + WIZCHIP.CS._select(); + +#if( (_WIZCHIP_IO_MODE_ & _WIZCHIP_IO_MODE_SPI_)) + WIZCHIP.IF.SPI._write_byte(0xF0); + WIZCHIP.IF.SPI._write_byte((AddrSel & 0xFF00) >> 8); + WIZCHIP.IF.SPI._write_byte((AddrSel & 0x00FF) >> 0); + WIZCHIP.IF.SPI._write_byte(wb); // Data write (write 1byte data) +#elif ( (_WIZCHIP_IO_MODE_ == _WIZCHIP_IO_MODE_BUS_DIR_) ) + //M20150601 : Rename the function for integrating with ioLibrary + //WIZCHIP.IF.BUS._write_byte(AddrSel,wb); + WIZCHIP.IF.BUS._write_data(AddrSel, wb); +#elif ( (_WIZCHIP_IO_MODE_ == _WIZCHIP_IO_MODE_BUS_INDIR_) ) + + //add indirect bus + //M20150601 : Rename the function for integrating with ioLibrary + //WIZCHIP.IF.BUS._write_byte(IDM_AR0,(AddrSel & 0xFF00) >> 8); + //WIZCHIP.IF.BUS._write_byte(IDM_AR1,(AddrSel & 0x00FF)); + //WIZCHIP.IF.BUS._write_byte(IDM_DR,wb); + WIZCHIP.IF.BUS._write_data(IDM_AR0, (AddrSel & 0xFF00) >> 8); + WIZCHIP.IF.BUS._write_data(IDM_AR1, (AddrSel & 0x00FF)); + WIZCHIP.IF.BUS._write_data(IDM_DR, wb); +#else +#error "Unknown _WIZCHIP_IO_MODE_ in W5100. !!!" +#endif + + WIZCHIP.CS._deselect(); + WIZCHIP_CRITICAL_EXIT(); +} +/** + @brief This function reads the value from W5100 registers. +*/ +uint8_t WIZCHIP_READ(uint32_t AddrSel) { + uint8_t ret; + + WIZCHIP_CRITICAL_ENTER(); + WIZCHIP.CS._select(); + +#if( (_WIZCHIP_IO_MODE_ & _WIZCHIP_IO_MODE_SPI_)) + WIZCHIP.IF.SPI._write_byte(0x0F); + WIZCHIP.IF.SPI._write_byte((AddrSel & 0xFF00) >> 8); + WIZCHIP.IF.SPI._write_byte((AddrSel & 0x00FF) >> 0); + ret = WIZCHIP.IF.SPI._read_byte(); +#elif ( (_WIZCHIP_IO_MODE_ == _WIZCHIP_IO_MODE_BUS_DIR_) ) + //M20150601 : Rename the function for integrating with ioLibrary + //ret = WIZCHIP.IF.BUS._read_byte(AddrSel); + ret = WIZCHIP.IF.BUS._read_data(AddrSel); +#elif ( (_WIZCHIP_IO_MODE_ == _WIZCHIP_IO_MODE_BUS_INDIR_) ) + + //add indirect bus + //M20150601 : Rename the function for integrating with ioLibrary + //WIZCHIP.IF.BUS._write_byte(IDM_AR0,(AddrSel & 0xFF00) >> 8); + //WIZCHIP.IF.BUS._write_byte(IDM_AR1,(AddrSel & 0x00FF)); + //ret = WIZCHIP.IF.BUS._read_byte(IDM_DR); + WIZCHIP.IF.BUS._write_data(IDM_AR0, (AddrSel & 0xFF00) >> 8); + WIZCHIP.IF.BUS._write_data(IDM_AR1, (AddrSel & 0x00FF)); + ret = WIZCHIP.IF.BUS._read_data(IDM_DR); + +#else +#error "Unknown _WIZCHIP_IO_MODE_ in W5100. !!!" +#endif + + WIZCHIP.CS._deselect(); + WIZCHIP_CRITICAL_EXIT(); + return ret; +} + + +/** + @brief This function writes into W5100 memory(Buffer) +*/ +void WIZCHIP_WRITE_BUF(uint32_t AddrSel, uint8_t* pBuf, uint16_t len) { + uint16_t i = 0; + + WIZCHIP_CRITICAL_ENTER(); + WIZCHIP.CS._select(); //M20150601 : Moved here. + +#if( (_WIZCHIP_IO_MODE_ & _WIZCHIP_IO_MODE_SPI_)) + for (i = 0; i < len; i++) { + //M20160715 : Depricated "M20150601 : Remove _select() to top-side" + // CS should be controlled every SPI frames + WIZCHIP.CS._select(); + WIZCHIP.IF.SPI._write_byte(0xF0); + WIZCHIP.IF.SPI._write_byte((((uint16_t)(AddrSel + i)) & 0xFF00) >> 8); + WIZCHIP.IF.SPI._write_byte((((uint16_t)(AddrSel + i)) & 0x00FF) >> 0); + WIZCHIP.IF.SPI._write_byte(pBuf[i]); // Data write (write 1byte data) + //M20160715 : Depricated "M20150601 : Remove _select() to top-side" + WIZCHIP.CS._deselect(); + } +#elif ( (_WIZCHIP_IO_MODE_ == _WIZCHIP_IO_MODE_BUS_DIR_) ) + for (i = 0; i < len; i++) + //M20150601 : Rename the function for integrating with ioLibrary + // WIZCHIP.IF.BUS._write_byte(AddrSel+i,pBuf[i]); + { + WIZCHIP.IF.BUS._write_data(AddrSel + i, pBuf[i]); + } +#elif ( (_WIZCHIP_IO_MODE_ == _WIZCHIP_IO_MODE_BUS_INDIR_) ) + //M20150601 : Rename the function for integrating with ioLibrary + /* + WIZCHIP_WRITE(MR,WIZCHIP_READ(MR) | MR_AI); + WIZCHIP.IF.BUS._write_byte(IDM_AR0,(AddrSel & 0xFF00) >> 8); + WIZCHIP.IF.BUS._write_byte(IDM_AR1,(AddrSel & 0x00FF)); + for(i = 0 ; i < len; i++) + WIZCHIP.IF.BUS._write_byte(IDM_DR,pBuf[i]); + WIZCHIP_WRITE(MR, WIZCHIP_READ(MR) & ~MR_AI); + */ + setMR(getMR() | MR_AI); + WIZCHIP.IF.BUS._write_data(IDM_AR0, (AddrSel & 0xFF00) >> 8); + WIZCHIP.IF.BUS._write_data(IDM_AR1, (AddrSel & 0x00FF)); + for (i = 0 ; i < len; i++) { + WIZCHIP.IF.BUS._write_data(IDM_DR, pBuf[i]); + } + setMR(getMR() & ~MR_AI); + +#else +#error "Unknown _WIZCHIP_IO_MODE_ in W5100. !!!!" +#endif + + WIZCHIP.CS._deselect(); //M20150601 : Moved here. + WIZCHIP_CRITICAL_EXIT(); +} + +/** + @brief This function reads into W5100 memory(Buffer) +*/ + +void WIZCHIP_READ_BUF(uint32_t AddrSel, uint8_t* pBuf, uint16_t len) { + uint16_t i = 0; + WIZCHIP_CRITICAL_ENTER(); + WIZCHIP.CS._select(); //M20150601 : Moved here. + +#if( (_WIZCHIP_IO_MODE_ & _WIZCHIP_IO_MODE_SPI_)) + for (i = 0; i < len; i++) { + //M20160715 : Depricated "M20150601 : Remove _select() to top-side" + // CS should be controlled every SPI frames + WIZCHIP.CS._select(); + WIZCHIP.IF.SPI._write_byte(0x0F); + WIZCHIP.IF.SPI._write_byte((uint16_t)((AddrSel + i) & 0xFF00) >> 8); + WIZCHIP.IF.SPI._write_byte((uint16_t)((AddrSel + i) & 0x00FF) >> 0); + pBuf[i] = WIZCHIP.IF.SPI._read_byte(); + //M20160715 : Depricated "M20150601 : Remove _select() to top-side" + WIZCHIP.CS._deselect(); + } +#elif ( (_WIZCHIP_IO_MODE_ == _WIZCHIP_IO_MODE_BUS_DIR_) ) + for (i = 0 ; i < len; i++) + //M20150601 : Rename the function for integrating with ioLibrary + // pBuf[i] = WIZCHIP.IF.BUS._read_byte(AddrSel+i); + { + pBuf[i] = WIZCHIP.IF.BUS._read_data(AddrSel + i); + } +#elif ( (_WIZCHIP_IO_MODE_ == _WIZCHIP_IO_MODE_BUS_INDIR_) ) + //M20150601 : Rename the function for integrating with ioLibrary + /* + WIZCHIP_WRITE(MR, WIZCHIP_READ(MR) | MR_AI); + WIZCHIP.IF.BUS._write_byte(IDM_AR0,(AddrSel & 0xFF00) >> 8); + WIZCHIP.IF.BUS._write_byte(IDM_AR1,(AddrSel & 0x00FF)); + for(i = 0 ; i < len; i++) + pBuf[i] = WIZCHIP.IF.BUS._read_byte(IDM_DR); + WIZCHIP_WRITE(MR, WIZCHIP_READ(MR) & ~MR_AI); + */ + setMR(getMR() | MR_AI); + WIZCHIP.IF.BUS._write_data(IDM_AR0, (AddrSel & 0xFF00) >> 8); + WIZCHIP.IF.BUS._write_data(IDM_AR1, (AddrSel & 0x00FF)); + for (i = 0 ; i < len; i++) { + pBuf[i] = WIZCHIP.IF.BUS._read_data(IDM_DR); + } + setMR(getMR() & ~MR_AI); + +#else +#error "Unknown _WIZCHIP_IO_MODE_ in W5100. !!!!" +#endif + + WIZCHIP.CS._deselect(); //M20150601 : Moved Here. + WIZCHIP_CRITICAL_EXIT(); +} + +/////////////////////////////////// +// Socket N regsiter IO function // +/////////////////////////////////// + +uint16_t getSn_TX_FSR(uint8_t sn) { + uint16_t val = 0, val1 = 0; + do { + val1 = WIZCHIP_READ(Sn_TX_FSR(sn)); + val1 = (val1 << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_TX_FSR(sn), 1)); + if (val1 != 0) { + val = WIZCHIP_READ(Sn_TX_FSR(sn)); + val = (val << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_TX_FSR(sn), 1)); + } + } while (val != val1); + return val; +} + + +uint16_t getSn_RX_RSR(uint8_t sn) { + uint16_t val = 0, val1 = 0; + do { + val1 = WIZCHIP_READ(Sn_RX_RSR(sn)); + val1 = (val1 << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_RX_RSR(sn), 1)); + if (val1 != 0) { + val = WIZCHIP_READ(Sn_RX_RSR(sn)); + val = (val << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_RX_RSR(sn), 1)); + } + } while (val != val1); + return val; +} + +///////////////////////////////////// +// Sn_TXBUF & Sn_RXBUF IO function // +///////////////////////////////////// +uint32_t getSn_RxBASE(uint8_t sn) { + int8_t i; +#if ( _WIZCHIP_IO_MODE_ == _WIZCHIP_IO_MODE_BUS_DIR_) + uint32_t rxbase = _W5100_IO_BASE_ + _WIZCHIP_IO_RXBUF_; +#else + uint32_t rxbase = _WIZCHIP_IO_RXBUF_; +#endif + for (i = 0; i < sn; i++) { + rxbase += getSn_RxMAX(i); + } + + return rxbase; +} + +uint32_t getSn_TxBASE(uint8_t sn) { + int8_t i; +#if ( _WIZCHIP_IO_MODE_ == _WIZCHIP_IO_MODE_BUS_DIR_) + uint32_t txbase = _W5100_IO_BASE_ + _WIZCHIP_IO_TXBUF_; +#else + uint32_t txbase = _WIZCHIP_IO_TXBUF_; +#endif + for (i = 0; i < sn; i++) { + txbase += getSn_TxMAX(i); + } + return txbase; +} + +/** + @brief This function is being called by send() and sendto() function also. for copy the data form application buffer to Transmite buffer of the chip. + + This function read the Tx write pointer register and after copy the data in buffer update the Tx write pointer + register. User should read upper byte first and lower byte later to get proper value. + And this function is being used for copy the data form application buffer to Transmite + buffer of the chip. It calculate the actual physical address where one has to write + the data in transmite buffer. Here also take care of the condition while it exceed + the Tx memory uper-bound of socket. + +*/ +void wiz_send_data(uint8_t sn, uint8_t *wizdata, uint16_t len) { + uint16_t ptr; + uint16_t size; + uint16_t dst_mask; + uint16_t dst_ptr; + + ptr = getSn_TX_WR(sn); + + dst_mask = ptr & getSn_TxMASK(sn); + dst_ptr = getSn_TxBASE(sn) + dst_mask; + + if (dst_mask + len > getSn_TxMAX(sn)) { + size = getSn_TxMAX(sn) - dst_mask; + WIZCHIP_WRITE_BUF(dst_ptr, wizdata, size); + wizdata += size; + size = len - size; + dst_ptr = getSn_TxBASE(sn); + WIZCHIP_WRITE_BUF(dst_ptr, wizdata, size); + } else { + WIZCHIP_WRITE_BUF(dst_ptr, wizdata, len); + } + + ptr += len; + + setSn_TX_WR(sn, ptr); +} + + +/** + @brief This function is being called by recv() also. This function is being used for copy the data form Receive buffer of the chip to application buffer. + + This function read the Rx read pointer register + and after copy the data from receive buffer update the Rx write pointer register. + User should read upper byte first and lower byte later to get proper value. + It calculate the actual physical address where one has to read + the data from Receive buffer. Here also take care of the condition while it exceed + the Rx memory uper-bound of socket. +*/ +void wiz_recv_data(uint8_t sn, uint8_t *wizdata, uint16_t len) { + uint16_t ptr; + uint16_t size; + uint16_t src_mask; + uint16_t src_ptr; + + ptr = getSn_RX_RD(sn); + + src_mask = (uint32_t)ptr & getSn_RxMASK(sn); + src_ptr = (getSn_RxBASE(sn) + src_mask); + + + if ((src_mask + len) > getSn_RxMAX(sn)) { + size = getSn_RxMAX(sn) - src_mask; + WIZCHIP_READ_BUF((uint32_t)src_ptr, (uint8_t*)wizdata, size); + wizdata += size; + size = len - size; + src_ptr = getSn_RxBASE(sn); + WIZCHIP_READ_BUF(src_ptr, (uint8_t*)wizdata, size); + } else { + WIZCHIP_READ_BUF(src_ptr, (uint8_t*)wizdata, len); + } + + ptr += len; + + setSn_RX_RD(sn, ptr); +} + +void wiz_recv_ignore(uint8_t sn, uint16_t len) { + uint16_t ptr; + + ptr = getSn_RX_RD(sn); + + ptr += len; + setSn_RX_RD(sn, ptr); +} + +#endif diff --git a/Ethernet/W5100/w5100.h b/Ethernet/W5100/w5100.h new file mode 100644 index 0000000..898f557 --- /dev/null +++ b/Ethernet/W5100/w5100.h @@ -0,0 +1,1875 @@ +//* **************************************************************************** +//! \file w5100.h +//! \brief W5100 HAL Header File. +//! \version 1.0.0 +//! \date 2013/10/21 +//! \par Revision history +//! <2013/10/21> 1st Release +//! \author MidnightCow +//! \copyright +//! +//! Copyright (c) 2013, WIZnet Co., 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: +//! +//! * 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 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 _W5100_H_ +#define _W5100_H_ + +#ifdef __cplusplus +extern "C" { +#endif + +#include +#include "wizchip_conf.h" + +/// \cond DOXY_APPLY_CODE +#if (_WIZCHIP_ == 5100) +/// \endcond + +#define _WIZCHIP_SN_BASE_ (0x0400) +#define _WIZCHIP_SN_SIZE_ (0x0100) +#define _WIZCHIP_IO_TXBUF_ (0x4000) /* Internal Tx buffer address of the iinchip */ +#define _WIZCHIP_IO_RXBUF_ (0x6000) /* Internal Rx buffer address of the iinchip */ + + +#define WIZCHIP_CREG_BLOCK 0x00 ///< Common register block +#define WIZCHIP_SREG_BLOCK(N) (_WIZCHIP_SN_BASE_+ _WIZCHIP_SN_SIZE_*N) ///< Socket N register block + +#define WIZCHIP_OFFSET_INC(ADDR, N) (ADDR + N) ///< Increase offset address + +#if (_WIZCHIP_IO_MODE_ == _WIZCHIP_IO_MODE_BUS_DIR_) +#define _W5100_IO_BASE_ _WIZCHIP_IO_BASE_ +#elif (_WIZCHIP_IO_MODE_ == _WIZCHIP_IO_MODE_BUS_INDIR_) +#define IDM_OR ((_WIZCHIP_IO_BASE + 0x0000)) +#define IDM_AR0 ((_WIZCHIP_IO_BASE_ + 0x0001)) +#define IDM_AR1 ((_WIZCHIP_IO_BASE_ + 0x0002)) +#define IDM_DR ((_WIZCHIP_IO_BASE_ + 0x0003)) +#define _W5100_IO_BASE_ 0x0000 +#elif (_WIZCHIP_IO_MODE_ & _WIZCHIP_IO_MODE_SPI_) +#define _W5100_IO_BASE_ 0x0000 +#endif + +/////////////////////////////////////// +// Definition For Legacy Chip Driver // +/////////////////////////////////////// +#define IINCHIP_READ(ADDR) WIZCHIP_READ(ADDR) ///< The defined for legacy chip driver +#define IINCHIP_WRITE(ADDR,VAL) WIZCHIP_WRITE(ADDR,VAL) ///< The defined for legacy chip driver +#define IINCHIP_READ_BUF(ADDR,BUF,LEN) WIZCHIP_READ_BUF(ADDR,BUF,LEN) ///< The defined for legacy chip driver +#define IINCHIP_WRITE_BUF(ADDR,BUF,LEN) WIZCHIP_WRITE(ADDR,BUF,LEN) ///< The defined for legacy chip driver + + +//----------- defgroup -------------------------------- + +/** + @defgroup W5100 W5100 + @brief WHIZCHIP register defines and I/O functions of @b W5100. + + - @ref WIZCHIP_register_W5100 : @ref Common_register_group_W5100 and @ref Socket_register_group_W5100 + - @ref WIZCHIP_IO_Functions_W5100 : @ref Basic_IO_function_W5100, @ref Common_register_access_function_W5100 and @ref Socket_register_group_W5100 +*/ + +/** + @defgroup WIZCHIP_register_W5100 WIZCHIP register + @ingroup W5100 + @brief WIZCHIP register defines register group of W5100 . + + - \ref Common_register_group_W5100 : Common register group W5100 + - \ref Socket_register_group_W5100 : \c SOCKET n register group W5100 +*/ + + +/** + @defgroup WIZCHIP_IO_Functions_W5100 WIZCHIP I/O functions + @ingroup W5100 + @brief This supports the basic I/O functions for \ref WIZCHIP_register_W5100. + + - Basic I/O function \n + WIZCHIP_READ(), WIZCHIP_WRITE(), WIZCHIP_READ_BUF(), WIZCHIP_WRITE_BUF() \n\n + + - \ref Common_register_group_W5100 access functions \n + -# @b Mode \n + getMR(), setMR() + -# @b Interrupt \n + getIR(), setIR(), getIMR(), setIMR(), + -# Network Information \n + getSHAR(), setSHAR(), getGAR(), setGAR(), getSUBR(), setSUBR(), getSIPR(), setSIPR() + -# @b Retransmission \n + getRCR(), setRCR(), getRTR(), setRTR() + -# @b PPPoE \n + getPTIMER(), setPTIMER(), getPMAGIC(), getPMAGIC() + + - \ref Socket_register_group_W5100 access functions \n + -# SOCKET control \n + getSn_MR(), setSn_MR(), getSn_CR(), setSn_CR(), getSn_IR(), setSn_IR() + -# SOCKET information \n + getSn_SR(), getSn_DHAR(), setSn_DHAR(), getSn_PORT(), setSn_PORT(), getSn_DIPR(), setSn_DIPR(), getSn_DPORT(), setSn_DPORT() + getSn_MSSR(), setSn_MSSR() + -# SOCKET communication \n + getSn_RXMEM_SIZE(), setSn_RXMEM_SIZE(), getSn_TXMEM_SIZE(), setSn_TXMEM_SIZE() \n + getSn_TX_RD(), getSn_TX_WR(), setSn_TX_WR() \n + getSn_RX_RD(), setSn_RX_RD(), getSn_RX_WR() \n + getSn_TX_FSR(), getSn_RX_RSR() + -# IP header field \n + getSn_FRAG(), setSn_FRAG(), getSn_TOS(), setSn_TOS() \n + getSn_TTL(), setSn_TTL() +*/ + +/** + @defgroup Common_register_group_W5100 Common register + @ingroup WIZCHIP_register_W5100 + @brief Common register group\n + It set the basic for the networking\n + It set the configuration such as interrupt, network information, ICMP, etc. + @details + @sa MR : Mode register. + @sa GAR, SUBR, SHAR, SIPR + @sa IR, Sn_IR, _IMR_ : Interrupt. + @sa _RTR_, _RCR_ : Data retransmission. + @sa PTIMER, PMAGIC : PPPoE. +*/ + + +/** + @defgroup Socket_register_group_W5100 Socket register + @ingroup WIZCHIP_register_W5100 + @brief Socket register group\n + Socket register configures and control SOCKETn which is necessary to data communication. + @details + @sa Sn_MR, Sn_CR, Sn_IR : SOCKETn Control + @sa Sn_SR, Sn_PORT, Sn_DHAR, Sn_DIPR, Sn_DPORT : SOCKETn Information + @sa Sn_MSSR, Sn_TOS, Sn_TTL, Sn_FRAG : Internet protocol. + @sa Sn_RXMEM_SIZE, Sn_TXMEM_SIZE, Sn_TX_FSR, Sn_TX_RD, Sn_TX_WR, Sn_RX_RSR, Sn_RX_RD, Sn_RX_WR : Data communication +*/ + +/** + @defgroup Basic_IO_function_W5100 Basic I/O function + @ingroup WIZCHIP_IO_Functions_W5100 + @brief These are basic input/output functions to read values from register or write values to register. +*/ + +/** + @defgroup Common_register_access_function_W5100 Common register access functions + @ingroup WIZCHIP_IO_Functions_W5100 + @brief These are functions to access common registers. +*/ + +/** + @defgroup Socket_register_access_function_W5100 Socket register access functions + @ingroup WIZCHIP_IO_Functions_W5100 + @brief These are functions to access socket registers. +*/ + +//----------------------------------------------------------------------------------- + +//----------------------------- W5100 Common Registers IOMAP ----------------------------- +/** + @ingroup Common_register_group_W5100 + @brief Mode Register address(R/W)\n + \ref MR is used for S/W reset, ping block mode, PPPoE mode and etc. + @details Each bit of \ref MR defined as follows. + + + +
    7 6 5 4 3 2 1 0
    RST Reserved WOL PB PPPoE Reserved AI IND
    + - \ref MR_RST : Reset + - \ref MR_PB : Ping block + - \ref MR_PPPOE : PPPoE mode + - \ref MR_AI : Address Auto-Increment in Indirect Bus Interface + - \ref MR_IND : Indirect Bus Interface mode +*/ +#if _WIZCHIP_IO_MODE_ == _WIZCHIP_IO_MODE_BUS_INDIR_ +#define MR (_WIZCHIP_IO_BASE_ + (0x0000)) // Mode +#else +#define MR (_W5100_IO_BASE_ + (0x0000)) // Mode +#endif + +/** + @ingroup Common_register_group_W5100 + @brief Gateway IP Register address(R/W) + @details \ref GAR configures the default gateway address. +*/ +#define GAR (_W5100_IO_BASE_ + (0x0001)) // GW Address + +/** + @ingroup Common_register_group_W5100 + @brief Subnet mask Register address(R/W) + @details \ref SUBR configures the subnet mask address. +*/ +#define SUBR (_W5100_IO_BASE_ + (0x0005)) // SN Mask Address + +/** + @ingroup Common_register_group_W5100 + @brief Source MAC Register address(R/W) + @details \ref SHAR configures the source hardware address. +*/ +#define SHAR (_W5100_IO_BASE_ + (0x0009)) // Source Hardware Address + +/** + @ingroup Common_register_group_W5100 + @brief Source IP Register address(R/W) + @details \ref SIPR configures the source IP address. +*/ +#define SIPR (_W5100_IO_BASE_ + (0x000F)) // Source IP Address + +// Reserved (_W5100_IO_BASE_ + (0x0013)) +// Reserved (_W5100_IO_BASE_ + (0x0014)) + +/** + @ingroup Common_register_group_W5100 + @brief Interrupt Register(R/W) + @details \ref IR indicates the interrupt status. Each bit of \ref IR will be still until the bit will be written to by the host. + If \ref IR is not equal to x00 INTn PIN is asserted to low until it is x00\n\n + Each bit of \ref IR defined as follows. + + + +
    7 6 5 4 3 2 1 0
    CONFLICT UNREACH PPPoE Reserved S3_INT S2_INT S1_INT S0_INT
    + - \ref IR_CONFLICT : IP conflict + - \ref IR_UNREACH : Destination unreachable + - \ref IR_PPPoE : PPPoE connection close + - \ref IR_SOCK(3) : SOCKET 3 Interrupt + - \ref IR_SOCK(2) : SOCKET 2 Interrupt + - \ref IR_SOCK(1) : SOCKET 1 Interrupt + - \ref IR_SOCK(0) : SOCKET 0 Interrupt +*/ +#define IR (_W5100_IO_BASE_ + (0x0015)) // Interrupt + +/** + @ingroup Common_register_group_W5100 + @brief Socket Interrupt Mask Register(R/W) + @details Each bit of \ref _IMR_ corresponds to each bit of \ref IR. + When a bit of \ref _IMR_ is and the corresponding bit of \ref IR is set, Interrupt will be issued. +*/ +#define _IMR_ (_W5100_IO_BASE_ + (0x0016)) // Socket Interrupt Mask + +/** + @ingroup Common_register_group_W5100 + @brief Timeout register address( 1 is 100us )(R/W) + @details \ref _RTR_ configures the retransmission timeout period. The unit of timeout period is 100us and the default of \ref _RTR_ is x07D0or 000 + And so the default timeout period is 200ms(100us X 2000). During the time configured by \ref _RTR_, W5100 waits for the peer response + to the packet that is transmitted by \ref Sn_CR (CONNECT, DISCON, CLOSE, SEND, SEND_MAC, SEND_KEEP command). + If the peer does not respond within the \ref _RTR_ time, W5100 retransmits the packet or issues timeout. +*/ +#define _RTR_ (_W5100_IO_BASE_ + (0x0017)) // Retry Time + +/** + @ingroup Common_register_group_W5100 + @brief Retry count register(R/W) + @details \ref _RCR_ configures the number of time of retransmission. + When retransmission occurs as many as ref _RCR_+1 Timeout interrupt is issued (\ref Sn_IR_TIMEOUT = '1'). +*/ +#define _RCR_ (_W5100_IO_BASE_ + (0x0019)) // Retry Count +#define RMSR (_W5100_IO_BASE_ + (0x001A)) // Receicve Memory Size +#define TMSR (_W5100_IO_BASE_ + (0x001B)) // Trnasmit Memory Size + + +/** + @ingroup Common_register_group_W5100 + @brief PPP LCP Request Timer register in PPPoE mode(R) + @details \ref PATR notifies authentication method that has been agreed at the connection with + PPPoE Server. W5100 supports two types of Authentication method - PAP and CHAP. +*/ +#define PATR (_W5100_IO_BASE_ + (0x001C)) + + +/** + @ingroup Common_register_group_W5100 + @brief PPP LCP Request Timer register in PPPoE mode(R) + @details \ref PTIMER configures the time for sending LCP echo request. The unit of time is 25ms. +*/ +#define PTIMER (_W5100_IO_BASE_ + (0x0028)) // PPP LCP RequestTimer + +/** + @ingroup Common_register_group_W5100 + @brief PPP LCP Magic number register in PPPoE mode(R) + @details \ref PMAGIC configures the 4bytes magic number to be used in LCP negotiation. +*/ +#define PMAGIC (_W5100_IO_BASE_ + (0x0029)) // PPP LCP Magic number + +#define UIPR0 (_W5100_IO_BASE_ + (0x002A)) +#define UPORT0 (_W5100_IO_BASE + (0x002E)) + + + +//----------------------------- W5100 Socket Registers ----------------------------- + +//--------------------------- For Backward Compatibility --------------------------- + +/** + @ingroup Socket_register_group_W5100 + @brief socket Mode register(R/W) + @details \ref Sn_MR configures the option or protocol type of Socket n.\n\n + Each bit of \ref Sn_MR defined as the following. + + + +
    7 6 5 4 3 2 1 0
    MULTI MF ND/MC Reserved Protocol[3] Protocol[2] Protocol[1] Protocol[0]
    + - \ref Sn_MR_MULTI : Support UDP Multicasting + - \ref Sn_MR_MF : Support MACRAW + - \ref Sn_MR_ND : No Delayed Ack(TCP) flag + - \ref Sn_MR_MC : IGMP version used in UDP mulitcasting + - Protocol + + + + + + +
    Protocol[3] Protocol[2] Protocol[1] Protocol[0] @b Meaning
    0 0 0 0 Closed
    0 0 0 1 TCP
    0 0 1 0 UDP
    0 1 0 0 MACRAW
    + - In case of Socket 0 + + + + +
    Protocol[3] Protocol[2] Protocol[1] Protocol[0] @b Meaning
    0 1 0 0 MACRAW
    0 1 0 1 PPPoE
    + - \ref Sn_MR_MACRAW : MAC LAYER RAW SOCK \n + - \ref Sn_MR_UDP : UDP + - \ref Sn_MR_TCP : TCP + - \ref Sn_MR_CLOSE : Unused socket + @note MACRAW mode should be only used in Socket 0. +*/ +#define Sn_MR(sn) (_W5100_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x0000)) // socket Mode register + +/** + @ingroup Socket_register_group_W5100 + @brief Socket command register(R/W) + @details This is used to set the command for Socket n such as OPEN, CLOSE, CONNECT, LISTEN, SEND, and RECEIVE.\n + After W5100 accepts the command, the \ref Sn_CR register is automatically cleared to 0x00. + Even though \ref Sn_CR is cleared to 0x00, the command is still being processed.\n + To check whether the command is completed or not, please check the \ref Sn_IR or \ref Sn_SR. + - \ref Sn_CR_OPEN : Initialize or open socket. + - \ref Sn_CR_LISTEN : Wait connection request in TCP mode(Server mode) + - \ref Sn_CR_CONNECT : Send connection request in TCP mode(Client mode) + - \ref Sn_CR_DISCON : Send closing request in TCP mode. + - \ref Sn_CR_CLOSE : Close socket. + - \ref Sn_CR_SEND : Update TX buffer pointer and send data. + - \ref Sn_CR_SEND_MAC : Send data with MAC address, so without ARP process. + - \ref Sn_CR_SEND_KEEP : Send keep alive message. + - \ref Sn_CR_RECV : Update RX buffer pointer and receive data. + - In case of S0_MR(P3:P0) = S0_MR_PPPoE + + + + + + + +
    Value Symbol Description
    0x23 PCON PPPoE connection begins by transmitting PPPoE discovery packet
    0x24 PDISCON Closes PPPoE connection
    0x25 PCR In each phase, it transmits REQ message.
    0x26 PCN In each phase, it transmits NAK message.
    0x27 PCJ In each phase, it transmits REJECT message.
    +*/ +#define Sn_CR(sn) (_W5100_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x0001)) // channel Sn_CR register + +/** + @ingroup Socket_register_group_W5100 + @brief Socket interrupt register(R) + @details \ref Sn_IR indicates the status of Socket Interrupt such as establishment, termination, receiving data, timeout).\n + When an interrupt occurs and the corresponding bit \ref IR_SOCK(N) in \ref _IMR_ are set, \ref IR_SOCK(N) in \ref IR becomes '1'.\n + In order to clear the \ref Sn_IR bit, the host should write the bit to \n + + + +
    7 6 5 4 3 2 1 0
    PRECV PFAIL PNEXT SEND_OK TIMEOUT RECV DISCON CON
    + - \ref Sn_IR_PRECV : PPP Receive Interrupt + - \ref Sn_IR_PFAIL : PPP Fail Interrupt + - \ref Sn_IR_PNEXT : PPP Next Phase Interrupt + - \ref Sn_IR_SENDOK : SEND_OK Interrupt + - \ref Sn_IR_TIMEOUT : TIMEOUT Interrupt + - \ref Sn_IR_RECV : RECV Interrupt + - \ref Sn_IR_DISCON : DISCON Interrupt + - \ref Sn_IR_CON : CON Interrupt +*/ +#define Sn_IR(sn) (_W5100_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x0002)) // channel interrupt register + +/** + @ingroup Socket_register_group_W5100 + @brief Socket status register(R) + @details \ref Sn_SR indicates the status of Socket n.\n + The status of Socket n is changed by \ref Sn_CR or some special control packet as SYN, FIN packet in TCP. + @par Normal status + - \ref SOCK_CLOSED : Closed + - \ref SOCK_INIT : Initiate state + - \ref SOCK_LISTEN : Listen state + - \ref SOCK_ESTABLISHED : Success to connect + - \ref SOCK_CLOSE_WAIT : Closing state + - \ref SOCK_UDP : UDP socket + - \ref SOCK_MACRAW : MAC raw mode socket + @par Temporary status during changing the status of Socket n. + - \ref SOCK_SYNSENT : This indicates Socket n sent the connect-request packet (SYN packet) to a peer. + - \ref SOCK_SYNRECV : It indicates Socket n successfully received the connect-request packet (SYN packet) from a peer. + - \ref SOCK_FIN_WAIT : Connection state + - \ref SOCK_CLOSING : Closing state + - \ref SOCK_TIME_WAIT : Closing state + - \ref SOCK_LAST_ACK : Closing state +*/ +#define Sn_SR(sn) (_W5100_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x0003)) // channel status register + +/** + @ingroup Socket_register_group_W5100 + @brief source port register(R/W) + @details \ref Sn_PORT configures the source port number of Socket n. + It is valid when Socket n is used in TCP/UDP mode. It should be set before OPEN command is ordered. +*/ +#define Sn_PORT(sn) (_W5100_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x0004)) // source port register + +/** + @ingroup Socket_register_group_W5100 + @brief Peer MAC register address(R/W) + @details \ref Sn_DHAR configures the destination hardware address of Socket n when using SEND_MAC command in UDP mode or + it indicates that it is acquired in ARP-process by CONNECT/SEND command. +*/ +#define Sn_DHAR(sn) (_W5100_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x0006)) // Peer MAC register address + +/** + @ingroup Socket_register_group_W5100 + @brief Peer IP register address(R/W) + @details \ref Sn_DIPR configures or indicates the destination IP address of Socket n. It is valid when Socket n is used in TCP/UDP mode. + In TCP client mode, it configures an IP address of TCP server before CONNECT command. + In TCP server mode, it indicates an IP address of TCP client after successfully establishing connection. + In UDP mode, it configures an IP address of peer to be received the UDP packet by SEND or SEND_MAC command. +*/ +#define Sn_DIPR(sn) (_W5100_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x000C)) // Peer IP register address + +/** + @ingroup Socket_register_group_W5100 + @brief Peer port register address(R/W) + @details \ref Sn_DPORT configures or indicates the destination port number of Socket n. It is valid when Socket n is used in TCP/UDP mode. + In TCP clientmode, it configures the listen port number of TCP server before CONNECT command. + In TCP Servermode, it indicates the port number of TCP client after successfully establishing connection. + In UDP mode, it configures the port number of peer to be transmitted the UDP packet by SEND/SEND_MAC command. +*/ +#define Sn_DPORT(sn) (_W5100_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x0010)) // Peer port register address + +/** + @ingroup Socket_register_group_W5100 + @brief Maximum Segment Size(Sn_MSSR0) register address(R/W) + @details \ref Sn_MSSR configures or indicates the MTU(Maximum Transfer Unit) of Socket n. +*/ +#define Sn_MSSR(sn) (_W5100_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x0012)) // Maximum Segment Size(Sn_MSSR0) register address + +/** + @ingroup Socket_register_group_W5100 + @brief IP Protocol(PROTO) Register(R/W) + @details \ref Sn_PROTO that sets the protocol number field of the IP header at the IP layer. It is + valid only in IPRAW mode, and ignored in other modes. +*/ +#define Sn_PROTO(sn) (_W5100_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x0014)) // Protocol of IP Header field register in IP raw mode + +/** + @ingroup Socket_register_group_W5100 + @brief IP Type of Service(TOS) Register(R/W) + @details \ref Sn_TOS configures the TOS(Type Of Service field in IP Header) of Socket n. + It is set before OPEN command. +*/ +#define Sn_TOS(sn) (_W5100_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + 0x0015) // IP Type of Service(TOS) Register + +/** + @ingroup Socket_register_group_W5100 + @brief IP Time to live(TTL) Register(R/W) + @details \ref Sn_TTL configures the TTL(Time To Live field in IP header) of Socket n. + It is set before OPEN command. +*/ +#define Sn_TTL(sn) (_W5100_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x0016)) // IP Time to live(TTL) Register + +// Reserved (_W5100_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x0017)) +// Reserved (_W5100_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x0018)) +// Reserved (_W5100_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x0019)) +// Reserved (_W5100_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x001A)) +// Reserved (_W5100_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x001B)) +// Reserved (_W5100_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x001C)) +// Reserved (_W5100_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x001D)) + +/** + @ingroup Socket_register_group_W5100 + @brief Transmit free memory size register(R) + @details \ref Sn_TX_FSR indicates the free size of Socket n TX Buffer Block. It is initialized to the configured size by \ref Sn_TXMEM_SIZE. + Data bigger than \ref Sn_TX_FSR should not be saved in the Socket n TX Buffer because the bigger data overwrites the previous saved data not yet sent. + Therefore, check before saving the data to the Socket n TX Buffer, and if data is equal or smaller than its checked size, + transmit the data with SEND/SEND_MAC command after saving the data in Socket n TX buffer. But, if data is bigger than its checked size, + transmit the data after dividing into the checked size and saving in the Socket n TX buffer. +*/ +#define Sn_TX_FSR(sn) (_W5100_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x0020)) // Transmit free memory size register + +/** + @ingroup Socket_register_group_W5100 + @brief Transmit memory read pointer register address(R) + @details \ref Sn_TX_RD is initialized by OPEN command. However, if Sn_MR(P[3:0]) is TCP mode(001), it is re-initialized while connecting with TCP. + After its initialization, it is auto-increased by SEND command. + SEND command transmits the saved data from the current \ref Sn_TX_RD to the \ref Sn_TX_WR in the Socket n TX Buffer. + After transmitting the saved data, the SEND command increases the \ref Sn_TX_RD as same as the \ref Sn_TX_WR. + If its increment value exceeds the maximum value 0xFFFF, (greater than 0x10000 and the carry bit occurs), + then the carry bit is ignored and will automatically update with the lower 16bits value. +*/ +#define Sn_TX_RD(sn) (_W5100_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x0022)) // Transmit memory read pointer register address + +/** + @ingroup Socket_register_group_W5100 + @brief Transmit memory write pointer register address(R/W) + @details \ref Sn_TX_WR is initialized by OPEN command. However, if Sn_MR(P[3:0]) is TCP mode(001), it is re-initialized while connecting with TCP.\n + It should be read or be updated like as follows.\n + 1. Read the starting address for saving the transmitting data.\n + 2. Save the transmitting data from the starting address of Socket n TX buffer.\n + 3. After saving the transmitting data, update \ref Sn_TX_WR to the increased value as many as transmitting data size. + If the increment value exceeds the maximum value 0xFFFF(greater than 0x10000 and the carry bit occurs), + then the carry bit is ignored and will automatically update with the lower 16bits value.\n + 4. Transmit the saved data in Socket n TX Buffer by using SEND/SEND command +*/ +#define Sn_TX_WR(sn) (_W5100_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x0024)) // Transmit memory write pointer register address + +/** + @ingroup Socket_register_group_W5100 + @brief Received data size register(R) + @details \ref Sn_RX_RSR indicates the data size received and saved in Socket n RX Buffer. + \ref Sn_RX_RSR does not exceed the \ref Sn_RXMEM_SIZE and is calculated as the difference between + Socket n RX Write Pointer (\ref Sn_RX_WR)and Socket n RX Read Pointer (\ref Sn_RX_RD) +*/ +#define Sn_RX_RSR(sn) (_W5100_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x0026)) // Received data size register + +/** + @ingroup Socket_register_group_W5100 + @brief Read point of Receive memory(R/W) + @details \ref Sn_RX_RD is initialized by OPEN command. Make sure to be read or updated as follows.\n + 1. Read the starting save address of the received data.\n + 2. Read data from the starting address of Socket n RX Buffer.\n + 3. After reading the received data, Update \ref Sn_RX_RD to the increased value as many as the reading size. + If the increment value exceeds the maximum value 0xFFFF, that is, is greater than 0x10000 and the carry bit occurs, + update with the lower 16bits value ignored the carry bit.\n + 4. Order RECV command is for notifying the updated \ref Sn_RX_RD to W5100. +*/ +#define Sn_RX_RD(sn) (_W5100_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x0028)) // Read point of Receive memory + +/** + @ingroup Socket_register_group_W5100 + @brief Write point of Receive memory(R) + @details \ref Sn_RX_WR is initialized by OPEN command and it is auto-increased by the data reception. + If the increased value exceeds the maximum value 0xFFFF, (greater than 0x10000 and the carry bit occurs), + then the carry bit is ignored and will automatically update with the lower 16bits value. +*/ +#define Sn_RX_WR(sn) (_W5100_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x002A)) // Write point of Receive memory + + +//----------------------------- W5100 Register values ----------------------------- + +/* MODE register values */ +/** + @brief Reset + @details If this bit is All internal registers will be initialized. It will be automatically cleared as after S/W reset. +*/ +#define MR_RST 0x80 ///< reset + + +/** + @brief Ping block + @details 0 : Disable Ping block\n + 1 : Enable Ping block\n + If the bit is it blocks the response to a ping request. +*/ +#define MR_PB 0x10 ///< ping block + +/** + @brief Enable PPPoE + @details 0 : DisablePPPoE mode\n + 1 : EnablePPPoE mode\n + If you use ADSL, this bit should be '1'. +*/ +#define MR_PPPOE 0x08 ///< enable pppoe + +/** + @brief Address Auto-Increment in Indirect Bus Interface + @details 0 : Disable auto-increment \n + 1 : Enable auto-incremente \n + At the Indirect Bus Interface mode, if this bit is set as ��1��, the address will + be automatically increased by 1 whenever read and write are performed. +*/ +#define MR_AI 0x02 ///< auto-increment in indirect mode + +/** + @brief Indirect Bus Interface mode + @details 0 : Disable Indirect bus Interface mode \n + 1 : Enable Indirect bus Interface mode \n + If this bit is set as ��1��, Indirect Bus Interface mode is set. +*/ +#define MR_IND 0x01 ///< enable indirect mode + +/* IR register values */ +/** + @brief Check IP conflict. + @details Bit is set as when own source IP address is same with the sender IP address in the received ARP request. +*/ +#define IR_CONFLICT 0x80 ///< check ip confict + +/** + @brief Get the destination unreachable message in UDP sending. + @details When receiving the ICMP (Destination port unreachable) packet, this bit is set as + When this bit is Destination Information such as IP address and Port number may be checked with the corresponding @ref UIPR & @ref UPORTR. +*/ +#define IR_UNREACH 0x40 ///< check destination unreachable + +/** + @brief Get the PPPoE close message. + @details When PPPoE is disconnected during PPPoE mode, this bit is set. +*/ +#define IR_PPPoE 0x20 ///< get the PPPoE close message + +#define IR_SOCK(sn) (0x01 << sn) ///< check socket interrupt + + +// Sn_MR values +/* Sn_MR Default values */ +/** + @brief Unused socket + @details This configures the protocol mode of Socket n. +*/ +#define Sn_MR_CLOSE 0x00 ///< unused socket + +/** + @brief TCP + @details This configures the protocol mode of Socket n. +*/ +#define Sn_MR_TCP 0x01 ///< TCP + +/** + @brief UDP + @details This configures the protocol mode of Socket n. +*/ +#define Sn_MR_UDP 0x02 ///< UDP +#define Sn_MR_IPRAW 0x03 ///< IP LAYER RAW SOCK + +/** + @brief MAC LAYER RAW SOCK + @details This configures the protocol mode of Socket n. + @note MACRAW mode should be only used in Socket 0. +*/ +#define Sn_MR_MACRAW 0x04 ///< MAC LAYER RAW SOCK + +/** + @brief PPPoE + @details This configures the protocol mode of Socket n. + @note PPPoE mode should be only used in Socket 0. +*/ +#define Sn_MR_PPPoE 0x05 ///< PPPoE + +/** + @brief No Delayed Ack(TCP), Multicast flag + @details 0 : Disable No Delayed ACK option\n + 1 : Enable No Delayed ACK option\n + This bit is applied only during TCP mode (P[3:0] = 001).\n + When this bit is It sends the ACK packet without delay as soon as a Data packet is received from a peer.\n + When this bit is It sends the ACK packet after waiting for the timeout time configured by \ref _RTR_. +*/ +#define Sn_MR_ND 0x20 ///< No Delayed Ack(TCP) flag + +/** + @brief Support UDP Multicasting + @details 0 : using IGMP version 2\n + 1 : using IGMP version 1\n + This bit is applied only during UDP mode(P[3:0] = 010 and MULTI = '1') + It configures the version for IGMP messages (Join/Leave/Report). +*/ +#define Sn_MR_MC Sn_MR_ND ///< Select IGMP version 1(0) or 2(1) + +/** + @brief MAC filter enable in @ref Sn_MR_MACRAW mode + @details 0 : disable MAC Filtering\n + 1 : enable MAC Filtering\n + This bit is applied only during MACRAW mode(P[3:0] = 100.\n + When set as W5100 can only receive broadcasting packet or packet sent to itself. + When this bit is W5100 can receive all packets on Ethernet. + If user wants to implement Hybrid TCP/IP stack, + it is recommended that this bit is set as for reducing host overhead to process the all received packets. +*/ +#define Sn_MR_MF 0x40 ///< Use MAC filter +#define Sn_MR_MFEN Sn_MR_MF + + +/* Sn_MR Default values */ +/** + @brief Support UDP Multicasting + @details 0 : disable Multicasting\n + 1 : enable Multicasting\n + This bit is applied only during UDP mode(P[3:0] = 010).\n + To use multicasting, \ref Sn_DIPR & \ref Sn_DPORT should be respectively configured with the multicast group IP address & port number + before Socket n is opened by OPEN command of \ref Sn_CR. +*/ +#define Sn_MR_MULTI 0x80 ///< support multicating + +/* Sn_CR values */ +/** + @brief Initialize or open socket + @details Socket n is initialized and opened according to the protocol selected in Sn_MR(P3:P0). + The table below shows the value of \ref Sn_SR corresponding to \ref Sn_MR.\n + + + + + + + + +
    \b Sn_MR (P[3:0]) \b Sn_SR
    Sn_MR_CLOSE (000) --
    Sn_MR_TCP (001) SOCK_INIT (0x13)
    Sn_MR_UDP (010) SOCK_UDP (0x22)
    S0_MR_IPRAW (011) SOCK_IPRAW (0x32)
    S0_MR_MACRAW (100) SOCK_MACRAW (0x42)
    S0_MR_PPPoE (101) SOCK_PPPoE (0x5F)
    +*/ +#define Sn_CR_OPEN 0x01 ///< initialize or open socket + +/** + @brief Wait connection request in TCP mode(Server mode) + @details This is valid only in TCP mode (Sn_MR(P3:P0) = \ref Sn_MR_TCP).// + In this mode, Socket n operates as a 'TCP server' and waits for connection-request (SYN packet) from any 'TCP client'.// + The \ref Sn_SR changes the state from SOCK_INIT to SOCKET_LISTEN.// + When a 'TCP client' connection request is successfully established, + the \ref Sn_SR changes from SOCK_LISTEN to SOCK_ESTABLISHED and the Sn_IR(0) becomes + But when a 'TCP client' connection request is failed, Sn_IR(3) becomes and the status of \ref Sn_SR changes to SOCK_CLOSED. +*/ +#define Sn_CR_LISTEN 0x02 ///< wait connection request in tcp mode(Server mode) + +/** + @brief Send connection request in TCP mode(Client mode) + @details To connect, a connect-request (SYN packet) is sent to TCP serverconfigured by \ref Sn_DIPR & Sn_DPORT(destination address & port). + If the connect-request is successful, the \ref Sn_SR is changed to \ref SOCK_ESTABLISHED and the Sn_IR(0) becomes \n\n + The connect-request fails in the following three cases.\n + 1. When a @b ARPTO occurs (\ref Sn_IR[3] = '1') because destination hardware address is not acquired through the ARP-process.\n + 2. When a @b SYN/ACK packet is not received and @b TCPTO (Sn_IR(3) ='1')\n + 3. When a @b RST packet is received instead of a @b SYN/ACK packet. In these cases, \ref Sn_SR is changed to \ref SOCK_CLOSED. + @note This is valid only in TCP mode and operates when Socket n acts as TCP client +*/ +#define Sn_CR_CONNECT 0x04 ///< send connection request in tcp mode(Client mode) + +/** + @brief Send closing request in TCP mode + @details Regardless of TCP serveror TCP client the DISCON command processes the disconnect-process (Active closeor Passive close.\n + @par Active close + it transmits disconnect-request(FIN packet) to the connected peer\n + @par Passive close + When FIN packet is received from peer, a FIN packet is replied back to the peer.\n + @details When the disconnect-process is successful (that is, FIN/ACK packet is received successfully), \ref Sn_SR is changed to \ref SOCK_CLOSED.\n + Otherwise, TCPTO occurs (Sn_IR(3)='1') and then \ref Sn_SR is changed to \ref SOCK_CLOSED. + @note Valid only in TCP mode. +*/ +#define Sn_CR_DISCON 0x08 ///< send closing reqeuset in tcp mode + +/** + @brief Close socket + @details Sn_SR is changed to \ref SOCK_CLOSED. +*/ +#define Sn_CR_CLOSE 0x10 + +/** + @brief Update TX buffer pointer and send data + @details SEND transmits all the data in the Socket n TX buffer.\n + For more details, please refer to Socket n TX Free Size Register (\ref Sn_TX_FSR), Socket n, + TX Write Pointer Register(\ref Sn_TX_WR), and Socket n TX Read Pointer Register(\ref Sn_TX_RD). +*/ +#define Sn_CR_SEND 0x20 + +/** + @brief Send data with MAC address, so without ARP process + @details The basic operation is same as SEND.\n + Normally SEND transmits data after destination hardware address is acquired by the automatic ARP-process(Address Resolution Protocol).\n + But SEND_MAC transmits data without the automatic ARP-process.\n + In this case, the destination hardware address is acquired from \ref Sn_DHAR configured by host, instead of APR-process. + @note Valid only in UDP mode. +*/ +#define Sn_CR_SEND_MAC 0x21 + +/** + @brief Send keep alive message + @details It checks the connection status by sending 1byte keep-alive packet.\n + If the peer can not respond to the keep-alive packet during timeout time, the connection is terminated and the timeout interrupt will occur. + @note Valid only in TCP mode. +*/ +#define Sn_CR_SEND_KEEP 0x22 + +/** + @brief Update RX buffer pointer and receive data + @details RECV completes the processing of the received data in Socket n RX Buffer by using a RX read pointer register (\ref Sn_RX_RD).\n + For more details, refer to Socket n RX Received Size Register (\ref Sn_RX_RSR), Socket n RX Write Pointer Register (\ref Sn_RX_WR), + and Socket n RX Read Pointer Register (\ref Sn_RX_RD). +*/ +#define Sn_CR_RECV 0x40 + +/** + @brief PPPoE connection + @details PPPoE connection begins by transmitting PPPoE discovery packet +*/ +#define Sn_CR_PCON 0x23 + +/** + @brief Closes PPPoE connection + @details Closes PPPoE connection +*/ +#define Sn_CR_PDISCON 0x24 + +/** + @brief REQ message transmission + @details In each phase, it transmits REQ message. +*/ +#define Sn_CR_PCR 0x25 + +/** + @brief NAK massage transmission + @details In each phase, it transmits NAK message. +*/ +#define Sn_CR_PCN 0x26 + +/** + @brief REJECT message transmission + @details In each phase, it transmits REJECT message. +*/ +#define Sn_CR_PCJ 0x27 + +/* Sn_IR values */ +/** + @brief PPP Receive Interrupt + @details PPP Receive Interrupts when the option which is not supported is received. +*/ +#define Sn_IR_PRECV 0x80 + +/** + @brief PPP Fail Interrupt + @details PPP Fail Interrupts when PAP Authentication is failed. +*/ +#define Sn_IR_PFAIL 0x40 + +/** + @brief PPP Next Phase Interrupt + @details PPP Next Phase Interrupts when the phase is changed during ADSL connection process. +*/ +#define Sn_IR_PNEXT 0x20 + +/** + @brief SEND_OK Interrupt + @details This is issued when SEND command is completed. +*/ +#define Sn_IR_SENDOK 0x10 ///< complete sending + +/** + @brief TIMEOUT Interrupt + @details This is issued when ARPTO or TCPTO occurs. +*/ +#define Sn_IR_TIMEOUT 0x08 ///< assert timeout + +/** + @brief RECV Interrupt + @details This is issued whenever data is received from a peer. +*/ +#define Sn_IR_RECV 0x04 + +/** + @brief DISCON Interrupt + @details This is issued when FIN or FIN/ACK packet is received from a peer. +*/ +#define Sn_IR_DISCON 0x02 + +/** + @brief CON Interrupt + @details This is issued one time when the connection with peer is successful and then \ref Sn_SR is changed to \ref SOCK_ESTABLISHED. +*/ +#define Sn_IR_CON 0x01 + +/* Sn_SR values */ +/** + @brief Closed + @details This indicates that Socket n is released.\n + When DICON, CLOSE command is ordered, or when a timeout occurs, it is changed to \ref SOCK_CLOSED regardless of previous status. +*/ +#define SOCK_CLOSED 0x00 ///< closed + +/** + @brief Initiate state + @details This indicates Socket n is opened with TCP mode.\n + It is changed to \ref SOCK_INIT when Sn_MR(P[3:0]) = 001)and OPEN command is ordered.\n + After \ref SOCK_INIT, user can use LISTEN /CONNECT command. +*/ +#define SOCK_INIT 0x13 ///< init state + +/** + @brief Listen state + @details This indicates Socket n is operating as TCP servermode and waiting for connection-request (SYN packet) from a peer (TCP client).\n + It will change to \ref SOCK_ESTABLISHED when the connection-request is successfully accepted.\n + Otherwise it will change to \ref SOCK_CLOSED after TCPTO occurred (Sn_IR(TIMEOUT) = '1'). +*/ +#define SOCK_LISTEN 0x14 + +/** + @brief Connection state + @details This indicates Socket n sent the connect-request packet (SYN packet) to a peer.\n + It is temporarily shown when \ref Sn_SR is changed from \ref SOCK_INIT to \ref SOCK_ESTABLISHED by CONNECT command.\n + If connect-accept(SYN/ACK packet) is received from the peer at SOCK_SYNSENT, it changes to \ref SOCK_ESTABLISHED.\n + Otherwise, it changes to \ref SOCK_CLOSED after TCPTO (\ref Sn_IR[TIMEOUT] = '1') is occurred. +*/ +#define SOCK_SYNSENT 0x15 + +/** + @brief Connection state + @details It indicates Socket n successfully received the connect-request packet (SYN packet) from a peer.\n + If socket n sends the response (SYN/ACK packet) to the peer successfully, it changes to \ref SOCK_ESTABLISHED. \n + If not, it changes to \ref SOCK_CLOSED after timeout occurs (\ref Sn_IR[TIMEOUT] = '1'). +*/ +#define SOCK_SYNRECV 0x16 + +/** + @brief Success to connect + @details This indicates the status of the connection of Socket n.\n + It changes to \ref SOCK_ESTABLISHED when the TCP SERVERprocessed the SYN packet from the TCP CLIENTduring \ref SOCK_LISTEN, or + when the CONNECT command is successful.\n + During \ref SOCK_ESTABLISHED, DATA packet can be transferred using SEND or RECV command. +*/ +#define SOCK_ESTABLISHED 0x17 + +/** + @brief Closing state + @details These indicate Socket n is closing.\n + These are shown in disconnect-process such as active-close and passive-close.\n + When Disconnect-process is successfully completed, or when timeout occurs, these change to \ref SOCK_CLOSED. +*/ +#define SOCK_FIN_WAIT 0x18 + +/** + @brief Closing state + @details These indicate Socket n is closing.\n + These are shown in disconnect-process such as active-close and passive-close.\n + When Disconnect-process is successfully completed, or when timeout occurs, these change to \ref SOCK_CLOSED. +*/ +#define SOCK_CLOSING 0x1A + +/** + @brief Closing state + @details These indicate Socket n is closing.\n + These are shown in disconnect-process such as active-close and passive-close.\n + When Disconnect-process is successfully completed, or when timeout occurs, these change to \ref SOCK_CLOSED. +*/ +#define SOCK_TIME_WAIT 0x1B + +/** + @brief Closing state + @details This indicates Socket n received the disconnect-request (FIN packet) from the connected peer.\n + This is half-closing status, and data can be transferred.\n + For full-closing, DISCON command is used. But For just-closing, @ref Sn_CR_CLOSE command is used. +*/ +#define SOCK_CLOSE_WAIT 0x1C + +/** + @brief Closing state + @details This indicates Socket n is waiting for the response (FIN/ACK packet) to the disconnect-request (FIN packet) by passive-close.\n + It changes to \ref SOCK_CLOSED when Socket n received the response successfully, or when timeout occurs (\ref Sn_IR[TIMEOUT] = '1'). +*/ +#define SOCK_LAST_ACK 0x1D + +/** + @brief UDP socket + @details This indicates Socket n is opened in UDP mode(Sn_MR(P[3:0]) = 010).\n + It changes to SOCK_UDP when Sn_MR(P[3:0]) = 010 and @ref Sn_CR_OPEN command is ordered.\n + Unlike TCP mode, data can be transfered without the connection-process. +*/ +#define SOCK_UDP 0x22 ///< udp socket + +/** + @brief IP raw mode socket + @details TThe socket is opened in IPRAW mode. The SOCKET status is change to SOCK_IPRAW when @ref Sn_MR (P3:P0) is + Sn_MR_IPRAW and @ref Sn_CR_OPEN command is used.\n + IP Packet can be transferred without a connection similar to the UDP mode. +*/ +#define SOCK_IPRAW 0x32 ///< ip raw mode socket + +/** + @brief MAC raw mode socket + @details This indicates Socket 0 is opened in MACRAW mode (@ref Sn_MR(P[3:0]) = '100' and n=0) and is valid only in Socket 0.\n + It changes to SOCK_MACRAW when @ref Sn_MR(P[3:0]) = '100' and @ref Sn_CR_OPEN command is ordered.\n + Like UDP mode socket, MACRAW mode Socket 0 can transfer a MAC packet (Ethernet frame) without the connection-process. +*/ +#define SOCK_MACRAW 0x42 ///< mac raw mode socket + +/** + @brief PPPoE mode socket + @details It is the status that SOCKET0 is open as PPPoE mode. It is changed to SOCK_PPPoE in case of S0_CR=OPEN and S0_MR + (P3:P0)=S0_MR_PPPoE.\n + It is temporarily used at the PPPoE + connection. +*/ +#define SOCK_PPPOE 0x5F ///< pppoe socket + +// IP PROTOCOL +#define IPPROTO_IP 0 ///< Dummy for IP +#define IPPROTO_ICMP 1 ///< Control message protocol +#define IPPROTO_IGMP 2 ///< Internet group management protocol +#define IPPROTO_GGP 3 ///< GW^2 (deprecated) +#define IPPROTO_TCP 6 ///< TCP +#define IPPROTO_PUP 12 ///< PUP +#define IPPROTO_UDP 17 ///< UDP +#define IPPROTO_IDP 22 ///< XNS idp +#define IPPROTO_ND 77 ///< UNOFFICIAL net disk protocol +#define IPPROTO_RAW 255 ///< Raw IP packet + +/** + @brief Enter a critical section + + @details It is provided to protect your shared code which are executed without distribution. \n \n + + In non-OS environment, It can be just implemented by disabling whole interrupt.\n + In OS environment, You can replace it to critical section api supported by OS. + + \sa WIZCHIP_READ(), WIZCHIP_WRITE(), WIZCHIP_READ_BUF(), WIZCHIP_WRITE_BUF() + \sa WIZCHIP_CRITICAL_EXIT() +*/ +#define WIZCHIP_CRITICAL_ENTER() WIZCHIP.CRIS._enter() + +#ifdef _exit +#undef _exit +#endif + +/** + @brief Exit a critical section + + @details It is provided to protect your shared code which are executed without distribution. \n\n + + In non-OS environment, It can be just implemented by disabling whole interrupt. \n + In OS environment, You can replace it to critical section api supported by OS. + + @sa WIZCHIP_READ(), WIZCHIP_WRITE(), WIZCHIP_READ_BUF(), WIZCHIP_WRITE_BUF() + @sa WIZCHIP_CRITICAL_ENTER() +*/ +#define WIZCHIP_CRITICAL_EXIT() WIZCHIP.CRIS._exit() + + + +//////////////////////// +// Basic I/O Function // +//////////////////////// +// +//M20150601 : uint16_t AddrSel --> uint32_t AddrSel +// +/** + @ingroup Basic_IO_function_W5100 + @brief It reads 1 byte value from a register. + @param AddrSel Register address + @return The value of register +*/ +uint8_t WIZCHIP_READ(uint32_t AddrSel); + +/** + @ingroup Basic_IO_function_W5100 + @brief It writes 1 byte value to a register. + @param AddrSel Register address + @param wb Write data + @return void +*/ +void WIZCHIP_WRITE(uint32_t AddrSel, uint8_t wb); + +/** + @ingroup Basic_IO_function_W5100 + @brief It reads sequence data from registers. + @param AddrSel Register address + @param pBuf Pointer buffer to read data + @param len Data length +*/ +void WIZCHIP_READ_BUF(uint32_t AddrSel, uint8_t* pBuf, uint16_t len); + +/** + @ingroup Basic_IO_function_W5100 + @brief It writes sequence data to registers. + @param AddrSel Register address + @param pBuf Pointer buffer to write data + @param len Data length +*/ +void WIZCHIP_WRITE_BUF(uint32_t AddrSel, uint8_t* pBuf, uint16_t len); + + +///////////////////////////////// +// Common Register IO function // +///////////////////////////////// + +/** + @ingroup Common_register_access_function_W5100 + @brief Set Mode Register + @param (uint8_t)mr The value to be set. + @sa getMR() +*/ +#if (_WIZCHIP_IO_MODE_ & _WIZCHIP_IO_MODE_SPI_) +#define setMR(mr) WIZCHIP_WRITE(MR,mr) +#else +#define setMR(mr) (*((uint8_t*)MR) = mr) +#endif + +/** + @ingroup Common_register_access_function_W5100 + @brief Get @ref MR. + @return uint8_t. The value of Mode register. + @sa setMR() +*/ +#if (_WIZCHIP_IO_MODE_ & _WIZCHIP_IO_MODE_SPI_) +#define getMR() WIZCHIP_READ(MR) +#else +#define getMR() (*(uint8_t*)MR) +#endif + +/** + @ingroup Common_register_access_function_W5100 + @brief Set @ref GAR. + @param (uint8_t*)gar Pointer variable to set gateway IP address. It should be allocated 4 bytes. + @sa getGAR() +*/ +#define setGAR(gar) \ + WIZCHIP_WRITE_BUF(GAR,gar,4) + +/** + @ingroup Common_register_access_function_W5100 + @brief Get @ref GAR. + @param (uint8_t*)gar Pointer variable to get gateway IP address. It should be allocated 4 bytes. + @sa setGAR() +*/ +#define getGAR(gar) \ + WIZCHIP_READ_BUF(GAR,gar,4) + +/** + @ingroup Common_register_access_function_W5100 + @brief Set @ref SUBR. + @param (uint8_t*)subr Pointer variable to set subnet mask address. It should be allocated 4 bytes. + @note If subr is null pointer, set the backup subnet to SUBR. \n + If subr is 0.0.0.0, back up SUBR and clear it. \n + Otherwize, set subr to SUBR + @sa getSUBR() +*/ +#define setSUBR(subr) \ + WIZCHIP_WRITE_BUF(SUBR,subr,4) + +/** + @ingroup Common_register_access_function_W5100 + @brief Get @ref SUBR. + @param (uint8_t*)subr Pointer variable to get subnet mask address. It should be allocated 4 bytes. + @sa setSUBR() +*/ +#define getSUBR(subr) \ + WIZCHIP_READ_BUF(SUBR, subr, 4) + +/** + @ingroup Common_register_access_function_W5100 + @brief Set @ref SHAR. + @param (uint8_t*)shar Pointer variable to set local MAC address. It should be allocated 6 bytes. + @sa getSHAR() +*/ +#define setSHAR(shar) \ + WIZCHIP_WRITE_BUF(SHAR, shar, 6) + +/** + @ingroup Common_register_access_function_W5100 + @brief Get @ref SHAR. + @param (uint8_t*)shar Pointer variable to get local MAC address. It should be allocated 6 bytes. + @sa setSHAR() +*/ +#define getSHAR(shar) \ + WIZCHIP_READ_BUF(SHAR, shar, 6) + +/** + @ingroup Common_register_access_function_W5100 + @brief Set @ref SIPR. + @param (uint8_t*)sipr Pointer variable to set local IP address. It should be allocated 4 bytes. + @sa getSIPR() +*/ +#define setSIPR(sipr) \ + WIZCHIP_WRITE_BUF(SIPR, sipr, 4) + +/** + @ingroup Common_register_access_function_W5100 + @brief Get @ref SIPR. + @param (uint8_t*)sipr Pointer variable to get local IP address. It should be allocated 4 bytes. + @sa setSIPR() +*/ +#define getSIPR(sipr) \ + WIZCHIP_READ_BUF(SIPR, sipr, 4) + +/** + @ingroup Common_register_access_function_W5100 + @brief Set \ref IR register + @param (uint8_t)ir Value to set \ref IR register. + @sa getIR() +*/ +#define setIR(ir) \ + WIZCHIP_WRITE(IR, (ir & 0xA0)) +/** + @ingroup Common_register_access_function_W5100 + @brief Get \ref IR register + @return uint8_t. Value of \ref IR register. + @sa setIR() +*/ +#define getIR() \ + (WIZCHIP_READ(IR) & 0xA0) + +/** + @ingroup Common_register_access_function_W5100 + @brief Set \ref _IMR_ register + @param (uint8_t)imr Value to set @ref _IMR_ register. + @sa getIMR() +*/ +#define setIMR(imr) \ + WIZCHIP_WRITE(_IMR_, imr) + +/** + @ingroup Common_register_access_function_W5100 + @brief Get \ref _IMR_ register + @return uint8_t. Value of @ref _IMR_ register. + @sa setIMR() +*/ +#define getIMR() \ + WIZCHIP_READ(_IMR_) + +/** + @ingroup Common_register_access_function_W5100 + @brief Set \ref _RTR_ register + @param (uint16_t)rtr Value to set @ref _RTR_ register. + @sa getRTR() +*/ +#define setRTR(rtr) {\ + WIZCHIP_WRITE(_RTR_, (uint8_t)(rtr >> 8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(_RTR_,1), (uint8_t) rtr); \ + } + +/** + @ingroup Common_register_access_function_W5100 + @brief Get \ref _RTR_ register + @return uint16_t. Value of @ref _RTR_ register. + @sa setRTR() +*/ +#define getRTR() \ + (((uint16_t)WIZCHIP_READ(_RTR_) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(_RTR_,1))) + +/** + @ingroup Common_register_access_function_W5100 + @brief Set \ref _RCR_ register + @param (uint8_t)rcr Value to set @ref _RCR_ register. + @sa getRCR() +*/ +#define setRCR(rcr) \ + WIZCHIP_WRITE(_RCR_, rcr) + +/** + @ingroup Common_register_access_function_W5100 + @brief Get \ref _RCR_ register + @return uint8_t. Value of @ref _RCR_ register. + @sa setRCR() +*/ +#define getRCR() \ + WIZCHIP_READ(_RCR_) + +/** + @ingroup Common_register_access_function_W5100 + @brief Get \ref RMSR register + @sa getRMSR() +*/ +#define setRMSR(rmsr) \ + WIZCHIP_WRITE(RMSR) // Receicve Memory Size + +/** + @ingroup Common_register_access_function_W5100 + @brief Get \ref RMSR register + @return uint8_t. Value of @ref RMSR register. + @sa setRMSR() +*/ +#define getRMSR() \ + WIZCHIP_READ() // Receicve Memory Size + +/** + @ingroup Common_register_access_function_W5100 + @brief Get \ref TMSR register + @sa getTMSR() +*/ +#define setTMSR(rmsr) \ + WIZCHIP_WRITE(TMSR) // Receicve Memory Size + +/** + @ingroup Common_register_access_function_W5100 + @brief Get \ref TMSR register + @return uint8_t. Value of @ref TMSR register. + @sa setTMSR() +*/ + + +/** + @ingroup Common_register_access_function_W5100 + @brief Get \ref PATR register + @return uint16_t. Value to set \ref PATR register +*/ +#define getPATR() \ + (((uint16_t)WIZCHIP_READ(PATR) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(PATR,1))) + +/** + @ingroup Common_register_access_function_W5100 + @brief Get \ref PPPALGO register + @return uint8_t. Value to set \ref PPPALGO register +*/ +#define getPPPALGO() \ + WIZCHIP_READ(PPPALGO) + + +/** + @ingroup Common_register_access_function_W5100 + @brief Set \ref PTIMER register + @param (uint8_t)ptimer Value to set \ref PTIMER register. + @sa getPTIMER() +*/ +#define setPTIMER(ptimer) \ + WIZCHIP_WRITE(PTIMER, ptimer) + +/** + @ingroup Common_register_access_function_W5100 + @brief Get \ref PTIMER register + @return uint8_t. Value of @ref PTIMER register. + @sa setPTIMER() +*/ +#define getPTIMER() \ + WIZCHIP_READ(PTIMER) + +/** + @ingroup Common_register_access_function_W5100 + @brief Set \ref PMAGIC register + @param (uint8_t)pmagic Value to set @ref PMAGIC register. + @sa getPMAGIC() +*/ +#define setPMAGIC(pmagic) \ + WIZCHIP_WRITE(PMAGIC, pmagic) + +/** + @ingroup Common_register_access_function_W5100 + @brief Get \ref PMAGIC register + @return uint8_t. Value of @ref PMAGIC register. + @sa setPMAGIC() +*/ +#define getPMAGIC() \ + WIZCHIP_READ(PMAGIC) + +/////////////////////////////////// +// Socket N register I/O function // +/////////////////////////////////// +/** + @ingroup Socket_register_access_function_W5100 + @brief Set @ref Sn_MR register + @param sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_ expect bit 4. + @param mr Value to set @ref Sn_MR + @sa getSn_MR() +*/ +#define setSn_MR(sn, mr) \ + WIZCHIP_WRITE(Sn_MR(sn),mr) + +/** + @ingroup Socket_register_access_function_W5100 + @brief Get @ref Sn_MR register + @param sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_ expect bit 4. + @return Value of @ref Sn_MR. + @sa setSn_MR() +*/ +#define getSn_MR(sn) \ + WIZCHIP_READ(Sn_MR(sn)) + +/** + @ingroup Socket_register_access_function_W5100 + @brief Set @ref Sn_CR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param (uint8_t)cr Value to set @ref Sn_CR + @sa getSn_CR() +*/ +#define setSn_CR(sn, cr) \ + WIZCHIP_WRITE(Sn_CR(sn), cr) + +/** + @ingroup Socket_register_access_function_W5100 + @brief Get @ref Sn_CR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint8_t. Value of @ref Sn_CR. + @sa setSn_CR() +*/ +#define getSn_CR(sn) \ + WIZCHIP_READ(Sn_CR(sn)) + +/** + @ingroup Socket_register_access_function_W5100 + @brief Set @ref Sn_IR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param (uint8_t)ir Value to set @ref Sn_IR + @sa getSn_IR() +*/ +#define setSn_IR(sn, ir) \ + WIZCHIP_WRITE(Sn_IR(sn), ir) + +/** + @ingroup Socket_register_access_function_W5100 + @brief Get @ref Sn_IR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint8_t. Value of @ref Sn_IR. + @sa setSn_IR() +*/ +#define getSn_IR(sn) \ + WIZCHIP_READ(Sn_IR(sn)) + +/** + @ingroup Socket_register_access_function_W5100 + @brief Get @ref Sn_SR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint8_t. Value of @ref Sn_SR. +*/ +#define getSn_SR(sn) \ + WIZCHIP_READ(Sn_SR(sn)) + +/** + @ingroup Socket_register_access_function_W5100 + @brief Set @ref Sn_PORT register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param (uint16_t)port Value to set @ref Sn_PORT. + @sa getSn_PORT() +*/ +#define setSn_PORT(sn, port) { \ + WIZCHIP_WRITE(Sn_PORT(sn), (uint8_t)(port >> 8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(Sn_PORT(sn),1), (uint8_t) port); \ + } + +#define setSn_PORTR setSn_PORT +/** + @ingroup Socket_register_access_function_W5100 + @brief Get @ref Sn_PORT register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint16_t. Value of @ref Sn_PORT. + @sa setSn_PORT() +*/ +#define getSn_PORT(sn) \ + (((uint16_t)WIZCHIP_READ(Sn_PORT(sn)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_PORT(sn),1))) + +/** + @ingroup Socket_register_access_function_W5100 + @brief Set @ref Sn_DHAR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param (uint8_t*)dhar Pointer variable to set socket n destination hardware address. It should be allocated 6 bytes. + @sa getSn_DHAR() +*/ +#define setSn_DHAR(sn, dhar) \ + WIZCHIP_WRITE_BUF(Sn_DHAR(sn), dhar, 6) + +/** + @ingroup Socket_register_access_function_W5100 + @brief Get @ref Sn_DHAR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param (uint8_t*)dhar Pointer variable to get socket n destination hardware address. It should be allocated 6 bytes. + @sa setSn_DHAR() +*/ +#define getSn_DHAR(sn, dhar) \ + WIZCHIP_READ_BUF(Sn_DHAR(sn), dhar, 6) + +/** + @ingroup Socket_register_access_function_W5100 + @brief Set @ref Sn_DIPR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param (uint8_t*)dipr Pointer variable to set socket n destination IP address. It should be allocated 4 bytes. + @sa getSn_DIPR() +*/ +#define setSn_DIPR(sn, dipr) \ + WIZCHIP_WRITE_BUF(Sn_DIPR(sn), dipr, 4) + +/** + @ingroup Socket_register_access_function_W5100 + @brief Get @ref Sn_DIPR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param (uint8_t*)dipr Pointer variable to get socket n destination IP address. It should be allocated 4 bytes. + @sa SetSn_DIPR() +*/ +#define getSn_DIPR(sn, dipr) \ + WIZCHIP_READ_BUF(Sn_DIPR(sn), dipr, 4) + +/** + /** + @ingroup Socket_register_access_function_W5100 + @brief Set @ref Sn_DPORT register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param (uint16_t)dport Value to set @ref Sn_DPORT + @sa getSn_DPORT() +*/ +#define setSn_DPORT(sn, dport) { \ + WIZCHIP_WRITE(Sn_DPORT(sn), (uint8_t) (dport>>8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(Sn_DPORT(sn),1), (uint8_t) dport); \ + } +#define setSn_DPORTR(sn, dport) setSn_DPORT(sn,dport) + +#define Sn_IMR(sn) (_W5100_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x002C)) +#define setSn_IMR(sn, imr) \ + WIZCHIP_WRITE(Sn_IMR(sn), (imr & 0x1F)) + +#define getSn_IMR(sn) \ + (WIZCHIP_READ(Sn_IMR(sn)) & 0x1F) + +/** + @ingroup Socket_register_access_function_W5100 + @brief Get @ref Sn_DPORT register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint16_t. Value of @ref Sn_DPORT. + @sa setSn_DPORT() +*/ +#define getSn_DPORT(sn) \ + (((uint16_t)WIZCHIP_READ(Sn_DPORT(sn)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_DPORT(sn),1))) +#define getSn_DPORTR(sn) getSn_DPORT(sn) +/** + @ingroup Socket_register_access_function_W5100 + @brief Set @ref Sn_MSSR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param (uint16_t)mss Value to set @ref Sn_MSSR + @sa setSn_MSSR() +*/ +#define setSn_MSSR(sn, mss) { \ + WIZCHIP_WRITE(Sn_MSSR(sn), (uint8_t)(mss>>8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(Sn_MSSR(sn),1), (uint8_t) mss); \ + } + +/** + @ingroup Socket_register_access_function_W5100 + @brief Get @ref Sn_MSSR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint16_t. Value of @ref Sn_MSSR. + @sa setSn_MSSR() +*/ +#define getSn_MSSR(sn) \ + (((uint16_t)WIZCHIP_READ(Sn_MSSR(sn)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_MSSR(sn),1))) + +/** + @ingroup Socket_register_access_function_W5100 + @brief Set @ref Sn_PROTO register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param (uint8_t)proto Value to set \ref Sn_PROTO + @sa getSn_PROTO() +*/ +#define setSn_PROTO(sn, proto) \ + WIZCHIP_WRITE(Sn_TOS(sn), tos) + +/** + @ingroup Socket_register_access_function_W5100 + @brief Get @ref Sn_PROTO register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint8_t. Value of @ref Sn_PROTO. + @sa setSn_PROTO() +*/ +#define getSn_PROTO(sn) \ + WIZCHIP_READ(Sn_TOS(sn)) + +/** + @ingroup Socket_register_access_function_W5100 + @brief Set @ref Sn_TOS register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param (uint8_t)tos Value to set @ref Sn_TOS + @sa getSn_TOS() +*/ +#define setSn_TOS(sn, tos) \ + WIZCHIP_WRITE(Sn_TOS(sn), tos) + +/** + @ingroup Socket_register_access_function_W5100 + @brief Get @ref Sn_TOS register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_ . + @return uint8_t. Value of Sn_TOS. + @sa setSn_TOS() +*/ +#define getSn_TOS(sn) \ + WIZCHIP_READ(Sn_TOS(sn)) + +/** + @ingroup Socket_register_access_function_W5100 + @brief Set @ref Sn_TTL register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_ . + @param (uint8_t)ttl Value to set @ref Sn_TTL + @sa getSn_TTL() +*/ +#define setSn_TTL(sn, ttl) \ + WIZCHIP_WRITE(Sn_TTL(sn), ttl) + +/** + @ingroup Socket_register_access_function_W5100 + @brief Get @ref Sn_TTL register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_ . + @return uint8_t. Value of @ref Sn_TTL. + @sa setSn_TTL() +*/ +#define getSn_TTL(sn) \ + WIZCHIP_READ(Sn_TTL(sn)) + +/** + @ingroup Socket_register_access_function_W5100 + @brief Set @ref Sn_RXMEM_SIZE register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_ . + @param (uint8_t)rxmemsize Value to set \ref Sn_RXMEM_SIZE + @sa getSn_RXMEM_SIZE() +*/ +#define setSn_RXMEM_SIZE(sn, rxmemsize) \ + WIZCHIP_WRITE(RMSR, (WIZCHIP_READ(RMSR) & ~(0x03 << (2*sn))) | (rxmemsize << (2*sn))) +#define setSn_RXBUF_SIZE(sn,rxmemsize) setSn_RXMEM_SIZE(sn,rxmemsize) + +/** + @ingroup Socket_register_access_function_W5100 + @brief Get @ref Sn_RXMEM_SIZE register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint8_t. Value of @ref Sn_RXMEM. + @sa setSn_RXMEM_SIZE() +*/ +#define getSn_RXMEM_SIZE(sn) \ + ((WIZCHIP_READ(RMSR) & (0x03 << (2*sn))) >> (2*sn)) +#define getSn_RXBUF_SIZE(sn) getSn_RXMEM_SIZE(sn) + +/** + @ingroup Socket_register_access_function_W5100 + @brief Set @ref Sn_TXMEM_SIZE register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param (uint8_t)txmemsize Value to set \ref Sn_TXMEM_SIZE + @sa getSn_TXMEM_SIZE() +*/ +#define setSn_TXMEM_SIZE(sn, txmemsize) \ + WIZCHIP_WRITE(TMSR, (WIZCHIP_READ(TMSR) & ~(0x03 << (2*sn))) | (txmemsize << (2*sn))) +#define setSn_TXBUF_SIZE(sn, txmemsize) setSn_TXMEM_SIZE(sn,txmemsize) + +/** + @ingroup Socket_register_access_function_W5100 + @brief Get @ref Sn_TXMEM_SIZE register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint8_t. Value of @ref Sn_TXMEM_SIZE. + @sa setSn_TXMEM_SIZE() +*/ +#define getSn_TXMEM_SIZE(sn) \ + ((WIZCHIP_READ(TMSR) & (0x03 << (2*sn))) >> (2*sn)) +#define getSn_TXBUF_SIZE(sn) getSn_TXMEM_SIZE(sn) + +/** + @ingroup Socket_register_access_function_W5100 + @brief Get @ref Sn_TX_FSR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint16_t. Value of @ref Sn_TX_FSR. +*/ +uint16_t getSn_TX_FSR(uint8_t sn); + +/** + @ingroup Socket_register_access_function_W5100 + @brief Get @ref Sn_TX_RD register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint16_t. Value of @ref Sn_TX_RD. +*/ +#define getSn_TX_RD(sn) \ + (((uint16_t)WIZCHIP_READ(Sn_TX_RD(sn)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_TX_RD(sn),1))) + +/** + @ingroup Socket_register_access_function_W5100 + @brief Set @ref Sn_TX_WR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param (uint16_t)txwr Value to set @ref Sn_TX_WR + @sa GetSn_TX_WR() +*/ +#define setSn_TX_WR(sn, txwr) { \ + WIZCHIP_WRITE(Sn_TX_WR(sn), (uint8_t)(txwr>>8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(Sn_TX_WR(sn),1), (uint8_t) txwr); \ + } + +/** + @ingroup Socket_register_access_function_W5100 + @brief Get @ref Sn_TX_WR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint16_t. Value of @ref Sn_TX_WR. + @sa setSn_TX_WR() +*/ +#define getSn_TX_WR(sn) \ + (((uint16_t)WIZCHIP_READ(Sn_TX_WR(sn)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_TX_WR(sn),1))) + +/** + @ingroup Socket_register_access_function_W5100 + @brief Get @ref Sn_RX_RSR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint16_t. Value of @ref Sn_RX_RSR. +*/ +uint16_t getSn_RX_RSR(uint8_t sn); + +/** + @ingroup Socket_register_access_function_W5100 + @brief Set @ref Sn_RX_RD register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param (uint16_t)rxrd Value to set @ref Sn_RX_RD + @sa getSn_RX_RD() +*/ +#define setSn_RX_RD(sn, rxrd) { \ + WIZCHIP_WRITE(Sn_RX_RD(sn), (uint8_t)(rxrd>>8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(Sn_RX_RD(sn),1), (uint8_t) rxrd); \ + } + +/** + @ingroup Socket_register_access_function_W5100 + @brief Get @ref Sn_RX_RD register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @regurn uint16_t. Value of @ref Sn_RX_RD. + @sa setSn_RX_RD() +*/ +#define getSn_RX_RD(sn) \ + (((uint16_t)WIZCHIP_READ(Sn_RX_RD(sn)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_RX_RD(sn),1))) + +/** + @ingroup Socket_register_access_function_W5100 + @brief Set @ref Sn_RX_WR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param (uint16_t)rxwr Value to set \ref Sn_RX_WR + @sa getSn_RX_WR() +*/ +#define setSn_RX_WR(sn, rxwr) { \ + WIZCHIP_WRITE(Sn_RX_WR(sn), (uint8_t)(rxwr>>8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(Sn_RX_WR(sn),1), (uint8_t) rxwr); \ + } + + +/** + @ingroup Socket_register_access_function_W5100 + @brief Get @ref Sn_RX_WR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint16_t. Value of @ref Sn_RX_WR. +*/ +#define getSn_RX_WR(sn) \ + (((uint16_t)WIZCHIP_READ(Sn_RX_WR(sn)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_RX_WR(sn),1))) + +/** + @ingroup Socket_register_access_function_W5100 + @brief Set @ref Sn_FRAG register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param (uint16_t)frag Value to set \ref Sn_FRAG + @sa getSn_FRAG() +*/ +#define setSn_FRAG(sn, frag) { \ + WIZCHIP_WRITE(Sn_FRAG(sn), (uint8_t)(frag >>8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(Sn_FRAG(sn),1), (uint8_t) frag); \ + } + +/** + @ingroup Socket_register_access_function_W5100 + @brief Get @ref Sn_FRAG register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint16_t. Value of @ref Sn_FRAG. + @sa setSn_FRAG() +*/ +#define getSn_FRAG(sn) \ + (((uint16_t)WIZCHIP_READ(Sn_FRAG(sn)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_FRAG(sn),1))) + +/** + @ingroup Socket_register_access_function_W5100 + @brief Get the max RX buffer size of socket sn + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint16_t. Max buffer size +*/ +#define getSn_RxMAX(sn) \ + ((uint16_t)(1 << getSn_RXMEM_SIZE(sn)) << 10) + + +/** + @ingroup Socket_register_access_function_W5100 + @brief Get the max TX buffer size of socket sn + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint16_t. Max buffer size +*/ +#define getSn_TxMAX(sn) \ + ((uint16_t)(1 << getSn_TXMEM_SIZE(sn)) << 10) + +/** + @ingroup Socket_register_access_function_W5100 + @brief Get the mask of socket sn RX buffer. + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint16_t. Mask value +*/ +#define getSn_RxMASK(sn) \ + (getSn_RxMAX(sn) - 1) + +/** + @ingroup Socket_register_access_function_W5100 + @brief Get the mask of socket sn TX buffer + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint16_t. Mask value +*/ +#define getSn_TxMASK(sn) \ + (getSn_TxMAX(sn) - 1) + +/** + @ingroup Socket_register_access_function_W5100 + @brief Get the base address of socket sn RX buffer. + @param sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint16_t. Value of Socket n RX buffer base address. +*/ +uint32_t getSn_RxBASE(uint8_t sn); + +/** + @ingroup Socket_register_access_function_W5100 + @brief Get the base address of socket sn TX buffer. + @param sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint16_t. Value of Socket n TX buffer base address. +*/ +uint32_t getSn_TxBASE(uint8_t sn); + +///////////////////////////////////// +// Sn_TXBUF & Sn_RXBUF IO function // +///////////////////////////////////// +/** + @ingroup Basic_IO_function_W5100 + @brief It copies data to internal TX memory + + @details This function reads the Tx write pointer register and after that, + it copies the wizdata(pointer buffer) of the length of len(variable) bytes to internal TX memory + and updates the Tx write pointer register. + This function is being called by send() and sendto() function also. + + @param sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param wizdata Pointer buffer to write data + @param len Data length + @sa wiz_recv_data() +*/ +void wiz_send_data(uint8_t sn, uint8_t *wizdata, uint16_t len); + +/** + @ingroup Basic_IO_function_W5100 + @brief It copies data to your buffer from internal RX memory + + @details This function read the Rx read pointer register and after that, + it copies the received data from internal RX memory + to wizdata(pointer variable) of the length of len(variable) bytes. + This function is being called by recv() also. + + @param sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param wizdata Pointer buffer to read data + @param len Data length + @sa wiz_send_data() +*/ +void wiz_recv_data(uint8_t sn, uint8_t *wizdata, uint16_t len); + +/** + @ingroup Basic_IO_function_W5100 + @brief It discard the received data in RX memory. + @details It discards the data of the length of len(variable) bytes in internal RX memory. + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param len Data length +*/ +void wiz_recv_ignore(uint8_t sn, uint16_t len); + +/// @cond DOXY_APPLY_CODE +#endif +/// @endcond + +#ifdef __cplusplus +} +#endif + +#endif //_W5100_H_ + + + diff --git a/Ethernet/W5100S/w5100s.c b/Ethernet/W5100S/w5100s.c new file mode 100644 index 0000000..6e65405 --- /dev/null +++ b/Ethernet/W5100S/w5100s.c @@ -0,0 +1,499 @@ +//***************************************************************************** +// +//! \file w5100S.c +//! \brief W5100S HAL Interface. +//! \version 1.0.0 +//! \date 2018/03/29 +//! \par Revision history +//! <2018/03/29> 1st Release +//! \author Peter +//! +//! Copyright (c) 2013, WIZnet Co., 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: +//! +//! * 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 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 "w5100s.h" + +#if (_WIZCHIP_ == W5100S) +/** + @brief This function writes the data into W5100S registers. +*/ +void WIZCHIP_WRITE(uint32_t AddrSel, uint8_t wb) { + uint8_t spi_data[4]; + + WIZCHIP_CRITICAL_ENTER(); + WIZCHIP.CS._select(); + +#if( (_WIZCHIP_IO_MODE_ == _WIZCHIP_IO_MODE_SPI_)) + if (!WIZCHIP.IF.SPI._write_burst) { // byte operation + WIZCHIP.IF.SPI._write_byte(0xF0); + WIZCHIP.IF.SPI._write_byte((AddrSel & 0xFF00) >> 8); + WIZCHIP.IF.SPI._write_byte((AddrSel & 0x00FF) >> 0); + WIZCHIP.IF.SPI._write_byte(wb); // Data write (write 1byte data) + } else { // burst operation + spi_data[0] = 0xF0; + spi_data[1] = (AddrSel & 0xFF00) >> 8; + spi_data[2] = (AddrSel & 0x00FF) >> 0; + spi_data[3] = wb; + WIZCHIP.IF.SPI._write_burst(spi_data, 4); + } +#elif ( (_WIZCHIP_IO_MODE_ == _WIZCHIP_IO_MODE_SPI_5500_) ) + if (!WIZCHIP.IF.SPI._write_burst) { // byte operation + WIZCHIP.IF.SPI._write_byte((AddrSel & 0xFF00) >> 8); + WIZCHIP.IF.SPI._write_byte((AddrSel & 0x00FF) >> 0); + WIZCHIP.IF.SPI._write_byte(0xF0); + WIZCHIP.IF.SPI._write_byte(wb); // Data write (write 1byte data) + } else { // burst operation + spi_data[0] = (AddrSel & 0xFF00) >> 8; + spi_data[1] = (AddrSel & 0x00FF) >> 0; + spi_data[2] = 0xF0; + spi_data[3] = wb; + WIZCHIP.IF.SPI._write_burst(spi_data, 4); + + } +#elif ( (_WIZCHIP_IO_MODE_ == _WIZCHIP_IO_MODE_BUS_INDIR_) ) + + //add indirect bus + //M20150601 : Rename the function for integrating with ioLibrary + //WIZCHIP.IF.BUS._write_byte(IDM_AR0,(AddrSel & 0xFF00) >> 8); + //WIZCHIP.IF.BUS._write_byte(IDM_AR1,(AddrSel & 0x00FF)); + //WIZCHIP.IF.BUS._write_byte(IDM_DR,wb); + WIZCHIP.IF.BUS._write_data(IDM_AR0, (AddrSel & 0xFF00) >> 8); + WIZCHIP.IF.BUS._write_data(IDM_AR1, (AddrSel & 0x00FF)); + WIZCHIP.IF.BUS._write_data(IDM_DR, wb); +#else +#error "Unknown _WIZCHIP_IO_MODE_ in W5100. !!!" +#endif + + WIZCHIP.CS._deselect(); + WIZCHIP_CRITICAL_EXIT(); +} +/** + @brief This function reads the value from W5100S registers. +*/ +uint8_t WIZCHIP_READ(uint32_t AddrSel) { + uint8_t ret; + uint8_t spi_data[3]; + WIZCHIP_CRITICAL_ENTER(); + WIZCHIP.CS._select(); + +#if( (_WIZCHIP_IO_MODE_ == _WIZCHIP_IO_MODE_SPI_)) + if (!WIZCHIP.IF.SPI._read_burst || !WIZCHIP.IF.SPI._write_burst) { // byte operation + WIZCHIP.IF.SPI._write_byte(0x0F); + WIZCHIP.IF.SPI._write_byte((AddrSel & 0xFF00) >> 8); + WIZCHIP.IF.SPI._write_byte((AddrSel & 0x00FF) >> 0); + } else { + spi_data[0] = 0x0F; + spi_data[1] = (AddrSel & 0xFF00) >> 8; + spi_data[2] = (AddrSel & 0x00FF) >> 0; + WIZCHIP.IF.SPI._write_burst(spi_data, 3); + } + ret = WIZCHIP.IF.SPI._read_byte(); +#elif ( (_WIZCHIP_IO_MODE_ == _WIZCHIP_IO_MODE_SPI_5500_) ) + if (!WIZCHIP.IF.SPI._read_burst || !WIZCHIP.IF.SPI._write_burst) { // burst operation + WIZCHIP.IF.SPI._write_byte((AddrSel & 0xFF00) >> 8); + WIZCHIP.IF.SPI._write_byte((AddrSel & 0x00FF) >> 0); + WIZCHIP.IF.SPI._write_byte(0x0F); + } else { + spi_data[0] = (AddrSel & 0xFF00) >> 8; + spi_data[1] = (AddrSel & 0x00FF) >> 0; + spi_data[2] = 0x0F + WIZCHIP.IF.SPI._write_burst(spi_data, 3); + } + ret = WIZCHIP.IF.SPI._read_byte(); +#elif ( (_WIZCHIP_IO_MODE_ == _WIZCHIP_IO_MODE_BUS_INDIR_) ) + + //add indirect bus + //M20150601 : Rename the function for integrating with ioLibrary + //WIZCHIP.IF.BUS._write_byte(IDM_AR0,(AddrSel & 0xFF00) >> 8); + //WIZCHIP.IF.BUS._write_byte(IDM_AR1,(AddrSel & 0x00FF)); + //ret = WIZCHIP.IF.BUS._read_byte(IDM_DR); + WIZCHIP.IF.BUS._write_data(IDM_AR0, (AddrSel & 0xFF00) >> 8); + WIZCHIP.IF.BUS._write_data(IDM_AR1, (AddrSel & 0x00FF)); + ret = WIZCHIP.IF.BUS._read_data(IDM_DR); + +#else +#error "Unknown _WIZCHIP_IO_MODE_ in W5100S. !!!" +#endif + + WIZCHIP.CS._deselect(); + WIZCHIP_CRITICAL_EXIT(); + return ret; +} + + +/** + @brief This function writes into W5100S memory(Buffer) +*/ +void WIZCHIP_WRITE_BUF(uint32_t AddrSel, uint8_t* pBuf, uint16_t len) { + uint8_t spi_data[3]; + uint16_t i = 0; + + WIZCHIP_CRITICAL_ENTER(); + WIZCHIP.CS._select(); //M20150601 : Moved here. + +#if((_WIZCHIP_IO_MODE_ == _WIZCHIP_IO_MODE_SPI_)) + + if (!WIZCHIP.IF.SPI._write_burst) { // byte operation + WIZCHIP.IF.SPI._write_byte(0xF0); + WIZCHIP.IF.SPI._write_byte((((uint16_t)(AddrSel + i)) & 0xFF00) >> 8); + WIZCHIP.IF.SPI._write_byte((((uint16_t)(AddrSel + i)) & 0x00FF) >> 0); + + for (i = 0; i < len; i++) { + WIZCHIP.IF.SPI._write_byte(pBuf[i]); // Data write (write 1byte data) + } + } else { // burst operation + spi_data[0] = 0xF0; + spi_data[1] = (((uint16_t)(AddrSel + i)) & 0xFF00) >> 8; + spi_data[2] = (((uint16_t)(AddrSel + i)) & 0x00FF) >> 0; + WIZCHIP.IF.SPI._write_burst(spi_data, 3); + WIZCHIP.IF.SPI._write_burst(pBuf, len); + } + +#elif ( (_WIZCHIP_IO_MODE_ == _WIZCHIP_IO_MODE_SPI_5500_) ) + if (!WIZCHIP.IF.SPI._write_burst) { // byte operation + WIZCHIP.IF.SPI._write_byte((((uint16_t)(AddrSel + i)) & 0xFF00) >> 8); + WIZCHIP.IF.SPI._write_byte((((uint16_t)(AddrSel + i)) & 0x00FF) >> 0); + WIZCHIP.IF.SPI._write_byte(0xF0); + + for (i = 0; i < len; i++) { + WIZCHIP.IF.SPI._write_byte(pBuf[i]); // Data write (write 1byte data) + } + } else { // burst operation + spi_data[0] = (((uint16_t)(AddrSel + i)) & 0xFF00) >> 8; + spi_data[1] = (((uint16_t)(AddrSel + i)) & 0x00FF) >> 0; + spi_data[2] = 0xF0; + WIZCHIP.IF.SPI._write_burst(spi_data, 3); + WIZCHIP.IF.SPI._write_burst(pBuf, len); + } +#elif ( (_WIZCHIP_IO_MODE_ == _WIZCHIP_IO_MODE_BUS_INDIR_) ) + //M20150601 : Rename the function for integrating with ioLibrary + /* + WIZCHIP_WRITE(MR,WIZCHIP_READ(MR) | MR_AI); + WIZCHIP.IF.BUS._write_byte(IDM_AR0,(AddrSel & 0xFF00) >> 8); + WIZCHIP.IF.BUS._write_byte(IDM_AR1,(AddrSel & 0x00FF)); + for(i = 0 ; i < len; i++) + WIZCHIP.IF.BUS._write_byte(IDM_DR,pBuf[i]); + WIZCHIP_WRITE(MR, WIZCHIP_READ(MR) & ~MR_AI); + */ + setMR(getMR() | MR_AI); +#if 1 + // 20231108 taylor + + uint8_t tAD[2]; + tAD[0] = (uint8_t)((AddrSel & 0x0000FF00) >> 8); + tAD[1] = (uint8_t)(AddrSel & 0x000000FF); + + WIZCHIP.IF.BUS._write_data_buf(IDM_AR0, tAD, 2, 1); + +#else + WIZCHIP.IF.BUS._write_data(IDM_AR0, (AddrSel & 0xFF00) >> 8); + WIZCHIP.IF.BUS._write_data(IDM_AR1, (AddrSel & 0x00FF)); +#endif + +#if 1 + // 20231108 taylor + WIZCHIP.IF.BUS._write_data_buf(IDM_DR, pBuf, len, 0); +#else + for (i = 0 ; i < len; i++) { + WIZCHIP.IF.BUS._write_data(IDM_DR, pBuf[i]); + } +#endif + setMR(getMR() & ~MR_AI); + +#else +#error "Unknown _WIZCHIP_IO_MODE_ in W5100S. !!!!" +#endif + + WIZCHIP.CS._deselect(); //M20150601 : Moved here. + WIZCHIP_CRITICAL_EXIT(); +} + +/** + @brief This function reads into W5100S memory(Buffer) +*/ + +void WIZCHIP_READ_BUF(uint32_t AddrSel, uint8_t* pBuf, uint16_t len) { + uint8_t spi_data[3]; + uint16_t i = 0; + WIZCHIP_CRITICAL_ENTER(); + WIZCHIP.CS._select(); //M20150601 : Moved here. + +#if( (_WIZCHIP_IO_MODE_ == _WIZCHIP_IO_MODE_SPI_) ) + if (!WIZCHIP.IF.SPI._read_burst || !WIZCHIP.IF.SPI._write_burst) { // byte operation + WIZCHIP.IF.SPI._write_byte(0x0F); + WIZCHIP.IF.SPI._write_byte((uint16_t)((AddrSel + i) & 0xFF00) >> 8); + WIZCHIP.IF.SPI._write_byte((uint16_t)((AddrSel + i) & 0x00FF) >> 0); + + for (i = 0; i < len; i++) { + pBuf[i] = WIZCHIP.IF.SPI._read_byte(); + } + } else { // burst operation + spi_data[0] = 0x0F; + spi_data[1] = (uint16_t)((AddrSel + i) & 0xFF00) >> 8; + spi_data[2] = (uint16_t)((AddrSel + i) & 0x00FF) >> 0; + WIZCHIP.IF.SPI._write_burst(spi_data, 3); + WIZCHIP.IF.SPI._read_burst(pBuf, len); + + } +#elif ( (_WIZCHIP_IO_MODE_ == _WIZCHIP_IO_MODE_SPI_5500_) ) + if (!WIZCHIP.IF.SPI._read_burst || !WIZCHIP.IF.SPI._write_burst) { // byte operation + WIZCHIP.IF.SPI._write_byte((uint16_t)((AddrSel + i) & 0xFF00) >> 8); + WIZCHIP.IF.SPI._write_byte((uint16_t)((AddrSel + i) & 0x00FF) >> 0); + WIZCHIP.IF.SPI._write_byte(0x0F); + + for (i = 0; i < len; i++) { + pBuf[i] = WIZCHIP.IF.SPI._read_byte(); + } + } else { // burst operation + spi_data[0] = (uint16_t)((AddrSel + i) & 0xFF00) >> 8; + spi_data[1] = (uint16_t)((AddrSel + i) & 0x00FF) >> 0; + spi_data[2] = 0x0F; + WIZCHIP.IF.SPI._write_burst(spi_data, 3); + WIZCHIP.IF.SPI._read_burst(pBuf, len); + } + + +#elif ( (_WIZCHIP_IO_MODE_ == _WIZCHIP_IO_MODE_BUS_INDIR_) ) + //M20150601 : Rename the function for integrating with ioLibrary + /* + WIZCHIP_WRITE(MR, WIZCHIP_READ(MR) | MR_AI); + WIZCHIP.IF.BUS._write_byte(IDM_AR0,(AddrSel & 0xFF00) >> 8); + WIZCHIP.IF.BUS._write_byte(IDM_AR1,(AddrSel & 0x00FF)); + for(i = 0 ; i < len; i++) + pBuf[i] = WIZCHIP.IF.BUS._read_byte(IDM_DR); + WIZCHIP_WRITE(MR, WIZCHIP_READ(MR) & ~MR_AI); + */ + setMR(getMR() | MR_AI); +#if 1 + // 20231108 taylor + + uint8_t tAD[2]; + tAD[0] = (uint8_t)((AddrSel & 0x0000FF00) >> 8); + tAD[1] = (uint8_t)(AddrSel & 0x000000FF); + + WIZCHIP.IF.BUS._write_data_buf(IDM_AR0, tAD, 2, 1); + +#else + WIZCHIP.IF.BUS._write_data(IDM_AR0, (AddrSel & 0xFF00) >> 8); + WIZCHIP.IF.BUS._write_data(IDM_AR1, (AddrSel & 0x00FF)); +#endif + +#if 1 + // 20231108 taylor + WIZCHIP.IF.BUS._read_data_buf(IDM_DR, pBuf, len, 0); +#else + for (i = 0 ; i < len; i++) { + pBuf[i] = WIZCHIP.IF.BUS._read_data(IDM_DR); + } +#endif + setMR(getMR() & ~MR_AI); + +#else +#error "Unknown _WIZCHIP_IO_MODE_ in W5100S. !!!!" +#endif + + WIZCHIP.CS._deselect(); //M20150601 : Moved Here. + WIZCHIP_CRITICAL_EXIT(); +} + +/////////////////////////////////// +// Socket N regsiter IO function // +/////////////////////////////////// + +uint16_t getSn_TX_FSR(uint8_t sn) { + uint16_t val = 0, val1 = 0; + do { + val1 = WIZCHIP_READ(Sn_TX_FSR(sn)); + val1 = (val1 << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_TX_FSR(sn), 1)); + if (val1 != 0) { + val = WIZCHIP_READ(Sn_TX_FSR(sn)); + val = (val << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_TX_FSR(sn), 1)); + } + } while (val != val1); + return val; +} + + +uint16_t getSn_RX_RSR(uint8_t sn) { + uint16_t val = 0, val1 = 0; + do { + val1 = WIZCHIP_READ(Sn_RX_RSR(sn)); + val1 = (val1 << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_RX_RSR(sn), 1)); + if (val1 != 0) { + val = WIZCHIP_READ(Sn_RX_RSR(sn)); + val = (val << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_RX_RSR(sn), 1)); + } + } while (val != val1); + return val; +} + +///////////////////////////////////// +// Sn_TXBUF & Sn_RXBUF IO function // +///////////////////////////////////// +uint32_t getSn_RxBASE(uint8_t sn) { + int8_t i; +#if ( _WIZCHIP_IO_MODE_ == _WIZCHIP_IO_MODE_BUS_DIR_) + uint32_t rxbase = _W5100S_IO_BASE_ + _WIZCHIP_IO_RXBUF_; +#else + uint32_t rxbase = _WIZCHIP_IO_RXBUF_; +#endif + for (i = 0; i < sn; i++) { + rxbase += getSn_RxMAX(i); + } + + return rxbase; +} + +uint32_t getSn_TxBASE(uint8_t sn) { + int8_t i; +#if ( _WIZCHIP_IO_MODE_ == _WIZCHIP_IO_MODE_BUS_DIR_) + uint32_t txbase = _W5100S_IO_BASE_ + _WIZCHIP_IO_TXBUF_; +#else + uint32_t txbase = _WIZCHIP_IO_TXBUF_; +#endif + for (i = 0; i < sn; i++) { + txbase += getSn_TxMAX(i); + } + return txbase; +} + +/** + @brief This function is being called by send() and sendto() function also. for copy the data form application buffer to Transmite buffer of the chip. + + This function read the Tx write pointer register and after copy the data in buffer update the Tx write pointer + register. User should read upper byte first and lower byte later to get proper value. + And this function is being used for copy the data form application buffer to Transmite + buffer of the chip. It calculate the actual physical address where one has to write + the data in transmite buffer. Here also take care of the condition while it exceed + the Tx memory uper-bound of socket. + +*/ +void wiz_send_data(uint8_t sn, uint8_t *wizdata, uint16_t len) { + uint16_t ptr; + uint16_t size; + uint16_t dst_mask; + uint16_t dst_ptr; + + ptr = getSn_TX_WR(sn); + + dst_mask = ptr & getSn_TxMASK(sn); + dst_ptr = getSn_TxBASE(sn) + dst_mask; + + if (dst_mask + len > getSn_TxMAX(sn)) { + size = getSn_TxMAX(sn) - dst_mask; + WIZCHIP_WRITE_BUF(dst_ptr, wizdata, size); + wizdata += size; + size = len - size; + dst_ptr = getSn_TxBASE(sn); + WIZCHIP_WRITE_BUF(dst_ptr, wizdata, size); + } else { + WIZCHIP_WRITE_BUF(dst_ptr, wizdata, len); + } + + ptr += len; + + setSn_TX_WR(sn, ptr); +} + + +/** + @brief This function is being called by recv() also. This function is being used for copy the data form Receive buffer of the chip to application buffer. + + This function read the Rx read pointer register + and after copy the data from receive buffer update the Rx write pointer register. + User should read upper byte first and lower byte later to get proper value. + It calculate the actual physical address where one has to read + the data from Receive buffer. Here also take care of the condition while it exceed + the Rx memory uper-bound of socket. +*/ +void wiz_recv_data(uint8_t sn, uint8_t *wizdata, uint16_t len) { + uint16_t ptr; + uint16_t size; + uint16_t src_mask; + uint16_t src_ptr; + + ptr = getSn_RX_RD(sn); + + src_mask = (uint32_t)ptr & getSn_RxMASK(sn); + src_ptr = (getSn_RxBASE(sn) + src_mask); + + + if ((src_mask + len) > getSn_RxMAX(sn)) { + size = getSn_RxMAX(sn) - src_mask; + WIZCHIP_READ_BUF((uint32_t)src_ptr, (uint8_t*)wizdata, size); + wizdata += size; + size = len - size; + src_ptr = getSn_RxBASE(sn); + WIZCHIP_READ_BUF(src_ptr, (uint8_t*)wizdata, size); + } else { + WIZCHIP_READ_BUF(src_ptr, (uint8_t*)wizdata, len); + } + + ptr += len; + + setSn_RX_RD(sn, ptr); +} + +void wiz_recv_ignore(uint8_t sn, uint16_t len) { + uint16_t ptr; + + ptr = getSn_RX_RD(sn); + + ptr += len; + setSn_RX_RD(sn, ptr); +} + +void wiz_mdio_write(uint8_t PHYMDIO_regadr, uint16_t var) { + WIZCHIP_WRITE(PHYRAR, PHYMDIO_regadr); + WIZCHIP_WRITE(PHYDIR, (uint8_t)(var >> 8)); + WIZCHIP_WRITE(PHYDIR + 1, (uint8_t)(var)); + WIZCHIP_WRITE(PHYACR, PHYACR_WRITE); + while (WIZCHIP_READ(PHYACR)); //wait for command complete +} + +uint16_t wiz_mdio_read(uint8_t PHYMDIO_regadr) { + WIZCHIP_WRITE(PHYRAR, PHYMDIO_regadr); + WIZCHIP_WRITE(PHYACR, PHYACR_READ); + while (WIZCHIP_READ(PHYACR)); //wait for command complete + return ((uint16_t)WIZCHIP_READ(PHYDOR) << 8) | WIZCHIP_READ(PHYDOR + 1); +} + +void wiz_delay_ms(uint32_t milliseconds) { + uint32_t i; + for (i = 0 ; i < milliseconds ; i++) { + //Write any values to clear the TCNTCLKR register + setTCNTCLKR(0xff); + + // Wait until counter register value reaches 10.(10 = 1ms : TCNTR is 100us tick counter register) + while (getTCNTR() < 0x0a) {} + } +} + +#endif diff --git a/Ethernet/W5100S/w5100s.h b/Ethernet/W5100S/w5100s.h new file mode 100644 index 0000000..3d0d296 --- /dev/null +++ b/Ethernet/W5100S/w5100s.h @@ -0,0 +1,3322 @@ +//* **************************************************************************** +//! \file w5100S.h +//! \brief W5100S HAL Header File. +//! \version 1.0.0 +//! \date 2018/03/29 +//! \par Revision history +//! <2018/03/29> 1st Release +//! \author Peter +//! \copyright +//! +//! Copyright (c) 2013, WIZnet Co., 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: +//! +//! * 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 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 _W5100S_H_ +#define _W5100S_H_ + +#ifdef __cplusplus +extern "C" { +#endif + +#include +#include "wizchip_conf.h" + +/// \cond DOXY_APPLY_CODE +#if (_WIZCHIP_ == W5100S) +/// \endcond + +#define _WIZCHIP_SN_BASE_ (0x0400) +#define _WIZCHIP_SN_SIZE_ (0x0100) +#define _WIZCHIP_IO_TXBUF_ (0x4000) /* Internal Tx buffer address of the iinchip */ +#define _WIZCHIP_IO_RXBUF_ (0x6000) /* Internal Rx buffer address of the iinchip */ + + +#define WIZCHIP_CREG_BLOCK 0x00 ///< Common register block +#define WIZCHIP_SREG_BLOCK(N) (_WIZCHIP_SN_BASE_+ _WIZCHIP_SN_SIZE_*N) ///< Socket N register block + +#define WIZCHIP_OFFSET_INC(ADDR, N) (ADDR + N) ///< Increase offset address + +#if (_WIZCHIP_IO_MODE_ == _WIZCHIP_IO_MODE_BUS_DIR_) +#define _W5100S_IO_BASE_ _WIZCHIP_IO_BASE_ +#elif (_WIZCHIP_IO_MODE_ == _WIZCHIP_IO_MODE_BUS_INDIR_) +#define IDM_OR ((_WIZCHIP_IO_BASE + 0x0000)) +#define IDM_AR0 ((_WIZCHIP_IO_BASE_ + 0x0001)) +#define IDM_AR1 ((_WIZCHIP_IO_BASE_ + 0x0002)) +#define IDM_DR ((_WIZCHIP_IO_BASE_ + 0x0003)) +#define _W5100S_IO_BASE_ 0x0000 +#elif (_WIZCHIP_IO_MODE_ & _WIZCHIP_IO_MODE_SPI_) +#define _W5100S_IO_BASE_ 0x0000 +#endif + +/////////////////////////////////////// +// Definition For Legacy Chip Driver // +/////////////////////////////////////// +#define IINCHIP_READ(ADDR) WIZCHIP_READ(ADDR) ///< The defined for legacy chip driver +#define IINCHIP_WRITE(ADDR,VAL) WIZCHIP_WRITE(ADDR,VAL) ///< The defined for legacy chip driver +#define IINCHIP_READ_BUF(ADDR,BUF,LEN) WIZCHIP_READ_BUF(ADDR,BUF,LEN) ///< The defined for legacy chip driver +#define IINCHIP_WRITE_BUF(ADDR,BUF,LEN) WIZCHIP_WRITE(ADDR,BUF,LEN) ///< The defined for legacy chip driver + + +//----------- defgroup -------------------------------- + +/** + @defgroup W5100S W5100S + @brief WHIZCHIP register defines and I/O functions of @b W5100S. + + - @ref WIZCHIP_register_W5100S: @ref Common_register_group_W5100S and @ref Socket_register_group_W5100S + - @ref WIZCHIP_IO_Functions_W5100S: @ref Basic_IO_function_W5100S, @ref Common_register_access_function_W5100S and @ref Special_function_W5100S +*/ + +/** + @defgroup WIZCHIP_register_W5100S WIZCHIP register + @ingroup W5100S + @brief WIZCHIP register defines register group of W5100S . + + - \ref Common_register_group_W5100S : Common register group W5100S + - \ref Socket_register_group_W5100S : \c SOCKET n register group W5100S +*/ + + +/** + @defgroup WIZCHIP_IO_Functions_W5100S WIZCHIP I/O functions + @ingroup W5100S + @brief This supports the basic I/O functions for \ref WIZCHIP_register_W5100S. + + - Basic I/O function \n + WIZCHIP_READ(), WIZCHIP_WRITE(), WIZCHIP_READ_BUF(), WIZCHIP_WRITE_BUF(), wiz_recv_data(), wiz_recv_ignore(), wiz_send_data() \n\n + + - \ref Common_register_group_W5100S access functions \n + -# @b Mode \n + getMR(), setMR() + -# @b Interrupt \n + getIR(), setIR(), getIMR(), setIMR(), + -# Network Information \n + getSHAR(), setSHAR(), getGAR(), setGAR(), getSUBR(), setSUBR(), getSIPR(), setSIPR() + -# @b Retransmission \n + getRCR(), setRCR(), getRTR(), setRTR() + -# @b PPPoE \n + getPTIMER(), setPTIMER(), getPMAGIC(), getPMAGIC() + + - \ref Socket_register_group_W5100S access functions \n + -# SOCKET control \n + getSn_MR(), setSn_MR(), getSn_CR(), setSn_CR(), getSn_IR(), setSn_IR() + -# SOCKET information \n + getSn_SR(), getSn_DHAR(), setSn_DHAR(), getSn_PORT(), setSn_PORT(), getSn_DIPR(), setSn_DIPR(), getSn_DPORT(), setSn_DPORT() + getSn_MSSR(), setSn_MSSR() + -# SOCKET communication \n + getSn_RXMEM_SIZE(), setSn_RXMEM_SIZE(), getSn_TXMEM_SIZE(), setSn_TXMEM_SIZE() \n + getSn_TX_RD(), getSn_TX_WR(), setSn_TX_WR() \n + getSn_RX_RD(), setSn_RX_RD(), getSn_RX_WR() \n + getSn_TX_FSR(), getSn_RX_RSR() + -# IP header field \n + getSn_FRAG(), setSn_FRAG(), getSn_TOS(), setSn_TOS() \n + getSn_TTL(), setSn_TTL() +*/ + +/** + @defgroup Common_register_group_W5100S Common register + @ingroup WIZCHIP_register_W5100S + @brief Common register group\n + It set the basic for the networking\n + It set the configuration such as interrupt, network information, ICMP, etc. + @details + @sa MR : Mode register. + @sa GAR, SUBR, SHAR, SIPR + @sa IR, Sn_IR, _IMR_ : Interrupt. + @sa _RTR_, _RCR_ : Data retransmission. + @sa PTIMER, PMAGIC : PPPoE. +*/ + + +/** + @defgroup Socket_register_group_W5100S Socket register + @ingroup WIZCHIP_register_W5100S + @brief Socket register group\n + Socket register configures and control SOCKETn which is necessary to data communication. + @details + @sa Sn_MR, Sn_CR, Sn_IR : SOCKETn Control + @sa Sn_SR, Sn_PORT, Sn_DHAR, Sn_DIPR, Sn_DPORT : SOCKETn Information + @sa Sn_MSSR, Sn_TOS, Sn_TTL, Sn_FRAGR : Internet protocol. + @sa Sn_RXMEM_SIZE, Sn_TXMEM_SIZE, Sn_TX_FSR, Sn_TX_RD, Sn_TX_WR, Sn_RX_RSR, Sn_RX_RD, Sn_RX_WR : Data communication +*/ + +/** + @defgroup Basic_IO_function_W5100S Basic I/O function + @ingroup WIZCHIP_IO_Functions_W5100S + @brief These are basic input/output functions to read values from register or write values to register. +*/ + +/** + @defgroup Common_register_access_function_W5100S Common register access functions + @ingroup WIZCHIP_IO_Functions_W5100S + @brief These are functions to access common registers. +*/ + +/** + @defgroup Socket_register_access_function_W5100S Socket register access functions + @ingroup WIZCHIP_IO_Functions_W5100S + @brief These are functions to access socket registers. +*/ + +/** + @defgroup Special_function_W5100S Special functions + @ingroup WIZCHIP_IO_Functions_W5100S + @brief These are special functions to access to the PHY +*/ + +//----------------------------------------------------------------------------------- + +//----------------------------- W5100S Common Registers IOMAP ----------------------------- +/** + @ingroup Common_register_group_W5100S + @brief Mode Register address(R/W)\n + \ref MR is used for S/W reset, ping block mode, PPPoE mode and etc. + @details Each bit of \ref MR defined as follows. + + + +
    7 6 5 4 3 2 1 0
    RST Reserved WOL PB PPPoE Reserved AI IND
    + - \ref MR_RST : Reset + - \ref MR_PB : Ping block + - \ref MR_PPPOE : PPPoE mode + - \ref MR_AI : Address Auto-Increment in Indirect Bus Interface + - \ref MR_IND : Indirect Bus Interface mode +*/ +#if _WIZCHIP_IO_MODE_ == _WIZCHIP_IO_MODE_BUS_INDIR_ +#define MR (_WIZCHIP_IO_BASE_ + (0x0000)) // Mode +#else +#define MR (_W5100S_IO_BASE_ + (0x0000)) // Mode +#endif + +/** + @ingroup Common_register_group_W5100S + @brief Gateway IP Register address(R/W) + @details \ref GAR configures the default gateway address. +*/ +#define GAR (_W5100S_IO_BASE_ + (0x0001)) // GW Address + +/** + @ingroup Common_register_group_W5100S + @brief Subnet mask Register address(R/W) + @details \ref SUBR configures the subnet mask address. +*/ +#define SUBR (_W5100S_IO_BASE_ + (0x0005)) // SN Mask Address + +/** + @ingroup Common_register_group_W5100S + @brief Source MAC Register address(R/W) + @details \ref SHAR configures the source hardware address. +*/ +#define SHAR (_W5100S_IO_BASE_ + (0x0009)) // Source Hardware Address + +/** + @ingroup Common_register_group_W5100S + @brief Source IP Register address(R/W) + @details \ref SIPR configures the source IP address. +*/ +#define SIPR (_W5100S_IO_BASE_ + (0x000F)) // Source IP Address + +// Reserved (_W5100S_IO_BASE_ + (0x0013)) +// Reserved (_W5100S_IO_BASE_ + (0x0014)) + +/** + @ingroup Common_register_group_W5100S + @brief Interrupt Register(R/W) + @details \ref IR indicates the interrupt status. Each bit of \ref IR will be still until the bit will be written to by the host. + If \ref IR is not equal to x00 INTn PIN is asserted to low until it is x00\n\n + Each bit of \ref IR defined as follows. + + + +
    7 6 5 4 3 2 1 0
    CONFLICT UNREACH PPPoE Reserved S3_INT S2_INT S1_INT S0_INT
    + - \ref IR_CONFLICT : IP conflict + - \ref IR_UNREACH : Destination unreachable + - \ref IR_PPPoE : PPPoE connection close + - \ref IR_SOCK(3) : SOCKET 3 Interrupt + - \ref IR_SOCK(2) : SOCKET 2 Interrupt + - \ref IR_SOCK(1) : SOCKET 1 Interrupt + - \ref IR_SOCK(0) : SOCKET 0 Interrupt +*/ +#define IR (_W5100S_IO_BASE_ + (0x0015)) // Interrupt + +/** + @ingroup Common_register_group_W5100S + @brief Socket Interrupt Mask Register(R/W) + @details Each bit of \ref _IMR_ corresponds to each bit of \ref IR. + When a bit of \ref _IMR_ is and the corresponding bit of \ref IR is set, Interrupt will be issued. +*/ +#define _IMR_ (_W5100S_IO_BASE_ + (0x0016)) // Socket Interrupt Mask + +/** + @ingroup Common_register_group_W5100S + @brief Timeout register address( 1 is 100us )(R/W) + @details \ref _RTR_ configures the retransmission timeout period. The unit of timeout period is 100us and the default of \ref _RTR_ is x07D0or 000 + And so the default timeout period is 200ms(100us X 2000). During the time configured by \ref _RTR_, W5100S waits for the peer response + to the packet that is transmitted by \ref Sn_CR (CONNECT, DISCON, CLOSE, SEND, SEND_MAC, SEND_KEEP command). + If the peer does not respond within the \ref _RTR_ time, W5100S retransmits the packet or issues timeout. +*/ +#define _RTR_ (_W5100S_IO_BASE_ + (0x0017)) // Retry Time + +/** + @ingroup Common_register_group_W5100S + @brief Retry count register(R/W) + @details \ref _RCR_ configures the number of time of retransmission. + When retransmission occurs as many as ref _RCR_+1 Timeout interrupt is issued (\ref Sn_IR_TIMEOUT = '1'). +*/ +#define _RCR_ (_W5100S_IO_BASE_ + (0x0019)) // Retry Count + +/** + @ingroup Common_register_group_W5100S + @brief Receive Memory Size Register + @details \ref RMSR register configures RX bufffer Size of the SOCKET + The sum of the RX buffers can not exceed 8kB. + + + +
    7 6 5 4 3 2 1 0
    S3-1 S3-0 S2-1 S2-0 S1-1 S1-0 S0-1 S0-0
    + + + + + + +
    Memory SizeSn-1Sn-0
    1KB00
    2KB01
    4KB10
    8KB11
    +*/ +#define RMSR (_W5100S_IO_BASE_ + (0x001A)) // Receive Memory Size + +/** + @ingroup Common_register_group_W5100S + @brief Transmit Memory Size Register + @details \ref TMSR register configures TX bufffer Size of the SOCKET + The sum of the TX buffers can not exceed 8kB. + + + +
    7 6 5 4 3 2 1 0
    S3-1 S3-0 S2-1 S2-0 S1-1 S1-0 S0-1 S0-0
    + + + + + + +
    Memory SizeSn-1Sn-0
    1KB00
    2KB01
    4KB10
    8KB11
    +*/ +#define TMSR (_W5100S_IO_BASE_ + (0x001B)) // Transmit Memory Size + +/** + @ingroup Common_register_group_W5100S + @brief Interrupt register 2 + @details \ref IR2 indicates the interrupt status. + Each bit of IR2 will be still until the bit will be written to by the host. + + + +
    7:1 0
    Reserved WOL
    + - \ref IR2_WOL : WOL MAGIC PACKET Interrupt Mask +*/ +#define IR2 (_W5100S_IO_BASE_ + (0x0020)) + +/** + @ingroup Common_register_group_W5100S + @brief Interrupt mask register 2 + @details \ref IMR2 Each bit of IMR2 corresponds to each bit of IR2. + When a bit of IMR2 is and the corresponding bit of IR2 is set, Interrupt will be issued. +*/ +#define IMR2 (_W5100S_IO_BASE_ + (0x0021)) + + +/** + @ingroup Common_register_group_W5100S + @brief PPP LCP Request Timer register in PPPoE mode(R) + @details \ref PTIMER configures the time for sending LCP echo request. The unit of time is 25ms. +*/ +#define PTIMER (_W5100S_IO_BASE_ + (0x0028)) // PPP LCP RequestTimer + +/** + @ingroup Common_register_group_W5100S + @brief PPP LCP Magic number register in PPPoE mode(R) + @details \ref PMAGIC configures the 4bytes magic number to be used in LCP negotiation. +*/ +#define PMAGIC (_W5100S_IO_BASE_ + (0x0029)) // PPP LCP Magic number + +/** + @ingroup Common_register_group_W5100S + @brief Unreachable IP address register + @details \ref +*/ +#define UIPR (_W5100S_IO_BASE_ + (0x002A)) + +/** + @ingroup Common_register_group_W5100S + @brief Unreachable Port register + @details \ref +*/ +#define UPORTR (_W5100S_IO_BASE_ + (0x002E)) + +/* register for W5100S only */ + +/*------------------------------------------ Common registers ------------------------------------------*/ + +/** + @ingroup Common_register_group_W5100S + @brief MR2 Mode register 2 + @details \reg +*/ +#define MR2 (_W5100S_IO_BASE_ + (0x0030)) + + +/** + @ingroup Common_register_group_W5100S + @brief Destination Hardware address in PPPoE + @details \reg +*/ +#define PHAR (_W5100S_IO_BASE_ + (0x0032)) + +/** + @ingroup Common_register_group_W5100S + @brief Session ID in PPPoE + @details \reg +*/ +#define PSIDR (_W5100S_IO_BASE_ + (0x0038)) + +/** + @ingroup Common_register_group_W5100S + @brief Maximum receive Unit in PPPoE + @details \reg +*/ +#define PMRUR (_W5100S_IO_BASE_ + (0x003A)) + + +/*------------------------------------------ PHY registers ------------------------------------------*/ + +/** + @ingroup Common_register_group_W5100S + @brief PHY status register + @details \reg +*/ +#define PHYSR (_W5100S_IO_BASE_ + (0x003C)) + +/** + @ingroup Common_register_group_W5100S + @brief PHY status register(hidden) + @details \reg +*/ +#define PHYSR1 (_W5100S_IO_BASE_ + (0x003D)) + +/** + @ingroup Common_register_group_W5100S + @brief PHY Address value + @details \reg +*/ +#define PHYAR (_W5100S_IO_BASE_ + (0x003E)) + +/** + @ingroup Common_register_group_W5100S + @brief PHY Register address + @details \reg +*/ +#define PHYRAR (_W5100S_IO_BASE_ + (0x003F)) + +/** + @ingroup Common_register_group_W5100S + @brief PHY Data input register + @details \reg +*/ +#define PHYDIR (_W5100S_IO_BASE_ + (0x0040)) + +/** + @ingroup Common_register_group_W5100S + @brief PHY data output register + @details \reg +*/ +#define PHYDOR (_W5100S_IO_BASE_ + (0x0042)) + +/** + @ingroup Common_register_group_W5100S + @brief PHY Action register + @details \reg +*/ +#define PHYACR (_W5100S_IO_BASE_ + (0x0044)) + +/** + @ingroup Common_register_group_W5100S + @brief PHY Division register + @details \reg +*/ +#define PHYDIVR (_W5100S_IO_BASE_ + (0x0045)) + +/** + @ingroup Common_register_group_W5100S + @brief PHY Control register 0 + @details \reg +*/ +#define PHYCR0 (_W5100S_IO_BASE_ + (0x0046)) +/** + @ingroup Common_register_group_W5100S + @brief PHY Control register 1 + @details \reg +*/ +#define PHYCR1 (_W5100S_IO_BASE_ + (0x0047)) + +/*------------------------------------------ Socket Less registers ------------------------------------------*/ + +/** + @ingroup Common_register_group_W5100S + @brief Socket-less control register + @details \reg +*/ +#define SLCR (_W5100S_IO_BASE_ + (0x004C)) + +/** + @ingroup Common_register_group_W5100S + @brief Socket-less retry time register + @details \reg +*/ +#define SLRTR (_W5100S_IO_BASE_ + (0x004D)) + + +/** + @ingroup Common_register_group_W5100S + @brief Socket-less retry count register + @details \reg +*/ +#define SLRCR (_W5100S_IO_BASE_ + (0x004F)) + +/** + @ingroup Common_register_group_W5100S + @brief Socket-less peer IP address register + @details \reg +*/ +#define SLPIPR (_W5100S_IO_BASE_ + (0x0050)) + +/** + @ingroup Common_register_group_W5100S + @brief Socket-less peer hardware address register + @details \reg +*/ +#define SLPHAR (_W5100S_IO_BASE_ + (0x0054)) + +/** + @ingroup Common_register_group_W5100S + @brief Ping sequence number register + @details \reg +*/ +#define PINGSEQR (_W5100S_IO_BASE_ + (0x005A)) + +/** + @ingroup Common_register_group_W5100S + @brief Ping ID register + @details \reg +*/ +#define PINGIDR (_W5100S_IO_BASE_ + (0x005C)) + +/** + @ingroup Common_register_group_W5100S + @brief Socket-less interrupt mask register + @details \reg +*/ +#define SLIMR (_W5100S_IO_BASE_ + (0x005E)) + +/** + @ingroup Common_register_group_W5100S + @brief Socket-less interrupt register + @details \reg +*/ +#define SLIR (_W5100S_IO_BASE_ + (0x005F)) + +/** + @ingroup Common_register_group_W5100S + @brief DBGOUT(hidden) + @details \reg +*/ +#define DBGOUT (_W5100S_IO_BASE_ + (0x0060)) + +/** + @ingroup Common_register_group_W5100S + @brief NICMAXCOLR(hidden) + @details \reg +*/ +#define NICMAXCOLR (_W5100S_IO_BASE_ + (0x0063)) +/*------------------------------------------ CFG registers ------------------------------------------*/ + +/** + @ingroup Common_register_group_W5100S + @brief Chip Configuration locking register + @details \reg +*/ +#define CHIPLCKR (_W5100S_IO_BASE_ + (0x0070)) + +/** + @ingroup Common_register_group_W5100S + @brief Network Configuration locking register + @details \reg +*/ +#define NETLCKR (_W5100S_IO_BASE_ + (0x0071)) + +/** + @ingroup Common_register_group_W5100S + @brief PHY Configuration locking register + @details \reg +*/ +#define PHYLCKR (_W5100S_IO_BASE_ + (0x0072)) + +/** + @ingroup Common_register_group_W5100S + @brief version register + @details \reg +*/ +#define VERR (_W5100S_IO_BASE_ + (0x0080)) + +/** + @ingroup Common_register_group_W5100S + @brief Core 100us Counter register + @details \reg +*/ +#define TCNTR (_W5100S_IO_BASE_ + (0x0082)) + +/** + @ingroup Common_register_group_W5100S + @brief Core 100us Counter clear register + @details \reg +*/ +#define TCNTCLKR (_W5100S_IO_BASE_ + (0x0088)) + +//----------------------------- W5100S Socket Registers ----------------------------- + +//--------------------------- For Backward Compatibility --------------------------- + +/** + @ingroup Socket_register_group_W5100S + @brief socket Mode register(R/W) + @details \ref Sn_MR configures the option or protocol type of Socket n.\n\n + Each bit of \ref Sn_MR defined as the following. + + + +
    7 6 5 4 3 2 1 0
    MULTI MF ND/MC Reserved Protocol[3] Protocol[2] Protocol[1] Protocol[0]
    + - \ref Sn_MR_MULTI : Support UDP Multicasting + - \ref Sn_MR_MF : Support MACRAW + - \ref Sn_MR_ND : No Delayed Ack(TCP) flag + - \ref Sn_MR_MC : IGMP version used in UDP mulitcasting + - Protocol + + + + + + +
    Protocol[3] Protocol[2] Protocol[1] Protocol[0] @b Meaning
    0 0 0 0 Closed
    0 0 0 1 TCP
    0 0 1 0 UDP
    0 1 0 0 MACRAW
    + - In case of Socket 0 + + + + +
    Protocol[3] Protocol[2] Protocol[1] Protocol[0] @b Meaning
    0 1 0 0 MACRAW
    0 1 0 1 PPPoE
    + - \ref Sn_MR_MACRAW : MAC LAYER RAW SOCK \n + - \ref Sn_MR_UDP : UDP + - \ref Sn_MR_TCP : TCP + - \ref Sn_MR_CLOSE : Unused socket + @note MACRAW mode should be only used in Socket 0. +*/ +#define Sn_MR(sn) (_W5100S_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x0000)) // socket Mode register + +/** + @ingroup Socket_register_group_W5100S + @brief Socket command register(R/W) + @details This is used to set the command for Socket n such as OPEN, CLOSE, CONNECT, LISTEN, SEND, and RECEIVE.\n + After W5100S accepts the command, the \ref Sn_CR register is automatically cleared to 0x00. + Even though \ref Sn_CR is cleared to 0x00, the command is still being processed.\n + To check whether the command is completed or not, please check the \ref Sn_IR or \ref Sn_SR. + - \ref Sn_CR_OPEN : Initialize or open socket. + - \ref Sn_CR_LISTEN : Wait connection request in TCP mode(Server mode) + - \ref Sn_CR_CONNECT : Send connection request in TCP mode(Client mode) + - \ref Sn_CR_DISCON : Send closing request in TCP mode. + - \ref Sn_CR_CLOSE : Close socket. + - \ref Sn_CR_SEND : Update TX buffer pointer and send data. + - \ref Sn_CR_SEND_MAC : Send data with MAC address, so without ARP process. + - \ref Sn_CR_SEND_KEEP : Send keep alive message. + - \ref Sn_CR_RECV : Update RX buffer pointer and receive data. + - In case of S0_MR(P3:P0) = S0_MR_PPPoE + + + + + + + +
    Value Symbol Description
    0x23 PCON PPPoE connection begins by transmitting PPPoE discovery packet
    0x24 PDISCON Closes PPPoE connection
    0x25 PCR In each phase, it transmits REQ message.
    0x26 PCN In each phase, it transmits NAK message.
    0x27 PCJ In each phase, it transmits REJECT message.
    +*/ +#define Sn_CR(sn) (_W5100S_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x0001)) // channel Sn_CR register + +/** + @ingroup Socket_register_group_W5100S + @brief Socket interrupt register(R) + @details \ref Sn_IR indicates the status of Socket Interrupt such as establishment, termination, receiving data, timeout).\n + When an interrupt occurs and the corresponding bit \ref IR_SOCK(N) in \ref _IMR_ are set, \ref IR_SOCK(N) in \ref IR becomes '1'.\n + In order to clear the \ref Sn_IR bit, the host should write the bit to \n + + + +
    7 6 5 4 3 2 1 0
    PRECV PFAIL PNEXT SEND_OK TIMEOUT RECV DISCON CON
    + - \ref Sn_IR_PRECV : PPP Receive Interrupt + - \ref Sn_IR_PFAIL : PPP Fail Interrupt + - \ref Sn_IR_PNEXT : PPP Next Phase Interrupt + - \ref Sn_IR_SENDOK : SEND_OK Interrupt + - \ref Sn_IR_TIMEOUT : TIMEOUT Interrupt + - \ref Sn_IR_RECV : RECV Interrupt + - \ref Sn_IR_DISCON : DISCON Interrupt + - \ref Sn_IR_CON : CON Interrupt +*/ +#define Sn_IR(sn) (_W5100S_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x0002)) // channel interrupt register + +/** + @ingroup Socket_register_group_W5100S + @brief Socket status register(R) + @details \ref Sn_SR indicates the status of Socket n.\n + The status of Socket n is changed by \ref Sn_CR or some special control packet as SYN, FIN packet in TCP. + @par Normal status + - \ref SOCK_CLOSED : Closed + - \ref SOCK_INIT : Initiate state + - \ref SOCK_LISTEN : Listen state + - \ref SOCK_ESTABLISHED : Success to connect + - \ref SOCK_CLOSE_WAIT : Closing state + - \ref SOCK_UDP : UDP socket + - \ref SOCK_MACRAW : MAC raw mode socket + @par Temporary status during changing the status of Socket n. + - \ref SOCK_SYNSENT : This indicates Socket n sent the connect-request packet (SYN packet) to a peer. + - \ref SOCK_SYNRECV : It indicates Socket n successfully received the connect-request packet (SYN packet) from a peer. + - \ref SOCK_FIN_WAIT : Connection state + - \ref SOCK_CLOSING : Closing state + - \ref SOCK_TIME_WAIT : Closing state + - \ref SOCK_LAST_ACK : Closing state +*/ +#define Sn_SR(sn) (_W5100S_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x0003)) // channel status register + +/** + @ingroup Socket_register_group_W5100S + @brief source port register(R/W) + @details \ref Sn_PORT configures the source port number of Socket n. + It is valid when Socket n is used in TCP/UDP mode. It should be set before OPEN command is ordered. +*/ +#define Sn_PORT(sn) (_W5100S_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x0004)) // source port register + +/** + @ingroup Socket_register_group_W5100S + @brief Peer MAC register address(R/W) + @details \ref Sn_DHAR configures the destination hardware address of Socket n when using SEND_MAC command in UDP mode or + it indicates that it is acquired in ARP-process by CONNECT/SEND command. +*/ +#define Sn_DHAR(sn) (_W5100S_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x0006)) // Peer MAC register address + +/** + @ingroup Socket_register_group_W5100S + @brief Peer IP register address(R/W) + @details \ref Sn_DIPR configures or indicates the destination IP address of Socket n. It is valid when Socket n is used in TCP/UDP mode. + In TCP client mode, it configures an IP address of TCP server before CONNECT command. + In TCP server mode, it indicates an IP address of TCP client after successfully establishing connection. + In UDP mode, it configures an IP address of peer to be received the UDP packet by SEND or SEND_MAC command. +*/ +#define Sn_DIPR(sn) (_W5100S_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x000C)) // Peer IP register address + +/** + @ingroup Socket_register_group_W5100S + @brief Peer port register address(R/W) + @details \ref Sn_DPORT configures or indicates the destination port number of Socket n. It is valid when Socket n is used in TCP/UDP mode. + In TCP clientmode, it configures the listen port number of TCP server before CONNECT command. + In TCP Servermode, it indicates the port number of TCP client after successfully establishing connection. + In UDP mode, it configures the port number of peer to be transmitted the UDP packet by SEND/SEND_MAC command. +*/ +#define Sn_DPORT(sn) (_W5100S_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x0010)) // Peer port register address + +/** + @ingroup Socket_register_group_W5100S + @brief Maximum Segment Size(Sn_MSSR0) register address(R/W) + @details \ref Sn_MSSR configures or indicates the MTU(Maximum Transfer Unit) of Socket n. +*/ +#define Sn_MSSR(sn) (_W5100S_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x0012)) // Maximum Segment Size(Sn_MSSR0) register address + +/** + @ingroup Socket_register_group_W5100S + @brief IP Protocol(PROTO) Register(R/W) + @details \ref Sn_PROTO that sets the protocol number field of the IP header at the IP layer. It is + valid only in IPRAW mode, and ignored in other modes. +*/ +#define Sn_PROTO(sn) (_W5100S_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x0014)) // Protocol of IP Header field register in IP raw mode + +/** + @ingroup Socket_register_group_W5100S + @brief IP Type of Service(TOS) Register(R/W) + @details \ref Sn_TOS configures the TOS(Type Of Service field in IP Header) of Socket n. + It is set before OPEN command. +*/ +#define Sn_TOS(sn) (_W5100S_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + 0x0015) // IP Type of Service(TOS) Register + +/** + @ingroup Socket_register_group_W5100S + @brief IP Time to live(TTL) Register(R/W) + @details \ref Sn_TTL configures the TTL(Time To Live field in IP header) of Socket n. + It is set before OPEN command. +*/ +#define Sn_TTL(sn) (_W5100S_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x0016)) // IP Time to live(TTL) Register + +// Reserved (_W5100S_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x0017)) +// Reserved (_W5100S_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x0018)) +// Reserved (_W5100S_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x0019)) +// Reserved (_W5100S_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x001A)) +// Reserved (_W5100S_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x001B)) +// Reserved (_W5100S_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x001C)) +// Reserved (_W5100S_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x001D)) + + + +/** + @ingroup Socket_register_group_W5100S + @brief Receive memory size register(R/W) + @details @ref Sn_RXBUF_SIZE configures the RX buffer block size of Socket n. + Socket n RX Buffer Block size can be configured with 1,2,4 and 8Kbytes. + If a different size is configured, the data cannot be normally received from a peer. + Although Socket n RX Buffer Block size is initially configured to 2Kbytes, + user can re-configure its size using @ref Sn_RXBUF_SIZE. The total sum of @ref Sn_RXBUF_SIZE can not be exceed 8Kbytes. + When exceeded, the data reception error is occurred. +*/ +#define Sn_RXBUF_SIZE(sn) (_W5100S_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x001E)) + +/** + @ingroup Socket_register_group_W5100S + @brief Transmit memory size register(R/W) + @details @ref Sn_TXBUF_SIZE configures the TX buffer block size of Socket n. Socket n TX Buffer Block size can be configured with 1,2,4 and 8Kbytes. + If a different size is configured, the data cannot be normally transmitted to a peer. + Although Socket n TX Buffer Block size is initially configured to 2Kbytes, + user can be re-configure its size using @ref Sn_TXBUF_SIZE. The total sum of @ref Sn_TXBUF_SIZE can not be exceed 8Kbytes. + When exceeded, the data transmission error is occurred. +*/ +#define Sn_TXBUF_SIZE(sn) (_W5100S_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x001F)) + + +/** + @ingroup Socket_register_group_W5100S + @brief Transmit free memory size register(R) + @details \ref Sn_TX_FSR indicates the free size of Socket n TX Buffer Block. It is initialized to the configured size by \ref Sn_TXMEM_SIZE. + Data bigger than \ref Sn_TX_FSR should not be saved in the Socket n TX Buffer because the bigger data overwrites the previous saved data not yet sent. + Therefore, check before saving the data to the Socket n TX Buffer, and if data is equal or smaller than its checked size, + transmit the data with SEND/SEND_MAC command after saving the data in Socket n TX buffer. But, if data is bigger than its checked size, + transmit the data after dividing into the checked size and saving in the Socket n TX buffer. +*/ +#define Sn_TX_FSR(sn) (_W5100S_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x0020)) // Transmit free memory size register + +/** + @ingroup Socket_register_group_W5100S + @brief Transmit memory read pointer register address(R) + @details \ref Sn_TX_RD is initialized by OPEN command. However, if Sn_MR(P[3:0]) is TCP mode(001), it is re-initialized while connecting with TCP. + After its initialization, it is auto-increased by SEND command. + SEND command transmits the saved data from the current \ref Sn_TX_RD to the \ref Sn_TX_WR in the Socket n TX Buffer. + After transmitting the saved data, the SEND command increases the \ref Sn_TX_RD as same as the \ref Sn_TX_WR. + If its increment value exceeds the maximum value 0xFFFF, (greater than 0x10000 and the carry bit occurs), + then the carry bit is ignored and will automatically update with the lower 16bits value. +*/ +#define Sn_TX_RD(sn) (_W5100S_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x0022)) // Transmit memory read pointer register address + +/** + @ingroup Socket_register_group_W5100S + @brief Transmit memory write pointer register address(R/W) + @details \ref Sn_TX_WR is initialized by OPEN command. However, if Sn_MR(P[3:0]) is TCP mode(001), it is re-initialized while connecting with TCP.\n + It should be read or be updated like as follows.\n + 1. Read the starting address for saving the transmitting data.\n + 2. Save the transmitting data from the starting address of Socket n TX buffer.\n + 3. After saving the transmitting data, update \ref Sn_TX_WR to the increased value as many as transmitting data size. + If the increment value exceeds the maximum value 0xFFFF(greater than 0x10000 and the carry bit occurs), + then the carry bit is ignored and will automatically update with the lower 16bits value.\n + 4. Transmit the saved data in Socket n TX Buffer by using SEND/SEND command +*/ +#define Sn_TX_WR(sn) (_W5100S_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x0024)) // Transmit memory write pointer register address + +/** + @ingroup Socket_register_group_W5100S + @brief Received data size register(R) + @details \ref Sn_RX_RSR indicates the data size received and saved in Socket n RX Buffer. + \ref Sn_RX_RSR does not exceed the \ref Sn_RXMEM_SIZE and is calculated as the difference between + Socket n RX Write Pointer (\ref Sn_RX_WR)and Socket n RX Read Pointer (\ref Sn_RX_RD) +*/ +#define Sn_RX_RSR(sn) (_W5100S_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x0026)) // Received data size register + +/** + @ingroup Socket_register_group_W5100S + @brief Read point of Receive memory(R/W) + @details \ref Sn_RX_RD is initialized by OPEN command. Make sure to be read or updated as follows.\n + 1. Read the starting save address of the received data.\n + 2. Read data from the starting address of Socket n RX Buffer.\n + 3. After reading the received data, Update \ref Sn_RX_RD to the increased value as many as the reading size. + If the increment value exceeds the maximum value 0xFFFF, that is, is greater than 0x10000 and the carry bit occurs, + update with the lower 16bits value ignored the carry bit.\n + 4. Order RECV command is for notifying the updated \ref Sn_RX_RD to W5100S. +*/ +#define Sn_RX_RD(sn) (_W5100S_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x0028)) // Read point of Receive memory + +/** + @ingroup Socket_register_group_W5100S + @brief Write point of Receive memory(R) + @details \ref Sn_RX_WR is initialized by OPEN command and it is auto-increased by the data reception. + If the increased value exceeds the maximum value 0xFFFF, (greater than 0x10000 and the carry bit occurs), + then the carry bit is ignored and will automatically update with the lower 16bits value. +*/ +#define Sn_RX_WR(sn) (_W5100S_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x002A)) // Write point of Receive memory + + +//todo +/** + @ingroup Socket_register_group_W5100S + @brief Socket interrupt mask register + @details Register address to configure the interrupt mask of the socket + @param sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_ expect bit 4. + +*/ +#define Sn_IMR(sn) (_W5100S_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x002C)) + +/** + @ingroup Socket_register_group_W5100S + @brief Socket fragment field register + @details Register to configure the Fragment field of IP Header + @param sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_ expect bit 4. +*/ +#define Sn_FRAGR(sn) (_W5100S_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x002D)) // and +1 + +/** + @ingroup Socket_register_group_W5100S + @brief Socket Mode register 2 + @details Register to set mode 2 + @param sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_ expect bit 4. +*/ +#define Sn_MR2(sn) (_W5100S_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x002F)) + +/** + @ingroup Socket_register_group_W5100S + @brief Socket n Keep Alive Timer Register + @details Register to set the transmission period of keep alive packet. + @param sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_ expect bit 4. +*/ +#define Sn_KPALVTR(sn) (_W5100S_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x0030)) + +/** todo delete + @ingroup Socket_register_group_W5100S + @brief Socket n Timer Status Register + @details + @param sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_ expect bit 4. +*/ +//#define Sn_TSR(sn) (_W5100S_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x0031)) + +/** + @ingroup Socket_register_group_W5100S + @brief Socket n Retry Time-value Register + @details Register to set the retry time value + @param sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_ expect bit 4. +*/ +#define Sn_RTR(sn) (_W5100S_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x0032)) + +/** + @ingroup Socket_register_group_W5100S + @brief Socket n Retry Count-value Register + @details Register to set the retry count value + @param sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_ expect bit 4. +*/ +#define Sn_RCR(sn) (_W5100S_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x0034)) + + +/*----------------------------- W5100S Register values -----------------------------*/ + +/* MODE register values */ +/** + @brief Reset + @details If this bit is All internal registers will be initialized. It will be automatically cleared as after S/W reset. +*/ +#define MR_RST 0x80 ///< reset + + +/** + @brief Ping block + @details 0 : Disable Ping block\n + 1 : Enable Ping block\n + If the bit is it blocks the response to a ping request. +*/ +#define MR_PB 0x10 ///< ping block + +/** + @brief Enable PPPoE + @details 0 : DisablePPPoE mode\n + 1 : EnablePPPoE mode\n + If you use ADSL, this bit should be '1'. +*/ +#define MR_PPPOE 0x08 ///< enable pppoe + +/** + @brief Address Auto-Increment in Indirect Bus Interface + @details 0 : Disable auto-increment \n + 1 : Enable auto-incremente \n + At the Indirect Bus Interface mode, if this bit is set as the address will + be automatically increased by 1 whenever read and write are performed. +*/ +#define MR_AI 0x02 ///< auto-increment in indirect mode + +/** + @brief Indirect Bus Interface mode + @details 0 : Disable Indirect bus Interface mode \n + 1 : Enable Indirect bus Interface mode \n + If this bit is set as Indirect Bus Interface mode is set. +*/ +#define MR_IND 0x01 ///< enable indirect mode + +/* IR register values */ +/** + @brief Check IP conflict. + @details Bit is set as when own source IP address is same with the sender IP address in the received ARP request. +*/ +#define IR_CONFLICT 0x80 ///< check ip confict + +/** + @brief Get the destination unreachable message in UDP sending. + @details When receiving the ICMP (Destination port unreachable) packet, this bit is set as + When this bit is Destination Information such as IP address and Port number may be checked with the corresponding @ref UIPR & @ref UPORTR. +*/ +#define IR_UNREACH 0x40 ///< check destination unreachable + +/** + @brief Get the PPPoE close message. + @details When PPPoE is disconnected during PPPoE mode, this bit is set. +*/ +#define IR_PPPoE 0x20 ///< get the PPPoE close message + +/** + @brief Socket interrupt bit + @details Indicates whether each socket interrupt has occured. +*/ +#define IR_SOCK(sn) (0x01 << sn) ///< check socket interrupt + +/** + @brief IP conflict interrupt mask bit + @details If this bit is set, IP conflict interrupt is enabled. +*/ +#define IMR_CONFLICT 0x80 + +/** + @brief Destination port unreachable interrupt mask bit + @details If this bit is set, destination port unreachable interrupt is enabled. +*/ +#define IMR_UNREACH 0x40 + +/** + @brief PADT/LCPT interrupt mask bit(PPPoE) + @details If this bit is set, PADT/LCPT interrupt is enabled. +*/ +#define IMR_PPPoE 0x20 + +/** + @brief Socket interrupt mask bit + @details If this bit is set, each socket interrupt is enabled. +*/ +#define IMR_SOCK(sn) (0x01 << sn) + +/** + @brief Socket-less command register bit + @details ARP command +*/ +#define SLCMD_ARP (1<<1) + +/** + @brief Socket-less command register bit + @details ARP command +*/ +#define SLCMD_PING (1<<0) + +/** + @brief Socket-less command interrupt and interrupt mask register bit + @details Request command time out interrupt and interrupt mask +*/ +#define SLIR_TIMEOUT (1<<2) + +/** + @brief Socket less command interrupt and interrupt mask register bit + @details Socket less command ARP interrupt and interrupt mask +*/ +#define SLIR_ARP (1<<1) + +/** + @brief Socket less command interrupt and interrupt mask register bit + @details Socket less command PING interrupt and interruptmask +*/ +#define SLIR_PING (1<<0) + + + +// Sn_MR values +/* Sn_MR Default values */ +/** + @brief Unused socket + @details This configures the protocol mode of Socket n. +*/ +#define Sn_MR_CLOSE 0x00 ///< unused socket + +/** + @brief TCP + @details This configures the protocol mode of Socket n. +*/ +#define Sn_MR_TCP 0x01 ///< TCP + +/** + @brief UDP + @details This configures the protocol mode of Socket n. +*/ +#define Sn_MR_UDP 0x02 ///< UDP +#define Sn_MR_IPRAW 0x03 ///< IP LAYER RAW SOCK + +/** + @brief MAC LAYER RAW SOCK + @details This configures the protocol mode of Socket n. + @note MACRAW mode should be only used in Socket 0. +*/ +#define Sn_MR_MACRAW 0x04 ///< MAC LAYER RAW SOCK + +/** + @brief PPPoE + @details This configures the protocol mode of Socket n. + @note PPPoE mode should be only used in Socket 0. +*/ +#define Sn_MR_PPPoE 0x05 ///< PPPoE + +/** + @brief No Delayed Ack(TCP), Multicast flag + @details 0 : Disable No Delayed ACK option\n + 1 : Enable No Delayed ACK option\n + This bit is applied only during TCP mode (P[3:0] = 001).\n + When this bit is It sends the ACK packet without delay as soon as a Data packet is received from a peer.\n + When this bit is It sends the ACK packet after waiting for the timeout time configured by \ref _RTR_. +*/ +#define Sn_MR_ND 0x20 ///< No Delayed Ack(TCP) flag + +/** + @brief Support UDP Multicasting + @details 0 : using IGMP version 2\n + 1 : using IGMP version 1\n + This bit is applied only during UDP mode(P[3:0] = 010 and MULTI = '1') + It configures the version for IGMP messages (Join/Leave/Report). +*/ +#define Sn_MR_MC Sn_MR_ND ///< Select IGMP version 1(0) or 2(1) + +/** + @brief MAC filter enable in @ref Sn_MR_MACRAW mode + @details 0 : disable MAC Filtering\n + 1 : enable MAC Filtering\n + This bit is applied only during MACRAW mode(P[3:0] = 100.\n + When set as W5100S can only receive broadcasting packet or packet sent to itself. + When this bit is W5100S can receive all packets on Ethernet. + If user wants to implement Hybrid TCP/IP stack, + it is recommended that this bit is set as for reducing host overhead to process the all received packets. +*/ +#define Sn_MR_MF 0x40 ///< Use MAC filter +#define Sn_MR_MFEN Sn_MR_MF + + +/* Sn_MR Default values */ +/** + @brief Support UDP Multicasting + @details 0 : disable Multicasting\n + 1 : enable Multicasting\n + This bit is applied only during UDP mode(P[3:0] = 010).\n + To use multicasting, \ref Sn_DIPR & \ref Sn_DPORT should be respectively configured with the multicast group IP address & port number + before Socket n is opened by OPEN command of \ref Sn_CR. +*/ +#define Sn_MR_MULTI 0x80 ///< support multicating + +/* Sn_CR values */ +/** + @brief Initialize or open socket + @details Socket n is initialized and opened according to the protocol selected in Sn_MR(P3:P0). + The table below shows the value of \ref Sn_SR corresponding to \ref Sn_MR.\n + + + + + + + + +
    \b Sn_MR (P[3:0]) \b Sn_SR
    Sn_MR_CLOSE (000) --
    Sn_MR_TCP (001) SOCK_INIT (0x13)
    Sn_MR_UDP (010) SOCK_UDP (0x22)
    S0_MR_IPRAW (011) SOCK_IPRAW (0x32)
    S0_MR_MACRAW (100) SOCK_MACRAW (0x42)
    S0_MR_PPPoE (101) SOCK_PPPoE (0x5F)
    +*/ +#define Sn_CR_OPEN 0x01 ///< initialize or open socket + +/** + @brief Wait connection request in TCP mode(Server mode) + @details This is valid only in TCP mode (Sn_MR(P3:P0) = \ref Sn_MR_TCP).// + In this mode, Socket n operates as a 'TCP server' and waits for connection-request (SYN packet) from any 'TCP client'.// + The \ref Sn_SR changes the state from SOCK_INIT to SOCKET_LISTEN.// + When a 'TCP client' connection request is successfully established, + the \ref Sn_SR changes from SOCK_LISTEN to SOCK_ESTABLISHED and the Sn_IR(0) becomes + But when a 'TCP client' connection request is failed, Sn_IR(3) becomes and the status of \ref Sn_SR changes to SOCK_CLOSED. +*/ +#define Sn_CR_LISTEN 0x02 ///< wait connection request in tcp mode(Server mode) + +/** + @brief Send connection request in TCP mode(Client mode) + @details To connect, a connect-request (SYN packet) is sent to TCP serverconfigured by \ref Sn_DIPR & Sn_DPORT(destination address & port). + If the connect-request is successful, the \ref Sn_SR is changed to \ref SOCK_ESTABLISHED and the Sn_IR(0) becomes \n\n + The connect-request fails in the following three cases.\n + 1. When a @b ARPTO occurs (\ref Sn_IR[3] = '1') because destination hardware address is not acquired through the ARP-process.\n + 2. When a @b SYN/ACK packet is not received and @b TCPTO (Sn_IR(3) ='1')\n + 3. When a @b RST packet is received instead of a @b SYN/ACK packet. In these cases, \ref Sn_SR is changed to \ref SOCK_CLOSED. + @note This is valid only in TCP mode and operates when Socket n acts as TCP client +*/ +#define Sn_CR_CONNECT 0x04 ///< send connection request in tcp mode(Client mode) + +/** + @brief Send closing request in TCP mode + @details Regardless of TCP serveror TCP client the DISCON command processes the disconnect-process (Active closeor Passive close.\n + @par Active close + it transmits disconnect-request(FIN packet) to the connected peer\n + @par Passive close + When FIN packet is received from peer, a FIN packet is replied back to the peer.\n + @details When the disconnect-process is successful (that is, FIN/ACK packet is received successfully), \ref Sn_SR is changed to \ref SOCK_CLOSED.\n + Otherwise, TCPTO occurs (Sn_IR(3)='1') and then \ref Sn_SR is changed to \ref SOCK_CLOSED. + @note Valid only in TCP mode. +*/ +#define Sn_CR_DISCON 0x08 ///< send closing reqeuset in tcp mode + +/** + @brief Close socket + @details Sn_SR is changed to \ref SOCK_CLOSED. +*/ +#define Sn_CR_CLOSE 0x10 + +/** + @brief Update TX buffer pointer and send data + @details SEND transmits all the data in the Socket n TX buffer.\n + For more details, please refer to Socket n TX Free Size Register (\ref Sn_TX_FSR), Socket n, + TX Write Pointer Register(\ref Sn_TX_WR), and Socket n TX Read Pointer Register(\ref Sn_TX_RD). +*/ +#define Sn_CR_SEND 0x20 + +/** + @brief Send data with MAC address, so without ARP process + @details The basic operation is same as SEND.\n + Normally SEND transmits data after destination hardware address is acquired by the automatic ARP-process(Address Resolution Protocol).\n + But SEND_MAC transmits data without the automatic ARP-process.\n + In this case, the destination hardware address is acquired from \ref Sn_DHAR configured by host, instead of APR-process. + @note Valid only in UDP mode. +*/ +#define Sn_CR_SEND_MAC 0x21 + +/** + @brief Send keep alive message + @details It checks the connection status by sending 1byte keep-alive packet.\n + If the peer can not respond to the keep-alive packet during timeout time, the connection is terminated and the timeout interrupt will occur. + @note Valid only in TCP mode. +*/ +#define Sn_CR_SEND_KEEP 0x22 + +/** + @brief Update RX buffer pointer and receive data + @details RECV completes the processing of the received data in Socket n RX Buffer by using a RX read pointer register (\ref Sn_RX_RD).\n + For more details, refer to Socket n RX Received Size Register (\ref Sn_RX_RSR), Socket n RX Write Pointer Register (\ref Sn_RX_WR), + and Socket n RX Read Pointer Register (\ref Sn_RX_RD). +*/ +#define Sn_CR_RECV 0x40 + +/** + @brief + @details +*/ +#define Sn_CR_IGMP_JOIN 0x23 + +/** + @brief + @details +*/ +#define Sn_CR_IGMP_LEAVE 0x24 + + +/* Sn_IR values */ + +/** + @brief SEND_OK Interrupt + @details This is issued when SEND command is completed. +*/ +#define Sn_IR_SENDOK 0x10 ///< complete sending + +/** + @brief TIMEOUT Interrupt + @details This is issued when ARPTO or TCPTO occurs. +*/ +#define Sn_IR_TIMEOUT 0x08 ///< assert timeout + +/** + @brief RECV Interrupt + @details This is issued whenever data is received from a peer. +*/ +#define Sn_IR_RECV 0x04 + +/** + @brief DISCON Interrupt + @details This is issued when FIN or FIN/ACK packet is received from a peer. +*/ +#define Sn_IR_DISCON 0x02 + +/** + @brief CON Interrupt + @details This is issued one time when the connection with peer is successful and then \ref Sn_SR is changed to \ref SOCK_ESTABLISHED. +*/ +#define Sn_IR_CON 0x01 + +/* Sn_SR values */ +/** + @brief Closed + @details This indicates that Socket n is released.\n + When DICON, CLOSE command is ordered, or when a timeout occurs, it is changed to \ref SOCK_CLOSED regardless of previous status. +*/ +#define SOCK_CLOSED 0x00 ///< closed + +/** + @brief Initiate state + @details This indicates Socket n is opened with TCP mode.\n + It is changed to \ref SOCK_INIT when Sn_MR(P[3:0]) = 001)and OPEN command is ordered.\n + After \ref SOCK_INIT, user can use LISTEN /CONNECT command. +*/ +#define SOCK_INIT 0x13 ///< init state + +/** + @brief Listen state + @details This indicates Socket n is operating as TCP servermode and waiting for connection-request (SYN packet) from a peer (TCP client).\n + It will change to \ref SOCK_ESTABLISHED when the connection-request is successfully accepted.\n + Otherwise it will change to \ref SOCK_CLOSED after TCPTO occurred (Sn_IR(TIMEOUT) = '1'). +*/ +#define SOCK_LISTEN 0x14 + +/** + @brief Connection state + @details This indicates Socket n sent the connect-request packet (SYN packet) to a peer.\n + It is temporarily shown when \ref Sn_SR is changed from \ref SOCK_INIT to \ref SOCK_ESTABLISHED by CONNECT command.\n + If connect-accept(SYN/ACK packet) is received from the peer at SOCK_SYNSENT, it changes to \ref SOCK_ESTABLISHED.\n + Otherwise, it changes to \ref SOCK_CLOSED after TCPTO (\ref Sn_IR[TIMEOUT] = '1') is occurred. +*/ +#define SOCK_SYNSENT 0x15 + +/** + @brief Connection state + @details It indicates Socket n successfully received the connect-request packet (SYN packet) from a peer.\n + If socket n sends the response (SYN/ACK packet) to the peer successfully, it changes to \ref SOCK_ESTABLISHED. \n + If not, it changes to \ref SOCK_CLOSED after timeout occurs (\ref Sn_IR[TIMEOUT] = '1'). +*/ +#define SOCK_SYNRECV 0x16 + +/** + @brief Success to connect + @details This indicates the status of the connection of Socket n.\n + It changes to \ref SOCK_ESTABLISHED when the TCP SERVERprocessed the SYN packet from the TCP CLIENTduring \ref SOCK_LISTEN, or + when the CONNECT command is successful.\n + During \ref SOCK_ESTABLISHED, DATA packet can be transferred using SEND or RECV command. +*/ +#define SOCK_ESTABLISHED 0x17 + +/** + @brief Closing state + @details These indicate Socket n is closing.\n + These are shown in disconnect-process such as active-close and passive-close.\n + When Disconnect-process is successfully completed, or when timeout occurs, these change to \ref SOCK_CLOSED. +*/ +#define SOCK_FIN_WAIT 0x18 + +/** + @brief Closing state + @details These indicate Socket n is closing.\n + These are shown in disconnect-process such as active-close and passive-close.\n + When Disconnect-process is successfully completed, or when timeout occurs, these change to \ref SOCK_CLOSED. +*/ +#define SOCK_CLOSING 0x1A + +/** + @brief Closing state + @details These indicate Socket n is closing.\n + These are shown in disconnect-process such as active-close and passive-close.\n + When Disconnect-process is successfully completed, or when timeout occurs, these change to \ref SOCK_CLOSED. +*/ +#define SOCK_TIME_WAIT 0x1B + +/** + @brief Closing state + @details This indicates Socket n received the disconnect-request (FIN packet) from the connected peer.\n + This is half-closing status, and data can be transferred.\n + For full-closing, DISCON command is used. But For just-closing, @ref Sn_CR_CLOSE command is used. +*/ +#define SOCK_CLOSE_WAIT 0x1C + +/** + @brief Closing state + @details This indicates Socket n is waiting for the response (FIN/ACK packet) to the disconnect-request (FIN packet) by passive-close.\n + It changes to \ref SOCK_CLOSED when Socket n received the response successfully, or when timeout occurs (\ref Sn_IR[TIMEOUT] = '1'). +*/ +#define SOCK_LAST_ACK 0x1D + +/** + @brief UDP socket + @details This indicates Socket n is opened in UDP mode(Sn_MR(P[3:0]) = 010).\n + It changes to SOCK_UDP when Sn_MR(P[3:0]) = 010 and @ref Sn_CR_OPEN command is ordered.\n + Unlike TCP mode, data can be transfered without the connection-process. +*/ +#define SOCK_UDP 0x22 ///< udp socket + +/** + @brief IP raw mode socket + @details TThe socket is opened in IPRAW mode. The SOCKET status is change to SOCK_IPRAW when @ref Sn_MR (P3:P0) is + Sn_MR_IPRAW and @ref Sn_CR_OPEN command is used.\n + IP Packet can be transferred without a connection similar to the UDP mode. +*/ +#define SOCK_IPRAW 0x32 ///< ip raw mode socket + +/** + @brief MAC raw mode socket + @details This indicates Socket 0 is opened in MACRAW mode (@ref Sn_MR(P[3:0]) = '100' and n=0) and is valid only in Socket 0.\n + It changes to SOCK_MACRAW when @ref Sn_MR(P[3:0]) = '100' and @ref Sn_CR_OPEN command is ordered.\n + Like UDP mode socket, MACRAW mode Socket 0 can transfer a MAC packet (Ethernet frame) without the connection-process. +*/ +#define SOCK_MACRAW 0x42 ///< mac raw mode socket + +/** + @brief PPPoE mode socket + @details It is the status that SOCKET0 is open as PPPoE mode. It is changed to SOCK_PPPoE in case of S0_CR=OPEN and S0_MR + (P3:P0)=S0_MR_PPPoE.\n + It is temporarily used at the PPPoE + connection. +*/ +#define SOCK_PPPOE 0x5F ///< pppoe socket + +// IP PROTOCOL +#define IPPROTO_IP 0 ///< Dummy for IP +#define IPPROTO_ICMP 1 ///< Control message protocol +#define IPPROTO_IGMP 2 ///< Internet group management protocol +#define IPPROTO_GGP 3 ///< GW^2 (deprecated) +#define IPPROTO_TCP 6 ///< TCP +#define IPPROTO_PUP 12 ///< PUP +#define IPPROTO_UDP 17 ///< UDP +#define IPPROTO_IDP 22 ///< XNS idp +#define IPPROTO_ND 77 ///< UNOFFICIAL net disk protocol +#define IPPROTO_RAW 255 ///< Raw IP packet + + + +/*----------------------------- W5100S !!Only!! Register values -----------------------------*/ + +//todo +/* MODE2 register values */ + +/** + @brief Clock select bit + @details With this bit, system clock can be selected to be 25Mhz or 100Mhz + 1: 25Mhz + 0: 100Mhz (default) +*/ +#define MR2_CLKSEL (1<<7) + +/** + @brief Interrupt pin enable bit + @details This bit enables interrupt. + 1: Enable interrupt + 0: Disable interrupt +*/ +#define MR2_G_IEN (1<<6) + + +/** + @brief No TCP Reset Packet send + @details This bit prevents sending reset packet. + 1: Block TCP reset packet send + 0: TCP Reset packet send +*/ +#define MR2_NOTCPRST (1<<5) + +/** + @brief Unreachable Packet Send Block bit + @details This bit prevents sending Destination Port Unreachable Packet. + 1: Block Destination Port Unreachable Packet Send + 0: Destination Port Unreachable Packet Send +*/ +#define MR2_UDPURB (1<<4) + +/** + @brief Wake On LAN + @details This bit enables WOL packet to be received. + 1: WOL packet can be received. + 0: WOL packet cannot be received. +*/ +#define MR2_WOL (1<<3) + +/** todo + @brief MACRAW No Size Check + @details +*/ +#define MR2_MNOSCHK (1<<2) + +/** + @brief UDP force ARP + @details This bit can enables to force ARP for each send command. + 1: UDP Force ARP Enable + 0: UDP Force ARP Disable. + +*/ +#define MR2_UDPFARP (1<<1) + +/** todo + @brief Skip SRC Hardware Address + @details This bit can enables to receive without checking the hardware address of the peer. + 1: +*/ +#define MR2_SSRCHA (1<<0) + + + +/* Common interrupt register 2 values */ + +/** todo + @brief magic packet + @details +*/ +#define IR2_MGC (1<<1) + +/** todo + @brief Magic packet interrupt mask bit + @details If this bit is set, each socket interrupt is enabled. +*/ +#define IMR2_MGC (1<<1) + +/** todo + @brief + @details +*/ +//#define IR2_MGD (1<<1) /* Reserved */ + + +/* PHY status register 0 values */ + +/** todo + @brief Ethernet CABLE OFF Signal + @details +*/ +#define PHYSR_CABOFF (1<<7) + +/** todo + @brief + @details +*/ +#define PHYSR_MD2 (1<<5) + +/** todo + @brief + @details +*/ +#define PHYSR_MD1 (1<<4) + +/** todo + @brief + @details +*/ +#define PHYSR_MD0 (1<<3) + +/** todo + @brief + @details +*/ +#define PHYSR_DUP (1<<2) + +/** todo + @brief + @details +*/ +#define PHYSR_SPD (1<<1) + +/** todo + @brief LINKDONE register + @details If 1 Linked successfully, if 0 no link +*/ +#define PHYSR_LNK (1<<0) + + +/* PHY status register 10 values */ + +/** + @brieftodo + @details +*/ +#define PHYSR1_RXPG (1<<2) + +/** + @brieftodo + @details +*/ +#define PHYSR1_LPI (1<<1) + +/** + @brieftodo + @details +*/ +#define PHYSR1_CLDN (1<<0) + +#define PHYCR_AUTONEGO_ENABLE (0<<2) +#define PHYCR_AUTONEGO_DISABLE (1<<2) + +#define PHYCR_SPD_10 (1<<1) +#define PHYCR_SPD_100 (0<<1) + +#define PHYCR_HALF_DUP (1<<0) +#define PHYCR_FULL_DUP (0<<0) + +#define PHYCR1_RST (0<<0) + +#define PHYCR1_PWDN_ENABLE (1<<5) +#define PHYCR1_PWDN_DISABLE (0<<5) + + +/* Socket n MODE register 2 values */ + +/** + @brief Broadcast Blocking bit in MACRAW mode + @details In MACRAW mode, this bit is set to ????to block the broadcast packet. +*/ +#define Sn_MR2_MBBLK (1<<6) + +/** + @brief Multicast Blocking bit in MACRAW mode + @details In MACRAW mode, this bit is set to ????to block the multicast packet. +*/ +#define Sn_MR2_MMBLK (1<<5) + +/** + @brief IPv6 packet Blocking bit in MACRAW mode + @details In MACRAW mode, this bit is set to ????to block the IPv6 packet. +*/ +#define Sn_MR2_IPV6BLK (1<<4) + + +/** + @brief Broadcast Blocking bit in UDP mode + @details In UDP mode, this bit is set to ????to block the broadcast packet. +*/ +#define Sn_MR2_UBBLK (1<<1) + + +/** + @brief TCP Force PSH bit + @details When the SOCKET transmits data in TCP mode, PSH Flag is set to all packets. +*/ +#define Sn_MR2_FPSH Sn_MR2_UBBLK + +/** + @brief Unicast Blocking bit in UDP mode + @details In UDP mode, this bit is set to ????to block the Unicast packet. +*/ +#define Sn_MR2_UUBLK (1<<0) + +/*----------------------------For PHY Control-------------------------------*/ + +/********************/ +/* Register Address */ +/********************/ + +//Basic mode control register, basic register +#define PHYMDIO_BMCR 0x00 + +//Basic mode status register, basic register +#define PHYMDIO_BMSR 0x01 + +//--------------------------------------Not used-------------------------------------------// +////PHY identifier register 1, extended register +//#define PHY_IDR1 0x02 //not used +// +////PHY identifier register 2, extended register +//#define PHY_IDR2 0x03 //not used +// +////Auto-negotiation advertisement register, extended register +//#define PHY_ANAR 0x04 //not used +// +////Auto-negotiation link partner ability register, extended register +//#define PHY_ANLPAR 0x05 //not used +// +////Auto-negotiation expansion register, extended register +//#define PHY_ANER 0x06 //not used +// +////Auto-negotiation next page transmit +//#define PHY_ANNP 0x07 //not used +// +////Auto-negotiation link partner of the next page receive +//#define PHY_ANLPNP 0x08 //not used +// +////MMD access control register +//#define PHY_REGCR 0x09 //not used +// +////MMD access address data register +//#define PHY_ADDAR 0x0e //not used +//--------------------------------------Not used-------------------------------------------// + +/********************/ +/* Bit definitions */ +/********************/ + +//For BMCR register +#define BMCR_RESET (1<<15) +#define BMCR_MLOOPBACK (1<<14) +#define BMCR_SPEED (1<<13) +#define BMCR_AUTONEGO (1<<12) +#define BMCR_PWDN (1<<11) +#define BMCR_ISOLATE (1<<10) +#define BMCR_RSTNEGO (1<<9) +#define BMCR_DUP (1<<8) +#define BMCR_COLTEST (1<<7) + +//For BMSR register +#define BMSR_AUTONEGO_COMPL (1<<5) +#define BMSR_REMOTE_FAULT (1<<4) +#define BMSR_LINK_STATUS (1<<2) +#define BMSR_JAB_DETECT (1<<1) +#define EXTENDED_CAPA (1<<0) + +//--------------------------------------Not used-------------------------------------------// +////For ANAR register +//#define ANAR_NP (1<<15) +//#define ANAR_ACK (1<<14) +//#define ANAR_RF (1<<13) +//#define ANAR_ASM (3<<10) +//#define ANAR_T4 (1<<9) +//#define ANAR_TX_FD (1<<8) +//#define ANAR_TX_HD (1<<7) +//#define ANAR_10_FD (1<<6) +//#define ANAR_10_HD (1<<5) +//#define ANAR_SELECTOR (0x1F<<0) +// +////For ANAR register +//#define ANLPAR_NP (1<<15) +//#define ANLPAR_ACK (1<<14) +//#define ANLPAR_RF (1<<13) +//#define ANLPAR_LP_DIR (1<<11) +//#define ANLPAR_PAUSE (1<<10) +//#define ANLPAR_T4 (1<<9) +//#define ANLPAR_TX_FD (1<<8) +//#define ANLPAR_TX_HD (1<<7) +//#define ANLPAR_10_FD (1<<6) +//#define ANLPAR_10_HD (1<<5) +//#define ANLPAR_SELECTOR (0x1F<<0) + +/**/ +/* MDIO register*/ +//PCS_CTL_1 | PCS control 1 register +//PCS_STS_1 | PCS status 1 register +//EEE_ABILITY | EEE capability register +//WAKE_ER_CNTR | EEE wake error counter +//EEE_ADVR | EEE Advertisement register +//EEE_LPAR | EEE link partner ability register + +//--------------------------------------Not used-------------------------------------------// + +/********************/ +/*Functions for PHY */ +/********************/ +//todo move this definition to bit area +#define PHYACR_READ 0x02 +#define PHYACR_WRITE 0x01 + + + + +/** + @brief Enter a critical section + + @details It is provided to protect your shared code which are executed without distribution. \n \n + + In non-OS environment, It can be just implemented by disabling whole interrupt.\n + In OS environment, You can replace it to critical section api supported by OS. + + \sa WIZCHIP_READ(), WIZCHIP_WRITE(), WIZCHIP_READ_BUF(), WIZCHIP_WRITE_BUF() + \sa WIZCHIP_CRITICAL_EXIT() +*/ +#define WIZCHIP_CRITICAL_ENTER() WIZCHIP.CRIS._enter() + +#ifdef _exit +#undef _exit +#endif + +/** + @brief Exit a critical section + + @details It is provided to protect your shared code which are executed without distribution. \n\n + + In non-OS environment, It can be just implemented by disabling whole interrupt. \n + In OS environment, You can replace it to critical section api supported by OS. + + @sa WIZCHIP_READ(), WIZCHIP_WRITE(), WIZCHIP_READ_BUF(), WIZCHIP_WRITE_BUF() + @sa WIZCHIP_CRITICAL_ENTER() +*/ +#define WIZCHIP_CRITICAL_EXIT() WIZCHIP.CRIS._exit() + + + +//////////////////////// +// Basic I/O Function // +//////////////////////// +// +//M20150601 : uint16_t AddrSel --> uint32_t AddrSel +// +/** + @ingroup Basic_IO_function_W5100S + @brief It reads 1 byte value from a register. + @param AddrSel Register address + @return The value of register +*/ +uint8_t WIZCHIP_READ(uint32_t AddrSel); + +/** + @ingroup Basic_IO_function_W5100S + @brief It writes 1 byte value to a register. + @param AddrSel Register address + @param wb Write data + @return void +*/ +void WIZCHIP_WRITE(uint32_t AddrSel, uint8_t wb); + +/** + @ingroup Basic_IO_function_W5100S + @brief It reads sequence data from registers. + @param AddrSel Register address + @param pBuf Pointer buffer to read data + @param len Data length +*/ +void WIZCHIP_READ_BUF(uint32_t AddrSel, uint8_t* pBuf, uint16_t len); + +/** + @ingroup Basic_IO_function_W5100S + @brief It writes sequence data to registers. + @param AddrSel Register address + @param pBuf Pointer buffer to write data + @param len Data length +*/ +void WIZCHIP_WRITE_BUF(uint32_t AddrSel, uint8_t* pBuf, uint16_t len); + + +///////////////////////////////// +// Common Register IO function // +///////////////////////////////// + +/** + @ingroup Common_register_access_function_W5100S + @brief Set Mode Register + @param (uint8_t)mr The value to be set. + @sa getMR() +*/ +#if (_WIZCHIP_IO_MODE_ & _WIZCHIP_IO_MODE_SPI_) +#define setMR(mr) WIZCHIP_WRITE(MR,mr) +#else +#define setMR(mr) (*((uint8_t*)MR) = mr) +#endif + +/** + @ingroup Common_register_access_function_W5100S + @brief Get @ref MR. + @return uint8_t. The value of Mode register. + @sa setMR() +*/ +#if (_WIZCHIP_IO_MODE_ & _WIZCHIP_IO_MODE_SPI_) +#define getMR() WIZCHIP_READ(MR) +#else +#define getMR() (*(uint8_t*)MR) +#endif + +/** + @ingroup Common_register_access_function_W5100S + @brief Set @ref GAR. + @param (uint8_t*)gar Pointer variable to set gateway IP address. It should be allocated 4 bytes. + @sa getGAR() +*/ +#define setGAR(gar) \ + WIZCHIP_WRITE_BUF(GAR,gar,4) + +/** + @ingroup Common_register_access_function_W5100S + @brief Get @ref GAR. + @param (uint8_t*)gar Pointer variable to get gateway IP address. It should be allocated 4 bytes. + @sa setGAR() +*/ +#define getGAR(gar) \ + WIZCHIP_READ_BUF(GAR,gar,4) + +/** + @ingroup Common_register_access_function_W5100S + @brief Set @ref SUBR. + @param (uint8_t*)subr Pointer variable to set subnet mask address. It should be allocated 4 bytes. + @note If subr is null pointer, set the backup subnet to SUBR. \n + If subr is 0.0.0.0, back up SUBR and clear it. \n + Otherwize, set subr to SUBR + @sa getSUBR() +*/ +#define setSUBR(subr) \ + WIZCHIP_WRITE_BUF(SUBR,subr,4) + +/** + @ingroup Common_register_access_function_W5100S + @brief Get @ref SUBR. + @param (uint8_t*)subr Pointer variable to get subnet mask address. It should be allocated 4 bytes. + @sa setSUBR() +*/ +#define getSUBR(subr) \ + WIZCHIP_READ_BUF(SUBR, subr, 4) + +/** + @ingroup Common_register_access_function_W5100S + @brief Set @ref SHAR. + @param (uint8_t*)shar Pointer variable to set local MAC address. It should be allocated 6 bytes. + @sa getSHAR() +*/ +#define setSHAR(shar) \ + WIZCHIP_WRITE_BUF(SHAR, shar, 6) + +/** + @ingroup Common_register_access_function_W5100S + @brief Get @ref SHAR. + @param (uint8_t*)shar Pointer variable to get local MAC address. It should be allocated 6 bytes. + @sa setSHAR() +*/ +#define getSHAR(shar) \ + WIZCHIP_READ_BUF(SHAR, shar, 6) + +/** + @ingroup Common_register_access_function_W5100S + @brief Set @ref SIPR. + @param (uint8_t*)sipr Pointer variable to set local IP address. It should be allocated 4 bytes. + @sa getSIPR() +*/ +#define setSIPR(sipr) \ + WIZCHIP_WRITE_BUF(SIPR, sipr, 4) + +/** + @ingroup Common_register_access_function_W5100S + @brief Get @ref SIPR. + @param (uint8_t*)sipr Pointer variable to get local IP address. It should be allocated 4 bytes. + @sa setSIPR() +*/ +#define getSIPR(sipr) \ + WIZCHIP_READ_BUF(SIPR, sipr, 4) + +/** + @ingroup Common_register_access_function_W5100S + @brief Set \ref IR register + @param (uint8_t)ir Value to set \ref IR register. + @sa getIR() +*/ +#define setIR(ir) \ + WIZCHIP_WRITE(IR, (ir & 0xE0)) //peter 2016.11.07 unreachable interrupt bit added +//WIZCHIP_WRITE(IR, (ir & 0xA0)) +/** + @ingroup Common_register_access_function_W5100S + @brief Get \ref IR register + @return uint8_t. Value of \ref IR register. + @sa setIR() +*/ +#define getIR() \ + WIZCHIP_READ(IR) + +/** + @ingroup Common_register_access_function_W5100S + @brief Set \ref _IMR_ register + @param (uint8_t)imr Value to set @ref _IMR_ register. + @sa getIMR() +*/ +#define setIMR(imr) \ + WIZCHIP_WRITE(_IMR_, imr) + +/** + @ingroup Common_register_access_function_W5100S + @brief Get \ref _IMR_ register + @return uint8_t. Value of @ref _IMR_ register. + @sa setIMR() +*/ +#define getIMR() \ + WIZCHIP_READ(_IMR_) + +/** + @ingroup Common_register_access_function_W5100S + @brief Set \ref _RTR_ register + @param (uint16_t)rtr Value to set @ref _RTR_ register. + @sa getRTR() +*/ +#define setRTR(rtr) {\ + WIZCHIP_WRITE(_RTR_, (uint8_t)(rtr >> 8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(_RTR_,1), (uint8_t) rtr); \ + } + +/** + @ingroup Common_register_access_function_W5100S + @brief Get \ref _RTR_ register + @return uint16_t. Value of @ref _RTR_ register. + @sa setRTR() +*/ +#define getRTR() \ + (((uint16_t)WIZCHIP_READ(_RTR_) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(_RTR_,1))) + +/** + @ingroup Common_register_access_function_W5100S + @brief Set \ref _RCR_ register + @param (uint8_t)rcr Value to set @ref _RCR_ register. + @sa getRCR() +*/ +#define setRCR(rcr) \ + WIZCHIP_WRITE(_RCR_, rcr) + +/** + @ingroup Common_register_access_function_W5100S + @brief Get \ref _RCR_ register + @return uint8_t. Value of @ref _RCR_ register. + @sa setRCR() +*/ +#define getRCR() \ + WIZCHIP_READ(_RCR_) + +/** + @ingroup Common_register_access_function_W5100S + @brief Get \ref RMSR register + @sa getRMSR() +*/ +#define setRMSR(rmsr) \ + WIZCHIP_WRITE(RMSR,rmsr) // Receicve Memory Size + +/** + @ingroup Common_register_access_function_W5100S + @brief Get \ref RMSR register + @return uint8_t. Value of @ref RMSR register. + @sa setRMSR() +*/ +#define getRMSR() \ + WIZCHIP_READ(RMSR) // Receicve Memory Size + +/** + @ingroup Common_register_access_function_W5100S + @brief Get \ref TMSR register + @sa getTMSR() +*/ +#define setTMSR(tmsr) \ + WIZCHIP_WRITE(TMSR,tmsr) // Receicve Memory Size + +/** + @ingroup Common_register_access_function_W5100S + @brief Get \ref TMSR register + @return uint8_t. Value of @ref TMSR register. + @sa setTMSR() +*/ +#define getTMSR() \ + WIZCHIP_READ(TMSR) + + +/** + @ingroup Common_register_access_function_W5100S + @brief Get \ref PATR register + @return uint16_t. Value to set \ref PATR register +*/ +#define getPATR() \ + (((uint16_t)WIZCHIP_READ(PATR) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(PATR,1))) + +/** + @ingroup Common_register_access_function_W5100S + @brief Get \ref PPPALGO register + @return uint8_t. Value to set \ref PPPALGO register +*/ +#define getPPPALGO() \ + WIZCHIP_READ(PPPALGO) + + +/** + @ingroup Common_register_access_function_W5100S + @brief Set \ref PTIMER register + @param (uint8_t)ptimer Value to set \ref PTIMER register. + @sa getPTIMER() +*/ +#define setPTIMER(ptimer) \ + WIZCHIP_WRITE(PTIMER, ptimer) + +/** + @ingroup Common_register_access_function_W5100S + @brief Get \ref PTIMER register + @return uint8_t. Value of @ref PTIMER register. + @sa setPTIMER() +*/ +#define getPTIMER() \ + WIZCHIP_READ(PTIMER) + +/** + @ingroup Common_register_access_function_W5100S + @brief Set \ref PMAGIC register + @param (uint8_t)pmagic Value to set @ref PMAGIC register. + @sa getPMAGIC() +*/ +#define setPMAGIC(pmagic) \ + WIZCHIP_WRITE(PMAGIC, pmagic) + +/** + @ingroup Common_register_access_function_W5100S + @brief Get \ref PMAGIC register + @return uint8_t. Value of @ref PMAGIC register. + @sa setPMAGIC() +*/ +#define getPMAGIC() \ + WIZCHIP_READ(PMAGIC) + + +//todo Functions for W5100S + +/*----------------------------------------------------------------------*/ +/* W5100S only */ +/*----------------------------------------------------------------------*/ + +/** + @ingroup Common_register_access_function_W5100S + @brief Set \ref IR2 register + @param (uint8_t)ir2 Value to set @ref IR2 register. + @sa getIR2() +*/ +#define setIR2(ir2) \ + WIZCHIP_WRITE(IR2, ir2) + +/** + @ingroup Common_register_access_function_W5100S + @brief Get \ref IR2 register + @return uint8_t. Value of @ref IR2 register. + @sa setIR2() +*/ +#define getIR2() \ + WIZCHIP_READ(IR2) + +/** + @ingroup Common_register_access_function_W5100S + @brief Set \ref IMR2 register + @param (uint8_t)imr2 Value to set @ref IMR2 register. + @sa setIMR2() +*/ +#define setIMR2(imr2) \ + WIZCHIP_WRITE(IMR2,imr2) + +/** + @ingroup Common_register_access_function_W5100S + @brief Get \ref IMR2 register + @return uint8_t. Value of @ref IMR2 register. + @sa getIMR2() +*/ +#define getIMR2() \ + WIZCHIP_READ(IMR2) + +/** + @ingroup Common_register_access_function_W5100S + @brief Set \ref UIPR(Unreachable IP Address Register) registers + @param (uint8_t*)uipr Value to set @ref UIPR registers. + @sa setUIPR() +*/ +#define setUIPR(uipr) \ + WIZCHIP_WRITE_BUF(UIPR,uipr,4) + +/** + @ingroup Common_register_access_function_W5100S + @brief Get \ref UIPR(Unreachable IP Address Register) registers + @param (uint8_t*)uipr Value to get @ref UIPR registers + @sa setUIPR() +*/ +#define getUIPR(uipr) \ + WIZCHIP_READ_BUF(UIPR,uipr,4) + +/** + @ingroup Common_register_access_function_W5100S + @brief Set \ref UPORTR(Unreachable Port Address Register) register + @param (uint16_t)uportr Value to set @ref UPORTR register. + @sa getUPORTR() +*/ +#define setUPORTR(uportr) {\ + WIZCHIP_WRITE(UPORTR, (uint8_t)(uportr >> 8)); \ + WIZCHIP_WRITE(UPORTR+1, (uint8_t) uportr); \ + } + +/** + @ingroup Common_register_access_function_W5100S + @brief Get \ref UPORTR(Unreachable Port Address Register) register + @return uint16_t. Value of @ref UPORTR register. + @sa setUPORTR() +*/ +#define getUPORTR() \ + (((uint16_t)WIZCHIP_READ(UPORTR) << 8) + WIZCHIP_READ(UPORTR+1)) + +/** + @ingroup Common_register_access_function_W5100S + @brief Set \ref MR2 register + @param (uint8_t)mr2 Value to set @ref MR2 registers. + @sa getMR2() +*/ +#define setMR2(mr2) \ + WIZCHIP_WRITE(MR2,mr2) + +/** + @ingroup Common_register_access_function_W5100S + @brief Get \ref MR2 register + @return uint8_t. Value of @ref MR2 register. + @sa setMR2() +*/ +#define getMR2() \ + WIZCHIP_READ(MR2) + +/** + @ingroup Common_register_access_function_W5100S + @brief Set \ref PHAR registers + @param (uint8_t*)phar Value to set @ref PHAR registers. + @sa getPHAR() +*/ +#define setPHAR(phar) \ + WIZCHIP_WRITE_BUF(PHAR,phar,6) + +/** + @ingroup Common_register_access_function_W5100S + @brief Get \ref PHAR registers + @param (uint8_t*)phar Pointer variable to get @ref PHAR registers. + @sa setPHAR() +*/ +#define getPHAR(phar) \ + WIZCHIP_READ_BUF(PHAR,phar,6) + +/** + @ingroup Common_register_access_function_W5100S + @brief Set \ref PSIDR register + @param (uint16_t)psidr Value to set @ref PSIDR register. + @sa getPSIDR() +*/ +#define setPSIDR(psidr) {\ + WIZCHIP_WRITE(PSIDR, (uint8_t)(psidr >> 8)); \ + WIZCHIP_WRITE(PSIDR+1, (uint8_t) psidr); \ + } + +/** + @ingroup Common_register_access_function_W5100S + @brief Get \ref PSIDR register + @return uint16_t. Value of @ref PSIDR register. + @sa setPSIDR() +*/ +#define getPSIDR() \ + (((uint16_t)WIZCHIP_READ(PSIDR) << 8) + WIZCHIP_READ(PSIDR+1)) + +/** + @ingroup Common_register_access_function_W5100S + @brief Set \ref PMRUR register + @param (uint16_t)pmrur Value to set @ref PMRUR register. + @sa getPMRUR() +*/ +#define setPMRUR(pmrur) {\ + WIZCHIP_WRITE(PMRUR, (uint8_t)(pmrur >> 8)); \ + WIZCHIP_WRITE(PMRUR+1, (uint8_t) pmrur); \ + } + +/** + @ingroup Common_register_access_function_W5100S + @brief Get \ref PMRUR register + @return uint16_t. Value of @ref PMRUR register. + @sa setPMRUR() +*/ +#define getPMRUR() \ + (((uint16_t)WIZCHIP_READ(PMRUR) << 8) + WIZCHIP_READ(PMRUR+1)) + +/** + @ingroup Common_register_access_function_W5100S + @brief Get \ref PHYSR register + @return uint8_t. Value of @ref PHYSR register. + @sa setPHYSR() +*/ +#define getPHYSR() \ + WIZCHIP_READ(PHYSR) + +/** + @ingroup Common_register_access_function_W5100S + @brief Get \ref PHYSR1 register + @return uint8_t. Value of @ref PHYSR1 register. + @sa setPHYSR1() +*/ +#define getPHYSR1() \ + WIZCHIP_READ(PHYSR1) + +/** + For internal uses + The address of the PHY is fixed as "0x0A". +*/ +#define getPHYAR() \ + WIZCHIP_READ(PHYAR) + +/** + @ingroup Common_register_access_function_W5100S + @brief Get \ref PHYRAR register + @return uint8_t. Value of @ref PHYRAR register. + @sa setPHYRAR() +*/ +#define getPHYRAR() \ + WIZCHIP_READ(PHYRAR) + +/** + @ingroup Common_register_access_function_W5100S + @brief Set \ref PHYRR register + @param (uint8_t)phyrar Value to set @ref PHYRR register. + @sa getPHYRR() +*/ +#define setPHYRR(phyrar) \ + WIZCHIP_WRITE(PHYRAR, phyrar) + +/** + @ingroup Common_register_access_function_W5100S + @brief Get \ref PHYDIR register + @return uint16_t. Value of @ref PHYDIR register. + @sa setPHYRAR() +*/ +//read the value of the phy data input register +#define getPHYDIR() \ + (((uint16_t)WIZCHIP_READ(PHYDIR+1) << 8) + WIZCHIP_READ(PHYDIR)) + +/** + @ingroup Common_register_access_function_W5100S + @brief Set \ref PHYDIR register + @param (uint16_t)phydir Value to set @ref PHYDIR register. + @sa getPHYDIR() +*/ +//write the value of the phy data input register +#define setPHYDIR(phydir) {\ + WIZCHIP_WRITE(PHYDIR+1, (uint8_t)(phydir >> 8)); \ + WIZCHIP_WRITE(PHYDIR, (uint8_t) phydir); \ + } + +/** + @ingroup Common_register_access_function_W5100S + @brief Get \ref PHYDOR register + @return uint16_t. Value of @ref PHYDOR register. + @sa setPHYDOR() +*/ +//read the value of the phy data output register +#define getPHYDOR() \ + (((uint16_t)WIZCHIP_READ(PHYDOR+1) << 8) + WIZCHIP_READ(PHYDOR)) + +/** + @ingroup Common_register_access_function_W5100S + @brief Set \ref PHYDOR register + @param (uint16_t)phydor Value to set @ref PHYDOR register. + @sa getPHYDOR() +*/ +//write the value of the phy data output register +#define setPHYDOR(phydor) {\ + WIZCHIP_WRITE(PHYDOR, (uint8_t)(phydor >> 8)); \ + WIZCHIP_WRITE(PHYDOR+1, (uint8_t) phydor); \ + } + +/** + @ingroup Common_register_access_function_W5100S + @brief Get \ref PHYACR register + @return uint8_t. Value of @ref PHYACR register. + @sa setPHYACR() +*/ +//read the value of the phy action register ***This register will be cleared automatically*** +#define getPHYACR() \ + WIZCHIP_READ(PHYACR) + +/** + @ingroup Common_register_access_function_W5100S + @brief Set \ref PHYACR register + @param (uint8_t)phyacr Value to set @ref PHYACR register. + @sa getPHYACR() +*/ +//write the value of the phy action register +#define setPHYACR(phyacr) \ + WIZCHIP_WRITE(PHYACR,phyacr) + +/** + @ingroup Common_register_access_function_W5100S + @brief Set \ref PHYDIVR register + @param (uint8_t)phydivr Value to set @ref PHYDIVR register. + @sa getPHYDIVR() +*/ +#define setPHYDIVR(phydivr) \ + WIZCHIP_WRITE(PHYDIVR, phydivr) + +/** + @ingroup Common_register_access_function_W5100S + @brief Get \ref PHYDIVR register + @return uint8_t. Value of @ref PHYDIVR register. + @sa setPHYDIVR() +*/ +#define getPHYDIVR() \ + WIZCHIP_READ(PHYDIVR) + +/** + @ingroup Common_register_access_function_W5100S + @brief Set \ref PHYCR0 register + @param (uint8_t)phych0 Value to set @ref PHYCR0 register. + @sa getPHYCR0() +*/ +#define setPHYCR0(phych0) \ + WIZCHIP_WRITE(PHYCR0,phych0) + +/** + @ingroup Common_register_access_function_W5100S + @brief Get \ref PHYCR0 register + @return uint8_t. Value of @ref PHYCR0 register. + @sa setPHYCR0() +*/ +#define getPHYCR0() \ + WIZCHIP_READ(PHYCR0) + +/** + @ingroup Common_register_access_function_W5100S + @brief Set \ref PHYCR1 register + @param (uint8_t)phycr1 Value to set @ref PHYCR1 register. + @sa getPHYCR1() +*/ +#define setPHYCR1(phycr1) \ + WIZCHIP_WRITE(PHYCR1,phycr1) + +/** + @ingroup Common_register_access_function_W5100S + @brief Get \ref PHYCR1 register + @return uint8_t. Value of @ref PHYCR1 register. + @sa setPHYCR1() +*/ +#define getPHYCR1() \ + WIZCHIP_READ(PHYCR1) + +/** + @ingroup Common_register_access_function_W5100S + @brief Set \ref SLCR register + @param (uint8_t)rqcr Value to set @ref SLCR register. + @sa getSLCR() +*/ +#define setSLCR(rqcr) \ + WIZCHIP_WRITE(SLCR, rqcr) + +/** + @ingroup Common_register_access_function_W5100S + @brief Get \ref SLCR register + @return uint8_t. Value of @ref SLCR register. + @sa setSLCR() +*/ +#define getSLCR() \ + WIZCHIP_READ(SLCR) + +/** + @ingroup Common_register_access_function_W5100S + @brief Set \ref SLRTR register + @param (uint16_t)slrtr Value to set @ref SLRTR register. + @sa getSLRTR() +*/ +#define setSLRTR(slrtr) \ + WIZCHIP_WRITE(SLRTR, (uint8_t)(slrtr >> 8)); \ + WIZCHIP_WRITE(SLRTR+1, (uint8_t) slrtr); \ + +/** + @ingroup Common_register_access_function_W5100S + @brief Get \ref SLRTR register + @return uint16_t. Value of @ref SLRTR register. + @sa setSLRTR() +*/ +#define getSLRTR() \ + (((uint16_t)WIZCHIP_READ(SLRTR) << 8) + WIZCHIP_READ(SLRTR+1)) + +/** + @ingroup Common_register_access_function_W5100S + @brief Set \ref SLRCR register + @param (uint8_t)slrcr Value to set @ref SLRCR register. + @sa getSLRCR() +*/ +#define setSLRCR(slrcr) \ + WIZCHIP_WRITE(SLRCR,slrcr) + +/** + @ingroup Common_register_access_function_W5100S + @brief Get \ref SLRCR register + @return uint8_t. Value of @ref SLRCR register. + @sa setSLRCR() +*/ +#define getSLRCR() \ + WIZCHIP_READ(SLRCR) + +/** + @ingroup Common_register_access_function_W5100S + @brief Set \ref SLPIPR registers + @param (uint8_t*)slpipr Values to set @ref SLPIPR registers. + @sa getSLPIPR() +*/ +#define setSLPIPR(slpipr) \ + WIZCHIP_WRITE_BUF(SLPIPR,slpipr,4) + +/** + @ingroup Common_register_access_function_W5100S + @brief Get \ref SLPIPR registers + @param (uint8_t*)slpipr Values to get @ref SLPIPR registers. + @sa getSLPIPR() +*/ +#define getSLPIPR(slpipr) \ + WIZCHIP_READ_BUF(SLPIPR,slpipr,4) + +/** + @ingroup Common_register_access_function_W5100S + @brief Get \ref SLPHAR registers + @param (uint8_t*)slphar Values to set @ref SLPHAR registers. + @sa getSLPHAR() +*/ +#define setSLPHAR(slphar) \ + WIZCHIP_WRITE_BUF(SLPHAR,slphar,6) + +/** + @ingroup Common_register_access_function_W5100S + @brief Get \ref SLPHAR registers + @param (uint8_t*)slphar Values to get @ref SLPHAR registers. + @sa getSLPHAR() +*/ +#define getSLPHAR(slphar) \ + WIZCHIP_READ_BUF(SLPHAR,slphar,6) + +/** + @ingroup Common_register_access_function_W5100S + @brief Set \ref PINGSEQR register + @param (uint16_t)pingseqr Value to set @ref PINGSEQR register. + @sa getPINGSEQR() +*/ +#define setPINGSEQR(pingseqr) {\ + WIZCHIP_WRITE(PINGSEQR, (uint8_t)(pingseqr >> 8)); \ + WIZCHIP_WRITE(PINGSEQR+1, (uint8_t) pingseqr); \ + } + +/** + @ingroup Common_register_access_function_W5100S + @brief Get \ref PINGSEQR register + @return uint16_t. Value of @ref PINGSEQR register. + @sa setPINGSEQR() +*/ +#define getPINGSEQR() \ + (((uint16_t)WIZCHIP_READ(PINGSEQR) << 8) + WIZCHIP_READ(PINGSEQR+1)) + +/** + @ingroup Common_register_access_function_W5100S + @brief Set \ref PINGIDR register + @param (uint16_t)pingidr Value to set @ref PINGIDR register. + @sa getPINGIDR() +*/ +#define setPINGIDR(pingidr) {\ + WIZCHIP_WRITE(PINGIDR, (uint8_t)(pingidr >> 8)); \ + WIZCHIP_WRITE(PINGIDR+1, (uint8_t) pingidr); \ + } + +/** + @ingroup Common_register_access_function_W5100S + @brief Get \ref PINGIDR register + @return uint16_t. Value of @ref PINGIDR register. + @sa setPINGIDR() +*/ +#define getPINGIDR() \ + (((uint16_t)WIZCHIP_READ(PINGIDR) << 8) + WIZCHIP_READ(PINGIDR+1)) + +/** + @ingroup Common_register_access_function_W5100S + @brief Set \ref SLIMR register + @param (uint8_t)slimr Value to set @ref SLIMR register. + @sa getSLIMR() +*/ +#define setSLIMR(slimr) \ + WIZCHIP_WRITE(SLIMR, slimr) + +/** + @ingroup Common_register_access_function_W5100S + @brief Get \ref SLIMR register + @return uint8_t. Value of @ref SLIMR register. + @sa setSLIMR() +*/ +#define getSLIMR() \ + WIZCHIP_READ(SLIMR) + +/** + @ingroup Common_register_access_function_W5100S + @brief Set \ref SLIR register + @param (uint8_t)slir Value to set @ref SLIR register. + @sa getSLIMR() +*/ +#define setSLIR(slir) \ + WIZCHIP_WRITE(SLIR, slir) + +/** + @ingroup Common_register_access_function_W5100S + @brief Get \ref SLIMR register + @return uint8_t. Value of @ref SLIMR register. + @sa setSLIMR() +*/ +#define getSLIR() \ + WIZCHIP_READ(SLIR) + +/*Hidden functions for W5100S*/ +#define setDBGOUT(dbgout) {\ + WIZCHIP_WRITE(DBGOUT,(uint8_t)(dbgout >> 16)); \ + WIZCHIP_WRITE(DBGOUT,(uint8_t)(dbgout >> 8)); \ + WIZCHIP_WRITE(DBGOUT,(uint8_t)(dbgout)); \ + } + +/** + @ingroup Common_register_access_function_W5100S + @brief Set \ref NICMAXCOLR register + @param (uint8_t)nicmaxcolr Value to set @ref NICMAXCOLR register. + @sa getNICMAXCOLR() +*/ +#define setNICMAXCOLR(nicmaxcolr) \ + WIZCHIP_WRITE(NICMAXCOLR,nicmaxcolr) + +/** + @ingroup Common_register_access_function_W5100S + @brief Get \ref NICMAXCOLR register + @return uint8_t. Value of @ref NICMAXCOLR register. + @sa setNICMAXCOLR() +*/ +#define getNICMAXCOLR() \ + WIZCHIP_READ(NICMAXCOLR) + +/*Clock lock/unlock*/ + +/** + @ingroup Common_register_access_function_W5100S + @brief LOCK Chip Information + @sa CHIPULLOCK() +*/ +#define CHIPLOCK() \ + WIZCHIP_WRITE(CHIPLCKR,0xff) + +/** + @ingroup Common_register_access_function_W5100S + @brief Unlock Chip Information + @sa CHIPLOCK() +*/ +#define CHIPUNLOCK() \ + WIZCHIP_WRITE(CHIPLCKR,0xCE) + + +/** + @ingroup Common_register_access_function_W5100S + @brief LOCK Chip Information + @sa CHIPULLOCK() +*/ +/*Network information lock/unlock*/ +#define NETLOCK() \ + WIZCHIP_WRITE(NETLCKR,0x3A) + +/** + @ingroup Common_register_access_function_W5100S + @brief Unlock Chip Information + @sa CHIPLOCK() +*/ +#define NETUNLOCK() \ + WIZCHIP_WRITE(NETLCKR,0xC5) + +/** + @ingroup Common_register_access_function_W5100S + @brief Lock PHYCR0,CR1 Information + @sa CHIPULLOCK() +*/ +/*PHY CR0,CR1 lock/unlock*/ +#define PHYLOCK() \ + WIZCHIP_WRITE(PHYLCKR,0xff) + +/** + @ingroup Common_register_access_function_W5100S + @brief Lock PHYCR0,CR1 Information + @sa CHIPULLOCK() +*/ +#define PHYUNLOCK() \ + WIZCHIP_WRITE(PHYLCKR,0x53) + +/** + @ingroup Version register_access_function_W5100SS + @brief Get version information. + @return uint16_t. It must be "0x51" +*/ +#define getVER() \ + (WIZCHIP_READ(VERR)) + +/** + @ingroup Common_register_access_function_W5100S + @brief Get \ref TCNTR register + @return uint16_t. Value of @ref TCNTR register. + @sa setNTCNTR() +*/ +/*Get 100us internal counter*/ +#define getTCNTR() \ + (((uint16_t)WIZCHIP_READ(TCNTR) << 8) + WIZCHIP_READ(TCNTR+1)) + +/** + @ingroup Common_register_access_function_W5100S + @brief Set \ref TCNTR register + @param (uint8_t) + Value to set @ref TCNTR register. + @sa getTCNTCLKR() +*/ +/*Reset 100us internal counter(TCNTR)*/ +#define setTCNTCLKR(var) \ + WIZCHIP_WRITE(TCNTCLKR, var) + +/*w5100s only end*/ + + + + + +/////////////////////////////////// +// Socket N register I/O function // +/////////////////////////////////// +/** + @ingroup Socket_register_access_function_W5100S + @brief Set @ref Sn_MR register + @param sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_ expect bit 4. + @param mr Value to set @ref Sn_MR + @sa getSn_MR() +*/ +#define setSn_MR(sn, mr) \ + WIZCHIP_WRITE(Sn_MR(sn),mr) + +/** + @ingroup Socket_register_access_function_W5100S + @brief Get @ref Sn_MR register + @param sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_ expect bit 4. + @return Value of @ref Sn_MR. + @sa setSn_MR() +*/ +#define getSn_MR(sn) \ + WIZCHIP_READ(Sn_MR(sn)) + +/** + @ingroup Socket_register_access_function_W5100S + @brief Set @ref Sn_CR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param (uint8_t)cr Value to set @ref Sn_CR + @sa getSn_CR() +*/ +#define setSn_CR(sn, cr) \ + WIZCHIP_WRITE(Sn_CR(sn), cr) + +/** + @ingroup Socket_register_access_function_W5100S + @brief Get @ref Sn_CR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint8_t. Value of @ref Sn_CR. + @sa setSn_CR() +*/ +#define getSn_CR(sn) \ + WIZCHIP_READ(Sn_CR(sn)) + +/** + @ingroup Socket_register_access_function_W5100S + @brief Set @ref Sn_IR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param (uint8_t)ir Value to set @ref Sn_IR + @sa getSn_IR() +*/ +#define setSn_IR(sn, ir) \ + WIZCHIP_WRITE(Sn_IR(sn), ir) + +/** + @ingroup Socket_register_access_function_W5100S + @brief Get @ref Sn_IR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint8_t. Value of @ref Sn_IR. + @sa setSn_IR() +*/ +#define getSn_IR(sn) \ + WIZCHIP_READ(Sn_IR(sn)) + +/** + @ingroup Socket_register_access_function_W5100S + @brief Get @ref Sn_SR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint8_t. Value of @ref Sn_SR. +*/ +#define getSn_SR(sn) \ + WIZCHIP_READ(Sn_SR(sn)) + +/** + @ingroup Socket_register_access_function_W5100S + @brief Set @ref Sn_PORT register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param (uint16_t)port Value to set @ref Sn_PORT. + @sa getSn_PORT() +*/ +#define setSn_PORT(sn, port) { \ + WIZCHIP_WRITE(Sn_PORT(sn), (uint8_t)(port >> 8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(Sn_PORT(sn),1), (uint8_t) port); \ + } +#define setSn_PORTR setSn_PORT +/** + @ingroup Socket_register_access_function_W5100S + @brief Get @ref Sn_PORT register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint16_t. Value of @ref Sn_PORT. + @sa setSn_PORT() +*/ +#define getSn_PORT(sn) \ + (((uint16_t)WIZCHIP_READ(Sn_PORT(sn)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_PORT(sn),1))) + +/** + @ingroup Socket_register_access_function_W5100S + @brief Set @ref Sn_DHAR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param (uint8_t*)dhar Pointer variable to set socket n destination hardware address. It should be allocated 6 bytes. + @sa getSn_DHAR() +*/ +#define setSn_DHAR(sn, dhar) \ + WIZCHIP_WRITE_BUF(Sn_DHAR(sn), dhar, 6) + +/** + @ingroup Socket_register_access_function_W5100S + @brief Get @ref Sn_DHAR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param (uint8_t*)dhar Pointer variable to get socket n destination hardware address. It should be allocated 6 bytes. + @sa setSn_DHAR() +*/ +#define getSn_DHAR(sn, dhar) \ + WIZCHIP_READ_BUF(Sn_DHAR(sn), dhar, 6) + +/** + @ingroup Socket_register_access_function_W5100S + @brief Set @ref Sn_DIPR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param (uint8_t*)dipr Pointer variable to set socket n destination IP address. It should be allocated 4 bytes. + @sa getSn_DIPR() +*/ +#define setSn_DIPR(sn, dipr) \ + WIZCHIP_WRITE_BUF(Sn_DIPR(sn), dipr, 4) + +/** + @ingroup Socket_register_access_function_W5100S + @brief Get @ref Sn_DIPR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param (uint8_t*)dipr Pointer variable to get socket n destination IP address. It should be allocated 4 bytes. + @sa SetSn_DIPR() +*/ +#define getSn_DIPR(sn, dipr) \ + WIZCHIP_READ_BUF(Sn_DIPR(sn), dipr, 4) + +/** + @ingroup Socket_register_access_function_W5100S + @brief Set @ref Sn_DPORT register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param (uint16_t)dport Value to set @ref Sn_DPORT + @sa getSn_DPORT() +*/ +#define setSn_DPORT(sn, dport) { \ + WIZCHIP_WRITE(Sn_DPORT(sn), (uint8_t) (dport>>8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(Sn_DPORT(sn),1), (uint8_t) dport); \ + } +#define setSn_DPORTR(sn, dport) setSn_DPORT(sn,dport) +/** + @ingroup Socket_register_access_function_W5100S + @brief Get @ref Sn_DPORT register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint16_t. Value of @ref Sn_DPORT. + @sa setSn_DPORT() +*/ +#define getSn_DPORT(sn) \ + (((uint16_t)WIZCHIP_READ(Sn_DPORT(sn)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_DPORT(sn),1))) +#define getSn_DPORTR(sn) getSn_DPORT(sn) +/** + @ingroup Socket_register_access_function_W5100S + @brief Set @ref Sn_MSSR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param (uint16_t)mss Value to set @ref Sn_MSSR + @sa setSn_MSSR() +*/ +#define setSn_MSSR(sn, mss) { \ + WIZCHIP_WRITE(Sn_MSSR(sn), (uint8_t)(mss>>8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(Sn_MSSR(sn),1), (uint8_t) mss); \ + } + +/** + @ingroup Socket_register_access_function_W5100S + @brief Get @ref Sn_MSSR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint16_t. Value of @ref Sn_MSSR. + @sa setSn_MSSR() +*/ +#define getSn_MSSR(sn) \ + (((uint16_t)WIZCHIP_READ(Sn_MSSR(sn)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_MSSR(sn),1))) + +/** + @ingroup Socket_register_access_function_W5100S + @brief Set @ref Sn_PROTO register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param (uint8_t)proto Value to set \ref Sn_PROTO + @sa getSn_PROTO() +*/ +#define setSn_PROTO(sn, proto) \ + WIZCHIP_WRITE(Sn_PROTO(sn), proto) + +/** + @ingroup Socket_register_access_function_W5100S + @brief Get @ref Sn_PROTO register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint8_t. Value of @ref Sn_PROTO. + @sa setSn_PROTO() +*/ +#define getSn_PROTO(sn) \ + WIZCHIP_READ(Sn_PROTO(sn)) + +/** + @ingroup Socket_register_access_function_W5100S + @brief Set @ref Sn_TOS register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param (uint8_t)tos Value to set @ref Sn_TOS + @sa getSn_TOS() +*/ +#define setSn_TOS(sn, tos) \ + WIZCHIP_WRITE(Sn_TOS(sn), tos) + +/** + @ingroup Socket_register_access_function_W5100S + @brief Get @ref Sn_TOS register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_ . + @return uint8_t. Value of Sn_TOS. + @sa setSn_TOS() +*/ +#define getSn_TOS(sn) \ + WIZCHIP_READ(Sn_TOS(sn)) + +/** + @ingroup Socket_register_access_function_W5100S + @brief Set @ref Sn_TTL register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_ . + @param (uint8_t)ttl Value to set @ref Sn_TTL + @sa getSn_TTL() +*/ +#define setSn_TTL(sn, ttl) \ + WIZCHIP_WRITE(Sn_TTL(sn), ttl) + +/** + @ingroup Socket_register_access_function_W5100S + @brief Get @ref Sn_TTL register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_ . + @return uint8_t. Value of @ref Sn_TTL. + @sa setSn_TTL() +*/ +#define getSn_TTL(sn) \ + WIZCHIP_READ(Sn_TTL(sn)) + +/** + @ingroup Socket_register_access_function_W5100S + @brief Set @ref Sn_RXMEM_SIZE register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_ . + @param (uint8_t)rxmemsize Value to set \ref Sn_RXMEM_SIZE + @sa getSn_RXMEM_SIZE() +*/ +#define setSn_RXMEM_SIZE(sn, rxmemsize) \ + WIZCHIP_WRITE(RMSR, (WIZCHIP_READ(RMSR) & ~(0x03 << (2*sn))) | (rxmemsize << (2*sn))) +#define setSn_RXBUF_SIZE(sn,rxmemsize) setSn_RXMEM_SIZE(sn,rxmemsize) +/** + @ingroup Socket_register_access_function_W5100S + @brief Get @ref Sn_RXMEM_SIZE register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint8_t. Value of @ref Sn_RXMEM. + @sa setSn_RXMEM_SIZE() +*/ +#define getSn_RXMEM_SIZE(sn) \ + ((WIZCHIP_READ(RMSR) & (0x03 << (2*sn))) >> (2*sn)) +#define getSn_RXBUF_SIZE(sn) getSn_RXMEM_SIZE(sn) + +/** + @ingroup Socket_register_access_function_W5100S + @brief Set @ref Sn_TXMEM_SIZE register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param (uint8_t)txmemsize Value to set \ref Sn_TXMEM_SIZE + @sa getSn_TXMEM_SIZE() +*/ +#define setSn_TXMEM_SIZE(sn, txmemsize) \ + WIZCHIP_WRITE(TMSR, (WIZCHIP_READ(TMSR) & ~(0x03 << (2*sn))) | (txmemsize << (2*sn))) +#define setSn_TXBUF_SIZE(sn, txmemsize) setSn_TXMEM_SIZE(sn,txmemsize) + +/** + @ingroup Socket_register_access_function_W5100S + @brief Get @ref Sn_TXMEM_SIZE register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint8_t. Value of @ref Sn_TXMEM_SIZE. + @sa setSn_TXMEM_SIZE() +*/ +#define getSn_TXMEM_SIZE(sn) \ + ((WIZCHIP_READ(TMSR) & (0x03 << (2*sn))) >> (2*sn)) +#define getSn_TXBUF_SIZE(sn) getSn_TXMEM_SIZE(sn) + +/** + @ingroup Socket_register_access_function_W5100S + @brief Get @ref Sn_TX_FSR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint16_t. Value of @ref Sn_TX_FSR. +*/ +uint16_t getSn_TX_FSR(uint8_t sn); + +/** + @ingroup Socket_register_access_function_W5100S + @brief Get @ref Sn_TX_RD register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint16_t. Value of @ref Sn_TX_RD. +*/ +#define getSn_TX_RD(sn) \ + (((uint16_t)WIZCHIP_READ(Sn_TX_RD(sn)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_TX_RD(sn),1))) + +/** + @ingroup Socket_register_access_function_W5100S + @brief Set @ref Sn_TX_WR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param (uint16_t)txwr Value to set @ref Sn_TX_WR + @sa GetSn_TX_WR() +*/ +#define setSn_TX_WR(sn, txwr) { \ + WIZCHIP_WRITE(Sn_TX_WR(sn), (uint8_t)(txwr>>8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(Sn_TX_WR(sn),1), (uint8_t) txwr); \ + } + +/** + @ingroup Socket_register_access_function_W5100S + @brief Get @ref Sn_TX_WR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint16_t. Value of @ref Sn_TX_WR. + @sa setSn_TX_WR() +*/ +#define getSn_TX_WR(sn) \ + (((uint16_t)WIZCHIP_READ(Sn_TX_WR(sn)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_TX_WR(sn),1))) + +/** + @ingroup Socket_register_access_function_W5100S + @brief Get @ref Sn_RX_RSR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint16_t. Value of @ref Sn_RX_RSR. +*/ +uint16_t getSn_RX_RSR(uint8_t sn); + +/** + @ingroup Socket_register_access_function_W5100S + @brief Set @ref Sn_RX_RD register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param (uint16_t)rxrd Value to set @ref Sn_RX_RD + @sa getSn_RX_RD() +*/ +#define setSn_RX_RD(sn, rxrd) { \ + WIZCHIP_WRITE(Sn_RX_RD(sn), (uint8_t)(rxrd>>8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(Sn_RX_RD(sn),1), (uint8_t) rxrd); \ + } + +/** + @ingroup Socket_register_access_function_W5100S + @brief Get @ref Sn_RX_RD register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @regurn uint16_t. Value of @ref Sn_RX_RD. + @sa setSn_RX_RD() +*/ +#define getSn_RX_RD(sn) \ + (((uint16_t)WIZCHIP_READ(Sn_RX_RD(sn)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_RX_RD(sn),1))) + +/** + @ingroup Socket_register_access_function_W5100S + @brief Set @ref Sn_RX_WR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param (uint16_t)rxwr Value to set \ref Sn_RX_WR + @sa getSn_RX_WR() +*/ +#define setSn_RX_WR(sn, rxwr) { \ + WIZCHIP_WRITE(Sn_RX_WR(sn), (uint8_t)(rxwr>>8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(Sn_RX_WR(sn),1), (uint8_t) rxwr); \ + } + + +/** + @ingroup Socket_register_access_function_W5100S + @brief Get @ref Sn_RX_WR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint16_t. Value of @ref Sn_RX_WR. +*/ +#define getSn_RX_WR(sn) \ + (((uint16_t)WIZCHIP_READ(Sn_RX_WR(sn)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_RX_WR(sn),1))) + +/** + @ingroup Socket_register_access_function_W5100S + @brief Set @ref Sn_FRAGR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param (uint16_t)frag Value to set \ref Sn_FRAGR + @sa getSn_FRAG() +*/ +#define setSn_FRAGR(sn, fragr) { \ + WIZCHIP_WRITE(Sn_FRAGR(sn), (uint8_t)(fragr >>8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(Sn_FRAGR(sn),1), (uint8_t) fragr); \ + } + +/** + @ingroup Socket_register_access_function_W5100S + @brief Get @ref Sn_FRAGR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint16_t. Value of @ref Sn_FRAGR. + @sa setSn_FRAG() +*/ +#define getSn_FRAGR(sn) \ + (((uint16_t)WIZCHIP_READ(Sn_FRAGR(sn)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_FRAGR(sn),1))) + +/** + @ingroup Socket_register_access_function_W5100S + @brief Get the max RX buffer size of socket sn + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint16_t. Max buffer size +*/ +#define getSn_RxMAX(sn) \ + ((uint16_t)(0x0001 << getSn_RXMEM_SIZE(sn)) << 10) + + +/** + @ingroup Socket_register_access_function_W5100S + @brief Get the max TX buffer size of socket sn + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint16_t. Max buffer size +*/ +#define getSn_TxMAX(sn) \ + ((uint16_t)(0x0001 << getSn_TXMEM_SIZE(sn)) << 10) + +/** + @ingroup Socket_register_access_function_W5100S + @brief Get the mask of socket sn RX buffer. + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint16_t. Mask value +*/ +#define getSn_RxMASK(sn) \ + (getSn_RxMAX(sn) - 1) + +/** + @ingroup Socket_register_access_function_W5100S + @brief Get the mask of socket sn TX buffer + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint16_t. Mask value +*/ +#define getSn_TxMASK(sn) \ + (getSn_TxMAX(sn) - 1) + + +/** + @ingroup Socket_register_access_function_W5100S + @brief Get the base address of socket sn RX buffer. + @param sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint16_t. Value of Socket n RX buffer base address. +*/ +uint32_t getSn_RxBASE(uint8_t sn); + +/** + @ingroup Socket_register_access_function_W5100S + @brief Get the base address of socket sn TX buffer. + @param sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint16_t. Value of Socket n TX buffer base address. +*/ +uint32_t getSn_TxBASE(uint8_t sn); + + +/*socket register W5100S only*/ + +/** + @ingroup Socket_register_access_function_W5100S + @brief Set the interrupt mask register of socket sn. + @param sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param (uint16_t)imr Value to set \ref Sn_IMR + @sa getSn_IMR(sn) +*/ +#define setSn_IMR(sn,imr) \ + WIZCHIP_WRITE(Sn_IMR(sn),imr) + +/** + @ingroup Socket_register_access_function_W5100S + @brief Get the interrupt mask register of socket sn. + @param sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint16_t. Value of Socket n interrupt mask register. +*/ +#define getSn_IMR(sn) \ + WIZCHIP_READ(Sn_IMR(sn)) + +/** + @ingroup Socket_register_access_function_W5100S + @brief Set the Sn_MR2 value of socket sn. + @param sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param mr2 Value of Sn_MR2 register to set. +*/ +#define setSn_MR2(sn,mr2) \ + WIZCHIP_WRITE(Sn_MR2(sn), mr2) + +/** + @ingroup Socket_register_access_function_W5100S + @brief Get the Sn_MR2 value of socket sn. + @param sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint16_t. Value of Socket n Sn_MR2 register. +*/ +#define getSn_MR2(sn) \ + WIZCHIP_READ(Sn_MR2(sn)) + +/** + @ingroup Socket_register_access_function_W5100S + @brief Set the Sn_KPALVTR value of socket sn. + @param sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param kpalvtr Value of the Sn_KPALVTR register to set. +*/ +#define setSn_KPALVTR(sn,kpalvtr) \ + WIZCHIP_WRITE(Sn_KPALVTR(sn), kpalvtr) + +/** + @ingroup Socket_register_access_function_W5100S + @brief Get the Sn_KPALVTR value of socket sn + @param sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint8_t. Value of the Sn_KPALVTR register. +*/ +#define getSn_KPALVTR(sn) \ + WIZCHIP_READ(Sn_KPALVTR(sn)) + +/** + @ingroup Socket_register_access_function_W5100S + @brief Get the Sn_TSR register of socket sn. + @param sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint8_t. Value of the Socket n Sn_TSR register. +*/ +#define getSn_TSR(sn) \ + WIZCHIP_READ(Sn_TSR(sn)) + +/** + @ingroup Socket_register_access_function_W5100S + @brief Set the Sn_RTR register of socket sn. + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param (uint16_t)rtr Value of the Socket n Sn_RTR register to set. +*/ +#define setSn_RTR(sn,rtr) { \ + WIZCHIP_WRITE(Sn_RTR(sn), (uint8_t)(rtr >> 8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(Sn_RTR(sn),1), (uint8_t) rtr); \ + } + +/** + @ingroup Socket_register_access_function_W5100S + @brief Get the Sn_RTR register of socket sn. + @param sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint16_t. Value of the Socket n Sn_RTR register. +*/ +#define getSn_RTR(sn) \ + (((uint16_t)WIZCHIP_READ(Sn_RTR(sn)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_RTR(sn),1))) + +/** + @ingroup Socket_register_access_function_W5100S + @brief Set the Sn_RCR register of socket sn. + @param sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint8_t. Value of the Socket n Sn_RCR register to set. +*/ +#define setSn_RCR(sn,rcr) \ + WIZCHIP_WRITE(Sn_RCR(sn),rcr) + +/** + @ingroup Socket_register_access_function_W5100S + @brief Get the Sn_RCR of socket sn. + @param sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint8_t. Value of the Socket n Sn_RCR. +*/ +#define getSn_RCR(sn) \ + WIZCHIP_READ(Sn_RCR(sn)) + +///////////////////////////////////// +// Sn_TXBUF & Sn_RXBUF IO function // +///////////////////////////////////// +/** + @ingroup Basic_IO_function_W5100S + @brief It copies data to internal TX memory + + @details This function reads the Tx write pointer register and after that, + it copies the wizdata(pointer buffer) of the length of len(variable) bytes to internal TX memory + and updates the Tx write pointer register. + This function is being called by send() and sendto() function also. + + @param sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param wizdata Pointer buffer to write data + @param len Data length + @sa wiz_recv_data() +*/ +void wiz_send_data(uint8_t sn, uint8_t *wizdata, uint16_t len); + +/** + @ingroup Basic_IO_function_W5100S + @brief It copies data to your buffer from internal RX memory + + @details This function read the Rx read pointer register and after that, + it copies the received data from internal RX memory + to wizdata(pointer variable) of the length of len(variable) bytes. + This function is being called by recv() also. + + @param sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param wizdata Pointer buffer to read data + @param len Data length + @sa wiz_send_data() +*/ +void wiz_recv_data(uint8_t sn, uint8_t *wizdata, uint16_t len); + +/** + @ingroup Basic_IO_function_W5100S + @brief It discard the received data in RX memory. + @details It discards the data of the length of len(variable) bytes in internal RX memory. + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param len Data length +*/ +void wiz_recv_ignore(uint8_t sn, uint16_t len); + +/** + @ingroup Special_function_W5100S + @brief Write data to the PHY via MDC/MDIO interface. + @details Write command data to the PHY via MDC/MDIO interface. + @param (uint8_t)PHYMDIO_regadr Address of the PHY register. It should be PHYMDIO_BMCR or PHYMDIO_BMSR. + @param (uint16_t)var Data to write to the PHY register. Please refer to the bit definitions of the BMCR and BMSR register. +*/ +void wiz_mdio_write(uint8_t PHYMDIO_regadr, uint16_t var); + +/** + @ingroup Special_function_W5100S + @brief Read data from the PHY via MDC/MDIO interface. + @details Read command or status data from the PHY via MDC/MDIO interface. + @param (uint8_t)PHYMDIO_regadr Address of the PHY register. It should be PHYMDIO_BMCR or PHYMDIO_BMSR. + @return The value of the PHY register +*/ +uint16_t wiz_mdio_read(uint8_t PHYMDIO_regadr); + +/** + @ingroup Special_function_W5100S + @brief Delay function + @details Delay function using internal 100us timer of the W5100S + @param (uint32_t)ms Time to delay in milliseconds. +*/ +void wiz_delay_ms(uint32_t ms); + +/// @cond DOXY_APPLY_CODE +#endif +/// @endcond + +#ifdef __cplusplus +} +#endif + +#endif //_W5100S_H_ + + + diff --git a/Ethernet/W5200/w5200.c b/Ethernet/W5200/w5200.c new file mode 100644 index 0000000..c487a1e --- /dev/null +++ b/Ethernet/W5200/w5200.c @@ -0,0 +1,338 @@ +//***************************************************************************** +// +//! \file w5200.c +//! \brief W5200 HAL Interface. +//! \version 1.0.0 +//! \date 2013/10/21 +//! \par Revision history +//! <2013/10/21> 1st Release +//! \author MidnightCow +//! +//! Copyright (c) 2013, WIZnet Co., 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: +//! +//! * 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 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 "w5200.h" + +#if (_WIZCHIP_ == 5200) +/** + @brief This function writes the data into W5200 registers. +*/ +void WIZCHIP_WRITE(uint32_t AddrSel, uint8_t wb) { + WIZCHIP_CRITICAL_ENTER(); + WIZCHIP.CS._select(); + +#if( (_WIZCHIP_IO_MODE_ & _WIZCHIP_IO_MODE_SPI_)) + WIZCHIP.IF.SPI._write_byte((AddrSel & 0x0000FF00) >> 8); + WIZCHIP.IF.SPI._write_byte((AddrSel & 0x000000FF) >> 0); + WIZCHIP.IF.SPI._write_byte(_W5200_SPI_WRITE_); // Data write command and Write data length upper + WIZCHIP.IF.SPI._write_byte(0x01); // Write data length lower + WIZCHIP.IF.SPI._write_byte(wb); // Data write (write 1byte data) + +#elif ( (_WIZCHIP_IO_MODE_ & _WIZCHIP_IO_MODE_BUS_) ) + + //add indirect bus + //M20150601 : Rename the function for integrating with W5300 + //WIZCHIP.IF.BUS._write_byte(IDM_AR0,(AddrSel & 0x0000FF00) >> 8); + //WIZCHIP.IF.BUS._write_byte(IDM_AR1,(AddrSel & 0x000000FF)); + //WIZCHIP.IF.BUS._write_byte(IDM_DR,wb); + WIZCHIP.IF.BUS._write_data(IDM_AR0, (AddrSel & 0x0000FF00) >> 8); + WIZCHIP.IF.BUS._write_data(IDM_AR1, (AddrSel & 0x000000FF)); + WIZCHIP.IF.BUS._write_data(IDM_DR, wb); + +#else +#error "Unknown _WIZCHIP_IO_MODE_ in W5200. !!!" +#endif + + WIZCHIP.CS._deselect(); + WIZCHIP_CRITICAL_EXIT(); +} +/** + @brief This function reads the value from W5200 registers. +*/ +uint8_t WIZCHIP_READ(uint32_t AddrSel) { + uint8_t ret; + + WIZCHIP_CRITICAL_ENTER(); + WIZCHIP.CS._select(); + +#if( (_WIZCHIP_IO_MODE_ & _WIZCHIP_IO_MODE_SPI_)) + WIZCHIP.IF.SPI._write_byte((AddrSel & 0x0000FF00) >> 8); + WIZCHIP.IF.SPI._write_byte((AddrSel & 0x000000FF) >> 0); + WIZCHIP.IF.SPI._write_byte(_W5200_SPI_READ_); // Read data length upper + WIZCHIP.IF.SPI._write_byte(0x01); // Data length lower + ret = WIZCHIP.IF.SPI._read_byte(); + +#elif ( (_WIZCHIP_IO_MODE_ & _WIZCHIP_IO_MODE_BUS_) ) + + //add indirect bus + //M20150601 : Rename the function for integrating with W5300 + //WIZCHIP.IF.BUS._write_byte(IDM_AR0,(AddrSel & 0x0000FF00) >> 8); + //WIZCHIP.IF.BUS._write_byte(IDM_AR1,(AddrSel & 0x000000FF)); + //ret = WIZCHIP.IF.BUS._read_byte(IDM_DR); + WIZCHIP.IF.BUS._write_data(IDM_AR0, (AddrSel & 0x0000FF00) >> 8); + WIZCHIP.IF.BUS._write_data(IDM_AR1, (AddrSel & 0x000000FF)); + ret = WIZCHIP.IF.BUS._read_data(IDM_DR); + +#else +#error "Unknown _WIZCHIP_IO_MODE_ in W5200. !!!" +#endif + + WIZCHIP.CS._deselect(); + WIZCHIP_CRITICAL_EXIT(); + return ret; +} + + +/** + @brief This function writes into W5200 memory(Buffer) +*/ +void WIZCHIP_WRITE_BUF(uint32_t AddrSel, uint8_t* pBuf, uint16_t len) { + uint16_t i = 0; + WIZCHIP_CRITICAL_ENTER(); + WIZCHIP.CS._select(); + +#if( (_WIZCHIP_IO_MODE_ & _WIZCHIP_IO_MODE_SPI_)) + WIZCHIP.IF.SPI._write_byte((AddrSel & 0x0000FF00) >> 8); + WIZCHIP.IF.SPI._write_byte((AddrSel & 0x000000FF) >> 0); + WIZCHIP.IF.SPI._write_byte(_W5200_SPI_WRITE_ | ((len & 0x7F00) >> 8)); // Write data op code and length upper + WIZCHIP.IF.SPI._write_byte((len & 0x00FF) >> 0); // length lower + for (i = 0; i < len; i++) { + WIZCHIP.IF.SPI._write_byte(pBuf[i]); + } + +#elif ( (_WIZCHIP_IO_MODE_ & _WIZCHIP_IO_MODE_BUS_) ) + //M20150601 : Rename the function for integrating with W5300 + /* + WIZCHIP_WRITE(MR,WIZCHIP_READ(MR) | MR_AI); + WIZCHIP.IF.BUS._write_byte(IDM_AR0,(AddrSel & 0x0000FF00) >> 8); + WIZCHIP.IF.BUS._write_byte(IDM_AR1,(AddrSel & 0x000000FF)); + for(i = 0 ; i < len; i++) + WIZCHIP.IF.BUS._write_byte(IDM_DR,pBuf[i]); + WIZCHIP_WRITE(MR, WIZCHIP_READ(MR) & ~MR_AI); + */ + setMR(getMR() | MR_AI); + WIZCHIP.IF.BUS._write_data(IDM_AR0, (AddrSel & 0x0000FF00) >> 8); + WIZCHIP.IF.BUS._write_data(IDM_AR1, (AddrSel & 0x000000FF)); + for (i = 0 ; i < len; i++) { + WIZCHIP.IF.BUS._write_data(IDM_DR, pBuf[i]); + } + WIZCHIP_WRITE(MR, WIZCHIP_READ(MR) & ~MR_AI); +#else +#error "Unknown _WIZCHIP_IO_MODE_ in W5200. !!!!" +#endif + + WIZCHIP.CS._deselect(); + WIZCHIP_CRITICAL_EXIT(); +} + +/** + @brief This function reads into W5200 memory(Buffer) +*/ +void WIZCHIP_READ_BUF(uint32_t AddrSel, uint8_t* pBuf, uint16_t len) { + uint16_t i = 0; + WIZCHIP_CRITICAL_ENTER(); + WIZCHIP.CS._select(); + +#if( (_WIZCHIP_IO_MODE_ & _WIZCHIP_IO_MODE_SPI_)) + WIZCHIP.IF.SPI._write_byte((AddrSel & 0x0000FF00) >> 8); + WIZCHIP.IF.SPI._write_byte((AddrSel & 0x000000FF) >> 0); + WIZCHIP.IF.SPI._write_byte(_W5200_SPI_READ_ | ((len & 0x7F00) >> 8)); // Write data op code and length upper + WIZCHIP.IF.SPI._write_byte((len & 0x00FF) >> 0); // length lower + for (i = 0; i < len; i++) { + pBuf[i] = WIZCHIP.IF.SPI._read_byte(); + } + +#elif ( (_WIZCHIP_IO_MODE_ & _WIZCHIP_IO_MODE_BUS_) ) + //M20150601 : Rename the function for integrating with W5300 + /* + WIZCHIP_WRITE(MR, WIZCHIP_READ(MR) | MR_AI); + WIZCHIP.IF.BUS._write_byte(IDM_AR0,(AddrSel & 0x0000FF00) >> 8); + WIZCHIP.IF.BUS._write_byte(IDM_AR1,(AddrSel & 0x000000FF)); + for(i = 0 ; i < len; i++) + pBuf[i] = WIZCHIP.IF.BUS._read_byte(IDM_DR); + WIZCHIP_WRITE(MR, WIZCHIP_READ(MR) & ~MR_AI); + */ + setMR(getMR() | MR_AI); + WIZCHIP.IF.BUS._write_data(IDM_AR0, (AddrSel & 0x0000FF00) >> 8); + WIZCHIP.IF.BUS._write_data(IDM_AR1, (AddrSel & 0x000000FF)); + for (i = 0 ; i < len; i++) { + pBuf[i] = WIZCHIP.IF.BUS._read_data(IDM_DR); + } + setMR(getMR() & ~MR_AI); +#else +#error "Unknown _WIZCHIP_IO_MODE_ in W5200. !!!!" +#endif + + WIZCHIP.CS._deselect(); + WIZCHIP_CRITICAL_EXIT(); +} + +/////////////////////////////////// +// Socket N regsiter IO function // +/////////////////////////////////// + +uint16_t getSn_TX_FSR(uint8_t sn) { + uint16_t val = 0, val1 = 0; + do { + val1 = WIZCHIP_READ(Sn_TX_FSR(sn)); + val1 = (val1 << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_TX_FSR(sn), 1)); + if (val1 != 0) { + val = WIZCHIP_READ(Sn_TX_FSR(sn)); + val = (val << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_TX_FSR(sn), 1)); + } + } while (val != val1); + return val; +} + + +uint16_t getSn_RX_RSR(uint8_t sn) { + uint16_t val = 0, val1 = 0; + do { + val1 = WIZCHIP_READ(Sn_RX_RSR(sn)); + val1 = (val1 << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_RX_RSR(sn), 1)); + if (val1 != 0) { + val = WIZCHIP_READ(Sn_RX_RSR(sn)); + val = (val << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_RX_RSR(sn), 1)); + } + } while (val != val1); + return val; +} + +///////////////////////////////////// +// Sn_TXBUF & Sn_RXBUF IO function // +///////////////////////////////////// + +uint16_t getSn_RxBASE(uint8_t sn) { + int8_t i; + uint16_t rxbase = _WIZCHIP_IO_RXBUF_; + for (i = 0; i < sn; i++) { + rxbase += getSn_RxMAX(i); + } + return rxbase; +} + +uint16_t getSn_TxBASE(uint8_t sn) { + int8_t i; + uint16_t txbase = _WIZCHIP_IO_TXBUF_; + for (i = 0; i < sn; i++) { + txbase += getSn_TxMAX(i); + } + return txbase; +} + +/** + @brief This function is being called by send() and sendto() function also. for copy the data form application buffer to Transmite buffer of the chip. + + This function read the Tx write pointer register and after copy the data in buffer update the Tx write pointer + register. User should read upper byte first and lower byte later to get proper value. + And this function is being used for copy the data form application buffer to Transmite + buffer of the chip. It calculate the actual physical address where one has to write + the data in transmite buffer. Here also take care of the condition while it exceed + the Tx memory uper-bound of socket. + +*/ + +void wiz_send_data(uint8_t sn, uint8_t *wizdata, uint16_t len) { + + uint16_t ptr; + uint16_t size; + uint16_t dst_mask; + uint8_t * dst_ptr; + + ptr = getSn_TX_WR(sn); + + + dst_mask = (uint32_t)ptr & getSn_TxMASK(sn); + dst_ptr = (uint8_t*)((uint32_t)getSn_TxBASE(sn) + dst_mask); + + if (dst_mask + len > getSn_TxMAX(sn)) { + size = getSn_TxMAX(sn) - dst_mask; + WIZCHIP_WRITE_BUF((uint32_t)dst_ptr, wizdata, size); + wizdata += size; + size = len - size; + dst_ptr = (uint8_t*)((uint32_t)getSn_TxBASE(sn)); + WIZCHIP_WRITE_BUF((uint32_t)dst_ptr, wizdata, size); + } else { + WIZCHIP_WRITE_BUF((uint32_t)dst_ptr, wizdata, len); + } + + ptr += len; + + setSn_TX_WR(sn, ptr); +} + + +/** + @brief This function is being called by recv() also. This function is being used for copy the data form Receive buffer of the chip to application buffer. + + This function read the Rx read pointer register + and after copy the data from receive buffer update the Rx write pointer register. + User should read upper byte first and lower byte later to get proper value. + It calculate the actual physical address where one has to read + the data from Receive buffer. Here also take care of the condition while it exceed + the Rx memory uper-bound of socket. +*/ +void wiz_recv_data(uint8_t sn, uint8_t *wizdata, uint16_t len) { + uint16_t ptr; + uint16_t size; + uint16_t src_mask; + uint8_t * src_ptr; + + ptr = getSn_RX_RD(sn); + + src_mask = (uint32_t)ptr & getSn_RxMASK(sn); + src_ptr = (uint8_t *)((uint32_t)getSn_RxBASE(sn) + src_mask); + + if ((src_mask + len) > getSn_RxMAX(sn)) { + size = getSn_RxMAX(sn) - src_mask; + WIZCHIP_READ_BUF((uint32_t)src_ptr, (uint8_t*)wizdata, size); + wizdata += size; + size = len - size; + src_ptr = (uint8_t*)((uint32_t)getSn_RxBASE(sn)); + WIZCHIP_READ_BUF((uint32_t)src_ptr, (uint8_t*)wizdata, size); + } else { + WIZCHIP_READ_BUF((uint32_t)src_ptr, (uint8_t*)wizdata, len); + } + + ptr += len; + + setSn_RX_RD(sn, ptr); +} + +void wiz_recv_ignore(uint8_t sn, uint16_t len) { + uint16_t ptr; + + ptr = getSn_RX_RD(sn); + + ptr += len; + setSn_RX_RD(sn, ptr); +} + +#endif diff --git a/Ethernet/W5200/w5200.h b/Ethernet/W5200/w5200.h new file mode 100644 index 0000000..eedf1c9 --- /dev/null +++ b/Ethernet/W5200/w5200.h @@ -0,0 +1,2118 @@ +//* **************************************************************************** +//! \file w5200.h +//! \brief W5200 HAL Header File. +//! \version 1.0.0 +//! \date 2015/03/23 +//! \par Revision history +//! <2013/10/21> 1st Release +//! \author MidnightCow +//! \copyright +//! +//! Copyright (c) 2013, WIZnet Co., 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: +//! +//! * 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 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 _W5200_H +#define _W5200_H + +#ifdef __cplusplus +extern "C" { +#endif + +#include +#include "wizchip_conf.h" + +/// \cond DOXY_APPLY_CODE +#if (_WIZCHIP_ == 5200) +/// \endcond + +#define _WIZCHIP_SN_BASE_ (0x4000) +#define _WIZCHIP_SN_SIZE_ (0x0100) +#define _WIZCHIP_IO_TXBUF_ (0x8000) /* Internal Tx buffer address of the iinchip */ +#define _WIZCHIP_IO_RXBUF_ (0xC000) /* Internal Rx buffer address of the iinchip */ + +#define _W5200_SPI_READ_ (0x00 << 7) ///< SPI interface Read operation in Control Phase +#define _W5200_SPI_WRITE_ (0x01 << 7) ///< SPI interface Write operation in Control Phase + +#define WIZCHIP_CREG_BLOCK 0x00 ///< Common register block +#define WIZCHIP_SREG_BLOCK(N) (_WIZCHIP_SN_BASE_+ _WIZCHIP_SN_SIZE_*N) ///< Socket N register block + +#define WIZCHIP_OFFSET_INC(ADDR, N) (ADDR + N) ///< Increase offset address + +#if (_WIZCHIP_IO_MODE_ & _WIZCHIP_IO_MODE_BUS_) +#define IDM_AR0 ((_WIZCHIP_IO_BASE_ + 0x0001)) +#define IDM_AR1 ((_WIZCHIP_IO_BASE_ + 0x0002)) +#define IDM_DR ((_WIZCHIP_IO_BASE_ + 0x0003)) +#define _W5200_IO_BASE_ 0x0000 +#elif (_WIZCHIP_IO_MODE_ & _WIZCHIP_IO_MODE_SPI_) +#define _W5200_IO_BASE_ 0x0000 +#endif + +/////////////////////////////////////// +// Definition For Legacy Chip Driver // +/////////////////////////////////////// +#define IINCHIP_READ(ADDR) WIZCHIP_READ(ADDR) ///< The defined for legacy chip driver +#define IINCHIP_WRITE(ADDR,VAL) WIZCHIP_WRITE(ADDR,VAL) ///< The defined for legacy chip driver +#define IINCHIP_READ_BUF(ADDR,BUF,LEN) WIZCHIP_READ_BUF(ADDR,BUF,LEN) ///< The defined for legacy chip driver +#define IINCHIP_WRITE_BUF(ADDR,BUF,LEN) WIZCHIP_WRITE(ADDR,BUF,LEN) ///< The defined for legacy chip driver + + +//----------- defgroup -------------------------------- + +/** + @defgroup W5200 W5200 + @brief WHIZCHIP register defines and I/O functions of @b W5200. + + - @ref WIZCHIP_register_W5200 : @ref Common_register_group_W5200 and @ref Socket_register_group_W5200 + - @ref WIZCHIP_IO_Functions_W5200 : @ref Basic_IO_function_W5200, @ref Common_register_access_function_W5200 and @ref Socket_register_group_W5200 +*/ + +/** + @defgroup WIZCHIP_register_W5200 WIZCHIP register + @ingroup W5200 + @brief WIZCHIP register defines register group of W5200 . + + - \ref Common_register_group_W5200 : Common register group w5200 + - \ref Socket_register_group_W5200 : \c SOCKET n register group w5200 +*/ + + +/** + @defgroup WIZCHIP_IO_Functions_W5200 WIZCHIP I/O functions + @ingroup W5200 + @brief This supports the basic I/O functions for \ref WIZCHIP_register_W5200. + + - Basic I/O function \n + WIZCHIP_READ(), WIZCHIP_WRITE(), WIZCHIP_READ_BUF(), WIZCHIP_WRITE_BUF() \n\n + + - \ref Common_register_group_W5200 access functions \n + -# @b Mode \n + getMR(), setMR() + -# @b Interrupt \n + getIR(), setIR(), getIMR(), setIMR(), getIR2(), setIR2(), getIMR2(), setIMR2(), getINTLEVEL(), setINTLEVEL() + -# Network Information \n + getSHAR(), setSHAR(), getGAR(), setGAR(), getSUBR(), setSUBR(), getSIPR(), setSIPR() + -# @b Retransmission \n + getRCR(), setRCR(), getRTR(), setRTR() + -# @b PPPoE \n + getPTIMER(), setPTIMER(), getPMAGIC(), getPMAGIC() + -# @b etc. \n + getPHYSTATUS(), getVERSIONR() \n\n + + - \ref Socket_register_group_W5200 access functions \n + -# SOCKET control \n + getSn_MR(), setSn_MR(), getSn_CR(), setSn_CR(), getSn_IMR(), setSn_IMR(), getSn_IR(), setSn_IR() + -# SOCKET information \n + getSn_SR(), getSn_DHAR(), setSn_DHAR(), getSn_PORT(), setSn_PORT(), getSn_DIPR(), setSn_DIPR(), getSn_DPORT(), setSn_DPORT() + getSn_MSSR(), setSn_MSSR() + -# SOCKET communication \n + getSn_RXMEM_SIZE(), setSn_RXMEM_SIZE(), getSn_TXMEM_SIZE(), setSn_TXMEM_SIZE() \n + getSn_TX_RD(), getSn_TX_WR(), setSn_TX_WR() \n + getSn_RX_RD(), setSn_RX_RD(), getSn_RX_WR() \n + getSn_TX_FSR(), getSn_RX_RSR() + -# IP header field \n + getSn_FRAG(), setSn_FRAG(), getSn_TOS(), setSn_TOS() \n + getSn_TTL(), setSn_TTL() +*/ + +/** + @defgroup Common_register_group_W5200 Common register + @ingroup WIZCHIP_register_W5200 + @brief Common register group\n + It set the basic for the networking\n + It set the configuration such as interrupt, network information, ICMP, etc. + @details + @sa MR : Mode register. + @sa GAR, SUBR, SHAR, SIPR + @sa INTLEVEL, IR, _IMR_, IR2, IMR2 : Interrupt. + @sa _RTR_, _RCR_ : Data retransmission. + @sa PTIMER, PMAGIC : PPPoE. + @sa PHYSTATUS, VERSIONR : etc. +*/ + + +/** + @defgroup Socket_register_group_W5200 Socket register + @ingroup WIZCHIP_register_W5200 + @brief Socket register group\n + Socket register configures and control SOCKETn which is necessary to data communication. + @details + @sa Sn_MR, Sn_CR, Sn_IR, Sn_IMR : SOCKETn Control + @sa Sn_SR, Sn_PORT, Sn_DHAR, Sn_DIPR, Sn_DPORT : SOCKETn Information + @sa Sn_MSSR, Sn_TOS, Sn_TTL, Sn_FRAG : Internet protocol. + @sa Sn_RXMEM_SIZE, Sn_TXMEM_SIZE, Sn_TX_FSR, Sn_TX_RD, Sn_TX_WR, Sn_RX_RSR, Sn_RX_RD, Sn_RX_WR : Data communication +*/ + +/** + @defgroup Basic_IO_function_W5200 Basic I/O function + @ingroup WIZCHIP_IO_Functions_W5200 + @brief These are basic input/output functions to read values from register or write values to register. +*/ + +/** + @defgroup Common_register_access_function_W5200 Common register access functions + @ingroup WIZCHIP_IO_Functions_W5200 + @brief These are functions to access common registers. +*/ + +/** + @defgroup Socket_register_access_function_W5200 Socket register access functions + @ingroup WIZCHIP_IO_Functions_W5200 + @brief These are functions to access socket registers. +*/ + +//----------------------------------------------------------------------------------- + +//----------------------------- W5200 Common Registers IOMAP ----------------------------- +/** + @ingroup Common_register_group_W5200 + @brief Mode Register address(R/W)\n + \ref MR is used for S/W reset, ping block mode, PPPoE mode and etc. + @details Each bit of \ref MR defined as follows. + + + +
    7 6 5 4 3 2 1 0
    RST Reserved WOL PB PPPoE Reserved AI IND
    + - \ref MR_RST : Reset + - \ref MR_WOL : Wake on LAN + - \ref MR_PB : Ping block + - \ref MR_PPPOE : PPPoE mode + - \ref MR_AI : Address Auto-Increment in Indirect Bus Interface + - \ref MR_IND : Indirect Bus Interface mode +*/ +#if (_WIZCHIP_IO_MODE_ & _WIZCHIP_IO_MODE_BUS_) +#define MR (_WIZCHIP_IO_BASE_ + (0x0000)) // Mode +#else +#define MR (_W5200_IO_BASE_ + (0x0000)) // Mode +#endif + +/** + @ingroup Common_register_group_W5200 + @brief Gateway IP Register address(R/W) + @details \ref GAR configures the default gateway address. +*/ +#define GAR (_W5200_IO_BASE_ + (0x0001)) // GW Address + +/** + @ingroup Common_register_group_W5200 + @brief Subnet mask Register address(R/W) + @details \ref SUBR configures the subnet mask address. +*/ +#define SUBR (_W5200_IO_BASE_ + (0x0005)) // SN Mask Address + +/** + @ingroup Common_register_group_W5200 + @brief Source MAC Register address(R/W) + @details \ref SHAR configures the source hardware address. +*/ +#define SHAR (_W5200_IO_BASE_ + (0x0009)) // Source Hardware Address + +/** + @ingroup Common_register_group_W5200 + @brief Source IP Register address(R/W) + @details \ref SIPR configures the source IP address. +*/ +#define SIPR (_W5200_IO_BASE_ + (0x000F)) // Source IP Address + +// Reserved (_W5200_IO_BASE_ + (0x0013)) +// Reserved (_W5200_IO_BASE_ + (0x0014)) + +/** + @ingroup Common_register_group_W5200 + @brief Interrupt Register(R/W) + @details \ref IR indicates the interrupt status. Each bit of \ref IR will be still until the bit will be written to by the host. + If \ref IR is not equal to x00 INTn PIN is asserted to low until it is x00\n\n + Each bit of \ref IR defined as follows. + + + +
    7 6 5 4 3 2 1 0
    CONFLICT Reserved PPPoE Reserved Reserved Reserved Reserved Reserved
    + - \ref IR_CONFLICT : IP conflict + - \ref IR_PPPoE : PPPoE connection close +*/ +#define IR (_W5200_IO_BASE_ + (0x0015)) // Interrupt + +/** + @ingroup Common_register_group_W5200 + @brief Socket Interrupt Mask Register(R/W) + @details Each bit of \ref _IMR_ corresponds to each bit of \ref IR2. + When a bit of \ref _IMR_ is and the corresponding bit of \ref IR2 is Interrupt will be issued. + In other words, if a bit of \ref _IMR_, an interrupt will be not issued even if the corresponding bit of \ref IR2 is set + @note This Register is same operated as SMIR of W5100, W5300 and W5550.\n + So, \ref setSIMR() set a value to _IMR_ for integrating with ioLibrary +*/ +#define _IMR_ (_W5200_IO_BASE_ + (0x0016)) // Socket Interrupt Mask + +/** + @ingroup Common_register_group_W5200 + @brief Timeout register address( 1 is 100us )(R/W) + @details \ref _RTR_ configures the retransmission timeout period. The unit of timeout period is 100us and the default of \ref _RTR_ is x07D0. + And so the default timeout period is 200ms(100us X 2000). During the time configured by \ref _RTR_, W5200 waits for the peer response + to the packet that is transmitted by \ref Sn_CR (CONNECT, DISCON, CLOSE, SEND, SEND_MAC, SEND_KEEP command). + If the peer does not respond within the \ref _RTR_ time, W5200 retransmits the packet or issues timeout. +*/ +#define _RTR_ (_W5200_IO_BASE_ + (0x0017)) // Retry Time + +/** + @ingroup Common_register_group_W5200 + @brief Retry count register(R/W) + @details \ref _RCR_ configures the number of time of retransmission. + When retransmission occurs as many as ref _RCR_+1 Timeout interrupt is issued (\ref Sn_IR_TIMEOUT = '1'). +*/ +#define _RCR_ (_W5200_IO_BASE_ + (0x0019)) // Retry Count + +// Reserved (_W5200_IO_BASE_ + (0x001A)) +// Reserved (_W5200_IO_BASE_ + (0x001B)) + +/** + @ingroup Common_register_group_W5200 + @brief PPP LCP Request Timer register in PPPoE mode(R) + @details \ref PATR notifies authentication method that has been agreed at the connection with + PPPoE Server. W5200 supports two types of Authentication method - PAP and CHAP. +*/ +#define PATR (_W5200_IO_BASE_ + (0x001C)) + +/** + @ingroup Common_register_group_W5200 + @brief PPP LCP Request Timer register in PPPoE mode(R) + @details \ref PPPALGO notifies authentication algorithm in PPPoE mode. For detailed information, + please refer to PPPoE application note. +*/ +#define PPPALGO (_W5200_IO_BASE_ + (0x001E)) // Authentication Algorithm in PPPoE + +/** + @ingroup Common_register_group_W5200 + @brief chip version register address(R) + @details \ref VERSIONR always indicates the W5200 version as @b 0x03. +*/ +#define VERSIONR (_W5200_IO_BASE_ + (0x001F)) // Chip version + +// Reserved (_W5200_IO_BASE_ + (0x0020)) +// Reserved (_W5200_IO_BASE_ + (0x0021)) +// Reserved (_W5200_IO_BASE_ + (0x0022)) +// Reserved (_W5200_IO_BASE_ + (0x0023)) +// Reserved (_W5200_IO_BASE_ + (0x0024)) +// Reserved (_W5200_IO_BASE_ + (0x0025)) +// Reserved (_W5200_IO_BASE_ + (0x0026)) +// Reserved (_W5200_IO_BASE_ + (0x0027)) + +/** + @ingroup Common_register_group_W5200 + @brief PPP LCP Request Timer register in PPPoE mode(R) + @details \ref PTIMER configures the time for sending LCP echo request. The unit of time is 25ms. +*/ +#define PTIMER (_W5200_IO_BASE_ + (0x0028)) // PPP LCP RequestTimer + +/** + @ingroup Common_register_group_W5200 + @brief PPP LCP Magic number register in PPPoE mode(R) + @details \ref PMAGIC configures the 4bytes magic number to be used in LCP negotiation. +*/ +#define PMAGIC (_W5200_IO_BASE_ + (0x0029)) // PPP LCP Magic number + +// Reserved (_W5200_IO_BASE_ + (0x002A)) +// Reserved (_W5200_IO_BASE_ + (0x002B)) +// Reserved (_W5200_IO_BASE_ + (0x002C)) +// Reserved (_W5200_IO_BASE_ + (0x002D)) +// Reserved (_W5200_IO_BASE_ + (0x002E)) +// Reserved (_W5200_IO_BASE_ + (0x002F)) + +/** + @ingroup Common_register_group_W5200 + @brief Set Interrupt low level timer register address(R/W) + @details \ref INTLEVEL configures the Interrupt Assert Time. +*/ +#define INTLEVEL (_W5200_IO_BASE_ + (0x0030)) // Interrupt Low Level Timer + +// Reserved (_W5200_IO_BASE_ + (0x0032)) +// Reserved (_W5200_IO_BASE_ + (0x0033)) + +/** + @ingroup Common_register_group_W5200 + @brief Socket Interrupt Register(R/W) + @details \ref IR2 indicates the interrupt status of Socket.\n + Each bit of \ref IR2 be still until \ref Sn_IR is cleared by the host.\n + If \ref Sn_IR is not equal to x00 the n-th bit of \ref IR2 is and INTn PIN is asserted until \ref IR2 is x00 */ +#define IR2 (_W5200_IO_BASE_ + (0x0034)) // Socket Interrupt + +/** + @ingroup Common_register_group_W5200 + @brief PHYSTATUS(R/W) + @details \ref PHYSTATUS is the Register to indicate W5200 status of PHY. + + + +
    7 6 5 4 3 2 1 0
    Reserved Reserved LINK POWERSAVE POWERDOWN Reserved Reserved Reserved
    + - \ref PHYSTATUS_LINK : Link Status Register[Read Only] + - \ref PHYSTATUS_POWERSAVE : Power save mode of PHY[R/W] + - \ref PHYSTATUS_POWERDOWN : Power down mode of PHY[R/W] +*/ +#define PHYSTATUS (_W5200_IO_BASE_ + (0x0035)) // PHY Status + +/** + @ingroup Common_register_group_W5200 + @brief Interrupt mask register(R/W) + @details \ref IMR2 is used to mask interrupts. Each bit of \ref _IMR_ corresponds to each bit of \ref IR. + When a bit of \ref IMR2 is and the corresponding bit of \ref IR is an interrupt will be issued. In other words, + if a bit of \ref IMR2 is an interrupt will not be issued even if the corresponding bit of \ref IR is \n\n + Each bit of \ref IMR2 defined as the following. + + + +
    7 6 5 4 3 2 1 0
    IM_IR7 Reserved IM_IR5 Reserved Reserved Reserved Reserved Reserved
    + - \ref IM_IR7 : IP Conflict Interrupt Mask + - \ref IM_IR5 : PPPoE Close Interrupt Mask + @note This Register is same operated as _IMR_ of W5100, W5300 and W5550.\n + So, \ref setIMR() set a value to IMR2 for integrating with ioLibrary +*/ +#define IMR2 (_W5200_IO_BASE_ + (0x0036)) // Interrupt Mask + + +//----------------------------- W5200 Socket Registers ----------------------------- + +//--------------------------- For Backward Compatibility --------------------------- + +/** + @ingroup Socket_register_group_W5200 + @brief socket Mode register(R/W) + @details \ref Sn_MR configures the option or protocol type of Socket n.\n\n + Each bit of \ref Sn_MR defined as the following. + + + +
    7 6 5 4 3 2 1 0
    MULTI MF ND/MC Reserved Protocol[3] Protocol[2] Protocol[1] Protocol[0]
    + - \ref Sn_MR_MULTI : Support UDP Multicasting + - \ref Sn_MR_MF : Support MACRAW + - \ref Sn_MR_ND : No Delayed Ack(TCP) flag + - \ref Sn_MR_MC : IGMP version used in UDP mulitcasting + - Protocol + + + + + + +
    Protocol[3] Protocol[2] Protocol[1] Protocol[0] @b Meaning
    0 0 0 0 Closed
    0 0 0 1 TCP
    0 0 1 0 UDP
    0 1 0 0 MACRAW
    + - In case of Socket 0 + + + + +
    Protocol[3] Protocol[2] Protocol[1] Protocol[0] @b Meaning
    0 1 0 0 MACRAW
    0 1 0 1 PPPoE
    + - \ref Sn_MR_MACRAW : MAC LAYER RAW SOCK \n + - \ref Sn_MR_UDP : UDP + - \ref Sn_MR_TCP : TCP + - \ref Sn_MR_CLOSE : Unused socket + @note MACRAW mode should be only used in Socket 0. +*/ +#define Sn_MR(sn) (_W5200_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x0000)) // socket Mode register + +/** + @ingroup Socket_register_group_W5200 + @brief Socket command register(R/W) + @details This is used to set the command for Socket n such as OPEN, CLOSE, CONNECT, LISTEN, SEND, and RECEIVE.\n + After W5200 accepts the command, the \ref Sn_CR register is automatically cleared to 0x00. + Even though \ref Sn_CR is cleared to 0x00, the command is still being processed.\n + To check whether the command is completed or not, please check the \ref Sn_IR or \ref Sn_SR. + - \ref Sn_CR_OPEN : Initialize or open socket. + - \ref Sn_CR_LISTEN : Wait connection request in TCP mode(Server mode) + - \ref Sn_CR_CONNECT : Send connection request in TCP mode(Client mode) + - \ref Sn_CR_DISCON : Send closing request in TCP mode. + - \ref Sn_CR_CLOSE : Close socket. + - \ref Sn_CR_SEND : Update TX buffer pointer and send data. + - \ref Sn_CR_SEND_MAC : Send data with MAC address, so without ARP process. + - \ref Sn_CR_SEND_KEEP : Send keep alive message. + - \ref Sn_CR_RECV : Update RX buffer pointer and receive data. + - In case of S0_MR(P3:P0) = S0_MR_PPPoE + + + + + + + +
    Value Symbol Description
    0x23 PCON PPPoE connection begins by transmitting PPPoE discovery packet
    0x24 PDISCON Closes PPPoE connection
    0x25 PCR In each phase, it transmits REQ message.
    0x26 PCN In each phase, it transmits NAK message.
    0x27 PCJ In each phase, it transmits REJECT message.
    +*/ +#define Sn_CR(sn) (_W5200_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x0001)) // channel Sn_CR register + +/** + @ingroup Socket_register_group_W5200 + @brief Socket interrupt register(R) + @details \ref Sn_IR indicates the status of Socket Interrupt such as establishment, termination, receiving data, timeout).\n + When an interrupt occurs and the corresponding bit of \ref Sn_IMR is the corresponding bit of \ref Sn_IR becomes \n + In order to clear the \ref Sn_IR bit, the host should write the bit to \n + + + +
    7 6 5 4 3 2 1 0
    PRECV PFAIL PNEXT SEND_OK TIMEOUT RECV DISCON CON
    + - \ref Sn_IR_PRECV : PPP Receive Interrupt + - \ref Sn_IR_PFAIL : PPP Fail Interrupt + - \ref Sn_IR_PNEXT : PPP Next Phase Interrupt + - \ref Sn_IR_SENDOK : SEND_OK Interrupt + - \ref Sn_IR_TIMEOUT : TIMEOUT Interrupt + - \ref Sn_IR_RECV : RECV Interrupt + - \ref Sn_IR_DISCON : DISCON Interrupt + - \ref Sn_IR_CON : CON Interrupt +*/ +#define Sn_IR(sn) (_W5200_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x0002)) // channel interrupt register + +/** + @ingroup Socket_register_group_W5200 + @brief Socket status register(R) + @details \ref Sn_SR indicates the status of Socket n.\n + The status of Socket n is changed by \ref Sn_CR or some special control packet as SYN, FIN packet in TCP. + @par Normal status + - \ref SOCK_CLOSED : Closed + - \ref SOCK_INIT : Initiate state + - \ref SOCK_LISTEN : Listen state + - \ref SOCK_ESTABLISHED : Success to connect + - \ref SOCK_CLOSE_WAIT : Closing state + - \ref SOCK_UDP : UDP socket + - \ref SOCK_MACRAW : MAC raw mode socket + @par Temporary status during changing the status of Socket n. + - \ref SOCK_SYNSENT : This indicates Socket n sent the connect-request packet (SYN packet) to a peer. + - \ref SOCK_SYNRECV : It indicates Socket n successfully received the connect-request packet (SYN packet) from a peer. + - \ref SOCK_FIN_WAIT : Connection state + - \ref SOCK_CLOSING : Closing state + - \ref SOCK_TIME_WAIT : Closing state + - \ref SOCK_LAST_ACK : Closing state +*/ +#define Sn_SR(sn) (_W5200_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x0003)) // channel status register + +/** + @ingroup Socket_register_group_W5200 + @brief source port register(R/W) + @details \ref Sn_PORT configures the source port number of Socket n. + It is valid when Socket n is used in TCP/UDP mode. It should be set before OPEN command is ordered. +*/ +#define Sn_PORT(sn) (_W5200_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x0004)) // source port register + +/** + @ingroup Socket_register_group_W5200 + @brief Peer MAC register address(R/W) + @details \ref Sn_DHAR configures the destination hardware address of Socket n when using SEND_MAC command in UDP mode or + it indicates that it is acquired in ARP-process by CONNECT/SEND command. +*/ +#define Sn_DHAR(sn) (_W5200_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x0006)) // Peer MAC register address + +/** + @ingroup Socket_register_group_W5200 + @brief Peer IP register address(R/W) + @details \ref Sn_DIPR configures or indicates the destination IP address of Socket n. It is valid when Socket n is used in TCP/UDP mode. + In TCP client mode, it configures an IP address of TCP server before CONNECT command. + In TCP server mode, it indicates an IP address of TCP client after successfully establishing connection. + In UDP mode, it configures an IP address of peer to be received the UDP packet by SEND or SEND_MAC command. +*/ +#define Sn_DIPR(sn) (_W5200_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x000C)) // Peer IP register address + +/** + @ingroup Socket_register_group_W5200 + @brief Peer port register address(R/W) + @details \ref Sn_DPORT configures or indicates the destination port number of Socket n. It is valid when Socket n is used in TCP/UDP mode. + In TCP clientmode, it configures the listen port number of TCP server before CONNECT command. + In TCP Servermode, it indicates the port number of TCP client after successfully establishing connection. + In UDP mode, it configures the port number of peer to be transmitted the UDP packet by SEND/SEND_MAC command. +*/ +#define Sn_DPORT(sn) (_W5200_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x0010)) // Peer port register address + +/** + @ingroup Socket_register_group_W5200 + @brief Maximum Segment Size(Sn_MSSR0) register address(R/W) + @details \ref Sn_MSSR configures or indicates the MTU(Maximum Transfer Unit) of Socket n. +*/ +#define Sn_MSSR(sn) (_W5200_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x0012)) // Maximum Segment Size(Sn_MSSR0) register address + +/** + @ingroup Socket_register_group_W5200 + @brief IP Protocol(PROTO) Register(R/W) + @details \ref Sn_PROTO that sets the protocol number field of the IP header at the IP layer. It is + valid only in IPRAW mode, and ignored in other modes. +*/ +#define Sn_PROTO(sn) (_W5200_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x0014)) // Protocol of IP Header field register in IP raw mode + +/** + @ingroup Socket_register_group_W5200 + @brief IP Type of Service(TOS) Register(R/W) + @details \ref Sn_TOS configures the TOS(Type Of Service field in IP Header) of Socket n. + It is set before OPEN command. +*/ +#define Sn_TOS(sn) (WIZCHIP_SREG_BLOCK(sn) + 0x0015) // IP Type of Service(TOS) Register + +/** + @ingroup Socket_register_group_W5200 + @brief IP Time to live(TTL) Register(R/W) + @details \ref Sn_TTL configures the TTL(Time To Live field in IP header) of Socket n. + It is set before OPEN command. +*/ +#define Sn_TTL(sn) (_W5200_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x0016)) // IP Time to live(TTL) Register + +// Reserved (_W5200_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x0017)) +// Reserved (_W5200_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x0018)) +// Reserved (_W5200_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x0019)) +// Reserved (_W5200_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x001A)) +// Reserved (_W5200_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x001B)) +// Reserved (_W5200_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x001C)) +// Reserved (_W5200_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x001D)) + +/** + @ingroup Socket_register_group_W5200 + @brief Receive memory size register(R/W) + @details \ref Sn_RXMEM_SIZE configures the RX buffer block size of Socket n. + Socket n RX Buffer Block size can be configured with 1,2,4,8, and 16 Kbytes. + If a different size is configured, the data cannot be normally received from a peer. + Although Socket n RX Buffer Block size is initially configured to 2Kbytes, + user can re-configure its size using \ref Sn_RXMEM_SIZE. The total sum of \ref Sn_RXMEM_SIZE can not be exceed 16Kbytes. + When exceeded, the data reception error is occurred. +*/ +#define Sn_RXMEM_SIZE(sn) (_W5200_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x001E)) // Receive memory size reigster + +/** + @ingroup Socket_register_group_W5200 + @brief Transmit memory size register(R/W) + @details \ref Sn_TXMEM_SIZE configures the TX buffer block size of Socket n. Socket n TX Buffer Block size can be configured with 1,2,4,8, and 16 Kbytes. + If a different size is configured, the data can't be normally transmitted to a peer. + Although Socket n TX Buffer Block size is initially configured to 2Kbytes, + user can be re-configure its size using \ref Sn_TXMEM_SIZE. The total sum of \ref Sn_TXMEM_SIZE can not be exceed 16Kbytes. + When exceeded, the data transmission error is occurred. +*/ +#define Sn_TXMEM_SIZE(sn) (_W5200_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x001F)) // Transmit memory size reigster + +/** + @ingroup Socket_register_group_W5200 + @brief Transmit free memory size register(R) + @details \ref Sn_TX_FSR indicates the free size of Socket n TX Buffer Block. It is initialized to the configured size by \ref Sn_TXMEM_SIZE. + Data bigger than \ref Sn_TX_FSR should not be saved in the Socket n TX Buffer because the bigger data overwrites the previous saved data not yet sent. + Therefore, check before saving the data to the Socket n TX Buffer, and if data is equal or smaller than its checked size, + transmit the data with SEND/SEND_MAC command after saving the data in Socket n TX buffer. But, if data is bigger than its checked size, + transmit the data after dividing into the checked size and saving in the Socket n TX buffer. +*/ +#define Sn_TX_FSR(sn) (_W5200_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x0020)) // Transmit free memory size register + +/** + @ingroup Socket_register_group_W5200 + @brief Transmit memory read pointer register address(R) + @details \ref Sn_TX_RD is initialized by OPEN command. However, if Sn_MR(P[3:0]) is TCP mode(001), it is re-initialized while connecting with TCP. + After its initialization, it is auto-increased by SEND command. + SEND command transmits the saved data from the current \ref Sn_TX_RD to the \ref Sn_TX_WR in the Socket n TX Buffer. + After transmitting the saved data, the SEND command increases the \ref Sn_TX_RD as same as the \ref Sn_TX_WR. + If its increment value exceeds the maximum value 0xFFFF, (greater than 0x10000 and the carry bit occurs), + then the carry bit is ignored and will automatically update with the lower 16bits value. +*/ +#define Sn_TX_RD(sn) (_W5200_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x0022)) // Transmit memory read pointer register address + +/** + @ingroup Socket_register_group_W5200 + @brief Transmit memory write pointer register address(R/W) + @details \ref Sn_TX_WR is initialized by OPEN command. However, if Sn_MR(P[3:0]) is TCP mode(001), it is re-initialized while connecting with TCP.\n + It should be read or be updated like as follows.\n + 1. Read the starting address for saving the transmitting data.\n + 2. Save the transmitting data from the starting address of Socket n TX buffer.\n + 3. After saving the transmitting data, update \ref Sn_TX_WR to the increased value as many as transmitting data size. + If the increment value exceeds the maximum value 0xFFFF(greater than 0x10000 and the carry bit occurs), + then the carry bit is ignored and will automatically update with the lower 16bits value.\n + 4. Transmit the saved data in Socket n TX Buffer by using SEND/SEND command +*/ +#define Sn_TX_WR(sn) (_W5200_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x0024)) // Transmit memory write pointer register address + +/** + @ingroup Socket_register_group_W5200 + @brief Received data size register(R) + @details \ref Sn_RX_RSR indicates the data size received and saved in Socket n RX Buffer. + \ref Sn_RX_RSR does not exceed the \ref Sn_RXMEM_SIZE and is calculated as the difference between + Socket n RX Write Pointer (\ref Sn_RX_WR)and Socket n RX Read Pointer (\ref Sn_RX_RD) +*/ +#define Sn_RX_RSR(sn) (_W5200_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x0026)) // Received data size register + +/** + @ingroup Socket_register_group_W5200 + @brief Read point of Receive memory(R/W) + @details \ref Sn_RX_RD is initialized by OPEN command. Make sure to be read or updated as follows.\n + 1. Read the starting save address of the received data.\n + 2. Read data from the starting address of Socket n RX Buffer.\n + 3. After reading the received data, Update \ref Sn_RX_RD to the increased value as many as the reading size. + If the increment value exceeds the maximum value 0xFFFF, that is, is greater than 0x10000 and the carry bit occurs, + update with the lower 16bits value ignored the carry bit.\n + 4. Order RECV command is for notifying the updated \ref Sn_RX_RD to W5200. +*/ +#define Sn_RX_RD(sn) (_W5200_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x0028)) // Read point of Receive memory + +/** + @ingroup Socket_register_group_W5200 + @brief Write point of Receive memory(R) + @details \ref Sn_RX_WR is initialized by OPEN command and it is auto-increased by the data reception. + If the increased value exceeds the maximum value 0xFFFF, (greater than 0x10000 and the carry bit occurs), + then the carry bit is ignored and will automatically update with the lower 16bits value. +*/ +#define Sn_RX_WR(sn) (_W5200_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x002A)) // Write point of Receive memory + +/** + @ingroup Socket_register_group_W5200 + @brief socket interrupt mask register(R) + @details \ref Sn_IMR masks the interrupt of Socket n. + Each bit corresponds to each bit of \ref Sn_IR. When a Socket n Interrupt is occurred and the corresponding bit of \ref Sn_IMR is + the corresponding bit of \ref Sn_IR becomes When both the corresponding bit of \ref Sn_IMR and \ref Sn_IR are and the n-th bit of \ref IR is + Host is interrupted by asserted INTn PIN to low. +*/ +#define Sn_IMR(sn) (_W5200_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x002C)) // socket interrupt mask register + +/** + @ingroup Socket_register_group_W5200 + @brief Fragment field value in IP header register(R/W) + @details \ref Sn_FRAG configures the FRAG(Fragment field in IP header). +*/ +#define Sn_FRAG(sn) (_W5200_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x002D)) // frag field value in IP header register + + +//----------------------------- W5200 Register values ----------------------------- + +/* MODE register values */ +/** + @brief Reset + @details If this bit is All internal registers will be initialized. It will be automatically cleared as after S/W reset. +*/ +#define MR_RST 0x80 ///< reset + +/** + @brief Wake on LAN + @details 0 : Disable WOL mode\n + 1 : Enable WOL mode\n + If WOL mode is enabled and the received magic packet over UDP has been normally processed, the Interrupt PIN (INTn) asserts to low. + When using WOL mode, the UDP Socket should be opened with any source port number. (Refer to Socket n Mode Register (\ref Sn_MR) for opening Socket.) + @note The magic packet over UDP supported by W5200 consists of 6 bytes synchronization stream (xFFFFFFFFFFFF and + 16 times Target MAC address stream in UDP payload. The options such like password are ignored. You can use any UDP source port number for WOL mode. +*/ +#define MR_WOL 0x20 ///< Wake on Lan + +/** + @brief Ping block + @details 0 : Disable Ping block\n + 1 : Enable Ping block\n + If the bit is it blocks the response to a ping request. +*/ +#define MR_PB 0x10 ///< ping block + +/** + @brief Enable PPPoE + @details 0 : DisablePPPoE mode\n + 1 : EnablePPPoE mode\n + If you use ADSL, this bit should be '1'. +*/ +#define MR_PPPOE 0x08 ///< enable pppoe + +/** + @brief Address Auto-Increment in Indirect Bus Interface + @details 0 : Disable auto-increment \n + 1 : Enable auto-incremente \n + At the Indirect Bus Interface mode, if this bit is set as ��1��, the address will + be automatically increased by 1 whenever read and write are performed. +*/ +#define MR_AI 0x02 ///< auto-increment in indirect mode + +/** + @brief Indirect Bus Interface mode + @details 0 : Disable Indirect bus Interface mode \n + 1 : Enable Indirect bus Interface mode \n + If this bit is set as ��1��, Indirect Bus Interface mode is set. +*/ +#define MR_IND 0x01 ///< enable indirect mode + +/* IR register values */ +/** + @brief Check IP conflict. + @details Bit is set as when own source IP address is same with the sender IP address in the received ARP request. +*/ +#define IR_CONFLICT 0x80 ///< check ip confict + +/** + @brief Get the PPPoE close message. + @details When PPPoE is disconnected during PPPoE mode, this bit is set. +*/ +#define IR_PPPoE 0x20 ///< get the PPPoE close message + +/** + @brief Link Status [Read Only] + @details 0: Link down \n 1: Link up \n +*/ +#define PHYSTATUS_LINK 0x20 + +/** + @brief Power save mode of PHY + @details 0: Disable Power save mode \n 1: Enable Power save mode \n +*/ +#define PHYSTATUS_POWERSAVE 0x10 + +/** + @brief Power down mode of PHY + @details 0: Disable Power down mode \n 1: Enable Power down mode\n +*/ +#define PHYSTATUS_POWERDOWN 0x08 + +// Sn_MR values +/* Sn_MR Default values */ +/** + @brief Unused socket + @details This configures the protocol mode of Socket n. +*/ +#define Sn_MR_CLOSE 0x00 ///< unused socket + +/** + @brief TCP + @details This configures the protocol mode of Socket n. +*/ +#define Sn_MR_TCP 0x01 ///< TCP + +/** + @brief UDP + @details This configures the protocol mode of Socket n. +*/ +#define Sn_MR_UDP 0x02 ///< UDP +#define Sn_MR_IPRAW 0x03 ///< IP LAYER RAW SOCK + +/** + @brief MAC LAYER RAW SOCK + @details This configures the protocol mode of Socket n. + @note MACRAW mode should be only used in Socket 0. +*/ +#define Sn_MR_MACRAW 0x04 ///< MAC LAYER RAW SOCK + +/** + @brief PPPoE + @details This configures the protocol mode of Socket n. + @note PPPoE mode should be only used in Socket 0. +*/ +#define Sn_MR_PPPOE 0x05 ///< PPPoE + +/** + @brief No Delayed Ack(TCP), Multicast flag + @details 0 : Disable No Delayed ACK option\n + 1 : Enable No Delayed ACK option\n + This bit is applied only during TCP mode (P[3:0] = 001).\n + When this bit is It sends the ACK packet without delay as soon as a Data packet is received from a peer.\n + When this bit is It sends the ACK packet after waiting for the timeout time configured by \ref _RTR_. +*/ +#define Sn_MR_ND 0x20 ///< No Delayed Ack(TCP) flag + +/* Sn_MR Default values */ +/** + @brief Support UDP Multicasting + @details 0 : disable Multicasting\n + 1 : enable Multicasting\n + This bit is applied only during UDP mode(P[3:0] = 010).\n + To use multicasting, \ref Sn_DIPR & \ref Sn_DPORT should be respectively configured with the multicast group IP address & port number + before Socket n is opened by OPEN command of \ref Sn_CR. +*/ +#define Sn_MR_MC Sn_MR_ND ///< Select IGMP version 1(0) or 2(1) + +/** + @brief Multicast Blocking in \ref Sn_MR_MACRAW mode + @details 0 : using IGMP version 2\n + 1 : using IGMP version 1\n + This bit is applied only during UDP mode(P[3:0] = 010 and MULTI = '1') + It configures the version for IGMP messages (Join/Leave/Report). +*/ +#define Sn_MR_MF 0x40 ///< Use MAC filter +#define Sn_MR_MFEN Sn_MR_MF + +/* Sn_MR Default values */ +/** + @brief Support UDP Multicasting + @details 0 : disable Multicasting\n + 1 : enable Multicasting\n + This bit is applied only during UDP mode(P[3:0] = 010).\n + To use multicasting, \ref Sn_DIPR & \ref Sn_DPORT should be respectively configured with the multicast group IP address & port number + before Socket n is opened by OPEN command of \ref Sn_CR. +*/ +#define Sn_MR_MULTI 0x80 ///< support multicating + +/* Sn_CR values */ +/** + @brief Initialize or open socket + @details Socket n is initialized and opened according to the protocol selected in Sn_MR(P3:P0). + The table below shows the value of \ref Sn_SR corresponding to \ref Sn_MR.\n + + + + + + + + +
    \b Sn_MR (P[3:0]) \b Sn_SR
    Sn_MR_CLOSE (000) --
    Sn_MR_TCP (001) SOCK_INIT (0x13)
    Sn_MR_UDP (010) SOCK_UDP (0x22)
    S0_MR_IPRAW (011) SOCK_IPRAW (0x32)
    S0_MR_MACRAW (100) SOCK_MACRAW (0x42)
    S0_MR_PPPoE (101) SOCK_PPPoE (0x5F)
    +*/ +#define Sn_CR_OPEN 0x01 ///< initialize or open socket + +/** + @brief Wait connection request in TCP mode(Server mode) + @details This is valid only in TCP mode (Sn_MR(P3:P0) = \ref Sn_MR_TCP).// + In this mode, Socket n operates as a 'TCP server' and waits for connection-request (SYN packet) from any 'TCP client'.// + The \ref Sn_SR changes the state from SOCK_INIT to SOCKET_LISTEN.// + When a 'TCP client' connection request is successfully established, + the \ref Sn_SR changes from SOCK_LISTEN to SOCK_ESTABLISHED and the Sn_IR(0) becomes + But when a 'TCP client' connection request is failed, Sn_IR(3) becomes and the status of \ref Sn_SR changes to SOCK_CLOSED. +*/ +#define Sn_CR_LISTEN 0x02 ///< wait connection request in tcp mode(Server mode) + +/** + @brief Send connection request in TCP mode(Client mode) + @details To connect, a connect-request (SYN packet) is sent to TCP serverconfigured by \ref Sn_DIPR & Sn_DPORT(destination address & port). + If the connect-request is successful, the \ref Sn_SR is changed to \ref SOCK_ESTABLISHED and the Sn_IR(0) becomes \n\n + The connect-request fails in the following three cases.\n + 1. When a @b ARPTO occurs (\ref Sn_IR[3] = '1') because destination hardware address is not acquired through the ARP-process.\n + 2. When a @b SYN/ACK packet is not received and @b TCPTO (Sn_IR(3) ='1')\n + 3. When a @b RST packet is received instead of a @b SYN/ACK packet. In these cases, \ref Sn_SR is changed to \ref SOCK_CLOSED. + @note This is valid only in TCP mode and operates when Socket n acts as TCP client +*/ +#define Sn_CR_CONNECT 0x04 ///< send connection request in tcp mode(Client mode) + +/** + @brief Send closing request in TCP mode + @details Regardless of TCP serveror TCP client the DISCON command processes the disconnect-process (Active closeor Passive close.\n + @par Active close + it transmits disconnect-request(FIN packet) to the connected peer\n + @par Passive close + When FIN packet is received from peer, a FIN packet is replied back to the peer.\n + @details When the disconnect-process is successful (that is, FIN/ACK packet is received successfully), \ref Sn_SR is changed to \ref SOCK_CLOSED.\n + Otherwise, TCPTO occurs (Sn_IR(3)='1') and then \ref Sn_SR is changed to \ref SOCK_CLOSED. + @note Valid only in TCP mode. +*/ +#define Sn_CR_DISCON 0x08 ///< send closing reqeuset in tcp mode + +/** + @brief Close socket + @details Sn_SR is changed to \ref SOCK_CLOSED. +*/ +#define Sn_CR_CLOSE 0x10 + +/** + @brief Update TX buffer pointer and send data + @details SEND transmits all the data in the Socket n TX buffer.\n + For more details, please refer to Socket n TX Free Size Register (\ref Sn_TX_FSR), Socket n, + TX Write Pointer Register(\ref Sn_TX_WR), and Socket n TX Read Pointer Register(\ref Sn_TX_RD). +*/ +#define Sn_CR_SEND 0x20 + +/** + @brief Send data with MAC address, so without ARP process + @details The basic operation is same as SEND.\n + Normally SEND transmits data after destination hardware address is acquired by the automatic ARP-process(Address Resolution Protocol).\n + But SEND_MAC transmits data without the automatic ARP-process.\n + In this case, the destination hardware address is acquired from \ref Sn_DHAR configured by host, instead of APR-process. + @note Valid only in UDP mode. +*/ +#define Sn_CR_SEND_MAC 0x21 + +/** + @brief Send keep alive message + @details It checks the connection status by sending 1byte keep-alive packet.\n + If the peer can not respond to the keep-alive packet during timeout time, the connection is terminated and the timeout interrupt will occur. + @note Valid only in TCP mode. +*/ +#define Sn_CR_SEND_KEEP 0x22 + +/** + @brief Update RX buffer pointer and receive data + @details RECV completes the processing of the received data in Socket n RX Buffer by using a RX read pointer register (\ref Sn_RX_RD).\n + For more details, refer to Socket n RX Received Size Register (\ref Sn_RX_RSR), Socket n RX Write Pointer Register (\ref Sn_RX_WR), + and Socket n RX Read Pointer Register (\ref Sn_RX_RD). +*/ +#define Sn_CR_RECV 0x40 + +/** + @brief PPPoE connection + @details PPPoE connection begins by transmitting PPPoE discovery packet +*/ +#define Sn_CR_PCON 0x23 + +/** + @brief Closes PPPoE connection + @details Closes PPPoE connection +*/ +#define Sn_CR_PDISCON 0x24 + +/** + @brief REQ message transmission + @details In each phase, it transmits REQ message. +*/ +#define Sn_CR_PCR 0x25 + +/** + @brief NAK massage transmission + @details In each phase, it transmits NAK message. +*/ +#define Sn_CR_PCN 0x26 + +/** + @brief REJECT message transmission + @details In each phase, it transmits REJECT message. +*/ +#define Sn_CR_PCJ 0x27 + +/* Sn_IR values */ +/** + @brief PPP Receive Interrupt + @details PPP Receive Interrupts when the option which is not supported is received. +*/ +#define Sn_IR_PRECV 0x80 + +/** + @brief PPP Fail Interrupt + @details PPP Fail Interrupts when PAP Authentication is failed. +*/ +#define Sn_IR_PFAIL 0x40 + +/** + @brief PPP Next Phase Interrupt + @details PPP Next Phase Interrupts when the phase is changed during ADSL connection process. +*/ +#define Sn_IR_PNEXT 0x20 + +/** + @brief SEND_OK Interrupt + @details This is issued when SEND command is completed. +*/ +#define Sn_IR_SENDOK 0x10 ///< complete sending + +/** + @brief TIMEOUT Interrupt + @details This is issued when ARPTO or TCPTO occurs. +*/ +#define Sn_IR_TIMEOUT 0x08 ///< assert timeout + +/** + @brief RECV Interrupt + @details This is issued whenever data is received from a peer. +*/ +#define Sn_IR_RECV 0x04 + +/** + @brief DISCON Interrupt + @details This is issued when FIN or FIN/ACK packet is received from a peer. +*/ +#define Sn_IR_DISCON 0x02 + +/** + @brief CON Interrupt + @details This is issued one time when the connection with peer is successful and then \ref Sn_SR is changed to \ref SOCK_ESTABLISHED. +*/ +#define Sn_IR_CON 0x01 + +/* Sn_SR values */ +/** + @brief Closed + @details This indicates that Socket n is released.\n + When DICON, CLOSE command is ordered, or when a timeout occurs, it is changed to \ref SOCK_CLOSED regardless of previous status. +*/ +#define SOCK_CLOSED 0x00 ///< closed + +/** + @brief Initiate state + @details This indicates Socket n is opened with TCP mode.\n + It is changed to \ref SOCK_INIT when Sn_MR(P[3:0]) = 001)and OPEN command is ordered.\n + After \ref SOCK_INIT, user can use LISTEN /CONNECT command. +*/ +#define SOCK_INIT 0x13 ///< init state + +/** + @brief Listen state + @details This indicates Socket n is operating as TCP servermode and waiting for connection-request (SYN packet) from a peer (TCP client).\n + It will change to \ref SOCK_ESTABLISHED when the connection-request is successfully accepted.\n + Otherwise it will change to \ref SOCK_CLOSED after TCPTO occurred (Sn_IR(TIMEOUT) = '1'). +*/ +#define SOCK_LISTEN 0x14 + +/** + @brief Connection state + @details This indicates Socket n sent the connect-request packet (SYN packet) to a peer.\n + It is temporarily shown when \ref Sn_SR is changed from \ref SOCK_INIT to \ref SOCK_ESTABLISHED by CONNECT command.\n + If connect-accept(SYN/ACK packet) is received from the peer at SOCK_SYNSENT, it changes to \ref SOCK_ESTABLISHED.\n + Otherwise, it changes to \ref SOCK_CLOSED after TCPTO (\ref Sn_IR[TIMEOUT] = '1') is occurred. +*/ +#define SOCK_SYNSENT 0x15 + +/** + @brief Connection state + @details It indicates Socket n successfully received the connect-request packet (SYN packet) from a peer.\n + If socket n sends the response (SYN/ACK packet) to the peer successfully, it changes to \ref SOCK_ESTABLISHED. \n + If not, it changes to \ref SOCK_CLOSED after timeout occurs (\ref Sn_IR[TIMEOUT] = '1'). +*/ +#define SOCK_SYNRECV 0x16 + +/** + @brief Success to connect + @details This indicates the status of the connection of Socket n.\n + It changes to \ref SOCK_ESTABLISHED when the TCP SERVERprocessed the SYN packet from the TCP CLIENTduring \ref SOCK_LISTEN, or + when the CONNECT command is successful.\n + During \ref SOCK_ESTABLISHED, DATA packet can be transferred using SEND or RECV command. +*/ +#define SOCK_ESTABLISHED 0x17 + +/** + @brief Closing state + @details These indicate Socket n is closing.\n + These are shown in disconnect-process such as active-close and passive-close.\n + When Disconnect-process is successfully completed, or when timeout occurs, these change to \ref SOCK_CLOSED. +*/ +#define SOCK_FIN_WAIT 0x18 + +/** + @brief Closing state + @details These indicate Socket n is closing.\n + These are shown in disconnect-process such as active-close and passive-close.\n + When Disconnect-process is successfully completed, or when timeout occurs, these change to \ref SOCK_CLOSED. +*/ +#define SOCK_CLOSING 0x1A + +/** + @brief Closing state + @details These indicate Socket n is closing.\n + These are shown in disconnect-process such as active-close and passive-close.\n + When Disconnect-process is successfully completed, or when timeout occurs, these change to \ref SOCK_CLOSED. +*/ +#define SOCK_TIME_WAIT 0x1B + +/** + @brief Closing state + @details This indicates Socket n received the disconnect-request (FIN packet) from the connected peer.\n + This is half-closing status, and data can be transferred.\n + For full-closing, DISCON command is used. But For just-closing, CLOSE command is used. +*/ +#define SOCK_CLOSE_WAIT 0x1C + +/** + @brief Closing state + @details This indicates Socket n is waiting for the response (FIN/ACK packet) to the disconnect-request (FIN packet) by passive-close.\n + It changes to \ref SOCK_CLOSED when Socket n received the response successfully, or when timeout occurs (\ref Sn_IR[TIMEOUT] = '1'). +*/ +#define SOCK_LAST_ACK 0x1D + +/** + @brief UDP socket + @details This indicates Socket n is opened in UDP mode(Sn_MR(P[3:0]) = 010).\n + It changes to SOCK_UDP when Sn_MR(P[3:0]) = 010 and OPEN command is ordered.\n + Unlike TCP mode, data can be transfered without the connection-process. +*/ +#define SOCK_UDP 0x22 ///< udp socket + +/** + @brief IP raw mode socket + @details TThe socket is opened in IPRAW mode. The SOCKET status is change to SOCK_IPRAW when Sn_MR (P3:P0) is + Sn_MR_IPRAW and OPEN command is used.\n + IP Packet can be transferred without a connection similar to the UDP mode. +*/ +#define SOCK_IPRAW 0x32 ///< ip raw mode socket + +/** + @brief MAC raw mode socket + @details This indicates Socket 0 is opened in MACRAW mode (S0_MR(P[3:0]) = 100and is valid only in Socket 0.\n + It changes to SOCK_MACRAW when S0_MR(P[3:0] = 100)and OPEN command is ordered.\n + Like UDP mode socket, MACRAW mode Socket 0 can transfer a MAC packet (Ethernet frame) without the connection-process. +*/ +#define SOCK_MACRAW 0x42 ///< mac raw mode socket + +/** + @brief PPPoE mode socket + @details It is the status that SOCKET0 is open as PPPoE mode. It is changed to SOCK_PPPoE in case of S0_CR=OPEN and S0_MR + (P3:P0)=S0_MR_PPPoE.\n + It is temporarily used at the PPPoE + connection. +*/ +#define SOCK_PPPOE 0x5F ///< pppoe socket + +// IP PROTOCOL +#define IPPROTO_IP 0 ///< Dummy for IP +#define IPPROTO_ICMP 1 ///< Control message protocol +#define IPPROTO_IGMP 2 ///< Internet group management protocol +#define IPPROTO_GGP 3 ///< GW^2 (deprecated) +#define IPPROTO_TCP 6 ///< TCP +#define IPPROTO_PUP 12 ///< PUP +#define IPPROTO_UDP 17 ///< UDP +#define IPPROTO_IDP 22 ///< XNS idp +#define IPPROTO_ND 77 ///< UNOFFICIAL net disk protocol +#define IPPROTO_RAW 255 ///< Raw IP packet + +/** + @brief Enter a critical section + + @details It is provided to protect your shared code which are executed without distribution. \n \n + + In non-OS environment, It can be just implemented by disabling whole interrupt.\n + In OS environment, You can replace it to critical section api supported by OS. + + \sa WIZCHIP_READ(), WIZCHIP_WRITE(), WIZCHIP_READ_BUF(), WIZCHIP_WRITE_BUF() + \sa WIZCHIP_CRITICAL_EXIT() +*/ +#define WIZCHIP_CRITICAL_ENTER() WIZCHIP.CRIS._enter() + +#ifdef _exit +#undef _exit +#endif + +/** + @brief Exit a critical section + + @details It is provided to protect your shared code which are executed without distribution. \n\n + + In non-OS environment, It can be just implemented by disabling whole interrupt. \n + In OS environment, You can replace it to critical section api supported by OS. + + @sa WIZCHIP_READ(), WIZCHIP_WRITE(), WIZCHIP_READ_BUF(), WIZCHIP_WRITE_BUF() + @sa WIZCHIP_CRITICAL_ENTER() +*/ +#define WIZCHIP_CRITICAL_EXIT() WIZCHIP.CRIS._exit() + + + +//////////////////////// +// Basic I/O Function // +//////////////////////// +/** + @ingroup Basic_IO_function_W5200 + @brief It reads 1 byte value from a register. + @param AddrSel Register address + @return The value of register +*/ +uint8_t WIZCHIP_READ(uint32_t AddrSel); + +/** + @ingroup Basic_IO_function_W5200 + @brief It writes 1 byte value to a register. + @param AddrSel Register address + @param wb Write data + @return void +*/ +void WIZCHIP_WRITE(uint32_t AddrSel, uint8_t wb); + +/** + @ingroup Basic_IO_function_W5200 + @brief It reads sequence data from registers. + @param AddrSel Register address + @param pBuf Pointer buffer to read data + @param len Data length +*/ +void WIZCHIP_READ_BUF(uint32_t AddrSel, uint8_t* pBuf, uint16_t len); + +/** + @ingroup Basic_IO_function_W5200 + @brief It writes sequence data to registers. + @param AddrSel Register address + @param pBuf Pointer buffer to write data + @param len Data length +*/ +void WIZCHIP_WRITE_BUF(uint32_t AddrSel, uint8_t* pBuf, uint16_t len); + + +///////////////////////////////// +// Common Register IO function // +///////////////////////////////// + +/** + @ingroup Common_register_access_function_W5200 + @brief Set Mode Register + @param (uint8_t)mr The value to be set. + @sa getMR() +*/ +#if (_WIZCHIP_IO_MODE_ & _WIZCHIP_IO_MODE_SPI_) +#define setMR(mr) WIZCHIP_WRITE(MR,mr) +#else +#define setMR(mr) (*((uint8_t*)MR) = mr) +#endif + +/** + @ingroup Common_register_access_function_W5200 + @brief Get @ref MR. + @return uint8_t. The value of Mode register. + @sa setMR() +*/ +#if (_WIZCHIP_IO_MODE_ & _WIZCHIP_IO_MODE_SPI_) +#define getMR() WIZCHIP_READ(MR) +#else +#define getMR() (*(uint8_t*)MR) +#endif + +/** + @ingroup Common_register_access_function_W5200 + @brief Set @ref GAR. + @param (uint8_t*)gar Pointer variable to set gateway IP address. It should be allocated 4 bytes. + @sa getGAR() +*/ +#define setGAR(gar) \ + WIZCHIP_WRITE_BUF(GAR,gar,4) + +/** + @ingroup Common_register_access_function_W5200 + @brief Get @ref GAR. + @param (uint8_t*)gar Pointer variable to get gateway IP address. It should be allocated 4 bytes. + @sa setGAR() +*/ +#define getGAR(gar) \ + WIZCHIP_READ_BUF(GAR,gar,4) + +/** + @ingroup Common_register_access_function_W5200 + @brief Set @ref SUBR. + @param (uint8_t*)subr Pointer variable to set subnet mask address. It should be allocated 4 bytes. + @note If subr is null pointer, set the backup subnet to SUBR. \n + If subr is 0.0.0.0, back up SUBR and clear it. \n + Otherwize, set subr to SUBR + @sa getSUBR() +*/ +#define setSUBR(subr) \ + WIZCHIP_WRITE_BUF(SUBR, subr,4) + +/** + @ingroup Common_register_access_function_W5200 + @brief Get @ref SUBR. + @param (uint8_t*)subr Pointer variable to get subnet mask address. It should be allocated 4 bytes. + @sa setSUBR() +*/ +#define getSUBR(subr) \ + WIZCHIP_READ_BUF(SUBR, subr, 4) + +/** + @ingroup Common_register_access_function_W5200 + @brief Set @ref SHAR. + @param (uint8_t*)shar Pointer variable to set local MAC address. It should be allocated 6 bytes. + @sa getSHAR() +*/ +#define setSHAR(shar) \ + WIZCHIP_WRITE_BUF(SHAR, shar, 6) + +/** + @ingroup Common_register_access_function_W5200 + @brief Get @ref SHAR. + @param (uint8_t*)shar Pointer variable to get local MAC address. It should be allocated 6 bytes. + @sa setSHAR() +*/ +#define getSHAR(shar) \ + WIZCHIP_READ_BUF(SHAR, shar, 6) + +/** + @ingroup Common_register_access_function_W5200 + @brief Set @ref SIPR. + @param (uint8_t*)sipr Pointer variable to set local IP address. It should be allocated 4 bytes. + @sa getSIPR() +*/ +#define setSIPR(sipr) \ + WIZCHIP_WRITE_BUF(SIPR, sipr, 4) + +/** + @ingroup Common_register_access_function_W5200 + @brief Get @ref SIPR. + @param (uint8_t*)sipr Pointer variable to get local IP address. It should be allocated 4 bytes. + @sa setSIPR() +*/ +#define getSIPR(sipr) \ + WIZCHIP_READ_BUF(SIPR, sipr, 4) + +/** + @ingroup Common_register_access_function_W5200 + @brief Set \ref IR register + @param (uint8_t)ir Value to set \ref IR register. + @sa getIR() +*/ +#define setIR(ir) \ + WIZCHIP_WRITE(IR, (ir & 0xA0)) +/** + @ingroup Common_register_access_function_W5200 + @brief Get \ref IR register + @return uint8_t. Value of \ref IR register. + @sa setIR() +*/ +#define getIR() \ + (WIZCHIP_READ(IR) & 0xA0) + +/** + @ingroup Common_register_access_function_W5200 + @brief Set \ref IMR2 register + @param (uint8_t)imr Value to set @ref IMR2 register. + @sa getIMR() +*/ +//M20150410 : Replace _IMR_ with IMR2 for integrating with ioLibrary +/* + #define setIMR(imr) \ + WIZCHIP_WRITE(_IMR_, imr) +*/ +#define setIMR(imr) \ + WIZCHIP_WRITE(IMR2, imr & 0xA0) + +/** + @ingroup Common_register_access_function_W5200 + @brief Get \ref IMR2 register + @return uint8_t. Value of @ref IMR2 register. + @sa setIMR() +*/ +//M20150410 : Replace _IMR_ with IMR2 for integrating with ioLibrary +/* + #define getIMR() \ + WIZCHIP_READ(_IMR_) +*/ +#define getIMR() \ + (WIZCHIP_READ(IMR2) & 0xA0) + +/** + @ingroup Common_register_access_function_W5200 + @brief Set \ref _RTR_ register + @param (uint16_t)rtr Value to set @ref _RTR_ register. + @sa getRTR() +*/ +#define setRTR(rtr) {\ + WIZCHIP_WRITE(_RTR_, (uint8_t)(rtr >> 8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(_RTR_,1), (uint8_t) rtr); \ + } + +/** + @ingroup Common_register_access_function_W5200 + @brief Get \ref _RTR_ register + @return uint16_t. Value of @ref _RTR_ register. + @sa setRTR() +*/ +#define getRTR() \ + (((uint16_t)WIZCHIP_READ(_RTR_) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(_RTR_,1))) + +/** + @ingroup Common_register_access_function_W5200 + @brief Set \ref _RCR_ register + @param (uint8_t)rcr Value to set @ref _RCR_ register. + @sa getRCR() +*/ +#define setRCR(rcr) \ + WIZCHIP_WRITE(_RCR_, rcr) + +/** + @ingroup Common_register_access_function_W5200 + @brief Get \ref _RCR_ register + @return uint8_t. Value of @ref _RCR_ register. + @sa setRCR() +*/ +#define getRCR() \ + WIZCHIP_READ(_RCR_) + +/** + @ingroup Common_register_access_function_W5200 + @brief Get \ref PATR register + @return uint16_t. Value to set \ref PATR register +*/ +#define getPATR() \ + (((uint16_t)WIZCHIP_READ(PATR) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(PATR,1))) + +/** + @ingroup Common_register_access_function_W5200 + @brief Get \ref PPPALGO register + @return uint8_t. Value to set \ref PPPALGO register +*/ +#define getPPPALGO() \ + WIZCHIP_READ(PPPALGO) + + +/** + @ingroup Common_register_access_function_W5200 + @brief Get \ref VERSIONR register + @return uint8_t. Value to set \ref VERSIONR register +*/ +#define getVERSIONR() \ + WIZCHIP_READ(VERSIONR) + +/** + @ingroup Common_register_access_function_W5200 + @brief Set \ref PTIMER register + @param (uint8_t)ptimer Value to set \ref PTIMER register. + @sa getPTIMER() +*/ +#define setPTIMER(ptimer) \ + WIZCHIP_WRITE(PTIMER, ptimer) + +/** + @ingroup Common_register_access_function_W5200 + @brief Get \ref PTIMER register + @return uint8_t. Value of @ref PTIMER register. + @sa setPTIMER() +*/ +#define getPTIMER() \ + WIZCHIP_READ(PTIMER) + +/** + @ingroup Common_register_access_function_W5200 + @brief Set \ref PMAGIC register + @param (uint8_t)pmagic Value to set @ref PMAGIC register. + @sa getPMAGIC() +*/ +#define setPMAGIC(pmagic) \ + WIZCHIP_WRITE(PMAGIC, pmagic) + +/** + @ingroup Common_register_access_function_W5200 + @brief Get \ref PMAGIC register + @return uint8_t. Value of @ref PMAGIC register. + @sa setPMAGIC() +*/ +#define getPMAGIC() \ + WIZCHIP_READ(PMAGIC) + +/** + @ingroup Common_register_access_function_W5200 + @brief Set @ref INTLEVEL register + @param (uint16_t)intlevel Value to set @ref INTLEVEL register. + @sa getINTLEVEL() +*/ +#define setINTLEVEL(intlevel) {\ + WIZCHIP_WRITE(INTLEVEL, (uint8_t)(intlevel >> 8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(INTLEVEL,1), (uint8_t) intlevel); \ + } +/** + @ingroup Common_register_access_function_W5200 + @brief Get @ref INTLEVEL register + @return uint16_t. Value of @ref INTLEVEL register. + @sa setINTLEVEL() +*/ +#define getINTLEVEL() \ + (((uint16_t)WIZCHIP_READ(INTLEVEL) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(INTLEVEL,1))) + +/** + @ingroup Common_register_access_function_W5200 + @brief Set \ref IR2 register + @param (uint8_t)ir2 Value to set \ref IR2 register. + @sa getIR2() +*/ +#define setIR2(ir2) \ + WIZCHIP_WRITE(IR2, ir2) +#define setSIR(ir2) setIR2(ir2) + +/** + @ingroup Common_register_access_function_W5200 + @brief Get \ref IR2 register + @return uint8_t. Value of \ref IR2 register. + @sa setIR2() +*/ +#define getIR2() \ + WIZCHIP_READ(IR2) +#define getSIR() getIR2() + +/** + @ingroup Common_register_access_function_W5200 + @brief Get \ref PHYSTATUS register + @return uint8_t. Value to set \ref PHYSTATUS register. +*/ +#define getPHYSTATUS() \ + WIZCHIP_READ(PHYSTATUS) + +/** + @ingroup Common_register_access_function_W5200 + @brief Set \ref _IMR_ register + @param (uint8_t)imr2 Value to set \ref IMR2 register. + @sa getIMR2() + @note If possible, Don't use this function. Instead, Use setSIMR() for compatible with ioLibrary. +*/ +//M20150410 : Replace IMR2 with _IMR_ for integrating with ioLibrary +/* + #define setIMR2(imr2) \ + WIZCHIP_WRITE(IMR2, (imr2 & 0xA0)) +*/ +#define setIMR2(imr2) \ + WIZCHIP_WRITE(_IMR_, imr2) +#define setSIMR(imr2) setIMR2(imr2) + +/** + @ingroup Common_register_access_function_W5200 + @brief Get \ref _IMR_ register + @return uint8_t. Value of \ref IMR2 register. + @sa setIMR2() +*/ +//M20150410 : Replace IMR2 with _IMR_ for integrating with ioLibrary +/* + #define getIMR2() \ + (WIZCHIP_READ(IMR2) & 0xA0) +*/ +#define getIMR2() \ + WIZCHIP_READ(_IMR_) +#define getSIMR() getIMR2() +/////////////////////////////////// +// Socket N register I/O function // +/////////////////////////////////// +/** + @ingroup Socket_register_access_function_W5200 + @brief Set @ref Sn_MR register + @param sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_ expect bit 4. + @param mr Value to set @ref Sn_MR + @sa getSn_MR() +*/ +#define setSn_MR(sn, mr) \ + WIZCHIP_WRITE(Sn_MR(sn),mr) + +/** + @ingroup Socket_register_access_function_W5200 + @brief Get @ref Sn_MR register + @param sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_ expect bit 4. + @return Value of @ref Sn_MR. + @sa setSn_MR() +*/ +#define getSn_MR(sn) \ + WIZCHIP_READ(Sn_MR(sn)) + +/** + @ingroup Socket_register_access_function_W5200 + @brief Set @ref Sn_CR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param (uint8_t)cr Value to set @ref Sn_CR + @sa getSn_CR() +*/ +#define setSn_CR(sn, cr) \ + WIZCHIP_WRITE(Sn_CR(sn), cr) + +/** + @ingroup Socket_register_access_function_W5200 + @brief Get @ref Sn_CR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint8_t. Value of @ref Sn_CR. + @sa setSn_CR() +*/ +#define getSn_CR(sn) \ + WIZCHIP_READ(Sn_CR(sn)) + +/** + @ingroup Socket_register_access_function_W5200 + @brief Set @ref Sn_IR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param (uint8_t)ir Value to set @ref Sn_IR + @sa getSn_IR() +*/ +#define setSn_IR(sn, ir) \ + WIZCHIP_WRITE(Sn_IR(sn), ir) + +/** + @ingroup Socket_register_access_function_W5200 + @brief Get @ref Sn_IR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint8_t. Value of @ref Sn_IR. + @sa setSn_IR() +*/ +#define getSn_IR(sn) \ + WIZCHIP_READ(Sn_IR(sn)) + +/** + @ingroup Socket_register_access_function_W5200 + @brief Set @ref Sn_IMR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param (uint8_t)imr Value to set @ref Sn_IMR + @sa getSn_IMR() +*/ +#define setSn_IMR(sn, imr) \ + WIZCHIP_WRITE(Sn_IMR(sn), imr) + +/** + @ingroup Socket_register_access_function_W5200 + @brief Get @ref Sn_IMR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint8_t. Value of @ref Sn_IMR. + @sa setSn_IMR() +*/ +#define getSn_IMR(sn) \ + WIZCHIP_READ(Sn_IMR(sn)) + +/** + @ingroup Socket_register_access_function_W5200 + @brief Get @ref Sn_SR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint8_t. Value of @ref Sn_SR. +*/ +#define getSn_SR(sn) \ + WIZCHIP_READ(Sn_SR(sn)) + +/** + @ingroup Socket_register_access_function_W5200 + @brief Set @ref Sn_PORT register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param (uint16_t)port Value to set @ref Sn_PORT. + @sa getSn_PORT() +*/ +#define setSn_PORT(sn, port) { \ + WIZCHIP_WRITE(Sn_PORT(sn), (uint8_t)(port >> 8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(Sn_PORT(sn),1), (uint8_t) port); \ + } +#define setSn_PORTR setSn_PORT +/** + /** + @ingroup Socket_register_access_function_W5200 + @brief Get @ref Sn_PORT register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint16_t. Value of @ref Sn_PORT. + @sa setSn_PORT() +*/ +#define getSn_PORT(sn) \ + (((uint16_t)WIZCHIP_READ(Sn_PORT(sn)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_PORT(sn),1))) + +/** + @ingroup Socket_register_access_function_W5200 + @brief Set @ref Sn_DHAR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param (uint8_t*)dhar Pointer variable to set socket n destination hardware address. It should be allocated 6 bytes. + @sa getSn_DHAR() +*/ +#define setSn_DHAR(sn, dhar) \ + WIZCHIP_WRITE_BUF(Sn_DHAR(sn), dhar, 6) + +/** + @ingroup Socket_register_access_function_W5200 + @brief Get @ref Sn_DHAR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param (uint8_t*)dhar Pointer variable to get socket n destination hardware address. It should be allocated 6 bytes. + @sa setSn_DHAR() +*/ +#define getSn_DHAR(sn, dhar) \ + WIZCHIP_READ_BUF(Sn_DHAR(sn), dhar, 6) + +/** + @ingroup Socket_register_access_function_W5200 + @brief Set @ref Sn_DIPR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param (uint8_t*)dipr Pointer variable to set socket n destination IP address. It should be allocated 4 bytes. + @sa getSn_DIPR() +*/ +#define setSn_DIPR(sn, dipr) \ + WIZCHIP_WRITE_BUF(Sn_DIPR(sn), dipr, 4) + +/** + @ingroup Socket_register_access_function_W5200 + @brief Get @ref Sn_DIPR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param (uint8_t*)dipr Pointer variable to get socket n destination IP address. It should be allocated 4 bytes. + @sa SetSn_DIPR() +*/ +#define getSn_DIPR(sn, dipr) \ + WIZCHIP_READ_BUF(Sn_DIPR(sn), dipr, 4) + +/** + @ingroup Socket_register_access_function_W5200 + @brief Set @ref Sn_DPORT register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param (uint16_t)dport Value to set @ref Sn_DPORT + @sa getSn_DPORT() +*/ +#define setSn_DPORT(sn, dport) { \ + WIZCHIP_WRITE(Sn_DPORT(sn), (uint8_t) (dport>>8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(Sn_DPORT(sn),1), (uint8_t) dport); \ + } +#define setSn_DPORTR setSn_DPORT + + +#define Sn_KPALVTR(sn) (_W5100S_IO_BASE_ + WIZCHIP_SREG_BLOCK(sn) + (0x0030)) +#define getSn_KPALVTR(sn) \ + WIZCHIP_READ(Sn_KPALVTR(sn)) +/** + /** + @ingroup Socket_register_access_function_W5200 + @brief Get @ref Sn_DPORT register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint16_t. Value of @ref Sn_DPORT. + @sa setSn_DPORT() +*/ +#define getSn_DPORT(sn) \ + (((uint16_t)WIZCHIP_READ(Sn_DPORT(sn)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_DPORT(sn),1))) + +#define getSn_DPORTR(sn) getSn_DPORT(sn) +/** + @ingroup Socket_register_access_function_W5200 + @brief Set @ref Sn_MSSR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param (uint16_t)mss Value to set @ref Sn_MSSR + @sa setSn_MSSR() +*/ +#define setSn_MSSR(sn, mss) { \ + WIZCHIP_WRITE(Sn_MSSR(sn), (uint8_t)(mss>>8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(Sn_MSSR(sn),1), (uint8_t) mss); \ + } + +/** + @ingroup Socket_register_access_function_W5200 + @brief Get @ref Sn_MSSR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint16_t. Value of @ref Sn_MSSR. + @sa setSn_MSSR() +*/ +#define getSn_MSSR(sn) \ + (((uint16_t)WIZCHIP_READ(Sn_MSSR(sn)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_MSSR(sn),1))) + +/** + @ingroup Socket_register_access_function_W5200 + @brief Set @ref Sn_PROTO register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param (uint8_t)proto Value to set \ref Sn_PROTO + @sa getSn_PROTO() +*/ +//M20150601 : Fixed Wrong Register address +/* + #define setSn_PROTO(sn, proto) \ + WIZCHIP_WRITE(Sn_TOS(sn), tos) +*/ +#define setSn_PROTO(sn, proto) \ + WIZCHIP_WRITE(Sn_PROTO(sn), proto) + +/** + @ingroup Socket_register_access_function_W5200 + @brief Get @ref Sn_PROTO register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint8_t. Value of @ref Sn_PROTO. + @sa setSn_PROTO() +*/ +//M20150601 : Fixed Wrong Register address +/* + #define getSn_PROTO(sn) \ + WIZCHIP_READ(Sn_TOS(sn)) +*/ +#define getSn_PROTO(sn) \ + WIZCHIP_READ(Sn_PROTO(sn)) + +/** + @ingroup Socket_register_access_function_W5200 + @brief Set @ref Sn_TOS register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param (uint8_t)tos Value to set @ref Sn_TOS + @sa getSn_TOS() +*/ +#define setSn_TOS(sn, tos) \ + WIZCHIP_WRITE(Sn_TOS(sn), tos) + +/** + @ingroup Socket_register_access_function_W5200 + @brief Get @ref Sn_TOS register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_ . + @return uint8_t. Value of Sn_TOS. + @sa setSn_TOS() +*/ +#define getSn_TOS(sn) \ + WIZCHIP_READ(Sn_TOS(sn)) + +/** + @ingroup Socket_register_access_function_W5200 + @brief Set @ref Sn_TTL register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_ . + @param (uint8_t)ttl Value to set @ref Sn_TTL + @sa getSn_TTL() +*/ +#define setSn_TTL(sn, ttl) \ + WIZCHIP_WRITE(Sn_TTL(sn), ttl) + +/** + @ingroup Socket_register_access_function_W5200 + @brief Get @ref Sn_TTL register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_ . + @return uint8_t. Value of @ref Sn_TTL. + @sa setSn_TTL() +*/ +#define getSn_TTL(sn) \ + WIZCHIP_READ(Sn_TTL(sn)) + +/** + @ingroup Socket_register_access_function_W5200 + @brief Set @ref Sn_RXMEM_SIZE register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_ . + @param (uint8_t)rxmemsize Value to set \ref Sn_RXMEM_SIZE + @sa getSn_RXMEM_SIZE() +*/ +#define setSn_RXMEM_SIZE(sn, rxmemsize) \ + WIZCHIP_WRITE(Sn_RXMEM_SIZE(sn),rxmemsize) + +#define setSn_RXBUF_SIZE(sn,rxmemsize) setSn_RXMEM_SIZE(sn,rxmemsize) + +/** + @ingroup Socket_register_access_function_W5200 + @brief Get @ref Sn_RXMEM_SIZE register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint8_t. Value of @ref Sn_RXMEM. + @sa setSn_RXMEM_SIZE() +*/ +#define getSn_RXMEM_SIZE(sn) \ + WIZCHIP_READ(Sn_RXMEM_SIZE(sn)) + +#define getSn_RXBUF_SIZE(sn) getSn_RXMEM_SIZE(sn) + +/** + @ingroup Socket_register_access_function_W5200 + @brief Set @ref Sn_TXMEM_SIZE register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param (uint8_t)txmemsize Value to set \ref Sn_TXMEM_SIZE + @sa getSn_TXMEM_SIZE() +*/ +#define setSn_TXMEM_SIZE(sn, txmemsize) \ + WIZCHIP_WRITE(Sn_TXMEM_SIZE(sn), txmemsize) + +#define setSn_TXBUF_SIZE(sn, txmemsize) setSn_TXMEM_SIZE(sn,txmemsize) + +/** + @ingroup Socket_register_access_function_W5200 + @brief Get @ref Sn_TXMEM_SIZE register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint8_t. Value of @ref Sn_TXMEM_SIZE. + @sa setSn_TXMEM_SIZE() +*/ +#define getSn_TXMEM_SIZE(sn) \ + WIZCHIP_READ(Sn_TXMEM_SIZE(sn)) + +#define getSn_TXBUF_SIZE(sn) getSn_TXMEM_SIZE(sn) + +/** + @ingroup Socket_register_access_function_W5200 + @brief Get @ref Sn_TX_FSR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint16_t. Value of @ref Sn_TX_FSR. +*/ +uint16_t getSn_TX_FSR(uint8_t sn); + +/** + @ingroup Socket_register_access_function_W5200 + @brief Get @ref Sn_TX_RD register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint16_t. Value of @ref Sn_TX_RD. +*/ +#define getSn_TX_RD(sn) \ + (((uint16_t)WIZCHIP_READ(Sn_TX_RD(sn)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_TX_RD(sn),1))) + +/** + @ingroup Socket_register_access_function_W5200 + @brief Set @ref Sn_TX_WR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param (uint16_t)txwr Value to set @ref Sn_TX_WR + @sa GetSn_TX_WR() +*/ +#define setSn_TX_WR(sn, txwr) { \ + WIZCHIP_WRITE(Sn_TX_WR(sn), (uint8_t)(txwr>>8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(Sn_TX_WR(sn),1), (uint8_t) txwr); \ + } + +/** + @ingroup Socket_register_access_function_W5200 + @brief Get @ref Sn_TX_WR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint16_t. Value of @ref Sn_TX_WR. + @sa setSn_TX_WR() +*/ +#define getSn_TX_WR(sn) \ + (((uint16_t)WIZCHIP_READ(Sn_TX_WR(sn)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_TX_WR(sn),1))) + +/** + @ingroup Socket_register_access_function_W5200 + @brief Get @ref Sn_RX_RSR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint16_t. Value of @ref Sn_RX_RSR. +*/ +uint16_t getSn_RX_RSR(uint8_t sn); + +/** + @ingroup Socket_register_access_function_W5200 + @brief Set @ref Sn_RX_RD register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param (uint16_t)rxrd Value to set @ref Sn_RX_RD + @sa getSn_RX_RD() +*/ +#define setSn_RX_RD(sn, rxrd) { \ + WIZCHIP_WRITE(Sn_RX_RD(sn), (uint8_t)(rxrd>>8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(Sn_RX_RD(sn),1), (uint8_t) rxrd); \ + } + +/** + @ingroup Socket_register_access_function_W5200 + @brief Get @ref Sn_RX_RD register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint16_t. Value of @ref Sn_RX_RD. + @sa setSn_RX_RD() +*/ +#define getSn_RX_RD(sn) \ + (((uint16_t)WIZCHIP_READ(Sn_RX_RD(sn)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_RX_RD(sn),1))) + +/** + @ingroup Socket_register_access_function_W5200 + @brief Set @ref Sn_RX_WR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param (uint16_t)rxwr Value to set \ref Sn_RX_WR + @sa getSn_RX_WR() +*/ +#define setSn_RX_WR(sn, rxwr) { \ + WIZCHIP_WRITE(Sn_RX_WR(sn), (uint8_t)(rxwr>>8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(Sn_RX_WR(sn),1), (uint8_t) rxwr); \ + } + + +/** + @ingroup Socket_register_access_function_W5200 + @brief Get @ref Sn_RX_WR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint16_t. Value of @ref Sn_RX_WR. +*/ +#define getSn_RX_WR(sn) \ + (((uint16_t)WIZCHIP_READ(Sn_RX_WR(sn)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_RX_WR(sn),1))) + +/** + @ingroup Socket_register_access_function_W5200 + @brief Set @ref Sn_IMR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param (uint8_t)imr Value to set \ref Sn_IMR + @sa getSn_IMR() +*/ +#define setSn_IMR(sn ,imr) \ + WIZCHIP_WRITE(Sn_IMR(sn), imr) + +/** + @ingroup Socket_register_access_function_W5200 + @brief Get @ref Sn_IMR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint8_t. Value of @ref Sn_IMR. + @sa setSn_IMR() +*/ +#define getSn_IMR(sn) \ + WIZCHIP_READ(Sn_IMR(sn)) + +/** + @ingroup Socket_register_access_function_W5200 + @brief Set @ref Sn_FRAG register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param (uint16_t)frag Value to set \ref Sn_FRAG + @sa getSn_FRAG() +*/ +#define setSn_FRAG(sn, frag) { \ + WIZCHIP_WRITE(Sn_FRAG(sn), (uint8_t)(frag >>8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(Sn_FRAG(sn),1), (uint8_t) frag); \ + } + +/** + @ingroup Socket_register_access_function_W5200 + @brief Get @ref Sn_FRAG register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint16_t. Value of @ref Sn_FRAG. + @sa setSn_FRAG() +*/ +#define getSn_FRAG(sn) \ + (((uint16_t)WIZCHIP_READ(Sn_FRAG(sn)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_FRAG(sn),1))) + +/** + @ingroup Socket_register_access_function_W5200 + @brief Get the max RX buffer size of socket sn + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint16_t. Max buffer size +*/ +#define getSn_RxMAX(sn) \ + ((uint16_t)getSn_RXMEM_SIZE(sn) << 10) + +/** + @ingroup Socket_register_access_function_W5200 + @brief Get the max TX buffer size of socket sn + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint16_t. Max buffer size +*/ +#define getSn_TxMAX(sn) \ + ((uint16_t)getSn_TXMEM_SIZE(sn) << 10) + +/** + @ingroup Socket_register_access_function_W5200 + @brief Get the mask of socket sn RX buffer. + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint16_t. Mask value +*/ +#define getSn_RxMASK(sn) \ + ((uint16_t)getSn_RxMAX(sn) - 1) + +/** + @ingroup Socket_register_access_function_W5200 + @brief Get the mask of socket sn TX buffer + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint16_t. Mask value +*/ +#define getSn_TxMASK(sn) \ + ((uint16_t)getSn_TxMAX(sn) - 1) + +/** + @ingroup Socket_register_access_function_W5200 + @brief Get the base address of socket sn RX buffer. + @param sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint16_t. Value of Socket n RX buffer base address. +*/ +uint16_t getSn_RxBASE(uint8_t sn); + +/** + @ingroup Socket_register_access_function_W5200 + @brief Get the base address of socket sn TX buffer. + @param sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint16_t. Value of Socket n TX buffer base address. +*/ +uint16_t getSn_TxBASE(uint8_t sn); + +///////////////////////////////////// +// Sn_TXBUF & Sn_RXBUF IO function // +///////////////////////////////////// +/** + @ingroup Basic_IO_function_W5200 + @brief It copies data to internal TX memory + + @details This function reads the Tx write pointer register and after that, + it copies the wizdata(pointer buffer) of the length of len(variable) bytes to internal TX memory + and updates the Tx write pointer register. + This function is being called by send() and sendto() function also. + + @param sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param wizdata Pointer buffer to write data + @param len Data length + @sa wiz_recv_data() +*/ +void wiz_send_data(uint8_t sn, uint8_t *wizdata, uint16_t len); + +/** + @ingroup Basic_IO_function_W5200 + @brief It copies data to your buffer from internal RX memory + + @details This function read the Rx read pointer register and after that, + it copies the received data from internal RX memory + to wizdata(pointer variable) of the length of len(variable) bytes. + This function is being called by recv() also. + + @param sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param wizdata Pointer buffer to read data + @param len Data length + @sa wiz_send_data() +*/ +void wiz_recv_data(uint8_t sn, uint8_t *wizdata, uint16_t len); + +/** + @ingroup Basic_IO_function_W5200 + @brief It discard the received data in RX memory. + @details It discards the data of the length of len(variable) bytes in internal RX memory. + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param len Data length +*/ +void wiz_recv_ignore(uint8_t sn, uint16_t len); + +/// \cond DOXY_APPLY_CODE +#endif +/// \endcond + +#ifdef __cplusplus +} +#endif + +#endif //_W5200_H_ + + + diff --git a/Ethernet/W5300/w5300.c b/Ethernet/W5300/w5300.c new file mode 100644 index 0000000..e57e019 --- /dev/null +++ b/Ethernet/W5300/w5300.c @@ -0,0 +1,229 @@ +//***************************************************************************** +// +//! \file w5300.h +//! \brief W5300 HAL implement File. +//! \version 1.0.0 +//! \date 2015/05/01 +//! \par Revision history +//! <2015/05/01> 1st Released for integrating with ioLibrary +//! Download the latest version directly from GitHub. Please visit the our GitHub repository for ioLibrary. +//! >> https://github.com/Wiznet/ioLibrary_Driver +//! \author MidnightCow +//! \copyright +//! +//! Copyright (c) 2015, WIZnet Co., 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: +//! +//! * 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 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 "wizchip_conf.h" + +#if _WIZCHIP_ == 5300 + +extern uint8_t sock_remained_byte[_WIZCHIP_SOCK_NUM_]; +extern uint8_t sock_pack_info[_WIZCHIP_SOCK_NUM_]; + + +/*********************** + Basic I/O Function + ***********************/ + +void WIZCHIP_WRITE(uint32_t AddrSel, uint16_t wb) { + WIZCHIP_CRITICAL_ENTER(); + WIZCHIP.CS._select(); + +#if ( (_WIZCHIP_IO_MODE_ == _WIZCHIP_IO_MODE_BUS_DIR_) ) +#if(_WIZCHIP_IO_BUS_WIDTH_ == 8) + WIZCHIP.IF.BUS._write_data(AddrSel, (uint8_t)(wb >> 8)); + WIZCHIP.IF.BUS._write_data(WIZCHIP_OFFSET_INC(AddrSel, 1), (uint8_t)wb); +#elif(_WIZCHIP_IO_BUS_WIDTH_ == 16) + WIZCHIP.IF.BUS._write_data(AddrSel, wb); +#else +#error "Abnoraml _WIZCHIP_IO_BUS_WIDTH_. Should be 8 or 16" +#endif +#elif ( (_WIZCHIP_IO_MODE_ == _WIZCHIP_IO_MODE_BUS_INDIR_) ) +#if(_WIZCHIP_IO_BUS_WIDTH_ == 8) + WIZCHIP.IF.BUS._write_data(IDM_AR, (uint8_t)(AddrSel >> 8)); + WIZCHIP.IF.BUS._write_data(WIZCHIP_OFFSET_INC(IDM_AR, 1), (uint8_t)AddrSel); + WIZCHIP.IF.BUS._write_data(IDM_DR, (uint8_t)(wb >> 8)); + WIZCHIP.IF.BUS._write_data(WIZCHIP_OFFSET_INC(IDM_DR, 1), (uint8_t)wb); +#elif(_WIZCHIP_IO_BUS_WIDTH_ == 16) + WIZCHIP.IF.BUS._write_data(IDM_AR, (uint16_t)AddrSel); + WIZCHIP.IF.BUS._write_data(IDM_DR, wb); +#else +#error "Abnoraml _WIZCHIP_IO_BUS_WIDTH_. Should be 8 or 16" +#endif +#else +#error "Unknown _WIZCHIP_IO_MODE_ in W5300. !!!" +#endif + + WIZCHIP.CS._deselect(); + WIZCHIP_CRITICAL_EXIT(); +} + +uint16_t WIZCHIP_READ(uint32_t AddrSel) { + uint16_t ret; + + WIZCHIP_CRITICAL_ENTER(); + WIZCHIP.CS._select(); + +#if ( (_WIZCHIP_IO_MODE_ == _WIZCHIP_IO_MODE_BUS_DIR_) ) +#if (_WIZCHIP_IO_BUS_WIDTH_ == 8) + ret = (((uint16_t)WIZCHIP.IF.BUS._read_data(AddrSel)) << 8) | + (((uint16_t)WIZCHIP.IF.BUS._read_data(WIZCHIP_OFFSET_INC(AddrSel, 1))) & 0x00FF) ; +#elif(_WIZCHIP_IO_BUS_WIDTH_ == 16) + ret = WIZCHIP.IF.BUS._read_data(AddrSel); +#else +#error "Abnoraml _WIZCHIP_IO_BUS_WIDTH_. Should be 8 or 16" +#endif +#elif ( (_WIZCHIP_IO_MODE_ == _WIZCHIP_IO_MODE_BUS_INDIR_) ) +#if(_WIZCHIP_IO_BUS_WIDTH_ == 8) + WIZCHIP.IF.BUS._write_data(IDM_AR, (uint8_t)(AddrSel >> 8)); + WIZCHIP.IF.BUS._write_data(WIZCHIP_OFFSET_INC(IDM_AR, 1), (uint8_t)AddrSel); + ret = (((uint16_t)WIZCHIP.IF.BUS._read_data(IDM_DR)) << 8) | + (((uint16_t)WIZCHIP.IF.BUS._read_data(WIZCHIP_OFFSET_INC(IDM_DR, 1))) & 0x00FF); +#elif(_WIZCHIP_IO_BUS_WIDTH_ == 16) + WIZCHIP.IF.BUS._write_data(IDM_AR, (uint16_t)AddrSel); + ret = WIZCHIP.IF.BUS._read_data(IDM_DR); +#else +#error "Abnoraml _WIZCHIP_IO_BUS_WIDTH_. Should be 8 or 16" +#endif +#else +#error "Unknown _WIZCHIP_IO_MODE_ in W5300. !!!" +#endif + + WIZCHIP.CS._deselect(); + WIZCHIP_CRITICAL_EXIT(); + return ret; +} + + +void setTMSR(uint8_t sn, uint8_t tmsr) { + uint16_t tmem; + tmem = WIZCHIP_READ(WIZCHIP_OFFSET_INC(TMS01R, (sn & 0xFE))); + if (sn & 0x01) { + tmem = (tmem & 0xFF00) | (((uint16_t)tmsr) & 0x00FF) ; + } else { + tmem = (tmem & 0x00FF) | (((uint16_t)tmsr) << 8) ; + } + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(TMS01R, (sn & 0xFE)), tmem); +} + +uint8_t getTMSR(uint8_t sn) { + if (sn & 0x01) { + return (uint8_t)(WIZCHIP_READ(WIZCHIP_OFFSET_INC(TMS01R, (sn & 0xFE))) & 0x00FF); + } + return (uint8_t)(WIZCHIP_READ(WIZCHIP_OFFSET_INC(TMS01R, (sn & 0xFE))) >> 8); +} + +void setRMSR(uint8_t sn, uint8_t rmsr) { + uint16_t rmem; + rmem = WIZCHIP_READ(WIZCHIP_OFFSET_INC(RMS01R, (sn & 0xFE))); + if (sn & 0x01) { + rmem = (rmem & 0xFF00) | (((uint16_t)rmsr) & 0x00FF) ; + } else { + rmem = (rmem & 0x00FF) | (((uint16_t)rmsr) << 8) ; + } + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(RMS01R, (sn & 0xFE)), rmem); +} + +uint8_t getRMSR(uint8_t sn) { + if (sn & 0x01) { + return (uint8_t)(WIZCHIP_READ(WIZCHIP_OFFSET_INC(RMS01R, (sn & 0xFE))) & 0x00FF); + } + return (uint8_t)(WIZCHIP_READ(WIZCHIP_OFFSET_INC(RMS01R, (sn & 0xFE))) >> 8); +} + +uint32_t getSn_TX_FSR(uint8_t sn) { + uint32_t free_tx_size = 0; + uint32_t free_tx_size1 = 1; + while (1) { + free_tx_size = (((uint32_t)WIZCHIP_READ(Sn_TX_FSR(sn))) << 16) | + (((uint32_t)WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_TX_FSR(sn), 2))) & 0x0000FFFF); // read + if (free_tx_size == free_tx_size1) { + break; // if first == sencond, Sn_TX_FSR value is valid. + } + free_tx_size1 = free_tx_size; // save second value into first + } + return free_tx_size; +} + +uint32_t getSn_RX_RSR(uint8_t sn) { + uint32_t received_rx_size = 0; + uint32_t received_rx_size1 = 1; + while (1) { + received_rx_size = (((uint32_t)WIZCHIP_READ(Sn_RX_RSR(sn))) << 16) | + (((uint32_t)WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_RX_RSR(sn), 2))) & 0x0000FFFF); + if (received_rx_size == received_rx_size1) { + break; + } + received_rx_size1 = received_rx_size; // if first == sencond, Sn_RX_RSR value is valid. + } // save second value into first + return received_rx_size + (uint32_t)((sock_pack_info[sn] & 0x02) ? 1 : 0); +} + + +void wiz_send_data(uint8_t sn, uint8_t *wizdata, uint32_t len) { + uint32_t i = 0; + if (len == 0) { + return; + } + + for (i = 0; i < len ; i += 2) + setSn_TX_FIFOR(sn, (((uint16_t)wizdata[i]) << 8) | (((uint16_t)wizdata[i + 1]) & 0x00FF)) + } + +void wiz_recv_data(uint8_t sn, uint8_t *wizdata, uint32_t len) { + uint16_t rd = 0; + uint32_t i = 0; + + if (len == 0) { + return; + } + + for (i = 0; i < len; i++) { + if ((i & 0x01) == 0) { + rd = getSn_RX_FIFOR(sn); + wizdata[i] = (uint8_t)(rd >> 8); + } else { + wizdata[i] = (uint8_t)rd; // For checking the memory access violation + } + } + sock_remained_byte[sn] = (uint8_t)rd; // back up the remaind fifo byte. +} + +void wiz_recv_ignore(uint8_t sn, uint32_t len) { + uint32_t i = 0; + for (i = 0; i < len ; i += 2) { + getSn_RX_FIFOR(sn); + } +} + + +#endif diff --git a/Ethernet/W5300/w5300.h b/Ethernet/W5300/w5300.h new file mode 100644 index 0000000..136aba0 --- /dev/null +++ b/Ethernet/W5300/w5300.h @@ -0,0 +1,2336 @@ +#ifndef _W5300_H_ +#define _W5300_H_ + +#ifdef __cplusplus +extern "C" { +#endif + +//***************************************************************************** +// +//! \file w5300.h +//! \brief W5300 HAL Header File. +//! \version 1.0.0 +//! \date 2015/05/01 +//! \par Revision history +//! <2015/05/01> 1st Released for integrating with ioLibrary +//! Download the latest version directly from GitHub. Please visit the our GitHub repository for ioLibrary. +//! >> https://github.com/Wiznet/ioLibrary_Driver +//! \author MidnightCow +//! \copyright +//! +//! Copyright (c) 2015, WIZnet Co., 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: +//! +//! * 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 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 "wizchip_conf.h" + +/// \cond DOXY_APPLY_CODE +#if (_WIZCHIP_ == 5300) +/// \endcond + +#define _WIZCHIP_SN_BASE_ (0x0200) +#define _WIZCHIP_SN_SIZE_ (0x0040) + + +#define WIZCHIP_CREG_BLOCK 0x00 ///< Common register block +#define WIZCHIP_SREG_BLOCK(N) (_WIZCHIP_SN_BASE_+ _WIZCHIP_SN_SIZE_*N) ///< Socket N register block + +#define WIZCHIP_OFFSET_INC(ADDR, N) (ADDR + N) ///< Increase offset address + +#if (_WIZCHIP_IO_MODE_ == _WIZCHIP_IO_MODE_BUS_DIR_) +#define _W5300_IO_BASE_ _WIZCHIP_IO_BASE_ +#elif (_WIZCHIP_IO_MODE_ == _WIZCHIP_IO_MODE_BUS_INDIR_) +#define IDM_AR ((_WIZCHIP_IO_BASE_ + 0x0002)) ///< Indirect mode address register +#define IDM_DR ((_WIZCHIP_IO_BASE_ + 0x0004)) ///< Indirect mode data register +#define _W5300_IO_BASE_ 0x0000 +#elif (_WIZCHIP_IO_MODE_ & _WIZCHIP_IO_MODE_SPI_) +#error "Unkonw _WIZCHIP_IO_MODE_" +#endif + +/////////////////////////////////////// +// Definition For Legacy Chip Driver // +/////////////////////////////////////// +#define IINCHIP_READ(ADDR) WIZCHIP_READ(ADDR) ///< The defined for legacy chip driver +#define IINCHIP_WRITE(ADDR,VAL) WIZCHIP_WRITE(ADDR,VAL) ///< The defined for legacy chip driver +//#define IINCHIP_READ_BUF(ADDR,BUF,LEN) WIZCHIP_READ_BUF(ADDR,BUF,LEN) ///< The defined for legacy chip driver +//#define IINCHIP_WRITE_BUF(ADDR,BUF,LEN) WIZCHIP_WRITE(ADDR,BUF,LEN) ///< The defined for legacy chip driver + +//-------------------------- defgroup --------------------------------- +/** + @defgroup W5300 W5300 + + @brief WHIZCHIP register defines and I/O functions of @b W5300. + + - @ref WIZCHIP_register_W5300 : @ref Common_register_group_W5300 and @ref Socket_register_group_W5300 + - @ref WIZCHIP_IO_Functions_W5300 : @ref Basic_IO_function_W5300, @ref Common_register_access_function_W5300 and @ref Socket_register_access_function_W5300 +*/ + + +/** + @defgroup WIZCHIP_register_W5300 WIZCHIP register + @ingroup W5300 + + @brief WHIZCHIP register defines register group of @b W5300. + + - @ref Common_register_group_W5300 : Common register group + - @ref Socket_register_group_W5300 : \c SOCKET n register group +*/ + + +/** + @defgroup WIZCHIP_IO_Functions_W5300 WIZCHIP I/O functions + @ingroup W5300 + + @brief This supports the basic I/O functions for @ref WIZCHIP_register_W5300. + + - Basic I/O function \n + WIZCHIP_READ(), WIZCHIP_WRITE() \n\n + + - @ref Common_register_group_W5300 access functions \n + -# @b Mode \n + getMR(), setMR() + -# @b Interrupt \n + getIR(), setIR(), getIMR(), setIMR(), getSIR(), setSIR(), getSIMR(), setSIMR() + -# Network Information \n + getSHAR(), setSHAR(), getGAR(), setGAR(), getSUBR(), setSUBR(), getSIPR(), setSIPR() + -# @b Retransmission \n + getRCR(), setRCR(), getRTR(), setRTR() + -# @b PPPoE \n + getPTIMER(), setPTIMER(), getPMAGIC(), getPMAGIC(), getPSID(), setPSID(), getPHAR(), setPHAR(), getPMRU(), setPMRU() + -# ICMP packet \n + getUIPR(), getUPORTR() + -# @b Socket Memory \n + getMTYPER(), setMTYPER() \n + getTMS01R(), getTMS23R(), getTMS45R(), getTMS67R(), setTMS01R(), setTMS23R(), setTMS45R(), setTMS67R() \n + getRMS01R(), getRMS23R(), getRMS45R(), getRMS67R(), setRMS01R(), setRMS23R(), setRMS45R(), setRMS67R() \n + -# @b etc. \n + getPn_BRDYR(), setPn_BRDYR(), getPn_BDPTHR(), setPn_BDPTHR(), getIDR() \n\n + + - \ref Socket_register_group_W5300 access functions \n + -# SOCKET control \n + getSn_MR(), setSn_MR(), getSn_CR(), setSn_CR(), getSn_IMR(), setSn_IMR(), getSn_IR(), setSn_IR() + -# SOCKET information \n + getSn_SR(), getSn_DHAR(), setSn_DHAR(), getSn_PORT(), setSn_PORT(), getSn_DIPR(), setSn_DIPR(), getSn_DPORT(), setSn_DPORT() + getSn_MSSR(), setSn_MSSR() + -# SOCKET communication \n + getSn_RXBUF_SIZE(), setSn_RXBUF_SIZE(), getSn_TXBUF_SIZE(), setSn_TXBUF_SIZE() \n + getSn_TX_RD(), getSn_TX_WR(), setSn_TX_WR() \n + getSn_RX_RD(), setSn_RX_RD(), getSn_RX_WR() \n + getSn_TX_FSR(), getSn_RX_RSR(), getSn_KPALVTR(), setSn_KPALVTR() + -# IP header field \n + getSn_FRAG(), setSn_FRAG(), getSn_TOS(), setSn_TOS() \n + getSn_TTL(), setSn_TTL() +*/ + + +/** + @defgroup Common_register_group_W5300 Common register + @ingroup WIZCHIP_register_W5300 + + @brief Common register group\n + It set the basic for the networking\n + It set the configuration such as interrupt, network information, ICMP, etc. + @details + @sa MR : Mode register. + @sa GAR, SUBR, SHAR, SIPR : Network Configuration + @sa IR, _IMR_ : Interrupt. + @sa MTYPER, TMS01R,TMS23R, TMS45R, TMS67R,RMS01R,RMS23R, RMS45R, RMS67R : Socket TX/RX memory + @sa _RTR_, _RCR_ : Data retransmission. + @sa PTIMER, PMAGIC, PSID, PDHAR : PPPoE. + @sa UIPR, UPORTR, FMTUR : ICMP message. + @sa Pn_BRDYR, Pn_BDPTHR, IDR : etc. +*/ + + +/** + @defgroup Socket_register_group_W5300 Socket register + @ingroup WIZCHIP_register_W5300 + + @brief Socket register group.\n + Socket register configures and control SOCKETn which is necessary to data communication. + @details + @sa Sn_MR, Sn_CR, Sn_IR, Sn_IMR : SOCKETn Control + @sa Sn_SR, Sn_PORT, Sn_DHAR, Sn_DIPR, Sn_DPORT : SOCKETn Information + @sa Sn_MSSR, Sn_TOS, Sn_TTL, Sn_KPALVTR, Sn_FRAG : Internet protocol. + @sa Sn_TX_WRSR, Sn_TX_FSR, Sn_TX_RD, Sn_TX_WR, Sn_RX_RSR, Sn_RX_RD, Sn_RX_WR, Sn_TX_FIFOR, Sn_RX_FIFOR : Data communication +*/ + + +/** + @defgroup Basic_IO_function_W5300 Basic I/O function + @ingroup WIZCHIP_IO_Functions_W5300 + @brief These are basic input/output functions to read values from register or write values to register. +*/ + +/** + @defgroup Common_register_access_function_W5300 Common register access functions + @ingroup WIZCHIP_IO_Functions_W5300 + @brief These are functions to access common registers. +*/ + +/** + @defgroup Socket_register_access_function_W5300 Socket register access functions + @ingroup WIZCHIP_IO_Functions_W5300 + @brief These are functions to access socket registers. +*/ + +//------------------------------- defgroup end -------------------------------------------- + +//----------------------------- W5300 Common Registers ----------------------------- +/** + @ingroup Common_register_group_W5300 + @brief Mode Register address(R/W)\n + @ref MR is used for S/W reset, ping block mode, PPPoE mode and etc. + @details Each bit of @ref MR defined as follows. + + + + + +
    15 14 13 12 11 10 9 8
    DBW MPF WDFRDF Reserved FS
    7 6 5 4 3 2 1 0
    RST Reserved WOL PB PPPoE Reserved FARP Reserved
    + - \ref MR_DBW : Data bus width (0 : 8 Bit, 1 : 16 Bit), Read Only + - \ref MR_MPF : Received a Pause Frame from MAC layer (0 : Normal Frame, 1 : Pause Frame), Read Only + - \ref MR_WDF : Write Data Fetch time (When CS signal is low, W5300 Fetch a written data by Host after PLL_CLK * MR_WDF) + - \ref MR_RDH : Read Data Hold time (0 : No use data hold time, 1 : Use data hold time, 2 PLL_CLK) + - \ref MR_FS : FIFO Swap (0 : Disable Swap, 1 : Enable Swap) + - \ref MR_RST : Reset + - \ref MR_WOL : Wake on LAN + - \ref MR_PB : Ping block + - \ref MR_PPPOE : PPPoE mode + - \ref MR_FARP : Force ARP mode +*/ +#define MR (_WIZCHIP_IO_BASE_) + +/** + @ingroup Common_register_group_W5300 + @brief Interrupt Register(R/W) + @details \ref IR indicates the interrupt status. Each bit of \ref IR will be still until the bit will be written to by the host. + If \ref IR is not equal to 0x0000 INTn PIN is asserted to low until it is 0x0000\n\n + Each bit of \ref IR defined as follows. + + + + + +
    15 14 13 12 11 10 9 8
    IPCF DPUR PPPT FMTU Reserved Reserved Reserved Reserved
    7 6 5 4 3 2 1 0
    S7_INT S6_INT S5_INT S4_INT S3_INT S2_INT S1_INT S0_INT
    + - \ref IR_IPCF : IP conflict + - \ref IR_DPUR : Destination Port Unreachable + - \ref IR_PPPT : PPPoE Termination + - \ref IR_FMTU : Fragmented MTU + - \ref IR_SnINT(n) : Interrupted from SOCKETn + + @note : In W5300, IR is operated same as IR and SIR in other WIZCHIP(5100,5200,W5500) +*/ +#define IR (_W5300_IO_BASE_ + 0x02) + +/** + @ingroup Common_register_group_W5300 + @brief Socket Interrupt Mask Register(R/W) + @details Each bit of \ref _IMR_ corresponds to each bit of \ref IR. + When a bit of _IMR_ is and the corresponding bit of \ref IR is Interrupt will be issued. + In other words, if a bit of _IMR_, an interrupt will be not issued even if the corresponding bit of \ref IR is set + @note : In W5300, _IMR_ is operated same as _IMR_ and SIMR in other WIZCHIP(5100,5200,W5500) +*/ +#define _IMR_ (_W5300_IO_BASE_ + 0x04) + + +//#define ICFGR (_W5300_IO_BASE_ + 0x06) +//#define INTLEVEL ICFGR + +/** + @ingroup Common_register_group_W5300 + @brief Source MAC Register address(R/W) + @details @ref SHAR configures the source hardware address. +*/ +#define SHAR (_W5300_IO_BASE_ + 0x08) + + +/** + @ingroup Common_register_group_W5300 + @brief Gateway IP Register address(R/W) + @details @ref GAR configures the default gateway address. +*/ +#define GAR (_W5300_IO_BASE_ + 0x10) + +/** + @ingroup Common_register_group_W5300 + @brief Subnet mask Register address(R/W) + @details @ref SUBR configures the subnet mask address. +*/ +#define SUBR (_W5300_IO_BASE_ + 0x14) + +/** + @ingroup Common_register_group_W5300 + @brief Source IP Register address(R/W) + @details @ref SIPR configures the source IP address. +*/ +#define SIPR (_W5300_IO_BASE_ + 0x18) + +/** + @ingroup Common_register_group_W5300 + @brief Timeout register address( 1 is 100us )(R/W) + @details @ref _RTR_ configures the retransmission timeout period. The unit of timeout period is 100us and the default of @ref _RTR_ is x07D0. + And so the default timeout period is 200ms(100us X 2000). During the time configured by @ref _RTR_, W5300 waits for the peer response + to the packet that is transmitted by \ref Sn_CR (CONNECT, DISCON, CLOSE, SEND, SEND_MAC, SEND_KEEP command). + If the peer does not respond within the @ref _RTR_ time, W5300 retransmits the packet or issues timeout. +*/ +#define _RTR_ (_W5300_IO_BASE_ + 0x1C) + +/** + @ingroup Common_register_group_W5300 + @brief Retry count register(R/W) + @details @ref _RCR_ configures the number of time of retransmission. + When retransmission occurs as many as ref _RCR_+1 Timeout interrupt is issued (@ref Sn_IR_TIMEOUT = '1'). +*/ +#define _RCR_ (_W5300_IO_BASE_ + 0x1E) + +/** + @ingroup Common_register_group_W5300 + @brief TX memory size of \c SOCKET 0 & 1 + @details TMS01R configures the TX buffer block size of \c SOCKET 0 & 1. The default value is configured with 8KB and can be configure from 0 to 64KB with unit 1KB. + But the sum of all SOCKET TX buffer size should be multiple of 8 and the sum of all SOCKET TX and RX memory size can't exceed 128KB. + When exceeded nor multiple of 8, the data transmittion is invalid. +*/ +#define TMS01R (_W5300_IO_BASE_ + 0x20) + +/** + @ingroup Common_register_group_W5300 + @brief TX memory size of \c SOCKET 2 & 3 + @details refer to \ref TMS01R +*/ +#define TMS23R (TMS01R + 2) + +/** + @ingroup Common_register_group_W5300 + @brief TX memory size of \c SOCKET 4 & 5 + @details refer to \ref TMS01R +*/ +#define TMS45R (TMS01R + 4) + +/** + @ingroup Common_register_group_W5300 + @brief TX memory size of \c SOCKET 6 & 7 + @details refer to \ref TMS01R +*/ +#define TMS67R (TMS01R + 6) + +/** + @ingroup Common_register_group_W5300 + @brief TX memory size of \c SOCKET 0. + @details refer to \ref TMS01R +*/ +#define TMSR0 TMS01R + +/** + @ingroup Common_register_group_W5300 + @brief TX memory size of \c SOCKET 1. + @details refer to \ref TMS01R +*/ +#define TMSR1 (TMSR0 + 1) + +/** + @ingroup Common_register_group_W5300 + @brief TX memory size of \c SOCKET 2. + @details refer to \ref TMS01R +*/ +#define TMSR2 (TMSR0 + 2) + +/** + @ingroup Common_register_group_W5300 + @brief TX memory size of \c SOCKET 3. + @details refer to \ref TMS01R +*/ +#define TMSR3 (TMSR0 + 3) + +/** + @ingroup Common_register_group_W5300 + @brief TX memory size of \c SOCKET 4. + @details refer to \ref TMS01R +*/ +#define TMSR4 (TMSR0 + 4) + +/** + @ingroup Common_register_group_W5300 + @brief TX memory size of \c SOCKET 5. + @details refer to \ref TMS01R +*/ +#define TMSR5 (TMSR0 + 5) + +/** + @ingroup Common_register_group_W5300 + @brief TX memory size of \c SOCKET 6. + @details refer to \ref TMS01R +*/ +#define TMSR6 (TMSR0 + 6) + +/** + @ingroup Common_register_group_W5300 + @brief TX memory size of \c SOCKET 7. + @details refer to \ref TMS01R +*/ +#define TMSR7 (TMSR0 + 7) + + +/** + @ingroup Common_register_group_W5300 + @brief RX memory size of \c SOCKET 0 & 1 + @details RMS01R configures the RX buffer block size of \c SOCKET 0 & 1. The default value is configured with 8KB and can be configure from 0 to 64KB with unit 1KB. + But the sum of all SOCKET RX buffer size should be multiple of 8 and the sum of all SOCKET RX and TX memory size can't exceed 128KB. + When exceeded nor multiple of 8, the data reception is invalid. +*/ +#define RMS01R (_W5300_IO_BASE_ + 0x28) + +/** + @ingroup Common_register_group_W5300 + @brief RX memory size of \c SOCKET 2 & 3 + @details Refer to \ref RMS01R +*/ +#define RMS23R (RMS01R + 2) + +/** + @ingroup Common_register_group_W5300 + @brief RX memory size of \c SOCKET 4 & 5 + @details Refer to \ref RMS01R +*/ +#define RMS45R (RMS01R + 4) + +/** + @ingroup Common_register_group_W5300 + @brief RX memory size of \c SOCKET 6 & 7 + @details Refer to \ref RMS01R +*/ +#define RMS67R (RMS01R + 6) + +/** + @ingroup Common_register_group_W5300 + @brief RX memory size of \c SOCKET 0. + @details refer to \ref RMS01R +*/ +#define RMSR0 RMS01R + +/** + @ingroup Common_register_group_W5300 + @brief RX memory size of \c SOCKET 1. + @details refer to \ref RMS01R +*/ +#define RMSR1 (RMSR0 + 1) + +/** + @ingroup Common_register_group_5300 + @brief RX memory size of \c SOCKET 2. + @details refer to \ref RMS01R +*/ +#define RMSR2 (RMSR0 + 2) + +/** + @ingroup Common_register_group_W5300 + @brief RX memory size of \c SOCKET 3. + @details refer to \ref RMS01R +*/ +#define RMSR3 (RMSR0 + 3) + +/** + @ingroup Common_register_group_W5300 + @brief RX memory size of \c SOCKET 4. + @details refer to \ref RMS01R +*/ +#define RMSR4 (RMSR0 + 4) + +/** + @ingroup Common_register_group_W5300 + @brief RX memory size of \c SOCKET 5. + @details refer to \ref RMS01R +*/ +#define RMSR5 (RMSR0 + 5) + +/** + @ingroup Common_register_group_W5300 + @brief RX memory size of \c SOCKET 6. + @details refer to \ref RMS01R +*/ +#define RMSR6 (RMSR0 + 6) + +/** + @ingroup Common_register_group_W5300 + @brief RX memory size of \c SOCKET 7. + @details refer to \ref RMS01R +*/ +#define RMSR7 (RMSR0 + 7) + + + +/** + @ingroup Common_register_group_W5300 + @brief Memory Type Register + @details W5300’s 128Kbytes data memory (Internal TX/RX memory) is composed of 16 memory blocks + of 8Kbytes. MTYPER configures type of each 8KB memory block in order to select RX or TX memory. + The type of 8KB memory block corresponds to each bit of MTYPER. When the bit is ‘1’, it is used as TX + memory, and the bit is ‘0’, it is used as RX memory. MTYPER is configured as TX memory type + from the lower bit. The rest of the bits not configured as TX memory, should be set as ‘0’. +*/ +#define MTYPER (_W5300_IO_BASE_ + 0x30) + +/** + @ingroup Common_register_group_W5300 + @brief PPPoE Authentication Type register + @details It notifies authentication method negotiated with PPPoE server. + W5300 supports 2 types of authentication methods. + - PAP : 0xC023 + - CHAP : 0xC223 +*/ +#define PATR (_W5300_IO_BASE_ + 0x32) + +//#define PPPALGOR (_W5300_IO_BASE_ + 0x34) + +/** + @ingroup Common_register_group_W5300 + @brief PPP Link Control Protocol Request Timer Register + @details It configures transmitting timer of link control protocol (LCP) echo request. Value 1 is about 25ms. +*/ +#define PTIMER (_W5300_IO_BASE_ + 0x36) + +/** + @ingroup Common_register_group_W5300 + @brief PPP LCP magic number register + @details It configures byte value to be used for 4bytes “Magic Number” during LCP negotiation with PPPoE server. +*/ +#define PMAGICR (_W5300_IO_BASE_ + 0x38) + +//#define PSTATER (_W5300_IO_BASE_ + 0x3A) + +/** + @ingroup Common_register_group_W5300 + @brief PPPoE session ID register + @details It notifies PPP session ID to be used for communication with PPPoE server (acquired by PPPoE-process of W5300). +*/ +#define PSIDR (_W5300_IO_BASE_ + 0x3C) + +/** + @ingroup Common_register_group_W5300 + @brief PPPoE destination hardware address register + @details It notifies hardware address of PPPoE server (acquired by PPPoE-process of W5300). +*/ +#define PDHAR (_W5300_IO_BASE_ + 0x40) + +/** + @ingroup Common_register_group_W5300 + @brief Unreachable IP address register + @details When trying to transmit UDP data to destination port number which is not open, + W5300 can receive ICMP (Destination port unreachable) packet. \n + In this case, \ref IR_DPUR bit of \ref IR becomes '1'. + And destination IP address and unreachable port number of ICMP packet can be acquired through UIPR and \ref UPORTR. +*/ +#define UIPR (_W5300_IO_BASE_ + 0x48) + +/** + @ingroup Common_register_group_W5300 + @brief Unreachable port number register + @details Refer to \ref UIPR. +*/ +#define UPORTR (_W5300_IO_BASE_ + 0x4C) + +/** + @ingroup Common_register_group_W5300 + @brief Fragment MTU register + @details When communicating with the peer having a different MTU, W5300 can receive an ICMP(Fragment MTU) packet. + At this case, IR(FMTU) becomes ‘1’ and destination IP address and fragment MTU value of ICMP packet can be acquired through UIPR and FMTUR. + In order to keep communicating with the peer having Fragment MTU, set the FMTUR first in Sn_MSSR of the SOCKETn, and try the next communication. +*/ +#define FMTUR (_W5300_IO_BASE_ + 0x4E) + +//#define Sn_RTCR(n) (_W5300_IO_BASE_ + 0x50 + n*2) + +/** + @ingroup Common_register_group_W5300 + @brief PIN 'BRDYn' configure register + @details It configures the PIN "BRDYn" which is monitoring TX/RX memory status of the specified SOCKET. + If the free buffer size of TX memory is same or bigger than the buffer depth of \ref Pn_BDPTHR, + or received buffer size of RX memory is same or bigger than the \ref Pn_BDPTHR, + PIN "BRDYn" is signaled. + + + + + +
    15 14 13 12 11 10 9 8
    Reserved, Read as 0
    7 6 5 4 3 2 1 0
    PEN MT PPL Reserved SN
    + + - \ref Pn_PEN Enable PIN 'BRDYn' (0 : Disable, 1 : Enable) + - \ref Pn_MT Monitoring Memory type (0 : RX memory, 1 : TX Memory) + - \ref Pn_PPL PIN Polarity bit of Pn_BRDYR. (0 : Low sensitive, 1 : High sensitive) + - \ref Pn_SN(n) Monitoring SOCKET number of Pn_BRDYR +*/ +#define Pn_BRDYR(n) (_W5300_IO_BASE_ + 0x60 + n*4) + +/** + @ingroup Common_register_group_W5300 + @brief PIN 'BRDYn' buffer depth Register + @details It configures buffer depth of PIN "BRDYn". + When monitoring TX memory and \ref Sn_TX_FSR is same or bigger than Pn_BDPTHR, the PIN "BRDYn" is signaled. + When monitoring RX memory and if \ref Sn_RX_RSR is same or bigger than Pn_BDPTHR, PIN "BRDYn" is signaled. + The value for Pn_BDPTHR can't exceed TX/RX memory size allocated by TMSR or RMSR such like as \ref TMS01R or \ref RMS01R. +*/ +#define Pn_BDPTHR(n) (_W5300_IO_BASE_ + 0x60 + n*4 + 2) + +/** + @ingroup Common_register_group_W5300 + @brief W5300 identification register. + @details Read Only. 0x5300. +*/ +#define IDR (_W5300_IO_BASE_ + 0xFE) +#define VERSIONR IDR + + +//----------------------------- W5300 SOCKET Registers ----------------------------- + +/** + @ingroup Socket_register_group_W5300 + @brief Socket Mode register(R/W) + @details @ref Sn_MR configures the option or protocol type of Socket n.\n\n + Each bit of @ref Sn_MR defined as the following. + + + + + +
    15 14 13 12 11 10 9 8
    Reserved. Read as 0 ALIGN
    7 6 5 4 3 2 1 0
    MULTI MF ND/IGMPv Reserved PROTOCOL[3:0]
    + - @ref Sn_MR_ALIGN : Alignment bit of Sn_MR, Only valid in \ref Sn_MR_TCP. (C0 : Include TCP PACK_INFO, 1 : Not include TCP PACK_INFO) + - @ref Sn_MR_MULTI : Support UDP Multicasting + - @ref Sn_MR_MF : Enable MAC Filter (0 : Disable, 1 - Enable), When enabled, W5300 can receive only both own and broadcast packet. + - @ref Sn_MR_ND : No Delayed Ack(TCP) flag + - @ref Sn_MR_IGMPv : IGMP version used in UDP mulitcasting. (0 : Version 2, 1 : Version 2) + - PROTOCOL[3:0] + + + + + + + + +
    Protocol[3] Protocol[2] Protocol[1] Protocol[0] @b Meaning
    0 0 0 0 Closed
    0 0 0 1 TCP
    0 0 1 0 UDP
    0 0 1 1 IPCRAW
    0 1 0 0 MACRAW
    0 1 0 1 PPPoE
    + + - @ref Sn_MR_PPPoE : PPPoE + - @ref Sn_MR_MACRAW : MAC LAYER RAW SOCK + - @ref Sn_MR_IPRAW : IP LAYER RAW SOCK + - @ref Sn_MR_UDP : UDP + - @ref Sn_MR_TCP : TCP + - @ref Sn_MR_CLOSE : Unused socket + @note MACRAW mode should be only used in Socket 0. +*/ +#define Sn_MR(n) (_W5300_IO_BASE_ + WIZCHIP_SREG_BLOCK(n) + 0x00) + +/** + @ingroup Socket_register_group_W5300 + @brief Socket command register(R/W) + @details This is used to set the command for Socket n such as OPEN, CLOSE, CONNECT, LISTEN, SEND, and RECEIVE.\n + After W5500 accepts the command, the @ref Sn_CR register is automatically cleared to 0x00. + Even though @ref Sn_CR is cleared to 0x00, the command is still being processed.\n + To check whether the command is completed or not, please check the @ref Sn_IR or @ref Sn_SR. + - @ref Sn_CR_OPEN : Initialize or open socket. + - @ref Sn_CR_LISTEN : Wait connection request in TCP mode(Server mode) + - @ref Sn_CR_CONNECT : Send connection request in TCP mode(Client mode) + - @ref Sn_CR_DISCON : Send closing request in TCP mode. + - @ref Sn_CR_CLOSE : Close socket. + - @ref Sn_CR_SEND : Update TX buffer pointer and send data. + - @ref Sn_CR_SEND_MAC : Send data with MAC address, so without ARP process. + - @ref Sn_CR_SEND_KEEP : Send keep alive message. + - @ref Sn_CR_RECV : Update RX buffer pointer and receive data. + - @ref Sn_CR_PCON : PPPoE connection begins by transmitting PPPoE discovery packet. + - @ref Sn_CR_PDISCON : Closes PPPoE connection. + - @ref Sn_CR_PCR : In each phase, it transmits REQ message. + - @ref Sn_CR_PCN : In each phase, it transmits NAK message. + - @ref Sn_CR_PCJ : In each phase, it transmits REJECT message. +*/ +#define Sn_CR(n) (_W5300_IO_BASE_ + WIZCHIP_SREG_BLOCK(n) + 0x02) + +/** + @ingroup Socket_register_group_W5300 + @brief socket interrupt mask register(R) + @details @ref Sn_IMR masks the interrupt of Socket n. + Each bit corresponds to each bit of @ref Sn_IR. When a Socket n Interrupt is occurred and the corresponding bit of @ref Sn_IMR is + the corresponding bit of @ref Sn_IR becomes When both the corresponding bit of @ref Sn_IMR and @ref Sn_IR are and the n-th bit of @ref IR is + Host is interrupted by asserted INTn PIN to low. +*/ +#define Sn_IMR(n) (_W5300_IO_BASE_ + WIZCHIP_SREG_BLOCK(n) + 0x04) + +/** + @ingroup Socket_register_group_W5300 + @brief Socket interrupt register(R) + @details @ref Sn_IR indicates the status of Socket Interrupt such as establishment, termination, receiving data, timeout).\n + When an interrupt occurs and the corresponding bit of @ref Sn_IMR is the corresponding bit of @ref Sn_IR becomes \n + In order to clear the @ref Sn_IR bit, the host should write the bit to \n + + + + + +
    15 14 13 12 11 10 9 8
    Reserved. Read as 0
    7 6 5 4 3 2 1 0
    PRECV PFAIL PNEXT SENDOK TIMEOUT RECV DISCON CON
    + - \ref Sn_IR_PRECV : PPP receive + - \ref Sn_IR_PFAIL : PPP fail + - \ref Sn_IR_PNEXT : PPP next phase + - \ref Sn_IR_SENDOK : SENDOK + - \ref Sn_IR_TIMEOUT : TIMEOUT + - \ref Sn_IR_RECV : RECV + - \ref Sn_IR_DISCON : DISCON + - \ref Sn_IR_CON : CON +*/ +#define Sn_IR(n) (_W5300_IO_BASE_ + WIZCHIP_SREG_BLOCK(n) + 0x06) + +/** + @ingroup Socket_register_group_W5300 + @brief Socket status register(R) + @details @ref Sn_SSR indicates the status of Socket n.\n + The status of Socket n is changed by @ref Sn_CR or some special control packet as SYN, FIN packet in TCP. + @par Normal status + - @ref SOCK_CLOSED : Closed + - @ref SOCK_INIT : Initiate state + - @ref SOCK_LISTEN : Listen state + - @ref SOCK_ESTABLISHED : Success to connect + - @ref SOCK_CLOSE_WAIT : Closing state + - @ref SOCK_UDP : UDP socket + - @ref SOCK_IPRAW : IPRAW socket + - @ref SOCK_MACRAW : MAC raw mode socket + - @ref SOCK_PPPoE : PPPoE mode Socket + @par Temporary status during changing the status of Socket n. + - @ref SOCK_SYNSENT : This indicates Socket n sent the connect-request packet (SYN packet) to a peer. + - @ref SOCK_SYNRECV : It indicates Socket n successfully received the connect-request packet (SYN packet) from a peer. + - @ref SOCK_FIN_WAIT : Connection state + - @ref SOCK_CLOSING : Closing state + - @ref SOCK_TIME_WAIT : Closing state + - @ref SOCK_LAST_ACK : Closing state + - @ref SOCK_ARP : ARP request state +*/ +#define Sn_SSR(n) (_W5300_IO_BASE_ + WIZCHIP_SREG_BLOCK(n) + 0x08) +#define Sn_SR(n) Sn_SSR(n) ///< For Compatible ioLibrary. Refer to @ref Sn_SSR(n) + +/** + @ingroup Socket_register_group_W5300 + @brief source port register(R/W) + @details @ref Sn_PORTR configures the source port number of Socket n. + It is valid when Socket n is used in TCP/UPD mode. It should be set before OPEN command is ordered. +*/ +#define Sn_PORTR(n) (_W5300_IO_BASE_ + WIZCHIP_SREG_BLOCK(n) + 0x0A) +#define Sn_PORT(n) Sn_PORTR(n) ///< For compatible ioLibrary. Refer to @ref Sn_PORTR(n). + +/** + @ingroup Socket_register_group_W5300 + @brief Peer MAC register address(R/W) + @details @ref Sn_DHAR configures the destination hardware address of Socket n when using SEND_MAC command in UDP mode or + it indicates that it is acquired in ARP-process by CONNECT/SEND command. +*/ +#define Sn_DHAR(n) (_W5300_IO_BASE_ + WIZCHIP_SREG_BLOCK(n) + 0x0C) + +/** + @ingroup Socket_register_group_W5300 + @brief Peer port register address(R/W) + @details @ref Sn_DPORTR configures or indicates the destination port number of Socket n. It is valid when Socket n is used in TCP/UDP mode. + In TCP clientmode, it configures the listen port number of TCP serverbefore CONNECT command. + In TCP Servermode, it indicates the port number of TCP client after successfully establishing connection. + In UDP mode, it configures the port number of peer to be transmitted the UDP packet by SEND/SEND_MAC command. +*/ +#define Sn_DPORTR(n) (_W5300_IO_BASE_ + WIZCHIP_SREG_BLOCK(n) + 0x12) +#define Sn_DPORT(n) Sn_DPORTR(n) ///< For compatible ioLibrary. Refer to \ref Sn_DPORTR. + + +/** + @ingroup Socket_register_group_W5300 + @brief Peer IP register address(R/W) + @details @ref Sn_DIPR configures or indicates the destination IP address of Socket n. It is valid when Socket n is used in TCP/UDP mode. + In TCP client mode, it configures an IP address of TCP serverbefore CONNECT command. + In TCP server mode, it indicates an IP address of TCP clientafter successfully establishing connection. + In UDP mode, it configures an IP address of peer to be received the UDP packet by SEND or SEND_MAC command. +*/ +#define Sn_DIPR(n) (_W5300_IO_BASE_ + WIZCHIP_SREG_BLOCK(n) + 0x14) + +/** + @ingroup Socket_register_group_W5300 + @brief Maximum Segment Size(Sn_MSSR0) register address(R/W) + @details @ref Sn_MSSR configures or indicates the MTU(Maximum Transfer Unit) of Socket n. +*/ +#define Sn_MSSR(n) (_W5300_IO_BASE_ + WIZCHIP_SREG_BLOCK(n) + 0x18) + +/** + @ingroup Socket_register_group_W5300 + @brief Keep Alive Timer register(R/W) + @details @ref Sn_KPALVTR configures the transmitting timer of KEEP ALIVE(KA)packet of SOCKETn. It is valid only in TCP mode, + and ignored in other modes. The time unit is 5s. + KA packet is transmittable after @ref Sn_SR is changed to SOCK_ESTABLISHED and after the data is transmitted or received to/from a peer at least once. + In case of '@ref Sn_KPALVTR > 0', W5500 automatically transmits KA packet after time-period for checking the TCP connection (Auto-keepalive-process). + In case of '@ref Sn_KPALVTR = 0', Auto-keep-alive-process will not operate, + and KA packet can be transmitted by SEND_KEEP command by the host (Manual-keep-alive-process). + Manual-keep-alive-process is ignored in case of '@ref Sn_KPALVTR > 0'. +*/ +#define Sn_KPALVTR(n) (_W5300_IO_BASE_ + WIZCHIP_SREG_BLOCK(n) + 0x1A) + +/** + @ingroup Socket_register_group_W5300 + @brief IP Protocol(PROTO) Register(R/W) + @details \ref Sn_PROTO that sets the protocol number field of the IP header at the IP layer. It is + valid only in IPRAW mode, and ignored in other modes. +*/ +#define Sn_PROTOR(n) Sn_KPALVTR(n) + + +/** + @ingroup Socket_register_group_W5300 + @brief IP Type of Service(TOS) Register(R/W) + @details @ref Sn_TOSR configures the TOS(Type Of Service field in IP Header) of Socket n. + It is set before OPEN command. +*/ +#define Sn_TOSR(n) (_W5300_IO_BASE_ + WIZCHIP_SREG_BLOCK(n) + 0x1C) +#define Sn_TOS(n) Sn_TOSR(n) ///< For compatible ioLibrary. Refer to Sn_TOSR + +/** + @ingroup Socket_register_group_W5300 + @brief IP Time to live(TTL) Register(R/W) + @details @ref Sn_TTLR configures the TTL(Time To Live field in IP header) of Socket n. + It is set before OPEN command. +*/ +#define Sn_TTLR(n) (_W5300_IO_BASE_ + WIZCHIP_SREG_BLOCK(n) + 0x1E) +#define Sn_TTL(n) Sn_TTLR(n) ///< For compatible ioLibrary. Refer to Sn_TTLR + +/** + @ingroup Socket_register_group_W5300 + @brief SOCKETn TX write size register(R/W) + @details It sets the byte size of the data written in internal TX memory through @ref Sn_TX_FIFOR. + It is set before SEND or SEND_MAC command, and can't be bigger than internal TX memory + size set by TMSR such as @ref TMS01R, TMS23R and etc. +*/ +#define Sn_TX_WRSR(n) (_W5300_IO_BASE_ + WIZCHIP_SREG_BLOCK(n) + 0x20) + +/** + @ingroup Socket_register_group_W5300 + @brief Transmit free memory size register(R) + @details Sn_TX_FSR indicates the free size of Socket n TX Buffer Block. It is initialized to the configured size by TMSR such as @ref TMS01SR. + Data bigger than Sn_TX_FSR should not be saved in the Socket n TX Buffer because the bigger data overwrites the previous saved data not yet sent. + Therefore, check before saving the data to the Socket n TX Buffer, and if data is equal or smaller than its checked size, + transmit the data with SEND/SEND_MAC command after saving the data in Socket n TX buffer. But, if data is bigger than its checked size, + transmit the data after dividing into the checked size and saving in the Socket n TX buffer. +*/ +#define Sn_TX_FSR(n) (_W5300_IO_BASE_ + WIZCHIP_SREG_BLOCK(n) + 0x0024) + +/** + @ingroup Socket_register_group_w5300 + @brief Received data size register(R) + @details @ref Sn_RX_RSR indicates the data size received and saved in Socket n RX Buffer. + @ref Sn_RX_RSR does not exceed the RMSR such as @ref RMS01SR and is calculated as the difference between + ?Socket n RX Write Pointer (@ref Sn_RX_WR)and Socket n RX Read Pointer (@ref Sn_RX_RD) +*/ +#define Sn_RX_RSR(n) (_W5300_IO_BASE_ + WIZCHIP_SREG_BLOCK(n) + 0x0028) + +/** + @ingroup Socket_register_group_W5300 + @brief Fragment field value in IP header register(R/W) + @details @ref Sn_FRAGR configures the FRAG(Fragment field in IP header). +*/ +#define Sn_FRAGR(n) (_W5300_IO_BASE_ + WIZCHIP_SREG_BLOCK(n) + 0x002C) +#define Sn_FRAG(n) Sn_FRAGR(n) + +/** + @ingroup Socket_register_group_W5300 + @brief SOCKET n TX FIFO regsiter + @details It indirectly accesses internal TX memory of SOCKETn. + The internal TX memory can't be accessed directly by the host, but can be accessed through Sn_TX_FIFOR. + If @ref MR(MT) = '0', only the Host-Write of internal TX memory is allowed through Sn_TX_FIFOR. + But if @ref MR(MT) is '1', both of Host-Read and Host-Write are allowed. +*/ +#define Sn_TX_FIFOR(n) (_W5300_IO_BASE_ + WIZCHIP_SREG_BLOCK(n) + 0x2E) + +/** + @ingroup Socket_register_group_W5300 + @brief SOCKET n RX FIFO register + @details It indirectly accesses to internal RX memory of SOCKETn. + The internal RX memory can't be directly accessed by the host, but can be accessed through Sn_RX_FIFOR. + If MR(MT) = '0', only the Host-Read of internal RX memory is allowed through Sn_RX_FIFOR. + But if MR(MT) is '1', both of Host-Read and Host-Write are allowed. +*/ +#define Sn_RX_FIFOR(n) (_W5300_IO_BASE_ + WIZCHIP_SREG_BLOCK(n) + 0x30) + +//#define Sn_TX_SADR(n) (_W5300_IO_BASE_ + WIZCHIP_SREG_BLOCK(n) + 0x32) + +//#define Sn_RX_SADR(n) (_W5300_IO_BASE_ + WIZCHIP_SREG_BLOCK(n) + 0x34) + +//#define Sn_TX_RD(n) (_W5300_IO_BASE_ + WIZCHIP_SREG_BLOCK(n) + 0x36) + +//#define Sn_TX_WR(n) (_W5300_IO_BASE_ + WIZCHIP_SREG_BLOCK(n) + 0x38) + +//#define Sn_TX_ACK(n) (_W5300_IO_BASE_ + WIZCHIP_SREG_BLOCK(n) + 0x3A) + +//#define Sn_RX_RD(n) (_W5300_IO_BASE_ + WIZCHIP_SREG_BLOCK(n) + 0x3C) + +//#define Sn_RX_WR(n) (_W5300_IO_BASE_ + WIZCHIP_SREG_BLOCK(n) + 0x3E) + + +/************************************/ +/* The bit of MR regsiter defintion */ +/************************************/ +#define MR_DBW (1 << 15) /**< Data bus width bit of \ref MR. Read Only. (0 : 8Bit, 1 : 16Bit)*/ +#define MR_MPF (1 << 14) /**< Mac layer pause frame bit of \ref MR. (0 : Disable, 1 : Enable)*/ +#define MR_WDF(X) ((X & 0x07) << 11) /**< Write data fetch time bit of \ref MR. Fetch Data from DATA bus after PLL_CLK * MR_WDF[2:0]*/ +#define MR_RDH (1 << 10) /**< Read data hold time bit of \ref MR. Hold Data on DATA bus during 2 * PLL_CLK after CS high*/ +#define MR_FS (1 << 8) /**< FIFO swap bit of \ref MR. Swap MSB & LSB of \ref Sn_TX_FIFOR & Sn_RX_FIFOR (0 : No swap, 1 : Swap) */ +#define MR_RST (1 << 7) /**< S/W reset bit of \ref MR. (0 : Normal Operation, 1 : Reset (automatically clear after reset))*/ +#define MR_MT (1 << 5) /**< Memory test bit of \ref MR. (0 : Normal, 1 : Internal Socket memory write & read Test)*/ +#define MR_PB (1 << 4) /**< Ping block bit of \ref MR. (0 : Unblock, 1 : Block)*/ +#define MR_PPPoE (1 << 3) /**< PPPoE bit of \ref MR. (0 : No use PPPoE, 1: Use PPPoE)*/ +#define MR_DBS (1 << 2) /**< Data bus swap of \ref MR. Valid only 16bit mode (0 : No swap, 1 : Swap)*/ +#define MR_IND (1 << 0) /**< Indirect mode bit of \ref MR. (0 : Direct mode, 1 : Indirect mode) */ + + +/************************************/ +/* The bit of IR regsiter definition */ +/************************************/ +#define IR_IPCF (1 << 7) /**< IP conflict bit of \ref IR. To clear, Write the bit to '1'. */ +#define IR_DPUR (1 << 6) /**< Destination port unreachable bit of \ref IR. To clear, Write the bit to '1'. */ +#define IR_PPPT (1 << 5) /**< PPPoE terminate bit of \ref IR. To clear, Write the bit to '1'. */ +#define IR_FMTU (1 << 4) /**< Fragment MTU bit of IR. To clear, Write the bit to '1'. */ +#define IR_SnINT(n) (0x01 << n) /**< SOCKETn interrupt occurrence bit of \ref IR. To clear, Clear \ref Sn_IR*/ + +/*****************************************/ +/* The bit of Pn_BRDYR regsiter definition*/ +/*****************************************/ +#define Pn_PEN (1 << 7) /**< PIN 'BRDYn' enable bit of Pn_BRDYR. */ +#define Pn_MT (1 << 6) /**< PIN memory type bit of Pn_BRDYR. */ +#define Pn_PPL (1 << 5) /**< PIN Polarity bit of Pn_BRDYR. */ +#define Pn_SN(n) ((n & 0x07) << 0) /**< What socket to monitor. */ + + +/***************************************/ +/* The bit of Sn_MR regsiter definition */ +/***************************************/ +/** + @brief Alignment bit of \ref Sn_MR. + @details It is valid only in the TCP (\ref Sn_MR_TCP) with TCP communication, + when every the received DATA packet size is of even number and set as '1', + data receiving performance can be improved by removing PACKET-INFO(data size) that is attached to every the received DATA packet. +*/ +#define Sn_MR_ALIGN (1 << 8) + +/** + @brief Multicasting bit of \ref Sn_MR + @details It is valid only in UDP (\ref Sn_MR_UDP). + In order to implement multicasting, set the IP address and port number in @ref Sn_DIPR and @ref Sn_DPORTR respectively before "OPEN" command(@ref Sn_CR_OPEN).\n + 0 : Disable, 1 : Enable +*/ +#define Sn_MR_MULTI (1 << 7) + +/** + @brief MAC filter bit of \ref Sn_MR + @details It is valid in MACRAW(@ref Sn_MR_MACRAW). + When this bit is set as ‘1’, W5300 can receive packet that is belong in itself or broadcasting. + When this bit is set as ‘0’, W5300 can receive all packets on Ethernet. + When using the hybrid TCP/IP stack, it is recommended to be set as ‘1’ for reducing the receiving overhead of host. \n + 0 : Disable, 1 : Enable +*/ +#define Sn_MR_MF (1 << 6) + +/** + @brief IGMP version bit of \ref Sn_MR + details It is valid in case of @ref Sn_MR_MULTI='1' and UDP(@ref Sn_MR_UDP). + It configures IGMP version to send IGMP message such as Join/Leave/Report to multicast-group. \n + 0 : IGMPv2, 1 : IGMPv1 +*/ +#define Sn_MR_IGMPv (1 << 5) +#define Sn_MR_MC Sn_MR_IGMPv ///< For compatible ioLibrary + +/** + @brief No delayed ack bit of \ref Sn_MR + @details It is valid in TCP(@ref Sn_MR_TCP). + In case that it is set as '1', ACK packet is transmitted right after receiving DATA packet from the peer. + It is recommended to be set as '1' for TCP performance improvement. + In case that it is set as '0', ACK packet is transmitted after the time set in @ref _RTR_ regardless of DATA packet receipt.\n + 0 : No use, 1 : Use +*/ +#define Sn_MR_ND (1 << 5) + +/** + @brief No mode + @details This configures the protocol mode of Socket n. + @sa Sn_MR +*/ +#define Sn_MR_CLOSE 0x00 + +/** + @brief TCP mode + @details This configures the protocol mode of Socket n. + @sa Sn_MR +*/ +#define Sn_MR_TCP 0x01 + +/** + @brief UDP mode + @details This configures the protocol mode of Socket n. + @sa Sn_MR +*/ +#define Sn_MR_UDP 0x02 /**< Protocol bits of \ref Sn_MR. */ + +/** + @brief IP LAYER RAW mode + @details This configures the protocol mode of Socket n. + @sa Sn_MR +*/ +#define Sn_MR_IPRAW 0x03 /**< Protocol bits of \ref Sn_MR. */ + +/** + @brief MAC LAYER RAW mode + @details This configures the protocol mode of Socket 0. + @sa Sn_MR + @note MACRAW mode should be only used in Socket 0. +*/ +#define Sn_MR_MACRAW 0x04 + +/** + @brief PPPoE mode + @details This configures the protocol mode of Socket 0. + @sa Sn_MR + @note PPPoE mode should be only used in Socket 0. +*/ +#define Sn_MR_PPPoE 0x05 /**< Protocol bits of \ref Sn_MR. */ + +#define SOCK_STREAM Sn_MR_TCP /**< For Berkeley Socket API, Refer to @ref Sn_MR_TCP */ +#define SOCK_DGRAM Sn_MR_UDP /**< For Berkeley Socket API, Refer to @ref Sn_MR_UDP */ + + + +/******************************/ +/* The values of CR definition */ +/******************************/ +/** + @brief Initialize or open a socket + @details Socket n is initialized and opened according to the protocol selected in Sn_MR(P3:P0). + The table below shows the value of @ref Sn_SR corresponding to @ref Sn_MR.\n + + + + + + + + +
    \b Sn_MR (P[3:0]) \b Sn_SR
    Sn_MR_CLOSE (000)
    Sn_MR_TCP (001) SOCK_INIT (0x13)
    Sn_MR_UDP (010) SOCK_UDP (0x22)
    Sn_MR_IPRAW (010) SOCK_IPRAW (0x32)
    Sn_MR_MACRAW (100) SOCK_MACRAW (0x42)
    Sn_MR_PPPoE (101) SOCK_PPPoE (0x5F)
    +*/ +#define Sn_CR_OPEN 0x01 + +/** + @brief Wait connection request in TCP mode(Server mode) + @details This is valid only in TCP mode (\ref Sn_MR(P3:P0) = \ref Sn_MR_TCP). + In this mode, Socket n operates as a TCP serverand waits for connection-request (SYN packet) from any TCP client + The @ref Sn_SR changes the state from \ref SOCK_INIT to \ref SOCKET_LISTEN. + When a TCP clientconnection request is successfully established, + the @ref Sn_SR changes from SOCK_LISTEN to SOCK_ESTABLISHED and the @ref Sn_IR(0) becomes + But when a TCP clientconnection request is failed, @ref Sn_IR(3) becomes and the status of @ref Sn_SR changes to SOCK_CLOSED. +*/ +#define Sn_CR_LISTEN 0x02 + +/** + @brief Send connection request in TCP mode(Client mode) + @details To connect, a connect-request (SYN packet) is sent to TCP serverconfigured by @ref Sn_DIPR & Sn_DPORT(destination address & port). + If the connect-request is successful, the @ref Sn_SR is changed to @ref SOCK_ESTABLISHED and the Sn_IR(0) becomes \n\n + The connect-request fails in the following three cases.\n + 1. When a @b ARPTO occurs (@ref Sn_IR[3] = '1') because destination hardware address is not acquired through the ARP-process.\n + 2. When a @b SYN/ACK packet is not received and @b TCPTO (Sn_IR(3) = )\n + 3. When a @b RST packet is received instead of a @b SYN/ACK packet. In these cases, @ref Sn_SR is changed to @ref SOCK_CLOSED. + @note This is valid only in TCP mode and operates when Socket n acts as TCP client +*/ +#define Sn_CR_CONNECT 0x04 + +/** + @brief Send closing request in TCP mode + @details Regardless of TCP serveror TCP client the DISCON command processes the disconnect-process (b>Active close    or Passive close.\n + @par Active close + it transmits disconnect-request(FIN packet) to the connected peer\n + @par Passive close + When FIN packet is received from peer, a FIN packet is replied back to the peer.\n + @details When the disconnect-process is successful (that is, FIN/ACK packet is received successfully), @ref Sn_SR is changed to @ref SOCK_CLOSED.\n + Otherwise, @b TCPTO occurs (\ref Sn_IR[3]='1') and then @ref Sn_SR is changed to @ref SOCK_CLOSED. + @note Valid only in TCP mode. +*/ +#define Sn_CR_DISCON 0x08 + +/** + @brief Close socket + @details @ref Sn_SR is changed to @ref SOCK_CLOSED. +*/ +#define Sn_CR_CLOSE 0x10 + +/** + @brief Update TX buffer pointer and send data + @details SEND command transmits all the data in the Socket n TX buffer thru @ref Sn_TX_FIFOR.\n + For more details, please refer to Socket n TX Free Size Register (@ref Sn_TX_FSR) and Socket TX Write Size register (@ref Sn_TX_WRSR). +*/ +#define Sn_CR_SEND 0x20 + +/** + @brief Send data with MAC address, so without ARP process + @details The basic operation is same as SEND.\n + Normally SEND command transmits data after destination hardware address is acquired by the automatic ARP-process(Address Resolution Protocol).\n + But SEND_MAC command transmits data without the automatic ARP-process.\n + In this case, the destination hardware address is acquired from @ref Sn_DHAR configured by host, instead of APR-process. + @note Valid only in UDP mode. +*/ +#define Sn_CR_SEND_MAC 0x21 + +/** + @brief Send keep alive message + @details It checks the connection status by sending 1byte keep-alive packet.\n + If the peer can not respond to the keep-alive packet during timeout time, the connection is terminated and the timeout interrupt will occur. + @note Valid only in TCP mode. +*/ +#define Sn_CR_SEND_KEEP 0x22 + +/** + @brief Update RX buffer pointer and receive data + @details RECV completes the processing of the received data in Socket n RX Buffer thru @ref Sn_RX_FIFOR).\n + For more details, refer to Socket n RX Received Size Register (@ref Sn_RX_RSR) & @ref Sn_RX_FIFOR. +*/ +#define Sn_CR_RECV 0x40 /**< RECV command value of \ref Sn_CR */ + +#define Sn_CR_PCON 0x23 /**< PPPoE connection begins by transmitting PPPoE discovery packet. Refer to \ref Sn_CR */ +#define Sn_CR_PDISCON 0x24 /**< Closes PPPoE connection. Refer to \ref Sn_CR */ +#define Sn_CR_PCR 0x25 /**< In each phase, it transmits REQ message. Refer to \ref Sn_CR */ +#define Sn_CR_PCN 0x26 /**< In each phase, it transmits NAK message. Refer to \ref Sn_CR */ +#define Sn_CR_PCJ 0x27 /**< In each phase, it transmits REJECT message. Refer to \ref Sn_CR */ + + +/*********************************/ +/* The values of Sn_IR definition */ +/*********************************/ +#define Sn_IR_PRECV 0x80 /**< It is set in the case that option data which is not supported is received. Refer to \ref Sn_IR */ +#define Sn_IR_PFAIL 0x40 /**< It is set in the case that PAP authentication is failed. Refer to \ref Sn_IR */ +#define Sn_IR_PNEXT 0x20 /**< It is set in the case that the phase is changed during PPPoE connection process. \ref Sn_IR */ +#define Sn_IR_SENDOK 0x10 /**< It is set when SEND command is completed. Refer to \ref Sn_IR */ +#define Sn_IR_TIMEOUT 0x08 /**< It is set when ARPTO or TCPTO is occured. Refer to \ref Sn_IR */ +#define Sn_IR_RECV 0x04 /**< It is set whenever data is received from a peer. Refer to \ref Sn_IR */ +#define Sn_IR_DISCON 0x02 /**< It is set when FIN or FIN/ACK packet is received from a peer. Refer to \ref Sn_IR */ +#define Sn_IR_CON 0x01 /**< It is set one time when the connection is successful and then @ref Sn_SR is changed to @ref SOCK_ESTABLISHED. */ + +/**********************************/ +/* The values of Sn_SSR definition */ +/**********************************/ +/** + @brief The state of SOCKET intialized or closed + @details This indicates that Socket n is released.\n + When DICON, CLOSE command is ordered, or when a timeout occurs, it is changed to @ref SOCK_CLOSED regardless of previous status. +*/ +#define SOCK_CLOSED 0x00 + +/** + @brief The state of ARP process + @details It is temporary state for getting a peer MAC address when TCP connect or UDP Data Send\n + When DICON, CLOSE command is ordered, or when a timeout occurs, it is changed to @ref SOCK_CLOSED regardless of previous status. +*/ +#define SOCK_ARP 0x01 /**< ARP-request is transmitted in order to acquire destination hardware address. */ + +/** + @brief Initiate state in TCP. + @details This indicates Socket n is opened with TCP mode.\n + It is changed to @ref SOCK_INIT when \ref Sn_MR(P[3:0]) = '001' and OPEN command(\ref Sn_CR_OPEN) is ordered.\n + After SOCK_INIT, user can use LISTEN(@ref Sn_CR_LISTEN)/CONNECT(@ref Sn_CR_CONNET) command. +*/ +#define SOCK_INIT 0x13 + +/** + @brief Listen state + @details This indicates Socket n is operating as TCP servermode and waiting for connection-request (SYN packet) from a peer TCP client.\n + It will change to @ref SOCK_ESTALBLISHED when the connection-request is successfully accepted.\n + Otherwise it will change to @ref SOCK_CLOSED after TCPTO (@ref Sn_IR_TIMEOUT = '1') is occurred. +*/ +#define SOCK_LISTEN 0x14 + +/** + @brief Connection state + @details This indicates Socket n sent the connect-request packet (SYN packet) to a peer.\n + It is temporarily shown when @ref Sn_SR is changed from @ref SOCK_INIT to @ref SOCK_ESTABLISHED by @ref Sn_CR_CONNECT command.\n + If connect-accept(SYN/ACK packet) is received from the peer at SOCK_SYNSENT, it changes to @ref SOCK_ESTABLISHED.\n + Otherwise, it changes to @ref SOCK_CLOSED after TCPTO (@ref Sn_IR_TIMEOUT = '1') is occurred. +*/ +#define SOCK_SYNSENT 0x15 + +/** + @brief Connection state + @details It indicates Socket n successfully received the connect-request packet (SYN packet) from a peer.\n + If socket n sends the response (SYN/ACK packet) to the peer successfully, it changes to @ref SOCK_ESTABLISHED. \n + If not, it changes to @ref SOCK_CLOSED after timeout (@ref Sn_IR_TIMEOUT = '1') is occurred. +*/ +#define SOCK_SYNRECV 0x16 + +/** + @brief Success to connect + @details This indicates the status of the connection of Socket n.\n + It changes to @ref SOCK_ESTABLISHED when the TCP SERVERprocessed the SYN packet from the TCP CLIENTduring @ref SOCK_LISTEN, or + when the @ref Sn_CR_CONNECT command is successful.\n + During @ref SOCK_ESTABLISHED, DATA packet can be transferred using @ref Sn_CR_SEND or @ref Sn_CR_RECV command. +*/ +#define SOCK_ESTABLISHED 0x17 + +/** + @brief Closing state + @details These indicate Socket n is closing.\n + These are shown in disconnect-process such as active-close and passive-close.\n + When Disconnect-process is successfully completed, or when timeout(@ref Sn_CR_TIMTEOUT = '1') is occurred, these change to @ref SOCK_CLOSED. +*/ +#define SOCK_FIN_WAIT 0x18 + +/** + @brief Closing state + @details These indicate Socket n is closing.\n + These are shown in disconnect-process such as active-close and passive-close.\n + When Disconnect-process is successfully completed, or when timeout occurs, these change to @ref SOCK_CLOSED. +*/ +#define SOCK_CLOSING 0x1A + +/** + @brief Closing state + @details These indicate Socket n is closing.\n + These are shown in disconnect-process such as active-close and passive-close.\n + When Disconnect-process is successfully completed, or when timeout occurs, these change to @ref SOCK_CLOSED. +*/ +#define SOCK_TIME_WAIT 0x1B + +/** + @brief Closing state + @details This indicates Socket n received the disconnect-request (FIN packet) from the connected peer.\n + This is half-closing status, and data can be transferred.\n + For full-closing, @ref Sn_CR_DISCON command is used. But For just-closing, @ref Sn_CR_CLOSE command is used. +*/ +#define SOCK_CLOSE_WAIT 0x1C + +/** + @brief Closing state + @details This indicates Socket n is waiting for the response (FIN/ACK packet) to the disconnect-request (FIN packet) by passive-close.\n + It changes to @ref SOCK_CLOSED when Socket n received the response successfully, or when timeout (@ref Sn_IR_TIMEOUT = '1') is occurred. +*/ +#define SOCK_LAST_ACK 0x1D + +/** + @brief UDP socket + @details This indicates Socket n is opened in UDP mode(@ref Sn_MR(P[3:0]) = '010').\n + It changes to SOCK_UDP when @ref Sn_MR(P[3:0]) = '010' and @ref Sn_CR_OPEN command is ordered.\n + Unlike TCP mode, data can be transfered without the connection-process. +*/ +#define SOCK_UDP 0x22 + +/** + @brief IP raw mode socket + @details TThe socket is opened in IPRAW mode. The SOCKET status is change to SOCK_IPRAW when @ref Sn_MR (P3:P0) is + Sn_MR_IPRAW and @ref Sn_CR_OPEN command is used.\n + IP Packet can be transferred without a connection similar to the UDP mode. +*/ +#define SOCK_IPRAW 0x32 + +/** + @brief MAC raw mode socket + @details This indicates Socket 0 is opened in MACRAW mode (@ref Sn_MR(P[3:0]) = '100' and n = 0) and is valid only in Socket 0.\n + It changes to SOCK_MACRAW when @ref Sn_MR(P[3:0] = 100)and @ ref Sn_CR_OPEN command is ordered.\n + Like UDP mode socket, MACRAW mode Socket 0 can transfer a MAC packet (Ethernet frame) without the connection-process. +*/ +#define SOCK_MACRAW 0x42 /**< SOCKET0 is open as MACRAW mode. */ + +/** + @brief PPPoE mode socket + @details It is the status that SOCKET0 is opened as PPPoE mode. + It is changed to SOCK_PPPoE in case of @ref Sn_CR_OPEN command is ordered and @ref Sn_MR(P3:P0)= @ref Sn_MR_PPPoE\n + It is temporarily used at the PPPoE connection. +*/ +#define SOCK_PPPoE 0x5F /**< SOCKET0 is open as PPPoE mode. */ + +/* IP PROTOCOL */ +#define IPPROTO_IP 0 //< Dummy for IP +#define IPPROTO_ICMP 1 //< Control message protocol +#define IPPROTO_IGMP 2 //< Internet group management protocol +#define IPPROTO_GGP 3 //< Gateway^2 (deprecated) +#define IPPROTO_TCP 6 //< TCP +#define IPPROTO_PUP 12 //< PUP +#define IPPROTO_UDP 17 //< UDP +#define IPPROTO_IDP 22 //< XNS idp +#define IPPROTO_ND 77 //< UNOFFICIAL net disk protocol +#define IPPROTO_RAW 255 //< Raw IP packet + + +/** + @brief Enter a critical section + + @details It is provided to protect your shared code which are executed without distribution. \n \n + + In non-OS environment, It can be just implemented by disabling whole interrupt.\n + In OS environment, You can replace it to critical section api supported by OS. + + \sa WIZCHIP_READ(), WIZCHIP_WRITE() + \sa WIZCHIP_CRITICAL_EXIT() +*/ +#define WIZCHIP_CRITICAL_ENTER() WIZCHIP.CRIS._enter() + +#ifdef _exit +#undef _exit +#endif + +/** + @brief Exit a critical section + + @details It is provided to protect your shared code which are executed without distribution. \n\n + + In non-OS environment, It can be just implemented by disabling whole interrupt. \n + In OS environment, You can replace it to critical section api supported by OS. + + @sa WIZCHIP_READ(), WIZCHIP_WRITE() + @sa WIZCHIP_CRITICAL_ENTER() +*/ +#define WIZCHIP_CRITICAL_EXIT() WIZCHIP.CRIS._exit() + +//////////////////////// +// Basic I/O Function // +//////////////////////// + +/** + @ingroup Basic_IO_function_W5300 + @brief It reads 1 byte value from a register. + @param AddrSel Register address + @return The value of register +*/ +uint16_t WIZCHIP_READ(uint32_t AddrSel); + +/** + @ingroup Basic_IO_function_W5300 + @brief It writes 1 byte value to a register. + @param AddrSel Register address + @param wb Write data + @return void +*/ +void WIZCHIP_WRITE(uint32_t AddrSel, uint16_t wb); + +/*********************************** + COMMON Register Access Function + ***********************************/ + +/** + @ingroup Common_register_access_function_W5300 + @brief Set Mode Register + @param (@ref iodata_t)mr The value to be set. + @sa getMR() +*/ +#if (_WIZCHIP_IO_MODE_ & _WIZCHIP_IO_MODE_BUS_) +#if (_WIZCHIP_IO_BUS_WIDTH_ == 8) +#define setMR(mr) \ + (*((uint8_t*)MR) = (uint8_t)((mr) >> 8)); (*((uint8_t*)WIZCHIP_OFFSET_INC(MR,1)) = (uint8_t)((mr) & 0xFF)) +#elif (_WIZCHIP_IO_BUS_WIDTH_ == 16) +#define setMR(mr) (*((uint16_t*)MR) = (uint16_t)((mr) & 0xFFFF)) +#else +#error "Unknown _WIZCHIP_IO_BUS_WIDTH_. You should be define _WIZCHIP_IO_BUS_WIDTH as 8 or 16." +#endif +#else +#error "Unknown _WIZCHIP_IO_MODE_" +#endif + +/** + @ingroup Common_register_access_function_W5300 + @brief Get @ref MR. + @return @ref iodata_t. The value of Mode register. + @sa setMR() +*/ +#if (_WIZCHIP_IO_MODE_ & _WIZCHIP_IO_MODE_BUS_) +#if (_WIZCHIP_IO_BUS_WIDTH_ == 8) +#define getMR() (((uint16_t)(*((uint8_t*)MR)) << 8) + (((uint16_t)(*((uint8_t*)WIZCHIP_OFFSET_INC(MR,1)))) & 0x00FF)) +#elif(_WIZCHIP_IO_BUS_WIDTH_ == 16) +#define getMR() (*((uint16_t*)MR)) +#else +#error "Unknown _WIZCHIP_IO_BUS_WIDTH_. You should be define _WIZCHIP_IO_BUS_WIDTH as 8 or 16." +#endif +#else +#error "Unknown _WIZCHIP_IO_MODE_" +#endif + +/** + @ingroup Common_register_access_function_W5300 + @brief Set \ref IR register + @param (uint16_t)ir Value to set \ref IR register. + @sa getIR() +*/ +#define setIR(ir) \ + WIZCHIP_WRITE(IR, ir & 0xF0FF) + +/** + @ingroup Common_register_access_function_W5300 + @brief Get \ref IR register + @return uint8_t. Value of \ref IR register. + @sa setIR() +*/ +#define getIR() \ + (WIZCHIP_READ(IR) & 0xF0FF) + + +/** + @ingroup Common_register_access_function_W5300 + @brief Set \ref _IMR_ register + @param (uint16_t)imr Value to set @ref _IMR_ register. + @sa getIMR() +*/ +#define setIMR(imr) \ + WIZCHIP_WRITE(_IMR_, imr & 0xF0FF) + +/** + @ingroup Common_register_access_function_W5300 + @brief Get \ref _IMR_ register + @return uint16_t. Value of \ref IR register. + @sa setIMR() +*/ +#define getIMR() \ + (WIZCHIP_READ(_IMR_) & 0xF0FF) + +/** + @ingroup Common_register_access_function_W5300 + @brief Set local MAC address + @param (uint8_t*)shar Pointer variable to set local MAC address. It should be allocated 6 bytes. + @sa getSHAR() +*/ +#define setSHAR(shar) { \ + WIZCHIP_WRITE(SHAR, (((uint16_t)((shar)[0])) << 8) + (((uint16_t)((shar)[1])) & 0x00FF)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(SHAR,2), (((uint16_t)((shar)[2])) << 8) + (((uint16_t)((shar)[3])) & 0x00FF)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(SHAR,4), (((uint16_t)((shar)[4])) << 8) + (((uint16_t)((shar)[5])) & 0x00FF)); \ + } + +/** + @ingroup Common_register_access_function + @brief Get local MAC address + @param (uint8_t*)shar Pointer variable to get local MAC address. It should be allocated 6 bytes. + @sa setSHAR() +*/ +#define getSHAR(shar) { \ + (shar)[0] = (uint8_t)(WIZCHIP_READ(SHAR) >> 8); \ + (shar)[1] = (uint8_t)(WIZCHIP_READ(SHAR)); \ + (shar)[2] = (uint8_t)(WIZCHIP_READ(WIZCHIP_OFFSET_INC(SHAR,2)) >> 8); \ + (shar)[3] = (uint8_t)(WIZCHIP_READ(WIZCHIP_OFFSET_INC(SHAR,2))); \ + (shar)[4] = (uint8_t)(WIZCHIP_READ(WIZCHIP_OFFSET_INC(SHAR,4)) >> 8); \ + (shar)[5] = (uint8_t)(WIZCHIP_READ(WIZCHIP_OFFSET_INC(SHAR,4))); \ + } + +/** + @ingroup Common_register_access_function_W5300 + @brief Set gateway IP address + @param (uint8_t*)gar Pointer variable to set gateway IP address. It should be allocated 4 bytes. + @sa getGAR() +*/ +#define setGAR(gar) { \ + WIZCHIP_WRITE(GAR, (((uint16_t)((gar)[0])) << 8) + (((uint16_t)((gar)[1])) & 0x00FF)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(GAR,2), (((uint16_t)((gar)[2])) << 8) + (((uint16_t)((gar)[3])) & 0x00FF)); \ + } + +/** + @ingroup Common_register_access_function_W5300 + @brief Get gateway IP address + @param (uint8_t*)gar Pointer variable to get gateway IP address. It should be allocated 4 bytes. + @sa setGAR() +*/ +#define getGAR(gar) { \ + (gar)[0] = (uint8_t)(WIZCHIP_READ(GAR) >> 8); \ + (gar)[1] = (uint8_t)(WIZCHIP_READ(GAR)); \ + (gar)[2] = (uint8_t)(WIZCHIP_READ(WIZCHIP_OFFSET_INC(GAR,2)) >> 8); \ + (gar)[3] = (uint8_t)(WIZCHIP_READ(WIZCHIP_OFFSET_INC(GAR,2))); \ + } + +/** + @ingroup Common_register_access_function_W5300 + @brief Set subnet mask address + @param (uint8_t*)subr Pointer variable to set subnet mask address. It should be allocated 4 bytes. + @sa getSUBR() +*/ +#define setSUBR(subr) { \ + WIZCHIP_WRITE(SUBR, (((uint16_t)((subr)[0])) << 8) + (((uint16_t)((subr)[1])) & 0x00FF)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(SUBR,2), (((uint16_t)((subr)[2])) << 8) + (((uint16_t)((subr)[3])) & 0x00FF)); \ + } + +/** + @ingroup Common_register_access_function_W5300 + @brief Get subnet mask address + @param (uint8_t*)subr Pointer variable to get subnet mask address. It should be allocated 4 bytes. + @sa setSUBR() +*/ +#define getSUBR(subr) { \ + (subr)[0] = (uint8_t)(WIZCHIP_READ(SUBR) >> 8); \ + (subr)[1] = (uint8_t)(WIZCHIP_READ(SUBR)); \ + (subr)[2] = (uint8_t)(WIZCHIP_READ(WIZCHIP_OFFSET_INC(SUBR,2)) >> 8); \ + (subr)[3] = (uint8_t)(WIZCHIP_READ(WIZCHIP_OFFSET_INC(SUBR,2))); \ + } + +/** + @ingroup Common_register_access_function_W5300 + @brief Set local IP address + @param (uint8_t*)sipr Pointer variable to set local IP address. It should be allocated 4 bytes. + @sa getSIPR() +*/ +#define setSIPR(sipr) { \ + WIZCHIP_WRITE(SIPR, (((uint16_t)((sipr)[0])) << 8) + (((uint16_t)((sipr)[1])) & 0x00FF)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(SIPR,2), (((uint16_t)((sipr)[2])) << 8) + (((uint16_t)((sipr)[3])) & 0x00FF)); \ + } + +/** + @ingroup Common_register_access_function_W5300 + @brief Get local IP address + @param (uint8_t*)sipr Pointer variable to get local IP address. It should be allocated 4 bytes. + @sa setSIPR() +*/ +#define getSIPR(sipr) { \ + (sipr)[0] = (uint8_t)(WIZCHIP_READ(SIPR) >> 8); \ + (sipr)[1] = (uint8_t)(WIZCHIP_READ(SIPR)); \ + (sipr)[2] = (uint8_t)(WIZCHIP_READ(WIZCHIP_OFFSET_INC(SIPR,2)) >> 8); \ + (sipr)[3] = (uint8_t)(WIZCHIP_READ(WIZCHIP_OFFSET_INC(SIPR,2))); \ + } + + +/** + @ingroup Common_register_access_function_W5300 + @brief Set @ref _RTR_ register + @param (uint16_t)rtr Value to set @ref _RTR_ register. + @sa getRTR() +*/ +#define setRTR(rtr) \ + WIZCHIP_WRITE(_RTR_, rtr) + +/** + @ingroup Common_register_access_function_W5300 + @brief Get @ref _RTR_ register + @return uint16_t. Value of @ref _RTR_ register. + @sa setRTR() +*/ +#define getRTR() \ + WIZCHIP_READ(_RTR_) + +/** + @ingroup Common_register_access_function_W5300 + @brief Set @ref _RCR_ register + @param (uint8_t)rcr Value to set @ref _RCR_ register. + @sa getRCR() +*/ +#define setRCR(rcr) \ + WIZCHIP_WRITE(_RCR_, ((uint16_t)rcr)&0x00FF) + +/** + @ingroup Common_register_access_function_W5300 + @brief Get @ref _RCR_ register + @return uint8_t. Value of @ref _RCR_ register. + @sa setRCR() +*/ +#define getRCR() \ + ((uint8_t)(WIZCHIP_READ(_RCR_) & 0x00FF)) + +/** + @ingroup Common_register_access_function_W5300 + @brief Set @ref TMS01R register + @param (uint16_t)tms01r Value to set @ref TMS01R register. The lower socket memory size is located at MSB of tms01r. + @sa getTMS01R() +*/ +#define setTMS01R(tms01r) \ + WIZCHIP_WRITE(TMS01R,tms01r) + +/** + @ingroup Common_register_access_function_W5300 + @brief Get @ref TMS01R register + @return uint16_t. Value of @ref TMS01R register. + @sa setTMS01R() +*/ +#define getTMS01R() \ + WIZCHIP_READ(TMS01R) + +/** + @ingroup Common_register_access_function_W5300 + @brief Set @ref TMS23R register + @param (uint16_t)tms23r Value to set @ref TMS23R register. The lower socket memory size is located at MSB of tms01r. + @sa getTMS23R() +*/ +#define setTMS23R(tms23r) \ + WIZCHIP_WRITE(TMS23R,tms23r) + +/** + @ingroup Common_register_access_function_W5300 + @brief Get @ref TMS23R register + @return uint16_t. Value of @ref TMS23R register. + @sa setTMS23R() +*/ +#define getTMS23R() \ + WIZCHIP_READ(TMS23R) + +/** + @ingroup Common_register_access_function_W5300 + @brief Set @ref TMS45R register + @param (uint16_t)tms45r Value to set @ref TMS45R register. The lower socket memory size is located at MSB of tms45r. + @sa getTMS45R() +*/ +#define setTMS45R(tms45r) \ + WIZCHIP_WRITE(TMS45R,tms45r) + +/** + @ingroup Common_register_access_function_W5300 + @brief Get @ref TMS45R register + @return uint16_t. Value of @ref TMS45R register. + @sa setTMS45R() +*/ +#define getTMS45R() \ + WIZCHIP_READ(TMS45R) + +/** + @ingroup Common_register_access_function_W5300 + @brief Set @ref TMS67R register + @param (uint16_t)tms67r Value to set @ref TMS67R register. The lower socket memory size is located at MSB of tms67r. + @sa getTMS67R() +*/ +#define setTMS67R(tms67r) \ + WIZCHIP_WRITE(TMS67R,tms67r) + +/** + @ingroup Common_register_access_function_W5300 + @brief Get @ref TMS67R register + @return uint16_t. Value of @ref TMS67R register. + @sa setTMS67R() +*/ +#define getTMS67R() \ + WIZCHIP_READ(TMS67R) + +/** + @ingroup Common_register_access_function_W5300 + @brief Set @ref TMSR0 ~ @ref TMSR7 register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @param (uint8_t)tmsr Value to set @ref TMSR0 ~@ref TMSR7 register. + @sa getTMSR() +*/ +void setTMSR(uint8_t sn, uint8_t tmsr); +#define setSn_TXBUF_SIZE(sn, tmsr) setTMSR(sn, tmsr) ///< For compatible ioLibrary + +/** + @ingroup Common_register_access_function_W5300 + @brief Get @ref TMSR0 ~ @ref TMSR7 register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @return uint8_t. Value of @ref TMSR0 ~ @ref TMSR7 + @sa getTMSR() +*/ +uint8_t getTMSR(uint8_t sn); +#define getSn_TXBUF_SIZE(sn) getTMSR(sn) ///< For compatible ioLibrary + +/** + @ingroup Common_register_access_function_W5300 + @brief Set @ref RMS01R register + @param (uint16_t)rms01r Value to set @ref RMS01R register. The lower socket memory size is located at MSB of rms01r. + @sa getRMS01R() +*/ +#define setRMS01R(rms01r) \ + WIZCHIP_WRITE(RMS01R,rms01r) + +/** + @ingroup Common_register_access_function_W5300 + @brief Get @ref RMS01R register + @return uint16_t. Value of @ref RMS01R register. + @sa setRMS01R() +*/ +#define getRMS01R() \ + WIZCHIP_READ(RMS01R) + +/** + @ingroup Common_register_access_function_W5300 + @brief Set @ref RMS23R register + @param (uint16_t)rms23r Value to set @ref RMS23R register. The lower socket memory size is located at MSB of rms01r. + @sa getRMS23R() +*/ +#define setRMS23R(rms23r) \ + WIZCHIP_WRITE(RMS23R,rms23r) + +/** + @ingroup Common_register_access_function_W5300 + @brief Get @ref RMS23R register + @return uint16_t. Value of @ref RMS23R register. + @sa setRMS23R() +*/ +#define getRMS23R() \ + WIZCHIP_READ(RMS23R) + +/** + @ingroup Common_register_access_function_W5300 + @brief Set @ref RMS45R register + @param (uint16_t)rms45r Value to set @ref RMS45R register. The lower socket memory size is located at MSB of rms45r. + @sa getRMS45R() +*/ +#define setRMS45R(rms45r) \ + WIZCHIP_WRITE(RMS45R,rms45r) + +/** + @ingroup Common_register_access_function_W5300 + @brief Get @ref RMS45R register + @return uint16_t. Value of @ref RMS45R register. + @sa setRMS45R() +*/ +#define getRMS45R() \ + WIZCHIP_READ(RMS45R) + +/** + @ingroup Common_register_access_function_W5300 + @brief Set @ref RMS67R register + @param (uint16_t)rms67r Value to set @ref RMS67R register. The lower socket memory size is located at MSB of rms67r. + @sa getRMS67R() +*/ +#define setRMS67R(rms67r) \ + WIZCHIP_WRITE(RMS67R,rms67r) + +/** + @ingroup Common_register_access_function_W5300 + @brief Get @ref RMS67R register + @return uint16_t. Value of @ref RMS67R register. + @sa setRMS67R() +*/ +#define getRMS67R() \ + WIZCHIP_READ(RMS67R) + +/** + @ingroup Common_register_access_function_W5300 + @brief Set @ref RMS01R ~ @ref RMS67R register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @param (uint8_t)rmsr Value to set @ref RMSR0 ~@ref RMSR7 register. + @sa getTMSR() +*/ +void setRMSR(uint8_t sn, uint8_t rmsr); +#define setSn_RXBUF_SIZE(sn,rmsr) setRMSR(sn, rmsr) ///< For compatible ioLibrary + +/** + @ingroup Common_register_access_function_W5300 + @brief Get @ref RMS01R ~ @ref RMS67R register + @param (uint8_t)sn Socket number. It shoudl be 0 ~ 7. + @return uint8_t. Value of @ref RMSR0 ~ @ref RMSR7 register. + @sa setRMSR() +*/ +uint8_t getRMSR(uint8_t sn); +#define getSn_RXBUF_SIZE(sn) getRMSR(sn) ///< For compatible ioLibrary + +/** + @ingroup Common_register_access_function_W5300 + @brief Set @ref MTYPER register + @param (uint16_t)mtyper Value to set @ref MTYPER register. + @sa getMTYPER() +*/ +#define setMTYPER(mtype) \ + WIZCHIP_WRITE(MTYPER, mtype) + +/** + @ingroup Common_register_access_function_W5300 + @brief Get @ref MTYPER register + @return uint16_t. Value of @ref MTYPER register. + @sa setMTYPER() +*/ +#define getMTYPER() \ + WIZCHIP_READ(MTYPER) + +/** + @ingroup Common_register_access_function_W5300 + @brief Get @ref RATR register + @return uint16_t. Value of @ref PATR register. +*/ +#define getPATR() \ + WIZCHIP_READ(PATR) + +/** + @ingroup Common_register_access_function_W5300 + @brief Set @ref PTIMER register + @param (uint8_t)ptimer Value to set @ref PTIMER register. + @sa getPTIMER() +*/ +#define setPTIMER(ptimer) \ + WIZCHIP_WRITE(PTIMER, ((uint16_t)ptimer) & 0x00FF) + +/** + @ingroup Common_register_access_function_W5300 + @brief Get @ref PTIMER register + @return uint8_t. Value of @ref PTIMER register. + @sa setPTIMER() +*/ +#define getPTIMER() \ + ((uint8_t)(WIZCHIP_READ(PTIMER) & 0x00FF)) + +/** + @ingroup Common_register_access_function_W5300 + @brief Set @ref PMAGIC register + @param (uint8_t)pmagic Value to set @ref PMAGIC register. + @sa getPMAGIC() +*/ +#define setPMAGIC(pmagic) \ + WIZCHIP_WRITE(PMAGIC, ((uint16_t)pmagic) & 0x00FF) + +/** + @ingroup Common_register_access_function_W5300 + @brief Get @ref PMAGIC register + @return uint8_t. Value of @ref PMAGIC register. + @sa setPMAGIC() +*/ +#define getPMAGIC() \ + ((uint8_t)(WIZCHIP_READ(PMAGIC) & 0x00FF)) + +/** + @ingroup Common_register_access_function_W5300 + @brief Get @ref PSID register + @return uint16_t. Value of @ref PSID register. +*/ +#define getPSIDR() \ + WIZCHIP_READ(PSIDR) + +/** + @ingroup Common_register_access_function_W5300 + @brief Get @ref PDHAR register + @param (uint8_t*)pdhar Pointer variable to PPP destination MAC register address. It should be allocated 6 bytes. +*/ +#define getPDHAR(pdhar) { \ + (pdhar)[0] = (uint8_t)(WIZCHIP_READ(PDHAR) >> 8); \ + (pdhar)[1] = (uint8_t)(WIZCHIP_READ(PDHAR)); \ + (pdhar)[2] = (uint8_t)(WIZCHIP_READ(WIZCHIP_OFFSET_INC(PDHAR,2)) >> 8); \ + (pdhar)[3] = (uint8_t)(WIZCHIP_READ(WIZCHIP_OFFSET_INC(PDHAR,2))); \ + (pdhar)[4] = (uint8_t)(WIZCHIP_READ(WIZCHIP_OFFSET_INC(PDHAR,4)) >> 8); \ + (pdhar)[5] = (uint8_t)(WIZCHIP_READ(WIZCHIP_OFFSET_INC(PDHAR,4))); \ + } + +/** + @ingroup Common_register_access_function_W5300 + @brief Get unreachable IP address. @ref UIPR + @param (uint8_t*)uipr Pointer variable to get unreachable IP address. It should be allocated 4 bytes. +*/ +#define getUIPR(uipr) { \ + (uipr)[0] = (uint8_t)(WIZCHIP_READ(UIPR) >> 8); \ + (uipr)[1] = (uint8_t)(WIZCHIP_READ(UIPR)); \ + (uipr)[2] = (uint8_t)(WIZCHIP_READ(WIZCHIP_OFFSET_INC(UIPR,2)) >> 8); \ + (uipr)[3] = (uint8_t)(WIZCHIP_READ(WIZCHIP_OFFSET_INC(UIPR,2))); \ + } + +/** + @ingroup Common_register_access_function_W5300 + @brief Get @ref UPORTR register + @return uint16_t. Value of @ref UPORTR register. +*/ +#define getUPORTR() \ + WIZCHIP_READ(UPORTR) + +/** + @ingroup Common_register_access_function_W5300 + @brief Get @ref FMTUR register + @return uint16_t. Value of @ref FMTUR register. +*/ +#define getFMTUR() \ + WIZCHIP_READ(FMTUR) + + +/** + @ingroup Common_register_access_function_W5300 + @brief Get @ref Pn_BRDYR register + @return uint8_t. Value of @ref Pn_BRDYR register. +*/ +#define getPn_BRDYR(p) \ + ((uint8_t)(WIZCHIP_READ(Pn_BRDYR(p)) & 0x00FF)) + +/** + @ingroup Common_register_access_function_W5300 + @brief Set @ref Pn_BRDYR register + @param p Pin number (p = 0,1,2,3) + @param brdyr Set a value @ref Pn_BRDYR(p). +*/ +#define setPn_BRDYR(p, brdyr) \ + WIZCHIP_WRITE(Pn_BRDYR(p), brdyr & 0x00E7) + +/** + @ingroup Common_register_access_function_W5300 + @brief Get @ref Pn_BDPTHR register + @param p Pin number (p = 0,1,2,3) + @return uint16_t. Value of @ref Pn_BDPTHR register. +*/ +#define getPn_BDPTHR(p) \ + WIZCHIP_READ(Pn_BDPTHR(p)) + +/** + @ingroup Common_register_access_function_W5300 + @brief Set @ref Pn_BDPTHR register + @param p Pin number (p = 0,1,2,3) + @param bdpthr Value of @ref Pn_BDPTHR +*/ +#define setPn_BDPTHR(p, bdpthr) \ + WIZCHIP_WRITE(Pn_BDPTHR(p),bdpthr) + + +/** + @ingroup Common_register_access_function_W5300 + @brief Get @ref IDR register + @return uint16_t. Always 0x5300. +*/ +#define getIDR() \ + WIZCHIP_READ(IDR) + + +/*********************************** + SOCKET Register Access Function + ***********************************/ + +/** + @ingroup Socket_register_access_function_W5300 + @brief Set @ref Sn_MR register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @param (uint8_t)mr Value to set @ref Sn_MR + @sa getSn_MR() +*/ +#define setSn_MR(sn, mr) \ + WIZCHIP_WRITE(Sn_MR(sn),mr) + +/** + @ingroup Socket_register_access_function_W5300 + @brief Get @ref Sn_MR register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @return uint8_t. Value of @ref Sn_MR. + @sa setSn_MR() +*/ +#define getSn_MR(sn) \ + WIZCHIP_READ(Sn_MR(sn)) + +/** + @ingroup Socket_register_access_function_W5300 + @brief Set @ref Sn_CR register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @param (uint8_t)cr Value to set @ref Sn_CR + @sa getSn_CR() +*/ +#define setSn_CR(sn, cr) \ + WIZCHIP_WRITE(Sn_CR(sn), ((uint16_t)cr) & 0x00FF) + +/** + @ingroup Socket_register_access_function_W5300 + @brief Get @ref Sn_CR register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @return uint8_t. Value of @ref Sn_CR. + @sa setSn_CR() +*/ +#define getSn_CR(sn) \ + ((uint8_t)WIZCHIP_READ(Sn_CR(sn))) + +/** + @ingroup Socket_register_access_function_W5300 + @brief Set @ref Sn_IMR register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @param (uint8_t)imr Value to set @ref Sn_IMR + @sa getSn_IMR() +*/ +#define setSn_IMR(sn, imr) \ + WIZCHIP_WRITE(Sn_IMR(sn), ((uint16_t)imr) & 0x00FF) + +/** + @ingroup Socket_register_access_function_W5300 + @brief Get @ref Sn_IMR register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @return uint8_t. Value of @ref Sn_IMR. + @sa setSn_IMR() +*/ +#define getSn_IMR(sn) \ + ((uint8_t)WIZCHIP_READ(Sn_IMR(sn))) + +/** + @ingroup Socket_register_access_function_W5300 + @brief Set @ref Sn_IR register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @param (uint8_t)ir Value to set @ref Sn_IR + @sa getSn_IR() +*/ +#define setSn_IR(sn, ir) \ + WIZCHIP_WRITE(Sn_IR(sn), ((uint16_t)ir) & 0x00FF) + +/** + @ingroup Socket_register_access_function_W5300 + @brief Get @ref Sn_IR register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @return uint8_t. Value of @ref Sn_IR. + @sa setSn_IR() +*/ +#define getSn_IR(sn) \ + ((uint8_t)WIZCHIP_READ(Sn_IR(sn))) + +/** + @ingroup Socket_register_access_function_W5300 + @brief Get @ref Sn_SR register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @return uint8_t. Value of @ref Sn_SR. +*/ +#define getSn_SSR(sn) \ + ((uint8_t)WIZCHIP_READ(Sn_SR(sn))) +#define getSn_SR(sn) getSn_SSR(sn) ///< For compatible ioLibrary. Refer to getSn_SSR(). + +/** + @ingroup Socket_register_access_function_W5300 + @brief Set @ref Sn_PORTR register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @param (uint16_t)port Variable to set @ref Sn_PORTR. + @sa getSn_PORTR() +*/ +#define setSn_PORTR(sn, port) \ + WIZCHIP_WRITE(Sn_PORTR(sn), port) +#define setSn_PORT(sn, port) setSn_PORTR(sn, port) ///< For compatible ioLibrary + +/** + @ingroup Socket_register_access_function_W5300 + @brief Get @ref Sn_PORTR register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @return uint16_t. Variable of @ref Sn_PORTR. + @sa setSn_PORTR() +*/ +#define getSn_PORTR(sn) \ + WIZCHIP_READ(Sn_PORTR(sn)) +#define getSn_PORT(sn) getSn_PORTR(sn) ///< For compatible ioLibrary + +/** + @ingroup Socket_register_access_function_W5300 + @brief Set @ref Sn_DHAR register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @param (uint8_t*)dhar Pointer variable to set socket n destination hardware address. It should be allocated 6 bytes. + @sa getSn_DHAR() +*/ +#define setSn_DHAR(sn, dhar) { \ + WIZCHIP_WRITE(Sn_DHAR(sn), (((uint16_t)((dhar)[0])) << 8) + (((uint16_t)((dhar)[1])) & 0x00FF)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(Sn_DHAR(sn),2), (((uint16_t)((dhar)[0])) << 8) + (((uint16_t)((dhar)[1])) & 0x00FF)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(Sn_DHAR(sn),4), (((uint16_t)((dhar)[0])) << 8) + (((uint16_t)((dhar)[1])) & 0x00FF)); \ + } + +/** + @ingroup Socket_register_access_function_W5300 + @brief Get @ref Sn_MR register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @param (uint8_t*)dhar Pointer variable to get socket n destination hardware address. It should be allocated 6 bytes. + @sa setSn_DHAR() +*/ +#define getSn_DHAR(sn, dhar) { \ + (dhar)[0] = (uint8_t)(WIZCHIP_READ(Sn_DHAR(sn)) >> 8); \ + (dhar)[1] = (uint8_t) WIZCHIP_READ(Sn_DHAR(sn)); \ + (dhar)[2] = (uint8_t)(WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_DHAR(sn),2)) >> 8); \ + (dhar)[3] = (uint8_t) WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_DHAR(sn),2)); \ + (dhar)[4] = (uint8_t)(WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_DHAR(sn),4)) >> 8); \ + (dhar)[5] = (uint8_t) WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_DHAR(sn),4)); \ + } + +/** + @ingroup Socket_register_access_function_W5300 + @brief Set @ref Sn_DPORT register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @param (uint16_t)dport Value to set @ref Sn_DPORT + @sa getSn_DPORT() +*/ +#define setSn_DPORTR(sn, dport) \ + WIZCHIP_WRITE(Sn_DPORTR(sn),dport) +#define setSn_DPORT(sn, dport) setSn_DPORTR(sn,dport) ///< For compatible ioLibrary. Refer to @ref Sn_DPORTR. + + +/** + @ingroup Socket_register_access_function_W5300 + @brief Get @ref Sn_DPORT register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @return uint16_t. Value of @ref Sn_DPORT. + @sa setSn_DPORT() + @note This function is not available because W5300 have a bug to read @ref Sn_DPORTR. \n + Don't use this function. +*/ +#define getSn_DPORTR(sn) \ + WIZCHIP_READ(Sn_DPORTR(sn)) +#define getSn_DPORT(sn) getSn_DPORTR(sn) ///< For compatible ioLibrary. Refer to @ref Sn_DPORTR. + +/** + @ingroup Socket_register_access_function_W5300 + @brief Set @ref Sn_DIPR register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @param (uint8_t*)dipr Pointer variable to set socket n destination IP address. It should be allocated 4 bytes. + @sa getSn_DIPR() +*/ +#define setSn_DIPR(sn, dipr) { \ + WIZCHIP_WRITE(Sn_DIPR(sn), (((uint16_t)((dipr)[0])) << 8) + (((uint16_t)((dipr)[1])) & 0x00FF)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(Sn_DIPR(sn),2), (((uint16_t)((dipr)[2])) << 8) + (((uint16_t)((dipr)[3])) & 0x00FF)); \ + } + +/** + @ingroup Socket_register_access_function_W5300 + @brief Get @ref Sn_DIPR register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @param (uint8_t*)dipr Pointer variable to get socket n destination IP address. It should be allocated 4 bytes. + @sa setSn_DIPR() +*/ +#define getSn_DIPR(sn, dipr) { \ + (dipr)[0] = (uint8_t)(WIZCHIP_READ(Sn_DIPR(sn)) >> 8); \ + (dipr)[1] = (uint8_t) WIZCHIP_READ(Sn_DIPR(sn)); \ + (dipr)[2] = (uint8_t)(WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_DIPR(sn),2)) >> 8); \ + (dipr)[3] = (uint8_t) WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_DIPR(sn),2)); \ + } + +/** + @ingroup Socket_register_access_function_W5300 + @brief Set @ref Sn_MSSR register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @param (uint16_t)mss Value to set @ref Sn_MSSR + @sa setSn_MSSR() +*/ +#define setSn_MSSR(sn, mss) \ + WIZCHIP_WRITE(Sn_MSSR(sn), mss) + +/** + @ingroup Socket_register_access_function_W5300 + @brief Get @ref Sn_MSSR register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @return uint16_t. Value of @ref Sn_MSSR. + @sa setSn_MSSR() +*/ +#define getSn_MSSR(sn) \ + WIZCHIP_READ(Sn_MSSR(sn)) + +/** + @ingroup Socket_register_access_function_W5300 + @brief Set @ref Sn_KPALVTR register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @param (uint8_t)kpalvt Value to set @ref Sn_KPALVTR + @sa getSn_KPALVTR() +*/ +#define setSn_KPALVTR(sn, kpalvt) \ + WIZCHIP_WRITE(Sn_KPALVTR(sn), (WIZCHIP_READ(Sn_KPALVTR(sn)) & 0x00FF) | (((uint16_t)kpalvt)<<8)) + +/** + @ingroup Socket_register_access_function_W5300 + @brief Get @ref Sn_KPALVTR register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @return uint8_t. Value of @ref Sn_KPALVTR. + @sa setSn_KPALVTR() +*/ +#define getSn_KPALVTR(sn) \ + ((uint8_t)(WIZCHIP_READ(Sn_KPALVTR(sn)) >> 8)) + +/** + @ingroup Socket_register_access_function_W5300 + @brief Set @ref Sn_PROTOR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param (uint8_t)proto Value to set \ref Sn_PROTOR + @sa getSn_PROTOR() +*/ +#define setSn_PROTOR(sn, proto) \ + WIZCHIP_WRITE(Sn_PROTOR(sn),(WIZCHIP_READ(Sn_PROTOR(sn)) & 0xFF00) | (((uint16_t)proto) & 0x00FF)) +#define setSn_PROTO(sn,proto) setSn_PROTOR(sn,proto) ///< For compatible ioLibrary + +/** + @ingroup Socket_register_access_function_W5300 + @brief Get @ref Sn_PROTOR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return uint8_t. Value of @ref Sn_PROTOR. + @sa setSn_PROTOR() +*/ +#define getSn_PROTOR(sn) \ + ((uint8_t)WIZCHIP_READ(Sn_PROTOR(sn))) +#define getSn_PROTO(sn) getSn_PROTOR(sn) ///< For compatible ioLibrary + +/** + @ingroup Socket_register_access_function_W5300 + @brief Set @ref Sn_TX_WRSR register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @param (uint32_t)txwrs Value to set @ref Sn_KPALVTR (It should be <= 0x00010000) + @sa getSn_TX_WRSR() +*/ +#define setSn_TX_WRSR(sn, txwrs) { \ + WIZCHIP_WRITE(Sn_TX_WRSR(sn), (uint16_t)(((uint32_t)txwrs) >> 16)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(Sn_TX_WRSR(sn),2), (uint16_t)txwrs); \ + } + +/** + @ingroup Socket_register_access_function_W5300 + @brief Get @ref Sn_TX_WRSR register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @return uint32_t. Value of Sn_TX_WRSR. + @sa setSn_TX_WRSR() +*/ +#define getSn_TX_WRSR(sn) \ + ( (((uint32_t)WIZCHIP_READ(Sn_TX_WRSR(sn))) << 16) + (((uint32_t)WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_TX_WRSR(sn),1))) & 0x0000FFFF) ) + +/** + @ingroup Socket_register_access_function_W5300 + @brief Get @ref Sn_TX_FSR register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @return uint32_t. Value of @ref Sn_TX_FSR. +*/ +uint32_t getSn_TX_FSR(uint8_t sn); + +/** + @ingroup Socket_register_access_function_W5300 + @brief Get @ref Sn_RX_RSR register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @return uint32_t. Value of @ref Sn_RX_RSR. +*/ +uint32_t getSn_RX_RSR(uint8_t sn); + +/** + @ingroup Socket_register_access_function_W5300 + @brief Set @ref Sn_TX_FIFOR register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @param (uint16_t)txfifo. Value to set @ref Sn_TX_FIFOR. +*/ +#define setSn_TX_FIFOR(sn, txfifo) \ + WIZCHIP_WRITE(Sn_TX_FIFOR(sn), txfifo); + +/** + @ingroup Socket_register_access_function_W5300 + @brief Get @ref Sn_RX_FIFOR register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @return uint16_t. Value of @ref Sn_RX_FIFOR. +*/ +#define getSn_RX_FIFOR(sn) \ + WIZCHIP_READ(Sn_RX_FIFOR(sn)); + +/** + @ingroup Socket_register_access_function_W5300 + @brief Set @ref Sn_TOSR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param (uint8_t)tos Value to set @ref Sn_TOSR + @sa getSn_TOSR() +*/ +#define setSn_TOSR(sn, tos) \ + WIZCHIP_WRITE(Sn_TOS(sn), ((uint16_t)tos) & 0x00FF) +#define setSn_TOS(sn,tos) setSn_TOSR(sn,tos) ///< For compatible ioLibrar + +/** + @ingroup Socket_register_access_function_W5300 + @brief Get @ref Sn_TOSR register + @param (uint8_t)sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_ . + @return uint8_t. Value of Sn_TOSR. + @sa setSn_TOSR() +*/ +#define getSn_TOSR(sn) \ + ((uint8_t)WIZCHIP_READ(Sn_TOSR(sn))) +#define getSn_TOS(sn) getSn_TOSR(sn) ///< For compatible ioLibrar + +/** + @ingroup Socket_register_access_function_W5300 + @brief Set @ref Sn_TTLR register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @param (uint8_t)ttl Value to set @ref Sn_TTLR + @sa getSn_TTLR() +*/ +#define setSn_TTLR(sn, ttl) \ + WIZCHIP_WRITE(Sn_TTLR(sn), ((uint16_t)ttl) & 0x00FF) +#define setSn_TTL(sn,ttl) setSn_TTLR(sn,ttl) ///< For compatible ioLibrary + +/** + @ingroup Socket_register_access_function_W5300 + @brief Get @ref Sn_TTLR register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @return uint8_t. Value of @ref Sn_TTLR. + @sa setSn_TTLR() +*/ +#define getSn_TTLR(sn) \ + ((uint8_t)WIZCHIP_READ(Sn_TTL(sn))) +#define getSn_TTL(sn) getSn_TTLR(sn) ///< For compatible ioLibrary + +/** + @ingroup Socket_register_access_function_W5300 + @brief Set @ref Sn_FRAGR register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @param (uint16_t)frag Value to set @ref Sn_FRAGR + @sa getSn_FRAGR() +*/ +#define setSn_FRAGR(sn, frag) \ + WIZCHIP_WRITE(Sn_FRAGR(sn), ((uint16_t)frag) & 0x00FF) +#define setSn_FRAG(sn,frag) setSn_FRAGR(sn,flag) + +/** + @ingroup Socket_register_access_function_W5300 + @brief Get @ref Sn_FRAGR register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @return uint16_t. Value of @ref Sn_FRAGR. + @sa setSn_FRAGR() +*/ +#define getSn_FRAGR(sn) \ + (WIZCHIP_READ(Sn_FRAG(sn))) +#define getSn_FRAG(sn) getSn_FRAGR(sn) + + +///////////////////////////////////// +// Sn_TXBUF & Sn_RXBUF IO function // +///////////////////////////////////// + +/** + @brief Socket_register_access_function_W5300 + @brief Gets the max buffer size of socket sn passed as parameter. + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @return uint32_t. Value of Socket n RX max buffer size. +*/ +#define getSn_RxMAX(sn) \ + (((uint32_t)getSn_RXBUF_SIZE(sn)) << 10) + +/** + @brief Socket_register_access_function_W5300 + @brief Gets the max buffer size of socket sn passed as parameters. + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @return uint32_t. Value of Socket n TX max buffer size. +*/ +#define getSn_TxMAX(sn) \ + (((uint32_t)getSn_TXBUF_SIZE(sn)) << 10) + +/** + @ingroup Basic_IO_function_W5300 + @brief It copies data to internal TX memory + + @details This function reads the Tx write pointer register and after that, + it copies the wizdata(pointer buffer) of the length of len(variable) bytes to internal TX memory + and updates the Tx write pointer register. + This function is being called by send() and sendto() function also. + + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @param wizdata Pointer buffer to write data + @param len Data length + @sa wiz_recv_data() +*/ +void wiz_send_data(uint8_t sn, uint8_t *wizdata, uint32_t len); + +/** + @ingroup Basic_IO_function_W5300 + @brief It copies data to your buffer from internal RX memory + + @details This function read the Rx read pointer register and after that, + it copies the received data from internal RX memory + to wizdata(pointer variable) of the length of len(variable) bytes. + This function is being called by recv() also. + + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @param wizdata Pointer buffer to read data + @param len Data length + @sa wiz_send_data() +*/ +void wiz_recv_data(uint8_t sn, uint8_t *wizdata, uint32_t len); + +/** + @ingroup Basic_IO_function_W5300 + @brief It discard the received data in RX memory. + @details It discards the data of the length of len(variable) bytes in internal RX memory. + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @param len Data length +*/ +void wiz_recv_ignore(uint8_t sn, uint32_t len); + +/// \cond DOXY_APPLY_CODE +#endif +/// \endcond + +#ifdef __cplusplus +} +#endif + +#endif // _W5300_H_ diff --git a/Ethernet/W5500/w5500.c b/Ethernet/W5500/w5500.c new file mode 100644 index 0000000..8913610 --- /dev/null +++ b/Ethernet/W5500/w5500.c @@ -0,0 +1,248 @@ +//***************************************************************************** +// +//! \file w5500.c +//! \brief W5500 HAL Interface. +//! \version 1.0.2 +//! \date 2013/10/21 +//! \par Revision history +//! <2015/02/05> Notice +//! The version history is not updated after this point. +//! Download the latest version directly from GitHub. Please visit the our GitHub repository for ioLibrary. +//! >> https://github.com/Wiznet/ioLibrary_Driver +//! <2014/05/01> V1.0.2 +//! 1. Implicit type casting -> Explicit type casting. Refer to M20140501 +//! Fixed the problem on porting into under 32bit MCU +//! Issued by Mathias ClauBen, wizwiki forum ID Think01 and bobh +//! Thank for your interesting and serious advices. +//! <2013/12/20> V1.0.1 +//! 1. Remove warning +//! 2. WIZCHIP_READ_BUF WIZCHIP_WRITE_BUF in case _WIZCHIP_IO_MODE_SPI_FDM_ +//! for loop optimized(removed). refer to M20131220 +//! <2013/10/21> 1st Release +//! \author MidnightCow +//! \copyright +//! +//! Copyright (c) 2013, WIZnet Co., 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: +//! +//! * 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 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 "w5500.h" + +#define _W5500_SPI_VDM_OP_ 0x00 +#define _W5500_SPI_FDM_OP_LEN1_ 0x01 +#define _W5500_SPI_FDM_OP_LEN2_ 0x02 +#define _W5500_SPI_FDM_OP_LEN4_ 0x03 + +#if (_WIZCHIP_ == 5500) +//////////////////////////////////////////////////// + +uint8_t WIZCHIP_READ(uint32_t AddrSel) { + uint8_t ret; + uint8_t spi_data[3]; + + WIZCHIP_CRITICAL_ENTER(); + WIZCHIP.CS._select(); + + AddrSel |= (_W5500_SPI_READ_ | _W5500_SPI_VDM_OP_); + + if (!WIZCHIP.IF.SPI._read_burst || !WIZCHIP.IF.SPI._write_burst) { // byte operation + WIZCHIP.IF.SPI._write_byte((AddrSel & 0x00FF0000) >> 16); + WIZCHIP.IF.SPI._write_byte((AddrSel & 0x0000FF00) >> 8); + WIZCHIP.IF.SPI._write_byte((AddrSel & 0x000000FF) >> 0); + } else { // burst operation + spi_data[0] = (AddrSel & 0x00FF0000) >> 16; + spi_data[1] = (AddrSel & 0x0000FF00) >> 8; + spi_data[2] = (AddrSel & 0x000000FF) >> 0; + WIZCHIP.IF.SPI._write_burst(spi_data, 3); + } + ret = WIZCHIP.IF.SPI._read_byte(); + + WIZCHIP.CS._deselect(); + WIZCHIP_CRITICAL_EXIT(); + return ret; +} + +void WIZCHIP_WRITE(uint32_t AddrSel, uint8_t wb) { + uint8_t spi_data[4]; + + WIZCHIP_CRITICAL_ENTER(); + WIZCHIP.CS._select(); + + AddrSel |= (_W5500_SPI_WRITE_ | _W5500_SPI_VDM_OP_); + + //if(!WIZCHIP.IF.SPI._read_burst || !WIZCHIP.IF.SPI._write_burst) // byte operation + if (!WIZCHIP.IF.SPI._write_burst) { // byte operation + WIZCHIP.IF.SPI._write_byte((AddrSel & 0x00FF0000) >> 16); + WIZCHIP.IF.SPI._write_byte((AddrSel & 0x0000FF00) >> 8); + WIZCHIP.IF.SPI._write_byte((AddrSel & 0x000000FF) >> 0); + WIZCHIP.IF.SPI._write_byte(wb); + } else { // burst operation + spi_data[0] = (AddrSel & 0x00FF0000) >> 16; + spi_data[1] = (AddrSel & 0x0000FF00) >> 8; + spi_data[2] = (AddrSel & 0x000000FF) >> 0; + spi_data[3] = wb; + WIZCHIP.IF.SPI._write_burst(spi_data, 4); + } + + WIZCHIP.CS._deselect(); + WIZCHIP_CRITICAL_EXIT(); +} + +void WIZCHIP_READ_BUF(uint32_t AddrSel, uint8_t* pBuf, uint16_t len) { + uint8_t spi_data[3]; + uint16_t i; + + WIZCHIP_CRITICAL_ENTER(); + WIZCHIP.CS._select(); + + AddrSel |= (_W5500_SPI_READ_ | _W5500_SPI_VDM_OP_); + + if (!WIZCHIP.IF.SPI._read_burst || !WIZCHIP.IF.SPI._write_burst) { // byte operation + WIZCHIP.IF.SPI._write_byte((AddrSel & 0x00FF0000) >> 16); + WIZCHIP.IF.SPI._write_byte((AddrSel & 0x0000FF00) >> 8); + WIZCHIP.IF.SPI._write_byte((AddrSel & 0x000000FF) >> 0); + for (i = 0; i < len; i++) { + pBuf[i] = WIZCHIP.IF.SPI._read_byte(); + } + } else { // burst operation + spi_data[0] = (AddrSel & 0x00FF0000) >> 16; + spi_data[1] = (AddrSel & 0x0000FF00) >> 8; + spi_data[2] = (AddrSel & 0x000000FF) >> 0; + WIZCHIP.IF.SPI._write_burst(spi_data, 3); + WIZCHIP.IF.SPI._read_burst(pBuf, len); + } + + WIZCHIP.CS._deselect(); + WIZCHIP_CRITICAL_EXIT(); +} + +void WIZCHIP_WRITE_BUF(uint32_t AddrSel, uint8_t* pBuf, uint16_t len) { + uint8_t spi_data[3]; + uint16_t i; + + WIZCHIP_CRITICAL_ENTER(); + WIZCHIP.CS._select(); + + AddrSel |= (_W5500_SPI_WRITE_ | _W5500_SPI_VDM_OP_); + + if (!WIZCHIP.IF.SPI._write_burst) { // byte operation + WIZCHIP.IF.SPI._write_byte((AddrSel & 0x00FF0000) >> 16); + WIZCHIP.IF.SPI._write_byte((AddrSel & 0x0000FF00) >> 8); + WIZCHIP.IF.SPI._write_byte((AddrSel & 0x000000FF) >> 0); + for (i = 0; i < len; i++) { + WIZCHIP.IF.SPI._write_byte(pBuf[i]); + } + } else { // burst operation + spi_data[0] = (AddrSel & 0x00FF0000) >> 16; + spi_data[1] = (AddrSel & 0x0000FF00) >> 8; + spi_data[2] = (AddrSel & 0x000000FF) >> 0; + WIZCHIP.IF.SPI._write_burst(spi_data, 3); + WIZCHIP.IF.SPI._write_burst(pBuf, len); + } + + WIZCHIP.CS._deselect(); + WIZCHIP_CRITICAL_EXIT(); +} + + +uint16_t getSn_TX_FSR(uint8_t sn) { + uint16_t val = 0, val1 = 0; + + do { + val1 = WIZCHIP_READ(Sn_TX_FSR(sn)); + val1 = (val1 << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_TX_FSR(sn), 1)); + if (val1 != 0) { + val = WIZCHIP_READ(Sn_TX_FSR(sn)); + val = (val << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_TX_FSR(sn), 1)); + } + } while (val != val1); + return val; +} + + +uint16_t getSn_RX_RSR(uint8_t sn) { + uint16_t val = 0, val1 = 0; + + do { + val1 = WIZCHIP_READ(Sn_RX_RSR(sn)); + val1 = (val1 << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_RX_RSR(sn), 1)); + if (val1 != 0) { + val = WIZCHIP_READ(Sn_RX_RSR(sn)); + val = (val << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_RX_RSR(sn), 1)); + } + } while (val != val1); + return val; +} + +void wiz_send_data(uint8_t sn, uint8_t *wizdata, uint16_t len) { + uint16_t ptr = 0; + uint32_t addrsel = 0; + + if (len == 0) { + return; + } + ptr = getSn_TX_WR(sn); + //M20140501 : implict type casting -> explict type casting + //addrsel = (ptr << 8) + (WIZCHIP_TXBUF_BLOCK(sn) << 3); + addrsel = ((uint32_t)ptr << 8) + (WIZCHIP_TXBUF_BLOCK(sn) << 3); + // + WIZCHIP_WRITE_BUF(addrsel, wizdata, len); + + ptr += len; + setSn_TX_WR(sn, ptr); +} + +void wiz_recv_data(uint8_t sn, uint8_t *wizdata, uint16_t len) { + uint16_t ptr = 0; + uint32_t addrsel = 0; + + if (len == 0) { + return; + } + ptr = getSn_RX_RD(sn); + //M20140501 : implict type casting -> explict type casting + //addrsel = ((ptr << 8) + (WIZCHIP_RXBUF_BLOCK(sn) << 3); + addrsel = ((uint32_t)ptr << 8) + (WIZCHIP_RXBUF_BLOCK(sn) << 3); + // + WIZCHIP_READ_BUF(addrsel, wizdata, len); + ptr += len; + + setSn_RX_RD(sn, ptr); +} + + +void wiz_recv_ignore(uint8_t sn, uint16_t len) { + uint16_t ptr = 0; + + ptr = getSn_RX_RD(sn); + ptr += len; + setSn_RX_RD(sn, ptr); +} + +#endif diff --git a/Ethernet/W5500/w5500.h b/Ethernet/W5500/w5500.h new file mode 100644 index 0000000..d120dd6 --- /dev/null +++ b/Ethernet/W5500/w5500.h @@ -0,0 +1,2164 @@ +//***************************************************************************** +// +//! \file w5500.h +//! \brief W5500 HAL Header File. +//! \version 1.0.0 +//! \date 2013/10/21 +//! \par Revision history +//! <2015/02/05> Notice +//! The version history is not updated after this point. +//! Download the latest version directly from GitHub. Please visit the our GitHub repository for ioLibrary. +//! >> https://github.com/Wiznet/ioLibrary_Driver +//! <2013/10/21> 1st Release +//! \author MidnightCow +//! \copyright +//! +//! Copyright (c) 2013, WIZnet Co., 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: +//! +//! * 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 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 _W5500_H_ +#define _W5500_H_ + +#ifdef __cplusplus +extern "C" { +#endif + +#include +#include "wizchip_conf.h" + +/// @cond DOXY_APPLY_CODE +#if (_WIZCHIP_ == 5500) +/// @endcond + +#define _W5500_IO_BASE_ 0x00000000 + +#define _W5500_SPI_READ_ (0x00 << 2) //< SPI interface Read operation in Control Phase +#define _W5500_SPI_WRITE_ (0x01 << 2) //< SPI interface Write operation in Control Phase + +#define WIZCHIP_CREG_BLOCK 0x00 //< Common register block +#define WIZCHIP_SREG_BLOCK(N) (1+4*N) //< Socket N register block +#define WIZCHIP_TXBUF_BLOCK(N) (2+4*N) //< Socket N Tx buffer address block +#define WIZCHIP_RXBUF_BLOCK(N) (3+4*N) //< Socket N Rx buffer address block + +#define WIZCHIP_OFFSET_INC(ADDR, N) (ADDR + (N<<8)) //< Increase offset address + + +/////////////////////////////////////// +// Definition For Legacy Chip Driver // +/////////////////////////////////////// +#define IINCHIP_READ(ADDR) WIZCHIP_READ(ADDR) ///< The defined for legacy chip driver +#define IINCHIP_WRITE(ADDR,VAL) WIZCHIP_WRITE(ADDR,VAL) ///< The defined for legacy chip driver +#define IINCHIP_READ_BUF(ADDR,BUF,LEN) WIZCHIP_READ_BUF(ADDR,BUF,LEN) ///< The defined for legacy chip driver +#define IINCHIP_WRITE_BUF(ADDR,BUF,LEN) WIZCHIP_WRITE(ADDR,BUF,LEN) ///< The defined for legacy chip driver + +////////////////////////////// +//-------------------------- defgroup --------------------------------- +/** + @defgroup W5500 W5500 + + @brief WHIZCHIP register defines and I/O functions of @b W5500. + + - @ref WIZCHIP_register : @ref Common_register_group and @ref Socket_register_group + - @ref WIZCHIP_IO_Functions : @ref Basic_IO_function, @ref Common_register_access_function and @ref Socket_register_access_function +*/ + + +/** + @defgroup WIZCHIP_register WIZCHIP register + @ingroup W5500 + + @brief WHIZCHIP register defines register group of @b W5500. + + - @ref Common_register_group : Common register group + - @ref Socket_register_group : \c SOCKET n register group +*/ + + +/** + @defgroup WIZCHIP_IO_Functions WIZCHIP I/O functions + @ingroup W5500 + + @brief This supports the basic I/O functions for @ref WIZCHIP_register. + + - Basic I/O function \n + WIZCHIP_READ(), WIZCHIP_WRITE(), WIZCHIP_READ_BUF(), WIZCHIP_WRITE_BUF() \n\n + + - @ref Common_register_group access functions \n + -# @b Mode \n + getMR(), setMR() + -# @b Interrupt \n + getIR(), setIR(), getIMR(), setIMR(), getSIR(), setSIR(), getSIMR(), setSIMR(), getINTLEVEL(), setINTLEVEL() + -# Network Information \n + getSHAR(), setSHAR(), getGAR(), setGAR(), getSUBR(), setSUBR(), getSIPR(), setSIPR() + -# @b Retransmission \n + getRCR(), setRCR(), getRTR(), setRTR() + -# @b PPPoE \n + getPTIMER(), setPTIMER(), getPMAGIC(), getPMAGIC(), getPSID(), setPSID(), getPHAR(), setPHAR(), getPMRU(), setPMRU() + -# ICMP packet \n + getUIPR(), getUPORTR() + -# @b etc. \n + getPHYCFGR(), setPHYCFGR(), getVERSIONR() \n\n + + - \ref Socket_register_group access functions \n + -# SOCKET control \n + getSn_MR(), setSn_MR(), getSn_CR(), setSn_CR(), getSn_IMR(), setSn_IMR(), getSn_IR(), setSn_IR() + -# SOCKET information \n + getSn_SR(), getSn_DHAR(), setSn_DHAR(), getSn_PORT(), setSn_PORT(), getSn_DIPR(), setSn_DIPR(), getSn_DPORT(), setSn_DPORT() + getSn_MSSR(), setSn_MSSR() + -# SOCKET communication \n + getSn_RXBUF_SIZE(), setSn_RXBUF_SIZE(), getSn_TXBUF_SIZE(), setSn_TXBUF_SIZE() \n + getSn_TX_RD(), getSn_TX_WR(), setSn_TX_WR() \n + getSn_RX_RD(), setSn_RX_RD(), getSn_RX_WR() \n + getSn_TX_FSR(), getSn_RX_RSR(), getSn_KPALVTR(), setSn_KPALVTR() + -# IP header field \n + getSn_FRAG(), setSn_FRAG(), getSn_TOS(), setSn_TOS() \n + getSn_TTL(), setSn_TTL() +*/ + + + +/** + @defgroup Common_register_group Common register + @ingroup WIZCHIP_register + + @brief Common register group\n + It set the basic for the networking\n + It set the configuration such as interrupt, network information, ICMP, etc. + @details + @sa MR : Mode register. + @sa GAR, SUBR, SHAR, SIPR + @sa INTLEVEL, IR, IMR, SIR, SIMR : Interrupt. + @sa _RTR_, _RCR_ : Data retransmission. + @sa PTIMER, PMAGIC, PHAR, PSID, PMRU : PPPoE. + @sa UIPR, UPORTR : ICMP message. + @sa PHYCFGR, VERSIONR : etc. +*/ + + + +/** + @defgroup Socket_register_group Socket register + @ingroup WIZCHIP_register + + @brief Socket register group.\n + Socket register configures and control SOCKETn which is necessary to data communication. + @details + @sa Sn_MR, Sn_CR, Sn_IR, Sn_IMR : SOCKETn Control + @sa Sn_SR, Sn_PORT, Sn_DHAR, Sn_DIPR, Sn_DPORT : SOCKETn Information + @sa Sn_MSSR, Sn_TOS, Sn_TTL, Sn_KPALVTR, Sn_FRAG : Internet protocol. + @sa Sn_RXBUF_SIZE, Sn_TXBUF_SIZE, Sn_TX_FSR, Sn_TX_RD, Sn_TX_WR, Sn_RX_RSR, Sn_RX_RD, Sn_RX_WR : Data communication +*/ + + + +/** + @defgroup Basic_IO_function Basic I/O function + @ingroup WIZCHIP_IO_Functions + @brief These are basic input/output functions to read values from register or write values to register. +*/ + +/** + @defgroup Common_register_access_function Common register access functions + @ingroup WIZCHIP_IO_Functions + @brief These are functions to access common registers. +*/ + +/** + @defgroup Socket_register_access_function Socket register access functions + @ingroup WIZCHIP_IO_Functions + @brief These are functions to access socket registers. +*/ + +//------------------------------- defgroup end -------------------------------------------- +//----------------------------- W5500 Common Registers IOMAP ----------------------------- +/** + @ingroup Common_register_group + @brief Mode Register address(R/W)\n + @ref MR is used for S/W reset, ping block mode, PPPoE mode and etc. + @details Each bit of @ref MR defined as follows. + + + +
    7 6 5 4 3 2 1 0
    RST Reserved WOL PB PPPoE Reserved FARP Reserved
    + - \ref MR_RST : Reset + - \ref MR_WOL : Wake on LAN + - \ref MR_PB : Ping block + - \ref MR_PPPOE : PPPoE mode + - \ref MR_FARP : Force ARP mode +*/ +#define MR (_W5500_IO_BASE_ + (0x0000 << 8) + (WIZCHIP_CREG_BLOCK << 3)) + +/** + @ingroup Common_register_group + @brief Gateway IP Register address(R/W) + @details @ref GAR configures the default gateway address. +*/ +#define GAR (_W5500_IO_BASE_ + (0x0001 << 8) + (WIZCHIP_CREG_BLOCK << 3)) + +/** + @ingroup Common_register_group + @brief Subnet mask Register address(R/W) + @details @ref SUBR configures the subnet mask address. +*/ +#define SUBR (_W5500_IO_BASE_ + (0x0005 << 8) + (WIZCHIP_CREG_BLOCK << 3)) + +/** + @ingroup Common_register_group + @brief Source MAC Register address(R/W) + @details @ref SHAR configures the source hardware address. +*/ +#define SHAR (_W5500_IO_BASE_ + (0x0009 << 8) + (WIZCHIP_CREG_BLOCK << 3)) + +/** + @ingroup Common_register_group + @brief Source IP Register address(R/W) + @details @ref SIPR configures the source IP address. +*/ +#define SIPR (_W5500_IO_BASE_ + (0x000F << 8) + (WIZCHIP_CREG_BLOCK << 3)) + +/** + @ingroup Common_register_group + @brief Set Interrupt low level timer register address(R/W) + @details @ref INTLEVEL configures the Interrupt Assert Time. +*/ +#define INTLEVEL (_W5500_IO_BASE_ + (0x0013 << 8) + (WIZCHIP_CREG_BLOCK << 3)) + +/** + @ingroup Common_register_group + @brief Interrupt Register(R/W) + @details @ref IR indicates the interrupt status. Each bit of @ref IR will be still until the bit will be written to by the host. + If @ref IR is not equal to x00 INTn PIN is asserted to low until it is x00\n\n + Each bit of @ref IR defined as follows. + + + +
    7 6 5 4 3 2 1 0
    CONFLICT UNREACH PPPoE MP Reserved Reserved Reserved Reserved
    + - \ref IR_CONFLICT : IP conflict + - \ref IR_UNREACH : Destination unreachable + - \ref IR_PPPoE : PPPoE connection close + - \ref IR_MP : Magic packet +*/ +#define IR (_W5500_IO_BASE_ + (0x0015 << 8) + (WIZCHIP_CREG_BLOCK << 3)) + +/** + @ingroup Common_register_group + @brief Interrupt mask register(R/W) + @details @ref _IMR_ is used to mask interrupts. Each bit of @ref _IMR_ corresponds to each bit of @ref IR. + When a bit of @ref _IMR_ is and the corresponding bit of @ref IR is an interrupt will be issued. In other words, + if a bit of @ref _IMR_ is an interrupt will not be issued even if the corresponding bit of @ref IR is \n\n + Each bit of @ref _IMR_ defined as the following. + + + +
    7 6 5 4 3 2 1 0
    IM_IR7 IM_IR6 IM_IR5 IM_IR4 Reserved Reserved Reserved Reserved
    + - \ref IM_IR7 : IP Conflict Interrupt Mask + - \ref IM_IR6 : Destination unreachable Interrupt Mask + - \ref IM_IR5 : PPPoE Close Interrupt Mask + - \ref IM_IR4 : Magic Packet Interrupt Mask +*/ +//M20150401 : Rename SYMBOE ( Re-define error in a compile) +//#define IMR (_W5500_IO_BASE_ + (0x0016 << 8) + (WIZCHIP_CREG_BLOCK << 3)) +#define _IMR_ (_W5500_IO_BASE_ + (0x0016 << 8) + (WIZCHIP_CREG_BLOCK << 3)) + +/** + @ingroup Common_register_group + @brief Socket Interrupt Register(R/W) + @details @ref SIR indicates the interrupt status of Socket.\n + Each bit of @ref SIR be still until @ref Sn_IR is cleared by the host.\n + If @ref Sn_IR is not equal to x00 the n-th bit of @ref SIR is and INTn PIN is asserted until @ref SIR is x00 */ +#define SIR (_W5500_IO_BASE_ + (0x0017 << 8) + (WIZCHIP_CREG_BLOCK << 3)) + +/** + @ingroup Common_register_group + @brief Socket Interrupt Mask Register(R/W) + @details Each bit of @ref SIMR corresponds to each bit of @ref SIR. + When a bit of @ref SIMR is and the corresponding bit of @ref SIR is Interrupt will be issued. + In other words, if a bit of @ref SIMR is an interrupt will be not issued even if the corresponding bit of @ref SIR is +*/ +#define SIMR (_W5500_IO_BASE_ + (0x0018 << 8) + (WIZCHIP_CREG_BLOCK << 3)) + +/** + @ingroup Common_register_group + @brief Timeout register address( 1 is 100us )(R/W) + @details @ref _RTR_ configures the retransmission timeout period. The unit of timeout period is 100us and the default of @ref _RTR_ is x07D0. + And so the default timeout period is 200ms(100us X 2000). During the time configured by @ref _RTR_, W5500 waits for the peer response + to the packet that is transmitted by \ref Sn_CR (CONNECT, DISCON, CLOSE, SEND, SEND_MAC, SEND_KEEP command). + If the peer does not respond within the @ref _RTR_ time, W5500 retransmits the packet or issues timeout. +*/ +//M20150401 : Rename SYMBOE ( Re-define error in a compile) +//#define RTR (_W5500_IO_BASE_ + (0x0019 << 8) + (WIZCHIP_CREG_BLOCK << 3)) +#define _RTR_ (_W5500_IO_BASE_ + (0x0019 << 8) + (WIZCHIP_CREG_BLOCK << 3)) + +/** + @ingroup Common_register_group + @brief Retry count register(R/W) + @details @ref _RCR_ configures the number of time of retransmission. + When retransmission occurs as many as ref _RCR_+1 Timeout interrupt is issued (@ref Sn_IR_TIMEOUT = '1'). +*/ +//M20150401 : Rename SYMBOE ( Re-define error in a compile) +//#define RCR (_W5500_IO_BASE_ + (0x001B << 8) + (WIZCHIP_CREG_BLOCK << 3)) +#define _RCR_ (_W5500_IO_BASE_ + (0x001B << 8) + (WIZCHIP_CREG_BLOCK << 3)) + +/** + @ingroup Common_register_group + @brief PPP LCP Request Timer register in PPPoE mode(R/W) + @details @ref PTIMER configures the time for sending LCP echo request. The unit of time is 25ms. +*/ +#define PTIMER (_W5500_IO_BASE_ + (0x001C << 8) + (WIZCHIP_CREG_BLOCK << 3)) + +/** + @ingroup Common_register_group + @brief PPP LCP Magic number register in PPPoE mode(R/W) + @details @ref PMAGIC configures the 4bytes magic number to be used in LCP negotiation. +*/ +#define PMAGIC (_W5500_IO_BASE_ + (0x001D << 8) + (WIZCHIP_CREG_BLOCK << 3)) + +/** + @ingroup Common_register_group + @brief PPP Destination MAC Register address(R/W) + @details @ref PHAR configures the PPPoE server hardware address that is acquired during PPPoE connection process. +*/ +#define PHAR (_W5500_IO_BASE_ + (0x001E << 8) + (WIZCHIP_CREG_BLOCK << 3)) + +/** + @ingroup Common_register_group + @brief PPP Session Identification Register(R/W) + @details @ref PSID configures the PPPoE sever session ID acquired during PPPoE connection process. +*/ +#define PSID (_W5500_IO_BASE_ + (0x0024 << 8) + (WIZCHIP_CREG_BLOCK << 3)) + +/** + @ingroup Common_register_group + @brief PPP Maximum Segment Size(MSS) register(R/W) + @details @ref PMRU configures the maximum receive unit of PPPoE. +*/ +#define PMRU (_W5500_IO_BASE_ + (0x0026 << 8) + (WIZCHIP_CREG_BLOCK << 3)) + +/** + @ingroup Common_register_group + @brief Unreachable IP register address in UDP mode(R) + @details W5500 receives an ICMP packet(Destination port unreachable) when data is sent to a port number + which socket is not open and @ref IR_UNREACH bit of @ref IR becomes and @ref UIPR & @ref UPORTR indicates + the destination IP address & port number respectively. +*/ +#define UIPR (_W5500_IO_BASE_ + (0x0028 << 8) + (WIZCHIP_CREG_BLOCK << 3)) + +/** + @ingroup Common_register_group + @brief Unreachable Port register address in UDP mode(R) + @details W5500 receives an ICMP packet(Destination port unreachable) when data is sent to a port number + which socket is not open and @ref IR_UNREACH bit of @ref IR becomes and @ref UIPR & @ref UPORTR + indicates the destination IP address & port number respectively. +*/ +#define UPORTR (_W5500_IO_BASE_ + (0x002C << 8) + (WIZCHIP_CREG_BLOCK << 3)) + +/** + @ingroup Common_register_group + @brief PHY Status Register(R/W) + @details @ref PHYCFGR configures PHY operation mode and resets PHY. In addition, @ref PHYCFGR indicates the status of PHY such as duplex, Speed, Link. +*/ +#define PHYCFGR (_W5500_IO_BASE_ + (0x002E << 8) + (WIZCHIP_CREG_BLOCK << 3)) + +// Reserved (_W5500_IO_BASE_ + (0x002F << 8) + (WIZCHIP_CREG_BLOCK << 3)) +// Reserved (_W5500_IO_BASE_ + (0x0030 << 8) + (WIZCHIP_CREG_BLOCK << 3)) +// Reserved (_W5500_IO_BASE_ + (0x0031 << 8) + (WIZCHIP_CREG_BLOCK << 3)) +// Reserved (_W5500_IO_BASE_ + (0x0032 << 8) + (WIZCHIP_CREG_BLOCK << 3)) +// Reserved (_W5500_IO_BASE_ + (0x0033 << 8) + (WIZCHIP_CREG_BLOCK << 3)) +// Reserved (_W5500_IO_BASE_ + (0x0034 << 8) + (WIZCHIP_CREG_BLOCK << 3)) +// Reserved (_W5500_IO_BASE_ + (0x0035 << 8) + (WIZCHIP_CREG_BLOCK << 3)) +// Reserved (_W5500_IO_BASE_ + (0x0036 << 8) + (WIZCHIP_CREG_BLOCK << 3)) +// Reserved (_W5500_IO_BASE_ + (0x0037 << 8) + (WIZCHIP_CREG_BLOCK << 3)) +// Reserved (_W5500_IO_BASE_ + (0x0038 << 8) + (WIZCHIP_CREG_BLOCK << 3)) + +/** + @ingroup Common_register_group + @brief chip version register address(R) + @details @ref VERSIONR always indicates the W5500 version as @b 0x04. +*/ +#define VERSIONR (_W5500_IO_BASE_ + (0x0039 << 8) + (WIZCHIP_CREG_BLOCK << 3)) + + +//----------------------------- W5500 Socket Registers IOMAP ----------------------------- +/** + @ingroup Socket_register_group + @brief socket Mode register(R/W) + @details @ref Sn_MR configures the option or protocol type of Socket n.\n\n + Each bit of @ref Sn_MR defined as the following. + + + +
    7 6 5 4 3 2 1 0
    MULTI/MFEN BCASTB ND/MC/MMB UCASTB/MIP6B Protocol[3] Protocol[2] Protocol[1] Protocol[0]
    + - @ref Sn_MR_MULTI : Support UDP Multicasting + - @ref Sn_MR_BCASTB : Broadcast block in UDP Multicasting + - @ref Sn_MR_ND : No Delayed Ack(TCP) flag + - @ref Sn_MR_MC : IGMP version used in UDP mulitcasting + - @ref Sn_MR_MMB : Multicast Blocking in @ref Sn_MR_MACRAW mode + - @ref Sn_MR_UCASTB : Unicast Block in UDP Multicating + - @ref Sn_MR_MIP6B : IPv6 packet Blocking in @ref Sn_MR_MACRAW mode + - Protocol + + + + + + +
    Protocol[3] Protocol[2] Protocol[1] Protocol[0] @b Meaning
    0 0 0 0 Closed
    0 0 0 1 TCP
    0 0 1 0 UDP
    0 1 0 0 MACRAW
    + - @ref Sn_MR_MACRAW : MAC LAYER RAW SOCK \n + - @ref Sn_MR_UDP : UDP + - @ref Sn_MR_TCP : TCP + - @ref Sn_MR_CLOSE : Unused socket + @note MACRAW mode should be only used in Socket 0. +*/ +#define Sn_MR(N) (_W5500_IO_BASE_ + (0x0000 << 8) + (WIZCHIP_SREG_BLOCK(N) << 3)) + +/** + @ingroup Socket_register_group + @brief Socket command register(R/W) + @details This is used to set the command for Socket n such as OPEN, CLOSE, CONNECT, LISTEN, SEND, and RECEIVE.\n + After W5500 accepts the command, the @ref Sn_CR register is automatically cleared to 0x00. + Even though @ref Sn_CR is cleared to 0x00, the command is still being processed.\n + To check whether the command is completed or not, please check the @ref Sn_IR or @ref Sn_SR. + - @ref Sn_CR_OPEN : Initialize or open socket. + - @ref Sn_CR_LISTEN : Wait connection request in TCP mode(Server mode) + - @ref Sn_CR_CONNECT : Send connection request in TCP mode(Client mode) + - @ref Sn_CR_DISCON : Send closing request in TCP mode. + - @ref Sn_CR_CLOSE : Close socket. + - @ref Sn_CR_SEND : Update TX buffer pointer and send data. + - @ref Sn_CR_SEND_MAC : Send data with MAC address, so without ARP process. + - @ref Sn_CR_SEND_KEEP : Send keep alive message. + - @ref Sn_CR_RECV : Update RX buffer pointer and receive data. +*/ +#define Sn_CR(N) (_W5500_IO_BASE_ + (0x0001 << 8) + (WIZCHIP_SREG_BLOCK(N) << 3)) + +/** + @ingroup Socket_register_group + @brief Socket interrupt register(R) + @details @ref Sn_IR indicates the status of Socket Interrupt such as establishment, termination, receiving data, timeout).\n + When an interrupt occurs and the corresponding bit of @ref Sn_IMR is the corresponding bit of @ref Sn_IR becomes \n + In order to clear the @ref Sn_IR bit, the host should write the bit to \n + + + +
    7 6 5 4 3 2 1 0
    Reserved Reserved Reserved SEND_OK TIMEOUT RECV DISCON CON
    + - \ref Sn_IR_SENDOK : SEND_OK Interrupt + - \ref Sn_IR_TIMEOUT : TIMEOUT Interrupt + - \ref Sn_IR_RECV : RECV Interrupt + - \ref Sn_IR_DISCON : DISCON Interrupt + - \ref Sn_IR_CON : CON Interrupt +*/ +#define Sn_IR(N) (_W5500_IO_BASE_ + (0x0002 << 8) + (WIZCHIP_SREG_BLOCK(N) << 3)) + +/** + @ingroup Socket_register_group + @brief Socket status register(R) + @details @ref Sn_SR indicates the status of Socket n.\n + The status of Socket n is changed by @ref Sn_CR or some special control packet as SYN, FIN packet in TCP. + @par Normal status + - @ref SOCK_CLOSED : Closed + - @ref SOCK_INIT : Initiate state + - @ref SOCK_LISTEN : Listen state + - @ref SOCK_ESTABLISHED : Success to connect + - @ref SOCK_CLOSE_WAIT : Closing state + - @ref SOCK_UDP : UDP socket + - @ref SOCK_MACRAW : MAC raw mode socket + @par Temporary status during changing the status of Socket n. + - @ref SOCK_SYNSENT : This indicates Socket n sent the connect-request packet (SYN packet) to a peer. + - @ref SOCK_SYNRECV : It indicates Socket n successfully received the connect-request packet (SYN packet) from a peer. + - @ref SOCK_FIN_WAIT : Connection state + - @ref SOCK_CLOSING : Closing state + - @ref SOCK_TIME_WAIT : Closing state + - @ref SOCK_LAST_ACK : Closing state +*/ +#define Sn_SR(N) (_W5500_IO_BASE_ + (0x0003 << 8) + (WIZCHIP_SREG_BLOCK(N) << 3)) + +/** + @ingroup Socket_register_group + @brief source port register(R/W) + @details @ref Sn_PORT configures the source port number of Socket n. + It is valid when Socket n is used in TCP/UDP mode. It should be set before OPEN command is ordered. +*/ +#define Sn_PORT(N) (_W5500_IO_BASE_ + (0x0004 << 8) + (WIZCHIP_SREG_BLOCK(N) << 3)) + +/** + @ingroup Socket_register_group + @brief Peer MAC register address(R/W) + @details @ref Sn_DHAR configures the destination hardware address of Socket n when using SEND_MAC command in UDP mode or + it indicates that it is acquired in ARP-process by CONNECT/SEND command. +*/ +#define Sn_DHAR(N) (_W5500_IO_BASE_ + (0x0006 << 8) + (WIZCHIP_SREG_BLOCK(N) << 3)) + +/** + @ingroup Socket_register_group + @brief Peer IP register address(R/W) + @details @ref Sn_DIPR configures or indicates the destination IP address of Socket n. It is valid when Socket n is used in TCP/UDP mode. + In TCP client mode, it configures an IP address of TCP serverbefore CONNECT command. + In TCP server mode, it indicates an IP address of TCP clientafter successfully establishing connection. + In UDP mode, it configures an IP address of peer to be received the UDP packet by SEND or SEND_MAC command. +*/ +#define Sn_DIPR(N) (_W5500_IO_BASE_ + (0x000C << 8) + (WIZCHIP_SREG_BLOCK(N) << 3)) + +/** + @ingroup Socket_register_group + @brief Peer port register address(R/W) + @details @ref Sn_DPORT configures or indicates the destination port number of Socket n. It is valid when Socket n is used in TCP/UDP mode. + In TCP clientmode, it configures the listen port number of TCP serverbefore CONNECT command. + In TCP Servermode, it indicates the port number of TCP client after successfully establishing connection. + In UDP mode, it configures the port number of peer to be transmitted the UDP packet by SEND/SEND_MAC command. +*/ +#define Sn_DPORT(N) (_W5500_IO_BASE_ + (0x0010 << 8) + (WIZCHIP_SREG_BLOCK(N) << 3)) + +/** + @ingroup Socket_register_group + @brief Maximum Segment Size(Sn_MSSR0) register address(R/W) + @details @ref Sn_MSSR configures or indicates the MTU(Maximum Transfer Unit) of Socket n. +*/ +#define Sn_MSSR(N) (_W5500_IO_BASE_ + (0x0012 << 8) + (WIZCHIP_SREG_BLOCK(N) << 3)) + +// Reserved (_W5500_IO_BASE_ + (0x0014 << 8) + (WIZCHIP_SREG_BLOCK(N) << 3)) + +/** + @ingroup Socket_register_group + @brief IP Type of Service(TOS) Register(R/W) + @details @ref Sn_TOS configures the TOS(Type Of Service field in IP Header) of Socket n. + It is set before OPEN command. +*/ +#define Sn_TOS(N) (_W5500_IO_BASE_ + (0x0015 << 8) + (WIZCHIP_SREG_BLOCK(N) << 3)) +/** + @ingroup Socket_register_group + @brief IP Time to live(TTL) Register(R/W) + @details @ref Sn_TTL configures the TTL(Time To Live field in IP header) of Socket n. + It is set before OPEN command. +*/ +#define Sn_TTL(N) (_W5500_IO_BASE_ + (0x0016 << 8) + (WIZCHIP_SREG_BLOCK(N) << 3)) +// Reserved (_W5500_IO_BASE_ + (0x0017 << 8) + (WIZCHIP_SREG_BLOCK(N) << 3)) +// Reserved (_W5500_IO_BASE_ + (0x0018 << 8) + (WIZCHIP_SREG_BLOCK(N) << 3)) +// Reserved (_W5500_IO_BASE_ + (0x0019 << 8) + (WIZCHIP_SREG_BLOCK(N) << 3)) +// Reserved (_W5500_IO_BASE_ + (0x001A << 8) + (WIZCHIP_SREG_BLOCK(N) << 3)) +// Reserved (_W5500_IO_BASE_ + (0x001B << 8) + (WIZCHIP_SREG_BLOCK(N) << 3)) +// Reserved (_W5500_IO_BASE_ + (0x001C << 8) + (WIZCHIP_SREG_BLOCK(N) << 3)) +// Reserved (_W5500_IO_BASE_ + (0x001D << 8) + (WIZCHIP_SREG_BLOCK(N) << 3)) + +/** + @ingroup Socket_register_group + @brief Receive memory size register(R/W) + @details @ref Sn_RXBUF_SIZE configures the RX buffer block size of Socket n. + Socket n RX Buffer Block size can be configured with 1,2,4,8, and 16 Kbytes. + If a different size is configured, the data cannot be normally received from a peer. + Although Socket n RX Buffer Block size is initially configured to 2Kbytes, + user can re-configure its size using @ref Sn_RXBUF_SIZE. The total sum of @ref Sn_RXBUF_SIZE can not be exceed 16Kbytes. + When exceeded, the data reception error is occurred. +*/ +#define Sn_RXBUF_SIZE(N) (_W5500_IO_BASE_ + (0x001E << 8) + (WIZCHIP_SREG_BLOCK(N) << 3)) + +/** + @ingroup Socket_register_group + @brief Transmit memory size register(R/W) + @details @ref Sn_TXBUF_SIZE configures the TX buffer block size of Socket n. Socket n TX Buffer Block size can be configured with 1,2,4,8, and 16 Kbytes. + If a different size is configured, the data can�t be normally transmitted to a peer. + Although Socket n TX Buffer Block size is initially configured to 2Kbytes, + user can be re-configure its size using @ref Sn_TXBUF_SIZE. The total sum of @ref Sn_TXBUF_SIZE can not be exceed 16Kbytes. + When exceeded, the data transmission error is occurred. +*/ +#define Sn_TXBUF_SIZE(N) (_W5500_IO_BASE_ + (0x001F << 8) + (WIZCHIP_SREG_BLOCK(N) << 3)) + +/** + @ingroup Socket_register_group + @brief Transmit free memory size register(R) + @details @ref Sn_TX_FSR indicates the free size of Socket n TX Buffer Block. It is initialized to the configured size by @ref Sn_TXBUF_SIZE. + Data bigger than @ref Sn_TX_FSR should not be saved in the Socket n TX Buffer because the bigger data overwrites the previous saved data not yet sent. + Therefore, check before saving the data to the Socket n TX Buffer, and if data is equal or smaller than its checked size, + transmit the data with SEND/SEND_MAC command after saving the data in Socket n TX buffer. But, if data is bigger than its checked size, + transmit the data after dividing into the checked size and saving in the Socket n TX buffer. +*/ +#define Sn_TX_FSR(N) (_W5500_IO_BASE_ + (0x0020 << 8) + (WIZCHIP_SREG_BLOCK(N) << 3)) + +/** + @ingroup Socket_register_group + @brief Transmit memory read pointer register address(R) + @details @ref Sn_TX_RD is initialized by OPEN command. However, if Sn_MR(P[3:0]) is TCP mode(001, it is re-initialized while connecting with TCP. + After its initialization, it is auto-increased by SEND command. + SEND command transmits the saved data from the current @ref Sn_TX_RD to the @ref Sn_TX_WR in the Socket n TX Buffer. + After transmitting the saved data, the SEND command increases the @ref Sn_TX_RD as same as the @ref Sn_TX_WR. + If its increment value exceeds the maximum value 0xFFFF, (greater than 0x10000 and the carry bit occurs), + then the carry bit is ignored and will automatically update with the lower 16bits value. +*/ +#define Sn_TX_RD(N) (_W5500_IO_BASE_ + (0x0022 << 8) + (WIZCHIP_SREG_BLOCK(N) << 3)) + +/** + @ingroup Socket_register_group + @brief Transmit memory write pointer register address(R/W) + @details @ref Sn_TX_WR is initialized by OPEN command. However, if Sn_MR(P[3:0]) is TCP mode(001, it is re-initialized while connecting with TCP.\n + It should be read or be updated like as follows.\n + 1. Read the starting address for saving the transmitting data.\n + 2. Save the transmitting data from the starting address of Socket n TX buffer.\n + 3. After saving the transmitting data, update @ref Sn_TX_WR to the increased value as many as transmitting data size. + If the increment value exceeds the maximum value 0xFFFF(greater than 0x10000 and the carry bit occurs), + then the carry bit is ignored and will automatically update with the lower 16bits value.\n + 4. Transmit the saved data in Socket n TX Buffer by using SEND/SEND command +*/ +#define Sn_TX_WR(N) (_W5500_IO_BASE_ + (0x0024 << 8) + (WIZCHIP_SREG_BLOCK(N) << 3)) + +/** + @ingroup Socket_register_group + @brief Received data size register(R) + @details @ref Sn_RX_RSR indicates the data size received and saved in Socket n RX Buffer. + @ref Sn_RX_RSR does not exceed the @ref Sn_RXBUF_SIZE and is calculated as the difference between + �Socket n RX Write Pointer (@ref Sn_RX_WR)and �Socket n RX Read Pointer (@ref Sn_RX_RD) +*/ +#define Sn_RX_RSR(N) (_W5500_IO_BASE_ + (0x0026 << 8) + (WIZCHIP_SREG_BLOCK(N) << 3)) + +/** + @ingroup Socket_register_group + @brief Read point of Receive memory(R/W) + @details @ref Sn_RX_RD is initialized by OPEN command. Make sure to be read or updated as follows.\n + 1. Read the starting save address of the received data.\n + 2. Read data from the starting address of Socket n RX Buffer.\n + 3. After reading the received data, Update @ref Sn_RX_RD to the increased value as many as the reading size. + If the increment value exceeds the maximum value 0xFFFF, that is, is greater than 0x10000 and the carry bit occurs, + update with the lower 16bits value ignored the carry bit.\n + 4. Order RECV command is for notifying the updated @ref Sn_RX_RD to W5500. +*/ +#define Sn_RX_RD(N) (_W5500_IO_BASE_ + (0x0028 << 8) + (WIZCHIP_SREG_BLOCK(N) << 3)) + +/** + @ingroup Socket_register_group + @brief Write point of Receive memory(R) + @details @ref Sn_RX_WR is initialized by OPEN command and it is auto-increased by the data reception. + If the increased value exceeds the maximum value 0xFFFF, (greater than 0x10000 and the carry bit occurs), + then the carry bit is ignored and will automatically update with the lower 16bits value. +*/ +#define Sn_RX_WR(N) (_W5500_IO_BASE_ + (0x002A << 8) + (WIZCHIP_SREG_BLOCK(N) << 3)) + +/** + @ingroup Socket_register_group + @brief socket interrupt mask register(R) + @details @ref Sn_IMR masks the interrupt of Socket n. + Each bit corresponds to each bit of @ref Sn_IR. When a Socket n Interrupt is occurred and the corresponding bit of @ref Sn_IMR is + the corresponding bit of @ref Sn_IR becomes When both the corresponding bit of @ref Sn_IMR and @ref Sn_IR are and the n-th bit of @ref IR is + Host is interrupted by asserted INTn PIN to low. +*/ +#define Sn_IMR(N) (_W5500_IO_BASE_ + (0x002C << 8) + (WIZCHIP_SREG_BLOCK(N) << 3)) + +/** + @ingroup Socket_register_group + @brief Fragment field value in IP header register(R/W) + @details @ref Sn_FRAG configures the FRAG(Fragment field in IP header). +*/ +#define Sn_FRAG(N) (_W5500_IO_BASE_ + (0x002D << 8) + (WIZCHIP_SREG_BLOCK(N) << 3)) + +/** + @ingroup Socket_register_group + @brief Keep Alive Timer register(R/W) + @details @ref Sn_KPALVTR configures the transmitting timer of �KEEP ALIVE(KA)packet of SOCKETn. It is valid only in TCP mode, + and ignored in other modes. The time unit is 5s. + KA packet is transmittable after @ref Sn_SR is changed to SOCK_ESTABLISHED and after the data is transmitted or received to/from a peer at least once. + In case of '@ref Sn_KPALVTR > 0', W5500 automatically transmits KA packet after time-period for checking the TCP connection (Auto-keepalive-process). + In case of '@ref Sn_KPALVTR = 0', Auto-keep-alive-process will not operate, + and KA packet can be transmitted by SEND_KEEP command by the host (Manual-keep-alive-process). + Manual-keep-alive-process is ignored in case of '@ref Sn_KPALVTR > 0'. +*/ +#define Sn_KPALVTR(N) (_W5500_IO_BASE_ + (0x002F << 8) + (WIZCHIP_SREG_BLOCK(N) << 3)) + +//#define Sn_TSR(N) (_W5500_IO_BASE_ + (0x0030 << 8) + (WIZCHIP_SREG_BLOCK(N) << 3)) + + +//----------------------------- W5500 Register values ----------------------------- + +/* MODE register values */ +/** + @brief Reset + @details If this bit is All internal registers will be initialized. It will be automatically cleared as after S/W reset. +*/ +#define MR_RST 0x80 + +/** + @brief Wake on LAN + @details 0 : Disable WOL mode\n + 1 : Enable WOL mode\n + If WOL mode is enabled and the received magic packet over UDP has been normally processed, the Interrupt PIN (INTn) asserts to low. + When using WOL mode, the UDP Socket should be opened with any source port number. (Refer to Socket n Mode Register (@ref Sn_MR) for opening Socket.) + @note The magic packet over UDP supported by W5500 consists of 6 bytes synchronization stream (xFFFFFFFFFFFF and + 16 times Target MAC address stream in UDP payload. The options such like password are ignored. You can use any UDP source port number for WOL mode. +*/ +#define MR_WOL 0x20 + +/** + @brief Ping block + @details 0 : Disable Ping block\n + 1 : Enable Ping block\n + If the bit is it blocks the response to a ping request. +*/ +#define MR_PB 0x10 + +/** + @brief Enable PPPoE + @details 0 : DisablePPPoE mode\n + 1 : EnablePPPoE mode\n + If you use ADSL, this bit should be +*/ +#define MR_PPPOE 0x08 + +/** + @brief Enable UDP_FORCE_ARP CHECHK + @details 0 : Disable Force ARP mode\n + 1 : Enable Force ARP mode\n + In Force ARP mode, It forces on sending ARP Request whenever data is sent. +*/ +#define MR_FARP 0x02 + +/* IR register values */ +/** + @brief Check IP conflict. + @details Bit is set as when own source IP address is same with the sender IP address in the received ARP request. +*/ +#define IR_CONFLICT 0x80 + +/** + @brief Get the destination unreachable message in UDP sending. + @details When receiving the ICMP (Destination port unreachable) packet, this bit is set as + When this bit is Destination Information such as IP address and Port number may be checked with the corresponding @ref UIPR & @ref UPORTR. +*/ +#define IR_UNREACH 0x40 + +/** + @brief Get the PPPoE close message. + @details When PPPoE is disconnected during PPPoE mode, this bit is set. +*/ +#define IR_PPPoE 0x20 + +/** + @brief Get the magic packet interrupt. + @details When WOL mode is enabled and receives the magic packet over UDP, this bit is set. +*/ +#define IR_MP 0x10 + + +/* PHYCFGR register value */ +#define PHYCFGR_RST ~(1<<7) //< For PHY reset, must operate AND mask. +#define PHYCFGR_OPMD (1<<6) // Configre PHY with OPMDC value +#define PHYCFGR_OPMDC_ALLA (7<<3) +#define PHYCFGR_OPMDC_PDOWN (6<<3) +#define PHYCFGR_OPMDC_NA (5<<3) +#define PHYCFGR_OPMDC_100FA (4<<3) +#define PHYCFGR_OPMDC_100F (3<<3) +#define PHYCFGR_OPMDC_100H (2<<3) +#define PHYCFGR_OPMDC_10F (1<<3) +#define PHYCFGR_OPMDC_10H (0<<3) +#define PHYCFGR_DPX_FULL (1<<2) +#define PHYCFGR_DPX_HALF (0<<2) +#define PHYCFGR_SPD_100 (1<<1) +#define PHYCFGR_SPD_10 (0<<1) +#define PHYCFGR_LNK_ON (1<<0) +#define PHYCFGR_LNK_OFF (0<<0) + +/* IMR register values */ +/** + @brief IP Conflict Interrupt Mask. + @details 0: Disable IP Conflict Interrupt\n + 1: Enable IP Conflict Interrupt +*/ +#define IM_IR7 0x80 + +/** + @brief Destination unreachable Interrupt Mask. + @details 0: Disable Destination unreachable Interrupt\n + 1: Enable Destination unreachable Interrupt +*/ +#define IM_IR6 0x40 + +/** + @brief PPPoE Close Interrupt Mask. + @details 0: Disable PPPoE Close Interrupt\n + 1: Enable PPPoE Close Interrupt +*/ +#define IM_IR5 0x20 + +/** + @brief Magic Packet Interrupt Mask. + @details 0: Disable Magic Packet Interrupt\n + 1: Enable Magic Packet Interrupt +*/ +#define IM_IR4 0x10 + +/* Sn_MR Default values */ +/** + @brief Support UDP Multicasting + @details 0 : disable Multicasting\n + 1 : enable Multicasting\n + This bit is applied only during UDP mode(P[3:0] = 010.\n + To use multicasting, @ref Sn_DIPR & @ref Sn_DPORT should be respectively configured with the multicast group IP address & port number + before Socket n is opened by OPEN command of @ref Sn_CR. +*/ +#define Sn_MR_MULTI 0x80 + +/** + @brief Broadcast block in UDP Multicasting. + @details 0 : disable Broadcast Blocking\n + 1 : enable Broadcast Blocking\n + This bit blocks to receive broadcasting packet during UDP mode(P[3:0] = 010.\m + In addition, This bit does when MACRAW mode(P[3:0] = 100 +*/ +#define Sn_MR_BCASTB 0x40 + +/** + @brief No Delayed Ack(TCP), Multicast flag + @details 0 : Disable No Delayed ACK option\n + 1 : Enable No Delayed ACK option\n + This bit is applied only during TCP mode (P[3:0] = 001.\n + When this bit is It sends the ACK packet without delay as soon as a Data packet is received from a peer.\n + When this bit is It sends the ACK packet after waiting for the timeout time configured by @ref _RTR_. +*/ +#define Sn_MR_ND 0x20 + +/** + @brief Unicast Block in UDP Multicasting + @details 0 : disable Unicast Blocking\n + 1 : enable Unicast Blocking\n + This bit blocks receiving the unicast packet during UDP mode(P[3:0] = 010 and MULTI = +*/ +#define Sn_MR_UCASTB 0x10 + +/** + @brief MAC LAYER RAW SOCK + @details This configures the protocol mode of Socket n. + @note MACRAW mode should be only used in Socket 0. +*/ +#define Sn_MR_MACRAW 0x04 + +#define Sn_MR_IPRAW 0x03 /**< IP LAYER RAW SOCK */ + +/** + @brief UDP + @details This configures the protocol mode of Socket n. +*/ +#define Sn_MR_UDP 0x02 + +/** + @brief TCP + @details This configures the protocol mode of Socket n. +*/ +#define Sn_MR_TCP 0x01 + +/** + @brief Unused socket + @details This configures the protocol mode of Socket n. +*/ +#define Sn_MR_CLOSE 0x00 + +/* Sn_MR values used with Sn_MR_MACRAW */ +/** + @brief MAC filter enable in @ref Sn_MR_MACRAW mode + @details 0 : disable MAC Filtering\n + 1 : enable MAC Filtering\n + This bit is applied only during MACRAW mode(P[3:0] = 100.\n + When set as W5500 can only receive broadcasting packet or packet sent to itself. + When this bit is W5500 can receive all packets on Ethernet. + If user wants to implement Hybrid TCP/IP stack, + it is recommended that this bit is set as for reducing host overhead to process the all received packets. +*/ +#define Sn_MR_MFEN Sn_MR_MULTI + +/** + @brief Multicast Blocking in @ref Sn_MR_MACRAW mode + @details 0 : using IGMP version 2\n + 1 : using IGMP version 1\n + This bit is applied only during UDP mode(P[3:0] = 010 and MULTI = + It configures the version for IGMP messages (Join/Leave/Report). +*/ +#define Sn_MR_MMB Sn_MR_ND + +/** + @brief IPv6 packet Blocking in @ref Sn_MR_MACRAW mode + @details 0 : disable IPv6 Blocking\n + 1 : enable IPv6 Blocking\n + This bit is applied only during MACRAW mode (P[3:0] = 100. It blocks to receiving the IPv6 packet. +*/ +#define Sn_MR_MIP6B Sn_MR_UCASTB + +/* Sn_MR value used with Sn_MR_UDP & Sn_MR_MULTI */ +/** + @brief IGMP version used in UDP mulitcasting + @details 0 : disable Multicast Blocking\n + 1 : enable Multicast Blocking\n + This bit is applied only when MACRAW mode(P[3:0] = 100. It blocks to receive the packet with multicast MAC address. +*/ +#define Sn_MR_MC Sn_MR_ND + +/* Sn_MR alternate values */ +/** + @brief For Berkeley Socket API +*/ +#define SOCK_STREAM Sn_MR_TCP + +/** + @brief For Berkeley Socket API +*/ +#define SOCK_DGRAM Sn_MR_UDP + + +/* Sn_CR values */ +/** + @brief Initialize or open socket + @details Socket n is initialized and opened according to the protocol selected in Sn_MR(P3:P0). + The table below shows the value of @ref Sn_SR corresponding to @ref Sn_MR.\n + + + + + + +
    \b Sn_MR (P[3:0]) \b Sn_SR
    Sn_MR_CLOSE (000)
    Sn_MR_TCP (001) SOCK_INIT (0x13)
    Sn_MR_UDP (010) SOCK_UDP (0x22)
    S0_MR_MACRAW (100) SOCK_MACRAW (0x02)
    +*/ +#define Sn_CR_OPEN 0x01 + +/** + @brief Wait connection request in TCP mode(Server mode) + @details This is valid only in TCP mode (\ref Sn_MR(P3:P0) = \ref Sn_MR_TCP). + In this mode, Socket n operates as a TCP serverand waits for connection-request (SYN packet) from any TCP client + The @ref Sn_SR changes the state from \ref SOCK_INIT to \ref SOCKET_LISTEN. + When a TCP clientconnection request is successfully established, + the @ref Sn_SR changes from SOCK_LISTEN to SOCK_ESTABLISHED and the @ref Sn_IR(0) becomes + But when a TCP clientconnection request is failed, @ref Sn_IR(3) becomes and the status of @ref Sn_SR changes to SOCK_CLOSED. +*/ +#define Sn_CR_LISTEN 0x02 + +/** + @brief Send connection request in TCP mode(Client mode) + @details To connect, a connect-request (SYN packet) is sent to TCP serverconfigured by @ref Sn_DIPR & Sn_DPORT(destination address & port). + If the connect-request is successful, the @ref Sn_SR is changed to @ref SOCK_ESTABLISHED and the Sn_IR(0) becomes \n\n + The connect-request fails in the following three cases.\n + 1. When a @b ARPTO occurs (@ref Sn_IR[3] = ) because destination hardware address is not acquired through the ARP-process.\n + 2. When a @b SYN/ACK packet is not received and @b TCPTO (Sn_IR(3) = )\n + 3. When a @b RST packet is received instead of a @b SYN/ACK packet. In these cases, @ref Sn_SR is changed to @ref SOCK_CLOSED. + @note This is valid only in TCP mode and operates when Socket n acts as TCP client +*/ +#define Sn_CR_CONNECT 0x04 + +/** + @brief Send closing request in TCP mode + @details Regardless of TCP serveror TCP client the DISCON command processes the disconnect-process (b>Active close    or Passive close.\n + @par Active close + it transmits disconnect-request(FIN packet) to the connected peer\n + @par Passive close + When FIN packet is received from peer, a FIN packet is replied back to the peer.\n + @details When the disconnect-process is successful (that is, FIN/ACK packet is received successfully), @ref Sn_SR is changed to @ref SOCK_CLOSED.\n + Otherwise, TCPTO occurs (\ref Sn_IR(3)='1') and then @ref Sn_SR is changed to @ref SOCK_CLOSED. + @note Valid only in TCP mode. +*/ +#define Sn_CR_DISCON 0x08 + +/** + @brief Close socket + @details Sn_SR is changed to @ref SOCK_CLOSED. +*/ +#define Sn_CR_CLOSE 0x10 + +/** + @brief Update TX buffer pointer and send data + @details SEND transmits all the data in the Socket n TX buffer.\n + For more details, please refer to Socket n TX Free Size Register (@ref Sn_TX_FSR), Socket n, + TX Write Pointer Register(@ref Sn_TX_WR), and Socket n TX Read Pointer Register(@ref Sn_TX_RD). +*/ +#define Sn_CR_SEND 0x20 + +/** + @brief Send data with MAC address, so without ARP process + @details The basic operation is same as SEND.\n + Normally SEND transmits data after destination hardware address is acquired by the automatic ARP-process(Address Resolution Protocol).\n + But SEND_MAC transmits data without the automatic ARP-process.\n + In this case, the destination hardware address is acquired from @ref Sn_DHAR configured by host, instead of APR-process. + @note Valid only in UDP mode. +*/ +#define Sn_CR_SEND_MAC 0x21 + +/** + @brief Send keep alive message + @details It checks the connection status by sending 1byte keep-alive packet.\n + If the peer can not respond to the keep-alive packet during timeout time, the connection is terminated and the timeout interrupt will occur. + @note Valid only in TCP mode. +*/ +#define Sn_CR_SEND_KEEP 0x22 + +/** + @brief Update RX buffer pointer and receive data + @details RECV completes the processing of the received data in Socket n RX Buffer by using a RX read pointer register (@ref Sn_RX_RD).\n + For more details, refer to Socket n RX Received Size Register (@ref Sn_RX_RSR), Socket n RX Write Pointer Register (@ref Sn_RX_WR), + and Socket n RX Read Pointer Register (@ref Sn_RX_RD). +*/ +#define Sn_CR_RECV 0x40 + +/* Sn_IR values */ +/** + @brief SEND_OK Interrupt + @details This is issued when SEND command is completed. +*/ +#define Sn_IR_SENDOK 0x10 + +/** + @brief TIMEOUT Interrupt + @details This is issued when ARPTO or TCPTO occurs. +*/ +#define Sn_IR_TIMEOUT 0x08 + +/** + @brief RECV Interrupt + @details This is issued whenever data is received from a peer. +*/ +#define Sn_IR_RECV 0x04 + +/** + @brief DISCON Interrupt + @details This is issued when FIN or FIN/ACK packet is received from a peer. +*/ +#define Sn_IR_DISCON 0x02 + +/** + @brief CON Interrupt + @details This is issued one time when the connection with peer is successful and then @ref Sn_SR is changed to @ref SOCK_ESTABLISHED. +*/ +#define Sn_IR_CON 0x01 + +/* Sn_SR values */ +/** + @brief Closed + @details This indicates that Socket n is released.\n + When DICON, CLOSE command is ordered, or when a timeout occurs, it is changed to @ref SOCK_CLOSED regardless of previous status. +*/ +#define SOCK_CLOSED 0x00 + +/** + @brief Initiate state + @details This indicates Socket n is opened with TCP mode.\n + It is changed to @ref SOCK_INIT when @ref Sn_MR(P[3:0]) = 001 and OPEN command is ordered.\n + After @ref SOCK_INIT, user can use LISTEN /CONNECT command. +*/ +#define SOCK_INIT 0x13 + +/** + @brief Listen state + @details This indicates Socket n is operating as TCP servermode and waiting for connection-request (SYN packet) from a peer TCP client.\n + It will change to @ref SOCK_ESTALBLISHED when the connection-request is successfully accepted.\n + Otherwise it will change to @ref SOCK_CLOSED after TCPTO @ref Sn_IR(TIMEOUT) = '1') is occurred. +*/ +#define SOCK_LISTEN 0x14 + +/** + @brief Connection state + @details This indicates Socket n sent the connect-request packet (SYN packet) to a peer.\n + It is temporarily shown when @ref Sn_SR is changed from @ref SOCK_INIT to @ref SOCK_ESTABLISHED by CONNECT command.\n + If connect-accept(SYN/ACK packet) is received from the peer at SOCK_SYNSENT, it changes to @ref SOCK_ESTABLISHED.\n + Otherwise, it changes to @ref SOCK_CLOSED after TCPTO (@ref Sn_IR[TIMEOUT] = '1') is occurred. +*/ +#define SOCK_SYNSENT 0x15 + +/** + @brief Connection state + @details It indicates Socket n successfully received the connect-request packet (SYN packet) from a peer.\n + If socket n sends the response (SYN/ACK packet) to the peer successfully, it changes to @ref SOCK_ESTABLISHED. \n + If not, it changes to @ref SOCK_CLOSED after timeout (@ref Sn_IR[TIMEOUT] = '1') is occurred. +*/ +#define SOCK_SYNRECV 0x16 + +/** + @brief Success to connect + @details This indicates the status of the connection of Socket n.\n + It changes to @ref SOCK_ESTABLISHED when the TCP SERVERprocessed the SYN packet from the TCP CLIENTduring @ref SOCK_LISTEN, or + when the CONNECT command is successful.\n + During @ref SOCK_ESTABLISHED, DATA packet can be transferred using SEND or RECV command. +*/ +#define SOCK_ESTABLISHED 0x17 + +/** + @brief Closing state + @details These indicate Socket n is closing.\n + These are shown in disconnect-process such as active-close and passive-close.\n + When Disconnect-process is successfully completed, or when timeout occurs, these change to @ref SOCK_CLOSED. +*/ +#define SOCK_FIN_WAIT 0x18 + +/** + @brief Closing state + @details These indicate Socket n is closing.\n + These are shown in disconnect-process such as active-close and passive-close.\n + When Disconnect-process is successfully completed, or when timeout occurs, these change to @ref SOCK_CLOSED. +*/ +#define SOCK_CLOSING 0x1A + +/** + @brief Closing state + @details These indicate Socket n is closing.\n + These are shown in disconnect-process such as active-close and passive-close.\n + When Disconnect-process is successfully completed, or when timeout occurs, these change to @ref SOCK_CLOSED. +*/ +#define SOCK_TIME_WAIT 0x1B + +/** + @brief Closing state + @details This indicates Socket n received the disconnect-request (FIN packet) from the connected peer.\n + This is half-closing status, and data can be transferred.\n + For full-closing, DISCON command is used. But For just-closing, CLOSE command is used. +*/ +#define SOCK_CLOSE_WAIT 0x1C + +/** + @brief Closing state + @details This indicates Socket n is waiting for the response (FIN/ACK packet) to the disconnect-request (FIN packet) by passive-close.\n + It changes to @ref SOCK_CLOSED when Socket n received the response successfully, or when timeout(@ref Sn_IR[TIMEOUT] = '1') is occurred. +*/ +#define SOCK_LAST_ACK 0x1D + +/** + @brief UDP socket + @details This indicates Socket n is opened in UDP mode(@ref Sn_MR(P[3:0]) = '010').\n + It changes to SOCK_UDP when @ref Sn_MR(P[3:0]) = '010' and @ref Sn_CR_OPEN command is ordered.\n + Unlike TCP mode, data can be transfered without the connection-process. +*/ +#define SOCK_UDP 0x22 + +#define SOCK_IPRAW 0x32 /**< IP raw mode socket */ + +/** + @brief MAC raw mode socket + @details This indicates Socket 0 is opened in MACRAW mode (S0_MR(P[3:0]) = 100and is valid only in Socket 0.\n + It changes to SOCK_MACRAW when S0_MR(P[3:0] = 100and OPEN command is ordered.\n + Like UDP mode socket, MACRAW mode Socket 0 can transfer a MAC packet (Ethernet frame) without the connection-process. +*/ +#define SOCK_MACRAW 0x42 + +//#define SOCK_PPPOE 0x5F + +/* IP PROTOCOL */ +#define IPPROTO_IP 0 //< Dummy for IP +#define IPPROTO_ICMP 1 //< Control message protocol +#define IPPROTO_IGMP 2 //< Internet group management protocol +#define IPPROTO_GGP 3 //< Gateway^2 (deprecated) +#define IPPROTO_TCP 6 //< TCP +#define IPPROTO_PUP 12 //< PUP +#define IPPROTO_UDP 17 //< UDP +#define IPPROTO_IDP 22 //< XNS idp +#define IPPROTO_ND 77 //< UNOFFICIAL net disk protocol +#define IPPROTO_RAW 255 //< Raw IP packet + + +/** + @brief Enter a critical section + + @details It is provided to protect your shared code which are executed without distribution. \n \n + + In non-OS environment, It can be just implemented by disabling whole interrupt.\n + In OS environment, You can replace it to critical section api supported by OS. + + \sa WIZCHIP_READ(), WIZCHIP_WRITE(), WIZCHIP_READ_BUF(), WIZCHIP_WRITE_BUF() + \sa WIZCHIP_CRITICAL_EXIT() +*/ +#define WIZCHIP_CRITICAL_ENTER() WIZCHIP.CRIS._enter() + +#ifdef _exit +#undef _exit +#endif + +/** + @brief Exit a critical section + + @details It is provided to protect your shared code which are executed without distribution. \n\n + + In non-OS environment, It can be just implemented by disabling whole interrupt. \n + In OS environment, You can replace it to critical section api supported by OS. + + @sa WIZCHIP_READ(), WIZCHIP_WRITE(), WIZCHIP_READ_BUF(), WIZCHIP_WRITE_BUF() + @sa WIZCHIP_CRITICAL_ENTER() +*/ +#define WIZCHIP_CRITICAL_EXIT() WIZCHIP.CRIS._exit() + + +//////////////////////// +// Basic I/O Function // +//////////////////////// + +/** + @ingroup Basic_IO_function + @brief It reads 1 byte value from a register. + @param AddrSel Register address + @return The value of register +*/ +uint8_t WIZCHIP_READ(uint32_t AddrSel); + +/** + @ingroup Basic_IO_function + @brief It writes 1 byte value to a register. + @param AddrSel Register address + @param wb Write data + @return void +*/ +void WIZCHIP_WRITE(uint32_t AddrSel, uint8_t wb); + +/** + @ingroup Basic_IO_function + @brief It reads sequence data from registers. + @param AddrSel Register address + @param pBuf Pointer buffer to read data + @param len Data length +*/ +void WIZCHIP_READ_BUF(uint32_t AddrSel, uint8_t* pBuf, uint16_t len); + +/** + @ingroup Basic_IO_function + @brief It writes sequence data to registers. + @param AddrSel Register address + @param pBuf Pointer buffer to write data + @param len Data length +*/ +void WIZCHIP_WRITE_BUF(uint32_t AddrSel, uint8_t* pBuf, uint16_t len); + +///////////////////////////////// +// Common Register I/O function // +///////////////////////////////// +/** + @ingroup Common_register_access_function + @brief Set Mode Register + @param (uint8_t)mr The value to be set. + @sa getMR() +*/ +#define setMR(mr) \ + WIZCHIP_WRITE(MR,mr) + + +/** + @ingroup Common_register_access_function + @brief Get Mode Register + @return uint8_t. The value of Mode register. + @sa setMR() +*/ +#define getMR() \ + WIZCHIP_READ(MR) + +/** + @ingroup Common_register_access_function + @brief Set gateway IP address + @param (uint8_t*)gar Pointer variable to set gateway IP address. It should be allocated 4 bytes. + @sa getGAR() +*/ +#define setGAR(gar) \ + WIZCHIP_WRITE_BUF(GAR,gar,4) + +/** + @ingroup Common_register_access_function + @brief Get gateway IP address + @param (uint8_t*)gar Pointer variable to get gateway IP address. It should be allocated 4 bytes. + @sa setGAR() +*/ +#define getGAR(gar) \ + WIZCHIP_READ_BUF(GAR,gar,4) + +/** + @ingroup Common_register_access_function + @brief Set subnet mask address + @param (uint8_t*)subr Pointer variable to set subnet mask address. It should be allocated 4 bytes. + @sa getSUBR() +*/ +#define setSUBR(subr) \ + WIZCHIP_WRITE_BUF(SUBR, subr,4) + + +/** + @ingroup Common_register_access_function + @brief Get subnet mask address + @param (uint8_t*)subr Pointer variable to get subnet mask address. It should be allocated 4 bytes. + @sa setSUBR() +*/ +#define getSUBR(subr) \ + WIZCHIP_READ_BUF(SUBR, subr, 4) + +/** + @ingroup Common_register_access_function + @brief Set local MAC address + @param (uint8_t*)shar Pointer variable to set local MAC address. It should be allocated 6 bytes. + @sa getSHAR() +*/ +#define setSHAR(shar) \ + WIZCHIP_WRITE_BUF(SHAR, shar, 6) + +/** + @ingroup Common_register_access_function + @brief Get local MAC address + @param (uint8_t*)shar Pointer variable to get local MAC address. It should be allocated 6 bytes. + @sa setSHAR() +*/ +#define getSHAR(shar) \ + WIZCHIP_READ_BUF(SHAR, shar, 6) + +/** + @ingroup Common_register_access_function + @brief Set local IP address + @param (uint8_t*)sipr Pointer variable to set local IP address. It should be allocated 4 bytes. + @sa getSIPR() +*/ +#define setSIPR(sipr) \ + WIZCHIP_WRITE_BUF(SIPR, sipr, 4) + +/** + @ingroup Common_register_access_function + @brief Get local IP address + @param (uint8_t*)sipr Pointer variable to get local IP address. It should be allocated 4 bytes. + @sa setSIPR() +*/ +#define getSIPR(sipr) \ + WIZCHIP_READ_BUF(SIPR, sipr, 4) + +/** + @ingroup Common_register_access_function + @brief Set INTLEVEL register + @param (uint16_t)intlevel Value to set @ref INTLEVEL register. + @sa getINTLEVEL() +*/ +#define setINTLEVEL(intlevel) {\ + WIZCHIP_WRITE(INTLEVEL, (uint8_t)(intlevel >> 8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(INTLEVEL,1), (uint8_t) intlevel); \ + } + + +/** + @ingroup Common_register_access_function + @brief Get INTLEVEL register + @return uint16_t. Value of @ref INTLEVEL register. + @sa setINTLEVEL() +*/ +//M20150401 : Type explict declaration +/* + #define getINTLEVEL() \ + ((WIZCHIP_READ(INTLEVEL) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(INTLEVEL,1))) +*/ +#define getINTLEVEL() \ + (((uint16_t)WIZCHIP_READ(INTLEVEL) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(INTLEVEL,1))) + +/** + @ingroup Common_register_access_function + @brief Set @ref IR register + @param (uint8_t)ir Value to set @ref IR register. + @sa getIR() +*/ +#define setIR(ir) \ + WIZCHIP_WRITE(IR, (ir & 0xF0)) + +/** + @ingroup Common_register_access_function + @brief Get @ref IR register + @return uint8_t. Value of @ref IR register. + @sa setIR() +*/ +#define getIR() \ + (WIZCHIP_READ(IR) & 0xF0) +/** + @ingroup Common_register_access_function + @brief Set @ref _IMR_ register + @param (uint8_t)imr Value to set @ref _IMR_ register. + @sa getIMR() +*/ +#define setIMR(imr) \ + WIZCHIP_WRITE(_IMR_, imr) + +/** + @ingroup Common_register_access_function + @brief Get @ref _IMR_ register + @return uint8_t. Value of @ref _IMR_ register. + @sa setIMR() +*/ +#define getIMR() \ + WIZCHIP_READ(_IMR_) + +/** + @ingroup Common_register_access_function + @brief Set @ref SIR register + @param (uint8_t)sir Value to set @ref SIR register. + @sa getSIR() +*/ +#define setSIR(sir) \ + WIZCHIP_WRITE(SIR, sir) + +/** + @ingroup Common_register_access_function + @brief Get @ref SIR register + @return uint8_t. Value of @ref SIR register. + @sa setSIR() +*/ +#define getSIR() \ + WIZCHIP_READ(SIR) +/** + @ingroup Common_register_access_function + @brief Set @ref SIMR register + @param (uint8_t)simr Value to set @ref SIMR register. + @sa getSIMR() +*/ +#define setSIMR(simr) \ + WIZCHIP_WRITE(SIMR, simr) + +/** + @ingroup Common_register_access_function + @brief Get @ref SIMR register + @return uint8_t. Value of @ref SIMR register. + @sa setSIMR() +*/ +#define getSIMR() \ + WIZCHIP_READ(SIMR) + +/** + @ingroup Common_register_access_function + @brief Set @ref _RTR_ register + @param (uint16_t)rtr Value to set @ref _RTR_ register. + @sa getRTR() +*/ +#define setRTR(rtr) {\ + WIZCHIP_WRITE(_RTR_, (uint8_t)(rtr >> 8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(_RTR_,1), (uint8_t) rtr); \ + } + +/** + @ingroup Common_register_access_function + @brief Get @ref _RTR_ register + @return uint16_t. Value of @ref _RTR_ register. + @sa setRTR() +*/ +//M20150401 : Type explict declaration +/* + #define getRTR() \ + ((WIZCHIP_READ(_RTR_) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(_RTR_,1))) +*/ +#define getRTR() \ + (((uint16_t)WIZCHIP_READ(_RTR_) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(_RTR_,1))) + + +/** + @ingroup Common_register_access_function + @brief Set @ref _RCR_ register + @param (uint8_t)rcr Value to set @ref _RCR_ register. + @sa getRCR() +*/ +#define setRCR(rcr) \ + WIZCHIP_WRITE(_RCR_, rcr) + +/** + @ingroup Common_register_access_function + @brief Get @ref _RCR_ register + @return uint8_t. Value of @ref _RCR_ register. + @sa setRCR() +*/ +#define getRCR() \ + WIZCHIP_READ(_RCR_) + +//================================================== test done =========================================================== + +/** + @ingroup Common_register_access_function + @brief Set @ref PTIMER register + @param (uint8_t)ptimer Value to set @ref PTIMER register. + @sa getPTIMER() +*/ +#define setPTIMER(ptimer) \ + WIZCHIP_WRITE(PTIMER, ptimer) + +/** + @ingroup Common_register_access_function + @brief Get @ref PTIMER register + @return uint8_t. Value of @ref PTIMER register. + @sa setPTIMER() +*/ +#define getPTIMER() \ + WIZCHIP_READ(PTIMER) + +/** + @ingroup Common_register_access_function + @brief Set @ref PMAGIC register + @param (uint8_t)pmagic Value to set @ref PMAGIC register. + @sa getPMAGIC() +*/ +#define setPMAGIC(pmagic) \ + WIZCHIP_WRITE(PMAGIC, pmagic) + +/** + @ingroup Common_register_access_function + @brief Get @ref PMAGIC register + @return uint8_t. Value of @ref PMAGIC register. + @sa setPMAGIC() +*/ +#define getPMAGIC() \ + WIZCHIP_READ(PMAGIC) + +/** + @ingroup Common_register_access_function + @brief Set @ref PHAR address + @param (uint8_t*)phar Pointer variable to set PPP destination MAC register address. It should be allocated 6 bytes. + @sa getPHAR() +*/ +#define setPHAR(phar) \ + WIZCHIP_WRITE_BUF(PHAR, phar, 6) + +/** + @ingroup Common_register_access_function + @brief Get @ref PHAR address + @param (uint8_t*)phar Pointer variable to PPP destination MAC register address. It should be allocated 6 bytes. + @sa setPHAR() +*/ +#define getPHAR(phar) \ + WIZCHIP_READ_BUF(PHAR, phar, 6) + +/** + @ingroup Common_register_access_function + @brief Set @ref PSID register + @param (uint16_t)psid Value to set @ref PSID register. + @sa getPSID() +*/ +#define setPSID(psid) {\ + WIZCHIP_WRITE(PSID, (uint8_t)(psid >> 8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(PSID,1), (uint8_t) psid); \ + } + +/** + @ingroup Common_register_access_function + @brief Get @ref PSID register + @return uint16_t. Value of @ref PSID register. + @sa setPSID() +*/ +//uint16_t getPSID(void); +//M20150401 : Type explict declaration +/* + #define getPSID() \ + ((WIZCHIP_READ(PSID) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(PSID,1))) +*/ +#define getPSID() \ + (((uint16_t)WIZCHIP_READ(PSID) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(PSID,1))) + +/** + @ingroup Common_register_access_function + @brief Set @ref PMRU register + @param (uint16_t)pmru Value to set @ref PMRU register. + @sa getPMRU() +*/ +#define setPMRU(pmru) { \ + WIZCHIP_WRITE(PMRU, (uint8_t)(pmru>>8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(PMRU,1), (uint8_t) pmru); \ + } + +/** + @ingroup Common_register_access_function + @brief Get @ref PMRU register + @return uint16_t. Value of @ref PMRU register. + @sa setPMRU() +*/ +//M20150401 : Type explict declaration +/* + #define getPMRU() \ + ((WIZCHIP_READ(PMRU) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(PMRU,1))) +*/ +#define getPMRU() \ + (((uint16_t)WIZCHIP_READ(PMRU) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(PMRU,1))) + +/** + @ingroup Common_register_access_function + @brief Get unreachable IP address + @param (uint8_t*)uipr Pointer variable to get unreachable IP address. It should be allocated 4 bytes. +*/ +//M20150401 : Size Error of UIPR (6 -> 4) +/* + #define getUIPR(uipr) \ + WIZCHIP_READ_BUF(UIPR,uipr,6) +*/ +#define getUIPR(uipr) \ + WIZCHIP_READ_BUF(UIPR,uipr,4) + +/** + @ingroup Common_register_access_function + @brief Get @ref UPORTR register + @return uint16_t. Value of @ref UPORTR register. +*/ +//M20150401 : Type explict declaration +/* + #define getUPORTR() \ + ((WIZCHIP_READ(UPORTR) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(UPORTR,1))) +*/ +#define getUPORTR() \ + (((uint16_t)WIZCHIP_READ(UPORTR) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(UPORTR,1))) + +/** + @ingroup Common_register_access_function + @brief Set @ref PHYCFGR register + @param (uint8_t)phycfgr Value to set @ref PHYCFGR register. + @sa getPHYCFGR() +*/ +#define setPHYCFGR(phycfgr) \ + WIZCHIP_WRITE(PHYCFGR, phycfgr) + +/** + @ingroup Common_register_access_function + @brief Get @ref PHYCFGR register + @return uint8_t. Value of @ref PHYCFGR register. + @sa setPHYCFGR() +*/ +#define getPHYCFGR() \ + WIZCHIP_READ(PHYCFGR) + +/** + @ingroup Common_register_access_function + @brief Get @ref VERSIONR register + @return uint8_t. Value of @ref VERSIONR register. +*/ +#define getVERSIONR() \ + WIZCHIP_READ(VERSIONR) + +///////////////////////////////////// + +/////////////////////////////////// +// Socket N register I/O function // +/////////////////////////////////// +/** + @ingroup Socket_register_access_function + @brief Set @ref Sn_MR register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @param (uint8_t)mr Value to set @ref Sn_MR + @sa getSn_MR() +*/ +#define setSn_MR(sn, mr) \ + WIZCHIP_WRITE(Sn_MR(sn),mr) + +/** + @ingroup Socket_register_access_function + @brief Get @ref Sn_MR register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @return uint8_t. Value of @ref Sn_MR. + @sa setSn_MR() +*/ +#define getSn_MR(sn) \ + WIZCHIP_READ(Sn_MR(sn)) + +/** + @ingroup Socket_register_access_function + @brief Set @ref Sn_CR register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @param (uint8_t)cr Value to set @ref Sn_CR + @sa getSn_CR() +*/ +#define setSn_CR(sn, cr) \ + WIZCHIP_WRITE(Sn_CR(sn), cr) + +/** + @ingroup Socket_register_access_function + @brief Get @ref Sn_CR register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @return uint8_t. Value of @ref Sn_CR. + @sa setSn_CR() +*/ +#define getSn_CR(sn) \ + WIZCHIP_READ(Sn_CR(sn)) + +/** + @ingroup Socket_register_access_function + @brief Set @ref Sn_IR register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @param (uint8_t)ir Value to set @ref Sn_IR + @sa getSn_IR() +*/ +#define setSn_IR(sn, ir) \ + WIZCHIP_WRITE(Sn_IR(sn), (ir & 0x1F)) + +/** + @ingroup Socket_register_access_function + @brief Get @ref Sn_IR register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @return uint8_t. Value of @ref Sn_IR. + @sa setSn_IR() +*/ +#define getSn_IR(sn) \ + (WIZCHIP_READ(Sn_IR(sn)) & 0x1F) + +/** + @ingroup Socket_register_access_function + @brief Set @ref Sn_IMR register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @param (uint8_t)imr Value to set @ref Sn_IMR + @sa getSn_IMR() +*/ +#define setSn_IMR(sn, imr) \ + WIZCHIP_WRITE(Sn_IMR(sn), (imr & 0x1F)) + +/** + @ingroup Socket_register_access_function + @brief Get @ref Sn_IMR register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @return uint8_t. Value of @ref Sn_IMR. + @sa setSn_IMR() +*/ +#define getSn_IMR(sn) \ + (WIZCHIP_READ(Sn_IMR(sn)) & 0x1F) + +/** + @ingroup Socket_register_access_function + @brief Get @ref Sn_SR register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @return uint8_t. Value of @ref Sn_SR. +*/ +#define getSn_SR(sn) \ + WIZCHIP_READ(Sn_SR(sn)) + +/** + @ingroup Socket_register_access_function + @brief Set @ref Sn_PORT register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @param (uint16_t)port Value to set @ref Sn_PORT. + @sa getSn_PORT() +*/ +#define setSn_PORT(sn, port) { \ + WIZCHIP_WRITE(Sn_PORT(sn), (uint8_t)(port >> 8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(Sn_PORT(sn),1), (uint8_t) port); \ + } +#define setSn_PORTR setSn_PORT +/** + @ingroup Socket_register_access_function + @brief Get @ref Sn_PORT register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @return uint16_t. Value of @ref Sn_PORT. + @sa setSn_PORT() +*/ +//M20150401 : Type explict declaration +/* + #define getSn_PORT(sn) \ + ((WIZCHIP_READ(Sn_PORT(sn)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_PORT(sn),1))) +*/ +#define getSn_PORT(sn) \ + (((uint16_t)WIZCHIP_READ(Sn_PORT(sn)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_PORT(sn),1))) + +/** + @ingroup Socket_register_access_function + @brief Set @ref Sn_DHAR register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @param (uint8_t*)dhar Pointer variable to set socket n destination hardware address. It should be allocated 6 bytes. + @sa getSn_DHAR() +*/ +#define setSn_DHAR(sn, dhar) \ + WIZCHIP_WRITE_BUF(Sn_DHAR(sn), dhar, 6) + +/** + @ingroup Socket_register_access_function + @brief Get @ref Sn_MR register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @param (uint8_t*)dhar Pointer variable to get socket n destination hardware address. It should be allocated 6 bytes. + @sa setSn_DHAR() +*/ +#define getSn_DHAR(sn, dhar) \ + WIZCHIP_READ_BUF(Sn_DHAR(sn), dhar, 6) + +/** + @ingroup Socket_register_access_function + @brief Set @ref Sn_DIPR register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @param (uint8_t*)dipr Pointer variable to set socket n destination IP address. It should be allocated 4 bytes. + @sa getSn_DIPR() +*/ +#define setSn_DIPR(sn, dipr) \ + WIZCHIP_WRITE_BUF(Sn_DIPR(sn), dipr, 4) + +/** + @ingroup Socket_register_access_function + @brief Get @ref Sn_DIPR register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @param (uint8_t*)dipr Pointer variable to get socket n destination IP address. It should be allocated 4 bytes. + @sa setSn_DIPR() +*/ +#define getSn_DIPR(sn, dipr) \ + WIZCHIP_READ_BUF(Sn_DIPR(sn), dipr, 4) + +/** + @ingroup Socket_register_access_function + @brief Set @ref Sn_DPORT register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @param (uint16_t)dport Value to set @ref Sn_DPORT + @sa getSn_DPORT() +*/ +#define setSn_DPORT(sn, dport) { \ + WIZCHIP_WRITE(Sn_DPORT(sn), (uint8_t) (dport>>8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(Sn_DPORT(sn),1), (uint8_t) dport); \ + } +#define setSn_DPORTR(sn, dport) setSn_DPORT(sn,dport) ///< For compatible ioLibrary. Refer to @ref Sn_DPORTR. + +/** + @ingroup Socket_register_access_function + @brief Get @ref Sn_DPORT register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @return uint16_t. Value of @ref Sn_DPORT. + @sa setSn_DPORT() +*/ +//M20150401 : Type explict declaration +/* + #define getSn_DPORT(sn) \ + ((WIZCHIP_READ(Sn_DPORT(sn)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_DPORT(sn),1))) +*/ +#define getSn_DPORT(sn) \ + (((uint16_t)WIZCHIP_READ(Sn_DPORT(sn)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_DPORT(sn),1))) +#define getSn_DPORTR(sn) getSn_DPORT(sn) +/** + @ingroup Socket_register_access_function + @brief Set @ref Sn_MSSR register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @param (uint16_t)mss Value to set @ref Sn_MSSR + @sa setSn_MSSR() +*/ +#define setSn_MSSR(sn, mss) { \ + WIZCHIP_WRITE(Sn_MSSR(sn), (uint8_t)(mss>>8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(Sn_MSSR(sn),1), (uint8_t) mss); \ + } + +/** + @ingroup Socket_register_access_function + @brief Get @ref Sn_MSSR register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @return uint16_t. Value of @ref Sn_MSSR. + @sa setSn_MSSR() +*/ +//M20150401 : Type explict declaration +/* + #define getSn_MSSR(sn) \ + ((WIZCHIP_READ(Sn_MSSR(sn)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_MSSR(sn),1))) +*/ +#define getSn_MSSR(sn) \ + (((uint16_t)WIZCHIP_READ(Sn_MSSR(sn)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_MSSR(sn),1))) + +/** + @ingroup Socket_register_access_function + @brief Set @ref Sn_TOS register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @param (uint8_t)tos Value to set @ref Sn_TOS + @sa getSn_TOS() +*/ +#define setSn_TOS(sn, tos) \ + WIZCHIP_WRITE(Sn_TOS(sn), tos) + +/** + @ingroup Socket_register_access_function + @brief Get @ref Sn_TOS register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @return uint8_t. Value of Sn_TOS. + @sa setSn_TOS() +*/ +#define getSn_TOS(sn) \ + WIZCHIP_READ(Sn_TOS(sn)) + +/** + @ingroup Socket_register_access_function + @brief Set @ref Sn_TTL register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @param (uint8_t)ttl Value to set @ref Sn_TTL + @sa getSn_TTL() +*/ +#define setSn_TTL(sn, ttl) \ + WIZCHIP_WRITE(Sn_TTL(sn), ttl) + + +/** + @ingroup Socket_register_access_function + @brief Get @ref Sn_TTL register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @return uint8_t. Value of @ref Sn_TTL. + @sa setSn_TTL() +*/ +#define getSn_TTL(sn) \ + WIZCHIP_READ(Sn_TTL(sn)) + + +/** + @ingroup Socket_register_access_function + @brief Set @ref Sn_RXBUF_SIZE register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @param (uint8_t)rxbufsize Value to set @ref Sn_RXBUF_SIZE + @sa getSn_RXBUF_SIZE() +*/ +#define setSn_RXBUF_SIZE(sn, rxbufsize) \ + WIZCHIP_WRITE(Sn_RXBUF_SIZE(sn),rxbufsize) + + +/** + @ingroup Socket_register_access_function + @brief Get @ref Sn_RXBUF_SIZE register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @return uint8_t. Value of @ref Sn_RXBUF_SIZE. + @sa setSn_RXBUF_SIZE() +*/ +#define getSn_RXBUF_SIZE(sn) \ + WIZCHIP_READ(Sn_RXBUF_SIZE(sn)) + +/** + @ingroup Socket_register_access_function + @brief Set @ref Sn_TXBUF_SIZE register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @param (uint8_t)txbufsize Value to set @ref Sn_TXBUF_SIZE + @sa getSn_TXBUF_SIZE() +*/ +#define setSn_TXBUF_SIZE(sn, txbufsize) \ + WIZCHIP_WRITE(Sn_TXBUF_SIZE(sn), txbufsize) + +/** + @ingroup Socket_register_access_function + @brief Get @ref Sn_TXBUF_SIZE register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @return uint8_t. Value of @ref Sn_TXBUF_SIZE. + @sa setSn_TXBUF_SIZE() +*/ +#define getSn_TXBUF_SIZE(sn) \ + WIZCHIP_READ(Sn_TXBUF_SIZE(sn)) + +/** + @ingroup Socket_register_access_function + @brief Get @ref Sn_TX_FSR register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @return uint16_t. Value of @ref Sn_TX_FSR. +*/ +uint16_t getSn_TX_FSR(uint8_t sn); + +/** + @ingroup Socket_register_access_function + @brief Get @ref Sn_TX_RD register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @return uint16_t. Value of @ref Sn_TX_RD. +*/ +//M20150401 : Type explict declaration +/* + #define getSn_TX_RD(sn) \ + ((WIZCHIP_READ(Sn_TX_RD(sn)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_TX_RD(sn),1))) +*/ +#define getSn_TX_RD(sn) \ + (((uint16_t)WIZCHIP_READ(Sn_TX_RD(sn)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_TX_RD(sn),1))) + +/** + @ingroup Socket_register_access_function + @brief Set @ref Sn_TX_WR register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @param (uint16_t)txwr Value to set @ref Sn_TX_WR + @sa GetSn_TX_WR() +*/ +#define setSn_TX_WR(sn, txwr) { \ + WIZCHIP_WRITE(Sn_TX_WR(sn), (uint8_t)(txwr>>8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(Sn_TX_WR(sn),1), (uint8_t) txwr); \ + } + +/** + @ingroup Socket_register_access_function + @brief Get @ref Sn_TX_WR register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @return uint16_t. Value of @ref Sn_TX_WR. + @sa setSn_TX_WR() +*/ +//M20150401 : Type explict declaration +/* + #define getSn_TX_WR(sn) \ + ((WIZCHIP_READ(Sn_TX_WR(sn)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_TX_WR(sn),1))) +*/ +#define getSn_TX_WR(sn) \ + (((uint16_t)WIZCHIP_READ(Sn_TX_WR(sn)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_TX_WR(sn),1))) + + +/** + @ingroup Socket_register_access_function + @brief Get @ref Sn_RX_RSR register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @return uint16_t. Value of @ref Sn_RX_RSR. +*/ +uint16_t getSn_RX_RSR(uint8_t sn); + + +/** + @ingroup Socket_register_access_function + @brief Set @ref Sn_RX_RD register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @param (uint16_t)rxrd Value to set @ref Sn_RX_RD + @sa getSn_RX_RD() +*/ +#define setSn_RX_RD(sn, rxrd) { \ + WIZCHIP_WRITE(Sn_RX_RD(sn), (uint8_t)(rxrd>>8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(Sn_RX_RD(sn),1), (uint8_t) rxrd); \ + } + +/** + @ingroup Socket_register_access_function + @brief Get @ref Sn_RX_RD register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @return uint16_t. Value of @ref Sn_RX_RD. + @sa setSn_RX_RD() +*/ +//M20150401 : Type explict declaration +/* + #define getSn_RX_RD(sn) \ + ((WIZCHIP_READ(Sn_RX_RD(sn)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_RX_RD(sn),1))) +*/ +#define getSn_RX_RD(sn) \ + (((uint16_t)WIZCHIP_READ(Sn_RX_RD(sn)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_RX_RD(sn),1))) + +/** + @ingroup Socket_register_access_function + @brief Get @ref Sn_RX_WR register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @return uint16_t. Value of @ref Sn_RX_WR. +*/ +//M20150401 : Type explict declaration +/* + #define getSn_RX_WR(sn) \ + ((WIZCHIP_READ(Sn_RX_WR(sn)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_RX_WR(sn),1))) +*/ +#define getSn_RX_WR(sn) \ + (((uint16_t)WIZCHIP_READ(Sn_RX_WR(sn)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_RX_WR(sn),1))) + +/** + @ingroup Socket_register_access_function + @brief Set @ref Sn_FRAG register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @param (uint16_t)frag Value to set @ref Sn_FRAG + @sa getSn_FRAD() +*/ +#define setSn_FRAG(sn, frag) { \ + WIZCHIP_WRITE(Sn_FRAG(sn), (uint8_t)(frag >>8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(Sn_FRAG(sn),1), (uint8_t) frag); \ + } + +/** + @ingroup Socket_register_access_function + @brief Get @ref Sn_FRAG register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @return uint16_t. Value of @ref Sn_FRAG. + @sa setSn_FRAG() +*/ +//M20150401 : Type explict declaration +/* + #define getSn_FRAG(sn) \ + ((WIZCHIP_READ(Sn_FRAG(sn)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_FRAG(sn),1))) +*/ +#define getSn_FRAG(sn) \ + (((uint16_t)WIZCHIP_READ(Sn_FRAG(sn)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(Sn_FRAG(sn),1))) + +/** + @ingroup Socket_register_access_function + @brief Set @ref Sn_KPALVTR register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @param (uint8_t)kpalvt Value to set @ref Sn_KPALVTR + @sa getSn_KPALVTR() +*/ +#define setSn_KPALVTR(sn, kpalvt) \ + WIZCHIP_WRITE(Sn_KPALVTR(sn), kpalvt) + +/** + @ingroup Socket_register_access_function + @brief Get @ref Sn_KPALVTR register + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @return uint8_t. Value of @ref Sn_KPALVTR. + @sa setSn_KPALVTR() +*/ +#define getSn_KPALVTR(sn) \ + WIZCHIP_READ(Sn_KPALVTR(sn)) + +////////////////////////////////////// + +///////////////////////////////////// +// Sn_TXBUF & Sn_RXBUF IO function // +///////////////////////////////////// +/** + @brief Socket_register_access_function + @brief Gets the max buffer size of socket sn passed as parameter. + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @return uint16_t. Value of Socket n RX max buffer size. +*/ +//M20150401 : Type explict declaration +/* + #define getSn_RxMAX(sn) \ + (getSn_RXBUF_SIZE(sn) << 10) +*/ +#define getSn_RxMAX(sn) \ + (((uint16_t)getSn_RXBUF_SIZE(sn)) << 10) + +/** + @brief Socket_register_access_function + @brief Gets the max buffer size of socket sn passed as parameters. + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @return uint16_t. Value of Socket n TX max buffer size. +*/ +//M20150401 : Type explict declaration +/* + #define getSn_TxMAX(sn) \ + (getSn_TXBUF_SIZE(sn) << 10) +*/ +#define getSn_TxMAX(sn) \ + (((uint16_t)getSn_TXBUF_SIZE(sn)) << 10) + +/** + @ingroup Basic_IO_function + @brief It copies data to internal TX memory + + @details This function reads the Tx write pointer register and after that, + it copies the wizdata(pointer buffer) of the length of len(variable) bytes to internal TX memory + and updates the Tx write pointer register. + This function is being called by send() and sendto() function also. + + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @param wizdata Pointer buffer to write data + @param len Data length + @sa wiz_recv_data() +*/ +void wiz_send_data(uint8_t sn, uint8_t *wizdata, uint16_t len); + +/** + @ingroup Basic_IO_function + @brief It copies data to your buffer from internal RX memory + + @details This function read the Rx read pointer register and after that, + it copies the received data from internal RX memory + to wizdata(pointer variable) of the length of len(variable) bytes. + This function is being called by recv() also. + + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @param wizdata Pointer buffer to read data + @param len Data length + @sa wiz_send_data() +*/ +void wiz_recv_data(uint8_t sn, uint8_t *wizdata, uint16_t len); + +/** + @ingroup Basic_IO_function + @brief It discard the received data in RX memory. + @details It discards the data of the length of len(variable) bytes in internal RX memory. + @param (uint8_t)sn Socket number. It should be 0 ~ 7. + @param len Data length +*/ +void wiz_recv_ignore(uint8_t sn, uint16_t len); + +/// @cond DOXY_APPLY_CODE +#endif +/// @endcond + +#ifdef __cplusplus +} +#endif + +#endif // _W5500_H_ diff --git a/Ethernet/W6100/w6100.c b/Ethernet/W6100/w6100.c new file mode 100644 index 0000000..4cc19e2 --- /dev/null +++ b/Ethernet/W6100/w6100.c @@ -0,0 +1,272 @@ +//***************************************************************************** +// +//! \file w6100.c +//! \brief W6100 HAL Implements file. +//! \version 1.0.0 +//! \date 2019/01/01 +//! \par Revision history +//! <2019/01/01> 1st Release +//! \author MidnightCow +//! \copyright +//! +//! Copyright (c) 2019, WIZnet Co., LTD. +//! +//! 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 "w6100.h" + + + +#define _WIZCHIP_SPI_VDM_OP_ 0x00 +#define _WIZCHIP_SPI_FDM_LEN1_ 0x01 +#define _WIZCHIP_SPI_FDM_LEN2_ 0x02 +#define _WIZCHIP_SPI_FDM_LEN4_ 0x03 +// +// If you want to use SPI FDM mode, Feel free contact to WIZnet. +// http://forum.wiznet.io +// + +#if _WIZCHIP_ == 6100 +//////////////////////////////////////////////////////////////////////////////////////// + + +#define _W6100_SPI_OP_ _WIZCHIP_SPI_VDM_OP_ + +////////////////////////////////////////////////// +void WIZCHIP_WRITE(uint32_t AddrSel, uint8_t wb) { + uint8_t tAD[4]; + tAD[0] = (uint8_t)((AddrSel & 0x00FF0000) >> 16); + tAD[1] = (uint8_t)((AddrSel & 0x0000FF00) >> 8); + tAD[2] = (uint8_t)(AddrSel & 0x000000ff); + tAD[3] = wb; + + WIZCHIP_CRITICAL_ENTER(); + WIZCHIP.CS._select(); + +#if( (_WIZCHIP_IO_MODE_ == _WIZCHIP_IO_MODE_SPI_VDM_)) + tAD[2] |= (_W6100_SPI_WRITE_ | _W6100_SPI_OP_); + if (!WIZCHIP.IF.SPI._write_burst) { // byte operation + WIZCHIP.IF.SPI._write_byte(tAD[0]); + WIZCHIP.IF.SPI._write_byte(tAD[1]); + WIZCHIP.IF.SPI._write_byte(tAD[2]); + WIZCHIP.IF.SPI._write_byte(tAD[3]); + } else { + WIZCHIP.IF.SPI._write_burst(tAD, 4); + } +#elif ( (_WIZCHIP_IO_MODE_ == _WIZCHIP_IO_MODE_BUS_INDIR_) ) +#if 1 + // 20231103 taylor + WIZCHIP.IF.BUS._write_data_buf(IDM_AR0, tAD, 4, 1); +#else + WIZCHIP.IF.BUS._write_data(IDM_AR0, tAD, 4, 1); +#endif +#else +#error "Unknown _WIZCHIP_IO_MODE_ in W6100. !!!" +#endif + + WIZCHIP.CS._deselect(); + WIZCHIP_CRITICAL_EXIT(); +} + +uint8_t WIZCHIP_READ(uint32_t AddrSel) { + uint8_t ret; + uint8_t tAD[3]; + tAD[0] = (uint8_t)((AddrSel & 0x00FF0000) >> 16); + tAD[1] = (uint8_t)((AddrSel & 0x0000FF00) >> 8); + tAD[2] = (uint8_t)(AddrSel & 0x000000ff); + + WIZCHIP_CRITICAL_ENTER(); + WIZCHIP.CS._select(); + +#if( (_WIZCHIP_IO_MODE_ == _WIZCHIP_IO_MODE_SPI_VDM_)) + tAD[2] |= (_W6100_SPI_READ_ | _W6100_SPI_OP_); + if (!WIZCHIP.IF.SPI._read_burst || !WIZCHIP.IF.SPI._write_burst) { // byte operation + WIZCHIP.IF.SPI._write_byte(tAD[0]); + WIZCHIP.IF.SPI._write_byte(tAD[1]); + WIZCHIP.IF.SPI._write_byte(tAD[2]); + } else { + WIZCHIP.IF.SPI._write_burst(tAD, 3); + } + ret = WIZCHIP.IF.SPI._read_byte(); +#elif ( (_WIZCHIP_IO_MODE_ == _WIZCHIP_IO_MODE_BUS_INDIR_) ) + WIZCHIP.IF.BUS._write_data_buf(IDM_AR0, tAD, 3, 1); + ret = WIZCHIP.IF.BUS._read_data(IDM_DR); +#else +#error "Unknown _WIZCHIP_IO_MODE_ in W6100. !!!" +#endif + + WIZCHIP.CS._deselect(); + WIZCHIP_CRITICAL_EXIT(); + return ret; +} + +void WIZCHIP_WRITE_BUF(uint32_t AddrSel, uint8_t* pBuf, uint16_t len) { + uint8_t tAD[3]; + uint16_t i = 0; + + tAD[0] = (uint8_t)((AddrSel & 0x00FF0000) >> 16); + tAD[1] = (uint8_t)((AddrSel & 0x0000FF00) >> 8); + tAD[2] = (uint8_t)(AddrSel & 0x000000ff); + + WIZCHIP_CRITICAL_ENTER(); + WIZCHIP.CS._select(); + +#if((_WIZCHIP_IO_MODE_ == _WIZCHIP_IO_MODE_SPI_VDM_)) + tAD[2] |= (_W6100_SPI_WRITE_ | _W6100_SPI_OP_); + if (!WIZCHIP.IF.SPI._write_burst) { // byte operation + WIZCHIP.IF.SPI._write_byte(tAD[0]); + WIZCHIP.IF.SPI._write_byte(tAD[1]); + WIZCHIP.IF.SPI._write_byte(tAD[2]); + for (i = 0; i < len; i++) { + WIZCHIP.IF.SPI._write_byte(pBuf[i]); + } + } else { + WIZCHIP.IF.SPI._write_burst(tAD, 3); + WIZCHIP.IF.SPI._write_burst(pBuf, len); + } +#elif ( (_WIZCHIP_IO_MODE_ == _WIZCHIP_IO_MODE_BUS_INDIR_) ) + WIZCHIP.IF.BUS._write_data_buf(IDM_AR0, tAD, 3, 1); + WIZCHIP.IF.BUS._write_data_buf(IDM_DR, pBuf, len, 0); +#else +#error "Unknown _WIZCHIP_IO_MODE_ in W6100. !!!!" +#endif + + WIZCHIP.CS._deselect(); + WIZCHIP_CRITICAL_EXIT(); +} + +void WIZCHIP_READ_BUF(uint32_t AddrSel, uint8_t* pBuf, uint16_t len) { + uint8_t tAD[3]; + uint16_t i; + tAD[0] = (uint8_t)((AddrSel & 0x00FF0000) >> 16); + tAD[1] = (uint8_t)((AddrSel & 0x0000FF00) >> 8); + tAD[2] = (uint8_t)(AddrSel & 0x000000ff); + + WIZCHIP_CRITICAL_ENTER(); + WIZCHIP.CS._select(); + +#if((_WIZCHIP_IO_MODE_ == _WIZCHIP_IO_MODE_SPI_VDM_)) + tAD[2] |= (_W6100_SPI_READ_ | _W6100_SPI_OP_); + if (!WIZCHIP.IF.SPI._read_burst || !WIZCHIP.IF.SPI._write_burst) { // byte operation + WIZCHIP.IF.SPI._write_byte(tAD[0]); + WIZCHIP.IF.SPI._write_byte(tAD[1]); + WIZCHIP.IF.SPI._write_byte(tAD[2]); + for (i = 0; i < len; len++) { + pBuf[i] = WIZCHIP.IF.SPI._read_byte(); + } + } else { + WIZCHIP.IF.SPI._write_burst(tAD, 3); + WIZCHIP.IF.SPI._read_burst(pBuf, len); + } + +#elif ( (_WIZCHIP_IO_MODE_ == _WIZCHIP_IO_MODE_BUS_INDIR_) ) + WIZCHIP.IF.BUS._write_data_buf(IDM_AR0, tAD, 3, 1); + WIZCHIP.IF.BUS._read_data_buf(IDM_DR, pBuf, len, 0); +#else +#error "Unknown _WIZCHIP_IO_MODE_ in W6100. !!!!" +#endif + WIZCHIP.CS._deselect(); + WIZCHIP_CRITICAL_EXIT(); +} + +uint16_t getSn_TX_FSR(uint8_t sn) { + uint16_t prev_val = -1, val = 0; + do { + prev_val = val; + val = WIZCHIP_READ(_Sn_TX_FSR_(sn)); + val = (val << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(_Sn_TX_FSR_(sn), 1)); + } while (val != prev_val); + return val; +} + +uint16_t getSn_RX_RSR(uint8_t sn) { + uint16_t prev_val = -1, val = 0; + do { + prev_val = val; + val = WIZCHIP_READ(_Sn_RX_RSR_(sn)); + val = (val << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(_Sn_RX_RSR_(sn), 1)); + } while (val != prev_val); + return val; +} + +void wiz_send_data(uint8_t sn, uint8_t *wizdata, uint16_t len) { + uint16_t ptr = 0; + uint32_t addrsel = 0; + ptr = getSn_TX_WR(sn); + addrsel = ((uint32_t)ptr << 8) + WIZCHIP_TXBUF_BLOCK(sn); + WIZCHIP_WRITE_BUF(addrsel, wizdata, len); + ptr += len; + setSn_TX_WR(sn, ptr); +} + +void wiz_recv_data(uint8_t sn, uint8_t *wizdata, uint16_t len) { + uint16_t ptr = 0; + uint32_t addrsel = 0; + if (len == 0) { + return; + } + ptr = getSn_RX_RD(sn); + addrsel = ((uint32_t)ptr << 8) + WIZCHIP_RXBUF_BLOCK(sn); + WIZCHIP_READ_BUF(addrsel, wizdata, len); + ptr += len; + setSn_RX_RD(sn, ptr); +} + +void wiz_recv_ignore(uint8_t sn, uint16_t len) { + setSn_RX_RD(sn, getSn_RX_RD(sn) + len); +} + +#if 1 +// 20231019 taylor +void wiz_delay_ms(uint32_t milliseconds) { + uint32_t i; + for (i = 0 ; i < milliseconds ; i++) { + //Write any values to clear the TCNTCLKR register + setTCNTRCLR(0xff); + + // Wait until counter register value reaches 10.(10 = 1ms : TCNTR is 100us tick counter register) + while (getTCNTR() < 0x0a) {} + } +} +#endif + +/// @cond DOXY_APPLY_CODE +#if (_PHY_IO_MODE_ == _PHY_IO_MODE_MII_) +/// @endcond +void wiz_mdio_write(uint8_t phyregaddr, uint16_t var) { + setPHYRAR(phyregaddr); + setPHYDIR(var); + setPHYACR(PHYACR_WRITE); + while (getPHYACR()); //wait for command complete +} + +uint16_t wiz_mdio_read(uint8_t phyregaddr) { + setPHYRAR(phyregaddr); + setPHYACR(PHYACR_READ); + while (getPHYACR()); //wait for command complete + return getPHYDOR(); +} +/// @cond DOXY_APPLY_CODE +#endif +/// @endcond + +//////////////////////////////////////////////////////////////////////////////////////// +#endif diff --git a/Ethernet/W6100/w6100.h b/Ethernet/W6100/w6100.h new file mode 100644 index 0000000..16ea8c9 --- /dev/null +++ b/Ethernet/W6100/w6100.h @@ -0,0 +1,4086 @@ +//* **************************************************************************** +//! \file w6100.h +//! \brief W6100 HAL Header File. +//! \version 1.0.0 +//! \date 2019/01/01 +//! \par Revision history +//! <2019/01/01> 1st Release +//! \author MidnightCow +//! \copyright +//! +//! Copyright (c) 2019, WIZnet Co., LTD. +//! +//! 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 _W6100_H_ +#define _W6100_H_ + +#include +#include "wizchip_conf.h" + + +#ifdef __cplusplus +extern "C" { +#endif + +/// @cond DOXY_APPLY_CODE +#if (_WIZCHIP_ == W6100) +/// @endcond + +#define _W6100_SPI_READ_ (0x00 << 2) ///< SPI interface Read operation in Control Phase +#define _W6100_SPI_WRITE_ (0x01 << 2) ///< SPI interface Write operation in Control Phase + +#define WIZCHIP_CREG_BLOCK (0x00 <<3) ///< Common register block +#define WIZCHIP_SREG_BLOCK(N) ((1+4*N)<<3) ///< SOCKETn register block +#define WIZCHIP_TXBUF_BLOCK(N) ((2+4*N)<<3) ///< SOCKETn Tx buffer address block +#define WIZCHIP_RXBUF_BLOCK(N) ((3+4*N)<<3) ///< SOCKETn Rx buffer address block + +#define WIZCHIP_OFFSET_INC(ADDR, N) (ADDR + (N<<8)) ///< Increase offset address + +#if (_WIZCHIP_IO_MODE_ == _WIZCHIP_IO_MODE_BUS_INDIR_) +#define IDM_AR0 ((_WIZCHIP_IO_BASE_ + 0x0000)) ///< Indirect High Address Register +#define IDM_AR1 ((_WIZCHIP_IO_BASE_ + 0x0001)) ///< Indirect Low Address Register +#define IDM_BSR ((_WIZCHIP_IO_BASE_ + 0x0002)) ///< Block Select Register +#define IDM_DR ((_WIZCHIP_IO_BASE_ + 0x0003)) ///< Indirect Data Register +#define _W6100_IO_BASE_ _WIZCHIP_IO_BASE_ +#elif (_WIZCHIP_IO_MODE_ & _WIZCHIP_IO_MODE_SPI_) +#define _W6100_IO_BASE_ 0x00000000 +#endif + + +//----------- defgroup -------------------------------- + +/** + @defgroup W6100 W6100 + @brief @ref _WIZCHIP_ register defines and I/O functions + @details + - @ref WIZCHIP_register_W6100 : @ref Common_register_group_W6100, @ref Socket_register_group_W6100 + - @ref WIZCHIP_IO_Functions_W6100 : @ref Basic_IO_function_W6100, @ref Common_register_access_function_W6100, @ref Socket_register_access_function_W6100 +*/ + +/** + @defgroup WIZCHIP_register_W6100 WIZCHIP register + @ingroup W6100 + @brief @ref WIZCHIP_register_W6100 defines register group of @b W6100. + @details + - @ref Common_register_group_W6100 : Common register group W6100 + - @ref Socket_register_group_W6100 : SOCKET n register group W6100 +*/ + +/** + @defgroup Basic_IO_function_W6100 Basic I/O function + @ingroup WIZCHIP_IO_Functions_W6100 + @brief These are basic input/output functions to read values from register or write values to register. +*/ + +/** + @defgroup Common_register_access_function_W6100 Common register access functions + @ingroup WIZCHIP_IO_Functions_W6100 + @brief These are functions to access @ref Common_register_group_W6100. +*/ + +/** + @defgroup Socket_register_access_function_W6100 Socket register access functions + @ingroup WIZCHIP_IO_Functions_W6100 + @brief These are functions to access @ref Socket_register_group_W6100. +*/ + +/** + @defgroup WIZCHIP_IO_Functions_W6100 WIZCHIP I/O functions + @ingroup W6100 + @brief @ref WIZCHIP_IO_Functions_W6100 supports the basic I/O functions for @ref WIZCHIP_register_W6100. + @details + - @ref WIZCHIP_IO_Functions_W6100 \n + WIZCHIP_READ(), WIZCHIP_WRITE(), WIZCHIP_READ_BUF(), WIZCHIP_WRITE_BUF() + - @ref Common_register_access_function_W6100 \n + - @ref _WIZCHIP_ Mode \n + getCIDR(), getVER() \n + getSYSR() \n + setCHPLCKR(), setNETLCKR(), setPHYLCKR() \n + setSYCR0(), getSYCR1(), setSYCR1() + - Network Mode \n + getNET4MR(), setNET4MR(), getNET6MR(), setNET6MR(), getNETMR(), setNETMR(), getNETMR2(), setNETMR2() + - Interrupt \n + getIR(), setIRCLR(), getIMR(), setIMR() \n + getSIR(), getSIMR(), setSIMR() \n + getSLIR(), setSLIRCLR(), getSLIMR(), setSLIMR() \n + getINTPTMR(), setINTPTMR() + - Network Information \n + NETLOCK(), NETUNLOCK() \n + getSHAR(), setSHAR(), getGAR(), setGAR(), getSUBR(), setSUBR(), getSIPR(), setSIPR() \n + getLLAR(), setLLAR(), getGUAR(), setGUAR(), getGA6R(), setGA6R(), getSUB6R(), setSUB6R() \n + getPLR(), getPFR(), getVLTR(), getPLTR(), getPAR() \n + - SOCKET-less Commands for PING, ARP and IPv6 Auto-Configuration \n + getSLCR(), setSLCR() \n + getPINGIDR(), setPINGIDR(), getPINGSEQR(), setPINGSEQR() \n + getSLDHAR(), getSLDIPR(), setSLDIPR(), getSLDIP4R(), setSLDIP4R(), getSLDIP6R(), setSLDIP6R(), getSLHOPR(), setSLHOPR() \n + - Retransmission \n + getRCR(), setRCR() \n + getSLRCR(), setSLRCR(), getSLRTR(), setSLRTR() \n + - ICMP \n + getUIPR(), getUIP6R(), getUPORTR(), getUPORT6R() \n + getICMP6BLKR(), setICMP6BLKR() \n + - PPPoE \n + getPTMR(), setPTMR(), getPMNR(), getPMNR() \n + getPHAR(), setPHAR(), getPSIDR(), setPSIDR(), getPMRUR(), setPMRUR() + - PHY Configuration \n + getPHYSR(), setPHYLCKR(), PHYLOCK(), PHYUNLOCK() \n + setPHYCR0(), getPHYCR1(), setPHYCR1() \n + getPHYRAR(), setPHYRAR(), setPHYDIR(), getPHYDOR(), getPHYACR(), setPHYACR(), getPHYDIVR(), setPHYDIVR() + - etc \n + getTCNTR(), setTCNTRCLR() + - @ref Socket_register_access_function_W6100 \n + - SOCKET control \n + getSn_MR(), setSn_MR(), getSn_MR2(), setSn_MR2(), getSn_PSR(), setSn_PSR(), getSn_CR(), setSn_CR() \n + getSn_IR(), setSn_IRCLR(), getSn_IMR(), setSn_IMR() \n + getSn_RTR(), setSn_RTR(), getSn_RCR(), setSn_RCR(), getSn_KPALVTR(), setSn_KPALVTR() + - SOCKET information \n + getSn_SR(), getSn_ESR() \n + getSn_DHAR(), setSn_DHAR(), getSn_PORTR(), setSn_PORTR(), getSn_DPORTR(), setSn_DPORTR() \n + getSn_DIPR(), setSn_DIPR(), getSn_DIP6R(), setSn_DIP6R() \n + getSn_MSSR(), setSn_MSSR() + - SOCKET communication \n + getSn_RX_BSR(), setSn_RX_BSR(), getSn_TX_BSR(), setSn_TX_BSR() \n + getSn_TX_RD(), getSn_TX_WR(), setSn_TX_WR() \n + getSn_RX_RD(), setSn_RX_RD(), getSn_RX_WR() \n + getSn_TX_FSR(), getSn_RX_RSR() + - IP header field \n + getSn_FRGR(), setSn_FRGR(), getSn_TOSR(), setSn_TOSR() \n + getSn_TTLR(), setSn_TTLR() +*/ + +/** + @defgroup Common_register_group_W6100 Common register + @ingroup WIZCHIP_register_W6100 + @brief Common register group \n + @details It set the general configuration such as interrupt, network information, ICMP, and etc. + @sa + + + + + + + + + + + + +
    @ref _WIZCHIP_ Information : _CIDR_, _VER_
    @ref _WIZCHIP_ Mode : _SYSR_, _SYCR0_, _SYCR1_, _CHPLCKR_, _NETLCKR_, _PHYLCKR_
    Network Mode : _NET4MR_, _NET6MR_, _NETMR_, _NETMR2_
    Network Information : _GAR_, _SUBR_, _SHAR_, _SIPR_, _GA6R_, _LLAR_, _GUAR_, _SUB6R_
    Interrupt : _IR_, _IRCLR_, _IMR_, _SIR_, _SIMR_, _SLIR_, _SLIMR_, _SLIRCLR_, _INTPTMR_
    Data retransmission : _RTR_, _RCR_, _SLRTR_, _SLRCR_, _SLHOPR_
    PPPoE : _PHAR_, _PSIDR_, _PMRUR_, _PTMR_, _PMNR_
    SOCKET-less command : _SLCR_, _SLIR_, _SLDIPR_, _SLDIP4R_, _SLDIP6R_, _SLDHAR_, _PINGIDR_, _PINGSEQR_
    ICMP v4 & v6 : _UIPR_, _UPORTR_, _UIP6R_, _UPORT6R_, _ICMP6BLKR_
    IPv6 Auto-configuration : _PLR_, _PFR_, _VLTR_, _PAR_
    PHY Configuration : _PHYSR_, _PHYCR0_, _PHYCR1_, _PHYRAR_, _PHYDIR_, _PHYDOR_, _PHYACR_, _PHYDIVR_
    +*/ + + +/** + @defgroup Socket_register_group_W6100 Socket register + @ingroup WIZCHIP_register_W6100 + @brief Socket register group\n + @details + SOCKETn registers configure and control SOCKETn which is necessary to data communication. + @sa + + + + + + +
    SOCKETn Control : _Sn_MR_, _Sn_MR2_, _Sn_CR_, _Sn_IR_, _Sn_IRCLR_, _Sn_IMR_, _Sn_PSR_
    SOCKETn Information : _Sn_SR_, _Sn_ESR_, _Sn_PORTR_, _Sn_DHAR_, _Sn_DIPR_, _Sn_DIP6R_, _Sn_DPORTR_
    SOCKETn Retransmission : _Sn_RTR_, _Sn_RCR_
    Internet protocol : _Sn_MSSR_, _Sn_TOSR_, _Sn_TTLR_, _Sn_FRGR_
    Data communication : _Sn_RX_BSR_, _Sn_TX_BSR_, _Sn_TX_FSR_, _Sn_TX_RD_, _Sn_TX_WR_, _Sn_RX_RSR_, _Sn_RX_RD_, _Sn_RX_WR_
    +*/ + +//----------------------------------------------------------------------------------- + +//----------------------------- W6100 Common Registers IOMAP ----------------------------- + +/** + @addtogroup Common_register_group_W6100 + @{ +*/ + +/** + @brief Chip Identification Register address [RO] [0x6100] + @sa getCIDR() +*/ +#define _CIDR_ (_W6100_IO_BASE_ + (0x0000 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief Chip Version Register address [RO] [0x4661] + @sa getVER() +*/ +#define _VER_ (_W6100_IO_BASE_ + (0x0002 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief System Status Register address [RO] [0xEU] + @details @ref _SYSR_ shows the information such as CHIP, NET, PHY Locking and Host I/F + + + +
    7 6 5 4 ~ 2 1 0
    CHPL NETL PHYL Reserved IND SPI
    + - @ref SYSR_CHPL + - @ref SYSR_NETL + - @ref SYSR_PHYL + - @ref SYSR_IND : HOST use Parallel BUS Interface(Indirect Bus Mode) + - @ref SYSR_SPI : HOST use SPI Interface + + @sa _CHPLCKR_, _NETLCKR_, _PHYLCKR_, + @sa getSYSR(), setCHPLCKR(), getCHPLCKR(), CHIPLOCK(), CHIPUNLOCK(), setNETLCKR(), getNETLCKR(), NETLOCK(), NETUNLOCK() \n + setPHYLCKR(), getPHYLCKR(), PHYLOCK(), PHYUNLOCK() +*/ +#define _SYSR_ (_W6100_IO_BASE_ + (0x2000 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief System Config Register 0 address [WO][0x80] + @details @ref _SYCR0_ softly reset to _WIZCHIP_. + + + +
    7 6 ~ 0
    RST Reserved
    + - @ref SYCR0_RST : Software Reset. + + @note It can be accessed only when @ref SYSR_CHPL = 1. + @sa _CHPLCKR_, _SYSR_, SYSR_CHPL + @sa setSYCR0(), setCHPLCKR(), getCHPLCKR(), CHIPLOCK(), CHIPUNLOCK(), getSYSR() +*/ +#define _SYCR0_ (_W6100_IO_BASE_ + (0x2004 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief System Config Register 1 address [R=W][0x80] + @details @ref _SYCR1_ controls the global interrupt enable, and selects the system clock. + + + +
    7 6 ~ 1 0
    IEN Reserved CLKSEL
    + - @ref SYCR1_IEN + - @ref SYCR1_CLKSEL + + @note SYCR1_CLKSEL bit can be accessed only when @ref SYSR_CHPL = 1. + @sa _CHPLCKR_, _SYSR_, SYSR_CHPL + @sa getSYCR1(), setSYCR1(), setCHPLCKR(), getCHPLCKR(), CHIPLOCK(), CHIPUNLOCK(), getSYSR() +*/ +#define _SYCR1_ (WIZCHIP_OFFSET_INC(_SYCR0_,1)) + +/** + @brief Ticker Counter Register address [RO][0x0000] + @details @ref _TCNTR_ increase by 1 every 100us after _WIZCHIP_ reset. + @sa _TCNTRCLR_ + @sa getTCNTR(), setTCNTRCLR() +*/ +#define _TCNTR_ (_W6100_IO_BASE_ + (0x2016 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief Ticker Counter Clear Register address [RO][0x00] + @details @ref _TCNTRCLR_ clear @ref _TCNTR_. + @sa setTCNTRCLR(), getTCNTR() +*/ +#define _TCNTRCLR_ (_W6100_IO_BASE_ + (0x2020 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief Interrupt Register address [RO][0x00] + @details @ref _IR_ indicates the interrupt status. + If @ref _IR_ is not equal to x00 INTn PIN is asserted to low until it is x00. + + + + +
    7 6 ~ 5 4 3 2 1 0
    WOL Reserved UNR6 Reserved IPCONF UNR4 PTERM
    + - @ref IR_WOL : Wake On LAN + - @ref IR_UNR6 : Destination Port Unreachable for IPv6 + - @ref IR_IPCONF : @ref _SIPR_ is Conflict + - @ref IR_UNR4 : Destination Port Unreachable for IPv4 + - @ref IR_PTERM : PPPoE Terminated + + @sa _IMR_, _IRCLR_, SYCR1_IEN, _CHIPLCKR_, _SYSR_, SYSR_CHPL + @sa getIR(), setIRCLR(), getSYCR1(), setSYCR1(), getCHPLCKR(), setCHPLCKR(), CHIPLOCK(), CHIPUNLOCK(), getSYSR() +*/ +#define _IR_ (_W6100_IO_BASE_ + (0x2100 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief SOCKET Interrupt Register address [RO][0x00] + @details @ref _SIR_ indicates whether a socket interrupt is occurred or not.\n + Each bit of @ref _SIR_ be still until @ref _Sn_IR_ is cleared by @ref _Sn_IRCLR_ + @sa _SIMR_, _Sn_IR_, _Sn_IRCLR_, _Sn_IMR_, SYCR1_IEN , _CHIPLCKR_, _SYSR_, SYSR_CHPL + @sa getSIR(), getSn_IR(), setSn_IRCLR(), getSIMR(), setSIMR(), getSn_IMR(), setSn_IMR(), getSYCR1(), setSYCR1(), \n + getSYCR1(), setSYCR1(), getCHPLCKR(), setCHPLCKR(), CHIPLOCK(), CHIPUNLOCK(), getSYSR() +*/ +#define _SIR_ (_W6100_IO_BASE_ + (0x2101 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief SOCKET-less Interrupt Register address [RO][0x00] + @details @ref _SLIR_ indicates the completion of @ref _SLCR_ or timeout. + + + +
    7 6 5 4 3 2 1 0
    TOUT ARP4 PING4 ARP6 PING6 NS RS RA
    + - @ref SLIR_TOUT : The timeout occurrence after @ref _SLCR_ is performed + - @ref SLIR_ARP4 : The completion of @ref SLCR_ARP4 + - @ref SLIR_PING4 : The completion of @ref SLCR_PING4 + - @ref SLIR_ARP6 : The completion f @ref SLCR_ARP6 + - @ref SLIR_PING6 : The completion of @ref SLCR_PING6 + - @ref SLIR_NS : The completion of @ref SLCR_NS + - @ref SLIR_RS : The completion of @ref SLIR_RS + - @ref SLIR_RA : The reception from Router Advertisement + + @sa _SLIRCLR_, _SLIMR_, SYCR1_IEN, _CHPLCKR_, _SYSR_, SYSR_CHPL + @sa getSLIR(), setSLIRCLR(), getSLIR(), getSLIMR(), setSLIMR(), \n + getSYCR1(), setSYCR1(), getCHPLCKR(), setCHPLCKR(), CHIPLOCK(), CHIPUNLOCK(), getSYSR() +*/ +#define _SLIR_ (_W6100_IO_BASE_ + (0x2102 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief Interrupt Mask Register address [R=W][0x00] + @details @ref _IMR_ is used to mask interrupts of @ref _IR_.\n + When a bit of @ref _IMR_ and the corresponding bit of @ref _IR_ is set, an interrupt will be issued. + @sa _IR_, SYCR1_IEN, _CHPLCKR_, _SYSR_, SYSR_CHPL + @sa getIMR(), setIMR(), getIR(), setIRCLR(), \n + getSYCR1(), setSYCR1(), getCHPLCKR(), setCHPLCKR(), CHIPLOCK(), CHIPUNLOCK(), getSYSR() +*/ +#define _IMR_ (_W6100_IO_BASE_ + (0x2104 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief @ref _IR_ Clear Register address [WO][0x00] + @details @ref _IRCLR_ clears @ref _IR_ + @sa _IR_, _IMR_, SYCR1_IEN, _CHPLCKR_, _SYSR_, SYSR_CHPL + @sa setIRCLR(), getIR(), getIMR(), getSYCR1(), setSYCR1(), getCHPLCKR(), setCHPLCKR(), CHIPLOCK(), CHIPUNLOCK(), getSYSR() +*/ +#define _IRCLR_ (_W6100_IO_BASE_ + (0x2108 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief SOCKET Interrupt Mask Register address [R=W]][0x00] + @details @ref _SIMR_ is used to mask interrupts of @ref _SIR_.\n + When a bit of @ref _SIMR_ and the corresponding bit of @ref _SIR_ is set, an interrupt will be issued.\n + when @ref _Sn_IR_ is not 0, The N-th bit of @ref _SIR_ is set. Otherwise, this bit is automatically clear.\n + @sa _SIR_, _Sn_IR_, _Sn_IRCLR_, _Sn_IMR_, SYCR1_IEN, _CHPLCKR_, _SYSR_, SYSR_CHPL + @sa getSIMR(), setSIMR(), getSIR(), setSn_IRCLR(), getSn_IMR(), setSn_IMR(), \n + getSYCR1(), setSYCR1(), getCHPLCKR(), setCHPLCKR(), CHIPLOCK(), CHIPUNLOCK(), getSYSR() +*/ +#define _SIMR_ (_W6100_IO_BASE_ + (0x2114 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief SOCKET-less Interrupt Mask Register address [R=W][0x00] + @details @ref _SLIMR_ is used to mask interrupts of @ref _SLIR_\n + When a bit of @ref _SLIMR_ and the corresponding bit of @ref _SLIR_ is set, an interrupt will be issued. + @sa _SLIR_, _SLIRCLR_, SYCR1_IEN, _CHPLCKR_, _SYSR_, SYSR_CHPL + @sa getSLIMR(), setSLIMR(), getSLIR(), setSLIRCLR(), \n + getSYCR1(), setSYCR1(), getCHPLCKR(), setCHPLCKR(), CHIPLOCK(), CHIPUNLOCK(), getSYSR() +*/ +#define _SLIMR_ (_W6100_IO_BASE_ + (0x2124 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief SOCKET-less Interrupt Clear Register address [WO][0x00] + @details @ref _SLIRCLR_ clears @ref _SLIR_ + @sa _SLIR_, _SLIRCLR_, _SLIMR_, SYCR1_IEN, _CHPLCKR_, _SYSR_, SYSR_CHPL + @sa getSLIR(), setSLIRCLR(), getSLIMR(), setSLIMR(), \n + getSYCR1(), setSYCR1(), getCHPLCKR(), setCHPLCKR(), CHIPLOCK(), CHIPUNLOCK(), getSYSR() +*/ +#define _SLIRCLR_ (_W6100_IO_BASE_ + (0x2128 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief SOCKET-less Prefer Source IPv6 Address Register address [R=W][0x00] + @details @ref _SLPSR_ select the Source IPv6 Address to transmit a packet by @ref _SLCR_. + - @ref PSR_AUTO + - @ref PSR_LLA + - @ref PSR_GUA + @sa _SLCR_, _Sn_PSR_ + @sa getSLPSR(), setSLPSR(), getSLCR(), setSLCR(), getSn_PSR(), setSn_PSR() +*/ +#define _SLPSR_ (_W6100_IO_BASE_ + (0x212C << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief SOCKET-less Command Register address [RW,AC][0x00] + @details @ref _SLCR_ can be request a message such like as ARP, PING, and ICMPv6 without SOCKET. + + + +
    7 6 5 4 3 2 1 0
    Reserved ARP4 PING4 ARP6 PING6 NS RS UNA
    + - @ref SLCR_ARP4 + - @ref SLCR_PING4 + - @ref SLCR_ARP6 + - @ref SLCR_PING6 + - @ref SLCR_NS + - @ref SLCR_RS + - @ref SLCR_UNA + + @sa _SLIR_, _SLIMR_, _SLDIPR_, _SLDIP4R_, _SLDIP6R_, _SLDHAR_, SYCR1_IEN, _CHPLCKR_, _SYSR_, SYSR_CHPL + @sa getSLCR(), setSLCR(), getSLIR(), setSLIRCLR(), getSLIMR(), setSLIMR(), getSLDIPR(),setSLDIPR(), getSLDIP4R(),setSLDIP4R(), + getSLDIP6R(), setSLDIP6R(), getSLDHAR(), getSYCR1(), setSYCR1(), getCHPLCKR(), setCHPLCKR(), CHIPLOCK(), CHIPUNLOCK(), getSYSR() +*/ +#define _SLCR_ (_W6100_IO_BASE_ + (0x2130 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief PHY Status Register address [RO][0x00] + @details @ref _PHYSR_ shows the operation mode of PHY, the link status and etc. + - @ref PHYSR_CAB : @ref PHYSR_CAB_OFF, @ref PHYSR_CAB_ON + - @ref PHYSR_MODE : @ref PHYSR_MODE_AUTO, @ref PHYSR_MODE_100F, @ref PHYSR_MODE_100H, @ref PHYSR_MODE_10F, @ref PHYSR_MODE_10H + - @ref PHYSR_DPX : @ref PHYSR_DPX_FULL, @ref PHYSR_DPX_HALF + - @ref PHYSR_SPD : @ref PHYSR_SPD_100M, @ref PHYSR_SPD_10M + - @ref PHYSR_LNK : @ref PHYSR_LNK_UP, @ref PHYSR_LNK_DOWN + + @sa _PHYCR0_, _PHYLCKR_, _SYSR_, SYSR_PHYL + @sa getPHYSR(), setPHYCR0(), setPHYLCKR(), getPHYLCKR(), PHYLOCK(), PHYUNLOCK(), getSYSR() +*/ +#define _PHYSR_ (_W6100_IO_BASE_ + (0x3000 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief PHY Internal Register Address Register address(R/W) + @details @ref _PHYRAR_ specifies the address of register in the Ethernet PHY. + - @ref PHYRAR_BMCR + - @ref PHYRAR_BMSR + @sa _PHYACR_, _PHYDOR_, _PHYDIR_, _PHYDIVR_ + @sa getPHYACR(), setPHYACR(), getPHYDOR(), setPHYDIR(), getPHYDIVR(), setPHYDIVR() +*/ +#define _PHYRAR_ (_W6100_IO_BASE_ + (0x3008 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief PHY Data Input Register address [R=W][0x00] + @details @ref _PHYDIR_ specifies the value to write to the register in PHY + @sa _PHYRAR_, _PHYACR_, _PHYDOR_, _PHYDIVR_ + @sa setPHYDIR(), getPHYRAR(), setPHYRAR(), getPHYACR(), setPHYACR(), getPHYDOR(), setPHYDIR(), getPHYDIVR(), setPHYDIVR() +*/ +#define _PHYDIR_ (_W6100_IO_BASE_ + (0x300C << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief PHY Data Output Register address [WO][0x00] + @details @ref _PHYDOR_ read the value from the register in PHY + @sa _PHYRAR_, _PHYACR_, _PHYDIR_, _PHYDIVR_ + @sa getPHYDOR(), getPHYRAR(), setPHYRAR(), getPHYACR(), setPHYACR(), setPHYDIR(), getPHYDIVR(), setPHYDIVR() +*/ +#define _PHYDOR_ (_W6100_IO_BASE_ + (0x3010 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief PHY Access Register address [RW,AC][0x00] + @details @ref _PHYACR_ write(read) to(from) the value of register in the Ethernet PHY + - @ref PHYACR_READ + - @ref PHYACR_WRITE + @sa _PHYRAR_, _PHYDOR_, _PHYDIR_, _PHYDIVR_ + @sa getPHYACR(), setPHYACR(), getPHYDOR(), getPHYRAR(), setPHYRAR(), setPHYDIR(), getPHYDIVR(), setPHYDIVR() +*/ +#define _PHYACR_ (_W6100_IO_BASE_ + (0x3014 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief PHY's MDC Clock Division Register address [R=W][0x01] + @details @ref _PHYDIVR_ divides the system clock for the MDC clock of Ethernet PHY' + - @ref PHYDIVR_32 + - @ref PHYDIVR_64 + - @ref PHYDIVR_128 + @sa _PHYRAR_, _PHYACR_, _PHYDOR_, _PHYDIR_, _PHYDIVR_ + @sa getPHYDIVR(), setPHYDIVR(), getPHYRAR(), setPHYRAR(), getPHYACR(), setPHYACR(), getPHYDOR(), setPHYDIR() +*/ +#define _PHYDIVR_ (_W6100_IO_BASE_ + (0x3018 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief PHY Control Register address [WO][0x00] + @details @ref _PHYCR0_ controls the operation mode of PHY. + The result will be checked by @ref _PHYSR_ after PHY HW reset by @ref PHYCR1_RST. + - @ref PHYCR0_AUTO + - @ref PHYCR0_100F + - @ref PHYCR0_100H + - @ref PHYCR0_10F + - @ref PHYCR0_10H + + @note It can be only accessed when @ref SYSR_PHYL is unlock. + @sa _SYSR_, _PHYCR1_ + @sa setPHYCR0(), getSYSR(), getPHYCR1(), setPHYCR1() +*/ +#define _PHYCR0_ (_W6100_IO_BASE_ + (0x301C << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief PHY Control Register address [R=W][0x40] + @details @ref _PHYCR1_ controls the Ethernet PHY function such as HW reset, Power down and etc. + + + +
    7 6 5 4 3 2 ~ 1 0
    Reserved Always 1 PWDN Reseved TE Reserved RST
    + - @ref PHYCR1_PWDN + - @ref PHYCR1_TE + - @ref PHYCR1_RST + + @note It can be only accessed when @ref SYSR_PHYL is unlock. + @sa _SYSR_, _PHYCR0_ + @sa getPHYCR1(), setPHYCR1(), setPHYCR0(), getSYSR() +*/ +#define _PHYCR1_ WIZCHIP_OFFSET_INC(_PHYCR0_,1) + +/** + @brief Network IPv4 Mode Register address [R=W][0x00] + @details @ref _NET4MR_ can block the transmission such like as unreachable message, TCP reset, and ping relay.\n + It can ARP request before ping relpy. + + + + +
    7 ~ 4 3 2 1 0
    Reserved UNRB PARP RSTB PB
    + - @ref NETxMR_UNRB + - @ref NETxMR_PARP + - @ref NETxMR_RSTB + - @ref NETxMR_PB + @sa _NET6MR_ + @sa getNET4MR(), setNET4MR(), getNET6MR(), setNET6MR() +*/ +#define _NET4MR_ (_W6100_IO_BASE_ + (0x4000 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief Network IPv6 Mode Register address [R=W][0x00] + @details @ref _NET6MR_ can block the transmission such like as unreachable message, TCP reset, and ping relay.\n + It can ARP request before ping reply. + + + + +
    7 ~ 4 3 2 1 0
    Reserved UNRB PARP RSTB PB
    + - @ref NETxMR_UNRB + - @ref NETxMR_PARP + - @ref NETxMR_RSTB + - @ref NETxMR_PB + @sa _NET4MR_ + @sa getNET6MR(), setNET6MR(), getNET4MR(), setNET4MR() +*/ +#define _NET6MR_ (_W6100_IO_BASE_ + (0x4004 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief Network Mode Register address [R=W][0x00] + @details @ref _NETMR_ set WOL(Wake On Lan) mode.\n + It also can block a packet such as \n + IPv6 PING request from an all-node broadcasting, \n + IPv6 PING request from a solicited mulitcasting address,\n + IPv4 packets, \n + and IPv6 packets. + + + + +
    7 ~ 6 5 4 3 2 1 0
    Reserved ANB M6B Always 0 WOL IP6B IP4B
    + - @ref NETMR_ANB + - @ref NETMR_M6B + - @ref NETMR_WOL + - @ref NETMR_IP6B + - @ref NETMR_IP4B + @sa getNETMR(), setNETMR() + +*/ +#define _NETMR_ (_W6100_IO_BASE_ + (0x4008 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief Network Mode Register 2 address [R=W][0x00] + @details @ref _NETMR2_ set PPPoE mode.\n + It also can select the destination hardware address to either Ethernet frame MAC or target MAC in the ARP-reply message + + + +
    7 6 ~ 1 0
    DHAS 6 ~ 1 PPPoE
    + - @ref NETMR2_DHAS : @ref NETMR2_DHAS_ARP, @ref NETMR2_DHAS_ETH + - @ref NETMR2_PPPoE + @sa getNETMR2(), setNETMR2() +*/ +#define _NETMR2_ (_W6100_IO_BASE_ + (0x4009 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief PPP LCP request Timer Register address [R=W][0x28] + @details @ref _PTMR_ sets the time for sending LCP echo request.\n + The unit of time is 25ms. + @sa _PMNR_, _PHAR_, _PSIDR_, _PMRUR_, NETMR2_PPPoE + @sa getPTMR(), setPTMR(), getPMNR(), setPMNR(), getPHAR(), setPHAR(), getPSIDR(), setPSIDR(), getPMRUR(), setPMRUR(), getNETMR2(), setNETMR2() +*/ +#define _PTMR_ (_W6100_IO_BASE_ + (0x4100 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief PPP LCP Magic Number Register address [R=W][0x00] + @details @ref _PMNR_ sets the 4bytes magic number to be used in LCP negotiation. + @sa _PTMR_, _PHAR_, _PSIDR_, _PMRUR_, NETMR2_PPPoE + @sa getPMNR(), setPMNR(), getPTMR(), setPTMR(), getPHAR(), setPHAR(), getPSIDR(), setPSIDR(), getPMRUR(), setPMRUR(), getNETMR2(), setNETMR2() +*/ +#define _PMNR_ (_W6100_IO_BASE_ + (0x4104 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief PPPoE Hardware Address Register address [R=W][0x00] + @details @ref _PHAR_ sets the PPPoE server hardware address that is acquired during PPPoE connection process. + @sa _PTMR_, _PMNR_, _PSIDR_, _PMRUR_, NETMR2_PPPoE + @sa getPHAR(), setPHAR(), getPTMR(), setPTMR(), getPMNR(), setPMNR(), getPSIDR(), setPSIDR(), getPMRUR(), setPMRUR(), getNETMR2(), setNETMR2() +*/ +#define _PHAR_ (_W6100_IO_BASE_ + (0x4108 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief PPP Session ID Register address [R=W][0X0000] + @details @ref _PSIDR_ sets the PPPoE sever session ID acquired during PPPoE connection process. + @sa _PTMR_, _PMNR_, _PHAR_, _PMRUR_, NETMR2_PPPoE + @sa getPSIDR(), setPSIDR(), getPTMR(), setPTMR(), getPMNR(), setPMNR(), getPHAR(), setPHAR(), getPMRUR(), setPMRUR(), getNETMR2(), setNETMR2() +*/ +#define _PSIDR_ (_W6100_IO_BASE_ + (0x4110 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief PPP Maximum Receive Unit Register address [R=W][0xFFFF] + @details @ref _PMRUR_ sets the maximum receive unit of PPPoE. + @sa _PTMR_, _PMNR_, _PHAR_, _PSIDR_, NETMR2_PPPoE + @sa getPMRUR(), setPMRUR(), getPTMR(), setPTMR(), getPMNR(), setPMNR(), getPHAR(), setPHAR(), getPSIDR(), setPSIDR(), getNETMR2(), setNETMR2() +*/ +#define _PMRUR_ (_W6100_IO_BASE_ + (0x4114 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief Source Hardware Address Register address [R=W][00:00:00:00:00:00] + @details @ref _SHAR_ sets the source hardware address. + @note It can be accessed only when @ref SYSR_NETL is unlock. + @sa SYSR_NETL, _NETLCKR_ + @sa getSHAR(), setSHAR(), getSYSR(), setNETLCKR(), getNETLCKR(), NETLOCK(), NETUNLOCK() +*/ +#define _SHAR_ (_W6100_IO_BASE_ + (0x4120 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief IPv4 Gateway Address Register address [R=W][0.0.0.0] + @details @ref _GAR_ sets the default gateway IPv4 address. + @note It can be accessed only when @ref SYSR_NETL is unlock. + @sa SYSR_NETL, _NETLCKR_, _GA6R_ + @sa getGAR(), setGAR(), getSYSR(), setNETLCKR(), getNETLCKR(), NETLOCK(), NETUNLOCK(), getGA6R(), setGA6R() +*/ +#define _GAR_ (_W6100_IO_BASE_ + (0x4130 << 8) + WIZCHIP_CREG_BLOCK) +#define _GA4R_ (_GAR_) ///< Refer to @ref _GAR_ +/** + @brief IPv4 Subnet Mask Register address [R=W][0.0.0.0] + @details @ref _SUBR_ sets the default subnet mask address of IPv4. + @note It can be accessed only when @ref SYSR_NETL is unlock. + @sa SYSR_NETL, _NETLCKR_, _SUB6R_ + @sa getSUBR(), setSUBR(), getSYSR(), setNETLCKR(), getNETLCKR(), NETLOCK(), NETUNLOCK(), getSUB6R(), setSUB6R() +*/ +#define _SUBR_ (_W6100_IO_BASE_ + (0x4134 << 8) + WIZCHIP_CREG_BLOCK) +#define _SUB4R_ (_SUBR_) ///< Refer to @ref _SUBR_ + +/** + @brief IPv4 Source IP Register address [R=W][0.0.0.0] + @details @ref _SIPR_ sets the source IPv4 address. + @note It can be accessed only when @ref SYSR_NETL is unlock. + @sa SYSR_NETL, _NETLCKR_, _LLAR_, _GUAR_ + @sa getSIPR(), setSIPR(), getSYSR(), setNETLCKR(), getNETLCKR(), NETLOCK(), NETUNLOCK(), getLLAR(), setLLAR(), getGUAR(),setGUAR() +*/ +#define _SIPR_ (_W6100_IO_BASE_ + (0x4138 << 8) + WIZCHIP_CREG_BLOCK) +#define _SIP4R_ (_SIPR_) ///< Refer to @ref _SIPR_. + +/** + @brief IPv6 LLA(Link Local Address) Register address [R=W][::] + @details @ref _LLAR_ sets the LLA address of IPv6. + @note It can be accessed only when @ref SYSR_NETL is unlock. + @sa SYSR_NETL, _NETLCKR_, _GUAR_, _SIPR_ + @sa getLLAR(), setLLAR(), getSYSR(), setNETLCKR(), getNETLCKR(), NETLOCK(), NETUNLOCK(), getGUAR(),setGUAR(), getSIPR(), setSIPR() +*/ +#define _LLAR_ (_W6100_IO_BASE_ + (0x4140 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief IPv6 GUA(Global Unicast Address) Register address [R=W][::] + @details @ref _GUAR_ sets the GUA address of IPv6. + @note It can be accessed only when @ref SYSR_NETL is unlock. + @sa SYSR_NETL, _NETLCKR_, _LLAR_, _SIPR_ + @sa getGUAR(), setGUAR(), getSYSR(), setNETLCKR(), getNETLCKR(), NETLOCK(), NETUNLOCK(), getLLAR(),setLLAR(), getSIPR(), setSIPR() +*/ +#define _GUAR_ (_W6100_IO_BASE_ + (0x4150 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief IPv6 Subnet Mask Register address [R=W][] + @details @ref _SUB6R_ sets the default subnet mask address of IPv6. + @note It can be accessed only when @ref SYSR_NETL is unlock. + @sa SYSR_NETL, _NETLCKR_, _SUBR_ + @sa getSUB6R(), setSUB6R(), getSYSR(), setNETLCKR(), getNETLCKR(), NETLOCK(), NETUNLOCK(), getSUBR(), setSUBR() +*/ +#define _SUB6R_ (_W6100_IO_BASE_ + (0x4160 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief IPv6 Gateway Address Register address [R/W][::] + @details @ref _GA6R_ sets the default gateway IPv6 address. + @sa _GAR_ + @sa getGA6R(), setGA6R(), getGAR(), setGAR() +*/ +#define _GA6R_ (_W6100_IO_BASE_ + (0x4170 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief SOCKET-less Peer IPv6 Register address [R=W][::] + @details @ref _SLDIP6R_ sets the destination IP address of @ref _SLCR_. + @sa _SLDIP6R_, _SLCR_, _SLIR_, _SLIRCLR_, _SLIMR_, _SLDHAR_, _SLDIPR_, _SLDIP4R_ + @sa getSLDIP6R(), setSLDIP6R(), getSLCR(), setSLCR(), getSLIR(), setSLIRCLR(), getSLIMR(), setSLIMR(), getSLDHAR(), + getSLDIPR(), setSLDIPR(), getSLDIP4R(), setSLDIP4R() +*/ +#define _SLDIP6R_ (_W6100_IO_BASE_ + (0x4180 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief SOCKET-less Peer IPv6 Register address [R=W][0.0.0.0] + @details @ref _SLDIPR_(= @ref _SLDIP4R_) sets the destination IPv4 address of @ref _SLCR_. + @sa _SLDIP4R_, _SLCR_, _SLIR_, _SLIRCLR_, _SLIMR_, _SLDHAR_, _SLDIP6R_ + @sa getSLDIPR(), setSLDIPR(), getSLDIP4R(), setSLDIP4R(), getSLCR(), setSLCR(), getSLIR(), setSLIRCLR(), getSLIMR(), setSLIMR(), getSLDHAR(), + getSLDIP6R(), setSLDIP6R() +*/ +#define _SLDIPR_ (_W6100_IO_BASE_ + (0x418C << 8) + WIZCHIP_CREG_BLOCK) +#define _SLDIP4R_ (_SLDIPR_) ///< Refer to @ref _SLDIPR_. + + +/** + @brief SOCKET-less Peer Hardware Address Register address [RO][00:00:00:00:00:00] + @details @ref _SLDHAR_ gets the destination hardware address acquired by of @ref SLCR_ARP4, SLCR_ARP6, SLCR_PING4, and SLCR_PING6. + @sa _SLDIP4R_, _SLDIP6R_, _SLCR_, _SLIR_, _SLIRCLR_, _SLIMR_ + @sa getSLDHAR(), getSLDIP4R(), setSLDIP4R(), getSLDIP6R(), setSLDIP6R(), getSLCR(), setSLCR(), \n + getSLIR(), setSLIRCLR(), getSLIMR(), setSLIMR() +*/ +#define _SLDHAR_ (_W6100_IO_BASE_ + (0x4190 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief SOCKET-less Ping ID Register address [R=W][0x00] + @details @ref _PINGIDR_ sets the PING-request ID to be sent by @ref SLCR_PING4 or @ref SLCR_PING6. + @sa _SLCR_, _PINGSEQR_, _SLDIPR_, _SLDIP4R_, _SLDIP6R_, _SLDHAR_, _SLIR_, _SLIRCLR_, _SLIMR_ + @sa getPINGIDR(), setPINGIDR(), getSLCR(), setSLCR(), getPINGSEQR(), setPINGSEQR(), getSLDIPR(), setSLDIPR(), + getSLDIP4R(), setSLDIP4R(), getSLDIP6R(), setSLDIP6R(), getSLDHAR(), getSLIR(), setSLIRCLR(), getSLIMR(), setSLIMR() +*/ +#define _PINGIDR_ (_W6100_IO_BASE_ + (0x4198 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief SOCKET-less ping Sequence number Register address [R=W][0x0000] + @details @ref _PINGIDR_ sets the PING-request sequence number to be sent by @ref SLCR_PING4 or @ref SLCR_PING6. + @sa _SLCR_, _PINGIDR_, _SLDIPR_, _SLDIP4R_, _SLDIP6R_, _SLDHAR_, _SLIR_, _SLIRCLR_, _SLIMR_ + @sa getPINGSEQR(), setPINGSEQR(), getSLCR(), setSLCR(), getPINGIDR(), setPINGIDR(), getSLDIPR(), setSLDIPR(), getSLDIP4R(), setSLDIP4R(), + getSLDIP6R(), setSLDIP6R(), getSLDHAR(), getSLIR(), setSLIRCLR(), getSLIMR(), setSLIMR() +*/ +#define _PINGSEQR_ (_W6100_IO_BASE_ + (0x419C << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief IPv4 Unreachable Address Register address [RO][0.0.0.0] + @details @ref _UIPR_ is set when a unreachable ICMPv4 message is received. + @sa _UPORTR_, _UIP6R_, _UPORT6R_ + @sa getUIPR(), setUIPR(), getUPORTR(), setUPORTR(), getUIPR6(), setUIPR6(), getUPORT6R(), setUPORT6R() +*/ +#define _UIPR_ (_W6100_IO_BASE_ + (0x41A0 << 8) + WIZCHIP_CREG_BLOCK) +#define _UIP4R_ (_UIPR_) ///< Refer to @ref _UPORTR_ + +/** + @brief IPv4 Unreachable Port number Register address [RO][0x0000] + @details @ref _UPORTR_ is set when a unreachable ICMPv4 message is received. + @sa _UIPR_, _UIP6R_, _UPORT6R_ + @sa getUPORTR(), setUPORTR(), getUIPR(), setUIPR(), getUIPR6(), setUIPR6(), getUPORT6R(), setUPORT6R() +*/ +#define _UPORTR_ (_W6100_IO_BASE_ + (0x41A4 << 8) + WIZCHIP_CREG_BLOCK) +#define _UPORT4R_ (_UPORTR_) ///< Refer to @ref _UPORTR_ +/** + @brief IPv6 Unreachable IP Address Register address [RO][::] + @details @ref _UIP6R_ is set when a unreachable ICMPv6 message is received. + @sa _UIPR_, _UPORTR_, _UIP6R_, _UPORT6R_ + @sa getUIPR6(), setUIPR6(), getUIPR(), setUIPR(), getUPORTR(), setUPORTR(), getUPORT6R(), setUPORT6R() +*/ +#define _UIP6R_ (_W6100_IO_BASE_ + (0x41B0 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief IPv6 Unreachable Port number Register address [RO][0x0000] + @details @ref _UIP6R_ is set when a unreachable ICMPv6 message is received. + @sa _UIPR_, _UPORTR_, _UIP6R_, _UPORT6R_ + @sa getUIPR6(), setUIPR6(), getUIPR(), setUIPR(), getUPORTR(), setUPORTR(), getUPORT6R(), setUPORT6R() +*/ +#define _UPORT6R_ (_W6100_IO_BASE_ + (0x41C0 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief Interrupt Pending Time Register address [R=w][0x0000] + @details @ref _INTPTMR_ pends the next interrupt issued by the INTn pin of @ref _WIZCHIP_.\n + It is decreased 1 every 4 SYS_CLK. \n + If it is zero and some interrupt is still remained, the INTn pin is issued. + @sa _IR_, _IRCLR_, _IMR_, _SIR_, _Sn_IRCLR_, _SIMR_, _SLIR_, _SLIRCLR_, _SLIMR_, SYCR_IEN + @sa getINTPTMR(), setINTPTMR(), getIR(), setIRCLR(), getIMR(), setIMR(), getSIR(), setSn_IRCLR(), getSIMR(), setSIMR(), \n + getSLIR(), setSLIRCLR(), getSLIMR(), setSLIMR(), getSYCR1(), setSYCR1() +*/ +#define _INTPTMR_ (_W6100_IO_BASE_ + (0x41C5 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief RA Prefix Length Register address [RO][0x00] + @details @ref _PLR_ is set when RA packet is received from a router. + @sa SLIR_RA, _SLIRCLR_, _PFR_, _VLTR_, _PLTR_, _PAR_ + @sa getPLR(), getSLIR(), setSLIRCLR(), getPFR(), getVLTR(), getPLTR(), getPAR() +*/ +#define _PLR_ (_W6100_IO_BASE_ + (0x41D0 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief RA Prefix Flag Register address [RO][0x00] + @details @ref _PFR_ is set when RA packet is received from a router. + @sa SLIR_RA, _SLIRCLR_, _PLR_, _VLTR_, _PLTR_, _PAR_ + @sa getPFR(), getSLIR(), setSLIRCLR(), getPLR(), getVLTR(), getPLTR(), getPAR() +*/ +#define _PFR_ (_W6100_IO_BASE_ + (0x41D4 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief RA Valid Life Time Register address [RO][0x00000000] + @details @ref _VLTR_ is set when RA packet is received from a router. + @sa SLIR_RA, _SLIRCLR_, _PLR_, _PFR_, _PLTR_, _PAR_ + @sa getVLTR(), getSLIR(), setSLIRCLR(), getPLR(), getPFR(), getPLTR(), getPAR() +*/ +#define _VLTR_ (_W6100_IO_BASE_ + (0x41D8 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief RA Prefered Life Time Register address [RO][0x00000000] + @details @ref _PLTR_ is set when RA packet is received from a router. + @sa SLIR_RA, _SLIRCLR_, _PLR_, _PFR_, _PLTR_, _PAR_ + @sa getPLTR(), getSLIR(), setSLIRCLR(), getPLR(), getPFR(), getVLTR(), getPAR() +*/ +#define _PLTR_ (_W6100_IO_BASE_ + (0x41DC << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief RA Prefix Address Register address[RO][::] + @details @ref _PAR_ is set when RA packet is received from a router. + @sa SLIR_RA, _SLIRCLR_, _PLR_, _PFR_, _VLTR_, _PLTR_, _PAR_ + @sa getPAR(), getPLTR(), getSLIR(), setSLIRCLR(), getPLR(), getPFR(), getVLTR() +*/ +#define _PAR_ (_W6100_IO_BASE_ + (0x41E0 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief ICMPv6 Block Register address [R=W][0x00] + @details @ref _ICMP6BLKR_ can block ICMPv6 message such like as PING, MLD, RA, NS and NA.\n + In this blocked case, @ref Sn_MR_IPRAW6 SOCKET can receive it. + + + +
    7 ~ 5 4 3 2 1 0
    7 ~ 5 PING6 MLD RA NA NS
    + - @ref ICMP6BLKR_PING6 : The same as @ref NETxMR_PB + - @ref ICMP6BLKR_MLD + - @ref ICMP6BLKR_RA + - @ref ICMP6BLKR_NA + - @ref ICMP6BLKR_NS + + @note The blocked message can be accepted by SOCKETn opened with @ref Sn_MR_IPRAW6. + @sa NETxMR_PB + @sa getICMP6BLKR(), setICMP6BLKR(), getNET6MR(), setNET6MR() +*/ +#define _ICMP6BLKR_ (_W6100_IO_BASE_ + (0x41F0 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief Chip configuration Lock Register address [WO][0x00] + @details @ref _CHPLCKR_ can lock or unlock to access @ref _SYCR0_ and @ref _SYCR1_.\n + The lock state can be checked from @ref SYSR_CHPL. + @sa _SYCR0_, _SYCR1_, _SYSR_, SYSR_CHPL + @sa getCHPLCKR(), setCHPLCKR(), CHIPLOCK(), CHIPUNLOCK(), getSYSR() +*/ +#define _CHPLCKR_ (_W6100_IO_BASE_ + (0x41F4 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief Network configuration Lock Register address [WO][0x00] + @details @ref _NETLCKR_ can lock or unlock to access the network information register such as @ref _SIPR_, @ref _LLAR_, and etc.\n + The lock state can be checked from @ SYSR_NETL. + @sa _SHAR_, _SIPR_, _SUBR_, _GAR_, _LLAR_, _GUAR_, _SUB6R_, _SYSR_, SYSR_NETL + @sa getNETLCKR(), setNETLCKR(), NETLOCK(), NETUNLOCK(), getSHAR(), setSHAR(), getSIPR(), getSIPR(), getSUBR(), setSUBR(), \n + getGAR(), setGAR(), getLLAR(), setLLAR(), getGUAR(), setGUAR(), getSUB6R(), setSUB6R(), getSYSR() +*/ +#define _NETLCKR_ (_W6100_IO_BASE_ + (0x41F5 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief PHY configuration Lock Register address [WO][0x00] + @details @ref _PHYLCKR_ can lock or unlock to access @ref _PHYCR0_ and @ref _PHYCR1_.\n + The lock state can be checked from @ref SYSR_PHYL. + @sa _PHYCR0_, _PHYCR1_, _SYSR_, SYSR_PHYL. + @sa getPHYLCKR(), setPHYLCKR(), PHYLOCK(), PHYUNLOCK(), setPHYCR0(), getPHYCR1(), setPHYCR1(), getSYSR() +*/ +#define _PHYLCKR_ (_W6100_IO_BASE_ + (0x41F6 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief Retransmission Time Register address [R=W][0x07D0] + @details @ref _RTR_ sets the default timeout value of @ref _Sn_RTR_.\n + When @ref _Sn_RTR_ is 0, @ref _Sn_RTR_ is reset to @ref _RTR_ after @ref Sn_CR_OPEN. + @sa _Sn_RTR_, _RCR_, _Sn_RCR_, _Sn_CR_, Sn_CR_OPEN, _Sn_IR_, _Sn_IRCLR_, Sn_IR_TIMEOUT + @sa getRTR(), setRTR(), getSn_RTR(), setSn_RTR(), getRCR(), setRCR(), getSn_RCR(), setSn_RCR(), \n + getSn_CR(), getSn_CR(), getSn_IR(), setSn_IRCLR() +*/ +#define _RTR_ (_W6100_IO_BASE_ + (0x4200 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief Retransmission Counter Register address [R=W][0x08] + @details @ref _RCR_ sets the default retransmission count of @ref _Sn_RCR_.\n + When @ref _Sn_RCR_ is 0, @ref _Sn_RCR_ is initialized as @ref _Sn_RTR_ after @ref Sn_CR_OPEN. + @sa _Sn_RCR_, _RTR_, _Sn_RTR_, _Sn_CR_, Sn_CR_OPEN, _Sn_IR_, _Sn_IRCLR_, Sn_IR_TIMEOUT + @sa getRCR(), setRCR(), getSn_RCR(), setSn_RCR(), getRTR(), setRTR(), getSn_RTR(), setSn_RTR(), \n + getSn_CR(), getSn_CR(), getSn_IR(), setSn_IRCLR() +*/ +#define _RCR_ (_W6100_IO_BASE_ + (0x4204 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief SOCKET-less Retransmission Time Register address [R=W][0x07D0] + @details @ref _SLRTR_ sets the timeout value of packet to be retransmitted by @ref _SLCR_. + @sa _SLRCR_, _SLIR_, _SLIRCLR_, SLIR_TOUT + @sa getSLRTR(), setSLRTR(), getSLRCR(), setSLRCR(), getSLIR(), setSLIRCLR() +*/ +#define _SLRTR_ (_W6100_IO_BASE_ + (0x4208 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief SOCKET-less Retransmission Count Register address [R=W][0x00] + @details @ref _SLRCR_ sets the retry counter of packet to be retransmitted by @ref _SLCR_. + @sa _SLRTR_, _SLIR_, _SLIRCLR_, SLIR_TOUT + @sa getSLRCR(), setSLRCR(), getSLRTR(), setSLRTR(), setSLIRCLR(), getSLIR(), setSLIRCLR(), +*/ +#define _SLRCR_ (_W6100_IO_BASE_ + (0x420C << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief SOCKET-less Hop Limit Register address [R=W][0x80] + @details @ref _SLHOPR_ sets the hop limit value of packet to be transmitted by @ref _SLCR_. + @sa _SLCR_ + @sa getSLHOPR(), setSLHOPR(), getSLCR(), setSLCR() +*/ +#define _SLHOPR_ (_W6100_IO_BASE_ + (0x420F << 8) + WIZCHIP_CREG_BLOCK) + +/** + @} +*/ + +//----------------------------- W6100 Socket Registers ----------------------------- +/** + @addtogroup Socket_register_group_W6100 + @{ +*/ +/** + @brief Socket Mode Register Address [R=W][0x00] + @details @ref _Sn_MR_ sets the option or protocol type of SOCKETn before @ref Sn_CR_OPEN is performed.\n\n + Each bit of @ref _Sn_MR_ is defined as the following. + + + +
    7 6 5 4 3 ~ 0
    MULTI/MF BRDB/FPSH ND/MC/SMB/MMB UNIB/MMB6 P[3:0]
    + - @ref Sn_MR_MULTI : Support UDP Multicasting + - @ref Sn_MR_MF : Support MAC Filter Enable + - @ref Sn_MR_BRDB : Broadcast Block + - @ref Sn_MR_FPSH : Force PSH flag + - @ref Sn_MR_ND : No Delay ACK flag + - @ref Sn_MR_MC : IGMP ver2, ver1 + - @ref Sn_MR_SMB : Solicited Multicast Block + - @ref Sn_MR_MMB : IPv4 Multicast block + - @ref Sn_MR_UNIB : Unicast Block + - @ref Sn_MR_MMB6 : IPv6 UDP Multicast Block + - P[3:0] + + + + + + + + + + + + +
    P[3:0] Protocol Mode
    0000 SOCKET Closed
    0001 TCP4
    0010 UDP4
    0011 IPRAW4
    0100
    MACRAW
    1001 TCP6
    1010 UDP6
    1100 IPRAW6
    1101 TCP Dual(TCPD)
    1110 UDP Dual (UDPD)
    + - @ref Sn_MR_CLOSE : SOCKET Closed + - @ref Sn_MR_TCP4(= @ref Sn_MR_TCP) : TCP4 mode + - @ref Sn_MR_UDP4(= @ref Sn_MR_UDP) : UDP4 mode + - @ref Sn_MR_IPRAW4(= @ref Sn_MR_IPRAW) : IPRAW4 mode + - @ref Sn_MR_MACRAW : MACRAW mode + - @ref Sn_MR_TCP6 : TCP6 mode + - @ref Sn_MR_UDP6 : UDP6 mode + - @ref Sn_MR_IPRAW6 : IPRAW6 mode + - @ref Sn_MR_TCPD : TCP Dual (TCPD) mode + - @ref Sn_MR_UDPD : UDP Dual (UDPD) mode + + @note MACRAW mode should be only used in Socket 0. + @sa _Sn_CR_, Sn_CR_OPEN, _Sn_SR_, _Sn_MR2_ + @sa getSn_MR(), setSn_MR(), getSn_CR(), setSn_CR(), getSn_SR(), getSn_MR2(), setSn_MR2() +*/ +#define _Sn_MR_(N) (_W6100_IO_BASE_ + (0x0000 << 8) + WIZCHIP_SREG_BLOCK(N)) + +/** + @brief SOCKET n Prefer Source IPv6 Address Register Address [R=W][0x00] + @details @ref _Sn_PSR_ select the Source IPv6 Address to transmit a packet by @ref _Sn_CR_. + This function is same as @ref _SLPSR_. + - @ref PSR_AUTO + - @ref PSR_LLA + - @ref PSR_GUA + @sa _Sn_CR_, _Sn_PSR_, _SLPSR_ + @sa getSn_PSR(), setSn_PSR(), getSLCR(), setSLCR(), getSLPSR(), setSLPSR(), +*/ +#define _Sn_PSR_(N) (_W6100_IO_BASE_ + (0x0004 << 8) + WIZCHIP_SREG_BLOCK(N)) + +/** + @brief Socket Command Register Address [RW,AC][0x00] + @details @ref _Sn_CR_ is used to set the command for SOCKET n such as OPEN, CLOSE, CONNECT, LISTEN, SEND, and RECEIVE.\n + It is automatically cleared to 0x00 after the command is recognized by @ref _WIZCHIP_.\n + Even though @ref _Sn_CR_ is cleared to 0x00, the command is still being processed.\n + To check whether the command is completed or not, please check the @ref _Sn_IR_ or @ref _Sn_SR_. + - @ref Sn_CR_OPEN : Initialize or open socket. + - @ref Sn_CR_LISTEN : Wait connection request on TCP4/TCP6/TCPD mode(Server mode) + - @ref Sn_CR_CONNECT : Send connection request on TCP4/TCPD mode(Client mode) + - @ref Sn_CR_CONNECT6 : Send connection request on TCP6/TCPD mode(Client mode):nohl + - @ref Sn_CR_DISCON : Send closing request on TCP/TCP6/TCPD mode. + - @ref Sn_CR_CLOSE : Close socket. + - @ref Sn_CR_SEND : Update TX buffer pointer and send data in IPv4 socket. + - @ref Sn_CR_SEND6 : Update TX buffer pointer and send data in IPv6 socket. + - @ref Sn_CR_SEND_KEEP : Send keep alive message. + - @ref Sn_CR_RECV : Update RX buffer pointer and receive data. + + @note These commands should be exclusive executed.\n That is, the other command can not executed when one command is not cleared yet. + @sa _Sn_IR_, _Sn_IRCLR_, Sn_IMR_, _SIR_, _Sn_SR_ + @sa getSn_CR(), setSn_CR(), getSn_IR(), setSn_IRCLR(), getSn_IMR(), setSn_IMR(), getSIR(), getSn_SR() +*/ +#define _Sn_CR_(N) (_W6100_IO_BASE_ + (0x0010 << 8) + WIZCHIP_SREG_BLOCK(N)) + +/** + @brief SOCKETn Interrupt Register Address [RO][0x00] + @details @ref _Sn_IR_ gets the status of SOCKETn interrupt such as establishment, termination, receiving data, timeout.\n + If SOCKETn interrupt occurs and the n-th bit of @ref _SIMR_ is set, then @ref SIR_INT(n) is set.\n + In order to clear the @ref _Sn_IR_ bit, Set the corresponding bit of _Sn_IRCLR_ to 1.\n + If all @ref _Sn_IR_ bits are cleared, the @ref SIR_INT(n) is automatically cleared. + + + +
    7 ~ 5 4 3 2 1 0
    Reserved SENDOK TIMEOUT RECV DISCON CON
    + - @ref Sn_IR_SENDOK + - @ref Sn_IR_TIMEOUT + - @ref Sn_IR_RECV + - @ref Sn_IR_DISCON + - @ref Sn_IR_CON + + @sa _Sn_IRCLR_, _Sn_IMR_, _SIR_, _SIMR_ + @sa getSn_IR(), setSn_IRCLR(), getSn_IMR(), setSn_IMR(), getSIR(), getSIMR(), setSIMR() +*/ +#define _Sn_IR_(N) (_W6100_IO_BASE_ + (0x0020 << 8) + WIZCHIP_SREG_BLOCK(N)) + +/** + @brief SOCKETn Interrupt Mask Register Address [R=W][0xFF] + @details @ref _Sn_IMR_ is used to mask interrupts of @ref _Sn_IR_. + @sa _Sn_IR_, _Sn_IRCR_, _SIR_, _SIMR_ + @sa getSn_IMR(), setSn_IMR(), getSn_IR(), setSn_IRCLR(), getSIR(), getSIMR(), setSIMR() +*/ +#define _Sn_IMR_(N) (_W6100_IO_BASE_ + (0x0024 << 8) + WIZCHIP_SREG_BLOCK(N)) + +/** + @brief SOCKETn Interrupt Clear Register Address [WO][0x00] + @details @ref _Sn_IRCLR_ clears @ref _Sn_IR_ + @sa _Sn_IR_, _SIR_, _SIMR_ + @sa setSn_IRCLR(), getSn_IR(), getSIR(), getSIMR(), setSIMR() +*/ +#define _Sn_IRCLR_(N) (_W6100_IO_BASE_ + (0x0028 << 8) + WIZCHIP_SREG_BLOCK(N)) + + + +/** + @brief SOCKETn Status Register Address [RO][0x00] + @details @ref _Sn_SR_ indicates the status of SOCKETn.\n + The status of SOCKETn can be changed by @ref _Sn_CR_, some TCP packets such as SYN, FIN, RST packet, or @ref Sn_IR_TIMEOUT. + - Normal status + - @ref SOCK_CLOSED : Closed + - @ref SOCK_INIT : Initiate state + - @ref SOCK_LISTEN : Listen state + - @ref SOCK_ESTABLISHED : Success to connect + - @ref SOCK_CLOSE_WAIT : Closing state + - @ref SOCK_UDP : UDP socket + - @ref SOCK_IPRAW : IPRAW socket + - @ref SOCK_IPRAW6 : IPv6 IPRAW socket + - @ref SOCK_MACRAW : MAC raw mode socket + - Temporary status during changing the status of SOCKETn . + - @ref SOCK_SYNSENT : This indicates SOCKETn sent the connect-request packet (SYN packet) to a peer. + - @ref SOCK_SYNRECV : It indicates SOCKETn successfully received the connect-request packet (SYN packet) from a peer. + - @ref SOCK_FIN_WAIT : Connection state + - @ref SOCK_TIME_WAIT : Closing state + - @ref SOCK_LAST_ACK : Closing state + + @sa _Sn_CR_, _Sn_IR_, _Sn_IRCLR_, Sn_IR_TIMEOUT + @sa getSn_SR(), getSn_CR(), setSn_CR(), getSn_IR(), setSn_IRCLR() + + + +
    @image html SocketStatus.png ""
    + +*/ +#define _Sn_SR_(N) (_W6100_IO_BASE_ + (0x0030 << 8) + WIZCHIP_SREG_BLOCK(N)) + +/** + @brief SOCKETn Extension Status Register Address [RO][0x00] + @details @ref _Sn_ESR_ indicates the connected client IP address information such as IP version, IPv6 address type(LLA or GUA), \n + and TCP operation mode such as TCP SERVER and TCP CLIENT + + + +
    7 ~ 3 2 1 0
    Reserved TCPM TCPOP IP6T
    + - @ref Sn_ESR_TCPM : @ref Sn_ESR_TCPM_IPV4, @ref Sn_ESR_TCPM_IPV6 + - @ref Sn_ESR_TCPOP : @ref Sn_ESR_TCPOP_SVR, @ref Sn_ESR_TCPOP_CLT + - @ref Sn_ESR_IP6T : @ref Sn_ESR_IP6T_LLA, @ref Sn_ESR_IP6T_GUA + + @note It is valid only on TCP mode such as @ref Sn_MR_TCP4, @ref Sn_MR_TCP6, and @ref Sn_MR_TCPD. + @sa _Sn_MR_, _Sn_PSR_ + @sa getSn_ESR(), getSn_MR(), setSn_MR(), getSn_PSR(), setSn_PSR() +*/ +#define _Sn_ESR_(N) (_W6100_IO_BASE_ + (0x0031 << 8) + WIZCHIP_SREG_BLOCK(N)) + +/** + @brief SOCKETn IP Protocol Number(PN) Register Address [R/W][0x0000] + @details \ref _Sn_PNR_ that sets the protocol number/next header field of the IPv4/IPv6 header at the IP layer. + @note It is valid only in IPRAW mode such as @ref Sn_MR_IPRAW4 and @ref Sn_MR_IPRAW6. + @note It is set before @ref Sn_CR_OPEN is performed. + @sa _Sn_NHR_, _Sn_MR_, Sn_CR_OPEN + @sa getSn_PNR(), setSn_PNR(), getSn_NHR(), setSn_NHR(), getSn_MR(), setSn_MR(), getSn_CR(), setSn_CR() +*/ +#define _Sn_PNR_(N) (_W6100_IO_BASE_ + (0x0100 << 8) + WIZCHIP_SREG_BLOCK(N)) +#define _Sn_NHR_(N) (_Sn_PNR_(N)) ///< Refer to @ref _Sn_PNR_. + +/** + @brief SOCKETn IPv4 Type of Service(TOS) Register Address [R=W][0x00] + @details @ref _Sn_TOSR_ sets the TOS(Type Of Service) field in IPv4 Header. + @sa getSn_TOSR(), setSn_TOSR() +*/ +#define _Sn_TOSR_(N) (_W6100_IO_BASE_ + (0x0104 << 8) + WIZCHIP_SREG_BLOCK(N)) + +/** + @brief SOCKETn IP Time to live(TTL) Register Address [R=W][0x80] + @details @ref _Sn_TTLR_ sets the TTL(Time To Live)/HOP(Hop Limit) field in IPv4/IPv6 header at the IP layer. + @sa _Sn_HOPR_ + @sa getSn_TTLR(), setSn_TTLR(), getSn_HOPR(), setSn_HOPR() +*/ +#define _Sn_TTLR_(N) (_W6100_IO_BASE_ + (0x0108 << 8) + WIZCHIP_SREG_BLOCK(N)) +#define _Sn_HOPR_(N) (_Sn_TTLR_(N)) ///< Refer to @ref _Sn_TTLR_. + +/** + @brief SOCKETn Fragment Register Address [R=W][0x4000] + @details @ref _Sn_FRGR_ sets the fragment flag & offset in IPv4 header. + @note @ref _WIZCHIP_ can not support IP fragment & re-assembly.\n So It is not recommended to set @ref _Sn_FRGR_ to any other value. + @sa getSn_FRGR(), setSn_FRGR() +*/ +#define _Sn_FRGR_(N) (_W6100_IO_BASE_ + (0x010C << 8) + WIZCHIP_SREG_BLOCK(N)) + +/** + @brief SOCKETn Maximum Segment Size(MSS) Register Address [RW][0x0000] + @details @ref _Sn_MSSR_ sets or gets the MTU(Maximum Transfer Unit) of SOCKETn. \n + The MTU of each protocol is as following. + + + + + + + + + +
    @ref _Sn_MR_[3:0] @ref NETMR2_PPPoE = 0 @ref NETMR2_PPPoE = '1'
    @ref Sn_MR_TCP4 1 ~ 1460 1 ~ 1452
    @ref Sn_MR_TCP6 1 ~ 1440 1 ~ 1432
    @ref Sn_MR_UDP4 1 ~ 1472 1 ~ 1464
    @ref Sn_MR_UDP6 1 ~ 1452 1 ~ 1444
    @ref Sn_MR_IPRAW4 1 ~ 1480 1 ~ 1472
    @ref Sn_MR_IPRAW6 1 ~ 1460 1 ~ 1452
    @ref Sn_MR_MACRAW 1 ~ 1514
    + + @note It is not set exceeding the MTU for each protocol of SOCKETn even if _Sn_MSSR_ is set over the MTU. + @sa _Sn_MR_, NETMR2_PPPoE + @sa getSn_MSSR(), setSn_MSSR(), getSn_MR(), setSn_MR(), getNETMR2(), setNETMR2() +*/ +#define _Sn_MSSR_(N) (_W6100_IO_BASE_ + (0x0110 << 8) + WIZCHIP_SREG_BLOCK(N)) + +/** + @brief SOCKETn Source Port Register Address [R=W][0x0000] + @details @ref _Sn_PORTR_ sets the source port number of SOCKETn . + @note It is valid in TCP(@ref Sn_MR_TCP4, @ref Sn_MR_TCP6, @ref Sn_MR_TCPD) and UDP(@ref Sn_MR_UDP4, @ref Sn_MR_UDP6, @ref Sn_MR_UDPD) mode. + @note It should be set before @ref Sn_CR_OPEN is performed. + @sa _Sn_MR_, Sn_CR_OPEN + @sa getSn_PORTR(), getSn_PORTR(), getSn_MR(), setSn_MR(), getSn_CR(), setSn_CR() +*/ +#define _Sn_PORTR_(N) (_W6100_IO_BASE_ + (0x0114 << 8) + WIZCHIP_SREG_BLOCK(N)) + +/** + @brief SOCKETn Destination Hardware Address Register Address [RW][00:00:00:00:00:00] + @details @ref _Sn_DHAR_ sets or gets the destination hardware address of SOCKETn.\n + - When @ref Sn_MR2_DHAM = 1 and @ref _Sn_MR_[3:0] != @ref Sn_MR_MACRAW + The destination hardware address is set by @ref _Sn_DHAR_ without ARP processed by @ref Sn_CR_CONNECT, @ref Sn_CR_CONNECT6, @ref Sn_CR_SEND, and @ref Sn_CR_SEND6.\n + Also, when SOCKETn is opened with @ref Sn_MR_UDP4 or @ref Sn_MR_UDP6 and @ref Sn_MR_MULTI is set, @ref _Sn_DHAR_ sets the Multicast Group Hardware address. + - Others + In TCP mode such as @ref Sn_MR_TCP4, @ref Sn_MR_TCP6, and @ref Sn_MR_TCPD, \n + @ref _Sn_DHAR_ gets the destination hardware address when @ref _Sn_SR_ is @ref SOCK_ESTABLISHED. + @sa _Sn_MR_, _Sn_MR2_, _Sn_CR_, _Sn_SR_ + @sa getSn_DHAR(), setSn_DHAR(), getSn_MR(), setSn_MR(), getSn_MR2(), setSn_MR2(), getSn_CR(), setSn_CR(), getSn_SR() +*/ +#define _Sn_DHAR_(N) (_W6100_IO_BASE_ + (0x0118 << 8) + WIZCHIP_SREG_BLOCK(N)) + +/** + @brief SOCKETn Destination IPv4 Address Register Address [RW][0.0.0.0] + @details @ref _Sn_DIPR_(= @ref _Sn_DIP4R_) sets or gets the destination IPv4 address of SOCKETn. \n + - In TCP mode such as @ref Sn_MR_TCP4, and @ref Sn_MR_TCPD + - TCP CLIENT mode : It sets the IPv4 address of TCP SERVER before @ref Sn_CR_CONNECT is performed. + - TCP SERVER mode : It gets the IPv4 address of TCP CLIENT when @ref _Sn_SR_ is @ref SOCK_ESTABLISHED. + - In UDP(@ref Sn_MR_UDP4, @ref Sn_MR_UDPD) mode & IPRAW4(@ref Sn_MR_IPRAW4) mode + It sets the destination IPv4 address before @ref Sn_CR_SEND is performed. \n + When Sn_MR_MULTI = 1, It sets the multicast group IPv4 address. + @sa _Sn_DIP4R_, _Sn_MR_, _Sn_CR_, _Sn_SR_ + @sa getSn_DIPR(), getSn_DIPR(), getSn_DIP4R(), getSn_DIP4R(), getSn_MR(), setSn_MR(), getSn_CR(), setSn_CR(), getSn_SR() +*/ +#define _Sn_DIPR_(N) (_W6100_IO_BASE_ + (0x0120 << 8) + WIZCHIP_SREG_BLOCK(N)) +#define _Sn_DIP4R_(N) (_Sn_DIPR_(N)) ///< Refer to @ref _Sn_DIPR_. + +/** + @brief SOCKETn Destination IPv6 Address Register Address [RW][::] + @details @ref _Sn_DIP6R_ sets or gets the destination IPv6 address of SOCKETn. + - In TCP mode such as @ref Sn_MR_TCP6, and @ref Sn_MR_TCPD + - TCP CLIENT mode : It sets the IPv6 address of TCP SERVER before @ref Sn_CR_CONNECT6 is performed. + - TCP SERVER mode : It gets the IPv6 address of TCP CLIENT when @ref _Sn_SR_ is @ref SOCK_ESTABLISHED. + - In UDP(@ref Sn_MR_UDP6, @ref Sn_MR_UDPD) mode & IPRAW4(@ref Sn_MR_IPRAW6) mode + It sets the destination IPv6 address before @ref Sn_CR_SEND6 is performed.\n + When Sn_MR_MULTI = 1, It sets the multicast group IPv6 address. + @sa _Sn_MR_, _Sn_CR_, _Sn_SR_ + @sa getSn_DIP6R(), setSn_DIP6R(), getSn_MR(), setSn_MR(), getSn_CR(), setSn_CR(), getSn_SR() +*/ +#define _Sn_DIP6R_(N) (_W6100_IO_BASE_ + (0x0130 << 8) + WIZCHIP_SREG_BLOCK(N)) + +/** + @brief SOCKETn Destination Port Register Address [RW][0x0000] + @details @ref _Sn_DPORTR_ sets or gets the destination port number of SOCKETn. + - In TCP mode such as @ref Sn_MR_TCP4, @ref Sn_MR_TCP6, and @ref Sn_MR_TCPD + - TCP CLIENT mode : It sets the port number of TCP SERVER before @ref Sn_CR_CONNECT is performed. + - TCP SERVER mode : It gets the port number of TCP CLIENT when @ref _Sn_SR_ is @ref SOCK_ESTABLISHED. + - In UDP mode such as @ref Sn_MR_UDP4, @ref Sn_MR_UDP6, and @ref Sn_MR_UDPD + It sets the destination port number before @ref Sn_CR_SEND is performed. \n + When Sn_MR_MULTI = 1, It sets the multicast group group port number. + + @note It is valid SOCKETn is opened with @ref Sn_MR_TCP4, @ref Sn_MR_TCP6, @ref Sn_MR_TCPD, @ref Sn_MR_UDP4, @ref Sn_MR_UDP4, and @ref Sn_MR_UDPD. + @note It should be set before OPEN command is ordered. + @sa _Sn_MR_, _Sn_CR_, _Sn_SR_ + @sa getSn_DPORTR(), getSn_DPORTR(), getSn_MR(), setSn_MR(), getSn_CR(), setSn_CR(), getSn_SR() +*/ +#define _Sn_DPORTR_(N) (_W6100_IO_BASE_ + (0x0140 << 8) + WIZCHIP_SREG_BLOCK(N)) + +/** + @brief SOCKETn Mode Register 2 Address [R=W][0x00] + @details @ref _Sn_MR2_ sets the option of SOCKETn with @ref _Sn_MR_, before @ref Sn_CR_OPEN is performed.\n + Each bit of @ref _Sn_MR2_ is defined as the following. + + + +
    7 ~ 2 1 0
    Reserved DHAM FARP
    + - @ref Sn_MR2_DHAM : @ref Sn_MR2_DHAM_AUTO, @ref Sn_MR2_DHAM_MANUAL + - @ref Sn_MR2_FARP + @sa _Sn_MR_, _Sn_CR_ + @sa getSn_MR2(), setSn_MR2(), getSn_MR(), getSn_MR(), getSn_CR() +*/ +#define _Sn_MR2_(N) (_W6100_IO_BASE_ + (0x0144 << 8) + WIZCHIP_SREG_BLOCK(N)) + + +/** + @brief SOCKETn Retransmission Time Register Address [R=W][0x0000] + @details @ref _Sn_RTR_ sets the timeout value of packet to be retransmitted by @ref _SLCR_.\n + @note It should be set before @ref Sn_CR_OPEN is performed.\n + It is initialized as @ref _RTR_ if you do not set it to none-zero value. + @sa _RTR_, _Sn_CR_ + @sa getSn_RTR(), setSn_RTR(), getSn_CR(), setSn_CR() +*/ +#define _Sn_RTR_(N) (_W6100_IO_BASE_ + (0x0180 << 8) + WIZCHIP_SREG_BLOCK(N)) + +/** + @brief SOCKETn Retransmission Count Register Address [R=W][0x00] + @details @ref _Sn_RCR_ sets the retry count value of packet to be retransmitted by @ref _SLCR_.\n + @note It should be set before @ref Sn_CR_OPEN is performed.\n + It is initialized as @ref _RTR_ if you do not set it to any none-zero value. + @sa _RTR_, _Sn_CR_ + @sa getSn_RTR(), setSn_RTR(), getSn_CR(), setSn_CR() +*/ +#define _Sn_RCR_(N) (_W6100_IO_BASE_ + (0x0184 << 8) + WIZCHIP_SREG_BLOCK(N)) + +/** + @brief SOCKETn Keep Alive Time Register Address [R=W][0x00] + @details @ref _Sn_KPALVTR_ sets the auto-retransmission time of KA(Keep Alive) packet. \n + If the destination can not respond to the KA packet during the time set by @ref _Sn_KPALVTR_,\n + the connection is terminated, @ref Sn_IR_TIMEOUT is set and then @ref _Sn_SR_ is changed @ref SOCK_CLOSED.\n + Before the time is expierd, if the destination sends a KA/ACK packet or any packet, the connection is still valid,\n + @ref _Sn_SR_ remained at @ref SOCK_ESTABLISHED. + @note It is valid only after sending data over 1 byte in TCP mode such as @ref Sn_MR_TCP4, @ref Sn_MR_TCP6, and @ref Sn_MR_TCPD. + @note If it is set to 0, KA packet can be sent by @ref Sn_CR_SEND_KEEP. + @sa Sn_CR_SEND_KEEP, Sn_IR_TIMEOUT, Sn_IRCLR, Sn_SR, Sn_MR + @sa getSn_KPALVTR(), setSn_KPALVTR(), getSn_IR(), setSn_IRCLR(), getSn_SR(), getSn_MR(), setSn_MR() +*/ +#define _Sn_KPALVTR_(N) (_W6100_IO_BASE_ + (0x0188 << 8) + WIZCHIP_SREG_BLOCK(N)) + +/** + @brief SOCKETn TX Buffer Size Register Address [R=W][0x02] + @details @ref _Sn_TX_BSR_ sets the TX buffer size of SOCKETn in the 16KB TX memory.\n + It can be set only with 0,1,2,4,8, and 16K bytes. + @note The 16KB TX memory is allocated as many as @ref _Sn_TX_BSR_ sequentially from SOCKET0 to SOCKETn(Here, 0 <= n <= @ref _WIZCHIP_SOCK_NUM_ - 1).\n + The total sum of Sn_TX_BSR can not be exceed 16KB of TX memory. \n + If the total size is exceeded, SOCKETn can't be normally sent data to a destination. + @sa _Sn_RX_BSR_ + @sa getSn_TX_BSR(), setSn_TX_BSR(), getSn_TXBUF_SIZE(), setSn_TXBUF_SIZE(), getSn_TxMAX(), setSn_TX_BSR(), getSn_RX_BSR(), setSn_RX_BSR() +*/ +#define _Sn_TX_BSR_(N) (_W6100_IO_BASE_ + (0x0200 << 8) + WIZCHIP_SREG_BLOCK(N)) + +/** + @brief SOCKETn TX Free Buffer Size Register Address [RO][0x0800] + @details @ref _Sn_TX_FSR_ gets the transmittable free size of SOCKETn TX buffer. + @note Data should not be saved bigger than it because the data overwrites the previous saved data not to be sent yet.\n + Therefore, Check it before saving the data to the SOCKETn TX buffer. \n + If the data size is equal or smaller than it, transmit the data with @ref Sn_CR_SEND / @ref Sn_CR_SEND6 after saving the data in SOCKETn TX buffer.\n + If the data size is greater than it, transmit the data after dividing into it and saving in the SOCKETn TX buffer. + @note \n + - In TCP mode such as @ref Sn_MR_TCP4, @ref Sn_MR_TCP6 and @ref Sn_MR_TCPD, \n + It is automatically increased by the absolute difference between @ref _Sn_TX_WR_ and interanl TX ACK pointer. + - In other mode \n + It is automatically increased by the absolute difference between @ref _Sn_TX_WR_ and @ref _Sn_TX_RD_. + @sa _Sn_RX_RSR_, _Sn_TX_WR_, _Sn_TX_RD_, _Sn_CR_ + @sa getSn_TX_FSR(), getSn_TX_WR(), getSn_TX_WR(), getSn_TX_RD(), getSn_CR(), setSn_CR() +*/ +#define _Sn_TX_FSR_(N) (_W6100_IO_BASE_ + (0x0204 << 8) + WIZCHIP_SREG_BLOCK(N)) + +/** + @brief SOCKET TX Memory Read Pointer Register Address[R][0x0000] + @details @ref _Sn_TX_RD_ gets the start pointer of data to be sent by @ref Sn_CR_SEND. \n + @ref Sn_CR_SEND / @ref Sn_CR_SEND6 starts to transmit the saved data from @ref _Sn_TX_RD_ to @ref _Sn_TX_WR_ in the SOCKETn TX Buffer,\n + and when @ref Sn_IR_SENDOK is set, It is automatically increased to equal @ref _Sn_TX_WR_. + @note It is initialized by @ref Sn_CR_OPEN, But, In TCP mode such as @ref Sn_MR_TCP4, @ref Sn_MR_TCP6, and @ref Sn_MR_TCPD,\n + it is re-initialized when the TCP connection is completed. + @note If it exceeds the maximum value 0xFFFF, (that is, it is greater than 0x10000 and the carry bit occurs),\n + then the carry bit is ignored and it automatically is updated with its the lower 16bits value. + @sa _Sn_TX_WR_, _Sn_TX_FSR_, _Sn_CR_, _Sn_IR_, _Sn_IRCLR_, _Sn_MR_ + @sa getSn_TX_RD(), getSn_TX_WR(), setSn_TX_WR(), getSn_TX_FSR(), getSn_CR(), setSn_CR(), getSn_IR(), setSn_IRCLR(), getSn_MR(), setSn_MR() +*/ +#define _Sn_TX_RD_(N) (_W6100_IO_BASE_ + (0x0208 << 8) + WIZCHIP_SREG_BLOCK(N)) + + +/** + @brief SOCKETn TX Memory Write Pointer Register Address [RW][0x0000] + @details @ref _Sn_TX_WR_ gets the start pointer of data to be saved in the SOCKETn TX buffer, \n + or sets the end pointer of data to be sent by @ref Sn_CR_SEND. \n + If you have completed to save the data to be sent in the SOCKETn TX buffer, + increase it as many as the saved size of data before @ref Sn_CR_SEND is performed.\n + @ref Sn_CR_SEND starts to transmit the saved data from @ref _Sn_TX_RD_ to @ref _Sn_TX_WR_ in the SOCKETn TX Buffer, \n + and when @ref Sn_IR_SENDOK is set, @ref _Sn_TX_RD_ is automatically increased to equal it. + @note It is initialized by @ref Sn_CR_OPEN.\n + But, In TCP mode such as @ref Sn_MR_TCP4, @ref Sn_MR_TCP6, and @ref Sn_MR_TCPD,\n + it is re-initialized when the TCP connection is completed. + @note The size of data to be saved can't exceed @ref _Sn_TX_FSR_. + @note If it exceeds the maximum value 0xFFFF(that is, it is greater than 0x10000 and the carry bit occurs),\n + then ignore the carry bit and update it with its lower 16bits value. + @sa _Sn_TX_RD_, _Sn_TX_FSR_, _Sn_CR_, _Sn_IR_, _Sn_IRCLR_, _Sn_MR_ + @sa getSn_TX_WR(), setSn_TX_WR(), getSn_TX_RD(), getSn_TX_FSR(), getSn_CR(), setSn_CR(), getSn_IR(), setSn_IRCLR(), getSn_MR(), setSn_MR() +*/ +#define _Sn_TX_WR_(N) (_W6100_IO_BASE_ + (0x020C << 8) + WIZCHIP_SREG_BLOCK(N)) + +/** + @brief SOCKETn RX Buffer Size Register Address [R=W][0x02] + @details @ref _Sn_RX_BSR_ sets the RX buffer size of SOCKETn in the 16KB RX memory.\n + It can be set only with 0,1,2,4,8, and 16K bytes. + @note The 16KB RX memory is allocated as many as @ref _Sn_RX_BSR_ sequentially from SOCKET0 to SOCKETn(Here, 0 <= n <= @ref _WIZCHIP_SOCK_NUM_ - 1).\n + The total sum of @ref _Sn_RX_BSR_ can not be exceed 16KB of RX memory. \n + If the total size is exceeded, SOCKETn can't be normally received data from a destination. + @sa _Sn_RX_BSR_ + @sa getSn_TX_BSR(), setSn_TX_BSR(), getSn_RXBUF_SIZE(), setSn_RXBUF_SIZE(), getSn_RxMAX(), getSn_RX_BSR(), setSn_RX_BSR() +*/ +#define _Sn_RX_BSR_(N) (_W6100_IO_BASE_ + (0x0220 << 8) + WIZCHIP_SREG_BLOCK(N)) + +/** + @brief SOCKETn RX Received Size Register Address [RO][0x0000] + @details @ref _Sn_RX_RSR_ gets the received data size of SOCKETn RX buffer. + @note The real received data size maybe smaller than it, \n + because it maybe included the size of 'PACKET NFO' such like as \n + the destination IP address, destination port number and data size of the received DATA PACKET. + @note Do not read bigger data than @ref _Sn_RX_RSR_. + @note It is automatically increased by the absolute difference between @ref _Sn_RX_WR_ and @ref _Sn_RX_RD_ \n + after @ref Sn_CR_RECV is performed. + @sa _Sn_RX_RSR_, _Sn_TX_WR_, _Sn_TX_RD_, _Sn_CR_, _Sn_TX_FSR_ + @sa getSn_RX_RSR(), getSn_TX_WR(), getSn_TX_WR(), getSn_CR(), setSn_CR(), getSn_TX_FSR() +*/ +#define _Sn_RX_RSR_(N) (_W6100_IO_BASE_ + (0x0224 << 8) + WIZCHIP_SREG_BLOCK(N)) + +/** + @brief SOCKET RX Memory Read Pointer Register Address[R][0x0000] + @details @ref _Sn_RX_RD_ gets the start pointer of the received data in the SOCKETn RX buffer,\n + or sets the end data pointer of the read completed data by @ref Sn_CR_RECV. \n + You can read the received data from it to @ref _Sn_RX_WR_ in the SOCKET RX buffer.\n + After completing to read data, you should increase it as many as the read size before @ref Sn_CR_RECV is performed. + @note It is initialized by @ref Sn_CR_OPEN, But, In TCP mode such as @ref Sn_MR_TCP4, @ref Sn_MR_TCP6, and @ref Sn_MR_TCPD,\n + it is re-initialized when the TCP connection is completed. + @note If it exceeds the maximum value 0xFFFF, (that is, it is greater than 0x10000 and the carry bit occurs),\n + Ignore the carry bit and update with its the lower 16bits value. + @sa _Sn_RX_WR_, _Sn_RX_RSR_, _Sn_CR_, _Sn_IR_, _Sn_IRCLR_, _Sn_MR_ + @sa getSn_RX_WR(), setSn_RX_RD(), getSn_RX_WR(), getSn_TX_FSR(), getSn_CR(), setSn_CR(), getSn_IR(), setSn_IRCLR(), getSn_MR(), setSn_MR() +*/ +#define _Sn_RX_RD_(N) (_W6100_IO_BASE_ + (0x0228 << 8) + WIZCHIP_SREG_BLOCK(N)) + +/** + @brief SOCKETn TX Memory Write Pointer Register Address [RW][0x0000] + @details @ref _Sn_TX_WR_ gets the end pointer of the data that has been completely received in the SOCKETn RX buffer. \n + Whenever a data has been completely received from a destination, \n + It is automatically increased as many as the sum size of the received data and the 'PACKET INFO'. \n + You can read the recevied data from @ref _Sn_RX_RD_ to it in the SOCKET RX buffer. + @note It is initialized by @ref Sn_CR_OPEN. But, In TCP mode such as @ref Sn_MR_TCP4, @ref Sn_MR_TCP6, and @ref Sn_MR_TCPD,\n + it is re-initialized when the TCP connection is completed. + @note If it exceeds the maximum value 0xFFFF(that is, it is greater than 0x10000 and the carry bit occurs),\n + then ignore the carry bit and update it with its lower 16bits value. + @sa _Sn_TX_RD_, _Sn_TX_FSR_, _Sn_CR_, _Sn_IR_, Sn_IRCLR_, _Sn_MR_ + @sa getSn_TX_WR(), setSn_TX_WR(), getSn_TX_RD(), getSn_TX_FSR(), getSn_CR(), setSn_CR(), getSn_IR(), setSn_IRCLR(), getSn_MR(), setSn_MR() +*/ +#define _Sn_RX_WR_(N) (_W6100_IO_BASE_ + (0x022C << 8) + WIZCHIP_SREG_BLOCK(N)) + +/** + @} +*/ + +/*----------------------------- W6100 Register values -----------------------------*/ + +/* System Status Register Bit Definition */ +/** + @brief CHIP Lock staus bit of @ref _SYSR_. + @details @ref SYSR_CHPL indicates the lock status of @ref _SYCR0_ and @ref _SYCR1_.\n + 1 : Lock \n + 0 : unlock + @note It is set by only @ref _CHPLCKR_. + @sa _SYSR_, _CHPLCKR_, _SYCR0_, _SYCR1_ + @sa getSYSR(), getCHPLCKR(), setCHPLCKR(), CHIPLOCK(), CHIPUNLOCK(), setSYCR0(), setSYCR1() +*/ +#define SYSR_CHPL (1 << 7) + +/** + @brief NET Lock status bit of @ref _SYSR_. + @details @ref SYSR_NETL indicates the lock of network information registers such as + @ref _SHAR_, @ref _GAR_, @ref _SUBR_, @ref _SIPR_, @ref _LLAR_, @ref _GUAR_, and @ref _SUB6R_. \n + 1 : Lock \n + 0 : unlock + @note It is set by only @ref _NETLCKR_. + @note @ref _GA6R_ can be accessed regardless of @ref SYSR_NETL. + @sa _SYSR_, _NETLCKR_, _SHAR_, _GAR_, _SUBR_, _SIPR_, _LLAR_, _GUAR_, _SUB6R_ + @sa getSYSR(), getNETLCKR(), setNETLCKR(), NETLOCK(), NETUNLOCK(),\n + getSHAR(), setSHAR(), getGAR(), setGAR(), getSUBR(), getSIR(), setSIPR(), \n + getLLAR(), setLLAR(), getGUAR(),setGUAR(), getSUB6R(), setSUB6R() +*/ +#define SYSR_NETL (1 << 6) + +/** + @brief PHY Lock status bit of @ref _SYSR_. Refer to @ref _PHYLCKR_. + @details @ref SYSR_PHYL indicates the lock status of @ref _PHYCR0_ and _PHYCR1_.\n + 1 : Lock \n + 0 : unlock + @note It is set by only @ref _PHYLCKR_. + @sa _SYSR_, _PHYCLKR_, _PHYCR0_, _PHYCR1_ + @sa getSYSR(), getPHYLCKR(), setPHYLCKR(), setPHYCR0(), getPHYCR1(), setPHYCR1() +*/ +#define SYSR_PHYL (1 << 5) + +/** + @brief Parallel Bus Mode bit of @ref _SYSR_ + @details @ref SYSR_IND is set when @ref _WIZCHIP_ PIN MODE[3:0] == "010X". + It indicates to use the parallel BUS mode. + @sa _SYSR_, _WIZCHIP_IO_MODE_BUS_ + @sa getSYSR() +*/ +#define SYSR_IND (1 << 5) + +/** + @brief SPI I/F Mode bit of @ref _SYSR_. + @details @ref SYSR_SPI is set when @ref _WIZCHIP_ PIN MODE[3:0] == "000X". + It indicates to use the SPI mode. + @sa _SYSR_, _WIZCHIP_IO_MODE_SPI_ + @sa getSYSR() +*/ +#define SYSR_SPI (1 << 0) + + +/* System Config Register Bit Definition */ +/** + @brief RST bit of @ref _SYCR0_ + @details @ref SYCR0_RST resets to @ref _WIZCHIP_ softly. \n + 0 : Soft reset \n + 1 : Normal operation + @note It can be set only when @ref SYSR_CHPL = 1. + @sa _SYSR0_, _CHPLCKR_, _SYSR_, SYSR_CHPL + @sa setSYCR0(), setCHPLCKR(), getCHPLCKR(), CHIPLOCK(), CHIPUNLOCK(), getSYSR() +*/ +#define SYCR0_RST (0x00) + +/** + @brief IEN bit of @ref _SYCR1_. + @details @ref SYCR1_IEN is globally enable or disable the interrupt of @ref _WIZCHIP_,\n + regardless of the related interrupt mask registers such as @ref _IMR_, @ref _SIMR_, @ref _SLIMR_, and @ref _Sn_IMR_.\n + 1 : Enable \n + 0 : Disable + @sa _SYCR1_, _IR_, _SIR_, _SLIR_, _Sn_IR_, _IRCLR_, _SLIRCLR_, _Sn_IRCLR_ + @sa getSYCR1(), setSYCR1(), getIR(), getSIR(), getSLIR(), getSn_IR(), setIRCLR(), setSLIRCLR(), setSn_IRCLR() +*/ +#define SYCR1_IEN (1 << 7) + +/** + @brief System Clock select mask bit of @ref _SYCR1_. + @details @ref SYCR1_CLKSEL selects a system clock to 100MHz or 25MHz. \n + The masked bit values are as following. + - @ref SYCR1_CLKSEL_25M + - @ref SYCR1_CLKSEL_100M + @note It can be set only when @ref SYSR_CHPL = 1. + @note The system clock is automatically changed to 25MHz while the reset of @ref _WIZCHIP_ H/W reset, the Ethernet PHY H/W reset and power down. \n + On the other hand, the system clock is set by @ref SYCR1_CLKSEL during normal operating. + @sa _SYCR1_, _SYSR_, _CHPLCKR_, SYSL_CHPL, PHYCR1_RST, PHYCR1_PWDN + @sa getSYCR1(), setSYCR1(), getSYSR(), getCHPLCKR(), setCHIPLCKR(), CHIPLOCK(), CHIPUNLOCK(), getPHYCR1(), setPHYCR1() +*/ +#define SYCR1_CLKSEL (1 << 0) + +/** + @brief System Clock - 25MHz + @details @ref SYCR1_CLKSEL_25M selects a system clock to 25MHz. + @note It can be set only when @ref SYSR_CHPL = 1. + @sa _SYCR1_, SYCR1_CLKSEL, SYCR1_CLKSEL_100M + @sa getSYCR1(), setSYCR1(), getSYSR(), getCHPLCKR(), setCHIPLCKR(), CHIPLOCK(), CHIPUNLOCK() +*/ +#define SYCR1_CLKSEL_25M 1 + +/** + @brief System Clock - 100MHz + @details @ref SYCR1_CLKSEL_100M selects a system clock to 100MHz. + @note It can be set only when @ref SYSR_CHPL = 1. + @sa _SYCR1_, SYCR1_CLKSEL, SYCR1_CLKSEL_25M + @sa getSYCR1(), setSYCR1(), getSYSR(), getCHPLCKR(), setCHIPLCKR(), CHIPLOCK(), CHIPUNLOCK() +*/ +#define SYCR1_CLKSEL_100M 0 + + +/* Interrupt Register Bit Definition */ +/** + @brief WOL bit of @ref _IR_ + @details @ref IR_WOL is set when @ref _WIZCHIP_ receives a magic packet of WOL. + @sa _IR_, _IRCLR_, _IMR_ + @sa getIR(), setIRCLR(), getIMR(), setIMR() +*/ +#define IR_WOL (1<<7) + +/** + @brief UNR6 bit of @ref _IR_ + @details @ref IR_UNR6 is set when @ref _WIZCHIP_ receives the unreachable message of ICMPv6. + @sa _IR_, _IRCLR_, _IMR_ + @sa getIR(), setIRCLR(), getIMR(), setIMR() +*/ +#define IR_UNR6 (1<<4) + +/** + @brief IPCONF bit of @ref _IR_ + @details @ref IR_IPCONF is set when @ref _WIZCHIP_ receives a ARP reply with the same IPv4 address as @ref _SIPR_. + @sa _IR_, _IRCLR_, _IMR_ + @sa getIR(), setIRCLR(), getIMR(), setIMR() +*/ +#define IR_IPCONF (1<<2) + +/** + @brief UNR4 bit of @ref _IR_ + @details @ref IR_UNR4 is set when @ref _WIZCHIP_ receives the unreachable message of ICMPv4. + @sa _IR_, _IRCLR_, _IMR_ + @sa getIR(), setIRCLR(), getIMR(), setIMR() +*/ +#define IR_UNR4 (1<<1) + +/** + @brief PTERM bit of @ref _IR_ + @details @ref IR_PTERM is set when @ref _WIZCHIP_ receives the PPP termination packet + @sa _IR_, _IRCLR_, _IMR_ + @sa getIR(), setIRCLR(), getIMR(), setIMR() +*/ +#define IR_PTERM (1<<0) + + +/* SOCKET Interrupt Register Bit Definition */ +/** + @brief N-th INT bit of @@ref _SIR_ + @details @ref SIR_INT(N) is set when @ref _Sn_IR_(N) is not equal to zero. + @sa _SIR_, _Sn_IRCLR_, _SIMR_ + @sa getSIR(), setSn_IRCLR(), getSIMR() +*/ +#define SIR_INT(N) (1<TCP SERVER     mode + If the connection request client have a IPv4 address, \n + TCP dual SOCKETn is changed to TCP4 mode and a destination IP address can be checked thru @ref _Sn_DIPR_, \n + else if the client have a IPv6 address, \n + TCP dual SOCKETn is changed to IPv6 mode and destination IP address can be checked by thru @ref _Sn_DIP6R_. + - In SOCKETn is operated as TCP CLIENT mode, + If the IP address type of destination to connect is IPv4, \n + the destination IP address should be set to @ref _Sn_DIPR_ and try to connect by @ref Sn_CR_CONNECT, \n + else if the type is IPv6, \n + the destination IP address should be set to @ref _Sn_DIP6R_ and try to connect by @ref Sn_CR_CONNECT6. \n + + @note In TCP SERVER mode, You can check the IP type of the client with @ref Sn_ESR_TCPM. + @note If the connected client have a IPv6 address, You can check whether the address is LLA or GAU, thru @ref Sn_ESR_IP6T + @sa _Sn_MR_, _Sn_CR_, _Sn_SR_, _Sn_ESR_TCPM_, Sn_MR_TCP4, Sn_MR_TCP6 + @sa getSn_MR(), setSn_MR(), getSn_CR(), setSn_CR(), getSn_SR(), getSn_ESR() +*/ +#define Sn_MR_TCPD (0x0D) + +/** + @brief UDP Dual mode + @details @ref Sn_MR_UDPD sets SOCKETn to both UDP4 & UDP6 mode. \n + It should be set before @ref Sn_CR_OPEN is performed. \n + After @ref Sn_CR_OPEN, SOCKETn is opened as UDP dual mode \n + and @ref _Sn_SR_ is changed from @ref SOCK_CLOSED to @ref SOCK_UDP. + @note In order to send data, \n + You can use both @ref Sn_CR_SEND and @ref Sn_CR_SEND6 as command and both @ref _Sn_DIPR_ and @ref _Sn_DIP6R_ as destination. + @note You can know the destination IP address type is whether IPv6 or IPv4 thru @ref getsockopt() with @ref SO_PACKINFO. + @sa _Sn_MR_, _Sn_CR_, _Sn_SR_, Sn_MR_UDP6, Sn_MR_UDP4 + @sa getSn_MR(), setSn_MR(), getSn_CR(), setSn_CR(), getSn_SR() +*/ +#define Sn_MR_UDPD (0x0E) + +/* SOCKETn Command Register BIt Definition */ +/** + @brief Initialize or Open SOCKETn. + @details SOCKETn is initialized and opened according to the protocol mode selected by @ref _Sn_MR_ and with a source port set by @ref _Sn_PORTR_. \n + The table shows @ref _Sn_SR_ is changed according to @ref _Sn_MR_.\n + + + + + + + + +
    @ref _Sn_MR_ (P[3:0]) @ref _Sn_SR_
    @ref Sn_MR_CLOSE @ref SOCK_CLOSED
    @ref Sn_MR_TCP4, @ref Sn_MR_TCP6, @ref Sn_MR_TCPD @ref SOCK_INIT
    @ref Sn_MR_UDP, @ref Sn_MR_UDP6, @ref Sn_MR_UDPD @ref SOCK_UDP
    @ref Sn_MR_IPRAW4 @ref SOCK_IPRAW4
    @ref Sn_MR_IPRAW6 @ref SOCK_IPRAW6
    @ref Sn_MR_MACRAW @ref SOCK_MACRAW
    + + @note If you want to use a SOCKETn option such as Sn_MR_MF, Sn_MR_ND, Sn_MR_MUTIL and etc, \n + these options should be set before @ref Sn_CR_OPEN is performed. + @note If you want to open a multicast UDP mode SOCKETn, \n + You should set the multicast group with @ref _Sn_DIPR_ or @ref _Sn_DIP6R_ and @ref _Sn_DPORTR_ before @ref Sn_CR_OPEN is performed. + @sa _Sn_CR_, _Sn_MR_, _Sn_SR_, _Sn_PORTR_, _Sn_DIPR_, _Sn_DIP6R_, _Sn_DPORTR_, + @sa getSn_CR(), setSn_CR(), getSn_MR(), setSn_MR(), getSn_SR(), getSn_PORTR(), setSn_PORTR(), getSn_DIPR(), setSn_DIPR(), + getSn_DIP6R(), setSn_DIP6R(), getSn_DPORTR(), setSn_DPORTR() +*/ +#define Sn_CR_OPEN (0x01) + +/** + @brief Wait a connection request in TCP SERVER mode + @details SOCKETn operates as a TCP SERVER and waits for a connection-request (SYN packet) \n + with corresponding @ref _Sn_PORTR_ port number from any TCP CLIENT \n + The @ref _Sn_SR_ is changed from @ref SOCK_INIT to @ref SOCK_LISTEN. \n + When a TCP CLIENT connection request is successfully accepted,\n + the @ref _Sn_SR_ is changed from @ref SOCK_LISTEN to @ref SOCK_ESTABLISHED \n + and the @ref Sn_IR_CON is set.\n + But when a TCP CLIENT connection request is failed, \n + @ref Sn_IR_TIMEOUT is set and @ref _Sn_SR_ is changed to SOCK_CLOSED. + @note This is valid only in TCP mode such as @ref Sn_MR_TCP4, @ref Sn_MR_TCP6, and @ref Sn_MR_TCPD. + @sa _Sn_CR_, _Sn_MR_, _Sn_SR_, _Sn_PORTR_ + @sa getSn_CR(), setSn_CR(), getSn_MR(), setSn_MR(), getSn_SR(), getSn_PORTR(), setSn_PORTR() +*/ +#define Sn_CR_LISTEN (0x02) + +/** + @brief Send a connection request in TCP CLIENT mode + @details To establish a connection, a connect-request (SYN packet) is sent to TCP SERVER set by @ref _Sn_DIPR_ & @ref _Sn_DPORTR_.\n + If the connect-request is successful accepted by a TCP SERVER, \n + the @ref _Sn_SR_ is changed to @ref SOCK_ESTABLISHED and the @ref Sn_IR_CON is set. \n + The connect-request fails in the following three cases, \n + and @ref _Sn_SR_ is changed to @ref SOCK_CLOSED.\n\n + 1. Until a ARP timeout is occurred (@ref Sn_IR_TIMEOUT = 1), a destination hardware address can not be acquired through the ARP-process.\n + 2. Until a TCP tmeout occurred (@ref Sn_IR_TIMEOUT = 1), a SYN/ACK packet is not received from the server\n + 3. When a RST packet is received instead of a SYN/ACK packet \n + + @note This is valid only in TCP mode such as @ref Sn_MR_TCP4 and @ref Sn_MR_TCPD. + @sa _Sn_CR_, _Sn_MR_, _Sn_SR_, _Sn_DIPR_, _Sn_DPORTR_, Sn_CR_CONNECT6, _Sn_IR_, _Sn_IRCLR_ + @sa getSn_CR(), setSn_CR(), getSn_MR(), setSn_MR(), getSn_SR(), getSn_DIPR(), setSn_DIPR(), getSn_DPORTR(), setSn_DPORTR(), getSn_IR(), setSn_IRCLR() +*/ +#define Sn_CR_CONNECT (0x04) + +/** + @brief Send connection request in TCP CLIENT mode + @details To establish a connection, a connect-request (SYN packet) is sent to TCP SERVER set by @ref _Sn_DIP6R_ & @ref _Sn_DPORTR_.\n + If the connect-request is successful accepted by a TCP SERVER, \n + the @ref _Sn_SR_ is changed to @ref SOCK_ESTABLISHED and the @ref Sn_IR_CON is set. \n + The connect-request fails in the following three cases, and @ref _Sn_SR_ is changed @ref SOCK_CLOSED.\n + 1. Until a ARP timeout is occurred (@ref Sn_IR_TIMEOUT = 1), a destination hardware address can not be acquired through the ARP-process.\n + 2. Until a TCP tmeout occurred (@ref Sn_IR_TIMEOUT = 1), a @b SYN/ACK packet is not received from the server\n + 3. When a RST packet is received instead of a @b SYN/ACK packet \n + + @note This is valid only in TCP mode such as @ref Sn_MR_TCP6 and @ref Sn_MR_TCPD. + @sa _Sn_CR_, _Sn_MR_, _Sn_SR_, _Sn_DIP6R_, _Sn_DPORTR_, Sn_CR_CONNECT, _Sn_IR_, _Sn_IRCLR_ + @sa getSn_CR(), setSn_CR(), getSn_MR(), setSn_MR(), getSn_SR(), getSn_DIP6R(), setSn_DIP6R(), getSn_DPORTR(), setSn_DPORTR(), getSn_IR(), setSn_IRCLR() +*/ +#define Sn_CR_CONNECT6 (0x84) + +/** + @brief Send a disconnect request in TCP mode + @details Regardless of TCP SERVER or TCP CLIENT, \n + @ref Sn_CR_DISCON processes the disconnect-process (Active or Passive close).\n + When the disconnect-process is successful (that is, FIN/ACK packet is received successfully from/to each other),\n + @ref _Sn_SR_ is changed to @ref SOCK_CLOSED.\n + Otherwise, @ref Sn_IR_TIMEOUT is set and then @ref _Sn_SR_ is changed to @ref SOCK_CLOSED. + - Active close + It transmits first a disconnect-request(FIN packet) to the connected peer, and waits to receive two FIN/ACK and FIN packet from the peer. \n + If two FIN/ACK and FIN packet is received successfully, @ref Sn_IR_DISCON is set and @ref _Sn_SR_ is changed @ref SOCK_CLOSED. + - Passive close + When a FIN packet is first received from the peer, the FIN/ACK packet is replied back to the peer and @ref Sn_IR_DISCON is set.\n + And then, a FIN packet is sent by @ref Sn_CR_DISCON to the peer, and waits to receive the FIN/ACK packet from the peer. \n + If the FIN/ACK packet is received successfully from the peer, @ref _Sn_SR_ is changed to @ref SOCK_CLOSED. + + @note It is valid only in TCP mode such as @ref Sn_MR_TCP4, @ref Sn_MR_TCP6, and @ref Sn_MR_TCPD. + @sa _Sn_CR_, _Sn_MR_, _Sn_SR_, _Sn_IR_, _Sn_IRCLR_, Sn_IR_DISCON, Sn_IR_TIMEOUT + @sa getSn_CR(), setSn_CR(), getSn_MR(), setSn_MR(), getSn_SR(), getSn_IR(), setSn_IRCLR() +*/ +#define Sn_CR_DISCON (0x08) + +/** + @brief Release or Close SOCKETn + @details In TCP mode, @ref Sn_CR_CLOSE force to close a SOCKETn without the disconnect-process.\n + In other SOCKETn mode, @ref Sn_CR_CLOSE just closes a SOCKET.\n + @note @ref _Sn_SR_ can be changed from any status to @ref SOCK_CLOSED by @ref Sn_CR_CLOSE. + @sa _Sn_CR_, _Sn_MR_, _Sn_SR_, Sn_CR_DISCON + @sa getSn_CR(), setSn_CR(), getSn_MR(), setSn_MR(), getSn_SR() +*/ +#define Sn_CR_CLOSE (0x10) + +/** + @brief Send Data + @details @ref Sn_CR_SEND send the saved data from @ref _Sn_TX_RD_ to @ref _Sn_TX_WR_ in the SOCKETn TX buffer \n + to the destination specified by @ref _Sn_DIPR_ or @ref _Sn_DIP6R_, and @ref _Sn_DPORTR_.\n + - TCP mode(@ref Sn_MR_TCP4, @ref Sn_MR_TCP6, @ref Sn_MR_TCPD) + If it starts to be sent the data by @ref Sn_CR_SEND, @ref Sn_IR_SENDOK is set. \n + And after sending the data, if the ACK to the sent data can not be received during @ref _Sn_RTR_, \n + the sent data can be retransmitted as many as @ref _Sn_RCR_. \n + During the retransmission, \n + If the ACK is received, @ref _Sn_TX_FSR_ is increased as many as the sent data size, \n + Otherwise, @ref Sn_IR_TIMEOUT is set and @ref _Sn_SR_ is changed to @ref SOCK_CLOSED. + - UDP mode(@ref Sn_MR_UDP4, @ref Sn_MR_UDPD) & IPRAW mode(@ref Sn_MR_IPRAW4) + It first sends a ARP-request to a destination specified with @ref _Sn_DIPR_ before it starts to be sent data by @ref Sn_CR_SEND. \n + If the ARP-reply can not be received during @ref _Sn_RTR_, the ARP-request can be retransmitted as many as @ref _Sn_RCR_. \n + During the retransmission, \n + If the ARP-reply is received and @ref Sn_IR_SENDOK is set, it starts to send data and then @ref _Sn_TX_FSR_ is increased as many as the sent data size. \n + Otherwise, @ref Sn_IR_TIMEOUT is set but @ref _Sn_SR_ is not changed. + - MACRAW mode(@ref Sn_MR_MACRAW) + It just start to send data and @ref Sn_IR_SENDOK is set. + + @note Data size to be sent is calculated by the absolute difference between @ref _Sn_TX_WR_ and @ref _Sn_TX_RD_. \n + In TCP or UDP mode, It can not be sent bigger data than @ref _Sn_TX_FSR_.\n + In IPRAW or Macraw case, it can not be sent bigger data than MTU(Maximum Transmit Unit). + @note In TCP or MACRAW mode, It can send data to a destination address whether IPv4 or IPv6. \n + In UDP or IPRAW mode, It can send data only to a destination IPv4 address. \n + For Sending to IPv6 address, It can be used with @ref Sn_CR_SEND6. + @sa _Sn_CR_, _Sn_MR_, _Sn_DIPR_, _Sn_DIP6R_, _Sn_DPORTR_, _Sn_IR_, _Sn_IRCLR_, _Sn_TX_FSR_, _Sn_TX_WR_, _Sn_TX_RD_ + @sa getSn_CR(), setSn_CR(), getSn_MR(), setSn_MR(), getSn_SR(), getSn_DIPR(), setSn_DIPR(), getSn_DIP6R(), setSn_DIP6R(), \n + getSn_DPORTR(), setSn_DPORTR(), getSn_IR(), setSn_IRCLR(), getSn_TX_FSR(), getSn_TX_WR(), setSn_TX_WR(), getSn_TX_RD() +*/ +#define Sn_CR_SEND (0x20) + +/** + @brief Send Data + @details @ref Sn_CR_SEND6 sends the saved data from @ref _Sn_TX_RD_ to @ref _Sn_TX_WR_ in the SOCKETn TX buffer \n + to the destination specified by @ref _Sn_DIP6R_, and @ref _Sn_DPORTR_.\n + - TCP mode(@ref Sn_MR_TCP4, @ref Sn_MR_TCP6, @ref Sn_MR_TCPD) & MACRAW mode(@ref Sn_MR_MACRAW) + @ref Sn_CR_SEND6 is not recommended. In this case, Use @ref Sn_CR_SEND. + - UDP mode(@ref Sn_MR_UDP6, @ref Sn_MR_UDPD) & IPRAW mode(@ref Sn_MR_IPRAW6) + It first send a neighbor solicitation NS) of ICMPv6 to a destination specified with @ref _Sn_DIP6R_ \n + before it starts to be sent data by @ref Sn_CR_SEND. \n + If the neighbor advertisement(NA) of ICMPv6 can not be received during @ref _Sn_RTR_, \n + the NS can be retransmitted as many as @ref _Sn_RCR_. \n + During the retransmission, \n + If the NA is received and @ref Sn_IR_SENDOK is set, \n + it starts to send data and then @ref _Sn_TX_FSR_ is increased as many as the sent data size. \n + Otherwise, @ref Sn_IR_TIMEOUT is set but @ref _Sn_SR_ is not changed. + + @note Data size to be sent is calculated by the absolute difference between @ref _Sn_TX_WR_ and @ref _Sn_TX_RD_. \n + In TCP or UDP mode, It can not be sent bigger data than @ref _Sn_TX_FSR_.\n + In IPRAW or Macraw case, it can not be sent bigger data than MTU(Maximum Transmit Unit). + @note In UDP or IPRAW mode, It can send data only to a destination IPv6 address. \n + For Sending to IPv4 address, It can be sent by @ref Sn_CR_SEND. + @sa _Sn_CR_, _Sn_MR_, _Sn_DIP6R_, _Sn_DPORTR_, _Sn_IR_, _Sn_IRCLR_, _Sn_TX_FSR_, _Sn_TX_WR_, _Sn_TX_RD_ + @sa getSn_CR(), setSn_CR(), getSn_MR(), setSn_MR(), getSn_SR(), getSn_DIP6R(), setSn_DIP6R(), getSn_DPORTR(), setSn_DPORTR(), \n + getSn_IR(), setSn_IRCLR(), getSn_TX_FSR(), getSn_TX_WR(), setSn_TX_WR(), getSn_TX_RD() +*/ +#define Sn_CR_SEND6 (0xA0) + +/** + @brief Send keep alive message + @details @ref Sn_CR_SEND_KEEP checks whether the connection is established or not by sending 1 byte KA(Keep Alive) packet.\n + If the destination can not respond to the KA packet during the time set by @ref _Sn_RTR_ and @ref _Sn_RCR_, \n + the connection is terminated, @ref Sn_IR_TIMEOUT is set and then @ref _Sn_SR_ is changed @ref SOCK_CLOSED. + @note It is valid only after sending data over 1 byte in TCP mode such as @ref Sn_MR_TCP4, @ref Sn_MR_TCP6, and @ref Sn_MR_TCPD. + @sa _Sn_CR_, _Sn_MR_, _Sn_SR_, _Sn_IR_, _Sn_IRCLR_, _Sn_RTR_, _Sn_RCR_, _Sn_KPALVTR_ + @sa getSn_CR(), setSn_CR(), getSn_MR(), setSn_MR(), getSn_SR(), getSn_IR(), setSn_IRCLR(), \n + getSn_RTR(), setSn_RTR(), getSn_RCR(), setSn_RCR(), getSn_KPALVTR(), getSn_KPALVTR() +*/ +#define Sn_CR_SEND_KEEP (0x22) + +/** + @brief Receive data + @details @ref Sn_CR_RECV reads the saved from @ref _Sn_RX_RD_ to @ref _Sn_RX_WR_ data in SOCKETn RX buffer.\n + When a data is saved in the SOCKETn RX buffer, \n + @ref Sn_IR_RECV is set and @ref _Sn_RX_RSR_ is increased as many as the saved data size.\n + The total size of saved data is calculated by the absolute difference between @ref _Sn_RX_WR_ and @ref _Sn_RX_RD_,\n + and it can be checked thru @ref _Sn_RX_RSR_.\n + After reading data, @ref _Sn_RX_RD_ should be increased as many as the read size before @ref Sn_CR_RECV is performed.\n + After @ref Sn_CR_RECV, @ref _Sn_RX_RSR_ is decreased as many as the read size.\n + If @ref _Sn_RX_RSR_ is remained still at none-zero, @ref Sn_IR_RECV is set again. + @sa _Sn_CR_, _Sn_MR_, _Sn_IR_, _Sn_IRCLR_, _Sn_RX_RD_, _Sn_RX_WR_, _Sn_RX_RSR_ + @sa getSn_CR(), setSn_CR(), getSn_MR(), setSn_MR(), getSn_IR(), getSn_IRCLR(), \n + getSn_RX_RD(), setSn_RX_RD(), getSn_RX_TX(), getSn_RX_RSR() +*/ +#define Sn_CR_RECV (0x40) + + +/* Sn_IR values */ +/** + @brief SEND OK Interrupt + @details @ref Sn_IR_SENDOK is set when it is started to be sent data by @ref Sn_CR_SEND. + @note Even though @ref Sn_IR_SENDOK is set, it does not means that the destination receives data successfully.\n + - In TCP mode, The sent data maybe still transmitting or retransmitting. \n + - In other modes, The sent data maybe lost by media collision or an other reason such as network traffic. + @sa _Sn_IR_, _Sn_IRCLR_, Sn_CR_SEND + @sa getSn_IR(), setSn_IRCLR(), getSn_CR(), setSn_CR() +*/ +#define Sn_IR_SENDOK (0x10) + +/** + @brief TIMEOUT Interrupt + @details @ref Sn_IR_TIMEOUT is set when a timeout occurs in ARP and ND process or TCP retransmission. + @note In TCP mode, If it is set, @ref _Sn_SR_ is changed to @ref SOCK_CLOSED. \n + In other modes, _Sn_SR_ is still remained at the previous status. + @sa _Sn_IR_, _Sn_IRCLR_, Sn_CR_CONNECT, Sn_CR_CONNECT6, Sn_CR_SEND + @sa getSn_IR(), setSn_IRCLR(), getSn_CR(), setSn_CR() +*/ +#define Sn_IR_TIMEOUT (0x08) + +/** + @brief RECV Interrupt + @details @ref Sn_IR_RECV is set whenever data is received from a peer, \n + or if @ref _Sn_RX_RSR_ is still at none-zero whenever @ref Sn_CR_RECV is performed. + @sa _Sn_IR_, _Sn_IRCLR_, Sn_CR_RECV + @sa getSn_IR(), setSn_IRCLR(), getSn_CR(), setSn_CR() +*/ +#define Sn_IR_RECV (0x04) + +/** + @brief DISCON Interrupt + @details @ref Sn_IR_DISCON is set when a FIN or FIN/ACK packet is received from the connected peer. + @note When first a FIN packet is received from the connected peer and @ref _Sn_SR_ is changed to SOCK_CLOSE_WAIT, \n + you should perform @ref Sn_CR_DISCON for a successful disconnect. \n + If the disconnect-process is completed or failed, @ref _Sn_SR_ is changed to @ref SOCK_CLOSED. + @note It is valild only in TCP mode such as @ref Sn_MR_TCP4, @ ref Sn_MR_TCP6 and @ref Sn_MR_TCPD. + @sa _Sn_IR_, _Sn_IRCLR_, Sn_IR_DISCON, _Sn_SR_ + @sa getSn_IR(), setSn_IRCLR(), getSn_CR(), setSn_CR(), getSn_SR() +*/ +#define Sn_IR_DISCON (0x02) + +/** + @brief CONNECT Interrupt + @details @ref Sn_IR_CON is set once the connection with a peer is established and @ref _Sn_SR_ is changed to @ref SOCK_ESTABLISHED. + @note It is valid only in TCP mode such as @ref Sn_MR_TCP4, @ ref Sn_MR_TCP6 adn @ref Sn_MR_TCPD. + @sa _Sn_IR_, _Sn_IRCLR_, _Sn_SR_ + @sa getSn_IR(), setSn_IRCLR(), getSn_SR() +*/ +#define Sn_IR_CON (0x01) + +/* Sn_SR values */ +/** + @brief SOCKETn Closed status + @details @ref SOCK_CLOSED indicates that SOCKETn is closed and released.\n + It is set when @ref Sn_CR_DISCON , @ref Sn_CR_CLOSE is performed, or when @ref Sn_IR_TIMEOUT is set.\n + It can be changed to @ref SOCK_CLOSED regardless of previous status. + @sa _Sn_SR_, _Sn_CR_, _Sn_IR_, _Sn_IRCLR_, Sn_IR_TIMEOUT + @sa getSn_SR(), getSn_CR(), setSn_CR(), getSn_IR(), setSn_IRCLR() +*/ +#define SOCK_CLOSED (0x00) + +/** + @brief TCP SOCKETn initialized status + @details @ref SOCK_INIT indicates SOCKETn is opened with TCP mode such as @ref Sn_MR_TCP4, @ref Sn_MR_TCP6, and @ref Sn_MR_TCP6.\n + @ref _Sn_SR_ is changed from @ref SOCK_CLOSED to @ref SOCK_INIT when @ref Sn_CR_OPEN is performed in TCP mode.\n + In @ref SOCK_INIT status, @ref Sn_CR_LISTEN for operating a TCP SERVER \n + or @ref Sn_CR_CONNECT / @ref Sn_CR_CONNECT6 for operating a TCP CLIENT can be performed. + @note It is valid only in TCP mode. + @sa _Sn_SR_, _Sn_CR_, _Sn_MR_ + @sa getSn_SR, getSn_CR(), setSn_CR(), getSn_MR(), setSn_MR() +*/ +#define SOCK_INIT (0x13) + +/** + @brief TCP SOCKETn Listen status + @details @ref SOCK_LISTEN indicates SOCKETn is operating as TCP SERVER mode \n + and waiting for connection-request (SYN packet) from a peer (TCP CLIENT).\n + @ref _Sn_SR_ is changed to @ref SOCK_SYNRECV when the connection-request(SYN packet) is successfully accepted \n + and It is changed from @ref SOCK_SYNRECV to @ref SOCK_ESTABLISHED \n + when the SYN/ACK packet is sent successfully to the peer and then the ACK packet of SYN/ACK is received successfully.\n + Otherwise, it is changed to @ref SOCK_CLOSED and @ref Sn_IR_TIMEOUT is set. + @note It is valid only in TCP mode such as @ref Sn_MR_TCP4, @ref Sn_MR_TCP6, and @ref Sn_MR_TCP6.. + @sa _Sn_SR_, _Sn_CR_, _Sn_IR_, _Sn_IRCLR_, _Sn_MR_ + @sa getSn_SR, getSn_CR(), getSn_IR(), setSn_IRCLR(), setSn_CR(), getSn_MR(), setSn_MR() +*/ +#define SOCK_LISTEN (0x14) + +/** + @brief TCP Connection Request status + @details @ref SOCK_SYNSENT indicates TCP SOCKETn sent the connect-request packet(SYN packet)\n + to the peer specified by @ref _Sn_DIPR_ / @ref _Sn_DIP6R_ and @ref _Sn_DPORTR_.\n + It is temporarily shown when @ref _Sn_SR_ is changing from @ref SOCK_INIT to @ref SOCK_ESTABLISHED by @ref Sn_CR_CONNECT or @ref Sn_CR_CONNECT6.\n + When the connect-accept packet (SYN/ACK packet) is received from the peer at @ref SOCK_SYNSENT and the ACK packet of SYN/ACK is sent successfully, \n + @ref _Sn_SR_ is changed to @ref SOCK_ESTABLISHED.\n + Otherwise, it is changed to @ref SOCK_CLOSED and @ref Sn_IR_TIMEOUT is set. + @note It is valid only in TCP mode such as @ref Sn_MR_TCP4, @ref Sn_MR_TCP6, and @ref Sn_MR_TCP6.. + @sa _Sn_SR_, _Sn_CR_, _Sn_IR_, _Sn_IRCLR_, _Sn_MR_ + @sa getSn_SR, getSn_CR(), getSn_IR(), setSn_IRCLR(), setSn_CR(), getSn_MR(), setSn_MR() +*/ +#define SOCK_SYNSENT (0x15) + +/** + @brief TCP Connection Accept status + @details @ref SOCK_SYNRECV indicates TCP SOCKETn is successfully received the connect-request packet (SYN packet) from a peer.\n + It is temporarily shown when @ref _Sn_SR_ is changing from @ref SOCK_LISTEN to @ref SOCK_ESTABLISHED by the SYN packet\n + If SOCKETn sends the response (SYN/ACK packet) to the peer successfully and the ACK packet of SYS/ACK is received successfully,\n + @ref _Sn_SR_ is changed to @ref SOCK_ESTABLISHED. \n + Otherwise, @ref _Sn_SR_ is changed to @ref SOCK_CLOSED and @ref Sn_IR_TIMEOUT is set. + @note It is valid only in TCP mode such as @ref Sn_MR_TCP4, @ref Sn_MR_TCP6, and @ref Sn_MR_TCP6.. + @sa _Sn_SR_, _Sn_CR_, _Sn_IR_, _Sn_IRCLR_, _Sn_MR_ + @sa getSn_SR, getSn_CR(), getSn_IR(), setSn_IRCLR(), setSn_CR(), getSn_MR(), setSn_MR() +*/ +#define SOCK_SYNRECV (0x16) + +/** + @brief TCP SOCKETn Established status + @details @ref SOCK_ESTABLISHED indicates TCP SOCKETn is connected successfully with a peer.\n + when the TCP SERVER processes the SYN packet from the TCP CLIENT during @ref SOCK_LISTEN or \n + when the TCP CLIENT performs successfully @ref Sn_CR_CONNECT or @ref Sn_CR_CONNECT6,\n + @ref _Sn_SR_ is changed to @ref SOCK_ESTABLISHED and @ref Sn_IR_CON is set. \n + During @ref SOCK_ESTABLISHED, a DATA packet can be sent to or received from the peer by @ref Sn_CR_SEND or @ref Sn_CR_RECV. \n + If the DATA/ACK packet is not received from the peer during data re-transmission, @ref Sn_IR_TIMEOUT is set and @ref _Sn_SR_ is changed to @ref SOCK_CLOSED.\n + Otherwise, @ref _Sn_SR_ is still at @ref SOCK_ESTABLISHED. + @note In TCP SERVER, \n + You can check the IPv4/IPv6 address and port number of connected peer thru @ref _Sn_DIPR_, @ref _Sn_DIP6R_, and @ref _Sn_DPORTR_ respectively. + @note It is valid only in TCP mode such as @ref Sn_MR_TCP4, @ref Sn_MR_TCP6, and @ref Sn_MR_TCP6. + @sa _Sn_SR_, _Sn_CR_, _Sn_IR_, _Sn_IRCLR_, _Sn_MR_, _Sn_DIPR_, _Sn_DIP6R_, _Sn_DPORTR_ + @sa getSn_SR, getSn_CR(), getSn_IR(), setSn_IRCLR(), setSn_CR(), getSn_MR(), setSn_MR(), + getSn_DIPR(), setSn_DIPR(), getSn_DIP6R(), setSn_DIP6R(), getSn_DPORTR(), setSn_DPORTR(). +*/ +#define SOCK_ESTABLISHED (0x17) + +/** + @brief TCP SOCKETn Closing status + @details @ref SOCK_FIN_WAIT indicates TCP mode SOCKETn waits until the disconnect-process is completed. \n + It is temporarily shown in disconnect-process such as active-close. \n + When the disconnect-process is successfully completed or when @ref Sn_IR_TIMEOUT is set,\n + @ref _Sn_SR_ is changed to @ref SOCK_CLOSED. + @note It is valid only in TCP mode such as @ref Sn_MR_TCP4, @ref Sn_MR_TCP6, and @ref Sn_MR_TCPD. + @sa _Sn_SR_, _Sn_CR_, _Sn_IR_, _Sn_IRCLR_, _Sn_MR_, SOCK_TIME_WAIT, SOCK_LAST_ACK + @sa getSn_SR, getSn_CR(), getSn_IR(), setSn_IRCLR(), setSn_CR(), getSn_MR(), setSn_MR() + +*/ +#define SOCK_FIN_WAIT (0x18) + +/** + @brief TCP SOCKETn Closing status + @details @ref SOCK_TIME_WAIT indicates TCP SOCKETn waits until the disconnect-process is completed.\n + It is temporarily shown in disconnect-process such as active-close. \n + When the disconnect-process is successfully completed or when @ref Sn_IR_TIMEOUT is set,\n + @ref _Sn_SR_ is changed to @ref SOCK_CLOSED. + @note It is valid only in TCP mode such as @ref Sn_MR_TCP4, @ref Sn_MR_TCP6, and @ref Sn_MR_TCPD. + @sa _Sn_SR_, _Sn_CR_, _Sn_IR_, _Sn_IRCLR_, _Sn_MR_, SOCK_FIN_WAIT, SOCK_LAST_ACK + @sa getSn_SR, getSn_CR(), getSn_IR(), setSn_IRCLR(), setSn_CR(), getSn_MR(), setSn_MR() +*/ +#define SOCK_TIME_WAIT (0x1B) + +/** + @brief TCP SOCKETn Half Closing staus + @details @ref SOCK_CLOSE_WAIT indicates TCP SOCKETn receives the disconnect-request (FIN packet) from the connected peer.\n + It is a half-closing status, and a DATA packet can be still sent or received by @ref Sn_CR_SEND or @ref Sn_CR_RECV.\n + If you do not have any more need to send or received a DATA packet, You can perform @ref Sn_CR_DISCON for a full-closing. + @note If you have no need the successful closing, You maybe perform @ref Sn_CR_CLOSE. + @note It is valid only in TCP mode such as @ref Sn_MR_TCP4, @ref Sn_MR_TCP6, and @ref Sn_MR_TCPD. + @sa _Sn_SR_, _Sn_CR_, _Sn_IR_, _Sn_IRCLR_, _Sn_MR_ + @sa getSn_SR, getSn_CR(), getSn_IR(), setSn_IRCLR(), setSn_CR(), getSn_MR(), setSn_MR() +*/ +#define SOCK_CLOSE_WAIT (0x1C) + +/** + @brief TCP SOCKETn Closing status + @details @ref SOCK_LAST_ACK indicates TCP SOCKETn waits until the disconnect-process is completed.\n + It is temporarily shown in disconnect-process such as active-close and passive-close.\n + When the disconnect-process is successfully completed or when @ref Sn_IR_TIMEOUT is set,\n + @ref _Sn_SR_ is changed to @ref SOCK_CLOSED. + @note It is valid only in TCP mode such as @ref Sn_MR_TCP4, @ref Sn_MR_TCP6, and @ref Sn_MR_TCPD. + @sa _Sn_SR_, _Sn_CR_, _Sn_IR_, _Sn_IRCLR_, _Sn_MR_, SOCK_FIN_WAIT, SOCK_TIME_WAIT + @sa getSn_SR, getSn_CR(), getSn_IR(), setSn_IRCLR(), setSn_CR(), getSn_MR(), setSn_MR() +*/ +#define SOCK_LAST_ACK (0x1D) + +/** + @brief UDP SOCKETn status + @details @ref SOCK_UDP indicates SOCKETn is opened in UDP mode such as @ref Sn_MR_UDP4, @ref Sn_MR_UDP6, and @ref Sn_MR_UDPD.\n + @ref _Sn_SR_ is changed from @ref SOCK_CLOSED to @ref SOCK_INIT when @ref Sn_CR_OPEN is performed in UDP mode.\n + Unlike TCP mode, during @ref SOCK_UDP, \n + a DATA packet can be sent to or received from a peer by @ref Sn_CR_SEND / @ref Sn_CR_SEND6 or @ref Sn_CR_RECV without a connect-process.\n + Before a DATA packet is sent by @ref Sn_CR_SEND / @ref Sn_CR_SEND6,\n + the ARP is requested to the peer specified by @ref _Sn_DIPR_ / @ref _Sn_DIP6R_.\n + In ARP processing, @ref _Sn_SR_ is stll at @ref SOCK_UDP even if @ref Sn_IR_TIMEOUT is set.\n + If you do not have any more need to send or received a DATA packet, \n + You can perform @ref Sn_CR_CLOSE and @ref _Sn_SR_ is changed to @ref SOCK_CLOSED. + @note It is valid only in UDP mode such as @ref Sn_MR_UDP4, @ref Sn_MR_UDP6, and @ref Sn_MR_UDPD. + @sa _Sn_SR_, _Sn_CR_, _Sn_IR_, _Sn_IRCLR_, _Sn_MR_, _Sn_DIPR_, _Sn_DIP6R_ + @sa getSn_SR, getSn_CR(), getSn_IR(), setSn_IRCLR(), setSn_CR(), getSn_MR(), setSn_MR(), + getSn_DIPR(), setSn_DIPR(), getSn_DIP6R(), setSn_DIP6R() +*/ +#define SOCK_UDP (0x22) + +/** + @brief IPRAW4 SOCKETn mode + @details @ref SOCK_IPRAW4(= @ref SOCK_IPRAW) SOCKETn indicates SOCKETn is opened as IPv4 RAW mode.\n + @ref _Sn_SR_ is changed from @ref SOCK_CLOSED to @ref SOCK_IPRAW4 when @ref Sn_CR_OPEN is performed with @ref Sn_MR_IPRAW4. \n + A DATA packet can be send to or received from a peer without a connection like as @ref SOCK_UDP. \n + Before a DATA packet is sent by @ref Sn_CR_SEND, \n + the ARP is requested to the peer specified by @ref _Sn_DIPR_.\n + In ARP processing, @ref _Sn_SR_ is still at @ref SOCK_IPRAW4 even if @ref Sn_IR_TIMEOUT is set.\n + IPRAW4 SOCKETn can receive only the packet specified by @ref _Sn_PNR_, and it discards the others packets.\n + If you do not have any more need to send or received a DATA packet, \n + You can perform @ref Sn_CR_CLOSE and @ref _Sn_SR_ is changed to @ref SOCK_CLOSED. + @note It is valid only in IPRAW4 mode such as @ref Sn_MR_IPRAW4. + @sa _Sn_SR_, _Sn_CR_, _Sn_IR_, _Sn_IRCLR_, _Sn_MR_, _Sn_DIPR_, _Sn_PNR_ + @sa getSn_SR, getSn_CR(), getSn_IR(), setSn_IRCLR(), setSn_CR(), getSn_MR(), setSn_MR(), + getSn_DIPR(), setSn_DIPR(), getSn_PNR(), setSn_PNR() +*/ +#define SOCK_IPRAW4 (0x32) +#define SOCK_IPRAW (SOCK_IPRAW4) ///< Refer to @ref SOCK_IPRAW4. + +/** + @brief IPRAW6 SOCKETn mode + @details @ref SOCK_IPRAW6 SOCKETn indicates SOCKETn is opened as IPv6 RAW mode.\n + @ref _Sn_SR_ is changed from @ref SOCK_CLOSED to @ref SOCK_IPRAW6 when @ref Sn_CR_OPEN is performed with @ref Sn_MR_IPRAW6. \n + A DATA packet can be send to or received from a peer without a connection like as @ref SOCK_UDP.\n + Before a DATA packet is sent by @ref Sn_CR_SEND6, \n + the ICMPv6 NS is requested to the peer specified by @ref _Sn_DIPR_ or @ref _Sn_DIP6R_.\n + In ND(Neighbor Discovery) is processing,\n + @ref _Sn_SR_ is still at @ref SOCK_IPRAW6 even if @ref Sn_IR_TIMEOUT is set.\n + IPRAW6 SOCKETn can receive only the packet specified by @ref _Sn_PNR_, and it discards the others packets.\n + If you do not have any more need to send or received a DATA packet, \n + You can perform @ref Sn_CR_CLOSE and @ref _Sn_SR_ is changed to @ref SOCK_CLOSED. + @note It is valid only in IPRAW6 mode such as @ref Sn_MR_IPRAW6. + @sa _Sn_SR_, _Sn_CR_, _Sn_IR_, _Sn_IRCLR_, _Sn_MR_, _Sn_DIP6R_, _Sn_PNR_ + @sa getSn_SR, getSn_CR(), getSn_IR(), setSn_IRCLR(), setSn_CR(), getSn_MR(), setSn_MR(), + getSn_DIP6R(), setSn_DIP6R(), getSn_PNR(), setSn_PNR() +*/ +#define SOCK_IPRAW6 (0x33) + +/** + @brief MACRAW SOCKETn mode + @details @ref SOCK_MACRAW indicates SOCKET0 is opened as MACRAW mode.\n + @ref _Sn_SR_ is changed from @ref SOCK_CLOSED to @ref SOCK_MACRAW when @ref Sn_CR_OPEN command is ordered with @ref Sn_MR_MACRAW.\n + MACRAW SOCKET0 can be sent or received a pure Ethernet frame packet to/from any peer. + @note It is valid only in SOCKET0. + @sa _Sn_SR_, _Sn_CR_, _Sn_IR_, _Sn_IRCLR_, _Sn_MR_ + @sa getSn_SR, getSn_CR(), getSn_IR(), setSn_IRCLR(), setSn_CR(), getSn_MR(), setSn_MR(), +*/ +#define SOCK_MACRAW (0x42) + +/* Sn_ESR values */ +/** + @brief SOCKETn Extended Status : TCP Mode + @details @ref Sn_ESR_TCPM masks the TCPM bit of @ref _Sn_ESR_. \n + The masked bit values are as following. \n + - @ref Sn_ESR_TCPM_IPV4 + - @ref Sn_ESR_TCPM_IPV6 + @note It is useful to know the destination IP version when TCPD(@ref Sn_MR_TCPD) mode SOCKETn is operated as TCP SERVER. + @sa _Sn_ESR_ + @sa getSn_ESR() +*/ +#define Sn_ESR_TCPM (1<<2) + +/** + @brief TCP SOCKETn IP version - IPv4 + @details @ref Sn_ESR_TCPM_IPV4 indicates TCP SOCKETn is operated on IPv4 . + @sa _Sn_ESR_, Sn_ESR_TCPM_IPV6 + @sa getSn_ESR() +*/ +#define Sn_ESR_TCPM_IPV4 (0<<2) + +/** + @brief TCP SOCKETn IP version - IPv6 + @details @ref Sn_ESR_TCPM_IPV6 indicates TCP SOCKETn is operated on IPv6 . + @sa _Sn_ESR_, Sn_ESR_TCPM_IPV4 + @sa getSn_ESR() +*/ +#define Sn_ESR_TCPM_IPV6 (1<<2) + +/** + @brief SOCKETn Extended Status : TCP Operation Mode + @details @ref Sn_ESR_TCPOP masks the TCPOP bit of @ref _Sn_ESR_. The masked bit values are as following. \n + - @ref Sn_ESR_TCPOP_SVR + - @ref Sn_ESR_TCPOP_CLT + @note It is useful to check TCP mode SOCKETn is operated as whether TCP SERVER or TCP CLIENT. + @sa _Sn_ESR_ + @sa getSn_ESR() +*/ +#define Sn_ESR_TCPOP (1<<1) + +/** + @brief TCP SOCKETn Operation Mode - TCP SERVER + @details @ref Sn_ESR_TCPOP_SVR indicates TCP mode SOCKET n is operated as TCP SERVER + @note It is valid only in TCP mode such as @ref Sn_MR_TCP4, @ref Sn_MR_TCP6, and @ref Sn_MR_TCPD. + @sa _Sn_ESR_, Sn_ESR_TCPOP_CLT + @sa getSn_ESR() +*/ +#define Sn_ESR_TCPOP_SVR (0<<1) + +/** + @brief TCP SOCKETn Operation Mode - TCP CLIENT + @details @ref Sn_ESR_TCPOP_SVR indicates TCP mode SOCKET n is operated as TCP CLIENT + @note It is valid only in TCP mode such as @ref Sn_MR_TCP4, @ref Sn_MR_TCP6, and @ref Sn_MR_TCPD. + @sa _Sn_ESR_, Sn_ESR_TCPOP_SVR + @sa getSn_ESR() +*/ +#define Sn_ESR_TCPOP_CLT (1<<1) + +/** + @brief SOCKETn Extended Status : Source IPv6 Address Type + @details @ref Sn_ESR_IP6T masks the IP6T bit of @ref _Sn_ESR_. \n + The masked bit values are as following. \n + - @ref Sn_ESR_IP6T_LLA + - @ref Sn_ESR_IP6T_GUA + @note It is useful to check whether the connected peer IP address is LLA or GUA. + @note It is valid only in TCP mode such as @ref Sn_MR_TCP6 and @ref Sn_MR_TCPD. + @sa _Sn_ESR_ + @sa getSn_ESR() +*/ +#define Sn_ESR_IP6T (1<<0) + +/** + @brief Source IPv6 Address Type - LLA + @details @ref Sn_ESR_IP6T_LLA indicates the source IPv6 Address is used as @ref _LLAR_ + @note It is valid only in TCP mode such as @ref Sn_MR_TCP6, and @ref Sn_MR_TCPD. + @sa _Sn_ESR_, Sn_ESR_IP6T_GUA, _LLAR_ + @sa getSn_ESR(), getLLAR(), setLLAR() +*/ +#define Sn_ESR_IP6T_LLA (0<<0) + +/** + @brief Source IPv6 Address Type - LLA + @details @ref Sn_ESR_IP6T_GUA indicates the source IPv6 Address is used as @ref _GUAR_ + @note It is valid only in TCP mode such as @ref Sn_MR_TCP6, and @ref Sn_MR_TCPD. + @sa _Sn_ESR_, Sn_ESR_IP6T_LLA, _GUAR_ + @sa getSn_ESR(), getGUAR(), setGUAR() +*/ +#define Sn_ESR_IP6T_GUA (1<<0) + +/* Sn_MR2 values */ +/** + @brief Destination Hardware Address Mode + @details @ref Sn_MR2_DHAM masks the DHAM bit of @ref _Sn_MR2_.\n + The masked bit values are as following. + - @ref Sn_MR2_DHAM_AUTO + - @ref Sn_MR2_DHAM_MANUAL + @sa _Sn_MR2_ + @sa getSn_MR2(), setSn_MR2() +*/ +#define Sn_MR2_DHAM (1<<1) + +/** + @brief Destination Hardware Address Mode - AUTO + @details @ref Sn_MR2_DHAM_AUTO sets the destination hardware address as the address acquired by ARP-process. + @sa _Sn_MR2_, Sn_MR_DHAM_MANUAL, NETMR_DHAS + @sa getSn_MR2(), setSn_MR2(), getNETMR(), setNETMR() +*/ +#define Sn_MR2_DHAM_AUTO (0<<1) + +/** + @brief Destination Hardware Address Mode - MANUAL + @details @ref Sn_MR2_DHAM_MANUAL sets the destination hardware address as @ref _Sn_DHAR_. + @sa _Sn_MR2_, Sn_MR_DHAM_MANUAL, NETMR_DHAS + @sa getSn_MR2(), setSn_MR2(), getNETMR(), setNETMR() +*/ +#define Sn_MR2_DHAM_MANUAL (1<<1) + +/** + @brief Force ARP + @details @ref Sn_MR2_FARP force to perform the ARP-process for acquiring the destination hardware address, before data communication\n + 0 : Normal \n + 1 : Force ARP + - In TCP mode such as @ref Sn_MR_TCP4, @ref Sn_MR_TCP6, and @ref Sn_MR_TCPD + If SOCKETn is operated as TCP SERVER, It sets the destination hardware address as the address + acquired by the forced ARP-process before sending SYN/ACK packet. + - In UDP mode such as @ref Sn_MR_UDP4, @ref Sn_MR_UDP6, and @ref Sn_MR_UDPD + It sets the destination hardware address as the address acquired by the forced ARP-process whenever @ref Sn_CR_SEND or @ref Sn_CR_SEND6. + @note When @ref Sn_MR2_DHAM_MANUAL and @ref Sn_MR2_FARP = '1', It sets the destination hardware address as @ref _Sn_DHAR_ even if the ARP-process is forced. +*/ +#define Sn_MR2_FARP (1<<0) + + +/*----------------------------For PHY Control-------------------------------*/ + +/** + @ingroup Common_register_group_W6100 + @brief Basic Mode Control Register of Ethernet PHY [RW][0x3100] + @details @ref PHYRAR_BMCR can be controlled by MDC/MDIO controller of @ref _WIZCHIP_. \n + Each bit of @ref PHYRAR_BMCR is defined as the following. + + + +
    15 14 13 12 11 10 9 8 7 6 ~ 0
    RST LB SPD ANE PWDN ISOL RAN DPX COLT Reserved
    + - @ref BMCR_RST + - @ref BMCR_LB + - @ref BMCR_SPD + - @ref BMCR_ANE + - @ref BMCR_PWDN + - @ref BMCR_ISOL : Not supported. + - @ref BMCR_REAN + - @ref BMCR_DPX + - @ref BMCR_COLT + + @note Its some bits have the same function as @ref _PHYCR0_ and @ref _PHYCR1_.\n + It can control the Ethernet PHY with software, while @ref _PHYCR0_ \n + and @ref _PHYCR1_ can control the Ethernet PHY with hardware. + + @sa PHYRAR_BMSR, _PHYRAR_, _PHYDIR_, _PHYDOR_, _PHYACR_, _PHYCR0_, _PHYCR1_ + @sa getPHYRAR(), setPHYRAR(), wiz_mdio_read(), wiz_mdio_write() +*/ +#define PHYRAR_BMCR (0x00) + +//Basic mode status register, basic register +/** + @ingroup Common_register_group_W6100 + @brief Basic Mode Status Register of Ethernet PHY [RO][0x7809] + @details @ref PHYRAR_BMSR gets the status of Ethernet PHY through MDC/MDIO controller of @ref _WIZCHIP_. \n + Each bit of @ref PHYRAR_BMSR is defined as the following. + + + + + +
    15 14 13 12 11 10~76 5 4 3 2 1 0
    100_T4 100_FDX 100_HDX 10_FDX 10_HDX Reserved MF_SUPANG_COMP REMOTE_FAULT ANG_ABILITY LINK_STATUS JABBER_DETECT EXT_CAPA
    + - @ref BMSR_100_T4 : Not supported. Always 0 + - @ref BMSR_100_FDX + - @ref BMSR_100_HDX + - @ref BMSR_10_FDX + - @ref BMSR_10_HDX + - @ref BMSR_MF_SUP : Not supported. Always 0. + - @ref BMSR_AN_COMP + - @ref BMSR_REMOTE_FAULT : Not supported. Always 0. + - @ref BMSR_AN_ABILITY + - @ref BMSR_LINK_STATUS + - @ref BMSR_JABBER_DETECT + - @ref BMSR_EXT_CAPA : Always 1. If you need a extended register information, send e-mail to support@wiznet.io + + @note Its some bits have the same function as @ref _PHYSR_. + @sa PHYRAR_BMCR, _PHYRAR_, _PHYDIR_, _PHYDOR_, _PHYACR_, _PHYCR0_, _PHYCR1_ + @sa getPHYRAR(), setPHYRAR(), wiz_mdio_read(), wiz_mdio_write() +*/ +#define PHYRAR_BMSR (0x01) + + +/********************/ +/* BMCR & BMSR Bit definitions */ +/********************/ + +/*For BMCR register*/ +/** + @brief Ethernet PHY S/W Reset. + @details 0 - Normal operation \n + 1 - Software reset + @sa PHYRAR_BMCR, PHYCR1_RST + @sa getPHYRAR_BMCR(), setPHYRAR_BMCR() +*/ +#define BMCR_RST (1<<15) + +/** + @brief Ethernet PHY Loopback. + @details 0 - Normal Operation \n + 1 - Loopback Enable + @sa PHYRAR_BMCR + @sa getPHYRAR_BMCR(), setPHYRAR_BMCR() +*/ +#define BMCR_LB (1<<14) ///< Loopback. 0 - Noraml operation, 1 - Loopback enabled + +/** + @brief Ethernet PHY Speed + @details 0 - 10 Mbps \n + 1 - 100 Mbps + @sa PHYCR_BMCR, PHYCR0_100F, PHYCR0_100H, PHYCR0_10F, PHYCR0_10H + @sa getPHYRAR_BMCR(), setPHYRAR_BMCR(), setPHYCR0() +*/ +#define BMCR_SPD (1<<13) + +/** + @brief Ethernet PHY Auto-Negotiation + @details 0 - Disable \n + 1 - Enable + @note When it is set, @ref BMCR_SPD and @ref BMCR_DPX is ignored + @sa PHYCR_BMCR, PHYCR0_AUTO + @sa getPHYRAR_BMCR(), setPHYRAR_BMCR(), setPHYCR0() +*/ +#define BMCR_ANE (1<<12) + +/** + @brief Ethernet PHY Power Down Mode + @details 0 - Normal Operation \n + 1 - Power Down mode + @sa PHYCR_BMCR, PHYCR0_PWDN + @sa getPHYRAR_BMCR(), setPHYRAR_BMCR(), setPHYCR0() +*/ +#define BMCR_PWDN (1<<11) ///< Power-down mode + +/** + @brief Ethernet PHY Isolation Mode + @details 0 - Normal Operation \n + 1 - Isolation Mode + @ Don't set it to '1'. It is not supported. + @sa PHYCR_BMCR + @sa getPHYRAR_BMCR(), setPHYRAR_BMCR() +*/ +#define BMCR_ISOL (1<<10) + +/** + @brief Ethernet PHY Restart Auto-Negotiation + @details 0 - Normal Operation \n + 1 - Restart Auto-Negotiation + @sa PHYCR_BMCR + @sa getPHYRAR_BMCR(), setPHYRAR_BMCR() +*/ +#define BMCR_REAN (1<<9) + +/** + @brief Ethernet PHY Duplex + @details 0 - Half-Duplex \n + 1 - Full-Duplex + @sa PHYCR_BMCR, PHYCR0_100F, PHYCR0_100H, PHYCR0_10F, PHYCR0_10H + @sa getPHYRAR_BMCR(), setPHYRAR_BMCR(), setPHYCR0() +*/ +#define BMCR_DPX (1<<8) + +/** + @brief Ethernet PHY Collision Test + @details 0 - Normal Operation \n + 1 - Collision Test + @sa PHYCR_BMCR + @sa getPHYRAR_BMCR(), setPHYRAR_BMCR() +*/ +#define BMCR_COLT (1<<7) + +/*For BMSR register*/ + +/** + @brief Ethernet PHY 100 Base-T4 capable + @details @ref BMSR_100_T4 is always 0. + @note It is not supported. + @sa PHYCR_BMSR + @sa getPHYRAR_BMSR() +*/ +#define BMSR_100_T4 (1<<15) + +/** + @brief Ethernet PHY 100 Base-TX Full-Duplex capable + @details @ref BMSR_100_FDX is always 1. + @sa PHYCR_BMSR + @sa getPHYRAR_BMSR() +*/ +#define BMSR_100_FDX (1<<14) + +/** + @brief Ethernet PHY 100 Base-TX Half-Duplex capable + @details @ref BMSR_100_HDX is always 1. + @sa PHYCR_BMSR + @sa getPHYRAR_BMSR() +*/ +#define BMSR_100_HDX (1<<13) + +/** + @brief Ethernet PHY 10 Base-T Full-Duplex capable + @details @ref BMSR_10_FDX is always 1. + @sa PHYCR_BMSR + @sa getPHYRAR_BMSR() +*/ +#define BMSR_10_FDX (1<<12) + +/** + @brief Ethernet PHY 10 Base-T Half-Duplex capable + @details @ref BMSR_10_HDX is always 1. + @sa PHYCR_BMSR + @sa getPHYRAR_BMSR() +*/ +#define BMSR_10_HDX (1<<11) + +/** + @brief Ethernet PHY Management Frame preamble suppression + @details @ref BMSR_MF_SUP is always 0. + @note It is not supported + @sa PHYCR_BMSR + @sa getPHYRAR_BMSR() +*/ +#define BMSR_MF_SUP (1<<6) + +/** + @brief Ethernet PHY Auto-Negotiation Complete + @details @ref BMSR_MF_SUP indicates the status of auto-negotiation. \n + 0 - Auto-negotiation process is not completed \n + 1 - Auto-negotiation process is completed + @sa PHYCR_BMSR + @sa getPHYRAR_BMSR() +*/ +#define BMSR_AN_COMP (1<<5) + +/** + @brief Ethernet PHY Remote Fault + @details @ref BMSR_REMOTE_FAULT is always 0. + @note It is not supported + @sa PHYCR_BMSR + @sa getPHYRAR_BMSR() +*/ +#define BMSR_REMOTE_FAULT (1<<4) + +/** + @brief Ethernet PHY Auto-Negotiation Ability + @details @ref BMSR_AN_ABILITY is always 1. + @sa PHYCR_BMSR + @sa getPHYRAR_BMSR() +*/ +#define BMSR_AN_ABILITY (1<<3) + +/** + @brief Ethernet PHY Link Status + @details @ref BMSR_LINK_STATUS indicates the status of link. \n + 0 - Link is not established + 1 - Valid link is established + @sa PHYCR_BMSR + @sa getPHYRAR_BMSR() +*/ +#define BMSR_LINK_STATUS (1<<2) + +/** + @brief Ethernet PHY Jabber Detect + @details @ref BMSR_JABBER_DETECT indicates the status of auto-negotiation. \n + 0 - Jabber condition is not detected\n + 1 - Jabber condition is detected + @sa PHYCR_BMSR + @sa getPHYRAR_BMSR() +*/ +#define BMSR_JABBER_DETECT (1<<1) + +/** + @brief Ethernet PHY Extended capability + @details @ref BMSR_EXT_CAPA indicates the extended register capability. \n + 0 - Only basic registers are capable\n + 1 - Extended registers are capable + @sa PHYCR_BMSR + @sa getPHYRAR_BMSR() +*/ +#define BMSR_EXT_CAPA (1<<0) + + +/** + @brief Enter a critical section + @details It is provided to protect your shared code and hardware resources against interference. \n + - Non-OS environment + It can be just implemented by disabling whole interrupt. + - OS environment + You can replace it to critical section API supported by OS. + + @note It is callback function that can be replaced it with your code, by calling @ref reg_wizchip_cris_cbfunc(). + @sa WIZCHIP_READ(), WIZCHIP_WRITE(), WIZCHIP_READ_BUF(), WIZCHIP_WRITE_BUF() + @sa WIZCHIP_CRITICAL_EXIT(), reg_wizchip_cris_cbfunc() +*/ +#define WIZCHIP_CRITICAL_ENTER() WIZCHIP.CRIS._enter() + + +/** + @brief Enter a critical section + @details It exits the protected code and hardware resources against interference. \n + - Non-OS environment + It can be just implemented by enabling whole interrupt.\n + - OS environment + You can replace it to critical section API supported by OS. + + @note It is callback function that can be replaced it with your code, by calling @ref reg_wizchip_cris_cbfunc(). + @sa WIZCHIP_READ(), WIZCHIP_WRITE(), WIZCHIP_READ_BUF(), WIZCHIP_WRITE_BUF() + @sa WIZCHIP_CRITICAL_EXIT(), reg_wizchip_cris_cbfunc() +*/ +#define WIZCHIP_CRITICAL_EXIT() WIZCHIP.CRIS._exit() + + + +//////////////////////// +// Basic I/O Function // +//////////////////////// +// +// +/** + @ingroup Basic_IO_function_W6100 + @brief It reads 1 byte value from a register. + @param AddrSel Register address + @return The value of register + @sa WIZCHIP_READ_BUF(), reg_wizchip_bus_cbfunc(), reg_wizchip_spi_cbfunc(), WIZCHIP_WRITE() +*/ +uint8_t WIZCHIP_READ(uint32_t AddrSel); + +/** + @ingroup Basic_IO_function_W6100 + @brief It writes 1 byte value to a register. + @param AddrSel Register address + @param wb Write data + @return void + @sa WIZCHIP_WRITE_BUF(), reg_wizchip_bus_cbfunc(), reg_wizchip_spi_cbfunc(), WIZCHIP_READ() +*/ +void WIZCHIP_WRITE(uint32_t AddrSel, uint8_t wb); + +/** + @ingroup Basic_IO_function_W6100 + @brief It reads sequentail data from registers. + @param AddrSel Register address + @param pBuf Pointer buffer to read data + @param len Data length + @return void + @sa WIZCHIP_WRITE_BUF(), reg_wizchip_bus_cbfunc(), reg_wizchip_spi_cbfunc(), WIZCHIP_READ() +*/ +void WIZCHIP_READ_BUF(uint32_t AddrSel, uint8_t* pBuf, uint16_t len); + +/** + @ingroup Basic_IO_function_W6100 + @brief It writes sequential data to registers. + @param AddrSel Register address + @param pBuf Pointer buffer to write data + @param len Data length + @return void + @sa WIZCHIP_READ_BUF(), reg_wizchip_bus_cbfunc(), reg_wizchip_spi_cbfunc(), WIZCHIP_WRITE() +*/ +void WIZCHIP_WRITE_BUF(uint32_t AddrSel, uint8_t* pBuf, uint16_t len); + + + +///////////////////////////////// +// Common Register IO function // +///////////////////////////////// +/** + @addtogroup Common_register_access_function_W6100 + @{ +*/ +#define getCIDR() \ + ((((uint16_t)WIZCHIP_READ(_CIDR_)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(_CIDR_,1))) + +#define getVER() \ + ((((uint16_t)WIZCHIP_READ(_VER_)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(_VER_,1))) + +#define getSYSR() \ + WIZCHIP_READ(_SYSR_) + +#define getSYCR0() \ + WIZCHIP_READ(_SYCR0_) + +#define setSYCR0(sycr0) \ + WIZCHIP_WRITE(_SYCR0_, (sycr0)) + +#define getSYCR1() \ + WIZCHIP_READ(_SYCR1_) + +#define setSYCR1(sycr1) \ + WIZCHIP_WRITE(_SYCR1_, (sycr1)) + +#define getTCNTR() \ + ((((uint16_t)WIZCHIP_READ(_TCNTR_)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(_TCNTR_,1))) + +#define setTCNTRCLR(tcntrclr) \ + WIZCHIP_WRITE(_TCNTRCLR_,(tcntrclr)) + +#define getIR() \ + WIZCHIP_READ(_IR_) + +#define getSIR() \ + WIZCHIP_READ(_SIR_) + +#define getSLIR() \ + WIZCHIP_READ(_SLIR_) + +#define setIMR(imr) \ + WIZCHIP_WRITE(_IMR_,(imr)) + +#define getIMR() \ + WIZCHIP_READ(_IMR_) + +#define setIRCLR(irclr) \ + WIZCHIP_WRITE(_IRCLR_,(irclr)) +#define setIR(ir) setIRCLR(ir) + +#define setSIMR(simr) \ + WIZCHIP_WRITE(_SIMR_,(simr)) + +#define getSIMR() \ + WIZCHIP_READ(_SIMR_) + +#define setSLIMR(slimr) \ + WIZCHIP_WRITE(_SLIMR_,(slimr)) + +#define getSLIMR() \ + WIZCHIP_READ(_SLIMR_) + +#define setSLIRCLR(slirclr) \ + WIZCHIP_WRITE(_SLIRCLR_,(slirclr)) +#define setSLIR(slir) setSLIRCLR(slir) + +#define setSLPSR(slpsr) \ + WIZCHIP_WRITE(_SLPSR_,(slpsr)) + +#define getSLPSR() \ + WIZCHIP_READ(_SLPSR_) + +#define setSLCR(slcr) \ + WIZCHIP_WRITE(_SLCR_,(slcr)) + +#define getSLCR() \ + WIZCHIP_READ(_SLCR_) + +#define getPHYSR() \ + WIZCHIP_READ(_PHYSR_) + +#define setPHYRAR(phyrar) \ + WIZCHIP_WRITE(_PHYRAR_,(phyrar)) + +#define getPHYRAR() \ + WIZCHIP_READ(_PHYRAR_) + +#define setPHYDIR(phydir) \ + do{ \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(_PHYDIR_,1), (uint8_t)((phydir)>>8)); \ + WIZCHIP_WRITE(_PHYDIR_, (uint8_t)(phydir)); \ + }while(0); + +#define getPHYDOR() \ + ((((uint16_t)WIZCHIP_READ(WIZCHIP_OFFSET_INC(_PHYDOR_,1))) << 8) + WIZCHIP_READ(_PHYDOR_)) + +#define setPHYACR(phyacr) \ + WIZCHIP_WRITE(_PHYACR_,(phyacr)) + +#define getPHYACR() \ + WIZCHIP_READ(_PHYACR_) + +#define setPHYDIVR(phydivr) \ + WIZCHIP_WRITE(_PHYDIVR_,(phydivr)) + +#define getPHYDIVR() \ + WIZCHIP_READ(_PHYDIVR_) + +#define setPHYCR0(phycr0) \ + WIZCHIP_WRITE(_PHYCR0_,(phycr0)) + +#define setPHYCR1(phycr1) \ + WIZCHIP_WRITE(_PHYCR1_,(phycr1)) + +#define getPHYCR1() \ + WIZCHIP_READ(_PHYCR1_) + +#define setNET4MR(net4mr) \ + WIZCHIP_WRITE(_NET4MR_,(net4mr)) + +#define setNET6MR(net6mr) \ + WIZCHIP_WRITE(_NET6MR_,(net6mr)) + +#define setNETMR(netmr) \ + WIZCHIP_WRITE(_NETMR_,(netmr)) + +#define setNETMR2(netmr2) \ + WIZCHIP_WRITE(_NETMR2_,(netmr2)) + +#define getNET4MR() \ + WIZCHIP_READ(_NET4MR_) + +#define getNET6MR() \ + WIZCHIP_READ(_NET6MR_) + +#define getNETMR() \ + WIZCHIP_READ(_NETMR_) + +#define getNETMR2() \ + WIZCHIP_READ(_NETMR2_) + +#define setPTMR(ptmr) \ + WIZCHIP_WRITE(_PTMR_, (ptmr)) + +#define getPTMR() \ + WIZCHIP_READ(_PTMR_) + +#define setPMNR(pmnr) \ + WIZCHIP_WRITE(_PMNR_, (pmnr)) + +#define getPMNR() \ + WIZCHIP_READ(_PMNR_) + +#define setPHAR(phar) \ + WIZCHIP_WRITE_BUF(_PHAR_,(phar),6) + +#define getPHAR(phar) \ + WIZCHIP_READ_BUF(_PHAR_,(phar),6) + +#define setPSIDR(psidr) \ + do{ \ + WIZCHIP_WRITE(_PSIDR_,(uint8_t)((psidr) >> 8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(_PSIDR_,1),(uint8_t)(psidr)); \ + }while(0); + +#define getPSIDR() \ + ((((uint16_t)WIZCHIP_READ(_PSIDR_)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(_PSIDR_,1))) + +#define setPMRUR(pmrur) \ + do{ \ + WIZCHIP_WRITE(_PMRUR_,(uint8_t)((pmrur) >> 8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(_PMRUR_,1),(uint8_t)(pmrur)); \ + }while(0); + +#define getPMRUR() \ + ((((uint16_t)WIZCHIP_READ(_PMRUR_)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(_PMRUR_,1))) + +#define setSHAR(shar) \ + WIZCHIP_WRITE_BUF(_SHAR_,(shar),6) + +#define getSHAR(shar) \ + WIZCHIP_READ_BUF(_SHAR_,(shar),6) + +#define setGAR(gar) \ + WIZCHIP_WRITE_BUF(_GAR_,(gar),4) + +#define getGAR(gar) \ + WIZCHIP_READ_BUF(_GAR_,(gar),4) + +#define setGA4R(ga4r) setGAR(ga4r) +#define getGA4R(ga4r) getGAR(ga4r) + +#define setSUBR(subr) \ + WIZCHIP_WRITE_BUF(_SUBR_,(subr),4) + +#define getSUBR(subr) \ + WIZCHIP_READ_BUF(_SUBR_,(subr),4) + +#define setSUB4R(sub4r) setSUBR(sub4r) +#define getSUB4R(sub4r) getSUBR(sub4r) + +#define setSIPR(sipr) \ + WIZCHIP_WRITE_BUF(_SIPR_,(sipr),4) + +#define getSIPR(sipr) \ + WIZCHIP_READ_BUF(_SIPR_,(sipr),4) + +#define setLLAR(llar) \ + WIZCHIP_WRITE_BUF(_LLAR_,(llar),16) + +#define getLLAR(llar) \ + WIZCHIP_READ_BUF(_LLAR_,(llar),16) + +#define setGUAR(guar) \ + WIZCHIP_WRITE_BUF(_GUAR_,(guar),16) + +#define getGUAR(guar) \ + WIZCHIP_READ_BUF(_GUAR_,(guar),16) + +#define setSUB6R(sub6r) \ + WIZCHIP_WRITE_BUF(_SUB6R_,(sub6r),16) + +#define getSUB6R(sub6r) \ + WIZCHIP_READ_BUF(_SUB6R_,(sub6r),16) + +#define setGA6R(ga6r) \ + WIZCHIP_WRITE_BUF(_GA6R_,(ga6r),16) + +#define getGA6R(ga6r) \ + WIZCHIP_READ_BUF(_GA6R_,(ga6r),16) + +#define setSLDIPR(sldipr) \ + WIZCHIP_WRITE_BUF(_SLDIPR_,(sldipr),4) +#define setSLDIP4R(sldip4r) setSLDIPR((sldip4r)) + +#define getSLDIPR(sldipr) \ + WIZCHIP_READ_BUF(_SLDIPR_,(sldipr),4) +#define getSLDIP4R(sldip4r) getSLDIPR((sldip4r)) + +#define setSLDIP6R(sldip6r) \ + WIZCHIP_WRITE_BUF(_SLDIP6R_, (sldip6r),16) + +#define getSLDIP6R(sldip6r) \ + WIZCHIP_READ_BUF(_SLDIP6R_,(sldip6r),16) + +#define getSLDHAR(sldhar) \ + WIZCHIP_READ_BUF(_SLDHAR_,(sldhar),6) + +#define setPINGIDR(pingidr) \ + do{ \ + WIZCHIP_WRITE(_PINGIDR_,(uint8_t)((pingidr)>>8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(_PINGIDR_,1),(uint8_t)(pingidr)); \ + }while(0); + +#define getPINGIDR() \ + (((int16_t)(WIZCHIP_READ(_PINGIDR_) << 8)) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(_PINGIDR_,1))) + +#define setPINGSEQR(pingseqr) \ + do{ \ + WIZCHIP_WRITE(_PINGSEQR_,(uint8_t)((pingseqr)>>8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(_PINGSEQR_,1),(uint8_t)(pingseqr)); \ + }while(0); + +#define getPINGSEQR() \ + (((int16_t)(WIZCHIP_READ(_PINGSEQR_) << 8)) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(_PINGSEQR_,1))) + +#define getUIPR(uipr) \ + WIZCHIP_READ_BUF(_UIPR_, (uipr), 4) + +#define getUIP4R(uip4r) getUIPR(uip4r) + +#define getUPORTR() \ + ((((uint16_t)WIZCHIP_READ(_UPORTR_)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(_UPORTR_,1))) + +#define getUPORT4R() getUPORTR() + +#define getUIP6R(uip6r) \ + WIZCHIP_READ_BUF(_UIP6R_,(uip6r),16) + +#define getUPORT6R(uport6r) \ + ((((uint16_t)WIZCHIP_READ(_UPORT6R_)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(_UPORT6R_,1))) + +#define setINTPTMR(intptmr) \ + do{ \ + WIZCHIP_WRITE(_INTPTMR_,(uint8_t)((intptmr) >> 8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(_INTPTMR_,1),(uint8_t)(intptmr)); \ + }while(0); + +#define getINTPTMR() \ + ((((uint16_t)WIZCHIP_READ(_INTPTMR_)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(_INTPTMR_,1))) + +#define getPLR() \ + WIZCHIP_READ(_PLR_) + +#define getPFR() \ + WIZCHIP_READ(_PFR_) + +#define getVLTR() \ + ( (((uint32_t)WIZCHIP_READ(_VLTR_)) << 24) + \ + (((uint32_t)WIZCHIP_READ(WIZCHIP_OFFSET_INC(_VLTR_,1))) << 16) + \ + (((uint32_t)WIZCHIP_READ(WIZCHIP_OFFSET_INC(_VLTR_,2))) << 16) + \ + (((uint32_t)WIZCHIP_READ(WIZCHIP_OFFSET_INC(_VLTR_,3))) << 16) ) + +#define getPLTR() \ + ( (((uint32_t)WIZCHIP_READ(_PLTR_)) << 24) + \ + (((uint32_t)WIZCHIP_READ(WIZCHIP_OFFSET_INC(_PLTR_,1))) << 16) + \ + (((uint32_t)WIZCHIP_READ(WIZCHIP_OFFSET_INC(_PLTR_,2))) << 16) + \ + (((uint32_t)WIZCHIP_READ(WIZCHIP_OFFSET_INC(_PLTR_,3))) << 16) ) + +#define getPAR(par) \ + WIZCHIP_READ_BUF(_PAR_, (par), 16) + +#define setICMP6BLKR(icmp6blkr) \ + WIZCHIP_WRITE(_ICMP6BLKR_,(icmp6blkr)) + +#define getICMP6BLKR() \ + WIZCHIP_READ(_ICMP6BLKR_) + +#define setCHPLCKR(chplckr) \ + WIZCHIP_WRITE(_CHPLCKR_, (chplckr)) + +#define getCHPLCKR() \ + ((getSYSR() & SYSR_CHPL) >> 7) + +#define CHIPLOCK() setCHPLCKR(0xFF) +#define CHIPUNLOCK() setCHPLCKR(0xCE) + +#define setNETLCKR(netlckr) \ + WIZCHIP_WRITE(_NETLCKR_, (netlckr)) + +#define getNETLCKR() \ + ((getSYSR() & SYSR_NETL) >> 6) + +#define NETLOCK() setNETLCKR(0xC5) +#define NETUNLOCK() setNETLCKR(0x3A) + +#define setPHYLCKR(phylckr) \ + WIZCHIP_WRITE(_PHYLCKR_,(phylckr)) + +#define getPHYLCKR() \ + ((getSYSR() & SYSR_PHYL) >> 5) + +#define PHYLOCK() setPHYLCKR(0xFF) +#define PHYUNLOCK() setPHYLCKR(0x53) + +#define setRTR(rtr) \ + do{ \ + WIZCHIP_WRITE(_RTR_,(uint8_t)((rtr)>>8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(_RTR_,1),(uint8_t)(rtr)); \ + }while(0); + +#define getRTR() \ + ((((uint16_t)WIZCHIP_READ(_RTR_)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(_RTR_,1))) + +#define setRCR(rcr) \ + WIZCHIP_WRITE(_RCR_,(rcr)) + +#define getRCR() \ + WIZCHIP_READ(_RCR_) + +#define setSLRTR(slrtr) \ + do{ \ + WIZCHIP_WRITE(_SLRTR_,(uint8_t)((slrtr)>>8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(_SLRTR_,1),(uint8_t)(slrtr)); \ + }while(0); + +#define getSLRTR() \ + ((((uint16_t)WIZCHIP_READ(_SLRTR_)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(_SLRTR_,1))) + +#define setSLRCR(slrcr) \ + WIZCHIP_WRITE(_SLRCR_,(slrcr)) + +#define getSLRCR() \ + WIZCHIP_READ(_SLRCR_) + +#define setSLHOPR(slhopr) \ + WIZCHIP_WRITE(_SLHOPR_,(slhopr)) + +#define getSLHOPR() \ + WIZCHIP_READ(_SLHOPR_) +/** + @} +*/ + + +//////////////////////////////////// +// SOCKETn register I/O function // +//////////////////////////////////// +/** + @addtogroup Socket_register_access_function_W6100 + @{ +*/ +#define setSn_MR(sn,mr) \ + WIZCHIP_WRITE(_Sn_MR_(sn),(mr)) +#define getSn_MR(sn) \ + WIZCHIP_READ(_Sn_MR_(sn)) + +#define setSn_PSR(sn,psr) \ + WIZCHIP_WRITE(_Sn_PSR_(sn),(psr)) +#define getSn_PSR(sn) \ + WIZCHIP_READ(_Sn_PSR_(sn)) + +#define setSn_CR(sn,cr) \ + WIZCHIP_WRITE(_Sn_CR_(sn),(cr)) +#define getSn_CR(sn) \ + WIZCHIP_READ(_Sn_CR_(sn)) + +#define getSn_IR(sn) \ + WIZCHIP_READ(_Sn_IR_(sn)) + +#define setSn_IMR(sn,imr) \ + WIZCHIP_WRITE(_Sn_IMR_(sn),(imr)) +#define getSn_IMR(sn) \ + WIZCHIP_READ(_Sn_IMR_(sn)) + +#define setSn_IRCLR(sn,irclr) \ + WIZCHIP_WRITE(_Sn_IRCLR_(sn),(irclr)) +#define setSn_IR(sn,ir) setSn_IRCLR(sn,(ir)) + +#define getSn_SR(sn) \ + WIZCHIP_READ(_Sn_SR_(sn)) + +#define getSn_ESR(sn) \ + WIZCHIP_READ(_Sn_ESR_(sn)) + +#define setSn_PNR(sn,pnr) \ + WIZCHIP_WRITE(_Sn_PNR_(sn),(pnr)) +#define setSn_NHR(sn,nhr) setSn_PNR(_Sn_PNR_(sn),(nhr)) + +#define getSn_PNR(sn) \ + WIZCHIP_READ(_Sn_PNR_(sn)) +#define getSn_NHR(sn) getSn_PNR(sn) + +#define setSn_TOSR(sn,tosr) \ + WIZCHIP_WRITE(_Sn_TOSR_(sn),(tosr)) +#define getSn_TOSR(sn) \ + WIZCHIP_READ(_Sn_TOSR_(sn)) +#define getSn_TOS(sn) getSn_TOSR(sn) ///< For compatible ioLibrar +#define setSn_TOS(sn,tos) setSn_TOSR(sn,tos) ///< For compatible ioLibrar + + +#define setSn_TTLR(sn,ttlr) \ + WIZCHIP_WRITE(_Sn_TTLR_(sn),(ttlr)) +#define setSn_TTL(sn,ttl) setSn_TTLR(sn,ttl) ///< For compatible ioLibrary + +#define getSn_TTLR(sn) \ + WIZCHIP_READ(_Sn_TTLR_(sn)) +#define getSn_TTL(sn) getSn_TTLR(sn) ///< For compatible ioLibrary + + +#define setSn_HOPR(sn,hopr) setSn_TTLR(sn),(ttlr)) +#define getSn_HOPR(sn) getSn_TTLR(sn) + +#define setSn_FRGR(sn,frgr) \ + do{ \ + WIZCHIP_WRITE(_Sn_FRGR_(sn),(uint8_t)((frgr)>>8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(_Sn_FRGR_(sn),1),(uint8_t)(frgr)); \ + }while(0); +#define getSn_FRGR(sn,frgr) \ + ((((uint16_t)WIZCHIP_READ(_Sn_FRGR_(sn))) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(_Sn_FRGR_(sn),1))) + +#define setSn_MSSR(sn,mssr) \ + do{ \ + WIZCHIP_WRITE(_Sn_MSSR_(sn),(uint8_t)((mssr)>>8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(_Sn_MSSR_(sn),1),(uint8_t)(mssr)); \ + }while(0); +#define getSn_MSSR(sn) \ + ((((uint16_t)WIZCHIP_READ(_Sn_MSSR_(sn))) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(_Sn_MSSR_(sn),1))) + +#define setSn_PORTR(sn,portr) \ + do{ \ + WIZCHIP_WRITE(_Sn_PORTR_(sn),(uint8_t)((portr)>>8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(_Sn_PORTR_(sn),1),(uint8_t)(portr)); \ + }while(0); +#define getSn_PORTR(sn) \ + ((((uint16_t)WIZCHIP_READ(_Sn_PORTR_(sn))) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(_Sn_PORTR_(sn),1))) + +#define setSn_DHAR(sn,dhar) \ + WIZCHIP_WRITE_BUF(_Sn_DHAR_(sn),(dhar),6) +#define getSn_DHAR(sn,dhar) \ + WIZCHIP_READ_BUF(_Sn_DHAR_(sn),(dhar),6) + +#define setSn_DIPR(sn,dipr) \ + WIZCHIP_WRITE_BUF(_Sn_DIPR_(sn),(dipr),4) +#define getSn_DIPR(sn,dipr) \ + WIZCHIP_READ_BUF(_Sn_DIPR_(sn),(dipr),4) + +#define setSn_DIP4R(sn,dipr) setSn_DIPR(sn,(dipr)) +#define getSn_DIP4R(sn,dipr) getSn_DIPR(sn,(dipr)) + +#define setSn_DIP6R(sn,dip6r) \ + WIZCHIP_WRITE_BUF(_Sn_DIP6R_(sn),(dip6r),16) +#define getSn_DIP6R(sn,dip6r) \ + WIZCHIP_READ_BUF(_Sn_DIP6R_(sn),(dip6r),16) + +#define setSn_DPORTR(sn,dportr) \ + do{ \ + WIZCHIP_WRITE(_Sn_DPORTR_(sn),(uint8_t)((dportr)>>8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(_Sn_DPORTR_(sn),1),(uint8_t)(dportr)); \ + }while(0); +#define getSn_DPORTR(sn) \ + ((((uint16_t)WIZCHIP_READ(_Sn_DPORTR_(sn))) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(_Sn_DPORTR_(sn),1))) +#define getSn_DPORT(sn) getSn_DPORTR(sn) +#define setSn_DPORT(sn,dportr) setSn_DPORTR(sn,dportr) + +#define setSn_MR2(sn,mr2) \ + WIZCHIP_WRITE(_Sn_MR2_(sn),(mr2)) +#define getSn_MR2(sn) \ + WIZCHIP_READ(_Sn_MR2_(sn)) + +#define setSn_RTR(sn,rtr) \ + do{ \ + WIZCHIP_WRITE(_Sn_RTR_(sn),(uint8_t)((rtr)>>8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(_Sn_RTR_(sn),1),(uint8_t)(rtr)); \ + }while(0); +#define getSn_RTR(sn) \ + ((((uint16_t)WIZCHIP_READ(_Sn_RTR_(sn))) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(_Sn_RTR_(sn),1))) + +#define setSn_RCR(sn,rcr) \ + WIZCHIP_WRITE(_Sn_RCR_(sn),(rcr)) +#define getSn_RCR(sn) \ + WIZCHIP_READ(_Sn_RCR_(sn)) + +#define setSn_KPALVTR(sn,kpalvtr) \ + WIZCHIP_WRITE(_Sn_KPALVTR_(sn),(kpalvtr)) +#define getSn_KPALVTR(sn) \ + WIZCHIP_READ(_Sn_KPALVTR_(sn)) + +#define setSn_TX_BSR(sn, tmsr) \ + WIZCHIP_WRITE(_Sn_TX_BSR_(sn),(tmsr)) +#define setSn_TXBUF_SIZE(sn, tmsr) setSn_TX_BSR(sn,(tmsr)) + +#define getSn_TX_BSR(sn) \ + WIZCHIP_READ(_Sn_TX_BSR_(sn)) +#define getSn_TXBUF_SIZE(sn) getSn_TX_BSR(sn) + +#define getSn_TxMAX(sn) \ + (getSn_TX_BSR(sn) << 10) + +uint16_t getSn_TX_FSR(uint8_t sn); + +#define getSn_TX_RD(sn) \ + ((((uint16_t)WIZCHIP_READ(_Sn_TX_RD_(sn))) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(_Sn_TX_RD_(sn),1))) + +#define setSn_TX_WR(sn,txwr) \ + do{ \ + WIZCHIP_WRITE(_Sn_TX_WR_(sn), (uint8_t)((txwr)>>8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(_Sn_TX_WR_(sn),1), (uint8_t)(txwr)); \ + }while(0); +#define getSn_TX_WR(sn) \ + (((uint16_t)WIZCHIP_READ(_Sn_TX_WR_(sn)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(_Sn_TX_WR_(sn),1))) + +#define setSn_RX_BSR(sn,rmsr) \ + WIZCHIP_WRITE(_Sn_RX_BSR_(sn),(rmsr)) +#define setSn_RXBUF_SIZE(sn,rmsr) setSn_RX_BSR(sn,(rmsr)) + +#define getSn_RX_BSR(sn) \ + WIZCHIP_READ(_Sn_RX_BSR_(sn)) +#define getSn_RXBUF_SIZE(sn) getSn_RX_BSR(sn) + +#define getSn_RxMAX(sn) \ + (getSn_RX_BSR(sn) <<10) + +uint16_t getSn_RX_RSR(uint8_t s); + +#define setSn_RX_RD(sn,rxrd) \ + do{ \ + WIZCHIP_WRITE(_Sn_RX_RD_(sn), (uint8_t)((rxrd)>>8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(_Sn_RX_RD_(sn),1), (uint8_t)(rxrd)) ; \ + }while(0); + +#define getSn_RX_RD(sn) \ + (((uint16_t)WIZCHIP_READ(_Sn_RX_RD_(sn)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(_Sn_RX_RD_(sn),1))) + +#define getSn_RX_WR(sn) \ + (((uint16_t)WIZCHIP_READ(_Sn_RX_WR_(sn)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(_Sn_RX_WR_(sn),1))) +/** + @} +*/ + + +///////////////////////////////////// +// Sn_TXBUF & Sn_RXBUF IO function // +///////////////////////////////////// +/** + @ingroup Basic_IO_function_W6100 + @brief It saves data to be sent in the SOCKETn TX buffer. + @details This function reads first @ref _Sn_TX_WR_ \n + and starts to copy wizdata from @ref _Sn_TX_WR_ address of SOCKETn TX buffer as many as len.\n + After it is completed to copy , \n + It increases @ref _Sn_TX_WR_ as many as len. + @param sn SOCKETn. It should be 0 ~ @ref _WIZCHIP_SOCK_NUM_. + @param wizdata Pointer buffer to write data + @param len Data length + @sa wiz_recv_data() +*/ +void wiz_send_data(uint8_t sn, uint8_t *wizdata, uint16_t len); + +/** + @ingroup Basic_IO_function_W6100 + @brief It reads the received data from the SOCKETn RX buffer and copies the data to your system memory specified by wizdata. + @details This function reads first @ref _Sn_RX_RD_ \n + and starts to copy the received data to wizdata as many as len.\n + After it is completed to copy the received data, \n + It increases @ref _Sn_RX_RD_ as many as len. + @param sn SOCKETn. It should be 0 ~ @ref _WIZCHIP_SOCK_NUM_. + @param wizdata Pointer buffer to read data + @param len Data length + @sa wiz_send_data() +*/ +void wiz_recv_data(uint8_t sn, uint8_t *wizdata, uint16_t len); + +/** + @ingroup Basic_IO_function_W6100 + @brief It discards the received data in the SOCKETn RX buffer. + @details This function discards the received data by increasing @ref _Sn_RX_RD_ as manay as len without coping the data. + @param sn SOCKETn. It should be 0 ~ @ref _WIZCHIP_SOCK_NUM_. + @param len Data length +*/ +void wiz_recv_ignore(uint8_t sn, uint16_t len); + +#if 1 +// 20231019 taylor +/** + @ingroup Special_function_W6100 + @brief Delay function + @details Delay function using internal 100us timer of the W6100 + @param (uint32_t)ms Time to delay in milliseconds. +*/ +void wiz_delay_ms(uint32_t ms); +#endif + +/// @cond DOXY_APPLY_CODE +#if (_PHY_IO_MODE_ == _PHY_IO_MODE_MII_) +/// @endcond +/** + @ingroup Special_function_W6100 + @brief Write data to the PHY via MDC/MDIO interface. + @details Write command data to the PHY via MDC/MDIO interface. + @param phyregaddr Address of the PHY register. It should be @ref PHYRAR_BMCR, @ref PHYRAR_BMSR, and etc. + @param var Data to write to the PHY register. Please refer to the bit definitions of the BMCR and BMSR register. + @note In order to use it, You should define @ref _PHY_IO_MODE_ to @ref _PHY_IO_MODE_MII_. +*/ +void wiz_mdio_write(uint8_t phyregaddr, uint16_t var); + +/** + @ingroup Special_function_W6100 + @brief Read data from the PHY via MDC/MDIO interface. + @details Read command or status data from the PHY via MDC/MDIO interface. + @param phyregaddr Address of the PHY register. It should be @ref PHYRAR_BMCR, @ref PHYRAR_BMSR, and etc. + @return The value of the PHY register + @note In order to use it, You should define @ref _PHY_IO_MODE_ to @ref _PHY_IO_MODE_MII_. +*/ +uint16_t wiz_mdio_read(uint8_t phyregaddr); +/// @cond DOXY_APPLY_CODE +#endif +/// @endcond + +/// @cond DOXY_APPLY_CODE +#endif // _WIZCHIP_ == 6100 +/// @endcond + + +#ifdef __cplusplus +} +#endif + + +#endif //_W6100_H_ diff --git a/Ethernet/W6300/w6300.c b/Ethernet/W6300/w6300.c new file mode 100644 index 0000000..1c8192a --- /dev/null +++ b/Ethernet/W6300/w6300.c @@ -0,0 +1,273 @@ +//***************************************************************************** +// +//! \file W6300.c +//! \brief W6300 HAL Implements file. +//! \version 1.0.0 +//! \date 2019/01/01 +//! \par Revision history +//! <2019/01/01> 1st Release +//! \author MidnightCow +//! \copyright +//! +//! Copyright (c) 2019, WIZnet Co., LTD. +//! +//! 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 "w6300.h" + + +#if 0 +#define _WIZCHIP_SPI_VDM_OP_ 0x00 +#define _WIZCHIP_SPI_FDM_LEN1_ 0x01 +#define _WIZCHIP_SPI_FDM_LEN2_ 0x02 +#define _WIZCHIP_SPI_FDM_LEN4_ 0x03 +#endif +// +// If you want to use SPI FDM mode, Feel free contact to WIZnet. +// http://forum.wiznet.io +// + +#if _WIZCHIP_ == 6300 +//////////////////////////////////////////////////////////////////////////////////////// + + +#define _W6300_SPI_OP_ _WIZCHIP_SPI_VDM_OP_ +#define _W6300_SPI_READ_ (0x00 << 5) ///< SPI interface Read operation in Control Phase +#define _W6300_SPI_WRITE_ (0x01 << 5) ///< SPI interface Write operation in Control Phase + +////////////////////////////////////////////////// +void WIZCHIP_WRITE(uint32_t AddrSel, uint8_t wb) { + + uint8_t opcode = 0; + uint16_t ADDR = 0; + + WIZCHIP_CRITICAL_ENTER(); + WIZCHIP.CS._select(); + +#if (_WIZCHIP_IO_MODE_ & 0xff00) & _WIZCHIP_IO_MODE_BUS_ + uint8_t tAD[4]; + tAD[0] = (uint8_t)((AddrSel & 0x00FF0000) >> 16); + tAD[1] = (uint8_t)((AddrSel & 0x0000FF00) >> 8); + tAD[2] = (uint8_t)(AddrSel & 0x000000ff); + tAD[3] = wb; + WIZCHIP.IF.BUS._write_data_buf(IDM_AR0, tAD, 4, 1); +#else //w6300 QSPI MODE + opcode = (uint8_t)((AddrSel & 0x000000FF) | (_W6300_SPI_WRITE_) | (_WIZCHIP_QSPI_MODE_)); + ADDR = (uint16_t)((AddrSel & 0x00ffff00) >> 8); + WIZCHIP.IF.QSPI._write_qspi(opcode, ADDR, &wb, 1); +#endif + + WIZCHIP.CS._deselect(); + WIZCHIP_CRITICAL_EXIT(); +} + +uint8_t WIZCHIP_READ(uint32_t AddrSel) { + //uint8_t ret; + uint8_t ret[2] = {0,}; + uint8_t opcode = 0; + uint16_t ADDR = 0; + + WIZCHIP_CRITICAL_ENTER(); + WIZCHIP.CS._select(); + +#if (_WIZCHIP_IO_MODE_ & 0xff00) & _WIZCHIP_IO_MODE_BUS_ + uint8_t tAD[3]; + tAD[0] = (uint8_t)((AddrSel & 0x00FF0000) >> 16); + tAD[1] = (uint8_t)((AddrSel & 0x0000FF00) >> 8); + tAD[2] = (uint8_t)(AddrSel & 0x000000ff); + WIZCHIP.IF.BUS._write_data_buf(IDM_AR0, tAD, 3, 1); + ret[0] = WIZCHIP.IF.BUS._read_data(IDM_DR); +#else + opcode = (uint8_t)((AddrSel & 0x000000FF) | (_W6300_SPI_READ_) | (_WIZCHIP_QSPI_MODE_)); + ADDR = (uint16_t)((AddrSel & 0x00ffff00) >> 8); + WIZCHIP.IF.QSPI._read_qspi(opcode, ADDR, ret, 1); +#endif + WIZCHIP.CS._deselect(); + WIZCHIP_CRITICAL_EXIT(); + return ret[0]; +} + + +void WIZCHIP_WRITE_BUF(uint32_t AddrSel, uint8_t* pBuf, datasize_t len) { + + uint8_t opcode = 0; + uint16_t ADDR = 0; + + WIZCHIP_CRITICAL_ENTER(); + WIZCHIP.CS._select(); + +#if (_WIZCHIP_IO_MODE_ & 0xff00) & _WIZCHIP_IO_MODE_BUS_ + uint8_t tAD[3]; + tAD[0] = (uint8_t)((AddrSel & 0x00FF0000) >> 16); + tAD[1] = (uint8_t)((AddrSel & 0x0000FF00) >> 8); + tAD[2] = (uint8_t)(AddrSel & 0x000000ff); + WIZCHIP.IF.BUS._write_data_buf(IDM_AR0, tAD, 3, 1); + WIZCHIP.IF.BUS._write_data_buf(IDM_DR, pBuf, len, 0); +#else + opcode = (uint8_t)((AddrSel & 0x000000FF) | (_W6300_SPI_WRITE_) | (_WIZCHIP_QSPI_MODE_)); + ADDR = (uint16_t)((AddrSel & 0x00ffff00) >> 8); + WIZCHIP.IF.QSPI._write_qspi(opcode, ADDR, pBuf, len);//by_lihan + //qspi_write_buf(opcode, ADDR, pBuf, len); + WIZCHIP.CS._deselect(); + WIZCHIP_CRITICAL_EXIT(); +#endif +} + +void WIZCHIP_READ_BUF(uint32_t AddrSel, uint8_t* pBuf, datasize_t len) { + + uint8_t ret; + uint8_t opcode = 0; + uint16_t ADDR = 0; + + WIZCHIP_CRITICAL_ENTER(); + WIZCHIP.CS._select(); + +#if _WIZCHIP_IO_MODE_ & _WIZCHIP_IO_MODE_BUS_ + uint8_t tAD[3]; + tAD[0] = (uint8_t)((AddrSel & 0x00FF0000) >> 16); + tAD[1] = (uint8_t)((AddrSel & 0x0000FF00) >> 8); + tAD[2] = (uint8_t)(AddrSel & 0x000000ff); + WIZCHIP.IF.BUS._write_data_buf(IDM_AR0, tAD, 3, 1); + WIZCHIP.IF.BUS._read_data_buf(IDM_DR, pBuf, len, 0); +#else + opcode = (uint8_t)((AddrSel & 0x000000FF) | (_W6300_SPI_READ_) | (_WIZCHIP_QSPI_MODE_)); + ADDR = (uint16_t)((AddrSel & 0x00ffff00) >> 8); + WIZCHIP.IF.QSPI._read_qspi(opcode, ADDR, pBuf, len);//by_lihan + //qspi_read_buf(opcode, ADDR, pBuf, len); + WIZCHIP.CS._deselect(); + WIZCHIP_CRITICAL_EXIT(); +#endif +} + +uint16_t getSn_TX_FSR(uint8_t sn) { + uint16_t prev_val = -1, val = 0; + do { + prev_val = val; + val = WIZCHIP_READ(_Sn_TX_FSR_(sn)); + val = (val << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(_Sn_TX_FSR_(sn), 1)); + } while (val != prev_val); + return val; +} + +uint16_t getSn_RX_RSR(uint8_t sn) { + uint16_t prev_val = -1, val = 0; + do { + prev_val = val; + val = WIZCHIP_READ(_Sn_RX_RSR_(sn)); + val = (val << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(_Sn_RX_RSR_(sn), 1)); + } while (val != prev_val); + return val; +} + +void wiz_send_data(uint8_t sn, uint8_t *wizdata, uint16_t len) { + uint16_t ptr = 0; + uint32_t addrsel = 0; + ptr = getSn_TX_WR(sn); + addrsel = ((uint32_t)ptr << 8) + WIZCHIP_TXBUF_BLOCK(sn); + WIZCHIP_WRITE_BUF(addrsel, wizdata, len); + ptr += len; + setSn_TX_WR(sn, ptr); +} + +#if 0 +#define ETHERNET_BUF_MAX_SIZE_TEMP (1024 * 32 ) +void wiz_recv_data(uint8_t sn, uint8_t *wizdata, uint16_t len) { + uint16_t ptr = 0; + uint32_t addrsel = 0; + if (len == 0) { + return; + } + ptr = getSn_RX_RD(sn); + + if (ptr + len > 0xFFFF) { + addrsel = ((uint32_t)ptr << 8) + WIZCHIP_RXBUF_BLOCK(sn); + uint16_t size = 0xFFFF - ptr; + WIZCHIP_READ_BUF(addrsel, wizdata, size); + wizdata += size; + size = len - size; + addrsel = WIZCHIP_RXBUF_BLOCK(sn); + WIZCHIP_READ_BUF(addrsel, wizdata, size); + } else { + addrsel = ((uint32_t)ptr << 8) + WIZCHIP_RXBUF_BLOCK(sn); + WIZCHIP_READ_BUF(addrsel, wizdata, len); + } + + ptr += len; + ptr %= 0xFFFF ; + + setSn_RX_RD(sn, ptr); +} + + +#else +void wiz_recv_data(uint8_t sn, uint8_t *wizdata, uint16_t len) { + uint16_t ptr = 0; + uint32_t addrsel = 0; + if (len == 0) { + return; + } + ptr = getSn_RX_RD(sn); + addrsel = ((uint32_t)ptr << 8) + WIZCHIP_RXBUF_BLOCK(sn); + WIZCHIP_READ_BUF(addrsel, wizdata, len); + ptr += len; + setSn_RX_RD(sn, ptr); +} +#endif +void wiz_recv_ignore(uint8_t sn, uint16_t len) { + setSn_RX_RD(sn, getSn_RX_RD(sn) + len); +} + +#if 1 +// 20231019 taylor +void wiz_delay_ms(uint32_t milliseconds) { + uint32_t i; + for (i = 0 ; i < milliseconds ; i++) { + //Write any values to clear the TCNTCLKR register + setTCNTRCLR(0xff); + + // Wait until counter register value reaches 10.(10 = 1ms : TCNTR is 100us tick counter register) + while (getTCNTR() < 0x0a) {} + } +} +#endif + +/// @cond DOXY_APPLY_CODE +#if (_PHY_IO_MODE_ == _PHY_IO_MODE_MII_) +/// @endcond +void wiz_mdio_write(uint8_t phyregaddr, uint16_t var) { + setPHYRAR(phyregaddr); + setPHYDIR(var); + setPHYACR(PHYACR_WRITE); + while (getPHYACR()); //wait for command complete +} + +uint16_t wiz_mdio_read(uint8_t phyregaddr) { + setPHYRAR(phyregaddr); + setPHYACR(PHYACR_READ); + while (getPHYACR()); //wait for command complete + return getPHYDOR(); +} +/// @cond DOXY_APPLY_CODE +#endif +/// @endcond + +//////////////////////////////////////////////////////////////////////////////////////// +#endif diff --git a/Ethernet/W6300/w6300.h b/Ethernet/W6300/w6300.h new file mode 100644 index 0000000..240c7aa --- /dev/null +++ b/Ethernet/W6300/w6300.h @@ -0,0 +1,4103 @@ +//* **************************************************************************** +//! \file W6300.h +//! \brief W6300 HAL Header File. +//! \version 1.0.0 +//! \date 2019/01/01 +//! \par Revision history +//! <2019/01/01> 1st Release +//! \author MidnightCow +//! \copyright +//! +//! Copyright (c) 2019, WIZnet Co., LTD. +//! +//! 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 _W6300_H_ +#define _W6300_H_ + +#include +#include "wizchip_conf.h" + + +#ifdef __cplusplus +extern "C" { +#endif + +/// @cond DOXY_APPLY_CODE +#if (_WIZCHIP_ == W6300) +/// @endcond + +#define _W6300_SPI_READ_ (0x00 << 5) ///< SPI interface Read operation in Control Phase +#define _W6300_SPI_WRITE_ (0x01 << 5) ///< SPI interface Write operation in Control Phase + +#define WIZCHIP_CREG_BLOCK (0x00 ) ///< Common register block +#define WIZCHIP_SREG_BLOCK(N) ((1+4*N)) ///< SOCKETn register block +#define WIZCHIP_TXBUF_BLOCK(N) ((2+4*N)) ///< SOCKETn Tx buffer address block +#define WIZCHIP_RXBUF_BLOCK(N) ((3+4*N)) ///< SOCKETn Rx buffer address block + +#define WIZCHIP_OFFSET_INC(ADDR, N) (ADDR + (N<<8)) ///< Increase offset address + +#if (_WIZCHIP_IO_MODE_ & _WIZCHIP_IO_MODE_BUS_) +#define IDM_AR0 ((_WIZCHIP_IO_BASE_ + 0x0000)) ///< Indirect High Address Register +#define IDM_AR1 ((_WIZCHIP_IO_BASE_ + 0x0001)) ///< Indirect Low Address Register +#define IDM_BSR ((_WIZCHIP_IO_BASE_ + 0x0002)) ///< Block Select Register +#define IDM_DR ((_WIZCHIP_IO_BASE_ + 0x0003)) ///< Indirect Data Register +#define _W6300_IO_BASE_ _WIZCHIP_IO_BASE_ +#elif (_WIZCHIP_IO_MODE_ & _WIZCHIP_IO_MODE_SPI_) +#define IDM_AR0 ((_WIZCHIP_IO_BASE_ + 0x0000)) ///< Indirect High Address Register +#define IDM_AR1 ((_WIZCHIP_IO_BASE_ + 0x0001)) ///< Indirect Low Address Register +#define IDM_BSR ((_WIZCHIP_IO_BASE_ + 0x0002)) ///< Block Select Register +#define IDM_DR ((_WIZCHIP_IO_BASE_ + 0x0003)) ///< Indirect Data Register +#define _W6300_IO_BASE_ 0x00000000 +#define _W6100_IO_BASE_ 0x00000000 +#endif + + +//----------- defgroup -------------------------------- + +/** + @defgroup W6300 W6300 + @brief @ref _WIZCHIP_ register defines and I/O functions + @details + - @ref WIZCHIP_register_W6300 : @ref Common_register_group_W6300, @ref Socket_register_group_W6300 + - @ref WIZCHIP_IO_Functions_W6300 : @ref Basic_IO_function_W6300, @ref Common_register_access_function_W6300, @ref Socket_register_access_function_W6300 +*/ + +/** + @defgroup WIZCHIP_register_W6300 WIZCHIP register + @ingroup W6300 + @brief @ref WIZCHIP_register_W6300 defines register group of @b W6300. + @details + - @ref Common_register_group_W6300 : Common register group W6300 + - @ref Socket_register_group_W6300 : SOCKET n register group W6300 +*/ + +/** + @defgroup Basic_IO_function_W6300 Basic I/O function + @ingroup WIZCHIP_IO_Functions_W6300 + @brief These are basic input/output functions to read values from register or write values to register. +*/ + +/** + @defgroup Common_register_access_function_W6300 Common register access functions + @ingroup WIZCHIP_IO_Functions_W6300 + @brief These are functions to access @ref Common_register_group_W6300. +*/ + +/** + @defgroup Socket_register_access_function_W6300 Socket register access functions + @ingroup WIZCHIP_IO_Functions_W6300 + @brief These are functions to access @ref Socket_register_group_W6300. +*/ + +/** + @defgroup WIZCHIP_IO_Functions_W6300 WIZCHIP I/O functions + @ingroup W6300 + @brief @ref WIZCHIP_IO_Functions_W6300 supports the basic I/O functions for @ref WIZCHIP_register_W6300. + @details + - @ref WIZCHIP_IO_Functions_W6300 \n + WIZCHIP_READ(), WIZCHIP_WRITE(), WIZCHIP_READ_BUF(), WIZCHIP_WRITE_BUF() + - @ref Common_register_access_function_W6300 \n + - @ref _WIZCHIP_ Mode \n + getCIDR(), getVER() \n + getSYSR() \n + setCHPLCKR(), setNETLCKR(), setPHYLCKR() \n + setSYCR0(), getSYCR1(), setSYCR1() + - Network Mode \n + getNET4MR(), setNET4MR(), getNET6MR(), setNET6MR(), getNETMR(), setNETMR(), getNETMR2(), setNETMR2() + - Interrupt \n + getIR(), setIRCLR(), getIMR(), setIMR() \n + getSIR(), getSIMR(), setSIMR() \n + getSLIR(), setSLIRCLR(), getSLIMR(), setSLIMR() \n + getINTPTMR(), setINTPTMR() + - Network Information \n + NETLOCK(), NETUNLOCK() \n + getSHAR(), setSHAR(), getGAR(), setGAR(), getSUBR(), setSUBR(), getSIPR(), setSIPR() \n + getLLAR(), setLLAR(), getGUAR(), setGUAR(), getGA6R(), setGA6R(), getSUB6R(), setSUB6R() \n + getPLR(), getPFR(), getVLTR(), getPLTR(), getPAR() \n + - SOCKET-less Commands for PING, ARP and IPv6 Auto-Configuration \n + getSLCR(), setSLCR() \n + getPINGIDR(), setPINGIDR(), getPINGSEQR(), setPINGSEQR() \n + getSLDHAR(), getSLDIPR(), setSLDIPR(), getSLDIP4R(), setSLDIP4R(), getSLDIP6R(), setSLDIP6R(), getSLHOPR(), setSLHOPR() \n + - Retransmission \n + getRCR(), setRCR() \n + getSLRCR(), setSLRCR(), getSLRTR(), setSLRTR() \n + - ICMP \n + getUIPR(), getUIP6R(), getUPORTR(), getUPORT6R() \n + getICMP6BLKR(), setICMP6BLKR() \n + - PPPoE \n + getPTMR(), setPTMR(), getPMNR(), getPMNR() \n + getPHAR(), setPHAR(), getPSIDR(), setPSIDR(), getPMRUR(), setPMRUR() + - PHY Configuration \n + getPHYSR(), setPHYLCKR(), PHYLOCK(), PHYUNLOCK() \n + setPHYCR0(), getPHYCR1(), setPHYCR1() \n + getPHYRAR(), setPHYRAR(), setPHYDIR(), getPHYDOR(), getPHYACR(), setPHYACR(), getPHYDIVR(), setPHYDIVR() + - etc \n + getTCNTR(), setTCNTRCLR() + - @ref Socket_register_access_function_W6300 \n + - SOCKET control \n + getSn_MR(), setSn_MR(), getSn_MR2(), setSn_MR2(), getSn_PSR(), setSn_PSR(), getSn_CR(), setSn_CR() \n + getSn_IR(), setSn_IRCLR(), getSn_IMR(), setSn_IMR() \n + getSn_RTR(), setSn_RTR(), getSn_RCR(), setSn_RCR(), getSn_KPALVTR(), setSn_KPALVTR() + - SOCKET information \n + getSn_SR(), getSn_ESR() \n + getSn_DHAR(), setSn_DHAR(), getSn_PORTR(), setSn_PORTR(), getSn_DPORTR(), setSn_DPORTR() \n + getSn_DIPR(), setSn_DIPR(), getSn_DIP6R(), setSn_DIP6R() \n + getSn_MSSR(), setSn_MSSR() + - SOCKET communication \n + getSn_RX_BSR(), setSn_RX_BSR(), getSn_TX_BSR(), setSn_TX_BSR() \n + getSn_TX_RD(), getSn_TX_WR(), setSn_TX_WR() \n + getSn_RX_RD(), setSn_RX_RD(), getSn_RX_WR() \n + getSn_TX_FSR(), getSn_RX_RSR() + - IP header field \n + getSn_FRGR(), setSn_FRGR(), getSn_TOSR(), setSn_TOSR() \n + getSn_TTLR(), setSn_TTLR() +*/ + +/** + @defgroup Common_register_group_W6300 Common register + @ingroup WIZCHIP_register_W6300 + @brief Common register group \n + @details It set the general configuration such as interrupt, network information, ICMP, and etc. + @sa + + + + + + + + + + + + +
    @ref _WIZCHIP_ Information : _CIDR_, _VER_
    @ref _WIZCHIP_ Mode : _SYSR_, _SYCR0_, _SYCR1_, _CHPLCKR_, _NETLCKR_, _PHYLCKR_
    Network Mode : _NET4MR_, _NET6MR_, _NETMR_, _NETMR2_
    Network Information : _GAR_, _SUBR_, _SHAR_, _SIPR_, _GA6R_, _LLAR_, _GUAR_, _SUB6R_
    Interrupt : _IR_, _IRCLR_, _IMR_, _SIR_, _SIMR_, _SLIR_, _SLIMR_, _SLIRCLR_, _INTPTMR_
    Data retransmission : _RTR_, _RCR_, _SLRTR_, _SLRCR_, _SLHOPR_
    PPPoE : _PHAR_, _PSIDR_, _PMRUR_, _PTMR_, _PMNR_
    SOCKET-less command : _SLCR_, _SLIR_, _SLDIPR_, _SLDIP4R_, _SLDIP6R_, _SLDHAR_, _PINGIDR_, _PINGSEQR_
    ICMP v4 & v6 : _UIPR_, _UPORTR_, _UIP6R_, _UPORT6R_, _ICMP6BLKR_
    IPv6 Auto-configuration : _PLR_, _PFR_, _VLTR_, _PAR_
    PHY Configuration : _PHYSR_, _PHYCR0_, _PHYCR1_, _PHYRAR_, _PHYDIR_, _PHYDOR_, _PHYACR_, _PHYDIVR_
    +*/ + + +/** + @defgroup Socket_register_group_W6300 Socket register + @ingroup WIZCHIP_register_W6300 + @brief Socket register group\n + @details + SOCKETn registers configure and control SOCKETn which is necessary to data communication. + @sa + + + + + + +
    SOCKETn Control : _Sn_MR_, _Sn_MR2_, _Sn_CR_, _Sn_IR_, _Sn_IRCLR_, _Sn_IMR_, _Sn_PSR_
    SOCKETn Information : _Sn_SR_, _Sn_ESR_, _Sn_PORTR_, _Sn_DHAR_, _Sn_DIPR_, _Sn_DIP6R_, _Sn_DPORTR_
    SOCKETn Retransmission : _Sn_RTR_, _Sn_RCR_
    Internet protocol : _Sn_MSSR_, _Sn_TOSR_, _Sn_TTLR_, _Sn_FRGR_
    Data communication : _Sn_RX_BSR_, _Sn_TX_BSR_, _Sn_TX_FSR_, _Sn_TX_RD_, _Sn_TX_WR_, _Sn_RX_RSR_, _Sn_RX_RD_, _Sn_RX_WR_
    +*/ + +//----------------------------------------------------------------------------------- + +//----------------------------- W6300 Common Registers IOMAP ----------------------------- + +/** + @addtogroup Common_register_group_W6300 + @{ +*/ + +/** + @brief Chip Identification Register address [RO] [0x6100] + @sa getCIDR() +*/ +#define _CIDR_ (_W6300_IO_BASE_ + (0x0000 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief Chip Identification Register address [RO] [0x11] + @sa getRTL() +*/ +#define _RTL_ (_W6300_IO_BASE_ + (0x0004 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief Chip Version Register address [RO] [0x4661] + @sa getVER() +*/ +#define _VER_ (_W6300_IO_BASE_ + (0x0002 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief System Status Register address [RO] [0xEU] + @details @ref _SYSR_ shows the information such as CHIP, NET, PHY Locking and Host I/F + + + +
    7 6 5 4 ~ 2 1 0
    CHPL NETL PHYL Reserved IND SPI
    + - @ref SYSR_CHPL + - @ref SYSR_NETL + - @ref SYSR_PHYL + - @ref SYSR_IND : HOST use Parallel BUS Interface(Indirect Bus Mode) + - @ref SYSR_SPI : HOST use SPI Interface + + @sa _CHPLCKR_, _NETLCKR_, _PHYLCKR_, + @sa getSYSR(), setCHPLCKR(), getCHPLCKR(), CHIPLOCK(), CHIPUNLOCK(), setNETLCKR(), getNETLCKR(), NETLOCK(), NETUNLOCK() \n + setPHYLCKR(), getPHYLCKR(), PHYLOCK(), PHYUNLOCK() +*/ +#define _SYSR_ (_W6300_IO_BASE_ + (0x2000 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief System Config Register 0 address [WO][0x80] + @details @ref _SYCR0_ softly reset to _WIZCHIP_. + + + +
    7 6 ~ 0
    RST Reserved
    + - @ref SYCR0_RST : Software Reset. + + @note It can be accessed only when @ref SYSR_CHPL = 1. + @sa _CHPLCKR_, _SYSR_, SYSR_CHPL + @sa setSYCR0(), setCHPLCKR(), getCHPLCKR(), CHIPLOCK(), CHIPUNLOCK(), getSYSR() +*/ +#define _SYCR0_ (_W6300_IO_BASE_ + (0x2004 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief System Config Register 1 address [R=W][0x80] + @details @ref _SYCR1_ controls the global interrupt enable, and selects the system clock. + + + +
    7 6 ~ 1 0
    IEN Reserved CLKSEL
    + - @ref SYCR1_IEN + - @ref SYCR1_CLKSEL + + @note SYCR1_CLKSEL bit can be accessed only when @ref SYSR_CHPL = 1. + @sa _CHPLCKR_, _SYSR_, SYSR_CHPL + @sa getSYCR1(), setSYCR1(), setCHPLCKR(), getCHPLCKR(), CHIPLOCK(), CHIPUNLOCK(), getSYSR() +*/ +#define _SYCR1_ (WIZCHIP_OFFSET_INC(_SYCR0_,1)) + +/** + @brief Ticker Counter Register address [RO][0x0000] + @details @ref _TCNTR_ increase by 1 every 100us after _WIZCHIP_ reset. + @sa _TCNTRCLR_ + @sa getTCNTR(), setTCNTRCLR() +*/ +#define _TCNTR_ (_W6300_IO_BASE_ + (0x2016 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief Ticker Counter Clear Register address [RO][0x00] + @details @ref _TCNTRCLR_ clear @ref _TCNTR_. + @sa setTCNTRCLR(), getTCNTR() +*/ +#define _TCNTRCLR_ (_W6300_IO_BASE_ + (0x2020 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief Interrupt Register address [RO][0x00] + @details @ref _IR_ indicates the interrupt status. + If @ref _IR_ is not equal to x00 INTn PIN is asserted to low until it is x00. + + + + +
    7 6 ~ 5 4 3 2 1 0
    WOL Reserved UNR6 Reserved IPCONF UNR4 PTERM
    + - @ref IR_WOL : Wake On LAN + - @ref IR_UNR6 : Destination Port Unreachable for IPv6 + - @ref IR_IPCONF : @ref _SIPR_ is Conflict + - @ref IR_UNR4 : Destination Port Unreachable for IPv4 + - @ref IR_PTERM : PPPoE Terminated + + @sa _IMR_, _IRCLR_, SYCR1_IEN, _CHIPLCKR_, _SYSR_, SYSR_CHPL + @sa getIR(), setIRCLR(), getSYCR1(), setSYCR1(), getCHPLCKR(), setCHPLCKR(), CHIPLOCK(), CHIPUNLOCK(), getSYSR() +*/ +#define _IR_ (_W6300_IO_BASE_ + (0x2100 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief SOCKET Interrupt Register address [RO][0x00] + @details @ref _SIR_ indicates whether a socket interrupt is occurred or not.\n + Each bit of @ref _SIR_ be still until @ref _Sn_IR_ is cleared by @ref _Sn_IRCLR_ + @sa _SIMR_, _Sn_IR_, _Sn_IRCLR_, _Sn_IMR_, SYCR1_IEN , _CHIPLCKR_, _SYSR_, SYSR_CHPL + @sa getSIR(), getSn_IR(), setSn_IRCLR(), getSIMR(), setSIMR(), getSn_IMR(), setSn_IMR(), getSYCR1(), setSYCR1(), \n + getSYCR1(), setSYCR1(), getCHPLCKR(), setCHPLCKR(), CHIPLOCK(), CHIPUNLOCK(), getSYSR() +*/ +#define _SIR_ (_W6300_IO_BASE_ + (0x2101 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief SOCKET-less Interrupt Register address [RO][0x00] + @details @ref _SLIR_ indicates the completion of @ref _SLCR_ or timeout. + + + +
    7 6 5 4 3 2 1 0
    TOUT ARP4 PING4 ARP6 PING6 NS RS RA
    + - @ref SLIR_TOUT : The timeout occurrence after @ref _SLCR_ is performed + - @ref SLIR_ARP4 : The completion of @ref SLCR_ARP4 + - @ref SLIR_PING4 : The completion of @ref SLCR_PING4 + - @ref SLIR_ARP6 : The completion f @ref SLCR_ARP6 + - @ref SLIR_PING6 : The completion of @ref SLCR_PING6 + - @ref SLIR_NS : The completion of @ref SLCR_NS + - @ref SLIR_RS : The completion of @ref SLIR_RS + - @ref SLIR_RA : The reception from Router Advertisement + + @sa _SLIRCLR_, _SLIMR_, SYCR1_IEN, _CHPLCKR_, _SYSR_, SYSR_CHPL + @sa getSLIR(), setSLIRCLR(), getSLIR(), getSLIMR(), setSLIMR(), \n + getSYCR1(), setSYCR1(), getCHPLCKR(), setCHPLCKR(), CHIPLOCK(), CHIPUNLOCK(), getSYSR() +*/ +#define _SLIR_ (_W6300_IO_BASE_ + (0x2102 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief Interrupt Mask Register address [R=W][0x00] + @details @ref _IMR_ is used to mask interrupts of @ref _IR_.\n + When a bit of @ref _IMR_ and the corresponding bit of @ref _IR_ is set, an interrupt will be issued. + @sa _IR_, SYCR1_IEN, _CHPLCKR_, _SYSR_, SYSR_CHPL + @sa getIMR(), setIMR(), getIR(), setIRCLR(), \n + getSYCR1(), setSYCR1(), getCHPLCKR(), setCHPLCKR(), CHIPLOCK(), CHIPUNLOCK(), getSYSR() +*/ +#define _IMR_ (_W6300_IO_BASE_ + (0x2104 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief @ref _IR_ Clear Register address [WO][0x00] + @details @ref _IRCLR_ clears @ref _IR_ + @sa _IR_, _IMR_, SYCR1_IEN, _CHPLCKR_, _SYSR_, SYSR_CHPL + @sa setIRCLR(), getIR(), getIMR(), getSYCR1(), setSYCR1(), getCHPLCKR(), setCHPLCKR(), CHIPLOCK(), CHIPUNLOCK(), getSYSR() +*/ +#define _IRCLR_ (_W6300_IO_BASE_ + (0x2108 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief SOCKET Interrupt Mask Register address [R=W]][0x00] + @details @ref _SIMR_ is used to mask interrupts of @ref _SIR_.\n + When a bit of @ref _SIMR_ and the corresponding bit of @ref _SIR_ is set, an interrupt will be issued.\n + when @ref _Sn_IR_ is not 0, The N-th bit of @ref _SIR_ is set. Otherwise, this bit is automatically clear.\n + @sa _SIR_, _Sn_IR_, _Sn_IRCLR_, _Sn_IMR_, SYCR1_IEN, _CHPLCKR_, _SYSR_, SYSR_CHPL + @sa getSIMR(), setSIMR(), getSIR(), setSn_IRCLR(), getSn_IMR(), setSn_IMR(), \n + getSYCR1(), setSYCR1(), getCHPLCKR(), setCHPLCKR(), CHIPLOCK(), CHIPUNLOCK(), getSYSR() +*/ +#define _SIMR_ (_W6300_IO_BASE_ + (0x2114 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief SOCKET-less Interrupt Mask Register address [R=W][0x00] + @details @ref _SLIMR_ is used to mask interrupts of @ref _SLIR_\n + When a bit of @ref _SLIMR_ and the corresponding bit of @ref _SLIR_ is set, an interrupt will be issued. + @sa _SLIR_, _SLIRCLR_, SYCR1_IEN, _CHPLCKR_, _SYSR_, SYSR_CHPL + @sa getSLIMR(), setSLIMR(), getSLIR(), setSLIRCLR(), \n + getSYCR1(), setSYCR1(), getCHPLCKR(), setCHPLCKR(), CHIPLOCK(), CHIPUNLOCK(), getSYSR() +*/ +#define _SLIMR_ (_W6300_IO_BASE_ + (0x2124 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief SOCKET-less Interrupt Clear Register address [WO][0x00] + @details @ref _SLIRCLR_ clears @ref _SLIR_ + @sa _SLIR_, _SLIRCLR_, _SLIMR_, SYCR1_IEN, _CHPLCKR_, _SYSR_, SYSR_CHPL + @sa getSLIR(), setSLIRCLR(), getSLIMR(), setSLIMR(), \n + getSYCR1(), setSYCR1(), getCHPLCKR(), setCHPLCKR(), CHIPLOCK(), CHIPUNLOCK(), getSYSR() +*/ +#define _SLIRCLR_ (_W6300_IO_BASE_ + (0x2128 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief SOCKET-less Prefer Source IPv6 Address Register address [R=W][0x00] + @details @ref _SLPSR_ select the Source IPv6 Address to transmit a packet by @ref _SLCR_. + - @ref PSR_AUTO + - @ref PSR_LLA + - @ref PSR_GUA + @sa _SLCR_, _Sn_PSR_ + @sa getSLPSR(), setSLPSR(), getSLCR(), setSLCR(), getSn_PSR(), setSn_PSR() +*/ +#define _SLPSR_ (_W6300_IO_BASE_ + (0x212C << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief SOCKET-less Command Register address [RW,AC][0x00] + @details @ref _SLCR_ can be request a message such like as ARP, PING, and ICMPv6 without SOCKET. + + + +
    7 6 5 4 3 2 1 0
    Reserved ARP4 PING4 ARP6 PING6 NS RS UNA
    + - @ref SLCR_ARP4 + - @ref SLCR_PING4 + - @ref SLCR_ARP6 + - @ref SLCR_PING6 + - @ref SLCR_NS + - @ref SLCR_RS + - @ref SLCR_UNA + + @sa _SLIR_, _SLIMR_, _SLDIPR_, _SLDIP4R_, _SLDIP6R_, _SLDHAR_, SYCR1_IEN, _CHPLCKR_, _SYSR_, SYSR_CHPL + @sa getSLCR(), setSLCR(), getSLIR(), setSLIRCLR(), getSLIMR(), setSLIMR(), getSLDIPR(),setSLDIPR(), getSLDIP4R(),setSLDIP4R(), + getSLDIP6R(), setSLDIP6R(), getSLDHAR(), getSYCR1(), setSYCR1(), getCHPLCKR(), setCHPLCKR(), CHIPLOCK(), CHIPUNLOCK(), getSYSR() +*/ +#define _SLCR_ (_W6300_IO_BASE_ + (0x2130 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief PHY Status Register address [RO][0x00] + @details @ref _PHYSR_ shows the operation mode of PHY, the link status and etc. + - @ref PHYSR_CAB : @ref PHYSR_CAB_OFF, @ref PHYSR_CAB_ON + - @ref PHYSR_MODE : @ref PHYSR_MODE_AUTO, @ref PHYSR_MODE_100F, @ref PHYSR_MODE_100H, @ref PHYSR_MODE_10F, @ref PHYSR_MODE_10H + - @ref PHYSR_DPX : @ref PHYSR_DPX_FULL, @ref PHYSR_DPX_HALF + - @ref PHYSR_SPD : @ref PHYSR_SPD_100M, @ref PHYSR_SPD_10M + - @ref PHYSR_LNK : @ref PHYSR_LNK_UP, @ref PHYSR_LNK_DOWN + + @sa _PHYCR0_, _PHYLCKR_, _SYSR_, SYSR_PHYL + @sa getPHYSR(), setPHYCR0(), setPHYLCKR(), getPHYLCKR(), PHYLOCK(), PHYUNLOCK(), getSYSR() +*/ +#define _PHYSR_ (_W6300_IO_BASE_ + (0x3000 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief PHY Internal Register Address Register address(R/W) + @details @ref _PHYRAR_ specifies the address of register in the Ethernet PHY. + - @ref PHYRAR_BMCR + - @ref PHYRAR_BMSR + @sa _PHYACR_, _PHYDOR_, _PHYDIR_, _PHYDIVR_ + @sa getPHYACR(), setPHYACR(), getPHYDOR(), setPHYDIR(), getPHYDIVR(), setPHYDIVR() +*/ +#define _PHYRAR_ (_W6300_IO_BASE_ + (0x3008 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief PHY Data Input Register address [R=W][0x00] + @details @ref _PHYDIR_ specifies the value to write to the register in PHY + @sa _PHYRAR_, _PHYACR_, _PHYDOR_, _PHYDIVR_ + @sa setPHYDIR(), getPHYRAR(), setPHYRAR(), getPHYACR(), setPHYACR(), getPHYDOR(), setPHYDIR(), getPHYDIVR(), setPHYDIVR() +*/ +#define _PHYDIR_ (_W6300_IO_BASE_ + (0x300C << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief PHY Data Output Register address [WO][0x00] + @details @ref _PHYDOR_ read the value from the register in PHY + @sa _PHYRAR_, _PHYACR_, _PHYDIR_, _PHYDIVR_ + @sa getPHYDOR(), getPHYRAR(), setPHYRAR(), getPHYACR(), setPHYACR(), setPHYDIR(), getPHYDIVR(), setPHYDIVR() +*/ +#define _PHYDOR_ (_W6300_IO_BASE_ + (0x3010 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief PHY Access Register address [RW,AC][0x00] + @details @ref _PHYACR_ write(read) to(from) the value of register in the Ethernet PHY + - @ref PHYACR_READ + - @ref PHYACR_WRITE + @sa _PHYRAR_, _PHYDOR_, _PHYDIR_, _PHYDIVR_ + @sa getPHYACR(), setPHYACR(), getPHYDOR(), getPHYRAR(), setPHYRAR(), setPHYDIR(), getPHYDIVR(), setPHYDIVR() +*/ +#define _PHYACR_ (_W6300_IO_BASE_ + (0x3014 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief PHY's MDC Clock Division Register address [R=W][0x01] + @details @ref _PHYDIVR_ divides the system clock for the MDC clock of Ethernet PHY' + - @ref PHYDIVR_32 + - @ref PHYDIVR_64 + - @ref PHYDIVR_128 + @sa _PHYRAR_, _PHYACR_, _PHYDOR_, _PHYDIR_, _PHYDIVR_ + @sa getPHYDIVR(), setPHYDIVR(), getPHYRAR(), setPHYRAR(), getPHYACR(), setPHYACR(), getPHYDOR(), setPHYDIR() +*/ +#define _PHYDIVR_ (_W6300_IO_BASE_ + (0x3018 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief PHY Control Register address [WO][0x00] + @details @ref _PHYCR0_ controls the operation mode of PHY. + The result will be checked by @ref _PHYSR_ after PHY HW reset by @ref PHYCR1_RST. + - @ref PHYCR0_AUTO + - @ref PHYCR0_100F + - @ref PHYCR0_100H + - @ref PHYCR0_10F + - @ref PHYCR0_10H + + @note It can be only accessed when @ref SYSR_PHYL is unlock. + @sa _SYSR_, _PHYCR1_ + @sa setPHYCR0(), getSYSR(), getPHYCR1(), setPHYCR1() +*/ +#define _PHYCR0_ (_W6300_IO_BASE_ + (0x301C << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief PHY Control Register address [R=W][0x40] + @details @ref _PHYCR1_ controls the Ethernet PHY function such as HW reset, Power down and etc. + + + +
    7 6 5 4 3 2 ~ 1 0
    Reserved Always 1 PWDN Reseved TE Reserved RST
    + - @ref PHYCR1_PWDN + - @ref PHYCR1_TE + - @ref PHYCR1_RST + + @note It can be only accessed when @ref SYSR_PHYL is unlock. + @sa _SYSR_, _PHYCR0_ + @sa getPHYCR1(), setPHYCR1(), setPHYCR0(), getSYSR() +*/ +#define _PHYCR1_ WIZCHIP_OFFSET_INC(_PHYCR0_,1) + +/** + @brief Network IPv4 Mode Register address [R=W][0x00] + @details @ref _NET4MR_ can block the transmission such like as unreachable message, TCP reset, and ping relay.\n + It can ARP request before ping relpy. + + + + +
    7 ~ 4 3 2 1 0
    Reserved UNRB PARP RSTB PB
    + - @ref NETxMR_UNRB + - @ref NETxMR_PARP + - @ref NETxMR_RSTB + - @ref NETxMR_PB + @sa _NET6MR_ + @sa getNET4MR(), setNET4MR(), getNET6MR(), setNET6MR() +*/ +#define _NET4MR_ (_W6300_IO_BASE_ + (0x4000 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief Network IPv6 Mode Register address [R=W][0x00] + @details @ref _NET6MR_ can block the transmission such like as unreachable message, TCP reset, and ping relay.\n + It can ARP request before ping reply. + + + + +
    7 ~ 4 3 2 1 0
    Reserved UNRB PARP RSTB PB
    + - @ref NETxMR_UNRB + - @ref NETxMR_PARP + - @ref NETxMR_RSTB + - @ref NETxMR_PB + @sa _NET4MR_ + @sa getNET6MR(), setNET6MR(), getNET4MR(), setNET4MR() +*/ +#define _NET6MR_ (_W6300_IO_BASE_ + (0x4004 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief Network Mode Register address [R=W][0x00] + @details @ref _NETMR_ set WOL(Wake On Lan) mode.\n + It also can block a packet such as \n + IPv6 PING request from an all-node broadcasting, \n + IPv6 PING request from a solicited mulitcasting address,\n + IPv4 packets, \n + and IPv6 packets. + + + + +
    7 ~ 6 5 4 3 2 1 0
    Reserved ANB M6B Always 0 WOL IP6B IP4B
    + - @ref NETMR_ANB + - @ref NETMR_M6B + - @ref NETMR_WOL + - @ref NETMR_IP6B + - @ref NETMR_IP4B + @sa getNETMR(), setNETMR() + +*/ +#define _NETMR_ (_W6300_IO_BASE_ + (0x4008 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief Network Mode Register 2 address [R=W][0x00] + @details @ref _NETMR2_ set PPPoE mode.\n + It also can select the destination hardware address to either Ethernet frame MAC or target MAC in the ARP-reply message + + + +
    7 6 ~ 1 0
    DHAS 6 ~ 1 PPPoE
    + - @ref NETMR2_DHAS : @ref NETMR2_DHAS_ARP, @ref NETMR2_DHAS_ETH + - @ref NETMR2_PPPoE + @sa getNETMR2(), setNETMR2() +*/ +#define _NETMR2_ (_W6300_IO_BASE_ + (0x4009 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief PPP LCP request Timer Register address [R=W][0x28] + @details @ref _PTMR_ sets the time for sending LCP echo request.\n + The unit of time is 25ms. + @sa _PMNR_, _PHAR_, _PSIDR_, _PMRUR_, NETMR2_PPPoE + @sa getPTMR(), setPTMR(), getPMNR(), setPMNR(), getPHAR(), setPHAR(), getPSIDR(), setPSIDR(), getPMRUR(), setPMRUR(), getNETMR2(), setNETMR2() +*/ +#define _PTMR_ (_W6300_IO_BASE_ + (0x4100 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief PPP LCP Magic Number Register address [R=W][0x00] + @details @ref _PMNR_ sets the 4bytes magic number to be used in LCP negotiation. + @sa _PTMR_, _PHAR_, _PSIDR_, _PMRUR_, NETMR2_PPPoE + @sa getPMNR(), setPMNR(), getPTMR(), setPTMR(), getPHAR(), setPHAR(), getPSIDR(), setPSIDR(), getPMRUR(), setPMRUR(), getNETMR2(), setNETMR2() +*/ +#define _PMNR_ (_W6300_IO_BASE_ + (0x4104 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief PPPoE Hardware Address Register address [R=W][0x00] + @details @ref _PHAR_ sets the PPPoE server hardware address that is acquired during PPPoE connection process. + @sa _PTMR_, _PMNR_, _PSIDR_, _PMRUR_, NETMR2_PPPoE + @sa getPHAR(), setPHAR(), getPTMR(), setPTMR(), getPMNR(), setPMNR(), getPSIDR(), setPSIDR(), getPMRUR(), setPMRUR(), getNETMR2(), setNETMR2() +*/ +#define _PHAR_ (_W6300_IO_BASE_ + (0x4108 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief PPP Session ID Register address [R=W][0X0000] + @details @ref _PSIDR_ sets the PPPoE sever session ID acquired during PPPoE connection process. + @sa _PTMR_, _PMNR_, _PHAR_, _PMRUR_, NETMR2_PPPoE + @sa getPSIDR(), setPSIDR(), getPTMR(), setPTMR(), getPMNR(), setPMNR(), getPHAR(), setPHAR(), getPMRUR(), setPMRUR(), getNETMR2(), setNETMR2() +*/ +#define _PSIDR_ (_W6300_IO_BASE_ + (0x4110 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief PPP Maximum Receive Unit Register address [R=W][0xFFFF] + @details @ref _PMRUR_ sets the maximum receive unit of PPPoE. + @sa _PTMR_, _PMNR_, _PHAR_, _PSIDR_, NETMR2_PPPoE + @sa getPMRUR(), setPMRUR(), getPTMR(), setPTMR(), getPMNR(), setPMNR(), getPHAR(), setPHAR(), getPSIDR(), setPSIDR(), getNETMR2(), setNETMR2() +*/ +#define _PMRUR_ (_W6300_IO_BASE_ + (0x4114 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief Source Hardware Address Register address [R=W][00:00:00:00:00:00] + @details @ref _SHAR_ sets the source hardware address. + @note It can be accessed only when @ref SYSR_NETL is unlock. + @sa SYSR_NETL, _NETLCKR_ + @sa getSHAR(), setSHAR(), getSYSR(), setNETLCKR(), getNETLCKR(), NETLOCK(), NETUNLOCK() +*/ +#define _SHAR_ (_W6300_IO_BASE_ + (0x4120 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief IPv4 Gateway Address Register address [R=W][0.0.0.0] + @details @ref _GAR_ sets the default gateway IPv4 address. + @note It can be accessed only when @ref SYSR_NETL is unlock. + @sa SYSR_NETL, _NETLCKR_, _GA6R_ + @sa getGAR(), setGAR(), getSYSR(), setNETLCKR(), getNETLCKR(), NETLOCK(), NETUNLOCK(), getGA6R(), setGA6R() +*/ +#define _GAR_ (_W6300_IO_BASE_ + (0x4130 << 8) + WIZCHIP_CREG_BLOCK) +#define _GA4R_ (_GAR_) ///< Refer to @ref _GAR_ +/** + @brief IPv4 Subnet Mask Register address [R=W][0.0.0.0] + @details @ref _SUBR_ sets the default subnet mask address of IPv4. + @note It can be accessed only when @ref SYSR_NETL is unlock. + @sa SYSR_NETL, _NETLCKR_, _SUB6R_ + @sa getSUBR(), setSUBR(), getSYSR(), setNETLCKR(), getNETLCKR(), NETLOCK(), NETUNLOCK(), getSUB6R(), setSUB6R() +*/ +#define _SUBR_ (_W6300_IO_BASE_ + (0x4134 << 8) + WIZCHIP_CREG_BLOCK) +#define _SUB4R_ (_SUBR_) ///< Refer to @ref _SUBR_ + +/** + @brief IPv4 Source IP Register address [R=W][0.0.0.0] + @details @ref _SIPR_ sets the source IPv4 address. + @note It can be accessed only when @ref SYSR_NETL is unlock. + @sa SYSR_NETL, _NETLCKR_, _LLAR_, _GUAR_ + @sa getSIPR(), setSIPR(), getSYSR(), setNETLCKR(), getNETLCKR(), NETLOCK(), NETUNLOCK(), getLLAR(), setLLAR(), getGUAR(),setGUAR() +*/ +#define _SIPR_ (_W6300_IO_BASE_ + (0x4138 << 8) + WIZCHIP_CREG_BLOCK) +#define _SIP4R_ (_SIPR_) ///< Refer to @ref _SIPR_. + +/** + @brief IPv6 LLA(Link Local Address) Register address [R=W][::] + @details @ref _LLAR_ sets the LLA address of IPv6. + @note It can be accessed only when @ref SYSR_NETL is unlock. + @sa SYSR_NETL, _NETLCKR_, _GUAR_, _SIPR_ + @sa getLLAR(), setLLAR(), getSYSR(), setNETLCKR(), getNETLCKR(), NETLOCK(), NETUNLOCK(), getGUAR(),setGUAR(), getSIPR(), setSIPR() +*/ +#define _LLAR_ (_W6300_IO_BASE_ + (0x4140 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief IPv6 GUA(Global Unicast Address) Register address [R=W][::] + @details @ref _GUAR_ sets the GUA address of IPv6. + @note It can be accessed only when @ref SYSR_NETL is unlock. + @sa SYSR_NETL, _NETLCKR_, _LLAR_, _SIPR_ + @sa getGUAR(), setGUAR(), getSYSR(), setNETLCKR(), getNETLCKR(), NETLOCK(), NETUNLOCK(), getLLAR(),setLLAR(), getSIPR(), setSIPR() +*/ +#define _GUAR_ (_W6300_IO_BASE_ + (0x4150 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief IPv6 Subnet Mask Register address [R=W][] + @details @ref _SUB6R_ sets the default subnet mask address of IPv6. + @note It can be accessed only when @ref SYSR_NETL is unlock. + @sa SYSR_NETL, _NETLCKR_, _SUBR_ + @sa getSUB6R(), setSUB6R(), getSYSR(), setNETLCKR(), getNETLCKR(), NETLOCK(), NETUNLOCK(), getSUBR(), setSUBR() +*/ +#define _SUB6R_ (_W6300_IO_BASE_ + (0x4160 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief IPv6 Gateway Address Register address [R/W][::] + @details @ref _GA6R_ sets the default gateway IPv6 address. + @sa _GAR_ + @sa getGA6R(), setGA6R(), getGAR(), setGAR() +*/ +#define _GA6R_ (_W6300_IO_BASE_ + (0x4170 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief SOCKET-less Peer IPv6 Register address [R=W][::] + @details @ref _SLDIP6R_ sets the destination IP address of @ref _SLCR_. + @sa _SLDIP6R_, _SLCR_, _SLIR_, _SLIRCLR_, _SLIMR_, _SLDHAR_, _SLDIPR_, _SLDIP4R_ + @sa getSLDIP6R(), setSLDIP6R(), getSLCR(), setSLCR(), getSLIR(), setSLIRCLR(), getSLIMR(), setSLIMR(), getSLDHAR(), + getSLDIPR(), setSLDIPR(), getSLDIP4R(), setSLDIP4R() +*/ +#define _SLDIP6R_ (_W6300_IO_BASE_ + (0x4180 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief SOCKET-less Peer IPv6 Register address [R=W][0.0.0.0] + @details @ref _SLDIPR_(= @ref _SLDIP4R_) sets the destination IPv4 address of @ref _SLCR_. + @sa _SLDIP4R_, _SLCR_, _SLIR_, _SLIRCLR_, _SLIMR_, _SLDHAR_, _SLDIP6R_ + @sa getSLDIPR(), setSLDIPR(), getSLDIP4R(), setSLDIP4R(), getSLCR(), setSLCR(), getSLIR(), setSLIRCLR(), getSLIMR(), setSLIMR(), getSLDHAR(), + getSLDIP6R(), setSLDIP6R() +*/ +#define _SLDIPR_ (_W6300_IO_BASE_ + (0x418C << 8) + WIZCHIP_CREG_BLOCK) +#define _SLDIP4R_ (_SLDIPR_) ///< Refer to @ref _SLDIPR_. + + +/** + @brief SOCKET-less Peer Hardware Address Register address [RO][00:00:00:00:00:00] + @details @ref _SLDHAR_ gets the destination hardware address acquired by of @ref SLCR_ARP4, SLCR_ARP6, SLCR_PING4, and SLCR_PING6. + @sa _SLDIP4R_, _SLDIP6R_, _SLCR_, _SLIR_, _SLIRCLR_, _SLIMR_ + @sa getSLDHAR(), getSLDIP4R(), setSLDIP4R(), getSLDIP6R(), setSLDIP6R(), getSLCR(), setSLCR(), \n + getSLIR(), setSLIRCLR(), getSLIMR(), setSLIMR() +*/ +#define _SLDHAR_ (_W6300_IO_BASE_ + (0x4190 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief SOCKET-less Ping ID Register address [R=W][0x00] + @details @ref _PINGIDR_ sets the PING-request ID to be sent by @ref SLCR_PING4 or @ref SLCR_PING6. + @sa _SLCR_, _PINGSEQR_, _SLDIPR_, _SLDIP4R_, _SLDIP6R_, _SLDHAR_, _SLIR_, _SLIRCLR_, _SLIMR_ + @sa getPINGIDR(), setPINGIDR(), getSLCR(), setSLCR(), getPINGSEQR(), setPINGSEQR(), getSLDIPR(), setSLDIPR(), + getSLDIP4R(), setSLDIP4R(), getSLDIP6R(), setSLDIP6R(), getSLDHAR(), getSLIR(), setSLIRCLR(), getSLIMR(), setSLIMR() +*/ +#define _PINGIDR_ (_W6300_IO_BASE_ + (0x4198 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief SOCKET-less ping Sequence number Register address [R=W][0x0000] + @details @ref _PINGIDR_ sets the PING-request sequence number to be sent by @ref SLCR_PING4 or @ref SLCR_PING6. + @sa _SLCR_, _PINGIDR_, _SLDIPR_, _SLDIP4R_, _SLDIP6R_, _SLDHAR_, _SLIR_, _SLIRCLR_, _SLIMR_ + @sa getPINGSEQR(), setPINGSEQR(), getSLCR(), setSLCR(), getPINGIDR(), setPINGIDR(), getSLDIPR(), setSLDIPR(), getSLDIP4R(), setSLDIP4R(), + getSLDIP6R(), setSLDIP6R(), getSLDHAR(), getSLIR(), setSLIRCLR(), getSLIMR(), setSLIMR() +*/ +#define _PINGSEQR_ (_W6300_IO_BASE_ + (0x419C << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief IPv4 Unreachable Address Register address [RO][0.0.0.0] + @details @ref _UIPR_ is set when a unreachable ICMPv4 message is received. + @sa _UPORTR_, _UIP6R_, _UPORT6R_ + @sa getUIPR(), setUIPR(), getUPORTR(), setUPORTR(), getUIPR6(), setUIPR6(), getUPORT6R(), setUPORT6R() +*/ +#define _UIPR_ (_W6300_IO_BASE_ + (0x41A0 << 8) + WIZCHIP_CREG_BLOCK) +#define _UIP4R_ (_UIPR_) ///< Refer to @ref _UPORTR_ + +/** + @brief IPv4 Unreachable Port number Register address [RO][0x0000] + @details @ref _UPORTR_ is set when a unreachable ICMPv4 message is received. + @sa _UIPR_, _UIP6R_, _UPORT6R_ + @sa getUPORTR(), setUPORTR(), getUIPR(), setUIPR(), getUIPR6(), setUIPR6(), getUPORT6R(), setUPORT6R() +*/ +#define _UPORTR_ (_W6300_IO_BASE_ + (0x41A4 << 8) + WIZCHIP_CREG_BLOCK) +#define _UPORT4R_ (_UPORTR_) ///< Refer to @ref _UPORTR_ +/** + @brief IPv6 Unreachable IP Address Register address [RO][::] + @details @ref _UIP6R_ is set when a unreachable ICMPv6 message is received. + @sa _UIPR_, _UPORTR_, _UIP6R_, _UPORT6R_ + @sa getUIPR6(), setUIPR6(), getUIPR(), setUIPR(), getUPORTR(), setUPORTR(), getUPORT6R(), setUPORT6R() +*/ +#define _UIP6R_ (_W6300_IO_BASE_ + (0x41B0 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief IPv6 Unreachable Port number Register address [RO][0x0000] + @details @ref _UIP6R_ is set when a unreachable ICMPv6 message is received. + @sa _UIPR_, _UPORTR_, _UIP6R_, _UPORT6R_ + @sa getUIPR6(), setUIPR6(), getUIPR(), setUIPR(), getUPORTR(), setUPORTR(), getUPORT6R(), setUPORT6R() +*/ +#define _UPORT6R_ (_W6300_IO_BASE_ + (0x41C0 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief Interrupt Pending Time Register address [R=w][0x0000] + @details @ref _INTPTMR_ pends the next interrupt issued by the INTn pin of @ref _WIZCHIP_.\n + It is decreased 1 every 4 SYS_CLK. \n + If it is zero and some interrupt is still remained, the INTn pin is issued. + @sa _IR_, _IRCLR_, _IMR_, _SIR_, _Sn_IRCLR_, _SIMR_, _SLIR_, _SLIRCLR_, _SLIMR_, SYCR_IEN + @sa getINTPTMR(), setINTPTMR(), getIR(), setIRCLR(), getIMR(), setIMR(), getSIR(), setSn_IRCLR(), getSIMR(), setSIMR(), \n + getSLIR(), setSLIRCLR(), getSLIMR(), setSLIMR(), getSYCR1(), setSYCR1() +*/ +#define _INTPTMR_ (_W6300_IO_BASE_ + (0x41C5 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief RA Prefix Length Register address [RO][0x00] + @details @ref _PLR_ is set when RA packet is received from a router. + @sa SLIR_RA, _SLIRCLR_, _PFR_, _VLTR_, _PLTR_, _PAR_ + @sa getPLR(), getSLIR(), setSLIRCLR(), getPFR(), getVLTR(), getPLTR(), getPAR() +*/ +#define _PLR_ (_W6300_IO_BASE_ + (0x41D0 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief RA Prefix Flag Register address [RO][0x00] + @details @ref _PFR_ is set when RA packet is received from a router. + @sa SLIR_RA, _SLIRCLR_, _PLR_, _VLTR_, _PLTR_, _PAR_ + @sa getPFR(), getSLIR(), setSLIRCLR(), getPLR(), getVLTR(), getPLTR(), getPAR() +*/ +#define _PFR_ (_W6300_IO_BASE_ + (0x41D4 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief RA Valid Life Time Register address [RO][0x00000000] + @details @ref _VLTR_ is set when RA packet is received from a router. + @sa SLIR_RA, _SLIRCLR_, _PLR_, _PFR_, _PLTR_, _PAR_ + @sa getVLTR(), getSLIR(), setSLIRCLR(), getPLR(), getPFR(), getPLTR(), getPAR() +*/ +#define _VLTR_ (_W6300_IO_BASE_ + (0x41D8 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief RA Prefered Life Time Register address [RO][0x00000000] + @details @ref _PLTR_ is set when RA packet is received from a router. + @sa SLIR_RA, _SLIRCLR_, _PLR_, _PFR_, _PLTR_, _PAR_ + @sa getPLTR(), getSLIR(), setSLIRCLR(), getPLR(), getPFR(), getVLTR(), getPAR() +*/ +#define _PLTR_ (_W6300_IO_BASE_ + (0x41DC << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief RA Prefix Address Register address[RO][::] + @details @ref _PAR_ is set when RA packet is received from a router. + @sa SLIR_RA, _SLIRCLR_, _PLR_, _PFR_, _VLTR_, _PLTR_, _PAR_ + @sa getPAR(), getPLTR(), getSLIR(), setSLIRCLR(), getPLR(), getPFR(), getVLTR() +*/ +#define _PAR_ (_W6300_IO_BASE_ + (0x41E0 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief ICMPv6 Block Register address [R=W][0x00] + @details @ref _ICMP6BLKR_ can block ICMPv6 message such like as PING, MLD, RA, NS and NA.\n + In this blocked case, @ref Sn_MR_IPRAW6 SOCKET can receive it. + + + +
    7 ~ 5 4 3 2 1 0
    7 ~ 5 PING6 MLD RA NA NS
    + - @ref ICMP6BLKR_PING6 : The same as @ref NETxMR_PB + - @ref ICMP6BLKR_MLD + - @ref ICMP6BLKR_RA + - @ref ICMP6BLKR_NA + - @ref ICMP6BLKR_NS + + @note The blocked message can be accepted by SOCKETn opened with @ref Sn_MR_IPRAW6. + @sa NETxMR_PB + @sa getICMP6BLKR(), setICMP6BLKR(), getNET6MR(), setNET6MR() +*/ +#define _ICMP6BLKR_ (_W6300_IO_BASE_ + (0x41F0 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief Chip configuration Lock Register address [WO][0x00] + @details @ref _CHPLCKR_ can lock or unlock to access @ref _SYCR0_ and @ref _SYCR1_.\n + The lock state can be checked from @ref SYSR_CHPL. + @sa _SYCR0_, _SYCR1_, _SYSR_, SYSR_CHPL + @sa getCHPLCKR(), setCHPLCKR(), CHIPLOCK(), CHIPUNLOCK(), getSYSR() +*/ +#define _CHPLCKR_ (_W6300_IO_BASE_ + (0x41F4 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief Network configuration Lock Register address [WO][0x00] + @details @ref _NETLCKR_ can lock or unlock to access the network information register such as @ref _SIPR_, @ref _LLAR_, and etc.\n + The lock state can be checked from @ SYSR_NETL. + @sa _SHAR_, _SIPR_, _SUBR_, _GAR_, _LLAR_, _GUAR_, _SUB6R_, _SYSR_, SYSR_NETL + @sa getNETLCKR(), setNETLCKR(), NETLOCK(), NETUNLOCK(), getSHAR(), setSHAR(), getSIPR(), getSIPR(), getSUBR(), setSUBR(), \n + getGAR(), setGAR(), getLLAR(), setLLAR(), getGUAR(), setGUAR(), getSUB6R(), setSUB6R(), getSYSR() +*/ +#define _NETLCKR_ (_W6300_IO_BASE_ + (0x41F5 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief PHY configuration Lock Register address [WO][0x00] + @details @ref _PHYLCKR_ can lock or unlock to access @ref _PHYCR0_ and @ref _PHYCR1_.\n + The lock state can be checked from @ref SYSR_PHYL. + @sa _PHYCR0_, _PHYCR1_, _SYSR_, SYSR_PHYL. + @sa getPHYLCKR(), setPHYLCKR(), PHYLOCK(), PHYUNLOCK(), setPHYCR0(), getPHYCR1(), setPHYCR1(), getSYSR() +*/ +#define _PHYLCKR_ (_W6300_IO_BASE_ + (0x41F6 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief Retransmission Time Register address [R=W][0x07D0] + @details @ref _RTR_ sets the default timeout value of @ref _Sn_RTR_.\n + When @ref _Sn_RTR_ is 0, @ref _Sn_RTR_ is reset to @ref _RTR_ after @ref Sn_CR_OPEN. + @sa _Sn_RTR_, _RCR_, _Sn_RCR_, _Sn_CR_, Sn_CR_OPEN, _Sn_IR_, _Sn_IRCLR_, Sn_IR_TIMEOUT + @sa getRTR(), setRTR(), getSn_RTR(), setSn_RTR(), getRCR(), setRCR(), getSn_RCR(), setSn_RCR(), \n + getSn_CR(), getSn_CR(), getSn_IR(), setSn_IRCLR() +*/ +#define _RTR_ (_W6300_IO_BASE_ + (0x4200 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief Retransmission Counter Register address [R=W][0x08] + @details @ref _RCR_ sets the default retransmission count of @ref _Sn_RCR_.\n + When @ref _Sn_RCR_ is 0, @ref _Sn_RCR_ is initialized as @ref _Sn_RTR_ after @ref Sn_CR_OPEN. + @sa _Sn_RCR_, _RTR_, _Sn_RTR_, _Sn_CR_, Sn_CR_OPEN, _Sn_IR_, _Sn_IRCLR_, Sn_IR_TIMEOUT + @sa getRCR(), setRCR(), getSn_RCR(), setSn_RCR(), getRTR(), setRTR(), getSn_RTR(), setSn_RTR(), \n + getSn_CR(), getSn_CR(), getSn_IR(), setSn_IRCLR() +*/ +#define _RCR_ (_W6300_IO_BASE_ + (0x4204 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief SOCKET-less Retransmission Time Register address [R=W][0x07D0] + @details @ref _SLRTR_ sets the timeout value of packet to be retransmitted by @ref _SLCR_. + @sa _SLRCR_, _SLIR_, _SLIRCLR_, SLIR_TOUT + @sa getSLRTR(), setSLRTR(), getSLRCR(), setSLRCR(), getSLIR(), setSLIRCLR() +*/ +#define _SLRTR_ (_W6300_IO_BASE_ + (0x4208 << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief SOCKET-less Retransmission Count Register address [R=W][0x00] + @details @ref _SLRCR_ sets the retry counter of packet to be retransmitted by @ref _SLCR_. + @sa _SLRTR_, _SLIR_, _SLIRCLR_, SLIR_TOUT + @sa getSLRCR(), setSLRCR(), getSLRTR(), setSLRTR(), setSLIRCLR(), getSLIR(), setSLIRCLR(), +*/ +#define _SLRCR_ (_W6300_IO_BASE_ + (0x420C << 8) + WIZCHIP_CREG_BLOCK) + +/** + @brief SOCKET-less Hop Limit Register address [R=W][0x80] + @details @ref _SLHOPR_ sets the hop limit value of packet to be transmitted by @ref _SLCR_. + @sa _SLCR_ + @sa getSLHOPR(), setSLHOPR(), getSLCR(), setSLCR() +*/ +#define _SLHOPR_ (_W6300_IO_BASE_ + (0x420F << 8) + WIZCHIP_CREG_BLOCK) + +/** + @} +*/ + +//----------------------------- W6300 Socket Registers ----------------------------- +/** + @addtogroup Socket_register_group_W6300 + @{ +*/ +/** + @brief Socket Mode Register Address [R=W][0x00] + @details @ref _Sn_MR_ sets the option or protocol type of SOCKETn before @ref Sn_CR_OPEN is performed.\n\n + Each bit of @ref _Sn_MR_ is defined as the following. + + + +
    7 6 5 4 3 ~ 0
    MULTI/MF BRDB/FPSH ND/MC/SMB/MMB UNIB/MMB6 P[3:0]
    + - @ref Sn_MR_MULTI : Support UDP Multicasting + - @ref Sn_MR_MF : Support MAC Filter Enable + - @ref Sn_MR_BRDB : Broadcast Block + - @ref Sn_MR_FPSH : Force PSH flag + - @ref Sn_MR_ND : No Delay ACK flag + - @ref Sn_MR_MC : IGMP ver2, ver1 + - @ref Sn_MR_SMB : Solicited Multicast Block + - @ref Sn_MR_MMB : IPv4 Multicast block + - @ref Sn_MR_UNIB : Unicast Block + - @ref Sn_MR_MMB6 : IPv6 UDP Multicast Block + - P[3:0] + + + + + + + + + + + + +
    P[3:0] Protocol Mode
    0000 SOCKET Closed
    0001 TCP4
    0010 UDP4
    0011 IPRAW4
    0100
    MACRAW
    1001 TCP6
    1010 UDP6
    1100 IPRAW6
    1101 TCP Dual(TCPD)
    1110 UDP Dual (UDPD)
    + - @ref Sn_MR_CLOSE : SOCKET Closed + - @ref Sn_MR_TCP4(= @ref Sn_MR_TCP) : TCP4 mode + - @ref Sn_MR_UDP4(= @ref Sn_MR_UDP) : UDP4 mode + - @ref Sn_MR_IPRAW4(= @ref Sn_MR_IPRAW) : IPRAW4 mode + - @ref Sn_MR_MACRAW : MACRAW mode + - @ref Sn_MR_TCP6 : TCP6 mode + - @ref Sn_MR_UDP6 : UDP6 mode + - @ref Sn_MR_IPRAW6 : IPRAW6 mode + - @ref Sn_MR_TCPD : TCP Dual (TCPD) mode + - @ref Sn_MR_UDPD : UDP Dual (UDPD) mode + + @note MACRAW mode should be only used in Socket 0. + @sa _Sn_CR_, Sn_CR_OPEN, _Sn_SR_, _Sn_MR2_ + @sa getSn_MR(), setSn_MR(), getSn_CR(), setSn_CR(), getSn_SR(), getSn_MR2(), setSn_MR2() +*/ +#define _Sn_MR_(N) (_W6300_IO_BASE_ + (0x0000 << 8) + WIZCHIP_SREG_BLOCK(N)) + +/** + @brief SOCKET n Prefer Source IPv6 Address Register Address [R=W][0x00] + @details @ref _Sn_PSR_ select the Source IPv6 Address to transmit a packet by @ref _Sn_CR_. + This function is same as @ref _SLPSR_. + - @ref PSR_AUTO + - @ref PSR_LLA + - @ref PSR_GUA + @sa _Sn_CR_, _Sn_PSR_, _SLPSR_ + @sa getSn_PSR(), setSn_PSR(), getSLCR(), setSLCR(), getSLPSR(), setSLPSR(), +*/ +#define _Sn_PSR_(N) (_W6300_IO_BASE_ + (0x0004 << 8) + WIZCHIP_SREG_BLOCK(N)) + +/** + @brief Socket Command Register Address [RW,AC][0x00] + @details @ref _Sn_CR_ is used to set the command for SOCKET n such as OPEN, CLOSE, CONNECT, LISTEN, SEND, and RECEIVE.\n + It is automatically cleared to 0x00 after the command is recognized by @ref _WIZCHIP_.\n + Even though @ref _Sn_CR_ is cleared to 0x00, the command is still being processed.\n + To check whether the command is completed or not, please check the @ref _Sn_IR_ or @ref _Sn_SR_. + - @ref Sn_CR_OPEN : Initialize or open socket. + - @ref Sn_CR_LISTEN : Wait connection request on TCP4/TCP6/TCPD mode(Server mode) + - @ref Sn_CR_CONNECT : Send connection request on TCP4/TCPD mode(Client mode) + - @ref Sn_CR_CONNECT6 : Send connection request on TCP6/TCPD mode(Client mode):nohl + - @ref Sn_CR_DISCON : Send closing request on TCP/TCP6/TCPD mode. + - @ref Sn_CR_CLOSE : Close socket. + - @ref Sn_CR_SEND : Update TX buffer pointer and send data in IPv4 socket. + - @ref Sn_CR_SEND6 : Update TX buffer pointer and send data in IPv6 socket. + - @ref Sn_CR_SEND_KEEP : Send keep alive message. + - @ref Sn_CR_RECV : Update RX buffer pointer and receive data. + + @note These commands should be exclusive executed.\n That is, the other command can not executed when one command is not cleared yet. + @sa _Sn_IR_, _Sn_IRCLR_, Sn_IMR_, _SIR_, _Sn_SR_ + @sa getSn_CR(), setSn_CR(), getSn_IR(), setSn_IRCLR(), getSn_IMR(), setSn_IMR(), getSIR(), getSn_SR() +*/ +#define _Sn_CR_(N) (_W6300_IO_BASE_ + (0x0010 << 8) + WIZCHIP_SREG_BLOCK(N)) + +/** + @brief SOCKETn Interrupt Register Address [RO][0x00] + @details @ref _Sn_IR_ gets the status of SOCKETn interrupt such as establishment, termination, receiving data, timeout.\n + If SOCKETn interrupt occurs and the n-th bit of @ref _SIMR_ is set, then @ref SIR_INT(n) is set.\n + In order to clear the @ref _Sn_IR_ bit, Set the corresponding bit of _Sn_IRCLR_ to 1.\n + If all @ref _Sn_IR_ bits are cleared, the @ref SIR_INT(n) is automatically cleared. + + + +
    7 ~ 5 4 3 2 1 0
    Reserved SENDOK TIMEOUT RECV DISCON CON
    + - @ref Sn_IR_SENDOK + - @ref Sn_IR_TIMEOUT + - @ref Sn_IR_RECV + - @ref Sn_IR_DISCON + - @ref Sn_IR_CON + + @sa _Sn_IRCLR_, _Sn_IMR_, _SIR_, _SIMR_ + @sa getSn_IR(), setSn_IRCLR(), getSn_IMR(), setSn_IMR(), getSIR(), getSIMR(), setSIMR() +*/ +#define _Sn_IR_(N) (_W6300_IO_BASE_ + (0x0020 << 8) + WIZCHIP_SREG_BLOCK(N)) + +/** + @brief SOCKETn Interrupt Mask Register Address [R=W][0xFF] + @details @ref _Sn_IMR_ is used to mask interrupts of @ref _Sn_IR_. + @sa _Sn_IR_, _Sn_IRCR_, _SIR_, _SIMR_ + @sa getSn_IMR(), setSn_IMR(), getSn_IR(), setSn_IRCLR(), getSIR(), getSIMR(), setSIMR() +*/ +#define _Sn_IMR_(N) (_W6300_IO_BASE_ + (0x0024 << 8) + WIZCHIP_SREG_BLOCK(N)) + +/** + @brief SOCKETn Interrupt Clear Register Address [WO][0x00] + @details @ref _Sn_IRCLR_ clears @ref _Sn_IR_ + @sa _Sn_IR_, _SIR_, _SIMR_ + @sa setSn_IRCLR(), getSn_IR(), getSIR(), getSIMR(), setSIMR() +*/ +#define _Sn_IRCLR_(N) (_W6300_IO_BASE_ + (0x0028 << 8) + WIZCHIP_SREG_BLOCK(N)) + + + +/** + @brief SOCKETn Status Register Address [RO][0x00] + @details @ref _Sn_SR_ indicates the status of SOCKETn.\n + The status of SOCKETn can be changed by @ref _Sn_CR_, some TCP packets such as SYN, FIN, RST packet, or @ref Sn_IR_TIMEOUT. + - Normal status + - @ref SOCK_CLOSED : Closed + - @ref SOCK_INIT : Initiate state + - @ref SOCK_LISTEN : Listen state + - @ref SOCK_ESTABLISHED : Success to connect + - @ref SOCK_CLOSE_WAIT : Closing state + - @ref SOCK_UDP : UDP socket + - @ref SOCK_IPRAW : IPRAW socket + - @ref SOCK_IPRAW6 : IPv6 IPRAW socket + - @ref SOCK_MACRAW : MAC raw mode socket + - Temporary status during changing the status of SOCKETn . + - @ref SOCK_SYNSENT : This indicates SOCKETn sent the connect-request packet (SYN packet) to a peer. + - @ref SOCK_SYNRECV : It indicates SOCKETn successfully received the connect-request packet (SYN packet) from a peer. + - @ref SOCK_FIN_WAIT : Connection state + - @ref SOCK_TIME_WAIT : Closing state + - @ref SOCK_LAST_ACK : Closing state + + @sa _Sn_CR_, _Sn_IR_, _Sn_IRCLR_, Sn_IR_TIMEOUT + @sa getSn_SR(), getSn_CR(), setSn_CR(), getSn_IR(), setSn_IRCLR() + + + +
    @image html SocketStatus.png ""
    + +*/ +#define _Sn_SR_(N) (_W6300_IO_BASE_ + (0x0030 << 8) + WIZCHIP_SREG_BLOCK(N)) + +/** + @brief SOCKETn Extension Status Register Address [RO][0x00] + @details @ref _Sn_ESR_ indicates the connected client IP address information such as IP version, IPv6 address type(LLA or GUA), \n + and TCP operation mode such as TCP SERVER and TCP CLIENT + + + +
    7 ~ 3 2 1 0
    Reserved TCPM TCPOP IP6T
    + - @ref Sn_ESR_TCPM : @ref Sn_ESR_TCPM_IPV4, @ref Sn_ESR_TCPM_IPV6 + - @ref Sn_ESR_TCPOP : @ref Sn_ESR_TCPOP_SVR, @ref Sn_ESR_TCPOP_CLT + - @ref Sn_ESR_IP6T : @ref Sn_ESR_IP6T_LLA, @ref Sn_ESR_IP6T_GUA + + @note It is valid only on TCP mode such as @ref Sn_MR_TCP4, @ref Sn_MR_TCP6, and @ref Sn_MR_TCPD. + @sa _Sn_MR_, _Sn_PSR_ + @sa getSn_ESR(), getSn_MR(), setSn_MR(), getSn_PSR(), setSn_PSR() +*/ +#define _Sn_ESR_(N) (_W6300_IO_BASE_ + (0x0031 << 8) + WIZCHIP_SREG_BLOCK(N)) + +/** + @brief SOCKETn IP Protocol Number(PN) Register Address [R/W][0x0000] + @details \ref _Sn_PNR_ that sets the protocol number/next header field of the IPv4/IPv6 header at the IP layer. + @note It is valid only in IPRAW mode such as @ref Sn_MR_IPRAW4 and @ref Sn_MR_IPRAW6. + @note It is set before @ref Sn_CR_OPEN is performed. + @sa _Sn_NHR_, _Sn_MR_, Sn_CR_OPEN + @sa getSn_PNR(), setSn_PNR(), getSn_NHR(), setSn_NHR(), getSn_MR(), setSn_MR(), getSn_CR(), setSn_CR() +*/ +#define _Sn_PNR_(N) (_W6300_IO_BASE_ + (0x0100 << 8) + WIZCHIP_SREG_BLOCK(N)) +#define _Sn_NHR_(N) (_Sn_PNR_(N)) ///< Refer to @ref _Sn_PNR_. + +/** + @brief SOCKETn IPv4 Type of Service(TOS) Register Address [R=W][0x00] + @details @ref _Sn_TOSR_ sets the TOS(Type Of Service) field in IPv4 Header. + @sa getSn_TOSR(), setSn_TOSR() +*/ +#define _Sn_TOSR_(N) (_W6300_IO_BASE_ + (0x0104 << 8) + WIZCHIP_SREG_BLOCK(N)) + +/** + @brief SOCKETn IP Time to live(TTL) Register Address [R=W][0x80] + @details @ref _Sn_TTLR_ sets the TTL(Time To Live)/HOP(Hop Limit) field in IPv4/IPv6 header at the IP layer. + @sa _Sn_HOPR_ + @sa getSn_TTLR(), setSn_TTLR(), getSn_HOPR(), setSn_HOPR() +*/ +#define _Sn_TTLR_(N) (_W6300_IO_BASE_ + (0x0108 << 8) + WIZCHIP_SREG_BLOCK(N)) +#define _Sn_HOPR_(N) (_Sn_TTLR_(N)) ///< Refer to @ref _Sn_TTLR_. + +/** + @brief SOCKETn Fragment Register Address [R=W][0x4000] + @details @ref _Sn_FRGR_ sets the fragment flag & offset in IPv4 header. + @note @ref _WIZCHIP_ can not support IP fragment & re-assembly.\n So It is not recommended to set @ref _Sn_FRGR_ to any other value. + @sa getSn_FRGR(), setSn_FRGR() +*/ +#define _Sn_FRGR_(N) (_W6300_IO_BASE_ + (0x010C << 8) + WIZCHIP_SREG_BLOCK(N)) + +/** + @brief SOCKETn Maximum Segment Size(MSS) Register Address [RW][0x0000] + @details @ref _Sn_MSSR_ sets or gets the MTU(Maximum Transfer Unit) of SOCKETn. \n + The MTU of each protocol is as following. + + + + + + + + + +
    @ref _Sn_MR_[3:0] @ref NETMR2_PPPoE = 0 @ref NETMR2_PPPoE = '1'
    @ref Sn_MR_TCP4 1 ~ 1460 1 ~ 1452
    @ref Sn_MR_TCP6 1 ~ 1440 1 ~ 1432
    @ref Sn_MR_UDP4 1 ~ 1472 1 ~ 1464
    @ref Sn_MR_UDP6 1 ~ 1452 1 ~ 1444
    @ref Sn_MR_IPRAW4 1 ~ 1480 1 ~ 1472
    @ref Sn_MR_IPRAW6 1 ~ 1460 1 ~ 1452
    @ref Sn_MR_MACRAW 1 ~ 1514
    + + @note It is not set exceeding the MTU for each protocol of SOCKETn even if _Sn_MSSR_ is set over the MTU. + @sa _Sn_MR_, NETMR2_PPPoE + @sa getSn_MSSR(), setSn_MSSR(), getSn_MR(), setSn_MR(), getNETMR2(), setNETMR2() +*/ +#define _Sn_MSSR_(N) (_W6300_IO_BASE_ + (0x0110 << 8) + WIZCHIP_SREG_BLOCK(N)) + +/** + @brief SOCKETn Source Port Register Address [R=W][0x0000] + @details @ref _Sn_PORTR_ sets the source port number of SOCKETn . + @note It is valid in TCP(@ref Sn_MR_TCP4, @ref Sn_MR_TCP6, @ref Sn_MR_TCPD) and UDP(@ref Sn_MR_UDP4, @ref Sn_MR_UDP6, @ref Sn_MR_UDPD) mode. + @note It should be set before @ref Sn_CR_OPEN is performed. + @sa _Sn_MR_, Sn_CR_OPEN + @sa getSn_PORTR(), getSn_PORTR(), getSn_MR(), setSn_MR(), getSn_CR(), setSn_CR() +*/ +#define _Sn_PORTR_(N) (_W6300_IO_BASE_ + (0x0114 << 8) + WIZCHIP_SREG_BLOCK(N)) + +/** + @brief SOCKETn Destination Hardware Address Register Address [RW][00:00:00:00:00:00] + @details @ref _Sn_DHAR_ sets or gets the destination hardware address of SOCKETn.\n + - When @ref Sn_MR2_DHAM = 1 and @ref _Sn_MR_[3:0] != @ref Sn_MR_MACRAW + The destination hardware address is set by @ref _Sn_DHAR_ without ARP processed by @ref Sn_CR_CONNECT, @ref Sn_CR_CONNECT6, @ref Sn_CR_SEND, and @ref Sn_CR_SEND6.\n + Also, when SOCKETn is opened with @ref Sn_MR_UDP4 or @ref Sn_MR_UDP6 and @ref Sn_MR_MULTI is set, @ref _Sn_DHAR_ sets the Multicast Group Hardware address. + - Others + In TCP mode such as @ref Sn_MR_TCP4, @ref Sn_MR_TCP6, and @ref Sn_MR_TCPD, \n + @ref _Sn_DHAR_ gets the destination hardware address when @ref _Sn_SR_ is @ref SOCK_ESTABLISHED. + @sa _Sn_MR_, _Sn_MR2_, _Sn_CR_, _Sn_SR_ + @sa getSn_DHAR(), setSn_DHAR(), getSn_MR(), setSn_MR(), getSn_MR2(), setSn_MR2(), getSn_CR(), setSn_CR(), getSn_SR() +*/ +#define _Sn_DHAR_(N) (_W6300_IO_BASE_ + (0x0118 << 8) + WIZCHIP_SREG_BLOCK(N)) + +/** + @brief SOCKETn Destination IPv4 Address Register Address [RW][0.0.0.0] + @details @ref _Sn_DIPR_(= @ref _Sn_DIP4R_) sets or gets the destination IPv4 address of SOCKETn. \n + - In TCP mode such as @ref Sn_MR_TCP4, and @ref Sn_MR_TCPD + - TCP CLIENT mode : It sets the IPv4 address of TCP SERVER before @ref Sn_CR_CONNECT is performed. + - TCP SERVER mode : It gets the IPv4 address of TCP CLIENT when @ref _Sn_SR_ is @ref SOCK_ESTABLISHED. + - In UDP(@ref Sn_MR_UDP4, @ref Sn_MR_UDPD) mode & IPRAW4(@ref Sn_MR_IPRAW4) mode + It sets the destination IPv4 address before @ref Sn_CR_SEND is performed. \n + When Sn_MR_MULTI = 1, It sets the multicast group IPv4 address. + @sa _Sn_DIP4R_, _Sn_MR_, _Sn_CR_, _Sn_SR_ + @sa getSn_DIPR(), getSn_DIPR(), getSn_DIP4R(), getSn_DIP4R(), getSn_MR(), setSn_MR(), getSn_CR(), setSn_CR(), getSn_SR() +*/ +#define _Sn_DIPR_(N) (_W6300_IO_BASE_ + (0x0120 << 8) + WIZCHIP_SREG_BLOCK(N)) +#define _Sn_DIP4R_(N) (_Sn_DIPR_(N)) ///< Refer to @ref _Sn_DIPR_. + +/** + @brief SOCKETn Destination IPv6 Address Register Address [RW][::] + @details @ref _Sn_DIP6R_ sets or gets the destination IPv6 address of SOCKETn. + - In TCP mode such as @ref Sn_MR_TCP6, and @ref Sn_MR_TCPD + - TCP CLIENT mode : It sets the IPv6 address of TCP SERVER before @ref Sn_CR_CONNECT6 is performed. + - TCP SERVER mode : It gets the IPv6 address of TCP CLIENT when @ref _Sn_SR_ is @ref SOCK_ESTABLISHED. + - In UDP(@ref Sn_MR_UDP6, @ref Sn_MR_UDPD) mode & IPRAW4(@ref Sn_MR_IPRAW6) mode + It sets the destination IPv6 address before @ref Sn_CR_SEND6 is performed.\n + When Sn_MR_MULTI = 1, It sets the multicast group IPv6 address. + @sa _Sn_MR_, _Sn_CR_, _Sn_SR_ + @sa getSn_DIP6R(), setSn_DIP6R(), getSn_MR(), setSn_MR(), getSn_CR(), setSn_CR(), getSn_SR() +*/ +#define _Sn_DIP6R_(N) (_W6300_IO_BASE_ + (0x0130 << 8) + WIZCHIP_SREG_BLOCK(N)) + +/** + @brief SOCKETn Destination Port Register Address [RW][0x0000] + @details @ref _Sn_DPORTR_ sets or gets the destination port number of SOCKETn. + - In TCP mode such as @ref Sn_MR_TCP4, @ref Sn_MR_TCP6, and @ref Sn_MR_TCPD + - TCP CLIENT mode : It sets the port number of TCP SERVER before @ref Sn_CR_CONNECT is performed. + - TCP SERVER mode : It gets the port number of TCP CLIENT when @ref _Sn_SR_ is @ref SOCK_ESTABLISHED. + - In UDP mode such as @ref Sn_MR_UDP4, @ref Sn_MR_UDP6, and @ref Sn_MR_UDPD + It sets the destination port number before @ref Sn_CR_SEND is performed. \n + When Sn_MR_MULTI = 1, It sets the multicast group group port number. + + @note It is valid SOCKETn is opened with @ref Sn_MR_TCP4, @ref Sn_MR_TCP6, @ref Sn_MR_TCPD, @ref Sn_MR_UDP4, @ref Sn_MR_UDP4, and @ref Sn_MR_UDPD. + @note It should be set before OPEN command is ordered. + @sa _Sn_MR_, _Sn_CR_, _Sn_SR_ + @sa getSn_DPORTR(), getSn_DPORTR(), getSn_MR(), setSn_MR(), getSn_CR(), setSn_CR(), getSn_SR() +*/ +#define _Sn_DPORTR_(N) (_W6300_IO_BASE_ + (0x0140 << 8) + WIZCHIP_SREG_BLOCK(N)) + +/** + @brief SOCKETn Mode Register 2 Address [R=W][0x00] + @details @ref _Sn_MR2_ sets the option of SOCKETn with @ref _Sn_MR_, before @ref Sn_CR_OPEN is performed.\n + Each bit of @ref _Sn_MR2_ is defined as the following. + + + +
    7 ~ 2 1 0
    Reserved DHAM FARP
    + - @ref Sn_MR2_DHAM : @ref Sn_MR2_DHAM_AUTO, @ref Sn_MR2_DHAM_MANUAL + - @ref Sn_MR2_FARP + @sa _Sn_MR_, _Sn_CR_ + @sa getSn_MR2(), setSn_MR2(), getSn_MR(), getSn_MR(), getSn_CR() +*/ +#define _Sn_MR2_(N) (_W6300_IO_BASE_ + (0x0144 << 8) + WIZCHIP_SREG_BLOCK(N)) + + +/** + @brief SOCKETn Retransmission Time Register Address [R=W][0x0000] + @details @ref _Sn_RTR_ sets the timeout value of packet to be retransmitted by @ref _SLCR_.\n + @note It should be set before @ref Sn_CR_OPEN is performed.\n + It is initialized as @ref _RTR_ if you do not set it to none-zero value. + @sa _RTR_, _Sn_CR_ + @sa getSn_RTR(), setSn_RTR(), getSn_CR(), setSn_CR() +*/ +#define _Sn_RTR_(N) (_W6300_IO_BASE_ + (0x0180 << 8) + WIZCHIP_SREG_BLOCK(N)) + +/** + @brief SOCKETn Retransmission Count Register Address [R=W][0x00] + @details @ref _Sn_RCR_ sets the retry count value of packet to be retransmitted by @ref _SLCR_.\n + @note It should be set before @ref Sn_CR_OPEN is performed.\n + It is initialized as @ref _RTR_ if you do not set it to any none-zero value. + @sa _RTR_, _Sn_CR_ + @sa getSn_RTR(), setSn_RTR(), getSn_CR(), setSn_CR() +*/ +#define _Sn_RCR_(N) (_W6300_IO_BASE_ + (0x0184 << 8) + WIZCHIP_SREG_BLOCK(N)) + +/** + @brief SOCKETn Keep Alive Time Register Address [R=W][0x00] + @details @ref _Sn_KPALVTR_ sets the auto-retransmission time of KA(Keep Alive) packet. \n + If the destination can not respond to the KA packet during the time set by @ref _Sn_KPALVTR_,\n + the connection is terminated, @ref Sn_IR_TIMEOUT is set and then @ref _Sn_SR_ is changed @ref SOCK_CLOSED.\n + Before the time is expierd, if the destination sends a KA/ACK packet or any packet, the connection is still valid,\n + @ref _Sn_SR_ remained at @ref SOCK_ESTABLISHED. + @note It is valid only after sending data over 1 byte in TCP mode such as @ref Sn_MR_TCP4, @ref Sn_MR_TCP6, and @ref Sn_MR_TCPD. + @note If it is set to 0, KA packet can be sent by @ref Sn_CR_SEND_KEEP. + @sa Sn_CR_SEND_KEEP, Sn_IR_TIMEOUT, Sn_IRCLR, Sn_SR, Sn_MR + @sa getSn_KPALVTR(), setSn_KPALVTR(), getSn_IR(), setSn_IRCLR(), getSn_SR(), getSn_MR(), setSn_MR() +*/ +#define _Sn_KPALVTR_(N) (_W6300_IO_BASE_ + (0x0188 << 8) + WIZCHIP_SREG_BLOCK(N)) + +/** + @brief SOCKETn TX Buffer Size Register Address [R=W][0x02] + @details @ref _Sn_TX_BSR_ sets the TX buffer size of SOCKETn in the 16KB TX memory.\n + It can be set only with 0,1,2,4,8, and 16K bytes. + @note The 16KB TX memory is allocated as many as @ref _Sn_TX_BSR_ sequentially from SOCKET0 to SOCKETn(Here, 0 <= n <= @ref _WIZCHIP_SOCK_NUM_ - 1).\n + The total sum of Sn_TX_BSR can not be exceed 16KB of TX memory. \n + If the total size is exceeded, SOCKETn can't be normally sent data to a destination. + @sa _Sn_RX_BSR_ + @sa getSn_TX_BSR(), setSn_TX_BSR(), getSn_TXBUF_SIZE(), setSn_TXBUF_SIZE(), getSn_TxMAX(), setSn_TX_BSR(), getSn_RX_BSR(), setSn_RX_BSR() +*/ +#define _Sn_TX_BSR_(N) (_W6300_IO_BASE_ + (0x0200 << 8) + WIZCHIP_SREG_BLOCK(N)) + +/** + @brief SOCKETn TX Free Buffer Size Register Address [RO][0x0800] + @details @ref _Sn_TX_FSR_ gets the transmittable free size of SOCKETn TX buffer. + @note Data should not be saved bigger than it because the data overwrites the previous saved data not to be sent yet.\n + Therefore, Check it before saving the data to the SOCKETn TX buffer. \n + If the data size is equal or smaller than it, transmit the data with @ref Sn_CR_SEND / @ref Sn_CR_SEND6 after saving the data in SOCKETn TX buffer.\n + If the data size is greater than it, transmit the data after dividing into it and saving in the SOCKETn TX buffer. + @note \n + - In TCP mode such as @ref Sn_MR_TCP4, @ref Sn_MR_TCP6 and @ref Sn_MR_TCPD, \n + It is automatically increased by the absolute difference between @ref _Sn_TX_WR_ and interanl TX ACK pointer. + - In other mode \n + It is automatically increased by the absolute difference between @ref _Sn_TX_WR_ and @ref _Sn_TX_RD_. + @sa _Sn_RX_RSR_, _Sn_TX_WR_, _Sn_TX_RD_, _Sn_CR_ + @sa getSn_TX_FSR(), getSn_TX_WR(), getSn_TX_WR(), getSn_TX_RD(), getSn_CR(), setSn_CR() +*/ +#define _Sn_TX_FSR_(N) (_W6300_IO_BASE_ + (0x0204 << 8) + WIZCHIP_SREG_BLOCK(N)) + +/** + @brief SOCKET TX Memory Read Pointer Register Address[R][0x0000] + @details @ref _Sn_TX_RD_ gets the start pointer of data to be sent by @ref Sn_CR_SEND. \n + @ref Sn_CR_SEND / @ref Sn_CR_SEND6 starts to transmit the saved data from @ref _Sn_TX_RD_ to @ref _Sn_TX_WR_ in the SOCKETn TX Buffer,\n + and when @ref Sn_IR_SENDOK is set, It is automatically increased to equal @ref _Sn_TX_WR_. + @note It is initialized by @ref Sn_CR_OPEN, But, In TCP mode such as @ref Sn_MR_TCP4, @ref Sn_MR_TCP6, and @ref Sn_MR_TCPD,\n + it is re-initialized when the TCP connection is completed. + @note If it exceeds the maximum value 0xFFFF, (that is, it is greater than 0x10000 and the carry bit occurs),\n + then the carry bit is ignored and it automatically is updated with its the lower 16bits value. + @sa _Sn_TX_WR_, _Sn_TX_FSR_, _Sn_CR_, _Sn_IR_, _Sn_IRCLR_, _Sn_MR_ + @sa getSn_TX_RD(), getSn_TX_WR(), setSn_TX_WR(), getSn_TX_FSR(), getSn_CR(), setSn_CR(), getSn_IR(), setSn_IRCLR(), getSn_MR(), setSn_MR() +*/ +#define _Sn_TX_RD_(N) (_W6300_IO_BASE_ + (0x0208 << 8) + WIZCHIP_SREG_BLOCK(N)) + + +/** + @brief SOCKETn TX Memory Write Pointer Register Address [RW][0x0000] + @details @ref _Sn_TX_WR_ gets the start pointer of data to be saved in the SOCKETn TX buffer, \n + or sets the end pointer of data to be sent by @ref Sn_CR_SEND. \n + If you have completed to save the data to be sent in the SOCKETn TX buffer, + increase it as many as the saved size of data before @ref Sn_CR_SEND is performed.\n + @ref Sn_CR_SEND starts to transmit the saved data from @ref _Sn_TX_RD_ to @ref _Sn_TX_WR_ in the SOCKETn TX Buffer, \n + and when @ref Sn_IR_SENDOK is set, @ref _Sn_TX_RD_ is automatically increased to equal it. + @note It is initialized by @ref Sn_CR_OPEN.\n + But, In TCP mode such as @ref Sn_MR_TCP4, @ref Sn_MR_TCP6, and @ref Sn_MR_TCPD,\n + it is re-initialized when the TCP connection is completed. + @note The size of data to be saved can't exceed @ref _Sn_TX_FSR_. + @note If it exceeds the maximum value 0xFFFF(that is, it is greater than 0x10000 and the carry bit occurs),\n + then ignore the carry bit and update it with its lower 16bits value. + @sa _Sn_TX_RD_, _Sn_TX_FSR_, _Sn_CR_, _Sn_IR_, _Sn_IRCLR_, _Sn_MR_ + @sa getSn_TX_WR(), setSn_TX_WR(), getSn_TX_RD(), getSn_TX_FSR(), getSn_CR(), setSn_CR(), getSn_IR(), setSn_IRCLR(), getSn_MR(), setSn_MR() +*/ +#define _Sn_TX_WR_(N) (_W6300_IO_BASE_ + (0x020C << 8) + WIZCHIP_SREG_BLOCK(N)) + +/** + @brief SOCKETn RX Buffer Size Register Address [R=W][0x02] + @details @ref _Sn_RX_BSR_ sets the RX buffer size of SOCKETn in the 16KB RX memory.\n + It can be set only with 0,1,2,4,8, and 16K bytes. + @note The 16KB RX memory is allocated as many as @ref _Sn_RX_BSR_ sequentially from SOCKET0 to SOCKETn(Here, 0 <= n <= @ref _WIZCHIP_SOCK_NUM_ - 1).\n + The total sum of @ref _Sn_RX_BSR_ can not be exceed 16KB of RX memory. \n + If the total size is exceeded, SOCKETn can't be normally received data from a destination. + @sa _Sn_RX_BSR_ + @sa getSn_TX_BSR(), setSn_TX_BSR(), getSn_RXBUF_SIZE(), setSn_RXBUF_SIZE(), getSn_RxMAX(), getSn_RX_BSR(), setSn_RX_BSR() +*/ +#define _Sn_RX_BSR_(N) (_W6300_IO_BASE_ + (0x0220 << 8) + WIZCHIP_SREG_BLOCK(N)) + +/** + @brief SOCKETn RX Received Size Register Address [RO][0x0000] + @details @ref _Sn_RX_RSR_ gets the received data size of SOCKETn RX buffer. + @note The real received data size maybe smaller than it, \n + because it maybe included the size of 'PACKET NFO' such like as \n + the destination IP address, destination port number and data size of the received DATA PACKET. + @note Do not read bigger data than @ref _Sn_RX_RSR_. + @note It is automatically increased by the absolute difference between @ref _Sn_RX_WR_ and @ref _Sn_RX_RD_ \n + after @ref Sn_CR_RECV is performed. + @sa _Sn_RX_RSR_, _Sn_TX_WR_, _Sn_TX_RD_, _Sn_CR_, _Sn_TX_FSR_ + @sa getSn_RX_RSR(), getSn_TX_WR(), getSn_TX_WR(), getSn_CR(), setSn_CR(), getSn_TX_FSR() +*/ +#define _Sn_RX_RSR_(N) (_W6300_IO_BASE_ + (0x0224 << 8) + WIZCHIP_SREG_BLOCK(N)) + +/** + @brief SOCKET RX Memory Read Pointer Register Address[R][0x0000] + @details @ref _Sn_RX_RD_ gets the start pointer of the received data in the SOCKETn RX buffer,\n + or sets the end data pointer of the read completed data by @ref Sn_CR_RECV. \n + You can read the received data from it to @ref _Sn_RX_WR_ in the SOCKET RX buffer.\n + After completing to read data, you should increase it as many as the read size before @ref Sn_CR_RECV is performed. + @note It is initialized by @ref Sn_CR_OPEN, But, In TCP mode such as @ref Sn_MR_TCP4, @ref Sn_MR_TCP6, and @ref Sn_MR_TCPD,\n + it is re-initialized when the TCP connection is completed. + @note If it exceeds the maximum value 0xFFFF, (that is, it is greater than 0x10000 and the carry bit occurs),\n + Ignore the carry bit and update with its the lower 16bits value. + @sa _Sn_RX_WR_, _Sn_RX_RSR_, _Sn_CR_, _Sn_IR_, _Sn_IRCLR_, _Sn_MR_ + @sa getSn_RX_WR(), setSn_RX_RD(), getSn_RX_WR(), getSn_TX_FSR(), getSn_CR(), setSn_CR(), getSn_IR(), setSn_IRCLR(), getSn_MR(), setSn_MR() +*/ +#define _Sn_RX_RD_(N) (_W6300_IO_BASE_ + (0x0228 << 8) + WIZCHIP_SREG_BLOCK(N)) + +/** + @brief SOCKETn TX Memory Write Pointer Register Address [RW][0x0000] + @details @ref _Sn_TX_WR_ gets the end pointer of the data that has been completely received in the SOCKETn RX buffer. \n + Whenever a data has been completely received from a destination, \n + It is automatically increased as many as the sum size of the received data and the 'PACKET INFO'. \n + You can read the recevied data from @ref _Sn_RX_RD_ to it in the SOCKET RX buffer. + @note It is initialized by @ref Sn_CR_OPEN. But, In TCP mode such as @ref Sn_MR_TCP4, @ref Sn_MR_TCP6, and @ref Sn_MR_TCPD,\n + it is re-initialized when the TCP connection is completed. + @note If it exceeds the maximum value 0xFFFF(that is, it is greater than 0x10000 and the carry bit occurs),\n + then ignore the carry bit and update it with its lower 16bits value. + @sa _Sn_TX_RD_, _Sn_TX_FSR_, _Sn_CR_, _Sn_IR_, Sn_IRCLR_, _Sn_MR_ + @sa getSn_TX_WR(), setSn_TX_WR(), getSn_TX_RD(), getSn_TX_FSR(), getSn_CR(), setSn_CR(), getSn_IR(), setSn_IRCLR(), getSn_MR(), setSn_MR() +*/ +#define _Sn_RX_WR_(N) (_W6300_IO_BASE_ + (0x022C << 8) + WIZCHIP_SREG_BLOCK(N)) + +/** + @} +*/ + +/*----------------------------- W6300 Register values -----------------------------*/ + +/* System Status Register Bit Definition */ +/** + @brief CHIP Lock staus bit of @ref _SYSR_. + @details @ref SYSR_CHPL indicates the lock status of @ref _SYCR0_ and @ref _SYCR1_.\n + 1 : Lock \n + 0 : unlock + @note It is set by only @ref _CHPLCKR_. + @sa _SYSR_, _CHPLCKR_, _SYCR0_, _SYCR1_ + @sa getSYSR(), getCHPLCKR(), setCHPLCKR(), CHIPLOCK(), CHIPUNLOCK(), setSYCR0(), setSYCR1() +*/ +#define SYSR_CHPL (1 << 7) + +/** + @brief NET Lock status bit of @ref _SYSR_. + @details @ref SYSR_NETL indicates the lock of network information registers such as + @ref _SHAR_, @ref _GAR_, @ref _SUBR_, @ref _SIPR_, @ref _LLAR_, @ref _GUAR_, and @ref _SUB6R_. \n + 1 : Lock \n + 0 : unlock + @note It is set by only @ref _NETLCKR_. + @note @ref _GA6R_ can be accessed regardless of @ref SYSR_NETL. + @sa _SYSR_, _NETLCKR_, _SHAR_, _GAR_, _SUBR_, _SIPR_, _LLAR_, _GUAR_, _SUB6R_ + @sa getSYSR(), getNETLCKR(), setNETLCKR(), NETLOCK(), NETUNLOCK(),\n + getSHAR(), setSHAR(), getGAR(), setGAR(), getSUBR(), getSIR(), setSIPR(), \n + getLLAR(), setLLAR(), getGUAR(),setGUAR(), getSUB6R(), setSUB6R() +*/ +#define SYSR_NETL (1 << 6) + +/** + @brief PHY Lock status bit of @ref _SYSR_. Refer to @ref _PHYLCKR_. + @details @ref SYSR_PHYL indicates the lock status of @ref _PHYCR0_ and _PHYCR1_.\n + 1 : Lock \n + 0 : unlock + @note It is set by only @ref _PHYLCKR_. + @sa _SYSR_, _PHYCLKR_, _PHYCR0_, _PHYCR1_ + @sa getSYSR(), getPHYLCKR(), setPHYLCKR(), setPHYCR0(), getPHYCR1(), setPHYCR1() +*/ +#define SYSR_PHYL (1 << 5) + +/** + @brief Parallel Bus Mode bit of @ref _SYSR_ + @details @ref SYSR_IND is set when @ref _WIZCHIP_ PIN MODE[3:0] == "010X". + It indicates to use the parallel BUS mode. + @sa _SYSR_, _WIZCHIP_IO_MODE_BUS_ + @sa getSYSR() +*/ +#define SYSR_IND (1 << 5) + +/** + @brief SPI I/F Mode bit of @ref _SYSR_. + @details @ref SYSR_SPI is set when @ref _WIZCHIP_ PIN MODE[3:0] == "000X". + It indicates to use the SPI mode. + @sa _SYSR_, _WIZCHIP_IO_MODE_SPI_ + @sa getSYSR() +*/ +#define SYSR_SPI (1 << 0) + + +/* System Config Register Bit Definition */ +/** + @brief RST bit of @ref _SYCR0_ + @details @ref SYCR0_RST resets to @ref _WIZCHIP_ softly. \n + 0 : Soft reset \n + 1 : Normal operation + @note It can be set only when @ref SYSR_CHPL = 1. + @sa _SYSR0_, _CHPLCKR_, _SYSR_, SYSR_CHPL + @sa setSYCR0(), setCHPLCKR(), getCHPLCKR(), CHIPLOCK(), CHIPUNLOCK(), getSYSR() +*/ +#define SYCR0_RST (0x00) + +/** + @brief IEN bit of @ref _SYCR1_. + @details @ref SYCR1_IEN is globally enable or disable the interrupt of @ref _WIZCHIP_,\n + regardless of the related interrupt mask registers such as @ref _IMR_, @ref _SIMR_, @ref _SLIMR_, and @ref _Sn_IMR_.\n + 1 : Enable \n + 0 : Disable + @sa _SYCR1_, _IR_, _SIR_, _SLIR_, _Sn_IR_, _IRCLR_, _SLIRCLR_, _Sn_IRCLR_ + @sa getSYCR1(), setSYCR1(), getIR(), getSIR(), getSLIR(), getSn_IR(), setIRCLR(), setSLIRCLR(), setSn_IRCLR() +*/ +#define SYCR1_IEN (1 << 7) + +/** + @brief System Clock select mask bit of @ref _SYCR1_. + @details @ref SYCR1_CLKSEL selects a system clock to 100MHz or 25MHz. \n + The masked bit values are as following. + - @ref SYCR1_CLKSEL_25M + - @ref SYCR1_CLKSEL_100M + @note It can be set only when @ref SYSR_CHPL = 1. + @note The system clock is automatically changed to 25MHz while the reset of @ref _WIZCHIP_ H/W reset, the Ethernet PHY H/W reset and power down. \n + On the other hand, the system clock is set by @ref SYCR1_CLKSEL during normal operating. + @sa _SYCR1_, _SYSR_, _CHPLCKR_, SYSL_CHPL, PHYCR1_RST, PHYCR1_PWDN + @sa getSYCR1(), setSYCR1(), getSYSR(), getCHPLCKR(), setCHIPLCKR(), CHIPLOCK(), CHIPUNLOCK(), getPHYCR1(), setPHYCR1() +*/ +#define SYCR1_CLKSEL (1 << 0) + +/** + @brief System Clock - 25MHz + @details @ref SYCR1_CLKSEL_25M selects a system clock to 25MHz. + @note It can be set only when @ref SYSR_CHPL = 1. + @sa _SYCR1_, SYCR1_CLKSEL, SYCR1_CLKSEL_100M + @sa getSYCR1(), setSYCR1(), getSYSR(), getCHPLCKR(), setCHIPLCKR(), CHIPLOCK(), CHIPUNLOCK() +*/ +#define SYCR1_CLKSEL_25M 1 + +/** + @brief System Clock - 100MHz + @details @ref SYCR1_CLKSEL_100M selects a system clock to 100MHz. + @note It can be set only when @ref SYSR_CHPL = 1. + @sa _SYCR1_, SYCR1_CLKSEL, SYCR1_CLKSEL_25M + @sa getSYCR1(), setSYCR1(), getSYSR(), getCHPLCKR(), setCHIPLCKR(), CHIPLOCK(), CHIPUNLOCK() +*/ +#define SYCR1_CLKSEL_100M 0 + + +/* Interrupt Register Bit Definition */ +/** + @brief WOL bit of @ref _IR_ + @details @ref IR_WOL is set when @ref _WIZCHIP_ receives a magic packet of WOL. + @sa _IR_, _IRCLR_, _IMR_ + @sa getIR(), setIRCLR(), getIMR(), setIMR() +*/ +#define IR_WOL (1<<7) + +/** + @brief UNR6 bit of @ref _IR_ + @details @ref IR_UNR6 is set when @ref _WIZCHIP_ receives the unreachable message of ICMPv6. + @sa _IR_, _IRCLR_, _IMR_ + @sa getIR(), setIRCLR(), getIMR(), setIMR() +*/ +#define IR_UNR6 (1<<4) + +/** + @brief IPCONF bit of @ref _IR_ + @details @ref IR_IPCONF is set when @ref _WIZCHIP_ receives a ARP reply with the same IPv4 address as @ref _SIPR_. + @sa _IR_, _IRCLR_, _IMR_ + @sa getIR(), setIRCLR(), getIMR(), setIMR() +*/ +#define IR_IPCONF (1<<2) + +/** + @brief UNR4 bit of @ref _IR_ + @details @ref IR_UNR4 is set when @ref _WIZCHIP_ receives the unreachable message of ICMPv4. + @sa _IR_, _IRCLR_, _IMR_ + @sa getIR(), setIRCLR(), getIMR(), setIMR() +*/ +#define IR_UNR4 (1<<1) + +/** + @brief PTERM bit of @ref _IR_ + @details @ref IR_PTERM is set when @ref _WIZCHIP_ receives the PPP termination packet + @sa _IR_, _IRCLR_, _IMR_ + @sa getIR(), setIRCLR(), getIMR(), setIMR() +*/ +#define IR_PTERM (1<<0) + + +/* SOCKET Interrupt Register Bit Definition */ +/** + @brief N-th INT bit of @@ref _SIR_ + @details @ref SIR_INT(N) is set when @ref _Sn_IR_(N) is not equal to zero. + @sa _SIR_, _Sn_IRCLR_, _SIMR_ + @sa getSIR(), setSn_IRCLR(), getSIMR() +*/ +#define SIR_INT(N) (1<TCP SERVER     mode + If the connection request client have a IPv4 address, \n + TCP dual SOCKETn is changed to TCP4 mode and a destination IP address can be checked thru @ref _Sn_DIPR_, \n + else if the client have a IPv6 address, \n + TCP dual SOCKETn is changed to IPv6 mode and destination IP address can be checked by thru @ref _Sn_DIP6R_. + - In SOCKETn is operated as TCP CLIENT mode, + If the IP address type of destination to connect is IPv4, \n + the destination IP address should be set to @ref _Sn_DIPR_ and try to connect by @ref Sn_CR_CONNECT, \n + else if the type is IPv6, \n + the destination IP address should be set to @ref _Sn_DIP6R_ and try to connect by @ref Sn_CR_CONNECT6. \n + + @note In TCP SERVER mode, You can check the IP type of the client with @ref Sn_ESR_TCPM. + @note If the connected client have a IPv6 address, You can check whether the address is LLA or GAU, thru @ref Sn_ESR_IP6T + @sa _Sn_MR_, _Sn_CR_, _Sn_SR_, _Sn_ESR_TCPM_, Sn_MR_TCP4, Sn_MR_TCP6 + @sa getSn_MR(), setSn_MR(), getSn_CR(), setSn_CR(), getSn_SR(), getSn_ESR() +*/ +#define Sn_MR_TCPD (0x0D) + +/** + @brief UDP Dual mode + @details @ref Sn_MR_UDPD sets SOCKETn to both UDP4 & UDP6 mode. \n + It should be set before @ref Sn_CR_OPEN is performed. \n + After @ref Sn_CR_OPEN, SOCKETn is opened as UDP dual mode \n + and @ref _Sn_SR_ is changed from @ref SOCK_CLOSED to @ref SOCK_UDP. + @note In order to send data, \n + You can use both @ref Sn_CR_SEND and @ref Sn_CR_SEND6 as command and both @ref _Sn_DIPR_ and @ref _Sn_DIP6R_ as destination. + @note You can know the destination IP address type is whether IPv6 or IPv4 thru @ref getsockopt() with @ref SO_PACKINFO. + @sa _Sn_MR_, _Sn_CR_, _Sn_SR_, Sn_MR_UDP6, Sn_MR_UDP4 + @sa getSn_MR(), setSn_MR(), getSn_CR(), setSn_CR(), getSn_SR() +*/ +#define Sn_MR_UDPD (0x0E) + +/* SOCKETn Command Register BIt Definition */ +/** + @brief Initialize or Open SOCKETn. + @details SOCKETn is initialized and opened according to the protocol mode selected by @ref _Sn_MR_ and with a source port set by @ref _Sn_PORTR_. \n + The table shows @ref _Sn_SR_ is changed according to @ref _Sn_MR_.\n + + + + + + + + +
    @ref _Sn_MR_ (P[3:0]) @ref _Sn_SR_
    @ref Sn_MR_CLOSE @ref SOCK_CLOSED
    @ref Sn_MR_TCP4, @ref Sn_MR_TCP6, @ref Sn_MR_TCPD @ref SOCK_INIT
    @ref Sn_MR_UDP, @ref Sn_MR_UDP6, @ref Sn_MR_UDPD @ref SOCK_UDP
    @ref Sn_MR_IPRAW4 @ref SOCK_IPRAW4
    @ref Sn_MR_IPRAW6 @ref SOCK_IPRAW6
    @ref Sn_MR_MACRAW @ref SOCK_MACRAW
    + + @note If you want to use a SOCKETn option such as Sn_MR_MF, Sn_MR_ND, Sn_MR_MUTIL and etc, \n + these options should be set before @ref Sn_CR_OPEN is performed. + @note If you want to open a multicast UDP mode SOCKETn, \n + You should set the multicast group with @ref _Sn_DIPR_ or @ref _Sn_DIP6R_ and @ref _Sn_DPORTR_ before @ref Sn_CR_OPEN is performed. + @sa _Sn_CR_, _Sn_MR_, _Sn_SR_, _Sn_PORTR_, _Sn_DIPR_, _Sn_DIP6R_, _Sn_DPORTR_, + @sa getSn_CR(), setSn_CR(), getSn_MR(), setSn_MR(), getSn_SR(), getSn_PORTR(), setSn_PORTR(), getSn_DIPR(), setSn_DIPR(), + getSn_DIP6R(), setSn_DIP6R(), getSn_DPORTR(), setSn_DPORTR() +*/ +#define Sn_CR_OPEN (0x01) + +/** + @brief Wait a connection request in TCP SERVER mode + @details SOCKETn operates as a TCP SERVER and waits for a connection-request (SYN packet) \n + with corresponding @ref _Sn_PORTR_ port number from any TCP CLIENT \n + The @ref _Sn_SR_ is changed from @ref SOCK_INIT to @ref SOCK_LISTEN. \n + When a TCP CLIENT connection request is successfully accepted,\n + the @ref _Sn_SR_ is changed from @ref SOCK_LISTEN to @ref SOCK_ESTABLISHED \n + and the @ref Sn_IR_CON is set.\n + But when a TCP CLIENT connection request is failed, \n + @ref Sn_IR_TIMEOUT is set and @ref _Sn_SR_ is changed to SOCK_CLOSED. + @note This is valid only in TCP mode such as @ref Sn_MR_TCP4, @ref Sn_MR_TCP6, and @ref Sn_MR_TCPD. + @sa _Sn_CR_, _Sn_MR_, _Sn_SR_, _Sn_PORTR_ + @sa getSn_CR(), setSn_CR(), getSn_MR(), setSn_MR(), getSn_SR(), getSn_PORTR(), setSn_PORTR() +*/ +#define Sn_CR_LISTEN (0x02) + +/** + @brief Send a connection request in TCP CLIENT mode + @details To establish a connection, a connect-request (SYN packet) is sent to TCP SERVER set by @ref _Sn_DIPR_ & @ref _Sn_DPORTR_.\n + If the connect-request is successful accepted by a TCP SERVER, \n + the @ref _Sn_SR_ is changed to @ref SOCK_ESTABLISHED and the @ref Sn_IR_CON is set. \n + The connect-request fails in the following three cases, \n + and @ref _Sn_SR_ is changed to @ref SOCK_CLOSED.\n\n + 1. Until a ARP timeout is occurred (@ref Sn_IR_TIMEOUT = 1), a destination hardware address can not be acquired through the ARP-process.\n + 2. Until a TCP tmeout occurred (@ref Sn_IR_TIMEOUT = 1), a SYN/ACK packet is not received from the server\n + 3. When a RST packet is received instead of a SYN/ACK packet \n + + @note This is valid only in TCP mode such as @ref Sn_MR_TCP4 and @ref Sn_MR_TCPD. + @sa _Sn_CR_, _Sn_MR_, _Sn_SR_, _Sn_DIPR_, _Sn_DPORTR_, Sn_CR_CONNECT6, _Sn_IR_, _Sn_IRCLR_ + @sa getSn_CR(), setSn_CR(), getSn_MR(), setSn_MR(), getSn_SR(), getSn_DIPR(), setSn_DIPR(), getSn_DPORTR(), setSn_DPORTR(), getSn_IR(), setSn_IRCLR() +*/ +#define Sn_CR_CONNECT (0x04) + +/** + @brief Send connection request in TCP CLIENT mode + @details To establish a connection, a connect-request (SYN packet) is sent to TCP SERVER set by @ref _Sn_DIP6R_ & @ref _Sn_DPORTR_.\n + If the connect-request is successful accepted by a TCP SERVER, \n + the @ref _Sn_SR_ is changed to @ref SOCK_ESTABLISHED and the @ref Sn_IR_CON is set. \n + The connect-request fails in the following three cases, and @ref _Sn_SR_ is changed @ref SOCK_CLOSED.\n + 1. Until a ARP timeout is occurred (@ref Sn_IR_TIMEOUT = 1), a destination hardware address can not be acquired through the ARP-process.\n + 2. Until a TCP tmeout occurred (@ref Sn_IR_TIMEOUT = 1), a @b SYN/ACK packet is not received from the server\n + 3. When a RST packet is received instead of a @b SYN/ACK packet \n + + @note This is valid only in TCP mode such as @ref Sn_MR_TCP6 and @ref Sn_MR_TCPD. + @sa _Sn_CR_, _Sn_MR_, _Sn_SR_, _Sn_DIP6R_, _Sn_DPORTR_, Sn_CR_CONNECT, _Sn_IR_, _Sn_IRCLR_ + @sa getSn_CR(), setSn_CR(), getSn_MR(), setSn_MR(), getSn_SR(), getSn_DIP6R(), setSn_DIP6R(), getSn_DPORTR(), setSn_DPORTR(), getSn_IR(), setSn_IRCLR() +*/ +#define Sn_CR_CONNECT6 (0x84) + +/** + @brief Send a disconnect request in TCP mode + @details Regardless of TCP SERVER or TCP CLIENT, \n + @ref Sn_CR_DISCON processes the disconnect-process (Active or Passive close).\n + When the disconnect-process is successful (that is, FIN/ACK packet is received successfully from/to each other),\n + @ref _Sn_SR_ is changed to @ref SOCK_CLOSED.\n + Otherwise, @ref Sn_IR_TIMEOUT is set and then @ref _Sn_SR_ is changed to @ref SOCK_CLOSED. + - Active close + It transmits first a disconnect-request(FIN packet) to the connected peer, and waits to receive two FIN/ACK and FIN packet from the peer. \n + If two FIN/ACK and FIN packet is received successfully, @ref Sn_IR_DISCON is set and @ref _Sn_SR_ is changed @ref SOCK_CLOSED. + - Passive close + When a FIN packet is first received from the peer, the FIN/ACK packet is replied back to the peer and @ref Sn_IR_DISCON is set.\n + And then, a FIN packet is sent by @ref Sn_CR_DISCON to the peer, and waits to receive the FIN/ACK packet from the peer. \n + If the FIN/ACK packet is received successfully from the peer, @ref _Sn_SR_ is changed to @ref SOCK_CLOSED. + + @note It is valid only in TCP mode such as @ref Sn_MR_TCP4, @ref Sn_MR_TCP6, and @ref Sn_MR_TCPD. + @sa _Sn_CR_, _Sn_MR_, _Sn_SR_, _Sn_IR_, _Sn_IRCLR_, Sn_IR_DISCON, Sn_IR_TIMEOUT + @sa getSn_CR(), setSn_CR(), getSn_MR(), setSn_MR(), getSn_SR(), getSn_IR(), setSn_IRCLR() +*/ +#define Sn_CR_DISCON (0x08) + +/** + @brief Release or Close SOCKETn + @details In TCP mode, @ref Sn_CR_CLOSE force to close a SOCKETn without the disconnect-process.\n + In other SOCKETn mode, @ref Sn_CR_CLOSE just closes a SOCKET.\n + @note @ref _Sn_SR_ can be changed from any status to @ref SOCK_CLOSED by @ref Sn_CR_CLOSE. + @sa _Sn_CR_, _Sn_MR_, _Sn_SR_, Sn_CR_DISCON + @sa getSn_CR(), setSn_CR(), getSn_MR(), setSn_MR(), getSn_SR() +*/ +#define Sn_CR_CLOSE (0x10) + +/** + @brief Send Data + @details @ref Sn_CR_SEND send the saved data from @ref _Sn_TX_RD_ to @ref _Sn_TX_WR_ in the SOCKETn TX buffer \n + to the destination specified by @ref _Sn_DIPR_ or @ref _Sn_DIP6R_, and @ref _Sn_DPORTR_.\n + - TCP mode(@ref Sn_MR_TCP4, @ref Sn_MR_TCP6, @ref Sn_MR_TCPD) + If it starts to be sent the data by @ref Sn_CR_SEND, @ref Sn_IR_SENDOK is set. \n + And after sending the data, if the ACK to the sent data can not be received during @ref _Sn_RTR_, \n + the sent data can be retransmitted as many as @ref _Sn_RCR_. \n + During the retransmission, \n + If the ACK is received, @ref _Sn_TX_FSR_ is increased as many as the sent data size, \n + Otherwise, @ref Sn_IR_TIMEOUT is set and @ref _Sn_SR_ is changed to @ref SOCK_CLOSED. + - UDP mode(@ref Sn_MR_UDP4, @ref Sn_MR_UDPD) & IPRAW mode(@ref Sn_MR_IPRAW4) + It first sends a ARP-request to a destination specified with @ref _Sn_DIPR_ before it starts to be sent data by @ref Sn_CR_SEND. \n + If the ARP-reply can not be received during @ref _Sn_RTR_, the ARP-request can be retransmitted as many as @ref _Sn_RCR_. \n + During the retransmission, \n + If the ARP-reply is received and @ref Sn_IR_SENDOK is set, it starts to send data and then @ref _Sn_TX_FSR_ is increased as many as the sent data size. \n + Otherwise, @ref Sn_IR_TIMEOUT is set but @ref _Sn_SR_ is not changed. + - MACRAW mode(@ref Sn_MR_MACRAW) + It just start to send data and @ref Sn_IR_SENDOK is set. + + @note Data size to be sent is calculated by the absolute difference between @ref _Sn_TX_WR_ and @ref _Sn_TX_RD_. \n + In TCP or UDP mode, It can not be sent bigger data than @ref _Sn_TX_FSR_.\n + In IPRAW or Macraw case, it can not be sent bigger data than MTU(Maximum Transmit Unit). + @note In TCP or MACRAW mode, It can send data to a destination address whether IPv4 or IPv6. \n + In UDP or IPRAW mode, It can send data only to a destination IPv4 address. \n + For Sending to IPv6 address, It can be used with @ref Sn_CR_SEND6. + @sa _Sn_CR_, _Sn_MR_, _Sn_DIPR_, _Sn_DIP6R_, _Sn_DPORTR_, _Sn_IR_, _Sn_IRCLR_, _Sn_TX_FSR_, _Sn_TX_WR_, _Sn_TX_RD_ + @sa getSn_CR(), setSn_CR(), getSn_MR(), setSn_MR(), getSn_SR(), getSn_DIPR(), setSn_DIPR(), getSn_DIP6R(), setSn_DIP6R(), \n + getSn_DPORTR(), setSn_DPORTR(), getSn_IR(), setSn_IRCLR(), getSn_TX_FSR(), getSn_TX_WR(), setSn_TX_WR(), getSn_TX_RD() +*/ +#define Sn_CR_SEND (0x20) + +/** + @brief Send Data + @details @ref Sn_CR_SEND6 sends the saved data from @ref _Sn_TX_RD_ to @ref _Sn_TX_WR_ in the SOCKETn TX buffer \n + to the destination specified by @ref _Sn_DIP6R_, and @ref _Sn_DPORTR_.\n + - TCP mode(@ref Sn_MR_TCP4, @ref Sn_MR_TCP6, @ref Sn_MR_TCPD) & MACRAW mode(@ref Sn_MR_MACRAW) + @ref Sn_CR_SEND6 is not recommended. In this case, Use @ref Sn_CR_SEND. + - UDP mode(@ref Sn_MR_UDP6, @ref Sn_MR_UDPD) & IPRAW mode(@ref Sn_MR_IPRAW6) + It first send a neighbor solicitation NS) of ICMPv6 to a destination specified with @ref _Sn_DIP6R_ \n + before it starts to be sent data by @ref Sn_CR_SEND. \n + If the neighbor advertisement(NA) of ICMPv6 can not be received during @ref _Sn_RTR_, \n + the NS can be retransmitted as many as @ref _Sn_RCR_. \n + During the retransmission, \n + If the NA is received and @ref Sn_IR_SENDOK is set, \n + it starts to send data and then @ref _Sn_TX_FSR_ is increased as many as the sent data size. \n + Otherwise, @ref Sn_IR_TIMEOUT is set but @ref _Sn_SR_ is not changed. + + @note Data size to be sent is calculated by the absolute difference between @ref _Sn_TX_WR_ and @ref _Sn_TX_RD_. \n + In TCP or UDP mode, It can not be sent bigger data than @ref _Sn_TX_FSR_.\n + In IPRAW or Macraw case, it can not be sent bigger data than MTU(Maximum Transmit Unit). + @note In UDP or IPRAW mode, It can send data only to a destination IPv6 address. \n + For Sending to IPv4 address, It can be sent by @ref Sn_CR_SEND. + @sa _Sn_CR_, _Sn_MR_, _Sn_DIP6R_, _Sn_DPORTR_, _Sn_IR_, _Sn_IRCLR_, _Sn_TX_FSR_, _Sn_TX_WR_, _Sn_TX_RD_ + @sa getSn_CR(), setSn_CR(), getSn_MR(), setSn_MR(), getSn_SR(), getSn_DIP6R(), setSn_DIP6R(), getSn_DPORTR(), setSn_DPORTR(), \n + getSn_IR(), setSn_IRCLR(), getSn_TX_FSR(), getSn_TX_WR(), setSn_TX_WR(), getSn_TX_RD() +*/ +#define Sn_CR_SEND6 (0xA0) + +/** + @brief Send keep alive message + @details @ref Sn_CR_SEND_KEEP checks whether the connection is established or not by sending 1 byte KA(Keep Alive) packet.\n + If the destination can not respond to the KA packet during the time set by @ref _Sn_RTR_ and @ref _Sn_RCR_, \n + the connection is terminated, @ref Sn_IR_TIMEOUT is set and then @ref _Sn_SR_ is changed @ref SOCK_CLOSED. + @note It is valid only after sending data over 1 byte in TCP mode such as @ref Sn_MR_TCP4, @ref Sn_MR_TCP6, and @ref Sn_MR_TCPD. + @sa _Sn_CR_, _Sn_MR_, _Sn_SR_, _Sn_IR_, _Sn_IRCLR_, _Sn_RTR_, _Sn_RCR_, _Sn_KPALVTR_ + @sa getSn_CR(), setSn_CR(), getSn_MR(), setSn_MR(), getSn_SR(), getSn_IR(), setSn_IRCLR(), \n + getSn_RTR(), setSn_RTR(), getSn_RCR(), setSn_RCR(), getSn_KPALVTR(), getSn_KPALVTR() +*/ +#define Sn_CR_SEND_KEEP (0x22) + +/** + @brief Receive data + @details @ref Sn_CR_RECV reads the saved from @ref _Sn_RX_RD_ to @ref _Sn_RX_WR_ data in SOCKETn RX buffer.\n + When a data is saved in the SOCKETn RX buffer, \n + @ref Sn_IR_RECV is set and @ref _Sn_RX_RSR_ is increased as many as the saved data size.\n + The total size of saved data is calculated by the absolute difference between @ref _Sn_RX_WR_ and @ref _Sn_RX_RD_,\n + and it can be checked thru @ref _Sn_RX_RSR_.\n + After reading data, @ref _Sn_RX_RD_ should be increased as many as the read size before @ref Sn_CR_RECV is performed.\n + After @ref Sn_CR_RECV, @ref _Sn_RX_RSR_ is decreased as many as the read size.\n + If @ref _Sn_RX_RSR_ is remained still at none-zero, @ref Sn_IR_RECV is set again. + @sa _Sn_CR_, _Sn_MR_, _Sn_IR_, _Sn_IRCLR_, _Sn_RX_RD_, _Sn_RX_WR_, _Sn_RX_RSR_ + @sa getSn_CR(), setSn_CR(), getSn_MR(), setSn_MR(), getSn_IR(), getSn_IRCLR(), \n + getSn_RX_RD(), setSn_RX_RD(), getSn_RX_TX(), getSn_RX_RSR() +*/ +#define Sn_CR_RECV (0x40) + + +/* Sn_IR values */ +/** + @brief SEND OK Interrupt + @details @ref Sn_IR_SENDOK is set when it is started to be sent data by @ref Sn_CR_SEND. + @note Even though @ref Sn_IR_SENDOK is set, it does not means that the destination receives data successfully.\n + - In TCP mode, The sent data maybe still transmitting or retransmitting. \n + - In other modes, The sent data maybe lost by media collision or an other reason such as network traffic. + @sa _Sn_IR_, _Sn_IRCLR_, Sn_CR_SEND + @sa getSn_IR(), setSn_IRCLR(), getSn_CR(), setSn_CR() +*/ +#define Sn_IR_SENDOK (0x10) + +/** + @brief TIMEOUT Interrupt + @details @ref Sn_IR_TIMEOUT is set when a timeout occurs in ARP and ND process or TCP retransmission. + @note In TCP mode, If it is set, @ref _Sn_SR_ is changed to @ref SOCK_CLOSED. \n + In other modes, _Sn_SR_ is still remained at the previous status. + @sa _Sn_IR_, _Sn_IRCLR_, Sn_CR_CONNECT, Sn_CR_CONNECT6, Sn_CR_SEND + @sa getSn_IR(), setSn_IRCLR(), getSn_CR(), setSn_CR() +*/ +#define Sn_IR_TIMEOUT (0x08) + +/** + @brief RECV Interrupt + @details @ref Sn_IR_RECV is set whenever data is received from a peer, \n + or if @ref _Sn_RX_RSR_ is still at none-zero whenever @ref Sn_CR_RECV is performed. + @sa _Sn_IR_, _Sn_IRCLR_, Sn_CR_RECV + @sa getSn_IR(), setSn_IRCLR(), getSn_CR(), setSn_CR() +*/ +#define Sn_IR_RECV (0x04) + +/** + @brief DISCON Interrupt + @details @ref Sn_IR_DISCON is set when a FIN or FIN/ACK packet is received from the connected peer. + @note When first a FIN packet is received from the connected peer and @ref _Sn_SR_ is changed to SOCK_CLOSE_WAIT, \n + you should perform @ref Sn_CR_DISCON for a successful disconnect. \n + If the disconnect-process is completed or failed, @ref _Sn_SR_ is changed to @ref SOCK_CLOSED. + @note It is valild only in TCP mode such as @ref Sn_MR_TCP4, @ ref Sn_MR_TCP6 and @ref Sn_MR_TCPD. + @sa _Sn_IR_, _Sn_IRCLR_, Sn_IR_DISCON, _Sn_SR_ + @sa getSn_IR(), setSn_IRCLR(), getSn_CR(), setSn_CR(), getSn_SR() +*/ +#define Sn_IR_DISCON (0x02) + +/** + @brief CONNECT Interrupt + @details @ref Sn_IR_CON is set once the connection with a peer is established and @ref _Sn_SR_ is changed to @ref SOCK_ESTABLISHED. + @note It is valid only in TCP mode such as @ref Sn_MR_TCP4, @ ref Sn_MR_TCP6 adn @ref Sn_MR_TCPD. + @sa _Sn_IR_, _Sn_IRCLR_, _Sn_SR_ + @sa getSn_IR(), setSn_IRCLR(), getSn_SR() +*/ +#define Sn_IR_CON (0x01) + +/* Sn_SR values */ +/** + @brief SOCKETn Closed status + @details @ref SOCK_CLOSED indicates that SOCKETn is closed and released.\n + It is set when @ref Sn_CR_DISCON , @ref Sn_CR_CLOSE is performed, or when @ref Sn_IR_TIMEOUT is set.\n + It can be changed to @ref SOCK_CLOSED regardless of previous status. + @sa _Sn_SR_, _Sn_CR_, _Sn_IR_, _Sn_IRCLR_, Sn_IR_TIMEOUT + @sa getSn_SR(), getSn_CR(), setSn_CR(), getSn_IR(), setSn_IRCLR() +*/ +#define SOCK_CLOSED (0x00) + +/** + @brief TCP SOCKETn initialized status + @details @ref SOCK_INIT indicates SOCKETn is opened with TCP mode such as @ref Sn_MR_TCP4, @ref Sn_MR_TCP6, and @ref Sn_MR_TCP6.\n + @ref _Sn_SR_ is changed from @ref SOCK_CLOSED to @ref SOCK_INIT when @ref Sn_CR_OPEN is performed in TCP mode.\n + In @ref SOCK_INIT status, @ref Sn_CR_LISTEN for operating a TCP SERVER \n + or @ref Sn_CR_CONNECT / @ref Sn_CR_CONNECT6 for operating a TCP CLIENT can be performed. + @note It is valid only in TCP mode. + @sa _Sn_SR_, _Sn_CR_, _Sn_MR_ + @sa getSn_SR, getSn_CR(), setSn_CR(), getSn_MR(), setSn_MR() +*/ +#define SOCK_INIT (0x13) + +/** + @brief TCP SOCKETn Listen status + @details @ref SOCK_LISTEN indicates SOCKETn is operating as TCP SERVER mode \n + and waiting for connection-request (SYN packet) from a peer (TCP CLIENT).\n + @ref _Sn_SR_ is changed to @ref SOCK_SYNRECV when the connection-request(SYN packet) is successfully accepted \n + and It is changed from @ref SOCK_SYNRECV to @ref SOCK_ESTABLISHED \n + when the SYN/ACK packet is sent successfully to the peer and then the ACK packet of SYN/ACK is received successfully.\n + Otherwise, it is changed to @ref SOCK_CLOSED and @ref Sn_IR_TIMEOUT is set. + @note It is valid only in TCP mode such as @ref Sn_MR_TCP4, @ref Sn_MR_TCP6, and @ref Sn_MR_TCP6.. + @sa _Sn_SR_, _Sn_CR_, _Sn_IR_, _Sn_IRCLR_, _Sn_MR_ + @sa getSn_SR, getSn_CR(), getSn_IR(), setSn_IRCLR(), setSn_CR(), getSn_MR(), setSn_MR() +*/ +#define SOCK_LISTEN (0x14) + +/** + @brief TCP Connection Request status + @details @ref SOCK_SYNSENT indicates TCP SOCKETn sent the connect-request packet(SYN packet)\n + to the peer specified by @ref _Sn_DIPR_ / @ref _Sn_DIP6R_ and @ref _Sn_DPORTR_.\n + It is temporarily shown when @ref _Sn_SR_ is changing from @ref SOCK_INIT to @ref SOCK_ESTABLISHED by @ref Sn_CR_CONNECT or @ref Sn_CR_CONNECT6.\n + When the connect-accept packet (SYN/ACK packet) is received from the peer at @ref SOCK_SYNSENT and the ACK packet of SYN/ACK is sent successfully, \n + @ref _Sn_SR_ is changed to @ref SOCK_ESTABLISHED.\n + Otherwise, it is changed to @ref SOCK_CLOSED and @ref Sn_IR_TIMEOUT is set. + @note It is valid only in TCP mode such as @ref Sn_MR_TCP4, @ref Sn_MR_TCP6, and @ref Sn_MR_TCP6.. + @sa _Sn_SR_, _Sn_CR_, _Sn_IR_, _Sn_IRCLR_, _Sn_MR_ + @sa getSn_SR, getSn_CR(), getSn_IR(), setSn_IRCLR(), setSn_CR(), getSn_MR(), setSn_MR() +*/ +#define SOCK_SYNSENT (0x15) + +/** + @brief TCP Connection Accept status + @details @ref SOCK_SYNRECV indicates TCP SOCKETn is successfully received the connect-request packet (SYN packet) from a peer.\n + It is temporarily shown when @ref _Sn_SR_ is changing from @ref SOCK_LISTEN to @ref SOCK_ESTABLISHED by the SYN packet\n + If SOCKETn sends the response (SYN/ACK packet) to the peer successfully and the ACK packet of SYS/ACK is received successfully,\n + @ref _Sn_SR_ is changed to @ref SOCK_ESTABLISHED. \n + Otherwise, @ref _Sn_SR_ is changed to @ref SOCK_CLOSED and @ref Sn_IR_TIMEOUT is set. + @note It is valid only in TCP mode such as @ref Sn_MR_TCP4, @ref Sn_MR_TCP6, and @ref Sn_MR_TCP6.. + @sa _Sn_SR_, _Sn_CR_, _Sn_IR_, _Sn_IRCLR_, _Sn_MR_ + @sa getSn_SR, getSn_CR(), getSn_IR(), setSn_IRCLR(), setSn_CR(), getSn_MR(), setSn_MR() +*/ +#define SOCK_SYNRECV (0x16) + +/** + @brief TCP SOCKETn Established status + @details @ref SOCK_ESTABLISHED indicates TCP SOCKETn is connected successfully with a peer.\n + when the TCP SERVER processes the SYN packet from the TCP CLIENT during @ref SOCK_LISTEN or \n + when the TCP CLIENT performs successfully @ref Sn_CR_CONNECT or @ref Sn_CR_CONNECT6,\n + @ref _Sn_SR_ is changed to @ref SOCK_ESTABLISHED and @ref Sn_IR_CON is set. \n + During @ref SOCK_ESTABLISHED, a DATA packet can be sent to or received from the peer by @ref Sn_CR_SEND or @ref Sn_CR_RECV. \n + If the DATA/ACK packet is not received from the peer during data re-transmission, @ref Sn_IR_TIMEOUT is set and @ref _Sn_SR_ is changed to @ref SOCK_CLOSED.\n + Otherwise, @ref _Sn_SR_ is still at @ref SOCK_ESTABLISHED. + @note In TCP SERVER, \n + You can check the IPv4/IPv6 address and port number of connected peer thru @ref _Sn_DIPR_, @ref _Sn_DIP6R_, and @ref _Sn_DPORTR_ respectively. + @note It is valid only in TCP mode such as @ref Sn_MR_TCP4, @ref Sn_MR_TCP6, and @ref Sn_MR_TCP6. + @sa _Sn_SR_, _Sn_CR_, _Sn_IR_, _Sn_IRCLR_, _Sn_MR_, _Sn_DIPR_, _Sn_DIP6R_, _Sn_DPORTR_ + @sa getSn_SR, getSn_CR(), getSn_IR(), setSn_IRCLR(), setSn_CR(), getSn_MR(), setSn_MR(), + getSn_DIPR(), setSn_DIPR(), getSn_DIP6R(), setSn_DIP6R(), getSn_DPORTR(), setSn_DPORTR(). +*/ +#define SOCK_ESTABLISHED (0x17) + +/** + @brief TCP SOCKETn Closing status + @details @ref SOCK_FIN_WAIT indicates TCP mode SOCKETn waits until the disconnect-process is completed. \n + It is temporarily shown in disconnect-process such as active-close. \n + When the disconnect-process is successfully completed or when @ref Sn_IR_TIMEOUT is set,\n + @ref _Sn_SR_ is changed to @ref SOCK_CLOSED. + @note It is valid only in TCP mode such as @ref Sn_MR_TCP4, @ref Sn_MR_TCP6, and @ref Sn_MR_TCPD. + @sa _Sn_SR_, _Sn_CR_, _Sn_IR_, _Sn_IRCLR_, _Sn_MR_, SOCK_TIME_WAIT, SOCK_LAST_ACK + @sa getSn_SR, getSn_CR(), getSn_IR(), setSn_IRCLR(), setSn_CR(), getSn_MR(), setSn_MR() + +*/ +#define SOCK_FIN_WAIT (0x18) + +/** + @brief TCP SOCKETn Closing status + @details @ref SOCK_TIME_WAIT indicates TCP SOCKETn waits until the disconnect-process is completed.\n + It is temporarily shown in disconnect-process such as active-close. \n + When the disconnect-process is successfully completed or when @ref Sn_IR_TIMEOUT is set,\n + @ref _Sn_SR_ is changed to @ref SOCK_CLOSED. + @note It is valid only in TCP mode such as @ref Sn_MR_TCP4, @ref Sn_MR_TCP6, and @ref Sn_MR_TCPD. + @sa _Sn_SR_, _Sn_CR_, _Sn_IR_, _Sn_IRCLR_, _Sn_MR_, SOCK_FIN_WAIT, SOCK_LAST_ACK + @sa getSn_SR, getSn_CR(), getSn_IR(), setSn_IRCLR(), setSn_CR(), getSn_MR(), setSn_MR() +*/ +#define SOCK_TIME_WAIT (0x1B) + +/** + @brief TCP SOCKETn Half Closing staus + @details @ref SOCK_CLOSE_WAIT indicates TCP SOCKETn receives the disconnect-request (FIN packet) from the connected peer.\n + It is a half-closing status, and a DATA packet can be still sent or received by @ref Sn_CR_SEND or @ref Sn_CR_RECV.\n + If you do not have any more need to send or received a DATA packet, You can perform @ref Sn_CR_DISCON for a full-closing. + @note If you have no need the successful closing, You maybe perform @ref Sn_CR_CLOSE. + @note It is valid only in TCP mode such as @ref Sn_MR_TCP4, @ref Sn_MR_TCP6, and @ref Sn_MR_TCPD. + @sa _Sn_SR_, _Sn_CR_, _Sn_IR_, _Sn_IRCLR_, _Sn_MR_ + @sa getSn_SR, getSn_CR(), getSn_IR(), setSn_IRCLR(), setSn_CR(), getSn_MR(), setSn_MR() +*/ +#define SOCK_CLOSE_WAIT (0x1C) + +/** + @brief TCP SOCKETn Closing status + @details @ref SOCK_LAST_ACK indicates TCP SOCKETn waits until the disconnect-process is completed.\n + It is temporarily shown in disconnect-process such as active-close and passive-close.\n + When the disconnect-process is successfully completed or when @ref Sn_IR_TIMEOUT is set,\n + @ref _Sn_SR_ is changed to @ref SOCK_CLOSED. + @note It is valid only in TCP mode such as @ref Sn_MR_TCP4, @ref Sn_MR_TCP6, and @ref Sn_MR_TCPD. + @sa _Sn_SR_, _Sn_CR_, _Sn_IR_, _Sn_IRCLR_, _Sn_MR_, SOCK_FIN_WAIT, SOCK_TIME_WAIT + @sa getSn_SR, getSn_CR(), getSn_IR(), setSn_IRCLR(), setSn_CR(), getSn_MR(), setSn_MR() +*/ +#define SOCK_LAST_ACK (0x1D) + +/** + @brief UDP SOCKETn status + @details @ref SOCK_UDP indicates SOCKETn is opened in UDP mode such as @ref Sn_MR_UDP4, @ref Sn_MR_UDP6, and @ref Sn_MR_UDPD.\n + @ref _Sn_SR_ is changed from @ref SOCK_CLOSED to @ref SOCK_INIT when @ref Sn_CR_OPEN is performed in UDP mode.\n + Unlike TCP mode, during @ref SOCK_UDP, \n + a DATA packet can be sent to or received from a peer by @ref Sn_CR_SEND / @ref Sn_CR_SEND6 or @ref Sn_CR_RECV without a connect-process.\n + Before a DATA packet is sent by @ref Sn_CR_SEND / @ref Sn_CR_SEND6,\n + the ARP is requested to the peer specified by @ref _Sn_DIPR_ / @ref _Sn_DIP6R_.\n + In ARP processing, @ref _Sn_SR_ is stll at @ref SOCK_UDP even if @ref Sn_IR_TIMEOUT is set.\n + If you do not have any more need to send or received a DATA packet, \n + You can perform @ref Sn_CR_CLOSE and @ref _Sn_SR_ is changed to @ref SOCK_CLOSED. + @note It is valid only in UDP mode such as @ref Sn_MR_UDP4, @ref Sn_MR_UDP6, and @ref Sn_MR_UDPD. + @sa _Sn_SR_, _Sn_CR_, _Sn_IR_, _Sn_IRCLR_, _Sn_MR_, _Sn_DIPR_, _Sn_DIP6R_ + @sa getSn_SR, getSn_CR(), getSn_IR(), setSn_IRCLR(), setSn_CR(), getSn_MR(), setSn_MR(), + getSn_DIPR(), setSn_DIPR(), getSn_DIP6R(), setSn_DIP6R() +*/ +#define SOCK_UDP (0x22) + +/** + @brief IPRAW4 SOCKETn mode + @details @ref SOCK_IPRAW4(= @ref SOCK_IPRAW) SOCKETn indicates SOCKETn is opened as IPv4 RAW mode.\n + @ref _Sn_SR_ is changed from @ref SOCK_CLOSED to @ref SOCK_IPRAW4 when @ref Sn_CR_OPEN is performed with @ref Sn_MR_IPRAW4. \n + A DATA packet can be send to or received from a peer without a connection like as @ref SOCK_UDP. \n + Before a DATA packet is sent by @ref Sn_CR_SEND, \n + the ARP is requested to the peer specified by @ref _Sn_DIPR_.\n + In ARP processing, @ref _Sn_SR_ is still at @ref SOCK_IPRAW4 even if @ref Sn_IR_TIMEOUT is set.\n + IPRAW4 SOCKETn can receive only the packet specified by @ref _Sn_PNR_, and it discards the others packets.\n + If you do not have any more need to send or received a DATA packet, \n + You can perform @ref Sn_CR_CLOSE and @ref _Sn_SR_ is changed to @ref SOCK_CLOSED. + @note It is valid only in IPRAW4 mode such as @ref Sn_MR_IPRAW4. + @sa _Sn_SR_, _Sn_CR_, _Sn_IR_, _Sn_IRCLR_, _Sn_MR_, _Sn_DIPR_, _Sn_PNR_ + @sa getSn_SR, getSn_CR(), getSn_IR(), setSn_IRCLR(), setSn_CR(), getSn_MR(), setSn_MR(), + getSn_DIPR(), setSn_DIPR(), getSn_PNR(), setSn_PNR() +*/ +#define SOCK_IPRAW4 (0x32) +#define SOCK_IPRAW (SOCK_IPRAW4) ///< Refer to @ref SOCK_IPRAW4. + +/** + @brief IPRAW6 SOCKETn mode + @details @ref SOCK_IPRAW6 SOCKETn indicates SOCKETn is opened as IPv6 RAW mode.\n + @ref _Sn_SR_ is changed from @ref SOCK_CLOSED to @ref SOCK_IPRAW6 when @ref Sn_CR_OPEN is performed with @ref Sn_MR_IPRAW6. \n + A DATA packet can be send to or received from a peer without a connection like as @ref SOCK_UDP.\n + Before a DATA packet is sent by @ref Sn_CR_SEND6, \n + the ICMPv6 NS is requested to the peer specified by @ref _Sn_DIPR_ or @ref _Sn_DIP6R_.\n + In ND(Neighbor Discovery) is processing,\n + @ref _Sn_SR_ is still at @ref SOCK_IPRAW6 even if @ref Sn_IR_TIMEOUT is set.\n + IPRAW6 SOCKETn can receive only the packet specified by @ref _Sn_PNR_, and it discards the others packets.\n + If you do not have any more need to send or received a DATA packet, \n + You can perform @ref Sn_CR_CLOSE and @ref _Sn_SR_ is changed to @ref SOCK_CLOSED. + @note It is valid only in IPRAW6 mode such as @ref Sn_MR_IPRAW6. + @sa _Sn_SR_, _Sn_CR_, _Sn_IR_, _Sn_IRCLR_, _Sn_MR_, _Sn_DIP6R_, _Sn_PNR_ + @sa getSn_SR, getSn_CR(), getSn_IR(), setSn_IRCLR(), setSn_CR(), getSn_MR(), setSn_MR(), + getSn_DIP6R(), setSn_DIP6R(), getSn_PNR(), setSn_PNR() +*/ +#define SOCK_IPRAW6 (0x33) + +/** + @brief MACRAW SOCKETn mode + @details @ref SOCK_MACRAW indicates SOCKET0 is opened as MACRAW mode.\n + @ref _Sn_SR_ is changed from @ref SOCK_CLOSED to @ref SOCK_MACRAW when @ref Sn_CR_OPEN command is ordered with @ref Sn_MR_MACRAW.\n + MACRAW SOCKET0 can be sent or received a pure Ethernet frame packet to/from any peer. + @note It is valid only in SOCKET0. + @sa _Sn_SR_, _Sn_CR_, _Sn_IR_, _Sn_IRCLR_, _Sn_MR_ + @sa getSn_SR, getSn_CR(), getSn_IR(), setSn_IRCLR(), setSn_CR(), getSn_MR(), setSn_MR(), +*/ +#define SOCK_MACRAW (0x42) + +/* Sn_ESR values */ +/** + @brief SOCKETn Extended Status : TCP Mode + @details @ref Sn_ESR_TCPM masks the TCPM bit of @ref _Sn_ESR_. \n + The masked bit values are as following. \n + - @ref Sn_ESR_TCPM_IPV4 + - @ref Sn_ESR_TCPM_IPV6 + @note It is useful to know the destination IP version when TCPD(@ref Sn_MR_TCPD) mode SOCKETn is operated as TCP SERVER. + @sa _Sn_ESR_ + @sa getSn_ESR() +*/ +#define Sn_ESR_TCPM (1<<2) + +/** + @brief TCP SOCKETn IP version - IPv4 + @details @ref Sn_ESR_TCPM_IPV4 indicates TCP SOCKETn is operated on IPv4 . + @sa _Sn_ESR_, Sn_ESR_TCPM_IPV6 + @sa getSn_ESR() +*/ +#define Sn_ESR_TCPM_IPV4 (0<<2) + +/** + @brief TCP SOCKETn IP version - IPv6 + @details @ref Sn_ESR_TCPM_IPV6 indicates TCP SOCKETn is operated on IPv6 . + @sa _Sn_ESR_, Sn_ESR_TCPM_IPV4 + @sa getSn_ESR() +*/ +#define Sn_ESR_TCPM_IPV6 (1<<2) + +/** + @brief SOCKETn Extended Status : TCP Operation Mode + @details @ref Sn_ESR_TCPOP masks the TCPOP bit of @ref _Sn_ESR_. The masked bit values are as following. \n + - @ref Sn_ESR_TCPOP_SVR + - @ref Sn_ESR_TCPOP_CLT + @note It is useful to check TCP mode SOCKETn is operated as whether TCP SERVER or TCP CLIENT. + @sa _Sn_ESR_ + @sa getSn_ESR() +*/ +#define Sn_ESR_TCPOP (1<<1) + +/** + @brief TCP SOCKETn Operation Mode - TCP SERVER + @details @ref Sn_ESR_TCPOP_SVR indicates TCP mode SOCKET n is operated as TCP SERVER + @note It is valid only in TCP mode such as @ref Sn_MR_TCP4, @ref Sn_MR_TCP6, and @ref Sn_MR_TCPD. + @sa _Sn_ESR_, Sn_ESR_TCPOP_CLT + @sa getSn_ESR() +*/ +#define Sn_ESR_TCPOP_SVR (0<<1) + +/** + @brief TCP SOCKETn Operation Mode - TCP CLIENT + @details @ref Sn_ESR_TCPOP_SVR indicates TCP mode SOCKET n is operated as TCP CLIENT + @note It is valid only in TCP mode such as @ref Sn_MR_TCP4, @ref Sn_MR_TCP6, and @ref Sn_MR_TCPD. + @sa _Sn_ESR_, Sn_ESR_TCPOP_SVR + @sa getSn_ESR() +*/ +#define Sn_ESR_TCPOP_CLT (1<<1) + +/** + @brief SOCKETn Extended Status : Source IPv6 Address Type + @details @ref Sn_ESR_IP6T masks the IP6T bit of @ref _Sn_ESR_. \n + The masked bit values are as following. \n + - @ref Sn_ESR_IP6T_LLA + - @ref Sn_ESR_IP6T_GUA + @note It is useful to check whether the connected peer IP address is LLA or GUA. + @note It is valid only in TCP mode such as @ref Sn_MR_TCP6 and @ref Sn_MR_TCPD. + @sa _Sn_ESR_ + @sa getSn_ESR() +*/ +#define Sn_ESR_IP6T (1<<0) + +/** + @brief Source IPv6 Address Type - LLA + @details @ref Sn_ESR_IP6T_LLA indicates the source IPv6 Address is used as @ref _LLAR_ + @note It is valid only in TCP mode such as @ref Sn_MR_TCP6, and @ref Sn_MR_TCPD. + @sa _Sn_ESR_, Sn_ESR_IP6T_GUA, _LLAR_ + @sa getSn_ESR(), getLLAR(), setLLAR() +*/ +#define Sn_ESR_IP6T_LLA (0<<0) + +/** + @brief Source IPv6 Address Type - LLA + @details @ref Sn_ESR_IP6T_GUA indicates the source IPv6 Address is used as @ref _GUAR_ + @note It is valid only in TCP mode such as @ref Sn_MR_TCP6, and @ref Sn_MR_TCPD. + @sa _Sn_ESR_, Sn_ESR_IP6T_LLA, _GUAR_ + @sa getSn_ESR(), getGUAR(), setGUAR() +*/ +#define Sn_ESR_IP6T_GUA (1<<0) + +/* Sn_MR2 values */ +/** + @brief Destination Hardware Address Mode + @details @ref Sn_MR2_DHAM masks the DHAM bit of @ref _Sn_MR2_.\n + The masked bit values are as following. + - @ref Sn_MR2_DHAM_AUTO + - @ref Sn_MR2_DHAM_MANUAL + @sa _Sn_MR2_ + @sa getSn_MR2(), setSn_MR2() +*/ +#define Sn_MR2_DHAM (1<<1) + +/** + @brief Destination Hardware Address Mode - AUTO + @details @ref Sn_MR2_DHAM_AUTO sets the destination hardware address as the address acquired by ARP-process. + @sa _Sn_MR2_, Sn_MR_DHAM_MANUAL, NETMR_DHAS + @sa getSn_MR2(), setSn_MR2(), getNETMR(), setNETMR() +*/ +#define Sn_MR2_DHAM_AUTO (0<<1) + +/** + @brief Destination Hardware Address Mode - MANUAL + @details @ref Sn_MR2_DHAM_MANUAL sets the destination hardware address as @ref _Sn_DHAR_. + @sa _Sn_MR2_, Sn_MR_DHAM_MANUAL, NETMR_DHAS + @sa getSn_MR2(), setSn_MR2(), getNETMR(), setNETMR() +*/ +#define Sn_MR2_DHAM_MANUAL (1<<1) + +/** + @brief Force ARP + @details @ref Sn_MR2_FARP force to perform the ARP-process for acquiring the destination hardware address, before data communication\n + 0 : Normal \n + 1 : Force ARP + - In TCP mode such as @ref Sn_MR_TCP4, @ref Sn_MR_TCP6, and @ref Sn_MR_TCPD + If SOCKETn is operated as TCP SERVER, It sets the destination hardware address as the address + acquired by the forced ARP-process before sending SYN/ACK packet. + - In UDP mode such as @ref Sn_MR_UDP4, @ref Sn_MR_UDP6, and @ref Sn_MR_UDPD + It sets the destination hardware address as the address acquired by the forced ARP-process whenever @ref Sn_CR_SEND or @ref Sn_CR_SEND6. + @note When @ref Sn_MR2_DHAM_MANUAL and @ref Sn_MR2_FARP = '1', It sets the destination hardware address as @ref _Sn_DHAR_ even if the ARP-process is forced. +*/ +#define Sn_MR2_FARP (1<<0) + + +/*----------------------------For PHY Control-------------------------------*/ + +/** + @ingroup Common_register_group_W6300 + @brief Basic Mode Control Register of Ethernet PHY [RW][0x3100] + @details @ref PHYRAR_BMCR can be controlled by MDC/MDIO controller of @ref _WIZCHIP_. \n + Each bit of @ref PHYRAR_BMCR is defined as the following. + + + +
    15 14 13 12 11 10 9 8 7 6 ~ 0
    RST LB SPD ANE PWDN ISOL RAN DPX COLT Reserved
    + - @ref BMCR_RST + - @ref BMCR_LB + - @ref BMCR_SPD + - @ref BMCR_ANE + - @ref BMCR_PWDN + - @ref BMCR_ISOL : Not supported. + - @ref BMCR_REAN + - @ref BMCR_DPX + - @ref BMCR_COLT + + @note Its some bits have the same function as @ref _PHYCR0_ and @ref _PHYCR1_.\n + It can control the Ethernet PHY with software, while @ref _PHYCR0_ \n + and @ref _PHYCR1_ can control the Ethernet PHY with hardware. + + @sa PHYRAR_BMSR, _PHYRAR_, _PHYDIR_, _PHYDOR_, _PHYACR_, _PHYCR0_, _PHYCR1_ + @sa getPHYRAR(), setPHYRAR(), wiz_mdio_read(), wiz_mdio_write() +*/ +#define PHYRAR_BMCR (0x00) + +//Basic mode status register, basic register +/** + @ingroup Common_register_group_W6300 + @brief Basic Mode Status Register of Ethernet PHY [RO][0x7809] + @details @ref PHYRAR_BMSR gets the status of Ethernet PHY through MDC/MDIO controller of @ref _WIZCHIP_. \n + Each bit of @ref PHYRAR_BMSR is defined as the following. + + + + + +
    15 14 13 12 11 10~76 5 4 3 2 1 0
    100_T4 100_FDX 100_HDX 10_FDX 10_HDX Reserved MF_SUPANG_COMP REMOTE_FAULT ANG_ABILITY LINK_STATUS JABBER_DETECT EXT_CAPA
    + - @ref BMSR_100_T4 : Not supported. Always 0 + - @ref BMSR_100_FDX + - @ref BMSR_100_HDX + - @ref BMSR_10_FDX + - @ref BMSR_10_HDX + - @ref BMSR_MF_SUP : Not supported. Always 0. + - @ref BMSR_AN_COMP + - @ref BMSR_REMOTE_FAULT : Not supported. Always 0. + - @ref BMSR_AN_ABILITY + - @ref BMSR_LINK_STATUS + - @ref BMSR_JABBER_DETECT + - @ref BMSR_EXT_CAPA : Always 1. If you need a extended register information, send e-mail to support@wiznet.io + + @note Its some bits have the same function as @ref _PHYSR_. + @sa PHYRAR_BMCR, _PHYRAR_, _PHYDIR_, _PHYDOR_, _PHYACR_, _PHYCR0_, _PHYCR1_ + @sa getPHYRAR(), setPHYRAR(), wiz_mdio_read(), wiz_mdio_write() +*/ +#define PHYRAR_BMSR (0x01) + + +/********************/ +/* BMCR & BMSR Bit definitions */ +/********************/ + +/*For BMCR register*/ +/** + @brief Ethernet PHY S/W Reset. + @details 0 - Normal operation \n + 1 - Software reset + @sa PHYRAR_BMCR, PHYCR1_RST + @sa getPHYRAR_BMCR(), setPHYRAR_BMCR() +*/ +#define BMCR_RST (1<<15) + +/** + @brief Ethernet PHY Loopback. + @details 0 - Normal Operation \n + 1 - Loopback Enable + @sa PHYRAR_BMCR + @sa getPHYRAR_BMCR(), setPHYRAR_BMCR() +*/ +#define BMCR_LB (1<<14) ///< Loopback. 0 - Noraml operation, 1 - Loopback enabled + +/** + @brief Ethernet PHY Speed + @details 0 - 10 Mbps \n + 1 - 100 Mbps + @sa PHYCR_BMCR, PHYCR0_100F, PHYCR0_100H, PHYCR0_10F, PHYCR0_10H + @sa getPHYRAR_BMCR(), setPHYRAR_BMCR(), setPHYCR0() +*/ +#define BMCR_SPD (1<<13) + +/** + @brief Ethernet PHY Auto-Negotiation + @details 0 - Disable \n + 1 - Enable + @note When it is set, @ref BMCR_SPD and @ref BMCR_DPX is ignored + @sa PHYCR_BMCR, PHYCR0_AUTO + @sa getPHYRAR_BMCR(), setPHYRAR_BMCR(), setPHYCR0() +*/ +#define BMCR_ANE (1<<12) + +/** + @brief Ethernet PHY Power Down Mode + @details 0 - Normal Operation \n + 1 - Power Down mode + @sa PHYCR_BMCR, PHYCR0_PWDN + @sa getPHYRAR_BMCR(), setPHYRAR_BMCR(), setPHYCR0() +*/ +#define BMCR_PWDN (1<<11) ///< Power-down mode + +/** + @brief Ethernet PHY Isolation Mode + @details 0 - Normal Operation \n + 1 - Isolation Mode + @ Don't set it to '1'. It is not supported. + @sa PHYCR_BMCR + @sa getPHYRAR_BMCR(), setPHYRAR_BMCR() +*/ +#define BMCR_ISOL (1<<10) + +/** + @brief Ethernet PHY Restart Auto-Negotiation + @details 0 - Normal Operation \n + 1 - Restart Auto-Negotiation + @sa PHYCR_BMCR + @sa getPHYRAR_BMCR(), setPHYRAR_BMCR() +*/ +#define BMCR_REAN (1<<9) + +/** + @brief Ethernet PHY Duplex + @details 0 - Half-Duplex \n + 1 - Full-Duplex + @sa PHYCR_BMCR, PHYCR0_100F, PHYCR0_100H, PHYCR0_10F, PHYCR0_10H + @sa getPHYRAR_BMCR(), setPHYRAR_BMCR(), setPHYCR0() +*/ +#define BMCR_DPX (1<<8) + +/** + @brief Ethernet PHY Collision Test + @details 0 - Normal Operation \n + 1 - Collision Test + @sa PHYCR_BMCR + @sa getPHYRAR_BMCR(), setPHYRAR_BMCR() +*/ +#define BMCR_COLT (1<<7) + +/*For BMSR register*/ + +/** + @brief Ethernet PHY 100 Base-T4 capable + @details @ref BMSR_100_T4 is always 0. + @note It is not supported. + @sa PHYCR_BMSR + @sa getPHYRAR_BMSR() +*/ +#define BMSR_100_T4 (1<<15) + +/** + @brief Ethernet PHY 100 Base-TX Full-Duplex capable + @details @ref BMSR_100_FDX is always 1. + @sa PHYCR_BMSR + @sa getPHYRAR_BMSR() +*/ +#define BMSR_100_FDX (1<<14) + +/** + @brief Ethernet PHY 100 Base-TX Half-Duplex capable + @details @ref BMSR_100_HDX is always 1. + @sa PHYCR_BMSR + @sa getPHYRAR_BMSR() +*/ +#define BMSR_100_HDX (1<<13) + +/** + @brief Ethernet PHY 10 Base-T Full-Duplex capable + @details @ref BMSR_10_FDX is always 1. + @sa PHYCR_BMSR + @sa getPHYRAR_BMSR() +*/ +#define BMSR_10_FDX (1<<12) + +/** + @brief Ethernet PHY 10 Base-T Half-Duplex capable + @details @ref BMSR_10_HDX is always 1. + @sa PHYCR_BMSR + @sa getPHYRAR_BMSR() +*/ +#define BMSR_10_HDX (1<<11) + +/** + @brief Ethernet PHY Management Frame preamble suppression + @details @ref BMSR_MF_SUP is always 0. + @note It is not supported + @sa PHYCR_BMSR + @sa getPHYRAR_BMSR() +*/ +#define BMSR_MF_SUP (1<<6) + +/** + @brief Ethernet PHY Auto-Negotiation Complete + @details @ref BMSR_MF_SUP indicates the status of auto-negotiation. \n + 0 - Auto-negotiation process is not completed \n + 1 - Auto-negotiation process is completed + @sa PHYCR_BMSR + @sa getPHYRAR_BMSR() +*/ +#define BMSR_AN_COMP (1<<5) + +/** + @brief Ethernet PHY Remote Fault + @details @ref BMSR_REMOTE_FAULT is always 0. + @note It is not supported + @sa PHYCR_BMSR + @sa getPHYRAR_BMSR() +*/ +#define BMSR_REMOTE_FAULT (1<<4) + +/** + @brief Ethernet PHY Auto-Negotiation Ability + @details @ref BMSR_AN_ABILITY is always 1. + @sa PHYCR_BMSR + @sa getPHYRAR_BMSR() +*/ +#define BMSR_AN_ABILITY (1<<3) + +/** + @brief Ethernet PHY Link Status + @details @ref BMSR_LINK_STATUS indicates the status of link. \n + 0 - Link is not established + 1 - Valid link is established + @sa PHYCR_BMSR + @sa getPHYRAR_BMSR() +*/ +#define BMSR_LINK_STATUS (1<<2) + +/** + @brief Ethernet PHY Jabber Detect + @details @ref BMSR_JABBER_DETECT indicates the status of auto-negotiation. \n + 0 - Jabber condition is not detected\n + 1 - Jabber condition is detected + @sa PHYCR_BMSR + @sa getPHYRAR_BMSR() +*/ +#define BMSR_JABBER_DETECT (1<<1) + +/** + @brief Ethernet PHY Extended capability + @details @ref BMSR_EXT_CAPA indicates the extended register capability. \n + 0 - Only basic registers are capable\n + 1 - Extended registers are capable + @sa PHYCR_BMSR + @sa getPHYRAR_BMSR() +*/ +#define BMSR_EXT_CAPA (1<<0) + + +/** + @brief Enter a critical section + @details It is provided to protect your shared code and hardware resources against interference. \n + - Non-OS environment + It can be just implemented by disabling whole interrupt. + - OS environment + You can replace it to critical section API supported by OS. + + @note It is callback function that can be replaced it with your code, by calling @ref reg_wizchip_cris_cbfunc(). + @sa WIZCHIP_READ(), WIZCHIP_WRITE(), WIZCHIP_READ_BUF(), WIZCHIP_WRITE_BUF() + @sa WIZCHIP_CRITICAL_EXIT(), reg_wizchip_cris_cbfunc() +*/ +#define WIZCHIP_CRITICAL_ENTER() WIZCHIP.CRIS._enter() + + +/** + @brief Enter a critical section + @details It exits the protected code and hardware resources against interference. \n + - Non-OS environment + It can be just implemented by enabling whole interrupt.\n + - OS environment + You can replace it to critical section API supported by OS. + + @note It is callback function that can be replaced it with your code, by calling @ref reg_wizchip_cris_cbfunc(). + @sa WIZCHIP_READ(), WIZCHIP_WRITE(), WIZCHIP_READ_BUF(), WIZCHIP_WRITE_BUF() + @sa WIZCHIP_CRITICAL_EXIT(), reg_wizchip_cris_cbfunc() +*/ +#define WIZCHIP_CRITICAL_EXIT() WIZCHIP.CRIS._exit() + + + +//////////////////////// +// Basic I/O Function // +//////////////////////// +// +// +/** + @ingroup Basic_IO_function_W6300 + @brief It reads 1 byte value from a register. + @param AddrSel Register address + @return The value of register + @sa WIZCHIP_READ_BUF(), reg_wizchip_bus_cbfunc(), reg_wizchip_spi_cbfunc(), WIZCHIP_WRITE() +*/ +uint8_t WIZCHIP_READ(uint32_t AddrSel); + +/** + @ingroup Basic_IO_function_W6300 + @brief It writes 1 byte value to a register. + @param AddrSel Register address + @param wb Write data + @return void + @sa WIZCHIP_WRITE_BUF(), reg_wizchip_bus_cbfunc(), reg_wizchip_spi_cbfunc(), WIZCHIP_READ() +*/ +void WIZCHIP_WRITE(uint32_t AddrSel, uint8_t wb); + +/** + @ingroup Basic_IO_function_W6300 + @brief It reads sequentail data from registers. + @param AddrSel Register address + @param pBuf Pointer buffer to read data + @param len Data length + @return void + @sa WIZCHIP_WRITE_BUF(), reg_wizchip_bus_cbfunc(), reg_wizchip_spi_cbfunc(), WIZCHIP_READ() +*/ +void WIZCHIP_READ_BUF(uint32_t AddrSel, uint8_t* pBuf, datasize_t len); + +/** + @ingroup Basic_IO_function_W6300 + @brief It writes sequential data to registers. + @param AddrSel Register address + @param pBuf Pointer buffer to write data + @param len Data length + @return void + @sa WIZCHIP_READ_BUF(), reg_wizchip_bus_cbfunc(), reg_wizchip_spi_cbfunc(), WIZCHIP_WRITE() +*/ +void WIZCHIP_WRITE_BUF(uint32_t AddrSel, uint8_t* pBuf, datasize_t len); + + + +///////////////////////////////// +// Common Register IO function // +///////////////////////////////// +/** + @addtogroup Common_register_access_function_W6300 + @{ +*/ + +#define getRTL() \ + WIZCHIP_READ(_RTL_) + +#define getCIDR() \ + ((((uint16_t)WIZCHIP_READ(_CIDR_)| (((WIZCHIP_READ(_RTL_))&0x0F) << 1)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(_CIDR_,1))) + +#define getVER() \ + ((((uint16_t)WIZCHIP_READ(_VER_)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(_VER_,1))) + +#define getSYSR() \ + WIZCHIP_READ(_SYSR_) + +#define getSYCR0() \ + WIZCHIP_READ(_SYCR0_) + +#define setSYCR0(sycr0) \ + WIZCHIP_WRITE(_SYCR0_, (sycr0)) + +#define getSYCR1() \ + WIZCHIP_READ(_SYCR1_) + +#define setSYCR1(sycr1) \ + WIZCHIP_WRITE(_SYCR1_, (sycr1)) + +#define getTCNTR() \ + ((((uint16_t)WIZCHIP_READ(_TCNTR_)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(_TCNTR_,1))) + +#define setTCNTRCLR(tcntrclr) \ + WIZCHIP_WRITE(_TCNTRCLR_,(tcntrclr)) + +#define getIR() \ + WIZCHIP_READ(_IR_) + +#define getSIR() \ + WIZCHIP_READ(_SIR_) + +#define getSLIR() \ + WIZCHIP_READ(_SLIR_) + +#define setIMR(imr) \ + WIZCHIP_WRITE(_IMR_,(imr)) + +#define getIMR() \ + WIZCHIP_READ(_IMR_) + +#define setIRCLR(irclr) \ + WIZCHIP_WRITE(_IRCLR_,(irclr)) +#define setIR(ir) setIRCLR(ir) + +#define setSIMR(simr) \ + WIZCHIP_WRITE(_SIMR_,(simr)) + +#define getSIMR() \ + WIZCHIP_READ(_SIMR_) + +#define setSLIMR(slimr) \ + WIZCHIP_WRITE(_SLIMR_,(slimr)) + +#define getSLIMR() \ + WIZCHIP_READ(_SLIMR_) + +#define setSLIRCLR(slirclr) \ + WIZCHIP_WRITE(_SLIRCLR_,(slirclr)) +#define setSLIR(slir) setSLIRCLR(slir) + +#define setSLPSR(slpsr) \ + WIZCHIP_WRITE(_SLPSR_,(slpsr)) + +#define getSLPSR() \ + WIZCHIP_READ(_SLPSR_) + +#define setSLCR(slcr) \ + WIZCHIP_WRITE(_SLCR_,(slcr)) + +#define getSLCR() \ + WIZCHIP_READ(_SLCR_) + +#define getPHYSR() \ + WIZCHIP_READ(_PHYSR_) + +#define setPHYRAR(phyrar) \ + WIZCHIP_WRITE(_PHYRAR_,(phyrar)) + +#define getPHYRAR() \ + WIZCHIP_READ(_PHYRAR_) + +#define setPHYDIR(phydir) \ + do{ \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(_PHYDIR_,1), (uint8_t)((phydir)>>8)); \ + WIZCHIP_WRITE(_PHYDIR_, (uint8_t)(phydir)); \ + }while(0); + +#define getPHYDOR() \ + ((((uint16_t)WIZCHIP_READ(WIZCHIP_OFFSET_INC(_PHYDOR_,1))) << 8) + WIZCHIP_READ(_PHYDOR_)) + +#define setPHYACR(phyacr) \ + WIZCHIP_WRITE(_PHYACR_,(phyacr)) + +#define getPHYACR() \ + WIZCHIP_READ(_PHYACR_) + +#define setPHYDIVR(phydivr) \ + WIZCHIP_WRITE(_PHYDIVR_,(phydivr)) + +#define getPHYDIVR() \ + WIZCHIP_READ(_PHYDIVR_) + +#define setPHYCR0(phycr0) \ + WIZCHIP_WRITE(_PHYCR0_,(phycr0)) + +#define setPHYCR1(phycr1) \ + WIZCHIP_WRITE(_PHYCR1_,(phycr1)) + +#define getPHYCR1() \ + WIZCHIP_READ(_PHYCR1_) + +#define setNET4MR(net4mr) \ + WIZCHIP_WRITE(_NET4MR_,(net4mr)) + +#define setNET6MR(net6mr) \ + WIZCHIP_WRITE(_NET6MR_,(net6mr)) + +#define setNETMR(netmr) \ + WIZCHIP_WRITE(_NETMR_,(netmr)) + +#define setNETMR2(netmr2) \ + WIZCHIP_WRITE(_NETMR2_,(netmr2)) + +#define getNET4MR() \ + WIZCHIP_READ(_NET4MR_) + +#define getNET6MR() \ + WIZCHIP_READ(_NET6MR_) + +#define getNETMR() \ + WIZCHIP_READ(_NETMR_) + +#define getNETMR2() \ + WIZCHIP_READ(_NETMR2_) + +#define setPTMR(ptmr) \ + WIZCHIP_WRITE(_PTMR_, (ptmr)) + +#define getPTMR() \ + WIZCHIP_READ(_PTMR_) + +#define setPMNR(pmnr) \ + WIZCHIP_WRITE(_PMNR_, (pmnr)) + +#define getPMNR() \ + WIZCHIP_READ(_PMNR_) + +#define setPHAR(phar) \ + WIZCHIP_WRITE_BUF(_PHAR_,(phar),6) + +#define getPHAR(phar) \ + WIZCHIP_READ_BUF(_PHAR_,(phar),6) + +#define setPSIDR(psidr) \ + do{ \ + WIZCHIP_WRITE(_PSIDR_,(uint8_t)((psidr) >> 8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(_PSIDR_,1),(uint8_t)(psidr)); \ + }while(0); + +#define getPSIDR() \ + ((((uint16_t)WIZCHIP_READ(_PSIDR_)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(_PSIDR_,1))) + +#define setPMRUR(pmrur) \ + do{ \ + WIZCHIP_WRITE(_PMRUR_,(uint8_t)((pmrur) >> 8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(_PMRUR_,1),(uint8_t)(pmrur)); \ + }while(0); + +#define getPMRUR() \ + ((((uint16_t)WIZCHIP_READ(_PMRUR_)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(_PMRUR_,1))) + +#define setSHAR(shar) \ + WIZCHIP_WRITE_BUF(_SHAR_,(shar),6) + +#define getSHAR(shar) \ + WIZCHIP_READ_BUF(_SHAR_,(shar),6) + +#define setGAR(gar) \ + WIZCHIP_WRITE_BUF(_GAR_,(gar),4) + +#define getGAR(gar) \ + WIZCHIP_READ_BUF(_GAR_,(gar),4) + +#define setGA4R(ga4r) setGAR(ga4r) +#define getGA4R(ga4r) getGAR(ga4r) + +#define setSUBR(subr) \ + WIZCHIP_WRITE_BUF(_SUBR_,(subr),4) + +#define getSUBR(subr) \ + WIZCHIP_READ_BUF(_SUBR_,(subr),4) + +#define setSUB4R(sub4r) setSUBR(sub4r) +#define getSUB4R(sub4r) getSUBR(sub4r) + +#define setSIPR(sipr) \ + WIZCHIP_WRITE_BUF(_SIPR_,(sipr),4) + +#define getSIPR(sipr) \ + WIZCHIP_READ_BUF(_SIPR_,(sipr),4) + +#define setLLAR(llar) \ + WIZCHIP_WRITE_BUF(_LLAR_,(llar),16) + +#define getLLAR(llar) \ + WIZCHIP_READ_BUF(_LLAR_,(llar),16) + +#define setGUAR(guar) \ + WIZCHIP_WRITE_BUF(_GUAR_,(guar),16) + +#define getGUAR(guar) \ + WIZCHIP_READ_BUF(_GUAR_,(guar),16) + +#define setSUB6R(sub6r) \ + WIZCHIP_WRITE_BUF(_SUB6R_,(sub6r),16) + +#define getSUB6R(sub6r) \ + WIZCHIP_READ_BUF(_SUB6R_,(sub6r),16) + +#define setGA6R(ga6r) \ + WIZCHIP_WRITE_BUF(_GA6R_,(ga6r),16) + +#define getGA6R(ga6r) \ + WIZCHIP_READ_BUF(_GA6R_,(ga6r),16) + +#define setSLDIPR(sldipr) \ + WIZCHIP_WRITE_BUF(_SLDIPR_,(sldipr),4) +#define setSLDIP4R(sldip4r) setSLDIPR((sldip4r)) + +#define getSLDIPR(sldipr) \ + WIZCHIP_READ_BUF(_SLDIPR_,(sldipr),4) +#define getSLDIP4R(sldip4r) getSLDIPR((sldip4r)) + +#define setSLDIP6R(sldip6r) \ + WIZCHIP_WRITE_BUF(_SLDIP6R_, (sldip6r),16) + +#define getSLDIP6R(sldip6r) \ + WIZCHIP_READ_BUF(_SLDIP6R_,(sldip6r),16) + +#define getSLDHAR(sldhar) \ + WIZCHIP_READ_BUF(_SLDHAR_,(sldhar),6) + +#define setPINGIDR(pingidr) \ + do{ \ + WIZCHIP_WRITE(_PINGIDR_,(uint8_t)((pingidr)>>8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(_PINGIDR_,1),(uint8_t)(pingidr)); \ + }while(0); + +#define getPINGIDR() \ + (((int16_t)(WIZCHIP_READ(_PINGIDR_) << 8)) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(_PINGIDR_,1))) + +#define setPINGSEQR(pingseqr) \ + do{ \ + WIZCHIP_WRITE(_PINGSEQR_,(uint8_t)((pingseqr)>>8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(_PINGSEQR_,1),(uint8_t)(pingseqr)); \ + }while(0); + +#define getPINGSEQR() \ + (((int16_t)(WIZCHIP_READ(_PINGSEQR_) << 8)) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(_PINGSEQR_,1))) + +#define getUIPR(uipr) \ + WIZCHIP_READ_BUF(_UIPR_, (uipr), 4) + +#define getUIP4R(uip4r) getUIPR(uip4r) + +#define getUPORTR() \ + ((((uint16_t)WIZCHIP_READ(_UPORTR_)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(_UPORTR_,1))) + +#define getUPORT4R() getUPORTR() + +#define getUIP6R(uip6r) \ + WIZCHIP_READ_BUF(_UIP6R_,(uip6r),16) + +#define getUPORT6R(uport6r) \ + ((((uint16_t)WIZCHIP_READ(_UPORT6R_)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(_UPORT6R_,1))) + +#define setINTPTMR(intptmr) \ + do{ \ + WIZCHIP_WRITE(_INTPTMR_,(uint8_t)((intptmr) >> 8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(_INTPTMR_,1),(uint8_t)(intptmr)); \ + }while(0); + +#define getINTPTMR() \ + ((((uint16_t)WIZCHIP_READ(_INTPTMR_)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(_INTPTMR_,1))) + +#define getPLR() \ + WIZCHIP_READ(_PLR_) + +#define getPFR() \ + WIZCHIP_READ(_PFR_) + +#define getVLTR() \ + ( (((uint32_t)WIZCHIP_READ(_VLTR_)) << 24) + \ + (((uint32_t)WIZCHIP_READ(WIZCHIP_OFFSET_INC(_VLTR_,1))) << 16) + \ + (((uint32_t)WIZCHIP_READ(WIZCHIP_OFFSET_INC(_VLTR_,2))) << 16) + \ + (((uint32_t)WIZCHIP_READ(WIZCHIP_OFFSET_INC(_VLTR_,3))) << 16) ) + +#define getPLTR() \ + ( (((uint32_t)WIZCHIP_READ(_PLTR_)) << 24) + \ + (((uint32_t)WIZCHIP_READ(WIZCHIP_OFFSET_INC(_PLTR_,1))) << 16) + \ + (((uint32_t)WIZCHIP_READ(WIZCHIP_OFFSET_INC(_PLTR_,2))) << 16) + \ + (((uint32_t)WIZCHIP_READ(WIZCHIP_OFFSET_INC(_PLTR_,3))) << 16) ) + +#define getPAR(par) \ + WIZCHIP_READ_BUF(_PAR_, (par), 16) + +#define setICMP6BLKR(icmp6blkr) \ + WIZCHIP_WRITE(_ICMP6BLKR_,(icmp6blkr)) + +#define getICMP6BLKR() \ + WIZCHIP_READ(_ICMP6BLKR_) + +#define setCHPLCKR(chplckr) \ + WIZCHIP_WRITE(_CHPLCKR_, (chplckr)) + +#define getCHPLCKR() \ + ((getSYSR() & SYSR_CHPL) >> 7) + +#define CHIPLOCK() setCHPLCKR(0xFF) +#define CHIPUNLOCK() setCHPLCKR(0xCE) + +#define setNETLCKR(netlckr) \ + WIZCHIP_WRITE(_NETLCKR_, (netlckr)) + +#define getNETLCKR() \ + ((getSYSR() & SYSR_NETL) >> 6) + +#define NETLOCK() setNETLCKR(0xC5) +#define NETUNLOCK() setNETLCKR(0x3A) + +#define setPHYLCKR(phylckr) \ + WIZCHIP_WRITE(_PHYLCKR_,(phylckr)) + +#define getPHYLCKR() \ + ((getSYSR() & SYSR_PHYL) >> 5) + +#define PHYLOCK() setPHYLCKR(0xFF) +#define PHYUNLOCK() setPHYLCKR(0x53) + +#define setRTR(rtr) \ + do{ \ + WIZCHIP_WRITE(_RTR_,(uint8_t)((rtr)>>8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(_RTR_,1),(uint8_t)(rtr)); \ + }while(0); + +#define getRTR() \ + ((((uint16_t)WIZCHIP_READ(_RTR_)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(_RTR_,1))) + +#define setRCR(rcr) \ + WIZCHIP_WRITE(_RCR_,(rcr)) + +#define getRCR() \ + WIZCHIP_READ(_RCR_) + +#define setSLRTR(slrtr) \ + do{ \ + WIZCHIP_WRITE(_SLRTR_,(uint8_t)((slrtr)>>8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(_SLRTR_,1),(uint8_t)(slrtr)); \ + }while(0); + +#define getSLRTR() \ + ((((uint16_t)WIZCHIP_READ(_SLRTR_)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(_SLRTR_,1))) + +#define setSLRCR(slrcr) \ + WIZCHIP_WRITE(_SLRCR_,(slrcr)) + +#define getSLRCR() \ + WIZCHIP_READ(_SLRCR_) + +#define setSLHOPR(slhopr) \ + WIZCHIP_WRITE(_SLHOPR_,(slhopr)) + +#define getSLHOPR() \ + WIZCHIP_READ(_SLHOPR_) +/** + @} +*/ + + +//////////////////////////////////// +// SOCKETn register I/O function // +//////////////////////////////////// +/** + @addtogroup Socket_register_access_function_W6300 + @{ +*/ +#define setSn_MR(sn,mr) \ + WIZCHIP_WRITE(_Sn_MR_(sn),(mr)) +#define getSn_MR(sn) \ + WIZCHIP_READ(_Sn_MR_(sn)) + +#define setSn_PSR(sn,psr) \ + WIZCHIP_WRITE(_Sn_PSR_(sn),(psr)) +#define getSn_PSR(sn) \ + WIZCHIP_READ(_Sn_PSR_(sn)) + +#define setSn_CR(sn,cr) \ + WIZCHIP_WRITE(_Sn_CR_(sn),(cr)) +#define getSn_CR(sn) \ + WIZCHIP_READ(_Sn_CR_(sn)) + +#define getSn_IR(sn) \ + WIZCHIP_READ(_Sn_IR_(sn)) + +#define setSn_IMR(sn,imr) \ + WIZCHIP_WRITE(_Sn_IMR_(sn),(imr)) +#define getSn_IMR(sn) \ + WIZCHIP_READ(_Sn_IMR_(sn)) + +#define setSn_IRCLR(sn,irclr) \ + WIZCHIP_WRITE(_Sn_IRCLR_(sn),(irclr)) +#define setSn_IR(sn,ir) setSn_IRCLR(sn,(ir)) + +#define getSn_SR(sn) \ + WIZCHIP_READ(_Sn_SR_(sn)) + +#define getSn_ESR(sn) \ + WIZCHIP_READ(_Sn_ESR_(sn)) + +#define setSn_PNR(sn,pnr) \ + WIZCHIP_WRITE(_Sn_PNR_(sn),(pnr)) +#define setSn_NHR(sn,nhr) setSn_PNR(_Sn_PNR_(sn),(nhr)) + +#define getSn_PNR(sn) \ + WIZCHIP_READ(_Sn_PNR_(sn)) +#define getSn_NHR(sn) getSn_PNR(sn) + +#define setSn_TOSR(sn,tosr) \ + WIZCHIP_WRITE(_Sn_TOSR_(sn),(tosr)) +#define getSn_TOSR(sn) \ + WIZCHIP_READ(_Sn_TOSR_(sn)) +#define getSn_TOS(sn) getSn_TOSR(sn) ///< For compatible ioLibrar +#define setSn_TOS(sn,tos) setSn_TOSR(sn,tos) ///< For compatible ioLibrar + + +#define setSn_TTLR(sn,ttlr) \ + WIZCHIP_WRITE(_Sn_TTLR_(sn),(ttlr)) +#define getSn_TTLR(sn) \ + WIZCHIP_READ(_Sn_TTLR_(sn)) +#define setSn_TTL(sn,ttl) setSn_TTLR(sn,ttl) ///< For compatible ioLibrary +#define getSn_TTL(sn) getSn_TTLR(sn) ///< For compatible ioLibrary + +#define setSn_HOPR(sn,hopr) setSn_TTLR(sn),(ttlr)) +#define getSn_HOPR(sn) getSn_TTLR(sn) + +#define setSn_FRGR(sn,frgr) \ + do{ \ + WIZCHIP_WRITE(_Sn_FRGR_(sn),(uint8_t)((frgr)>>8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(_Sn_FRGR_(sn),1),(uint8_t)(frgr)); \ + }while(0); +#define getSn_FRGR(sn,frgr) \ + ((((uint16_t)WIZCHIP_READ(_Sn_FRGR_(sn))) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(_Sn_FRGR_(sn),1))) + +#define setSn_MSSR(sn,mssr) \ + do{ \ + WIZCHIP_WRITE(_Sn_MSSR_(sn),(uint8_t)((mssr)>>8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(_Sn_MSSR_(sn),1),(uint8_t)(mssr)); \ + }while(0); +#define getSn_MSSR(sn) \ + ((((uint16_t)WIZCHIP_READ(_Sn_MSSR_(sn))) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(_Sn_MSSR_(sn),1))) + +#define setSn_PORTR(sn,portr) \ + do{ \ + WIZCHIP_WRITE(_Sn_PORTR_(sn),(uint8_t)((portr)>>8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(_Sn_PORTR_(sn),1),(uint8_t)(portr)); \ + }while(0); +#define getSn_PORTR(sn) \ + ((((uint16_t)WIZCHIP_READ(_Sn_PORTR_(sn))) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(_Sn_PORTR_(sn),1))) + +#define setSn_DHAR(sn,dhar) \ + WIZCHIP_WRITE_BUF(_Sn_DHAR_(sn),(dhar),6) +#define getSn_DHAR(sn,dhar) \ + WIZCHIP_READ_BUF(_Sn_DHAR_(sn),(dhar),6) + +#define setSn_DIPR(sn,dipr) \ + WIZCHIP_WRITE_BUF(_Sn_DIPR_(sn),(dipr),4) +#define getSn_DIPR(sn,dipr) \ + WIZCHIP_READ_BUF(_Sn_DIPR_(sn),(dipr),4) + +#define setSn_DIP4R(sn,dipr) setSn_DIPR(sn,(dipr)) +#define getSn_DIP4R(sn,dipr) getSn_DIPR(sn,(dipr)) + +#define setSn_DIP6R(sn,dip6r) \ + WIZCHIP_WRITE_BUF(_Sn_DIP6R_(sn),(dip6r),16) +#define getSn_DIP6R(sn,dip6r) \ + WIZCHIP_READ_BUF(_Sn_DIP6R_(sn),(dip6r),16) + +#define setSn_DPORTR(sn,dportr) \ + do{ \ + WIZCHIP_WRITE(_Sn_DPORTR_(sn),(uint8_t)((dportr)>>8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(_Sn_DPORTR_(sn),1),(uint8_t)(dportr)); \ + }while(0); + + +#define getSn_DPORTR(sn) \ + ((((uint16_t)WIZCHIP_READ(_Sn_DPORTR_(sn))) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(_Sn_DPORTR_(sn),1))) + +#define getSn_DPORT(sn) getSn_DPORTR(sn) +#define setSn_DPORT(sn,dportr) setSn_DPORTR(sn,dportr) + + +#define setSn_MR2(sn,mr2) \ + WIZCHIP_WRITE(_Sn_MR2_(sn),(mr2)) +#define getSn_MR2(sn) \ + WIZCHIP_READ(_Sn_MR2_(sn)) + +#define setSn_RTR(sn,rtr) \ + do{ \ + WIZCHIP_WRITE(_Sn_RTR_(sn),(uint8_t)((rtr)>>8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(_Sn_RTR_(sn),1),(uint8_t)(rtr)); \ + }while(0); +#define getSn_RTR(sn) \ + ((((uint16_t)WIZCHIP_READ(_Sn_RTR_(sn))) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(_Sn_RTR_(sn),1))) + +#define setSn_RCR(sn,rcr) \ + WIZCHIP_WRITE(_Sn_RCR_(sn),(rcr)) +#define getSn_RCR(sn) \ + WIZCHIP_READ(_Sn_RCR_(sn)) + +#define setSn_KPALVTR(sn,kpalvtr) \ + WIZCHIP_WRITE(_Sn_KPALVTR_(sn),(kpalvtr)) +#define getSn_KPALVTR(sn) \ + WIZCHIP_READ(_Sn_KPALVTR_(sn)) + +#define setSn_TX_BSR(sn, tmsr) \ + WIZCHIP_WRITE(_Sn_TX_BSR_(sn),(tmsr)) +#define setSn_TXBUF_SIZE(sn, tmsr) setSn_TX_BSR(sn,(tmsr)) + +#define getSn_TX_BSR(sn) \ + WIZCHIP_READ(_Sn_TX_BSR_(sn)) +#define getSn_TXBUF_SIZE(sn) getSn_TX_BSR(sn) + +#define getSn_TxMAX(sn) \ + (getSn_TX_BSR(sn) << 10) + +uint16_t getSn_TX_FSR(uint8_t sn); + +#define getSn_TX_RD(sn) \ + ((((uint16_t)WIZCHIP_READ(_Sn_TX_RD_(sn))) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(_Sn_TX_RD_(sn),1))) + +#define setSn_TX_WR(sn,txwr) \ + do{ \ + WIZCHIP_WRITE(_Sn_TX_WR_(sn), (uint8_t)((txwr)>>8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(_Sn_TX_WR_(sn),1), (uint8_t)(txwr)); \ + }while(0); +#define getSn_TX_WR(sn) \ + (((uint16_t)WIZCHIP_READ(_Sn_TX_WR_(sn)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(_Sn_TX_WR_(sn),1))) + +#define setSn_RX_BSR(sn,rmsr) \ + WIZCHIP_WRITE(_Sn_RX_BSR_(sn),(rmsr)) +#define setSn_RXBUF_SIZE(sn,rmsr) setSn_RX_BSR(sn,(rmsr)) + +#define getSn_RX_BSR(sn) \ + WIZCHIP_READ(_Sn_RX_BSR_(sn)) +#define getSn_RXBUF_SIZE(sn) getSn_RX_BSR(sn) + +#define getSn_RxMAX(sn) \ + (getSn_RX_BSR(sn) <<10) + +uint16_t getSn_RX_RSR(uint8_t s); + +#define setSn_RX_RD(sn,rxrd) \ + do{ \ + WIZCHIP_WRITE(_Sn_RX_RD_(sn), (uint8_t)((rxrd)>>8)); \ + WIZCHIP_WRITE(WIZCHIP_OFFSET_INC(_Sn_RX_RD_(sn),1), (uint8_t)(rxrd)) ; \ + }while(0); + +#define getSn_RX_RD(sn) \ + (((uint16_t)WIZCHIP_READ(_Sn_RX_RD_(sn)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(_Sn_RX_RD_(sn),1))) + +#define getSn_RX_WR(sn) \ + (((uint16_t)WIZCHIP_READ(_Sn_RX_WR_(sn)) << 8) + WIZCHIP_READ(WIZCHIP_OFFSET_INC(_Sn_RX_WR_(sn),1))) +/** + @} +*/ + + +///////////////////////////////////// +// Sn_TXBUF & Sn_RXBUF IO function // +///////////////////////////////////// +/** + @ingroup Basic_IO_function_W6300 + @brief It saves data to be sent in the SOCKETn TX buffer. + @details This function reads first @ref _Sn_TX_WR_ \n + and starts to copy wizdata from @ref _Sn_TX_WR_ address of SOCKETn TX buffer as many as len.\n + After it is completed to copy , \n + It increases @ref _Sn_TX_WR_ as many as len. + @param sn SOCKETn. It should be 0 ~ @ref _WIZCHIP_SOCK_NUM_. + @param wizdata Pointer buffer to write data + @param len Data length + @sa wiz_recv_data() +*/ +void wiz_send_data(uint8_t sn, uint8_t *wizdata, uint16_t len); + +/** + @ingroup Basic_IO_function_W6300 + @brief It reads the received data from the SOCKETn RX buffer and copies the data to your system memory specified by wizdata. + @details This function reads first @ref _Sn_RX_RD_ \n + and starts to copy the received data to wizdata as many as len.\n + After it is completed to copy the received data, \n + It increases @ref _Sn_RX_RD_ as many as len. + @param sn SOCKETn. It should be 0 ~ @ref _WIZCHIP_SOCK_NUM_. + @param wizdata Pointer buffer to read data + @param len Data length + @sa wiz_send_data() +*/ +void wiz_recv_data(uint8_t sn, uint8_t *wizdata, uint16_t len); + +/** + @ingroup Basic_IO_function_W6300 + @brief It discards the received data in the SOCKETn RX buffer. + @details This function discards the received data by increasing @ref _Sn_RX_RD_ as manay as len without coping the data. + @param sn SOCKETn. It should be 0 ~ @ref _WIZCHIP_SOCK_NUM_. + @param len Data length +*/ +void wiz_recv_ignore(uint8_t sn, uint16_t len); + +#if 1 +// 20231019 taylor +/** + @ingroup Special_function_W6300 + @brief Delay function + @details Delay function using internal 100us timer of the W6300 + @param (uint32_t)ms Time to delay in milliseconds. +*/ +void wiz_delay_ms(uint32_t ms); +#endif + +/// @cond DOXY_APPLY_CODE +#if (_PHY_IO_MODE_ == _PHY_IO_MODE_MII_) +/// @endcond +/** + @ingroup Special_function_W6300 + @brief Write data to the PHY via MDC/MDIO interface. + @details Write command data to the PHY via MDC/MDIO interface. + @param phyregaddr Address of the PHY register. It should be @ref PHYRAR_BMCR, @ref PHYRAR_BMSR, and etc. + @param var Data to write to the PHY register. Please refer to the bit definitions of the BMCR and BMSR register. + @note In order to use it, You should define @ref _PHY_IO_MODE_ to @ref _PHY_IO_MODE_MII_. +*/ +void wiz_mdio_write(uint8_t phyregaddr, uint16_t var); + +/** + @ingroup Special_function_W6300 + @brief Read data from the PHY via MDC/MDIO interface. + @details Read command or status data from the PHY via MDC/MDIO interface. + @param phyregaddr Address of the PHY register. It should be @ref PHYRAR_BMCR, @ref PHYRAR_BMSR, and etc. + @return The value of the PHY register + @note In order to use it, You should define @ref _PHY_IO_MODE_ to @ref _PHY_IO_MODE_MII_. +*/ +uint16_t wiz_mdio_read(uint8_t phyregaddr); +/// @cond DOXY_APPLY_CODE +#endif +/// @endcond + +/// @cond DOXY_APPLY_CODE +#endif // _WIZCHIP_ == 6100 +/// @endcond + + +#ifdef __cplusplus +} +#endif + + +#endif //_W6300_H_ \ No newline at end of file diff --git a/Ethernet/socket.c b/Ethernet/socket.c new file mode 100644 index 0000000..4f6ee50 --- /dev/null +++ b/Ethernet/socket.c @@ -0,0 +1,1473 @@ +//***************************************************************************** +// +//! \file socket.c +//! \brief SOCKET APIs Implements file. +//! \details SOCKET APIs like as Berkeley Socket APIs. +//! \version 1.0.3 +//! \date 2013/10/21 +//! \par Revision history +//! <2015/02/05> Notice +//! The version history is not updated after this point. +//! Download the latest version directly from GitHub. Please visit the our GitHub repository for ioLibrary. +//! >> https://github.com/Wiznet/ioLibrary_Driver +//! <2014/05/01> V1.0.3. Refer to M20140501 +//! 1. Implicit type casting -> Explicit type casting. +//! 2. replace 0x01 with PACK_REMAINED in recvfrom() +//! 3. Validation a destination ip in connect() & sendto(): +//! It occurs a fatal error on converting unint32 address if uint8* addr parameter is not aligned by 4byte address. +//! Copy 4 byte addr value into temporary uint32 variable and then compares it. +//! <2013/12/20> V1.0.2 Refer to M20131220 +//! Remove Warning. +//! <2013/11/04> V1.0.1 2nd Release. Refer to "20131104". +//! In sendto(), Add to clear timeout interrupt status (Sn_IR_TIMEOUT) +//! <2013/10/21> 1st Release +//! \author MidnightCow +//! \copyright +//! +//! Copyright (c) 2013, WIZnet Co., 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: +//! +//! * 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 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 "socket.h" + +//M20150401 : Typing Error +//#define SOCK_ANY_PORT_NUM 0xC000; +#define SOCK_ANY_PORT_NUM 0xC000 + +static uint16_t sock_any_port = SOCK_ANY_PORT_NUM; +static uint16_t sock_io_mode = 0; +static uint16_t sock_is_sending = 0; + +static uint16_t sock_remained_size[_WIZCHIP_SOCK_NUM_] = {0, 0,}; + +//M20150601 : For extern decleation +//static uint8_t sock_pack_info[_WIZCHIP_SOCK_NUM_] = {0,}; +uint8_t sock_pack_info[_WIZCHIP_SOCK_NUM_] = {0,}; +// + +#if _WIZCHIP_ == 5200 +static uint16_t sock_next_rd[_WIZCHIP_SOCK_NUM_] = {0,}; +#endif + +//A20150601 : For integrating with W5300 +#if _WIZCHIP_ == 5300 +uint8_t sock_remained_byte[_WIZCHIP_SOCK_NUM_] = {0,}; // set by wiz_recv_data() +#endif + + +#define CHECK_SOCKNUM() \ + do{ \ + if(sn >= _WIZCHIP_SOCK_NUM_) return SOCKERR_SOCKNUM; \ + }while(0); \ + +#define CHECK_SOCKMODE(mode) \ + do{ \ + if((getSn_MR(sn) & 0x0F) != mode) return SOCKERR_SOCKMODE; \ + }while(0); \ + +#define CHECK_TCPMODE() \ + do{ \ + if((getSn_MR(sn) & 0x03) != 0x01) return SOCKERR_SOCKMODE; \ + }while(0); + +#define CHECK_SOCKINIT() \ + do{ \ + if((getSn_SR(sn) != SOCK_INIT)) return SOCKERR_SOCKINIT; \ + }while(0); \ + +#define CHECK_SOCKDATA() \ + do{ \ + if(len == 0) return SOCKERR_DATALEN; \ + }while(0); \ +//teddy 240122 +#if _WIZCHIP_ == W6100 || _WIZCHIP_ == W6300 +#define CHECK_TCPMODE() \ + do{ \ + if((getSn_MR(sn) & 0x03) != 0x01) return SOCKERR_SOCKMODE; \ + }while(0); + +#define CHECK_UDPMODE() \ + do{ \ + if((getSn_MR(sn) & 0x03) != 0x02) return SOCKERR_SOCKMODE; \ + }while(0); + +#define CHECK_IPMODE() \ + do{ \ + if((getSn_MR(sn) & 0x07) != 0x03) return SOCKERR_SOCKMODE; \ + }while(0); + +#define CHECK_DGRAMMODE() \ + do{ \ + if(getSn_MR(sn) == Sn_MR_CLOSED) return SOCKERR_SOCKMODE; \ + if((getSn_MR(sn) & 0x03) == 0x01) return SOCKERR_SOCKMODE; \ + }while(0); + +#define CHECK_IPZERO(addr, addrlen) \ + do{ \ + uint16_t ipzero= 0; \ + for(uint8_t i=0; i W5500) +#define IPV6_AVAILABLE +#endif + +#if 1 + + +#define Sn_MR_TCP4 (Sn_MR_TCP) ///< Refer to @ref Sn_MR_TCP. +#define Sn_MR_UDP4 (Sn_MR_UDP) ///< Refer to @ref Sn_MR_UDP +#define Sn_MR_IPRAW4 (Sn_MR_IPRAW) ///< Refer to @ref Sn_MR_IPRAW. +#define Sn_MR_TCP6 (0x09) +#define Sn_MR_UDP6 (0x0A) //0x1010 +#define Sn_MR_IPRAW6 (0x0B) //0x1011 +#define Sn_MR_TCPD (0x0D) +#define Sn_MR_UDPD (0x0E) + + + +#endif + + +#if 0 // By lihan +static uint8_t addrlenTEST = -1 ; + +void setAddrlen_W6x00(uint8_t num) { + addrlenTEST = num; +} + +uint8_t checkAddrlen_W6x00() { + //if (addrlenTEST < 0 ) + if ((addrlenTEST != 4) && (addrlenTEST != 16)) { + perror("Error: addrlen is not initialized"); + } else { + printf("addrlenTEST %d \r\n", addrlenTEST) ; + } + return addrlenTEST; +} + +inline void inline_setAddrlen_W6x00(uint8_t num) { +#if (_WIZCHIP_ == 6100) || (_WIZCHIP_ == 6300) + setAddrlen_W6x00(num); +#endif +} + +inline uint8_t inline_CheckAddrlen_W6x00(void) { +#if (_WIZCHIP_ == 6100) || (_WIZCHIP_ == 6300) + return checkAddrlen_W6x00(); +#else + return 4; +#endif +} +#endif + + + + +int8_t socket(uint8_t sn, uint8_t protocol, uint16_t port, uint8_t flag) { + + uint8_t taddr[16]; + uint16_t local_port = 0; + CHECK_SOCKNUM(); + switch (protocol & 0x0F) { +#ifdef IPV6_AVAILABLE + case Sn_MR_TCP4 : + getSIPR(taddr); + CHECK_IPZERO(taddr, 4); + break; + case Sn_MR_TCP6 : + getLLAR(taddr); + CHECK_IPZERO(taddr, 16); + //getGUAR(taddr); + //CHECK_IPZERO(taddr, 16); + break; + case Sn_MR_TCPD : + getSIPR(taddr); + CHECK_IPZERO(taddr, 4); + getLLAR(taddr); + CHECK_IPZERO(taddr, 16); + //getGUAR(taddr); + //CHECK_IPZERO(taddr, 16); + break; +#else + case Sn_MR_TCP : { + //M20150601 : Fixed the warning - taddr will never be NULL + /* + uint8_t taddr[4]; + getSIPR(taddr); + */ + uint32_t taddr; + getSIPR((uint8_t*)&taddr); + if (taddr == 0) { + return SOCKERR_SOCKINIT; + } + break; + } +#endif + case Sn_MR_UDP : + case Sn_MR_UDP6 : + case Sn_MR_UDPD : + case Sn_MR_MACRAW : + case Sn_MR_IPRAW4 : + case Sn_MR_IPRAW6 : + break; +#if ( _WIZCHIP_ < 5200 ) + case Sn_MR_PPPoE : + break; +#endif + default : + return SOCKERR_SOCKMODE; + } + //M20150601 : For SF_TCP_ALIGN & W5300 + //if((flag & 0x06) != 0) return SOCKERR_SOCKFLAG; + if ((flag & 0x04) != 0) { + return SOCKERR_SOCKFLAG; + } +#if _WIZCHIP_ == 5200 + if (flag & 0x10) { + return SOCKERR_SOCKFLAG; + } +#endif + + if (flag != 0) { + switch (protocol) { + +#ifdef IPV6_AVAILABLE + case Sn_MR_MACRAW: + if ((flag & (SF_DHA_MANUAL | SF_FORCE_ARP)) != 0) { + return SOCKERR_SOCKFLAG; + } + break; + case Sn_MR_TCP4: + case Sn_MR_TCP6: + case Sn_MR_TCPD: + if ((flag & (SF_MULTI_ENABLE | SF_UNI_BLOCK)) != 0) { + return SOCKERR_SOCKFLAG; + } + break; + case Sn_MR_IPRAW4: + case Sn_MR_IPRAW6: + if (flag != 0) { + return SOCKERR_SOCKFLAG; + } + break; +#else + case Sn_MR_TCP: + //M20150601 : For SF_TCP_ALIGN & W5300 +#if _WIZCHIP_ == 5300 + if ((flag & (SF_TCP_NODELAY | SF_IO_NONBLOCK | SF_TCP_ALIGN)) == 0) { + return SOCKERR_SOCKFLAG; + } +#else + if ((flag & (SF_TCP_NODELAY | SF_IO_NONBLOCK)) == 0) { + return SOCKERR_SOCKFLAG; + } +#endif + + break; + case Sn_MR_UDP: + if (flag & SF_IGMP_VER2) { + if ((flag & SF_MULTI_ENABLE) == 0) { + return SOCKERR_SOCKFLAG; + } + } +#if _WIZCHIP_ == 5500 + if (flag & SF_UNI_BLOCK) { + if ((flag & SF_MULTI_ENABLE) == 0) { + return SOCKERR_SOCKFLAG; + } + } +#endif + break; + +#endif + + default: + break; + } + } + close(sn); + //M20150601 +#if _WIZCHIP_ == 5300 + setSn_MR(sn, ((uint16_t)(protocol | (flag & 0xF0))) | (((uint16_t)(flag & 0x02)) << 7)); +#else + setSn_MR(sn, (protocol | (flag & 0xF0))); +#endif +#ifdef IPV6_AVAILABLE + setSn_MR2(sn, flag & 0x03); +#endif + if (!port) { + port = sock_any_port++; + if (sock_any_port == 0xFFF0) { + sock_any_port = SOCK_ANY_PORT_NUM; + } + } + setSn_PORTR(sn, port); + setSn_CR(sn, Sn_CR_OPEN); + while (getSn_CR(sn)); + //A20150401 : For release the previous sock_io_mode + sock_io_mode &= ~(1 << sn); + // +#ifndef IPV6_AVAILABLE + sock_io_mode |= ((flag & SF_IO_NONBLOCK) << sn); +#else + sock_io_mode |= ((flag & (SF_IO_NONBLOCK >> 3)) << sn); +#endif + sock_is_sending &= ~(1 << sn); + sock_remained_size[sn] = 0; + //M20150601 : repalce 0 with PACK_COMPLETED + //sock_pack_info[sn] = 0; + sock_pack_info[sn] = PACK_COMPLETED;//PACK_COMPLETED //TODO::need verify:LINAN 20250421 + // + while (getSn_SR(sn) == SOCK_CLOSED); + return (int8_t)sn; +} + +int8_t close(uint8_t sn) { + CHECK_SOCKNUM(); + //A20160426 : Applied the erratum 1 of W5300 +#if (_WIZCHIP_ == 5300) + //M20160503 : Wrong socket parameter. s -> sn + //if( ((getSn_MR(s)& 0x0F) == Sn_MR_TCP) && (getSn_TX_FSR(s) != getSn_TxMAX(s)) ) + if (((getSn_MR(sn) & 0x0F) == Sn_MR_TCP) && (getSn_TX_FSR(sn) != getSn_TxMAX(sn))) { + uint8_t destip[4] = {0, 0, 0, 1}; + // TODO + // You can wait for completing to sending data; + // wait about 1 second; + // if you have completed to send data, skip the code of erratum 1 + // ex> wait_1s(); + // if (getSn_TX_FSR(s) == getSn_TxMAX(s)) continue; + // + //M20160503 : The socket() of close() calls close() itself again. It occures a infinite loop - close()->socket()->close()->socket()-> ~ + //socket(s,Sn_MR_UDP,0x3000,0); + //sendto(s,destip,1,destip,0x3000); // send the dummy data to an unknown destination(0.0.0.1). + setSn_MR(sn, Sn_MR_UDP); + setSn_PORTR(sn, 0x3000); + setSn_CR(sn, Sn_CR_OPEN); + while (getSn_CR(sn) != 0); + while (getSn_SR(sn) != SOCK_UDP); + sendto(sn, destip, 1, destip, 0x3000); // send the dummy data to an unknown destination(0.0.0.1). + }; +#endif + setSn_CR(sn, Sn_CR_CLOSE); + /* wait to process the command... */ + while (getSn_CR(sn)); + /* clear all interrupt of SOCKETn. */ + setSn_IR(sn, 0xFF); + //A20150401 : Release the sock_io_mode of socket n. + sock_io_mode &= ~(1 << sn); + // + sock_is_sending &= ~(1 << sn); + sock_remained_size[sn] = 0; + sock_pack_info[sn] = PACK_NONE; + while (getSn_SR(sn) != SOCK_CLOSED); + return SOCK_OK; +} + +int8_t listen(uint8_t sn) { + CHECK_SOCKNUM(); + CHECK_TCPMODE(); + CHECK_SOCKINIT(); + setSn_CR(sn, Sn_CR_LISTEN); + while (getSn_CR(sn)); + while (getSn_SR(sn) != SOCK_LISTEN) { + close(sn); + return SOCKERR_SOCKCLOSED; + } + return SOCK_OK; +} +//int8_t connect (uint8_t sn, uint8_t * addr, uint16_t port ) +int8_t connect_W5x00(uint8_t sn, uint8_t * addr, uint16_t port) { + // printf(" W5x00 - connect - addrlen = %d \r\n" , 4 ); + // #ifdef IPV6_AVAILABLE + // TODO :define how to work, when IPV6_AVAILABLE is defined + // #endif + return connect_IO_6(sn, addr, port, 4); +} + +int8_t connect_W6x00(uint8_t sn, uint8_t * addr, uint16_t port, uint8_t addrlen) { + // printf(" W6x00 - connect - addrlen = %d \r\n" , addrlen ); + // #ifdef IPV6_AVAILABLE + // TODO :define how to work, when IPV6_AVAILABLE is defined + // #endif + return connect_IO_6(sn, addr, port, addrlen); +} + +static int8_t connect_IO_6(uint8_t sn, uint8_t * addr, uint16_t port, uint8_t addrlen) { + + // printf(" connect - addrlen = %d \r\n" , addrlen ); + + CHECK_SOCKNUM(); + CHECK_TCPMODE(); // same macro " CHECK_SOCKMODE(Sn_MR_TCP);" + CHECK_SOCKINIT(); + +#ifdef IPV6_AVAILABLE + CHECK_IPZERO(addr, addrlen); +#else + //M20140501 : For avoiding fatal error on memory align mismatched + //if( *((uint32_t*)addr) == 0xFFFFFFFF || *((uint32_t*)addr) == 0) return SOCKERR_IPINVALID; + { + uint32_t taddr; + taddr = ((uint32_t)addr[0] & 0x000000FF); + taddr = (taddr << 8) + ((uint32_t)addr[1] & 0x000000FF); + taddr = (taddr << 8) + ((uint32_t)addr[2] & 0x000000FF); + taddr = (taddr << 8) + ((uint32_t)addr[3] & 0x000000FF); + if (taddr == 0xFFFFFFFF || taddr == 0) { + return SOCKERR_IPINVALID; + } + } +#endif + + if (port == 0) { + return SOCKERR_PORTZERO; + } + + setSn_DPORTR(sn, port); + + if (addrlen == 16) { // addrlen=16, Sn_MR_TCP6(1001), Sn_MR_TCPD(1101)) +#ifdef IPV6_AVAILABLE + if (getSn_MR(sn) & 0x08) { + setSn_DIP6R(sn, addr); + setSn_CR(sn, Sn_CR_CONNECT6); + } else +#endif + return SOCKERR_SOCKMODE; + } else { // addrlen=4, Sn_MR_TCP4(0001), Sn_MR_TCPD(1101) + if (getSn_MR(sn) == Sn_MR_TCP6) { + return SOCKERR_SOCKMODE; + } + setSn_DIPR(sn, addr); + //setSn_DPORT(sn,port); //TODO::need verify:LINAN 20250421 + setSn_CR(sn, Sn_CR_CONNECT); + } + while (getSn_CR(sn)); + if (sock_io_mode & (1 << sn)) { + return SOCK_BUSY; + } + while (getSn_SR(sn) != SOCK_ESTABLISHED) { + if (getSn_IR(sn) & Sn_IR_TIMEOUT) { + setSn_IR(sn, Sn_IR_TIMEOUT); + return SOCKERR_TIMEOUT; + } + + if (getSn_SR(sn) == SOCK_CLOSED) { + return SOCKERR_SOCKCLOSED; + } + } + + return SOCK_OK; +} + +int8_t disconnect(uint8_t sn) { + CHECK_SOCKNUM(); + CHECK_TCPMODE(); + if (getSn_SR(sn) != SOCK_CLOSED) { + setSn_CR(sn, Sn_CR_DISCON); + /* wait to process the command... */ + while (getSn_CR(sn)); + sock_is_sending &= ~(1 << sn); + if (sock_io_mode & (1 << sn)) { + return SOCK_BUSY; + } + while (getSn_SR(sn) != SOCK_CLOSED) { + if (getSn_IR(sn) & Sn_IR_TIMEOUT) { + close(sn); + return SOCKERR_TIMEOUT; + } + } + } + return SOCK_OK; +} + + +#if 1 +int32_t send(uint8_t sn, uint8_t * buf, uint16_t len) { + uint8_t tmp = 0; + uint16_t freesize = 0; + /* + The below codes can be omitted for optmization of speed + */ + //CHECK_SOCKNUM(); + //CHECK_TCPMODE(Sn_MR_TCP4); + /************/ +#ifndef IPV6_AVAILABLE + CHECK_SOCKNUM(); + CHECK_SOCKMODE(Sn_MR_TCP); + CHECK_SOCKDATA(); + tmp = getSn_SR(sn); + if (tmp != SOCK_ESTABLISHED && tmp != SOCK_CLOSE_WAIT) { + return SOCKERR_SOCKSTATUS; + } + if (sock_is_sending & (1 << sn)) { + tmp = getSn_IR(sn); + if (tmp & Sn_IR_SENDOK) { + setSn_IR(sn, Sn_IR_SENDOK); + //M20150401 : Typing Error + //#if _WZICHIP_ == 5200 +#if _WIZCHIP_ == 5200 + if (getSn_TX_RD(sn) != sock_next_rd[sn]) { + setSn_CR(sn, Sn_CR_SEND); + while (getSn_CR(sn)); + return SOCK_BUSY; + } +#endif + sock_is_sending &= ~(1 << sn); + } else if (tmp & Sn_IR_TIMEOUT) { + close(sn); + return SOCKERR_TIMEOUT; + } else { + return SOCK_BUSY; + } + } +#endif + freesize = getSn_TxMAX(sn); + if (len > freesize) { + len = freesize; // check size not to exceed MAX size. + } + while (1) { + freesize = (uint16_t)getSn_TX_FSR(sn); + tmp = getSn_SR(sn); + if ((tmp != SOCK_ESTABLISHED) && (tmp != SOCK_CLOSE_WAIT)) { + if (tmp == SOCK_CLOSED) { + close(sn); + } + return SOCKERR_SOCKSTATUS; + } + if ((sock_io_mode & (1 << sn)) && (len > freesize)) { + return SOCK_BUSY; //TODO::need verify:LINAN 20250421 + } + // if( sock_io_mode & (1< 4096) len = 4096; // check size not to exceed MAX size.// + //if (len > 8192) len = 8192; // check size not to exceed MAX siz + //if (len > 16384) len = 16384; // check size not to exceed MAX size. + //if (len > 32768) len = 32768; // check size not to exceed MAX size. +#define __FREESIZE__(i) 1024 * i +#define __FREESIZE__Value 8 + if (len > __FREESIZE__(__FREESIZE__Value)) { + len = __FREESIZE__(__FREESIZE__Value); // check size not to exceed MAX size.//tse + } + + while (1) { + freesize = (uint16_t)getSn_TX_FSR(sn); + if (len <= freesize) { + break; + } + } + wiz_send_data(sn, buf, len); + setSn_CR(sn, Sn_CR_SEND); + + while (getSn_CR(sn)); // wait to process the command... + sock_is_sending |= (1 << sn); + + return len; +} +#endif +int32_t recv(uint8_t sn, uint8_t * buf, uint16_t len) { //lihan + uint8_t tmp = 0; + uint16_t recvsize = 0; + /* + The below codes can be omitted for optmization of speed + */ + //A20150601 : For integarating with W5300 +#if _WIZCHIP_ == 5300 + uint8_t head[2]; + uint16_t mr; +#endif + // + CHECK_SOCKNUM(); + CHECK_SOCKMODE(Sn_MR_TCP); + CHECK_SOCKDATA(); + + recvsize = getSn_RxMAX(sn); + if (recvsize < len) { + len = recvsize; + } + + //A20150601 : For Integrating with W5300 +#if _WIZCHIP_ == 5300 + //sock_pack_info[sn] = PACK_COMPLETED; // for clear + if (sock_remained_size[sn] == 0) { +#endif + // + while (1) { + recvsize = (uint16_t)getSn_RX_RSR(sn); + tmp = getSn_SR(sn); + if (tmp != SOCK_ESTABLISHED) { + if (tmp == SOCK_CLOSE_WAIT) { + if (recvsize != 0) { + break; + } else if (getSn_TX_FSR(sn) == getSn_TxMAX(sn)) { + close(sn); + return SOCKERR_SOCKSTATUS; + } + } else { + close(sn); + return SOCKERR_SOCKSTATUS; + } + } +#ifdef IPV6_AVAILABLE + if (recvsize != 0) { + break; + } + if (sock_io_mode & (1 << sn)) { + return SOCK_BUSY; + } +#else + if (sock_io_mode & (1 << sn)) { + return SOCK_BUSY; + } + if (recvsize != 0) { + break; + } +#endif + }; +#if _WIZCHIP_ == 5300 + } +#endif + + //A20150601 : For integrating with W5300 +#if _WIZCHIP_ == 5300 + if ((sock_remained_size[sn] == 0) || (getSn_MR(sn) & Sn_MR_ALIGN)) { + mr = getMR(); + if ((getSn_MR(sn) & Sn_MR_ALIGN) == 0) { + wiz_recv_data(sn, head, 2); + if (mr & MR_FS) { + recvsize = (((uint16_t)head[1]) << 8) | ((uint16_t)head[0]); + } else { + recvsize = (((uint16_t)head[0]) << 8) | ((uint16_t)head[1]); + } + sock_pack_info[sn] = PACK_FIRST; + } + sock_remained_size[sn] = recvsize; + } + if (len > sock_remained_size[sn]) { + len = sock_remained_size[sn]; + } + recvsize = len; + if (sock_pack_info[sn] & PACK_FIFOBYTE) { + *buf = sock_remained_byte[sn]; + buf++; + sock_pack_info[sn] &= ~(PACK_FIFOBYTE); + recvsize -= 1; + sock_remained_size[sn] -= 1; + } + if (recvsize != 0) { + wiz_recv_data(sn, buf, recvsize); + setSn_CR(sn, Sn_CR_RECV); + while (getSn_CR(sn)); + } + sock_remained_size[sn] -= recvsize; + if (sock_remained_size[sn] != 0) { + sock_pack_info[sn] |= PACK_REMAINED; + if (recvsize & 0x1) { + sock_pack_info[sn] |= PACK_FIFOBYTE; + } + } else { + sock_pack_info[sn] = PACK_COMPLETED; + } + if (getSn_MR(sn) & Sn_MR_ALIGN) { + sock_remained_size[sn] = 0; + } + //len = recvsize; +#else + if (recvsize < len) { + len = recvsize; + } + wiz_recv_data(sn, buf, len); + setSn_CR(sn, Sn_CR_RECV); + while (getSn_CR(sn)); +#endif + + //M20150409 : Explicit Type Casting + //return len; + return (int32_t)len; +} + + +int32_t sendto_W5x00(uint8_t sn, uint8_t * buf, uint16_t len, uint8_t * addr, uint16_t port) { + //static int32_t sendto_IO_6(uint8_t sn, uint8_t * buf, uint16_t len, uint8_t * addr, uint16_t port) + // printf("sendto_W5x00\r\n" ) ; + return sendto_IO_6(sn, buf, len, addr, port, 4); +} + +int32_t sendto_W6x00(uint8_t sn, uint8_t * buf, uint16_t len, uint8_t * addr, uint16_t port, uint8_t addrlen) { + // printf("sendto_W6x00\r\n" ) ; + //static int32_t sendto_IO_6(uint8_t sn, uint8_t * buf, uint16_t len, uint8_t * addr, uint16_t port) + return sendto_IO_6(sn, buf, len, addr, port, addrlen); +} + +static int32_t sendto_IO_6(uint8_t sn, uint8_t * buf, uint16_t len, uint8_t * addr, uint16_t port, uint8_t addrlen) { + uint8_t tmp = 0; + uint8_t tcmd = Sn_CR_SEND; + uint16_t freesize = 0; + uint32_t taddr; + + /* + The below codes can be omitted for optmization of speed + */ + CHECK_SOCKNUM(); + //CHECK_DGRAMMODE(); + /************/ + switch (getSn_MR(sn) & 0x0F) { + case Sn_MR_UDP: + case Sn_MR_MACRAW: + // break; + // #if ( _WIZCHIP_ < 5200 ) + case Sn_MR_IPRAW: + case Sn_MR_IPRAW6: + break; + // #endif + default: + return SOCKERR_SOCKMODE; + } + tmp = getSn_MR(sn); + if (tmp != Sn_MR_MACRAW) { + if (addrlen == 16) { // addrlen=16, Sn_MR_UDP6(1010), Sn_MR_UDPD(1110)), IPRAW6(1011) +#ifdef IPV6_AVAILABLE + if (tmp & 0x08) { + setSn_DIP6R(sn, addr); + tcmd = Sn_CR_SEND6; + } else +#endif + return SOCKERR_SOCKMODE; + } else if (addrlen == 4) { // addrlen=4, Sn_MR_UDP4(0010), Sn_MR_UDPD(1110), IPRAW4(0011) + if (tmp == Sn_MR_UDP6 || tmp == Sn_MR_IPRAW6) { + return SOCKERR_SOCKMODE; + } + setSn_DIPR(sn, addr); + tcmd = Sn_CR_SEND; + } else { + return SOCKERR_IPINVALID; + } + } + if ((tmp & 0x03) == 0x02) { // Sn_MR_UPD4(0010), Sn_MR_UDP6(1010), Sn_MR_UDPD(1110) + if (port) { + setSn_DPORTR(sn, port); + } else { + return SOCKERR_PORTZERO; + } + } +#ifndef IPV6_AVAILABLE + CHECK_SOCKDATA(); + //M20140501 : For avoiding fatal error on memory align mismatched + //if(*((uint32_t*)addr) == 0) return SOCKERR_IPINVALID; + //{ + //uint32_t taddr; + taddr = ((uint32_t)addr[0]) & 0x000000FF; + taddr = (taddr << 8) + ((uint32_t)addr[1] & 0x000000FF); + taddr = (taddr << 8) + ((uint32_t)addr[2] & 0x000000FF); + taddr = (taddr << 8) + ((uint32_t)addr[3] & 0x000000FF); + //} + // + //if(*((uint32_t*)addr) == 0) return SOCKERR_IPINVALID; + if ((taddr == 0) && ((getSn_MR(sn)&Sn_MR_MACRAW) != Sn_MR_MACRAW)) { + return SOCKERR_IPINVALID; + } + if ((port == 0) && ((getSn_MR(sn)&Sn_MR_MACRAW) != Sn_MR_MACRAW)) { + return SOCKERR_PORTZERO; + } + tmp = getSn_SR(sn); + //#if ( _WIZCHIP_ < 5200 ) + if ((tmp != SOCK_MACRAW) && (tmp != SOCK_UDP) && (tmp != SOCK_IPRAW)) { + return SOCKERR_SOCKSTATUS; + } + //#else + // if(tmp != SOCK_MACRAW && tmp != SOCK_UDP) return SOCKERR_SOCKSTATUS; + //#endif + + setSn_DIPR(sn, addr); + setSn_DPORT(sn, port); +#endif + + freesize = getSn_TxMAX(sn); + if (len > freesize) { + len = freesize; // check size not to exceed MAX size. + } + + while (1) { + freesize = getSn_TX_FSR(sn); + if (getSn_SR(sn) == SOCK_CLOSED) { + return SOCKERR_SOCKCLOSED; + } + if ((sock_io_mode & (1 << sn)) && (len > freesize)) { + return SOCK_BUSY; + } + if (len <= freesize) { + break; + } + }; + wiz_send_data(sn, buf, len); + +#if _WIZCHIP_ < 5500 //M20150401 : for WIZCHIP Errata #4, #5 (ARP errata) + getSIPR((uint8_t *)&taddr); + if (taddr == 0) { + getSUBR((uint8_t*)&taddr); + setSUBR((uint8_t*)"\x00\x00\x00\x00"); + } else { + taddr = 0; + } +#endif + +#ifdef IPV6_AVAILABLE + setSn_CR(sn, tcmd); +#else + //A20150601 : For W5300 +#if _WIZCHIP_ == 5300 + setSn_TX_WRSR(sn, len); +#endif + // + setSn_CR(sn, Sn_CR_SEND); +#endif + /* wait to process the command... */ + while (getSn_CR(sn)); + while (1) { + tmp = getSn_IR(sn); + if (tmp & Sn_IR_SENDOK) { + setSn_IR(sn, Sn_IR_SENDOK); + break; + } + //M:20131104 + //else if(tmp & Sn_IR_TIMEOUT) return SOCKERR_TIMEOUT; + else if (tmp & Sn_IR_TIMEOUT) { + setSn_IR(sn, Sn_IR_TIMEOUT); + //M20150409 : Fixed the lost of sign bits by type casting. + //len = (uint16_t)SOCKERR_TIMEOUT; + //break; +#if _WIZCHIP_ < 5500 //M20150401 : for WIZCHIP Errata #4, #5 (ARP errata) + if (taddr) { + setSUBR((uint8_t*)&taddr); + } +#endif + return SOCKERR_TIMEOUT; + } + //////////// + } +#if _WIZCHIP_ < 5500 //M20150401 : for WIZCHIP Errata #4, #5 (ARP errata) + if (taddr) { + setSUBR((uint8_t*)&taddr); + } +#endif + //M20150409 : Explicit Type Casting + //return len; + return (int32_t)len; +} + + + +int32_t recvfrom_W5x00(uint8_t sn, uint8_t * buf, uint16_t len, uint8_t * addr, uint16_t *port) { + //int32_t recvfrom_IO_6(uint8_t sn, uint8_t * buf, uint16_t len, uint8_t * addr, uint16_t *port) + // printf("recvfrom_W5x00\r\n" ) ; + uint8_t addrlen = 4; //M20150601 : For W5300 + uint8_t *dummy = &addrlen; + return recvfrom_IO_6(sn, buf, len, addr, port, dummy); +} + +int32_t recvfrom_W6x00(uint8_t sn, uint8_t * buf, uint16_t len, uint8_t * addr, uint16_t *port, uint8_t *addrlen) { + // printf("recvfrom_W6x00\r\n" ) ; + //int32_t recvfrom_IO_6(uint8_t sn, uint8_t * buf, uint16_t len, uint8_t * addr, uint16_t *port) + return recvfrom_IO_6(sn, buf, len, addr, port, addrlen); +} +static int32_t recvfrom_IO_6(uint8_t sn, uint8_t * buf, uint16_t len, uint8_t * addr, uint16_t *port, uint8_t *addrlen) { //TODO : WILL BE IMPROVED + //M20150601 : For W5300 +#if _WIZCHIP_ == 5300 + uint16_t mr; + uint16_t mr1; +#else + uint8_t mr; +#endif + // + uint8_t head[8]; + uint16_t pack_len = 0; + + /* + The below codes can be omitted for optmization of speed + */ + CHECK_SOCKNUM(); + //CHECK_DGRAMMODE(); + //CHECK_SOCKDATA(); + /************/ + //CHECK_SOCKMODE(Sn_MR_UDP); + //A20150601 +#if _WIZCHIP_ == 5300 + mr1 = getMR(); +#endif + + switch ((mr = getSn_MR(sn)) & 0x0F) { + case Sn_MR_UDP: + case Sn_MR_IPRAW: + case Sn_MR_IPRAW6: + case Sn_MR_MACRAW: + break; +#if ( _WIZCHIP_ < 5200 ) + case Sn_MR_PPPoE: + break; +#endif + default: + return SOCKERR_SOCKMODE; + } + CHECK_SOCKDATA(); + if (sock_remained_size[sn] == 0) { + while (1) { + pack_len = getSn_RX_RSR(sn); + if (getSn_SR(sn) == SOCK_CLOSED) { + return SOCKERR_SOCKCLOSED; + } +#ifndef IPV6_AVAILABLE + if ((sock_io_mode & (1 << sn)) && (pack_len == 0)) { + return SOCK_BUSY; + } + if (pack_len != 0) { + break; + } +#else + if (pack_len != 0) { + sock_pack_info[sn] = PACK_NONE; + break; + } + if (sock_io_mode & (1 << sn)) { + return SOCK_BUSY; + } +#endif + }; + } +#ifdef IPV6_AVAILABLE + /* First read 2 bytes of PACKET INFO in SOCKETn RX buffer*/ + wiz_recv_data(sn, head, 2); + setSn_CR(sn, Sn_CR_RECV); + while (getSn_CR(sn)); + pack_len = head[0] & 0x07; + pack_len = (pack_len << 8) + head[1]; +#endif + //D20150601 : Move it to bottom + // sock_pack_info[sn] = PACK_COMPLETED; + switch (mr & 0x07) { + case Sn_MR_UDP4 : + case Sn_MR_UDP6: + case Sn_MR_UDPD: +#ifdef IPV6_AVAILABLE + if (addr == 0) { + return SOCKERR_ARG; + } + + sock_pack_info[sn] = head[0] & 0xF8; + + if (sock_pack_info[sn] & PACK_IPv6) { + *addrlen = 16 ; + } else { + *addrlen = 4 ; + } + wiz_recv_data(sn, addr, *addrlen); + setSn_CR(sn, Sn_CR_RECV); + + while (getSn_CR(sn)); + +#else + if (sock_remained_size[sn] == 0) { + wiz_recv_data(sn, head, 8); + setSn_CR(sn, Sn_CR_RECV); + while (getSn_CR(sn)); + // read peer's IP address, port number & packet length + //A20150601 : For W5300 +#if _WIZCHIP_ == 5300 + if (mr1 & MR_FS) { + addr[0] = head[1]; + addr[1] = head[0]; + addr[2] = head[3]; + addr[3] = head[2]; + *port = head[5]; + *port = (*port << 8) + head[4]; + sock_remained_size[sn] = head[7]; + sock_remained_size[sn] = (sock_remained_size[sn] << 8) + head[6]; + } else { +#endif + addr[0] = head[0]; + addr[1] = head[1]; + addr[2] = head[2]; + addr[3] = head[3]; + *port = head[4]; + *port = (*port << 8) + head[5]; + sock_remained_size[sn] = head[6]; + sock_remained_size[sn] = (sock_remained_size[sn] << 8) + head[7]; +#if _WIZCHIP_ == 5300 + } +#endif + sock_pack_info[sn] = PACK_FIRST; + } + if (len < sock_remained_size[sn]) { + pack_len = len; + } else { + pack_len = sock_remained_size[sn]; + } + //A20150601 : For W5300 + len = pack_len; +#if _WIZCHIP_ == 5300 + if (sock_pack_info[sn] & PACK_FIFOBYTE) { + *buf++ = sock_remained_byte[sn]; + pack_len -= 1; + sock_remained_size[sn] -= 1; + sock_pack_info[sn] &= ~PACK_FIFOBYTE; + } +#endif + // + // Need to packet length check (default 1472) + // + wiz_recv_data(sn, buf, pack_len); // data copy. +#endif + break; + case Sn_MR_MACRAW : + if (sock_remained_size[sn] == 0) { +#ifndef IPV6_AVAILABLE + wiz_recv_data(sn, head, 2); + setSn_CR(sn, Sn_CR_RECV); + while (getSn_CR(sn)); +#endif + // read peer's IP address, port number & packet length + sock_remained_size[sn] = head[0]; + sock_remained_size[sn] = (sock_remained_size[sn] << 8) + head[1] - 2; +#if _WIZCHIP_ == W5300 + if (sock_remained_size[sn] & 0x01) { + sock_remained_size[sn] = sock_remained_size[sn] + 1 - 4; + } else { + sock_remained_size[sn] -= 4; + } +#endif + if (sock_remained_size[sn] > 1514) { + close(sn); + return SOCKFATAL_PACKLEN; + } + sock_pack_info[sn] = PACK_FIRST; + } + if (len < sock_remained_size[sn]) { + pack_len = len; + } else { + pack_len = sock_remained_size[sn]; + } + wiz_recv_data(sn, buf, pack_len); + break; + //#if ( _WIZCHIP_ < 5200 ) + case Sn_MR_IPRAW6: + case Sn_MR_IPRAW4 : + if (sock_remained_size[sn] == 0) { +#ifndef IPV6_AVAILABLE + wiz_recv_data(sn, head, 6); + setSn_CR(sn, Sn_CR_RECV); + while (getSn_CR(sn)); + addr[0] = head[0]; + addr[1] = head[1]; + addr[2] = head[2]; + addr[3] = head[3]; + sock_remained_size[sn] = head[4]; + //M20150401 : For Typing Error + //sock_remaiend_size[sn] = (sock_remained_size[sn] << 8) + head[5]; + sock_remained_size[sn] = (sock_remained_size[sn] << 8) + head[5]; + sock_pack_info[sn] = PACK_FIRST; + // + // Need to packet length check + // + if (len < sock_remained_size[sn]) { + pack_len = len; + } else { + pack_len = sock_remained_size[sn]; + } + wiz_recv_data(sn, buf, pack_len); // data copy. +#else + if (*addr == 0) { + return SOCKERR_ARG; + } + sock_pack_info[sn] = head[0] & 0xF8; + if (sock_pack_info[sn] & PACK_IPv6) { + *addrlen = 16; + } else { + *addrlen = 4; + } + wiz_recv_data(sn, addr, *addrlen); + setSn_CR(sn, Sn_CR_RECV); + while (getSn_CR(sn)); + +#endif + } + break; + default: + wiz_recv_ignore(sn, pack_len); // data copy. + sock_remained_size[sn] = pack_len; + break; + } +#ifdef IPV6_AVAILABLE + sock_remained_size[sn] = pack_len; + sock_pack_info[sn] |= PACK_FIRST; + if ((getSn_MR(sn) & 0x03) == 0x02) { // Sn_MR_UDP4(0010), Sn_MR_UDP6(1010), Sn_MR_UDPD(1110) + /* Read port number of PACKET INFO in SOCKETn RX buffer */ + if (port == 0) { + return SOCKERR_ARG; + } + wiz_recv_data(sn, head, 2); + *port = (((((uint16_t)head[0])) << 8) + head[1]); + setSn_CR(sn, Sn_CR_RECV); + while (getSn_CR(sn)); + } + + if (len < sock_remained_size[sn]) { + pack_len = len; + } else { + pack_len = sock_remained_size[sn]; + } + wiz_recv_data(sn, buf, pack_len); + setSn_CR(sn, Sn_CR_RECV); + /* wait to process the command... */ + while (getSn_CR(sn)) ; + + sock_remained_size[sn] -= pack_len; + if (sock_remained_size[sn] != 0) { + sock_pack_info[sn] |= PACK_REMAINED; + } else { + sock_pack_info[sn] |= PACK_COMPLETED; + } + +#else + setSn_CR(sn, Sn_CR_RECV); + /* wait to process the command... */ + while (getSn_CR(sn)) ; + sock_remained_size[sn] -= pack_len; + //M20150601 : + //if(sock_remained_size[sn] != 0) sock_pack_info[sn] |= 0x01; + if (sock_remained_size[sn] != 0) { + sock_pack_info[sn] |= PACK_REMAINED; +#if _WIZCHIP_ == 5300 + if (pack_len & 0x01) { + sock_pack_info[sn] |= PACK_FIFOBYTE; + } +#endif + } else { + sock_pack_info[sn] = PACK_COMPLETED; + } +#if _WIZCHIP_ == 5300 + pack_len = len; +#endif + // + //M20150409 : Explicit Type Casting + //return pack_len; +#endif + return (int32_t)pack_len; +} + + +int8_t ctlsocket(uint8_t sn, ctlsock_type cstype, void* arg) { + uint8_t tmp = 0; + CHECK_SOCKNUM(); + tmp = *((uint8_t*)arg); + switch (cstype) { + case CS_SET_IOMODE: + if (tmp == SOCK_IO_NONBLOCK) { + sock_io_mode |= (1 << sn); + } else if (tmp == SOCK_IO_BLOCK) { + sock_io_mode &= ~(1 << sn); + } else { + return SOCKERR_ARG; + } + break; + case CS_GET_IOMODE: + //M20140501 : implict type casting -> explict type casting + //*((uint8_t*)arg) = (sock_io_mode >> sn) & 0x0001; + *((uint8_t*)arg) = (uint8_t)((sock_io_mode >> sn) & 0x0001); + // + break; + case CS_GET_MAXTXBUF: + *((uint16_t*)arg) = getSn_TxMAX(sn); + break; + case CS_GET_MAXRXBUF: + *((uint16_t*)arg) = getSn_RxMAX(sn); + break; + case CS_CLR_INTERRUPT: + if (tmp > SIK_ALL) { + return SOCKERR_ARG; + } + setSn_IR(sn, tmp); + break; + case CS_GET_INTERRUPT: + *((uint8_t*)arg) = getSn_IR(sn); + break; +#if _WIZCHIP_ != 5100 + case CS_SET_INTMASK: + if (tmp > SIK_ALL) { + return SOCKERR_ARG; + } + setSn_IMR(sn, tmp); + break; + case CS_GET_INTMASK: + *((uint8_t*)arg) = getSn_IMR(sn); + break; +#endif +#ifdef IPV6_AVAILABLE + case CS_SET_PREFER: + if ((tmp & 0x03) == 0x01) { + return SOCKERR_ARG; + } + setSn_PSR(sn, tmp); + break; + case CS_GET_PREFER: + *(uint8_t*) arg = getSn_PSR(sn); + break; +#endif + default: + return SOCKERR_ARG; + } + return SOCK_OK; +} + +int8_t setsockopt(uint8_t sn, sockopt_type sotype, void* arg) { + // M20131220 : Remove warning + //uint8_t tmp; + CHECK_SOCKNUM(); + switch (sotype) { + case SO_TTL: + setSn_TTL(sn, *(uint8_t*)arg); + break; + case SO_TOS: + setSn_TOS(sn, *(uint8_t*)arg); + break; + case SO_MSS: + setSn_MSSR(sn, *(uint16_t*)arg); + break; + case SO_DESTIP: +#ifdef IPV6_AVAILABLE + if (((wiz_IPAddress *)arg)->len == 16) { + setSn_DIP6R(sn, ((wiz_IPAddress*)arg)->ip); + } else +#endif + setSn_DIPR(sn, (uint8_t*)arg); + break; + case SO_DESTPORT: + setSn_DPORTR(sn, *(uint16_t*)arg); + break; +#if _WIZCHIP_ != 5100 + case SO_KEEPALIVESEND: + CHECK_TCPMODE(); +#if _WIZCHIP_ > 5200 + if (getSn_KPALVTR(sn) != 0) { + return SOCKERR_SOCKOPT; + } +#endif + setSn_CR(sn, Sn_CR_SEND_KEEP); + while (getSn_CR(sn) != 0) { + // M20131220 + //if ((tmp = getSn_IR(sn)) & Sn_IR_TIMEOUT) + if (getSn_IR(sn) & Sn_IR_TIMEOUT) { + setSn_IR(sn, Sn_IR_TIMEOUT); + return SOCKERR_TIMEOUT; + } + } + break; +#if _WIZCHIP_ > 5200 + case SO_KEEPALIVEAUTO: + CHECK_TCPMODE(); + setSn_KPALVTR(sn, *(uint8_t*)arg); + break; +#endif +#endif + default: + return SOCKERR_ARG; + } + return SOCK_OK; +} + +int8_t getsockopt(uint8_t sn, sockopt_type sotype, void* arg) { + CHECK_SOCKNUM(); + switch (sotype) { + case SO_FLAG: +#ifdef IPV6_AVAILABLE + *(uint8_t*)arg = (getSn_MR(sn) & 0xF0) | (getSn_MR2(sn)) | ((uint8_t)(((sock_io_mode >> sn) & 0x0001) << 3)); +#endif + *(uint8_t*)arg = getSn_MR(sn) & 0xF0; + break; + case SO_TTL: + *(uint8_t*) arg = getSn_TTL(sn); + break; + case SO_TOS: + *(uint8_t*) arg = getSn_TOS(sn); + break; + case SO_MSS: + *(uint16_t*) arg = getSn_MSSR(sn); + break; + case SO_DESTIP: +#ifdef IPV6_AVAILABLE + CHECK_TCPMODE(); + if (getSn_ESR(sn) & TCPSOCK_MODE) { //IPv6 ? + getSn_DIP6R(sn, ((wiz_IPAddress*)arg)->ip); + ((wiz_IPAddress*)arg)->len = 16; + } else { + getSn_DIPR(sn, ((wiz_IPAddress*)arg)->ip); + ((wiz_IPAddress*)arg)->len = 4; + } + break; +#else + getSn_DIPR(sn, (uint8_t*)arg); + break; +#endif + case SO_DESTPORT: + *(uint16_t*) arg = getSn_DPORTR(sn); + break; +#if _WIZCHIP_ > 5200 + case SO_KEEPALIVEAUTO: + CHECK_TCPMODE(); + *(uint16_t*) arg = getSn_KPALVTR(sn); + break; +#endif + case SO_SENDBUF: + *(uint16_t*) arg = getSn_TX_FSR(sn); + break; + case SO_RECVBUF: + *(uint16_t*) arg = getSn_RX_RSR(sn); + break; + case SO_STATUS: + *(uint8_t*) arg = getSn_SR(sn); + break; +#ifdef IPV6_AVAILABLE + case SO_EXTSTATUS: + CHECK_TCPMODE(); + *(uint8_t*) arg = getSn_ESR(sn) & 0x07; + break; + case SO_REMAINSIZE: + if (getSn_MR(sn) == SOCK_CLOSED) { + return SOCKERR_SOCKSTATUS; + } + if (getSn_MR(sn) & 0x01) { + *(uint16_t*)arg = getSn_RX_RSR(sn); + } else { + *(uint16_t*)arg = sock_remained_size[sn]; + } + break; + case SO_PACKINFO: + if (getSn_MR(sn) == SOCK_CLOSED) { + return SOCKERR_SOCKSTATUS; + } + if (getSn_MR(sn) & 0x01) { + return SOCKERR_SOCKMODE; + } else { + *(uint8_t*)arg = sock_pack_info[sn]; + } + break; + case SO_MODE: + *(uint8_t*) arg = 0x0F & getSn_MR(sn); + break; +#else + case SO_REMAINSIZE: + if (getSn_MR(sn) & Sn_MR_TCP) { + *(uint16_t*)arg = getSn_RX_RSR(sn); + } else { + *(uint16_t*)arg = sock_remained_size[sn]; + } + break; + case SO_PACKINFO : + //CHECK_SOCKMODE(Sn_MR_TCP); +#if _WIZCHIP_ != 5300 + if ((getSn_MR(sn) == Sn_MR_TCP)) { + return SOCKERR_SOCKMODE; + } +#endif + *(uint8_t*)arg = sock_pack_info[sn]; + break; + +#endif + default: + return SOCKERR_SOCKOPT; + } + return SOCK_OK; +} + +#ifdef IPV6_AVAILABLE +int16_t peeksockmsg(uint8_t sn, uint8_t* submsg, uint16_t subsize) { + uint32_t rx_ptr = 0; + uint16_t i = 0, sub_idx = 0; + + if ((getSn_RX_RSR(sn) > 0) && (subsize > 0)) { + rx_ptr = ((uint32_t)getSn_RX_RD(sn) << 8) + WIZCHIP_RXBUF_BLOCK(sn); + sub_idx = 0; + for (i = 0; i < getSn_RX_RSR(sn) ; i++) { + if (WIZCHIP_READ(rx_ptr) == submsg[sub_idx]) { + sub_idx++; + if (sub_idx == subsize) { + return (i + 1 - sub_idx); + } + } else { + sub_idx = 0; + } + rx_ptr = WIZCHIP_OFFSET_INC(rx_ptr, 1); + } + } + return -1; +} + + +#endif + diff --git a/Ethernet/socket.h b/Ethernet/socket.h new file mode 100644 index 0000000..292844c --- /dev/null +++ b/Ethernet/socket.h @@ -0,0 +1,736 @@ +//***************************************************************************** +// +//! \file socket.h +//! \brief SOCKET APIs Header file. +//! \details SOCKET APIs like as berkeley socket api. +//! \version 1.0.2 +//! \date 2013/10/21 +//! \par Revision history +//! <2015/02/05> Notice +//! The version history is not updated after this point. +//! Download the latest version directly from GitHub. Please visit the our GitHub repository for ioLibrary. +//! >> https://github.com/Wiznet/ioLibrary_Driver +//! <2014/05/01> V1.0.2. Refer to M20140501 +//! 1. Modify the comment : SO_REMAINED -> PACK_REMAINED +//! 2. Add the comment as zero byte udp data reception in getsockopt(). +//! <2013/10/21> 1st Release +//! \author MidnightCow +//! \copyright +//! +//! Copyright (c) 2013, WIZnet Co., 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: +//! +//! * 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 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 WIZnet_socket_APIs 1. WIZnet socket APIs + @brief WIZnet socket APIs are based on Berkeley socket APIs, thus it has much similar name and interface. + But there is a little bit of difference. + @details + Comparison between WIZnet and Berkeley SOCKET APIs + + + + + + + + + + + + +
    API WIZnet Berkeley
    socket() O O
    bind() X O
    listen() O O
    connect() O O
    accept() X O
    recv() O O
    send() O O
    recvfrom() O O
    sendto() O O
    closesocket() O
    close() & disconnect()    		 O
    + There are @b bind() and @b accept() functions in @b Berkeley SOCKET API but, + not in @b WIZnet SOCKET API. Because socket() of WIZnet is not only creating a SOCKET but also binding a local port number, + and listen() of WIZnet is not only listening to connection request from client but also accepting the connection request. \n + When you program "TCP SERVER" with Berkeley SOCKET API, you can use only one listen port. + When the listen SOCKET accepts a connection request from a client, it keeps listening. + After accepting the connection request, a new SOCKET is created and the new SOCKET is used in communication with the client. \n + Following figure shows network flow diagram by Berkeley SOCKET API. + @image html Berkeley_SOCKET.jpg "" + But, When you program "TCP SERVER" with WIZnet SOCKET API, you can use as many as 8 listen SOCKET with same port number. \n + Because there's no accept() in WIZnet SOCKET APIs, when the listen SOCKET accepts a connection request from a client, + it is changed in order to communicate with the client. + And the changed SOCKET is not listening any more and is dedicated for communicating with the client. \n + If there're many listen SOCKET with same listen port number and a client requests a connection, + the SOCKET which has the smallest SOCKET number accepts the request and is changed as communication SOCKET. \n + Following figure shows network flow diagram by WIZnet SOCKET API. + @image html WIZnet_SOCKET.jpg "" +*/ +#ifndef _SOCKET_H_ +#define _SOCKET_H_ +#ifdef __cplusplus +extern "C" { +#endif + +#include "wizchip_conf.h" + +#define SOCKET uint8_t ///< SOCKET type define for legacy driver + +#define SOCK_OK 1 ///< Result is OK about socket process. +#define SOCK_BUSY 0 ///< Socket is busy on processing the operation. Valid only Non-block IO Mode. +#define SOCK_FATAL -1000 ///< Result is fatal error about socket process. + +#define SOCK_ERROR 0 +#define SOCKERR_SOCKNUM (SOCK_ERROR - 1) ///< Invalid socket number +#define SOCKERR_SOCKOPT (SOCK_ERROR - 2) ///< Invalid socket option +#define SOCKERR_SOCKINIT (SOCK_ERROR - 3) ///< Socket is not initialized or SIPR is Zero IP address when Sn_MR_TCP +#define SOCKERR_SOCKCLOSED (SOCK_ERROR - 4) ///< Socket unexpectedly closed. +#define SOCKERR_SOCKMODE (SOCK_ERROR - 5) ///< Invalid socket mode for socket operation. +#define SOCKERR_SOCKFLAG (SOCK_ERROR - 6) ///< Invalid socket flag +#define SOCKERR_SOCKSTATUS (SOCK_ERROR - 7) ///< Invalid socket status for socket operation. +#define SOCKERR_ARG (SOCK_ERROR - 10) ///< Invalid argument. +#define SOCKERR_PORTZERO (SOCK_ERROR - 11) ///< Port number is zero +#define SOCKERR_IPINVALID (SOCK_ERROR - 12) ///< Invalid IP address +#define SOCKERR_TIMEOUT (SOCK_ERROR - 13) ///< Timeout occurred +#define SOCKERR_DATALEN (SOCK_ERROR - 14) ///< Data length is zero or greater than buffer max size. +#define SOCKERR_BUFFER (SOCK_ERROR - 15) ///< Socket buffer is not enough for data communication. + +#define SOCKFATAL_PACKLEN (SOCK_FATAL - 1) ///< Invalid packet length. Fatal Error. + +#if (_WIZCHIP_ == W5100 || _WIZCHIP_ == W5100S || _WIZCHIP_ == W5200 || _WIZCHIP_ == W5300 || _WIZCHIP_ == W5500) +/* + SOCKET FLAG +*/ +#define SF_ETHER_OWN (Sn_MR_MFEN) ///< In @ref Sn_MR_MACRAW, Receive only the packet as broadcast, multicast and own packet +#define SF_IGMP_VER2 (Sn_MR_MC) ///< In @ref Sn_MR_UDP with \ref SF_MULTI_ENABLE, Select IGMP version 2. +#define SF_TCP_NODELAY (Sn_MR_ND) ///< In @ref Sn_MR_TCP, Use to nodelayed ack. +#define SF_MULTI_ENABLE (Sn_MR_MULTI) ///< In @ref Sn_MR_UDP, Enable multicast mode. + +#define Sn_MR2_DHAM (1<<1) +#define SF_DHA_MANUAL (Sn_MR2_DHAM) +#define Sn_MR2_FARP (1<<0) +#define SF_FORCE_ARP (Sn_MR2_FARP) + + +#if _WIZCHIP_ == 5500 +#define SF_BROAD_BLOCK (Sn_MR_BCASTB) ///< In @ref Sn_MR_UDP or @ref Sn_MR_MACRAW, Block broadcast packet. Valid only in W5500 +#define SF_MULTI_BLOCK (Sn_MR_MMB) ///< In @ref Sn_MR_MACRAW, Block multicast packet. Valid only in W5500 +#define SF_IPv6_BLOCK (Sn_MR_MIP6B) ///< In @ref Sn_MR_MACRAW, Block IPv6 packet. Valid only in W5500 +#define SF_UNI_BLOCK (Sn_MR_UCASTB) ///< In @ref Sn_MR_UDP with \ref SF_MULTI_ENABLE. Valid only in W5500 +#endif + +//A201505 : For W5300 +#if _WIZCHIP_ == 5300 +#define SF_TCP_ALIGN 0x02 ///< Valid only \ref Sn_MR_TCP and W5300, refer to \ref Sn_MR_ALIGN +#endif + +#define SF_IO_NONBLOCK 0x01 ///< Socket nonblock io mode. It used parameter in \ref socket(). + +/* + UDP & MACRAW Packet Infomation +*/ +#define PACK_FIRST 0x80 ///< In Non-TCP packet, It indicates to start receiving a packet. (When W5300, This flag can be applied) +#define PACK_REMAINED 0x01 ///< In Non-TCP packet, It indicates to remain a packet to be received. (When W5300, This flag can be applied) +#define PACK_COMPLETED 0x00 ///< In Non-TCP packet, It indicates to complete to receive a packet. (When W5300, This flag can be applied) +//A20150601 : For Integrating with W5300 +#define PACK_FIFOBYTE 0x02 ///< Valid only W5300, It indicate to have read already the Sn_RX_FIFOR. +// +//teddy 240122 + +#define PACK_IPv6 (1<<7) ///< It indicates the destination IP address of the received packet is IPv6 or IPv4. +#define PACK_IPV6_ALLNODE (PACK_IPv6 | (1<<6)) ///< It indicates the destination IP address of the received packet is allnode multicast(broadcast) address or not. +#define PACK_IPV6_MULTI (PACK_IPv6 | (1<<5)) ///< It indicates the destination IP address of the received packet is multicast address or not. +#define PACK_IPV6_LLA (PACK_IPv6 | (1<<4)) ///< It indicates the destination IP address of the received packet is lla or gua. +#define PACK_NONE (0x00) ///< It indicates no information of a packet + +#elif ((_WIZCHIP_ == 6100) || (_WIZCHIP_ == 6300)) + +/* + - @ref Sn_MR_MULTI : Support UDP Multicasting + - @ref Sn_MR_MF : Support MAC Filter Enable + - @ref Sn_MR_BRDB : Broadcast Block + - @ref Sn_MR_FPSH : Force PSH flag + - @ref Sn_MR_ND : No Delay ACK flag + - @ref Sn_MR_MC : IGMP ver2, ver1 + - @ref Sn_MR_SMB : Solicited Multicast Block + - @ref Sn_MR_MMB : IPv4 Multicast block + - @ref Sn_MR_UNIB : Unicast Block + - @ref Sn_MR_MMB6 : IPv6 UDP Multicast Block     + + - @ref Sn_MR2_DHAM : @ref Sn_MR2_DHAM_AUTO, @ref Sn_MR2_DHAM_MANUAL + - @ref Sn_MR_FARP +*/ + +/* + SOCKET FLAG +*/ +/** + @brief In UDP mode such as @ref Sn_MR_UDP4 and @ref Sn_MR_UDP6, @ref Sn_MR_UDP6, Enable multicast mode. When @ref Sn_MR_UDP6, Enable only IPv6 Multicating. +*/ +#define SF_MULTI_ENABLE (Sn_MR_MULTI) +#define SF_ETHER_OWN (Sn_MR_MF) ///< In MACRAW mode such as @ref Sn_MR_MACRAW, Receive only the packet as broadcast, multicast and own packet + +/** + @brief In UDP mode such as @ref Sn_MR_UDP4, @ref Sn_MR_UDP6 and @ref Sn_MR_UDPD, or In MACRAW mode sucha as @ref Sn_MR_MACRAW, Block a broadcast packet. +*/ +#define SF_BROAD_BLOCK (Sn_MR_BRDB) +#define SF_TCP_FPSH (Sn_MR_FPSH) ///< In TCP mode such as @ref Sn_MR_TCP4, @ref Sn_MR_TCP6 and @ref Sn_MR_TCPD, Use to forced push flag. + +#define SF_TCP_NODELAY (Sn_MR_ND) ///< In TCP mode such as @ref Sn_MR_TCP4, @ref Sn_MR_TCP6 and @ref Sn_MR_TCPD, Use to nodelayed ack. +#define SF_IGMP_VER2 (Sn_MR_MC) ///< In UDP mode such as @ref Sn_MR_UDP4 with @ref SF_MULTI_ENABLE, Select IGMP version 2. +#define SF_SOLICIT_BLOCK (Sn_MR_SMB) ///< In UDP mode such as @ref Sn_MR_UDP6 and @ref Sn_MR_UDPD, Block a solicited mutlicast packet. +#define SF_ETHER_MULTI4B (Sn_MR_MMB4) ///< In MACRAW mode such as @ref Sn_MR_MACRAW with @ref SF_MULTI_ENABLE, Block a IPv4 multicast packet. + +#define SF_UNI_BLOCK (Sn_MR_UNIB) ///< In UDP mdoe such as @ref Sn_MR_UDP4, @ref Sn_MR_UDP6 and @ref Sn_MR_UDPD with @ref SF_MULTI_ENABLE, Block a unicast packet. +#define SF_ETHER_MULIT6B (Sn_MR_MMB6) ///< In MACRAW mode such as @ref Sn_MR_MACRAW with @ref SF_MULTI_ENABLE, Block a IPv6 multicast packet. + +/** + @brief Force to APR. + @details In datagram mode such as @ref Sn_MR_IPRAW4, @ref Sn_MR_IPRAW6, @ref Sn_MR_UDP4, @ref Sn_MR_UDP6, and @ref Sn_MR_UDPD, + Force to request ARP before a packet is sent to a destination.\n + In TCP mode such as @ref Sn_MR_TCP4, @ref Sn_MR_TCP6, and @ref Sn_MR_TCPD and TCP SERVER operation mode, + Force to request ARP before SYN/ACK packet is sent to a TCP CLIENT. \n + When @ref SF_DHA_MANUAL is set, the ARP is process but the destination hardware address is fixed by user. +*/ +#define SF_FORCE_ARP (Sn_MR2_FARP) + +/** + @brief The destination hardware address of packet to be transmitted is set by user through @ref _Sn_DHAR_. It is invalid in MACRAW mode such as @ref Sn_MR_MACRAW. +*/ +#define SF_DHA_MANUAL (Sn_MR2_DHAM) + +#define SF_IO_NONBLOCK (0x01 << 3) ///< Socket nonblock io mode. It used parameter in @ref socket(). + +/* + UDP, IPRAW, MACRAW Packet Infomation +*/ +#define PACK_IPv6 (1<<7) ///< It indicates the destination IP address of the received packet is IPv6 or IPv4. +#define PACK_IPV6_ALLNODE (PACK_IPv6 | (1<<6)) ///< It indicates the destination IP address of the received packet is allnode multicast(broadcast) address or not. +#define PACK_IPV6_MULTI (PACK_IPv6 | (1<<5)) ///< It indicates the destination IP address of the received packet is multicast address or not. +#define PACK_IPV6_LLA (PACK_IPv6 | (1<<4)) ///< It indicates the destination IP address of the received packet is lla or gua. +#define PACK_COMPLETED (1<<3) ///< It indicates the read data is last in the received packet. +#define PACK_REMAINED (1<<2) ///< It indicates to remain data in the received packet +#define PACK_FIRST (1<<1) ///< It indicates the read data is first in the received packet. +#define PACK_NONE (0x00) ///< It indicates no information of a packet + +#define SRCV6_PREFER_AUTO (PSR_AUTO) ///< Soruce IPv6 address is preferred to auto-selection. Refer to @ref _Sn_PSR_ +#define SRCV6_PREFER_LLA (PSR_LLA) ///< Soruce IPv6 address is preferred to link local address. Refer to @ref _Sn_PSR_ +#define SRCV6_PREFER_GUA (PSR_GUA) ///< Soruce IPv6 address is preferred to global unique address. Refer to @ref _Sn_PSR_ + +#define TCPSOCK_MODE (Sn_ESR_TCPM) ///< It indicates the IP version when SOCKETn is opened as TCP6 or TCPD mode.(0 - IPv4 , 1 - IPv6) +#define TCPSOCK_OP (Sn_ESR_TCPOP) ///< It indicates the operation mode when SOCKETn is connected.(0 - TCP CLIENT , 1 - TCP SERVER) +#define TCPSOCK_SIP (Sn_ESR_IP6T) ///< It indicates the source ip address type when SOCKET is connected. (0 - Link Local, 1 - Global Unique) + +///////////////////////////// +// SOCKET CONTROL & OPTION // +///////////////////////////// +#define SOCK_IO_BLOCK 0 ///< Socket Block IO Mode in @ref setsockopt(). +#define SOCK_IO_NONBLOCK 1 ///< Socket Non-block IO Mode in @ref setsockopt(). +#endif + +/** + @ingroup WIZnet_socket_APIs + @brief Open a socket. + @details Initializes the socket with 'sn' passed as parameter and open. + + @param sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param protocol Protocol type to operate such as TCP, UDP and MACRAW. + @param port Port number to be bined. + @param flag Socket flags as \ref SF_ETHER_OWN, \ref SF_IGMP_VER2, \ref SF_TCP_NODELAY, \ref SF_MULTI_ENABLE, \ref SF_IO_NONBLOCK and so on.\n + Valid flags only in W5500 : @ref SF_BROAD_BLOCK, @ref SF_MULTI_BLOCK, @ref SF_IPv6_BLOCK, and @ref SF_UNI_BLOCK. + @sa Sn_MR + + @return @b Success : The socket number @b 'sn' passed as parameter\n + @b Fail :\n @ref SOCKERR_SOCKNUM - Invalid socket number\n + @ref SOCKERR_SOCKMODE - Not support socket mode as TCP, UDP, and so on. \n + @ref SOCKERR_SOCKFLAG - Invaild socket flag. +*/ +int8_t socket(uint8_t sn, uint8_t protocol, uint16_t port, uint8_t flag); + +/** + @ingroup WIZnet_socket_APIs + @brief Close a socket. + @details It closes the socket with @b'sn' passed as parameter. + + @param sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + + @return @b Success : @ref SOCK_OK \n + @b Fail : @ref SOCKERR_SOCKNUM - Invalid socket number +*/ +int8_t close(uint8_t sn); + +/** + @ingroup WIZnet_socket_APIs + @brief Listen to a connection request from a client. + @details It is listening to a connection request from a client. + If connection request is accepted successfully, the connection is established. Socket sn is used in passive(server) mode. + + @param sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return @b Success : @ref SOCK_OK \n + @b Fail :\n @ref SOCKERR_SOCKINIT - Socket is not initialized \n + @ref SOCKERR_SOCKCLOSED - Socket closed unexpectedly. +*/ +int8_t listen(uint8_t sn); + +//teddy 240122 +/** + @ingroup WIZnet_socket_APIs + @brief Try to connect to a TCP SERVER. + @details It sends a connection-reqeust message to the server with destination IP address and port number passed as parameter.\n + SOCKET sn is used as active(TCP CLIENT) mode. + @param sn SOCKET number. It should be 0 ~ @ref _WIZCHIP_SOCK_NUM_. + @param addr Pointer variable of destination IPv6 or IPv4 address. + @param port Destination port number. + @param addrlen the length of addr. \n <- removed + If addr is IPv6 address it should be 16,else if addr is IPv4 address it should be 4. Otherwize, return @ref SOCKERR_IPINVALID. + @return Success : @ref SOCK_OK \n + Fail :\n @ref SOCKERR_SOCKNUM - Invalid socket number\n + @ref SOCKERR_SOCKMODE - Invalid socket mode\n + @ref SOCKERR_SOCKINIT - Socket is not initialized\n + @ref SOCKERR_IPINVALID - Wrong server IP address\n + @ref SOCKERR_PORTZERO - Server port zero\n + @ref SOCKERR_TIMEOUT - Timeout occurred during request connection\n + @ref SOCK_BUSY - In non-block io mode, it returns immediately\n + @note It is valid only in TCP client mode. \n + In block io mode, it does not return until connection is completed. \n + In Non-block io mode(@ref SF_IO_NONBLOCK), it returns @ref SOCK_BUSY immediately. +*/ +static int8_t connect_IO_6(uint8_t sn, uint8_t * addr, uint16_t port, uint8_t addrlen); +//int8_t connect(uint8_t sn, uint8_t * addr, uint16_t port, uint8_t addrlen); + +/** + @ingroup WIZnet_socket_APIs + @brief Try to disconnect a connection socket. + @details It sends request message to disconnect the TCP socket 'sn' passed as parameter to the server or client. + @note It is valid only in TCP server or client mode. \n + In block io mode, it does not return until disconnection is completed. \n + In Non-block io mode, it return @ref SOCK_BUSY immediately. \n + + @param sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @return @b Success : @ref SOCK_OK \n + @b Fail :\n @ref SOCKERR_SOCKNUM - Invalid socket number \n + @ref SOCKERR_SOCKMODE - Invalid operation in the socket \n + @ref SOCKERR_TIMEOUT - Timeout occurred \n + @ref SOCK_BUSY - Socket is busy. +*/ +int8_t disconnect(uint8_t sn); + +/** + @ingroup WIZnet_socket_APIs + @brief Send data to the connected peer in TCP socket. + @details It is used to send outgoing data to the connected socket. + @note It is valid only in TCP server or client mode. It can't send data greater than socket buffer size. \n + In block io mode, It doesn't return until data send is completed - socket buffer size is greater than data. \n + In non-block io mode, It return @ref SOCK_BUSY immediately when socket buffer is not enough. \n + @param sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param buf Pointer buffer containing data to be sent. + @param len The byte length of data in buf. + @return @b Success : The sent data size \n + @b Fail : \n @ref SOCKERR_SOCKSTATUS - Invalid socket status for socket operation \n + @ref SOCKERR_TIMEOUT - Timeout occurred \n + @ref SOCKERR_SOCKMODE - Invalid operation in the socket \n + @ref SOCKERR_SOCKNUM - Invalid socket number \n + @ref SOCKERR_DATALEN - zero data length \n + @ref SOCK_BUSY - Socket is busy. +*/ +int32_t send(uint8_t sn, uint8_t * buf, uint16_t len); + +/** + @ingroup WIZnet_socket_APIs + @brief Receive data from the connected peer. + @details It is used to read incoming data from the connected socket.\n + It waits for data as much as the application wants to receive. + @note It is valid only in TCP server or client mode. It can't receive data greater than socket buffer size. \n + In block io mode, it doesn't return until data reception is completed - data is filled as len in socket buffer. \n + In non-block io mode, it return @ref SOCK_BUSY immediately when len is greater than data size in socket buffer. \n + + @param sn Socket number. It should be 0 ~ @ref \_WIZCHIP_SOCK_NUM_. + @param buf Pointer buffer to read incoming data. + @param len The max data length of data in buf. + @return @b Success : The real received data size \n + @b Fail :\n + @ref SOCKERR_SOCKSTATUS - Invalid socket status for socket operation \n + @ref SOCKERR_SOCKMODE - Invalid operation in the socket \n + @ref SOCKERR_SOCKNUM - Invalid socket number \n + @ref SOCKERR_DATALEN - zero data length \n + @ref SOCK_BUSY - Socket is busy. +*/ +int32_t recv(uint8_t sn, uint8_t * buf, uint16_t len); + +/** + @ingroup WIZnet_socket_APIs + @brief Send datagram to the peer specifed by destination IP address and port number passed as parameter. + @details It sends datagram data by using UDP,IPRAW, or MACRAW mode SOCKET. + @param sn SOCKET number. It should be 0 ~ @ref _WIZCHIP_SOCK_NUM_. + @param buf Pointer of data buffer to be sent. + @param len The byte length of data in buf. + @param addr Pointer variable of destination IPv6 or IPv4 address. + @param port Destination port number. + @param addrlen the length of addr. \n + If addr is IPv6 address it should be 16,else if addr is IPv4 address it should be 4. Otherwize, return @ref SOCKERR_IPINVALID. + @return Success : The real sent data size. It may be equal to len or small.\n + Fail :\n @ref SOCKERR_SOCKNUM - Invalid SOCKET number \n + @ref SOCKERR_SOCKMODE - Invalid operation in the SOCKET \n + @ref SOCKERR_SOCKSTATUS - Invalid SOCKET status for SOCKET operation \n + @ref SOCKERR_IPINVALID - Invalid IP address\n + @ref SOCKERR_PORTZERO - Destination port number is zero\n + @ref SOCKERR_DATALEN - Invalid data length \n + @ref SOCKERR_SOCKCLOSED - SOCKET unexpectedly closed \n + @ref SOCKERR_TIMEOUT - Timeout occurred \n + @ref SOCK_BUSY - SOCKET is busy. + @note It is valid only in @ref Sn_MR_UDP4, @ref Sn_MR_UDP6, @ref Sn_MR_UDPD, @ref Sn_MR_IPRAW4, @ref Sn_MR_IPRAW6, and @ref Sn_MR_MACRAW. \n + In UDP mode, It can send data as many as SOCKET RX buffer size if data is greater than SOCKET TX buffer size. \n + In IPRAW and MACRAW mode, It should send data as many as MTU(maxium transmission unit) if data is greater than MTU. That is, len can't exceed to MTU. + In block io mode, It doesn't return until data send is completed. + In non-block io mode(@ref SF_IO_NONBLOCK), It return @ref SOCK_BUSY immediately when SOCKET transimttable buffer size is not enough. +*/ +//int32_t sendto(uint8_t sn, uint8_t * buf, uint16_t len, uint8_t * addr, uint16_t port, uint8_t addrlen); +static int32_t sendto_IO_6(uint8_t sn, uint8_t * buf, uint16_t len, uint8_t * addr, uint16_t port, uint8_t addrlen); + +/** + @ingroup WIZnet_socket_APIs + @brief Receive datagram from a peer + @details It can read a data received from a peer by using UDP, IPRAW, or MACRAW mode SOCKET. + @param sn SOCKET number. It should be 0 ~ @ref _WIZCHIP_SOCK_NUM_. + @param buf Pointer buffer to be saved the received data. + @param len The max read data length. \n + When the received packet size <= len, it can read data as many as the packet size. \n + When others, it can read data as many as len and remain to the rest data of the packet. + @param addr Pointer variable of destination IP address.\n + It is valid only when @ref recvfrom() is first called for receiving the datagram packet. + You can check it valid or not through @ref PACK_FIRST. You can get it through @ref getsockopt(sn, @ref SO_PACKINFO, &packinfo).\n + In UDP4, IPRAW mode SOCKET, it should be allocated over 4bytes. \n + In UDP6, UDPD mode SOCKET, it should be allocated over 16bytes. + @param port Pointer variable of destination port number. \n + It is valid only when @ref recvfrom() is first called for receiving the datagram packet, same as port case. + @param addrlen The byte length of destination IP address. \n + It is valid only when @ref recvfrom() is first called for receiving the datagram packet, same as port case.\n + When the destination has a IPv4 address, it is set to 4. \n + when the destination has a IPv6 address, it is set to 16. + @return Success : The real received data size. It may be equal to len or small.\n + Fail : @ref SOCKERR_SOCKMODE - Invalid operation in the socket \n + @ref SOCKERR_SOCKNUM - Invalid socket number \n + @ref SOCKERR_ARG - Invalid parameter such as addr, port + @ref SOCK_BUSY - SOCKET is busy. + @note It is valid only in @ref Sn_MR_UDP4, @ref Sn_MR_UDP6, @ref Sn_MR_UDPD, @ref Sn_MR_IPRAW4, @ref Sn_MR_IPRAW6, and @ref Sn_MR_MACRAW. \n + When SOCKET is opened with @ref Sn_MR_MACRAW or When it reads the the remained data of the previous datagram packet, + the parameters such as addr, port, addrlen is ignored. \n + Also, It can read data as many as the received datagram packet size if len is greater than the datagram packet size. \n + In block io mode, it doesn't return until data reception is completed. that is, it waits until any datagram packet is received in SOCKET RX buffer. \n + In non-block io mode(@ref SF_IO_NONBLOCK), it return @ref SOCK_BUSY immediately when SOCKET RX buffer is empty. \n +*/ +//int32_t recvfrom(uint8_t sn, uint8_t * buf, uint16_t len, uint8_t * addr, uint16_t *port, uint8_t *addrlen); +static int32_t recvfrom_IO_6(uint8_t sn, uint8_t * buf, uint16_t len, uint8_t * addr, uint16_t *port, uint8_t *addrlen); + + +///////////////////////////// +// SOCKET CONTROL & OPTION // +///////////////////////////// +#define SOCK_IO_BLOCK 0 ///< Socket Block IO Mode in @ref setsockopt(). +#define SOCK_IO_NONBLOCK 1 ///< Socket Non-block IO Mode in @ref setsockopt(). + +/** + @defgroup DATA_TYPE DATA TYPE +*/ + +/** + @ingroup DATA_TYPE + @brief The kind of Socket Interrupt. + @sa Sn_IR, Sn_IMR, setSn_IR(), getSn_IR(), setSn_IMR(), getSn_IMR() +*/ +typedef enum { + SIK_CONNECTED = (1 << 0), ///< connected + SIK_DISCONNECTED = (1 << 1), ///< disconnected + SIK_RECEIVED = (1 << 2), ///< data received + SIK_TIMEOUT = (1 << 3), ///< timeout occurred + SIK_SENT = (1 << 4), ///< send ok + //M20150410 : Remove the comma of last member + //SIK_ALL = 0x1F, ///< all interrupt + SIK_ALL = 0x1F ///< all interrupt +} sockint_kind; + +/** + @ingroup DATA_TYPE + @brief The type of @ref ctlsocket(). +*/ +typedef enum { + CS_SET_IOMODE, ///< set socket IO mode with @ref SOCK_IO_BLOCK or @ref SOCK_IO_NONBLOCK + CS_GET_IOMODE, ///< get socket IO mode + CS_GET_MAXTXBUF, ///< get the size of socket buffer allocated in TX memory + CS_GET_MAXRXBUF, ///< get the size of socket buffer allocated in RX memory + CS_CLR_INTERRUPT, ///< clear the interrupt of socket with @ref sockint_kind + CS_GET_INTERRUPT, ///< get the socket interrupt. refer to @ref sockint_kind + + //teddy 240122 + //#if _WIZCHIP_ == W6100 || _WIZCHIP_ == W6300 + CS_SET_PREFER, ///< set the preferred source IPv6 address of transmission packet.\n Refer to @ref SRCV6_PREFER_AUTO, @ref SRCV6_PREFER_LLA and @ref SRCV6_PREFER_GUA. + CS_GET_PREFER, ///< get the preferred source IPv6 address of transmission packet.\n Refer to @ref SRCV6_PREFER_AUTO, @ref SRCV6_PREFER_LLA and @ref SRCV6_PREFER_GUA. + //#endif +#if _WIZCHIP_ >= 5100 + CS_SET_INTMASK, ///< set the interrupt mask of socket with @ref sockint_kind, Not supported in W5100 + CS_GET_INTMASK ///< get the masked interrupt of socket. refer to @ref sockint_kind, Not supported in W5100 +#endif +} ctlsock_type; + + +/** + @ingroup DATA_TYPE + @brief The type of socket option in @ref setsockopt() or @ref getsockopt() +*/ +typedef enum { + SO_FLAG, ///< Valid only in getsockopt(), For set flag of socket refer to flag in @ref socket(). + SO_TTL, ///< Set TTL. @ref Sn_TTL ( @ref setSn_TTL(), @ref getSn_TTL() ) + SO_TOS, ///< Set TOS. @ref Sn_TOS ( @ref setSn_TOS(), @ref getSn_TOS() ) + SO_MSS, ///< Set MSS. @ref Sn_MSSR ( @ref setSn_MSSR(), @ref getSn_MSSR() ) + SO_DESTIP, ///< Set the destination IP address. @ref Sn_DIPR ( @ref setSn_DIPR(), @ref getSn_DIPR() ) + SO_DESTPORT, ///< Set the destination Port number. @ref Sn_DPORT ( @ref setSn_DPORT(), @ref getSn_DPORT() ) +#if _WIZCHIP_ != 5100 + SO_KEEPALIVESEND, ///< Valid only in setsockopt. Manually send keep-alive packet in TCP mode, Not supported in W5100 +#if !( (_WIZCHIP_ == 5100) || (_WIZCHIP_ == 5200) ) + SO_KEEPALIVEAUTO, ///< Set/Get keep-alive auto transmission timer in TCP mode, Not supported in W5100, W5200 +#endif +#endif + SO_SENDBUF, ///< Valid only in getsockopt. Get the free data size of Socekt TX buffer. @ref Sn_TX_FSR, @ref getSn_TX_FSR() + SO_RECVBUF, ///< Valid only in getsockopt. Get the received data size in socket RX buffer. @ref Sn_RX_RSR, @ref getSn_RX_RSR() + SO_STATUS, ///< Valid only in getsockopt. Get the socket status. @ref Sn_SR, @ref getSn_SR() + + //teddy 240122 + //#if _WIZCHIP_ == W6100 || _WIZCHIP_ == W6300 + SO_EXTSTATUS, ///< Valid only in @ref getsockopt(). Get the extended TCP SOCKETn status. @ref getSn_ESR() + SO_MODE, + //#endif + SO_REMAINSIZE, ///< Valid only in getsockopt. Get the remained packet size in other then TCP mode. + SO_PACKINFO ///< Valid only in getsockopt. Get the packet information as @ref PACK_FIRST, @ref PACK_REMAINED, and @ref PACK_COMPLETED in other then TCP mode. +} sockopt_type; + +/** + @ingroup WIZnet_socket_APIs + @brief Control socket. + @details Control IO mode, Interrupt & Mask of socket and get the socket buffer information. + Refer to @ref ctlsock_type. + @param sn socket number + @param cstype type of control socket. refer to @ref ctlsock_type. + @param arg Data type and value is determined according to @ref ctlsock_type. \n + + + + + +
    @b cstype @b data type@b value
    @ref CS_SET_IOMODE \n @ref CS_GET_IOMODE uint8_t @ref SOCK_IO_BLOCK @ref SOCK_IO_NONBLOCK
    @ref CS_GET_MAXTXBUF \n @ref CS_GET_MAXRXBUF uint16_t 0 ~ 16K
    @ref CS_CLR_INTERRUPT \n @ref CS_GET_INTERRUPT \n @ref CS_SET_INTMASK \n @ref CS_GET_INTMASK @ref sockint_kind @ref SIK_CONNECTED, etc.
    + @return @b Success @ref SOCK_OK \n + @b fail @ref SOCKERR_ARG - Invalid argument\n +*/ +int8_t ctlsocket(uint8_t sn, ctlsock_type cstype, void* arg); + +/** + @ingroup WIZnet_socket_APIs + @brief set socket options + @details Set socket option like as TTL, MSS, TOS, and so on. Refer to @ref sockopt_type. + + @param sn socket number + @param sotype socket option type. refer to @ref sockopt_type + @param arg Data type and value is determined according to sotype. \n + + + + + + + + + +
    @b sotype @b data type@b value
    @ref SO_TTL uint8_t 0 ~ 255
    @ref SO_TOS uint8_t 0 ~ 255
    @ref SO_MSS uint16_t 0 ~ 65535
    @ref SO_DESTIP uint8_t[4]
    @ref SO_DESTPORT uint16_t 0 ~ 65535
    @ref SO_KEEPALIVESEND null null
    @ref SO_KEEPALIVEAUTO uint8_t 0 ~ 255
    + @return + - @b Success : @ref SOCK_OK \n + - @b Fail + - @ref SOCKERR_SOCKNUM - Invalid Socket number \n + - @ref SOCKERR_SOCKMODE - Invalid socket mode \n + - @ref SOCKERR_SOCKOPT - Invalid socket option or its value \n + - @ref SOCKERR_TIMEOUT - Timeout occurred when sending keep-alive packet \n +*/ +int8_t setsockopt(uint8_t sn, sockopt_type sotype, void* arg); + +/** + @ingroup WIZnet_socket_APIs + @brief get socket options + @details Get socket option like as FLAG, TTL, MSS, and so on. Refer to @ref sockopt_type + @param sn socket number + @param sotype socket option type. refer to @ref sockopt_type + @param arg Data type and value is determined according to sotype. \n + + + + + + + + + + + + + +
    @b sotype @b data type@b value
    @ref SO_FLAG uint8_t @ref SF_ETHER_OWN, etc...
    @ref SO_TOS uint8_t 0 ~ 255
    @ref SO_MSS uint16_t 0 ~ 65535
    @ref SO_DESTIP uint8_t[4]
    @ref SO_DESTPORT uint16_t
    @ref SO_KEEPALIVEAUTO uint8_t 0 ~ 255
    @ref SO_SENDBUF uint16_t 0 ~ 65535
    @ref SO_RECVBUF uint16_t 0 ~ 65535
    @ref SO_STATUS uint8_t @ref SOCK_ESTABLISHED, etc..
    @ref SO_REMAINSIZE uint16_t 0~ 65535
    @ref SO_PACKINFO uint8_t @ref PACK_FIRST, etc...
    + @return + - @b Success : @ref SOCK_OK \n + - @b Fail + - @ref SOCKERR_SOCKNUM - Invalid Socket number \n + - @ref SOCKERR_SOCKOPT - Invalid socket option or its value \n + - @ref SOCKERR_SOCKMODE - Invalid socket mode \n + @note + The option as PACK_REMAINED and SO_PACKINFO is valid only in NON-TCP mode and after call @ref recvfrom(). \n + When SO_PACKINFO value is PACK_FIRST and the return value of recvfrom() is zero, + This means the zero byte UDP data(UDP Header only) received. +*/ +int8_t getsockopt(uint8_t sn, sockopt_type sotype, void* arg); + +//teddy 240122 +#if _WIZCHIP_ == W6100 || _WIZCHIP_ == W6300 +/** + @ingroup WIZnet_socket_APIs + @brief Peeks a sub-message in SOCKETn RX buffer + @details It peeks the incoming message of SOCKETn RX buffer. \n + It can find the specified sub-message in the incoming message and + return the length of incoming message before the sub-message. \n + It is useful when you need to read each messages from multiple message in SOCKET RX buffer. + @param sn SOCKET number + @param submsg sub-message pointer to find + @param subsize the length of submsg + @return + - Success : the length of incoming message length before the submsg \n + - Fail : -1 + @note + It is just return the length of incoming message before the found sub-message. It does not receive the message.\n + So, after calling peeksockmsg, @ref _Sn_RX_RD_ is not changed. +*/ +int16_t peeksockmsg(uint8_t sn, uint8_t* submsg, uint16_t subsize); + +#endif + +// void setAddrlen_W6x00( uint8_t num) ; +// uint8_t checkAddrlen_W6x00() ; + +// void inline_setAddrlen_W6x00( uint8_t num); +// uint8_t inline_CheckAddrlen_W6x00( void ); + + +#if 1 // by_Lihan + +/** + @ingroup WIZnet_socket_APIs + @brief by_Lihan_W5x00 +*/ +int8_t connect_W5x00(uint8_t sn, uint8_t * addr, uint16_t port); +/** + @ingroup WIZnet_socket_APIs + @brief by_Lihan_Wx00 +*/ +int8_t connect_W6x00(uint8_t sn, uint8_t * addr, uint16_t port, uint8_t addrlen); + + + + + +#define GET_MACRO_connect(_1, _2, _3, _4, NAME, ...) NAME +#define CHOOSE_TESTCODE_MACRO(...) GET_MACRO_connect(__VA_ARGS__, connect_4, connect_3) + +/** + // by_LIhan for overroading + // NOTE_LIHAN: Some sections of this code are not yet fully defined. + @note + In case of get 3 arguments - int8_t connect_W5x00(uint8_t sn, uint8_t * addr, uint16_t port );\n + In case of get 4 arguments - int8_t connect_W6x00(uint8_t sn, uint8_t * addr, uint16_t port, uint8_t addrlen ); +*/ + +#define connect(...) CHOOSE_TESTCODE_MACRO(__VA_ARGS__)(__VA_ARGS__) + +// In case of get 3 arguments +#define connect_3(sn , addr , port ) connect_W5x00(sn , addr , port) + +// In case of get 4 arguments +#define connect_4(sn , addr , port, addrlen ) connect_W6x00(sn , addr , port,addrlen) + + + + +/** + @ingroup WIZnet_socket_APIs + @brief by_Lihan +*/ +int32_t sendto_W5x00(uint8_t sn, uint8_t * buf, uint16_t len, uint8_t * addr, uint16_t port); +/** + @ingroup WIZnet_socket_APIs + @brief by_Lihan +*/ +int32_t sendto_W6x00(uint8_t sn, uint8_t * buf, uint16_t len, uint8_t * addr, uint16_t port, uint8_t addrlen); + + +#define GET_MACRO_sendto(_1, _2, _3, _4, _5 , _6, NAME, ...) NAME +#define CHOOSE_sendto_MACRO(...) GET_MACRO_sendto(__VA_ARGS__, sendto_6, sendto_5) + +// by_LIhan for overroading +// NOTE_LIHAN: Some sections of this code are not yet fully defined. +// In case of get 3 arguments - int8_t sendto_W5x00(uint8_t sn, uint8_t * addr, uint16_t port ); +// In case of get 4 arguments - int8_t sendto_W6x00(uint8_t sn, uint8_t * addr, uint16_t port,uint8_t addrlen ); +#define sendto(...) CHOOSE_sendto_MACRO(__VA_ARGS__)(__VA_ARGS__) + +// In case of get 3 arguments +#define sendto_5( sn, buf, len, addr, port ) sendto_W5x00( sn, buf, len, addr, port) + +// In case of get 4 arguments +#define sendto_6( sn, buf, len, addr, port, addrlen ) sendto_W6x00( sn, buf, len, addr, port, addrlen) + +/** + @ingroup WIZnet_socket_APIs + @brief byLihan_W5x00 +*/ +int32_t recvfrom_W5x00(uint8_t sn, uint8_t * buf, uint16_t len, uint8_t * addr, uint16_t *port); +/** + @ingroup WIZnet_socket_APIs + @brief byLihan_Wx00 +*/ +int32_t recvfrom_W6x00(uint8_t sn, uint8_t * buf, uint16_t len, uint8_t * addr, uint16_t *port, uint8_t *addrlen); + + +#define GET_MACRO_recvfrom(_1, _2, _3, _4, _5, _6 ,NAME, ...) NAME +#define CHOOSE_recvfrom_MACRO(...) GET_MACRO_recvfrom(__VA_ARGS__, recvfrom_6, recvfrom_5) + +// by_LIhanfor overroading +// In case of get 3 arguments - int8_t recvfrom_W5x00(uint8_t sn, uint8_t * addr, uint16_t port ); +// In case of get 4 arguments - int8_t recvfrom_W6x00(uint8_t sn, uint8_t * addr, uint16_t port,uint8_t addrlen ); +#define recvfrom(...) CHOOSE_recvfrom_MACRO(__VA_ARGS__)(__VA_ARGS__) + +// In case of get 3 arguments +#define recvfrom_5(sn, buf, len, addr, port ) recvfrom_W5x00(sn, buf, len, addr, port) + +// In case of get 4 arguments +#define recvfrom_6(sn, buf, len, addr, port, addrlen ) recvfrom_W6x00(sn, buf, len, addr, port, addrlen ) + + +#endif + + + +#ifdef __cplusplus +} +#endif + +#endif // _SOCKET_H_ + + diff --git a/Ethernet/wizchip_conf.c b/Ethernet/wizchip_conf.c new file mode 100644 index 0000000..9409b60 --- /dev/null +++ b/Ethernet/wizchip_conf.c @@ -0,0 +1,1515 @@ +//****************************************************************************/ +//! +//! \file wizchip_conf.c +//! \brief WIZCHIP Config Header File. +//! \version 1.0.1 +//! \date 2013/10/21 +//! \par Revision history +//! <2015/02/05> Notice +//! The version history is not updated after this point. +//! Download the latest version directly from GitHub. Please visit the our GitHub repository for ioLibrary. +//! >> https://github.com/Wiznet/ioLibrary_Driver +//! <2014/05/01> V1.0.1 Refer to M20140501 +//! 1. Explicit type casting in wizchip_bus_readdata() & wizchip_bus_writedata() +// Issued by Mathias ClauBen. +//! uint32_t type converts into ptrdiff_t first. And then recoverting it into uint8_t* +//! For remove the warning when pointer type size is not 32bit. +//! If ptrdiff_t doesn't support in your complier, You should must replace ptrdiff_t into your suitable pointer type. +//! <2013/10/21> 1st Release +//! \author MidnightCow +//! \copyright +//! +//! Copyright (c) 2013, WIZnet Co., 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: +//! +//! * 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 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. +// +//*****************************************************************************/ +//A20140501 : for use the type - ptrdiff_t +#include +// + +#include "wizchip_conf.h" + +///////////// +//M20150401 : Remove ; in the default callback function such as wizchip_cris_enter(), wizchip_cs_select() and etc. +///////////// + +/** + @brief Default function to enable interrupt. + @note This function help not to access wrong address. If you do not describe this function or register any functions, + null function is called. +*/ +//void wizchip_cris_enter(void) {}; +void wizchip_cris_enter(void) {} + +/** + @brief Default function to disable interrupt. + @note This function help not to access wrong address. If you do not describe this function or register any functions, + null function is called. +*/ +//void wizchip_cris_exit(void) {}; +void wizchip_cris_exit(void) {} + +/** + @brief Default function to select chip. + @note This function help not to access wrong address. If you do not describe this function or register any functions, + null function is called. +*/ +//void wizchip_cs_select(void) {}; +void wizchip_cs_select(void) {} + +/** + @brief Default function to deselect chip. + @note This function help not to access wrong address. If you do not describe this function or register any functions, + null function is called. +*/ +//void wizchip_cs_deselect(void) {}; +void wizchip_cs_deselect(void) {} + +/** + @brief Default function to read in direct or indirect interface. + @note This function help not to access wrong address. If you do not describe this function or register any functions, + null function is called. +*/ +//M20150601 : Rename the function for integrating with W5300 +//uint8_t wizchip_bus_readbyte(uint32_t AddrSel) { return * ((volatile uint8_t *)((ptrdiff_t) AddrSel)); } +iodata_t wizchip_bus_readdata(uint32_t AddrSel) { + return * ((volatile iodata_t *)((ptrdiff_t) AddrSel)); +} + +/** + @brief Default function to write in direct or indirect interface. + @note This function help not to access wrong address. If you do not describe this function or register any functions, + null function is called. +*/ +//M20150601 : Rename the function for integrating with W5300 +//void wizchip_bus_writebyte(uint32_t AddrSel, uint8_t wb) { *((volatile uint8_t*)((ptrdiff_t)AddrSel)) = wb; } +void wizchip_bus_writedata(uint32_t AddrSel, iodata_t wb) { + *((volatile iodata_t*)((ptrdiff_t)AddrSel)) = wb; +} +#if 1 +// 20231103 taylor +/** + @brief Default function to read @ref iodata_t buffer by using BUS interface + @details @ref wizchip_bus_read_buf() provides the default read @ref iodata_t data as many as len from BUS of @ref _WIZCHIP_. + @param AddrSel It specifies the address of register to be read. + @param buf It specifies your buffer pointer to be saved the read data from @ref _WIZCHIP_. + @param len It specifies the data length to be read from @ref _WIZCHIP_. + @param addrinc It specifies whether the address is increased by every read operation or not.\n + 0 : Not Increased \n + 1 : Increased + @return void + @note It can be overwritten with your function or register your functions by calling @ref reg_wizchip_bus_cbfunc(). + @sa wizchip_bus_write_buf() +*/ +void wizchip_bus_read_buf(uint32_t AddrSel, iodata_t* buf, int16_t len, uint8_t addrinc) { + uint16_t i; + if (addrinc) { + addrinc = sizeof(iodata_t); + } + for (i = 0; i < len; i++) { + *buf++ = WIZCHIP.IF.BUS._read_data(AddrSel); + AddrSel += (uint32_t) addrinc; + } +} + +/** + @brief Default function to write @ref iodata_t buffer by using BUS interface. + @details @ref wizchip_bus_write_buf() provides the default write @ref iodata_t data as many as len to BUS of @ref _WIZCHIP_. + @param AddrSel It specifies the address of register to be written. + @param buf It specifies your buffer pointer to be written to @ref _WIZCHIP_. + @param len It specifies the data length to be written to @ref _WIZCHIP_. + @param addrinc It specifies whether the address is increased by every write operation or not.\n + 0 : Not Increased \n + 1 : Increased + @return void + @note It can be overwritten with your function or register your functions by calling @ref reg_wizchip_bus_cbfunc(). + @sa wizchip_bus_read_buf() +*/ +void wizchip_bus_write_buf(uint32_t AddrSel, iodata_t* buf, int16_t len, uint8_t addrinc) { + uint16_t i; + if (addrinc) { + addrinc = sizeof(iodata_t); + } + for (i = 0; i < len ; i++) { + WIZCHIP.IF.BUS._write_data(AddrSel, *buf++); + AddrSel += (uint32_t)addrinc; + } + +} +#endif + +/** + @brief Default function to read in SPI interface. + @note This function help not to access wrong address. If you do not describe this function or register any functions, + null function is called. +*/ +//uint8_t wizchip_spi_readbyte(void) {return 0;}; +uint8_t wizchip_spi_readbyte(void) { + return 0; +} + +/** + @brief Default function to write in SPI interface. + @note This function help not to access wrong address. If you do not describe this function or register any functions, + null function is called. +*/ +//void wizchip_spi_writebyte(uint8_t wb) {}; +void wizchip_spi_writebyte(uint8_t wb) {} + +/** + @brief Default function to burst read in SPI interface. + @note This function help not to access wrong address. If you do not describe this function or register any functions, + null function is called. +*/ +//void wizchip_spi_readburst(uint8_t* pBuf, uint16_t len) {}; +#if 1 +// 20231018 taylor +void wizchip_spi_readburst(uint8_t* pBuf, uint16_t len) { + for (uint16_t i = 0; i < len; i++) { + *pBuf++ = WIZCHIP.IF.SPI._read_byte(); + } +} +#else +void wizchip_spi_readburst(uint8_t* pBuf, uint16_t len) {} +#endif + +/** + @brief Default function to burst write in SPI interface. + @note This function help not to access wrong address. If you do not describe this function or register any functions, + null function is called. +*/ +//void wizchip_spi_writeburst(uint8_t* pBuf, uint16_t len) {}; +#if 1 +// 20231018 taylor +void wizchip_spi_writeburst(uint8_t* pBuf, uint16_t len) { + for (uint16_t i = 0; i < len; i++) { + WIZCHIP.IF.SPI._write_byte(*pBuf++); + } +} +#else +void wizchip_spi_writeburst(uint8_t* pBuf, uint16_t len) {} +#endif +#if 1 //teddy 240122 + +/** + @brief Default function to read in QSPI interface. + @note This function help not to access wrong address. If you do not describe this function or register any functions, + null function is called. +*/ +void wizchip_qspi_read(uint8_t opcode, uint16_t addr, uint8_t* pBuf, uint16_t len) {} + +/** + @brief Default function to write in QSPI interface. + @note This function help not to access wrong address. If you do not describe this function or register any functions, + null function is called. +*/ +void wizchip_qspi_write(uint8_t opcode, uint16_t addr, uint8_t* pBuf, uint16_t len) {} + +#endif +/** + @\ref _WIZCHIP instance +*/ +// +//M20150401 : For a compiler didnot support a member of structure +// Replace the assignment of struct members with the assingment of array +// +/* + _WIZCHIP WIZCHIP = + { + .id = _WIZCHIP_ID_, + .if_mode = _WIZCHIP_IO_MODE_, + .CRIS._enter = wizchip_cris_enter, + .CRIS._exit = wizchip_cris_exit, + .CS._select = wizchip_cs_select, + .CS._deselect = wizchip_cs_deselect, + .IF.BUS._read_byte = wizchip_bus_readbyte, + .IF.BUS._write_byte = wizchip_bus_writebyte + // .IF.SPI._read_byte = wizchip_spi_readbyte, + // .IF.SPI._write_byte = wizchip_spi_writebyte + }; +*/ +_WIZCHIP WIZCHIP = { + _WIZCHIP_IO_MODE_, + _WIZCHIP_ID_, + { + wizchip_cris_enter, + wizchip_cris_exit + }, + { + wizchip_cs_select, + wizchip_cs_deselect + }, + { + { + //M20150601 : Rename the function + //wizchip_bus_readbyte, + //wizchip_bus_writebyte + wizchip_bus_readdata, + wizchip_bus_writedata + }, + + } +}; + + +static uint8_t _DNS_[4]; // DNS server ip address +#if (_WIZCHIP_ == W5100 || _WIZCHIP_ == W5100S || _WIZCHIP_ == W5200 || _WIZCHIP_ == W5300 || _WIZCHIP_ == W5500) +static dhcp_mode _DHCP_; // DHCP mode +//teddy 240122 +#elif ((_WIZCHIP_ == 6100) || (_WIZCHIP_ == 6300)) +static uint8_t _DNS6_[16]; ///< DSN server IPv6 address +static ipconf_mode _IPMODE_; ///< IP configuration mode +#endif + +void reg_wizchip_cris_cbfunc(void(*cris_en)(void), void(*cris_ex)(void)) { + if (!cris_en || !cris_ex) { + WIZCHIP.CRIS._enter = wizchip_cris_enter; + WIZCHIP.CRIS._exit = wizchip_cris_exit; + } else { + WIZCHIP.CRIS._enter = cris_en; + WIZCHIP.CRIS._exit = cris_ex; + } +} + +void reg_wizchip_cs_cbfunc(void(*cs_sel)(void), void(*cs_desel)(void)) { + if (!cs_sel || !cs_desel) { + WIZCHIP.CS._select = wizchip_cs_select; + WIZCHIP.CS._deselect = wizchip_cs_deselect; + } else { + WIZCHIP.CS._select = cs_sel; + WIZCHIP.CS._deselect = cs_desel; + } +} + +//M20150515 : For integrating with W5300 +//void reg_wizchip_bus_cbfunc(uint8_t(*bus_rb)(uint32_t addr), void (*bus_wb)(uint32_t addr, uint8_t wb)) +void reg_wizchip_bus_cbfunc(iodata_t(*bus_rb)(uint32_t addr), void (*bus_wb)(uint32_t addr, iodata_t wb)) { + while (!(WIZCHIP.if_mode & _WIZCHIP_IO_MODE_BUS_)); + //M20150601 : Rename call back function for integrating with W5300 + /* + if(!bus_rb || !bus_wb) + { + WIZCHIP.IF.BUS._read_byte = wizchip_bus_readbyte; + WIZCHIP.IF.BUS._write_byte = wizchip_bus_writebyte; + } + else + { + WIZCHIP.IF.BUS._read_byte = bus_rb; + WIZCHIP.IF.BUS._write_byte = bus_wb; + } + */ + if (!bus_rb || !bus_wb) { + WIZCHIP.IF.BUS._read_data = wizchip_bus_readdata; + WIZCHIP.IF.BUS._write_data = wizchip_bus_writedata; + } else { + WIZCHIP.IF.BUS._read_data = bus_rb; + WIZCHIP.IF.BUS._write_data = bus_wb; + } +} +#if 1 +// 20231103 taylor +void reg_wizchip_busbuf_cbfunc(void(*busbuf_rb)(uint32_t AddrSel, iodata_t* pBuf, int16_t len, uint8_t addrinc), void (*busbuf_wb)(uint32_t AddrSel, iodata_t* pBuf, int16_t len, uint8_t addrinc)) { + while (!(WIZCHIP.if_mode & _WIZCHIP_IO_MODE_BUS_)); + //M20150601 : Rename call back function for integrating with W5300 + /* + if(!bus_rb || !bus_wb) + { + WIZCHIP.IF.BUS._read_byte = wizchip_bus_readbyte; + WIZCHIP.IF.BUS._write_byte = wizchip_bus_writebyte; + } + else + { + WIZCHIP.IF.BUS._read_byte = bus_rb; + WIZCHIP.IF.BUS._write_byte = bus_wb; + } + */ + if (!busbuf_rb || !busbuf_wb) { + WIZCHIP.IF.BUS._read_data_buf = wizchip_bus_read_buf; + WIZCHIP.IF.BUS._write_data_buf = wizchip_bus_write_buf; + } else { + WIZCHIP.IF.BUS._read_data_buf = busbuf_rb; + WIZCHIP.IF.BUS._write_data_buf = busbuf_wb; + } +} +#endif + +#if _WIZCHIP_ == W6100 + +void reg_wizchip_spi_cbfunc(uint8_t (*spi_rb)(void), + void (*spi_wb)(uint8_t wb), + void (*spi_rbuf)(uint8_t* buf, datasize_t len), + void (*spi_wbuf)(uint8_t* buf, datasize_t len)) { + while (!(WIZCHIP.if_mode & _WIZCHIP_IO_MODE_SPI_)); + + if (!spi_rb) { + WIZCHIP.IF.SPI._read_byte = wizchip_spi_readbyte; + } else { + WIZCHIP.IF.SPI._read_byte = spi_rb; + } + if (!spi_wb) { + WIZCHIP.IF.SPI._write_byte = wizchip_spi_writebyte; + } else { + WIZCHIP.IF.SPI._write_byte = spi_wb; + } + + if (!spi_rbuf) { + WIZCHIP.IF.SPI._read_burst = wizchip_spi_readburst; + } else { + WIZCHIP.IF.SPI._read_burst = spi_rbuf; + } + if (!spi_wbuf) { + WIZCHIP.IF.SPI._write_burst = wizchip_spi_writeburst; + } else { + WIZCHIP.IF.SPI._write_burst = spi_wbuf; + } +} +#else + +void reg_wizchip_spi_cbfunc(uint8_t (*spi_rb)(void), void (*spi_wb)(uint8_t wb)) { + while (!(WIZCHIP.if_mode & _WIZCHIP_IO_MODE_SPI_)); + + if (!spi_rb || !spi_wb) { + WIZCHIP.IF.SPI._read_byte = wizchip_spi_readbyte; + WIZCHIP.IF.SPI._write_byte = wizchip_spi_writebyte; + } else { + WIZCHIP.IF.SPI._read_byte = spi_rb; + WIZCHIP.IF.SPI._write_byte = spi_wb; + } +} +#endif + +// 20140626 Eric Added for SPI burst operations +void reg_wizchip_spiburst_cbfunc(void (*spi_rb)(uint8_t* pBuf, uint16_t len), void (*spi_wb)(uint8_t* pBuf, uint16_t len)) { + while (!(WIZCHIP.if_mode & _WIZCHIP_IO_MODE_SPI_)); + + if (!spi_rb || !spi_wb) { + WIZCHIP.IF.SPI._read_burst = wizchip_spi_readburst; + WIZCHIP.IF.SPI._write_burst = wizchip_spi_writeburst; + } else { + WIZCHIP.IF.SPI._read_burst = spi_rb; + WIZCHIP.IF.SPI._write_burst = spi_wb; + } +} +#if 1 //teddy 240122 +void reg_wizchip_qspi_cbfunc(void (*qspi_rb)(uint8_t opcode, uint16_t addr, uint8_t* pBuf, uint16_t len), + void (*qspi_wb)(uint8_t opcode, uint16_t addr, uint8_t* pBuf, uint16_t len)) { + while (!(WIZCHIP.if_mode & _WIZCHIP_IO_MODE_SPI_QSPI_)); + + if (!qspi_rb || !qspi_wb) { + WIZCHIP.IF.QSPI._read_qspi = wizchip_qspi_read; + WIZCHIP.IF.QSPI._write_qspi = wizchip_qspi_write; + } else { + WIZCHIP.IF.QSPI._read_qspi = qspi_rb; + WIZCHIP.IF.QSPI._write_qspi = qspi_wb; + } +} +#endif + +int8_t ctlwizchip(ctlwizchip_type cwtype, void* arg) { + //teddy 240122 +#if _WIZCHIP_ == W5100S || _WIZCHIP_ == W5200 || _WIZCHIP_ == W5500 || _WIZCHIP_ == W6100 || _WIZCHIP_ == W6300 + uint8_t tmp = *(uint8_t*) arg; +#endif + uint8_t* ptmp[2] = {0, 0}; + switch (cwtype) { + //teddy 240122 +#if _WIZCHIP_ == W6100 || _WIZCHIP_ == W6300 + case CW_SYS_LOCK: + if (tmp & SYS_CHIP_LOCK) { + CHIPLOCK(); + } + if (tmp & SYS_NET_LOCK) { + NETLOCK(); + } + if (tmp & SYS_PHY_LOCK) { + PHYLOCK(); + } + break; + case CW_SYS_UNLOCK: + if (tmp & SYS_CHIP_LOCK) { + CHIPUNLOCK(); + } + if (tmp & SYS_NET_LOCK) { + NETUNLOCK(); + } + if (tmp & SYS_PHY_LOCK) { + PHYUNLOCK(); + } + break; + case CW_GET_SYSLOCK: + *(uint8_t*)arg = getSYSR() >> 5; + break; +#endif + case CW_RESET_WIZCHIP: + wizchip_sw_reset(); + break; + case CW_INIT_WIZCHIP: + if (arg != 0) { + ptmp[0] = (uint8_t*)arg; + ptmp[1] = ptmp[0] + _WIZCHIP_SOCK_NUM_; + } + return wizchip_init(ptmp[0], ptmp[1]); + case CW_CLR_INTERRUPT: + wizchip_clrinterrupt(*((intr_kind*)arg)); + break; + case CW_GET_INTERRUPT: + *((intr_kind*)arg) = wizchip_getinterrupt(); + break; + case CW_SET_INTRMASK: + wizchip_setinterruptmask(*((intr_kind*)arg)); + break; + case CW_GET_INTRMASK: + *((intr_kind*)arg) = wizchip_getinterruptmask(); + break; + //M20150601 : This can be supported by W5200, W5500 + //#if _WIZCHIP_ > W5100 +#if (_WIZCHIP_ == W5200 || _WIZCHIP_ == W5500) + case CW_SET_INTRTIME: + setINTLEVEL(*(uint16_t*)arg); + break; + case CW_GET_INTRTIME: + *(uint16_t*)arg = getINTLEVEL(); + break; + //teddy 240122 +#elif ((_WIZCHIP_ == W6100) || (_WIZCHIP_ == W6300)) + case CW_SET_INTRTIME: + setINTPTMR(*(uint16_t*)arg); + break; + case CW_GET_INTRTIME: + *(uint16_t*)arg = getINTPTMR(); + break; +#endif + case CW_GET_ID: + ((uint8_t*)arg)[0] = WIZCHIP.id[0]; + ((uint8_t*)arg)[1] = WIZCHIP.id[1]; + ((uint8_t*)arg)[2] = WIZCHIP.id[2]; + ((uint8_t*)arg)[3] = WIZCHIP.id[3]; + ((uint8_t*)arg)[4] = WIZCHIP.id[4]; + ((uint8_t*)arg)[5] = WIZCHIP.id[5]; + ((uint8_t*)arg)[6] = 0; + break; +#if 1 + // 20231017 taylor//teddy 240122 +#if _WIZCHIP_ == W6100 || _WIZCHIP_ == W6300 + case CW_GET_VER: + *(uint16_t*)arg = getVER(); + break; +#endif +#endif + //teddy 240122 +#if _WIZCHIP_ == W5100S || _WIZCHIP_ == W5500 || _WIZCHIP_ == W6100 || _WIZCHIP_ == W6300 + case CW_RESET_PHY: + wizphy_reset(); + break; + case CW_SET_PHYCONF: + wizphy_setphyconf((wiz_PhyConf*)arg); + break; + case CW_GET_PHYCONF: + wizphy_getphyconf((wiz_PhyConf*)arg); + break; + case CW_GET_PHYSTATUS: +#if 1 + // 20231012 taylor +#if _WIZCHIP_ == W5500 + wizphy_getphystat((wiz_PhyConf*)arg); +#endif +#else + wizphy_getphystat((wiz_PhyConf*)arg); +#endif + break; + case CW_SET_PHYPOWMODE: + //teddy 240122 +#if _WIZCHIP_ == W6100 ||_WIZCHIP_ == W6300 + wizphy_setphypmode(*(uint8_t*)arg); + break; +#else + return wizphy_setphypmode(*(uint8_t*)arg); +#endif +#endif + //teddy 240122 +#if _WIZCHIP_ == W5100S || _WIZCHIP_ == W5200 || _WIZCHIP_ == W5500 || _WIZCHIP_ == W6100 || _WIZCHIP_ == W6300 + case CW_GET_PHYPOWMODE: + tmp = wizphy_getphypmode(); + if ((int8_t)tmp == -1) { + return -1; + } + *(uint8_t*)arg = tmp; + break; + case CW_GET_PHYLINK: + tmp = wizphy_getphylink(); + if ((int8_t)tmp == -1) { + return -1; + } + *(uint8_t*)arg = tmp; + break; +#endif + default: + return -1; + } + return 0; +} + + +int8_t ctlnetwork(ctlnetwork_type cntype, void* arg) { + + switch (cntype) { + case CN_SET_NETINFO: + wizchip_setnetinfo((wiz_NetInfo*)arg); + break; + case CN_GET_NETINFO: + wizchip_getnetinfo((wiz_NetInfo*)arg); + break; + case CN_SET_NETMODE: +#if (_WIZCHIP_ == W5100 || _WIZCHIP_ == W5100S || _WIZCHIP_ == W5200 || _WIZCHIP_ == W5300 || _WIZCHIP_ == W5500) + return wizchip_setnetmode(*(netmode_type*)arg); + //teddy 240122 +#elif ((_WIZCHIP_ == 6100)||(_WIZCHIP_ == W6300)) + wizchip_setnetmode(*(netmode_type*)arg); +#endif + case CN_GET_NETMODE: + *(netmode_type*)arg = wizchip_getnetmode(); + break; + case CN_SET_TIMEOUT: + wizchip_settimeout((wiz_NetTimeout*)arg); + break; + case CN_GET_TIMEOUT: + wizchip_gettimeout((wiz_NetTimeout*)arg); + break; + //teddy 240122 +#if ((_WIZCHIP_ == 6100)||(_WIZCHIP_ == 6300)) + case CN_SET_PREFER: + setSLPSR(*(uint8_t*)arg); + break; + case CN_GET_PREFER: + *(uint8_t*)arg = getSLPSR(); + break; +#endif + default: + return -1; + } + return 0; +} + +void wizchip_sw_reset(void) { + uint8_t gw[4], sn[4], sip[4]; + uint8_t mac[6]; + //teddy 240122 +#if ((_WIZCHIP_ == 6100) ||(_WIZCHIP_ == 6300)) + uint8_t gw6[16], sn6[16], lla[16], gua[16]; + uint8_t islock = getSYSR(); +#endif + +#if (_WIZCHIP_ == W5100 || _WIZCHIP_ == W5100S || _WIZCHIP_ == W5200 || _WIZCHIP_ == W5300 || _WIZCHIP_ == W5500) + //A20150601 +#if _WIZCHIP_IO_MODE_ == _WIZCHIP_IO_MODE_BUS_INDIR_ + uint16_t mr = (uint16_t)getMR(); + setMR(mr | MR_IND); +#endif + // + getSHAR(mac); + getGAR(gw); getSUBR(sn); getSIPR(sip); + setMR(MR_RST); + getMR(); // for delay + //A2015051 : For indirect bus mode +#if _WIZCHIP_IO_MODE_ == _WIZCHIP_IO_MODE_BUS_INDIR_ + setMR(mr | MR_IND); +#endif + // + setSHAR(mac); + setGAR(gw); + setSUBR(sn); + setSIPR(sip); + //teddy 240122 +#elif ((_WIZCHIP_ == W6100)||(_WIZCHIP_ == W6300)) + CHIPUNLOCK(); + + getSHAR(mac); + getGAR(gw); getSUBR(sn); getSIPR(sip); getGA6R(gw6); getSUB6R(sn6); getLLAR(lla); getGUAR(gua); + setSYCR0(SYCR0_RST); + getSYCR0(); // for delay + + NETUNLOCK(); + + setSHAR(mac); + setGAR(gw); + setSUBR(sn); + setSIPR(sip); + setGA6R(gw6); + setSUB6R(sn6); + setLLAR(lla); + setGUAR(gua); + if (islock & SYSR_CHPL) { + CHIPLOCK(); + } + if (islock & SYSR_NETL) { + NETLOCK(); + } +#endif +} + +int8_t wizchip_init(uint8_t* txsize, uint8_t* rxsize) { + int8_t i; +#if _WIZCHIP_ < W5200 + int8_t j; +#endif + int8_t tmp = 0; + wizchip_sw_reset(); + if (txsize) { + tmp = 0; + //M20150601 : For integrating with W5300 +#if _WIZCHIP_ == W5300 + for (i = 0 ; i < _WIZCHIP_SOCK_NUM_; i++) { + if (txsize[i] > 64) { + return -1; //No use 64KB even if W5300 support max 64KB memory allocation + } + tmp += txsize[i]; + if (tmp > 128) { + return -1; + } + } + if (tmp % 8) { + return -1; + } +#else + for (i = 0 ; i < _WIZCHIP_SOCK_NUM_; i++) { + tmp += txsize[i]; + +#if _WIZCHIP_ < W5200 //2016.10.28 peter add condition for w5100 and w5100s + if (tmp > 8) { + return -1; + } +#elif _WIZCHIP_ == W6300 + if (tmp > 32) { + return -1; + } +#else + if (tmp > 16) { + return -1; + } +#endif + } +#endif + for (i = 0 ; i < _WIZCHIP_SOCK_NUM_; i++) { +#if _WIZCHIP_ < W5200 //2016.10.28 peter add condition for w5100 + j = 0; + while ((txsize[i] >> j != 1) && (txsize[i] != 0)) { + j++; + } + setSn_TXBUF_SIZE(i, j); +#else + setSn_TXBUF_SIZE(i, txsize[i]); +#endif + } + } + + if (rxsize) { + tmp = 0; +#if _WIZCHIP_ == W5300 + for (i = 0 ; i < _WIZCHIP_SOCK_NUM_; i++) { + if (rxsize[i] > 64) { + return -1; //No use 64KB even if W5300 support max 64KB memory allocation + } + tmp += rxsize[i]; + if (tmp > 128) { + return -1; + } + } + if (tmp % 8) { + return -1; + } +#else + for (i = 0 ; i < _WIZCHIP_SOCK_NUM_; i++) { + tmp += rxsize[i]; +#if _WIZCHIP_ < W5200 //2016.10.28 peter add condition for w5100 and w5100s + if (tmp > 8) { + return -1; + } +#elif _WIZCHIP_ == W6300 + if (tmp > 32) { + return -1; + } +#else + if (tmp > 16) { + return -1; + } +#endif + } +#endif + for (i = 0 ; i < _WIZCHIP_SOCK_NUM_; i++) { +#if _WIZCHIP_ < W5200 // add condition for w5100 + j = 0; + while ((rxsize[i] >> j != 1) && (txsize[i] != 0)) { + j++; + } + setSn_RXBUF_SIZE(i, j); +#else + setSn_RXBUF_SIZE(i, rxsize[i]); +#endif + } + } + return 0; +} + +void wizchip_clrinterrupt(intr_kind intr) { + uint8_t ir = (uint8_t)intr; + uint8_t sir = (uint8_t)((uint16_t)intr >> 8); + + //teddy 240122 +#if _WIZCHIP_ == W6100 || _WIZCHIP_ == W6300 + int i; + uint8_t slir = (uint8_t)((uint32_t)intr >> 16); + setIRCLR(ir); + for (i = 0; i < _WIZCHIP_SOCK_NUM_; i++) { + if (sir & (1 << i)) { + setSn_IRCLR(i, 0xFF); + } + } + setSLIRCLR(slir); + return; +#endif + +#if _WIZCHIP_ < W5500 + ir |= (1 << 4); // IK_WOL +#endif +#if _WIZCHIP_ == W5200 + ir |= (1 << 6); +#endif + +#if _WIZCHIP_ < W5200 + sir &= 0x0F; +#endif + +#if _WIZCHIP_ <= W5100S + ir |= sir; + setIR(ir); + //A20150601 : For integrating with W5300 +#elif _WIZCHIP_ == W5300 + setIR(((((uint16_t)ir) << 8) | (((uint16_t)sir) & 0x00FF))); +#else + setIR(ir); + //M20200227 : For clear + //setSIR(sir); + for (ir = 0; ir < 8; ir++) { + if (sir & (0x01 << ir)) { + setSn_IR(ir, 0xff); + } + } + +#endif +} + +intr_kind wizchip_getinterrupt(void) { + uint8_t ir = 0; + uint8_t sir = 0; + uint32_t ret = 0; + +#if _WIZCHIP_ <= W5100S + ir = getIR(); + sir = ir & 0x0F; + //A20150601 : For integrating with W5300 +#elif _WIZCHIP_ == W5300 + ret = getIR(); + ir = (uint8_t)(ret >> 8); + sir = (uint8_t)ret; +#else + ir = getIR(); + sir = getSIR(); +#endif + + //M20150601 : For Integrating with W5300 + //#if _WIZCHIP_ < W5500 +#if _WIZCHIP_ < W5200 + ir &= ~(1 << 4); // IK_WOL +#endif +#if _WIZCHIP_ == W5200 + ir &= ~(1 << 6); +#endif + ret = sir; + ret = (ret << 8) + ir; + //teddy 240122 +#if _WIZCHIP_ == W6100 || _WIZCHIP_ == W6300 + ret = (((uint32_t)getSLIR()) << 16) | ret; +#endif + + return (intr_kind)ret; +} + +void wizchip_setinterruptmask(intr_kind intr) { + uint8_t imr = (uint8_t)intr; + uint8_t simr = (uint8_t)((uint16_t)intr >> 8); +#if _WIZCHIP_ < W5500 + imr &= ~(1 << 4); // IK_WOL +#endif +#if _WIZCHIP_ == W5200 + imr &= ~(1 << 6); +#endif + +#if _WIZCHIP_ < W5200 + simr &= 0x0F; + imr |= simr; + setIMR(imr); + //A20150601 : For integrating with W5300 +#elif _WIZCHIP_ == W5300 + setIMR(((((uint16_t)imr) << 8) | (((uint16_t)simr) & 0x00FF))); +#else + setIMR(imr); + setSIMR(simr); + //teddy 240122 +#if _WIZCHIP_ == W6100 || _WIZCHIP_ == W6300 + uint8_t slimr = (uint8_t)((uint32_t)intr >> 16); + setSLIMR(slimr); +#endif +#endif +} + +intr_kind wizchip_getinterruptmask(void) { + uint8_t imr = 0; + uint8_t simr = 0; + uint32_t ret = 0; +#if _WIZCHIP_ < W5200 + imr = getIMR(); + simr = imr & 0x0F; + //A20150601 : For integrating with W5300 +#elif _WIZCHIP_ == W5300 + ret = getIMR(); + imr = (uint8_t)(ret >> 8); + simr = (uint8_t)ret; +#else + imr = getIMR(); + simr = getSIMR(); +#endif + +#if _WIZCHIP_ < W5500 + imr &= ~(1 << 4); // IK_WOL +#endif +#if _WIZCHIP_ == W5200 + imr &= ~(1 << 6); // IK_DEST_UNREACH +#endif + ret = simr; + ret = (ret << 8) + imr; + + //teddy 240122 +#if _WIZCHIP_ == W6100 || _WIZCHIP_ == W6300 + ret = (((uint32_t)getSLIMR()) << 16) | ret; +#endif + + return (intr_kind)ret; +} + +int8_t wizphy_getphylink(void) { + int8_t tmp = PHY_LINK_OFF; +#if _WIZCHIP_ == W5100S + if (getPHYSR() & PHYSR_LNK) { + tmp = PHY_LINK_ON; + } +#elif _WIZCHIP_ == W5200 + if (getPHYSTATUS() & PHYSTATUS_LINK) { + tmp = PHY_LINK_ON; + } +#elif _WIZCHIP_ == W5500 + if (getPHYCFGR() & PHYCFGR_LNK_ON) { + tmp = PHY_LINK_ON; + } + +#elif ((_WIZCHIP_ == W6100)||(_WIZCHIP_ == W6300)) + +#if (_PHY_IO_MODE_ == _PHY_IO_MODE_PHYCR_) + return (getPHYSR() & PHYSR_LNK); +#elif (_PHY_IO_MODE_ == _PHY_IO_MODE_MII_) + if (wiz_mdio_read(PHYRAR_BMSR) & BMSR_LINK_STATUS) { + return PHY_LINK_ON; + } + return PHY_LINK_OFF; +#endif + +#else + tmp = -1; +#endif + return tmp; +} + +#if _WIZCHIP_ > W5100 + +int8_t wizphy_getphypmode(void) { + int8_t tmp = 0; +#if _WIZCHIP_ == W5200 + if (getPHYSTATUS() & PHYSTATUS_POWERDOWN) { + tmp = PHY_POWER_DOWN; + } else { + tmp = PHY_POWER_NORM; + } +#elif _WIZCHIP_ == 5500 + if ((getPHYCFGR() & PHYCFGR_OPMDC_ALLA) == PHYCFGR_OPMDC_PDOWN) { + tmp = PHY_POWER_DOWN; + } else { + tmp = PHY_POWER_NORM; + } + //teddy 240122 +#elif _WIZCHIP_ == W6100 || _WIZCHIP_ == W6300 +#if (_PHY_IO_MODE_ == _PHY_IO_MODE_PHYCR_) + if (getPHYCR1() & PHYCR1_PWDN) { + return PHY_POWER_DOWN; + } +#elif (_PHY_IO_MODE_ == _PHY_IO_MODE_MII_) + if (wiz_mdio_read(PHYRAR_BMCR) & BMCR_PWDN) { + return PHY_POWER_DOWN; + } +#endif + return PHY_POWER_NORM; +#else + tmp = -1; +#endif + return tmp; +} +#endif + +#if _WIZCHIP_ == W5100S +void wizphy_reset(void) { + uint16_t tmp = wiz_mdio_read(PHYMDIO_BMCR); + tmp |= BMCR_RESET; + wiz_mdio_write(PHYMDIO_BMCR, tmp); + while (wiz_mdio_read(PHYMDIO_BMCR)&BMCR_RESET) {} +} + +void wizphy_setphyconf(wiz_PhyConf* phyconf) { + uint16_t tmp = wiz_mdio_read(PHYMDIO_BMCR); + if (phyconf->mode == PHY_MODE_AUTONEGO) { + tmp |= BMCR_AUTONEGO; + } else { + tmp &= ~BMCR_AUTONEGO; + if (phyconf->duplex == PHY_DUPLEX_FULL) { + tmp |= BMCR_DUP; + } else { + tmp &= ~BMCR_DUP; + } + if (phyconf->speed == PHY_SPEED_100) { + tmp |= BMCR_SPEED; + } else { + tmp &= ~BMCR_SPEED; + } + } + wiz_mdio_write(PHYMDIO_BMCR, tmp); +} + +void wizphy_getphyconf(wiz_PhyConf* phyconf) { + uint16_t tmp = 0; + tmp = wiz_mdio_read(PHYMDIO_BMCR); + phyconf->by = PHY_CONFBY_SW; + if (tmp & BMCR_AUTONEGO) { + phyconf->mode = PHY_MODE_AUTONEGO; + } else { + phyconf->mode = PHY_MODE_MANUAL; + if (tmp & BMCR_DUP) { + phyconf->duplex = PHY_DUPLEX_FULL; + } else { + phyconf->duplex = PHY_DUPLEX_HALF; + } + if (tmp & BMCR_SPEED) { + phyconf->speed = PHY_SPEED_100; + } else { + phyconf->speed = PHY_SPEED_10; + } + } +} + +int8_t wizphy_setphypmode(uint8_t pmode) { + uint16_t tmp = 0; + tmp = wiz_mdio_read(PHYMDIO_BMCR); + if (pmode == PHY_POWER_DOWN) { + tmp |= BMCR_PWDN; + } else { + tmp &= ~BMCR_PWDN; + } + wiz_mdio_write(PHYMDIO_BMCR, tmp); + tmp = wiz_mdio_read(PHYMDIO_BMCR); + if (pmode == PHY_POWER_DOWN) { + if (tmp & BMCR_PWDN) { + return 0; + } + } else { + if ((tmp & BMCR_PWDN) != BMCR_PWDN) { + return 0; + } + } + return -1; +} + +#elif _WIZCHIP_ == W5500 +void wizphy_reset(void) { + uint8_t tmp = getPHYCFGR(); + tmp &= PHYCFGR_RST; + setPHYCFGR(tmp); + tmp = getPHYCFGR(); + tmp |= ~PHYCFGR_RST; + setPHYCFGR(tmp); +} + +void wizphy_setphyconf(wiz_PhyConf* phyconf) { + uint8_t tmp = 0; + if (phyconf->by == PHY_CONFBY_SW) { + tmp |= PHYCFGR_OPMD; + } else { + tmp &= ~PHYCFGR_OPMD; + } + if (phyconf->mode == PHY_MODE_AUTONEGO) { + tmp |= PHYCFGR_OPMDC_ALLA; + } else { + if (phyconf->duplex == PHY_DUPLEX_FULL) { + if (phyconf->speed == PHY_SPEED_100) { + tmp |= PHYCFGR_OPMDC_100F; + } else { + tmp |= PHYCFGR_OPMDC_10F; + } + } else { + if (phyconf->speed == PHY_SPEED_100) { + tmp |= PHYCFGR_OPMDC_100H; + } else { + tmp |= PHYCFGR_OPMDC_10H; + } + } + } + setPHYCFGR(tmp); + wizphy_reset(); +} + +void wizphy_getphyconf(wiz_PhyConf* phyconf) { + uint8_t tmp = 0; + tmp = getPHYCFGR(); + phyconf->by = (tmp & PHYCFGR_OPMD) ? PHY_CONFBY_SW : PHY_CONFBY_HW; + switch (tmp & PHYCFGR_OPMDC_ALLA) { + case PHYCFGR_OPMDC_ALLA: + case PHYCFGR_OPMDC_100FA: + phyconf->mode = PHY_MODE_AUTONEGO; + break; + default: + phyconf->mode = PHY_MODE_MANUAL; + break; + } + switch (tmp & PHYCFGR_OPMDC_ALLA) { + case PHYCFGR_OPMDC_100FA: + case PHYCFGR_OPMDC_100F: + case PHYCFGR_OPMDC_100H: + phyconf->speed = PHY_SPEED_100; + break; + default: + phyconf->speed = PHY_SPEED_10; + break; + } + switch (tmp & PHYCFGR_OPMDC_ALLA) { + case PHYCFGR_OPMDC_100FA: + case PHYCFGR_OPMDC_100F: + case PHYCFGR_OPMDC_10F: + phyconf->duplex = PHY_DUPLEX_FULL; + break; + default: + phyconf->duplex = PHY_DUPLEX_HALF; + break; + } +} + +void wizphy_getphystat(wiz_PhyConf* phyconf) { + uint8_t tmp = getPHYCFGR(); + phyconf->duplex = (tmp & PHYCFGR_DPX_FULL) ? PHY_DUPLEX_FULL : PHY_DUPLEX_HALF; + phyconf->speed = (tmp & PHYCFGR_SPD_100) ? PHY_SPEED_100 : PHY_SPEED_10; +} + +int8_t wizphy_setphypmode(uint8_t pmode) { + uint8_t tmp = 0; + tmp = getPHYCFGR(); + if ((tmp & PHYCFGR_OPMD) == 0) { + return -1; + } + tmp &= ~PHYCFGR_OPMDC_ALLA; + if (pmode == PHY_POWER_DOWN) { + tmp |= PHYCFGR_OPMDC_PDOWN; + } else { + tmp |= PHYCFGR_OPMDC_ALLA; + } + setPHYCFGR(tmp); + wizphy_reset(); + tmp = getPHYCFGR(); + if (pmode == PHY_POWER_DOWN) { + if (tmp & PHYCFGR_OPMDC_PDOWN) { + return 0; + } + } else { + if (tmp & PHYCFGR_OPMDC_ALLA) { + return 0; + } + } + return -1; +} + +//teddy 240122 +#elif _WIZCHIP_ == W6100 || _WIZCHIP_ == W6300 +void wizphy_reset(void) { +#if (_PHY_IO_MODE_ == _PHY_IO_MODE_PHYCR_) + uint8_t tmp = getPHYCR1() | PHYCR1_RST; + PHYUNLOCK(); + setPHYCR1(tmp); + PHYLOCK(); +#elif (_PHY_IO_MODE_ == _PHY_IO_MODE_MII_) + wiz_mdio_write(PHYRAR_BMCR, wiz_mdio_read(PHYRAR_BMCR) | BMCR_RST); + while (wiz_mdio_read(PHYRAR_BMCR) & BMCR_RST); +#endif +} + +void wizphy_setphyconf(wiz_PhyConf* phyconf) { +#if (_PHY_IO_MODE_ == _PHY_IO_MODE_PHYCR_) + uint8_t tmp = 0; + if (phyconf->mode == PHY_MODE_TE) { + setPHYCR1(getPHYCR1() | PHYCR1_TE); + tmp = PHYCR0_AUTO; + } else { + setPHYCR1(getPHYCR1() & ~PHYCR1_TE); + if (phyconf->mode == PHY_MODE_AUTONEGO) { + tmp = PHYCR0_AUTO; + } else { + tmp |= 0x04; + if (phyconf->speed == PHY_SPEED_10) { + tmp |= 0x02; + } + if (phyconf->duplex == PHY_DUPLEX_HALF) { + tmp |= 0x01; + } + } + } + setPHYCR0(tmp); +#elif (_PHY_IO_MODE_ == _PHY_IO_MODE_MII_) + uint16_t tmp = wiz_mdio_read(PHYRAR_BMCR); + if (phyconf->mode == PHY_MODE_TE) { + setPHYCR1(getPHYCR1() | PHYCR1_TE); + setPHYCR0(PHYCR0_AUTO); + } else { + setPHYCR1(getPHYCR1() & ~PHYCR1_TE); + if (phyconf->mode == PHY_MODE_AUTONEGO) { + tmp |= BMCR_ANE; + } else { + tmp &= ~(BMCR_ANE | BMCR_DPX | BMCR_SPD); + if (phyconf->duplex == PHY_DUPLEX_FULL) { + tmp |= BMCR_DPX; + } + if (phyconf->speed == PHY_SPEED_100) { + tmp |= BMCR_SPD; + } + } + wiz_mdio_write(PHYRAR_BMCR, tmp); + } +#endif +} + +void wizphy_getphyconf(wiz_PhyConf* phyconf) { +#if (_PHY_IO_MODE_ == _PHY_IO_MODE_PHYCR_) + uint8_t tmp = 0; + tmp = getPHYSR(); + if (getPHYCR1() & PHYCR1_TE) { + phyconf->mode = PHY_MODE_TE; + } else { + phyconf->mode = (tmp & (1 << 5)) ? PHY_MODE_MANUAL : PHY_MODE_AUTONEGO ; + } + phyconf->speed = (tmp & (1 << 4)) ? PHY_SPEED_10 : PHY_SPEED_100; + phyconf->duplex = (tmp & (1 << 3)) ? PHY_DUPLEX_HALF : PHY_DUPLEX_FULL; +#elif (_PHY_IO_MODE_ == _PHY_IO_MODE_MII_) + uint16_t tmp = 0; + tmp = wiz_mdio_read(PHYRAR_BMCR); + if (getPHYCR1() & PHYCR1_TE) { + phyconf->mode = PHY_MODE_TE; + } else { + phyconf->mode = (tmp & BMCR_ANE) ? PHY_MODE_AUTONEGO : PHY_MODE_MANUAL; + } + phyconf->duplex = (tmp & BMCR_DPX) ? PHY_DUPLEX_FULL : PHY_DUPLEX_HALF; + phyconf->speed = (tmp & BMCR_SPD) ? PHY_SPEED_100 : PHY_SPEED_10; +#endif +} + +void wizphy_getphystat(wiz_PhyConf* phyconf) { + uint8_t tmp = 0; + tmp = getPHYSR(); + if (getPHYCR1() & PHYCR1_TE) { + phyconf->mode = PHY_MODE_TE; + } else { + phyconf->mode = (tmp & (1 << 5)) ? PHY_MODE_MANUAL : PHY_MODE_AUTONEGO ; + } + phyconf->speed = (tmp & PHYSR_SPD) ? PHY_SPEED_10 : PHY_SPEED_100; + phyconf->duplex = (tmp & PHYSR_DPX) ? PHY_DUPLEX_HALF : PHY_DUPLEX_FULL; +} + +void wizphy_setphypmode(uint8_t pmode) { +#if (_PHY_IO_MODE_ == _PHY_IO_MODE_PHYCR_) + uint8_t tmp = getPHYCR1(); + if (pmode == PHY_POWER_DOWN) { + tmp |= PHYCR1_PWDN; + } else { + tmp &= ~PHYCR1_PWDN; + } + setPHYCR1(tmp); +#elif (_PHY_IO_MODE_ == _PHY_IO_MODE_MII_) + uint16_t tmp = 0; + tmp = wiz_mdio_read(PHYRAR_BMCR); + if (pmode == PHY_POWER_DOWN) { + tmp |= BMCR_PWDN; + } else { + tmp &= ~BMCR_PWDN; + } + wiz_mdio_write(PHYRAR_BMCR, tmp); +#endif +} + +int8_t wizchip_arp(wiz_ARP* arp) { + uint8_t tmp; + if (arp->destinfo.len == 16) { + setSLDIP6R(arp->destinfo.ip); + setSLCR(SLCR_ARP6); + } else { + setSLDIP4R(arp->destinfo.ip); + setSLCR(SLCR_ARP4); + } + while (getSLCR()); + while ((tmp = getSLIR()) == 0x00); + setSLIRCLR(~SLIR_RA); + if (tmp & (SLIR_ARP4 | SLIR_ARP6)) { + getSLDHAR(arp->dha); + return 0; + } + return -1; +} + +int8_t wizchip_ping(wiz_PING* ping) { + uint8_t tmp; + setPINGIDR(ping->id); + setPINGSEQR(ping->seq); + if (ping->destinfo.len == 16) { + setSLDIP6R(ping->destinfo.ip); + setSLCR(SLCR_PING6); + } else { + setSLDIP4R(ping->destinfo.ip); + setSLCR(SLCR_PING4); + } + while (getSLCR()); + while ((tmp = getSLIR()) == 0x00); + setSLIRCLR(~SLIR_RA); + if (tmp & (SLIR_PING4 | SLIR_PING6)) { + return 0; + } + return -1; +} + +int8_t wizchip_dad(uint8_t* ipv6) { + uint8_t tmp; + setSLDIP6R(ipv6); + setSLCR(SLCR_NS); + while (getSLCR()); + while ((tmp = getSLIR()) == 0x00); + setSLIRCLR(~SLIR_RA); + if (tmp & SLIR_TOUT) { + return 0; + } + return -1; +} + +int8_t wizchip_slaac(wiz_Prefix* prefix) { + uint8_t tmp; + setSLCR(SLCR_RS); + while (getSLCR()); + while ((tmp = getSLIR()) == 0x00); + setSLIRCLR(~SLIR_RA); + if (tmp & SLIR_RS) { + prefix->len = getPLR(); + prefix->flag = getPFR(); + prefix->valid_lifetime = getVLTR(); + prefix->preferred_lifetime = getPLTR(); + getPAR(prefix->prefix); + return 0; + } + return -1; +} + +int8_t wizchip_unsolicited(void) { + uint8_t tmp; + setSLCR(SLCR_UNA); + while (getSLCR()); + while ((tmp = getSLIR()) == 0x00); + setSLIRCLR(~SLIR_RA); + if (tmp & SLIR_TOUT) { + return 0; + } + return -1; +} + +int8_t wizchip_getprefix(wiz_Prefix * prefix) { + if (getSLIR() & SLIR_RA) { + prefix->len = getPLR(); + prefix->flag = getPFR(); + prefix->valid_lifetime = getVLTR(); + prefix->preferred_lifetime = getPLTR(); + getPAR(prefix->prefix); + setSLIRCLR(SLIR_RA); + } + return -1; +} + + +#endif + +#if (_WIZCHIP_ == W5100 || _WIZCHIP_ == W5100S || _WIZCHIP_ == W5200 || _WIZCHIP_ == W5300 || _WIZCHIP_ == W5500) +void wizchip_setnetinfo(wiz_NetInfo* pnetinfo) { + setSHAR(pnetinfo->mac); + setGAR(pnetinfo->gw); + setSUBR(pnetinfo->sn); + setSIPR(pnetinfo->ip); + _DNS_[0] = pnetinfo->dns[0]; + _DNS_[1] = pnetinfo->dns[1]; + _DNS_[2] = pnetinfo->dns[2]; + _DNS_[3] = pnetinfo->dns[3]; + _DHCP_ = pnetinfo->dhcp; +} + +void wizchip_getnetinfo(wiz_NetInfo* pnetinfo) { + getSHAR(pnetinfo->mac); + getGAR(pnetinfo->gw); + getSUBR(pnetinfo->sn); + getSIPR(pnetinfo->ip); + pnetinfo->dns[0] = _DNS_[0]; + pnetinfo->dns[1] = _DNS_[1]; + pnetinfo->dns[2] = _DNS_[2]; + pnetinfo->dns[3] = _DNS_[3]; + pnetinfo->dhcp = _DHCP_; +} + +int8_t wizchip_setnetmode(netmode_type netmode) { + uint8_t tmp = 0; +#if _WIZCHIP_ != W5500 + if (netmode & ~(NM_WAKEONLAN | NM_PPPOE | NM_PINGBLOCK)) { + return -1; + } +#else + if (netmode & ~(NM_WAKEONLAN | NM_PPPOE | NM_PINGBLOCK | NM_FORCEARP)) { + return -1; + } +#endif + tmp = getMR(); + tmp |= (uint8_t)netmode; + setMR(tmp); + return 0; +} + +netmode_type wizchip_getnetmode(void) { + return (netmode_type) getMR(); +} + +void wizchip_settimeout(wiz_NetTimeout* nettime) { + setRCR(nettime->retry_cnt); + setRTR(nettime->time_100us); +} + +void wizchip_gettimeout(wiz_NetTimeout* nettime) { + nettime->retry_cnt = getRCR(); + nettime->time_100us = getRTR(); +} +//teddy 240122 +#elif ((_WIZCHIP_ == 6100) ||(_WIZCHIP_ == 6300)) +void wizchip_setnetinfo(wiz_NetInfo* pnetinfo) { + uint8_t i = 0; + setSHAR(pnetinfo->mac); + setGAR(pnetinfo->gw); + setSUBR(pnetinfo->sn); + setSIPR(pnetinfo->ip); + setGA6R(pnetinfo->gw6); + setSUB6R(pnetinfo->sn6); + setLLAR(pnetinfo->lla); + setGUAR(pnetinfo->gua); + + for (i = 0; i < 4; i++) { + _DNS_[i] = pnetinfo->dns[i]; + } + for (i = 0; i < 16; i++) { + _DNS6_[i] = pnetinfo->dns6[i]; + } + + _IPMODE_ = pnetinfo->ipmode; +} + +void wizchip_getnetinfo(wiz_NetInfo* pnetinfo) { + uint8_t i = 0; + getSHAR(pnetinfo->mac); + + getGAR(pnetinfo->gw); + getSUBR(pnetinfo->sn); + getSIPR(pnetinfo->ip); + + getGA6R(pnetinfo->gw6); + getSUB6R(pnetinfo->sn6); + getLLAR(pnetinfo->lla); + getGUAR(pnetinfo->gua); + for (i = 0; i < 4; i++) { + pnetinfo->dns[i] = _DNS_[i]; + } + for (i = 0; i < 16; i++) { + pnetinfo->dns6[i] = _DNS6_[i]; + } + + pnetinfo->ipmode = _IPMODE_; +} + +void wizchip_setnetmode(netmode_type netmode) { + uint32_t tmp = (uint32_t) netmode; + setNETMR((uint8_t)tmp); + setNETMR2((uint8_t)(tmp >> 8)); + setNET4MR((uint8_t)(tmp >> 16)); + setNET6MR((uint8_t)(tmp >> 24)); +} + +netmode_type wizchip_getnetmode(void) { + uint32_t ret = 0; + ret = getNETMR(); + ret = (ret << 8) + getNETMR2(); + ret = (ret << 16) + getNET4MR(); + ret = (ret << 24) + getNET6MR(); + return (netmode_type)ret; +} + +// netmode_type wizchip_getnetmode(void) +// { +// return (netmode_type) getMR(); +// } + +void wizchip_settimeout(wiz_NetTimeout* nettime) { + setRCR(nettime->s_retry_cnt); + setRTR(nettime->s_time_100us); + setSLRCR(nettime->sl_retry_cnt); + setSLRTR(nettime->sl_time_100us); +} + +void wizchip_gettimeout(wiz_NetTimeout* nettime) { + nettime->s_retry_cnt = getRCR(); + nettime->s_time_100us = getRTR(); + nettime->sl_retry_cnt = getSLRCR(); + nettime->sl_time_100us = getSLRTR(); +} +#endif + diff --git a/Ethernet/wizchip_conf.h b/Ethernet/wizchip_conf.h new file mode 100644 index 0000000..1bea81a --- /dev/null +++ b/Ethernet/wizchip_conf.h @@ -0,0 +1,1348 @@ +//***************************************************************************** +// +//! \file wizchip_conf.h +//! \brief WIZCHIP Config Header File. +//! \version 1.0.0 +//! \date 2013/10/21 +//! \par Revision history +//! <2015/02/05> Notice +//! The version history is not updated after this point. +//! Download the latest version directly from GitHub. Please visit the our GitHub repository for ioLibrary. +//! >> https://github.com/Wiznet/ioLibrary_Driver +//! <2013/10/21> 1st Release +//! \author MidnightCow +//! \copyright +//! +//! Copyright (c) 2013, WIZnet Co., 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: +//! +//! * 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 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 extra_functions 2. WIZnet Extra Functions + + @brief These functions is optional function. It could be replaced at WIZCHIP I/O function because they were made by WIZCHIP I/O functions. + @details There are functions of configuring WIZCHIP, network, interrupt, phy, network information and timer. \n + +*/ + +#ifndef _WIZCHIP_CONF_H_ +#define _WIZCHIP_CONF_H_ + +#ifdef __cplusplus +extern "C" { +#endif + +#include +/** + @brief Select WIZCHIP. + @todo You should select one, \b W5100, \b W5100S, \b W5200, \b W5300, \b W5500 or etc. \n\n + ex> #define \_WIZCHIP_ W5500 +*/ + +#define W5100 5100 +#define W5100S 5100+5 +#define W5200 5200 +#define W5300 5300 +#define W5500 5500 +#define W6100 6100 +#define W6300 6300 + + +#ifndef _WIZCHIP_ +// NOTE_LIHAN: Some sections of this code are not yet fully defined. +#define _WIZCHIP_ W6300 // W5100, W5100S, W5200, W5300, W5500, 6300 +#endif + +// +//#ifndef _WIZCHIP_ +// #error please Define your WIZnet chip numer +//#endif + + +#define _WIZCHIP_IO_MODE_NONE_ 0x0000 +#define _WIZCHIP_IO_MODE_BUS_ 0x0100 /**< Bus interface mode */ +#define _WIZCHIP_IO_MODE_SPI_ 0x0200 /**< SPI interface mode */ +//#define _WIZCHIP_IO_MODE_IIC_ 0x0400 +//#define _WIZCHIP_IO_MODE_SDIO_ 0x0800 +// Add to +// + +#define _WIZCHIP_IO_MODE_BUS_DIR_ (_WIZCHIP_IO_MODE_BUS_ + 1) /**< BUS interface mode for direct */ +#define _WIZCHIP_IO_MODE_BUS_INDIR_ (_WIZCHIP_IO_MODE_BUS_ + 2) /**< BUS interface mode for indirect */ + +#define _WIZCHIP_IO_MODE_SPI_VDM_ (_WIZCHIP_IO_MODE_SPI_ + 1) /**< SPI interface mode for variable length data*/ +#define _WIZCHIP_IO_MODE_SPI_FDM_ (_WIZCHIP_IO_MODE_SPI_ + 2) /**< SPI interface mode for fixed length data mode*/ +#define _WIZCHIP_IO_MODE_SPI_5500_ (_WIZCHIP_IO_MODE_SPI_ + 3) /**< SPI interface mode for fixed length data mode*/ +//teddy 240122 +#define _WIZCHIP_IO_MODE_SPI_QSPI_ (_WIZCHIP_IO_MODE_SPI_ + 4) /**< SPI interface mode for QSPI mode*/ + + + +/** + @brief PHY can be accessed by @ref _PHYCR0_, _PHYCR1_. + @details It provides hardware access method. + @note It is smaller s/w footprint than @ref _PHY_IO_MODE_MII_. + @sa _PHY_IO_MODE_MII_, _PHY_IO_MODE_ + @sa ctlwizchip(), getPHYCR0(), getPHYCR1(), setPHYCR1(), getPHYSR() +*/ +#define _PHY_IO_MODE_PHYCR_ 0x0000 + +/** + @brief PHY can be accessed by MDC/MDIO signals of MII interface. + @details It provide software access method. + @note It is bigger s/w footprint than @ref _PHY_IO_MODE_PHYCR_. + @sa _PHY_IO_MODE_PHYCR_, _PHY_IO_MODE_ + @sa ctlwizchip(), wiz_read_mdio(), wiz_write_mdio() +*/ +#define _PHY_IO_MODE_MII_ 0x0010 + +/** + @brief Select PHY Access Mode + @details @ref _PHY_IO_MODE_ selects PHY access method. + @todo You should select one of @ref _PHY_IO_MODE_PHYCR_ or @ref _PHY_IO_MODE_MII_. + @sa ctlwizchip() +*/ +#define _PHY_IO_MODE_ _PHY_IO_MODE_MII_ //_PHY_IO_MODE_MII_ + + + +#if (_WIZCHIP_ == W5100) +#define _WIZCHIP_ID_ "W5100\0" +/** + @brief Define interface mode. + @todo you should select interface mode as chip. Select one of @ref \_WIZCHIP_IO_MODE_SPI_ , @ref \_WIZCHIP_IO_MODE_BUS_DIR_ or @ref \_WIZCHIP_IO_MODE_BUS_INDIR_ +*/ +// #define _WIZCHIP_IO_MODE_ _WIZCHIP_IO_MODE_BUS_DIR_ +// #define _WIZCHIP_IO_MODE_ _WIZCHIP_IO_MODE_BUS_INDIR_ +#define _WIZCHIP_IO_MODE_ _WIZCHIP_IO_MODE_SPI_ + +//A20150601 : Define the unit of IO DATA. +typedef uint8_t iodata_t; +//A20150401 : Indclude W5100.h file +#include "W5100/w5100.h" + +#elif (_WIZCHIP_ == W5100S) +#define _WIZCHIP_ID_ "W5100S\0" +/** + @brief Define interface mode. + @todo you should select interface mode as chip. Select one of @ref \_WIZCHIP_IO_MODE_SPI_ , @ref \_WIZCHIP_IO_MODE_BUS_DIR_ or @ref \_WIZCHIP_IO_MODE_BUS_INDIR_ +*/ +#if 0 +#define _WIZCHIP_IO_MODE_ _WIZCHIP_IO_MODE_BUS_INDIR_ +#elif 0 +#define _WIZCHIP_IO_MODE_ _WIZCHIP_IO_MODE_SPI_5500_ +#else +#define _WIZCHIP_IO_MODE_ _WIZCHIP_IO_MODE_SPI_ +#endif + +//A20150601 : Define the unit of IO DATA. +typedef uint8_t iodata_t; +//A20150401 : Indclude W5100.h file +#include "W5100S/w5100s.h" +#elif (_WIZCHIP_ == W5200) +#define _WIZCHIP_ID_ "W5200\0" +/** + @brief Define interface mode. + @todo you should select interface mode as chip. Select one of @ref \_WIZCHIP_IO_MODE_SPI_ or @ref \ _WIZCHIP_IO_MODE_BUS_INDIR_ +*/ +#ifndef _WIZCHIP_IO_MODE_ +// #define _WIZCHIP_IO_MODE_ _WIZCHIP_IO_MODE_BUS_INDIR_ +#define _WIZCHIP_IO_MODE_ _WIZCHIP_IO_MODE_SPI_ +#endif +//A20150601 : Define the unit of IO DATA. +typedef uint8_t iodata_t; +#include "W5200/w5200.h" +#elif (_WIZCHIP_ == W5500) +#define _WIZCHIP_ID_ "W5500\0" + +/** + @brief Define interface mode. \n + @todo Should select interface mode as chip. + - @ref \_WIZCHIP_IO_MODE_SPI_ \n + -@ref \_WIZCHIP_IO_MODE_SPI_VDM_ : Valid only in @ref \_WIZCHIP_ == W5500 \n + -@ref \_WIZCHIP_IO_MODE_SPI_FDM_ : Valid only in @ref \_WIZCHIP_ == W5500 \n + - @ref \_WIZCHIP_IO_MODE_BUS_ \n + - @ref \_WIZCHIP_IO_MODE_BUS_DIR_ \n + - @ref \_WIZCHIP_IO_MODE_BUS_INDIR_ \n + - Others will be defined in future. \n\n + ex> #define \_WIZCHIP_IO_MODE_ \_WIZCHIP_IO_MODE_SPI_VDM_ + +*/ +#ifndef _WIZCHIP_IO_MODE_ +//#define _WIZCHIP_IO_MODE_ _WIZCHIP_IO_MODE_SPI_FDM_ +#define _WIZCHIP_IO_MODE_ _WIZCHIP_IO_MODE_SPI_ +#endif +//A20150601 : Define the unit of IO DATA. +typedef uint8_t iodata_t; +#include "W5500/w5500.h" +#elif ( _WIZCHIP_ == W5300) +#define _WIZCHIP_ID_ "W5300\0" +/** + @brief Define interface mode. + @todo you should select interface mode as chip. Select one of @ref \_WIZCHIP_IO_MODE_SPI_ , @ref \_WIZCHIP_IO_MODE_BUS_DIR_ or @ref \_WIZCHIP_IO_MODE_BUS_INDIR_ +*/ +#ifndef _WIZCHIP_IO_MODE_ +#define _WIZCHIP_IO_MODE_ _WIZCHIP_IO_MODE_BUS_DIR_ +// #define _WIZCHIP_IO_MODE_ _WIZCHIP_IO_MODE_BUS_INDIR_ +#endif + +//A20150601 : Define the unit and bus width of IO DATA. +/** + @brief Select the data width 8 or 16 bits. + @todo you should select the bus width. Select one of 8 or 16. +*/ +#ifndef _WIZCHIP_IO_BUS_WIDTH_ +#define _WIZCHIP_IO_BUS_WIDTH_ 16 // 8 +#endif +#if _WIZCHIP_IO_BUS_WIDTH_ == 8 +typedef uint8_t iodata_t; +#elif _WIZCHIP_IO_BUS_WIDTH_ == 16 +typedef uint16_t iodata_t; +#else +#error "Unknown _WIZCHIP_IO_BUS_WIDTH_. It should be 8 or 16." +#endif +// +#include "W5300/w5300.h" + + +#elif ( _WIZCHIP_ == W6100) + +#define _WIZCHIP_ID_ "W6100\0" + +/** + @brief Define @ref _WIZCHIP_ interface mode. + @todo You should select interface mode of @ref _WIZCHIP_.\n\n + Select one of @ref _WIZCHIP_IO_MODE_SPI_VDM_, @ref _WIZCHIP_IO_MODE_SPI_FDM_, and @ref _WIZCHIP_IO_MODE_BUS_INDIR_ + @sa WIZCHIP_READ(), WIZCHIP_WRITE(), WIZCHIP_READ_BUF(), WIZCHIP_WRITE_BUF() +*/ +#if 1 +// 20231103 taylor +#define _WIZCHIP_IO_MODE_ _WIZCHIP_IO_MODE_SPI_VDM_ +#elif 0 +#define _WIZCHIP_IO_MODE_ _WIZCHIP_IO_MODE_SPI_VDM_ +#else +#define _WIZCHIP_IO_MODE_ _WIZCHIP_IO_MODE_SPV_FDM_ +#endif + +typedef uint8_t iodata_t; ///< IO access unit. bus width +typedef int16_t datasize_t; ///< sent or received data size +#include "./W6100/w6100.h" +#include "../Application/Application.h" + +//teddy 240122 +#elif ( _WIZCHIP_ == W6300) + +#define _WIZCHIP_ID_ "W6300\0" + + + + +/** + @brief Define @ref _WIZCHIP_ interface mode. + @todo You should select interface mode of @ref _WIZCHIP_.\n\n + Select one of @ref _WIZCHIP_IO_MODE_SPI_QSPI_, @ref _WIZCHIP_IO_MODE_SPI_VDM_,@ref _WIZCHIP_IO_MODE_BUS_INDIR_ + @sa WIZCHIP_READ(), WIZCHIP_WRITE(), WIZCHIP_READ_BUF(), WIZCHIP_WRITE_BUF() +*/ + +#define QSPI_SINGLE_MODE (0x00 << 6) // 0b0000 0000 // 0x00 +#define QSPI_DUAL_MODE (0x01 << 6) // 0b0100 0000 // 0x40 +#define QSPI_QUAD_MODE (0x02 << 6) // 0b1000 0000 // 0x80 + +#ifndef _WIZCHIP_QSPI_MODE_ +#define _WIZCHIP_QSPI_MODE_ QSPI_SINGLE_MODE +#endif + +//#define _WIZCHIP_IO_MODE_ _WIZCHIP_IO_MODE_BUS_INDIR_ +#define _WIZCHIP_IO_MODE_ ((_WIZCHIP_IO_MODE_SPI_ & 0xff00) | (_WIZCHIP_QSPI_MODE_ & 0x00ff)) + + + +typedef uint8_t iodata_t; ///< IO access unit. bus width +typedef int16_t datasize_t; ///< sent or received data size +#include "./W6300/w6300.h" +#include "../Application/Application.h" + +#else +#error "Unknown defined _WIZCHIP_. You should define one of 5100, 5200, 5300, 5500, 6100 and 6300!!!" +#endif + +#ifndef _WIZCHIP_IO_MODE_ +#error "Undefined _WIZCHIP_IO_MODE_. You should define it !!!" +#endif + +/** + @brief Define I/O base address when BUS IF mode. + @todo Should re-define it to fit your system when BUS IF Mode (@ref \_WIZCHIP_IO_MODE_BUS_, + @ref \_WIZCHIP_IO_MODE_BUS_DIR_, @ref \_WIZCHIP_IO_MODE_BUS_INDIR_). \n\n + ex> #define \_WIZCHIP_IO_BASE_ 0x00008000 +*/ +#if _WIZCHIP_IO_MODE_ & _WIZCHIP_IO_MODE_BUS_ +#if 1 +// 20231108 taylor +#if (_WIZCHIP_ == W6300) +#define _WIZCHIP_IO_BASE_ 0x60000000 // for W6100-EVB +#elif (_WIZCHIP_ == W6100) +#define _WIZCHIP_IO_BASE_ 0x60000000 // for W5100S-EV +#elif (_WIZCHIP_ == W5100S) +#define _WIZCHIP_IO_BASE_ 0x60000000 // for W5100S-EVB +#elif (_WIZCHIP_ == W5300) +#define _WIZCHIP_IO_BASE_ 0x68000000 // for W5300 by javakys 20210408 @66c27e960a813f7ea6e8b1ce083d12b3e7e86fc0 +#else +#define _WIZCHIP_IO_BASE_ 0x00000000 +#endif + +#else +#if (_WIZCHIP_ == W6100) +#define _WIZCHIP_IO_BASE_ 0x60000000 // for W6100 BUS +#else +// #define _WIZCHIP_IO_BASE_ 0x60000000 // for 5100S IND +#define _WIZCHIP_IO_BASE_ 0x68000000 // for W5300 +#endif +#endif +#elif _WIZCHIP_IO_MODE_ & _WIZCHIP_IO_MODE_SPI_ +//#define _WIZCHIP_IO_BASE_ 0x00000000 // for 5100S SPI +#endif + +#ifndef _WIZCHIP_IO_BASE_ +#if 1 +// 20231108 taylor +#define _WIZCHIP_IO_BASE_ 0x00000000 +#else +#define _WIZCHIP_IO_BASE_ 0x00000000 // 0x8000 +#endif +#endif + +//M20150401 : Typing Error +//#if _WIZCHIP_IO_MODE_ & _WIZCHIP_IO_MODE_BUS +#if _WIZCHIP_IO_MODE_ & _WIZCHIP_IO_MODE_BUS_ +#ifndef _WIZCHIP_IO_BASE_ +#error "You should be define _WIZCHIP_IO_BASE to fit your system memory map." +#endif +#endif + +#if _WIZCHIP_ >= W5200 +#define _WIZCHIP_SOCK_NUM_ 8 ///< The count of independant socket of @b WIZCHIP +#else +#define _WIZCHIP_SOCK_NUM_ 4 ///< The count of independant socket of @b WIZCHIP +#endif + + +/******************************************************** + WIZCHIP BASIC IF functions for SPI, SDIO, I2C , ETC. +*********************************************************/ +/** + @ingroup DATA_TYPE + @brief The set of callback functions for W5500:@ref WIZCHIP_IO_Functions W5200:@ref WIZCHIP_IO_Functions_W5200 +*/ +typedef struct __WIZCHIP { + uint16_t if_mode; ///< host interface mode + uint8_t id[8]; ///< @b WIZCHIP ID such as @b 5100, @b 5100S, @b 5200, @b 5500, and so on. + /** + The set of critical section callback func. + */ + struct _CRIS { + void (*_enter) (void); ///< crtical section enter + void (*_exit) (void); ///< critial section exit + } CRIS; + /** + The set of @ref \_WIZCHIP_ select control callback func. + */ + struct _CS { + void (*_select) (void); ///< @ref \_WIZCHIP_ selected + void (*_deselect)(void); ///< @ref \_WIZCHIP_ deselected + } CS; + /** + The set of interface IO callback func. + */ + union _IF { + /** + For BUS interface IO + */ + //M20156501 : Modify the function name for integrating with W5300 + //struct + //{ + // uint8_t (*_read_byte) (uint32_t AddrSel); + // void (*_write_byte) (uint32_t AddrSel, uint8_t wb); + //}BUS; + struct { + iodata_t (*_read_data) (uint32_t AddrSel); + void (*_write_data) (uint32_t AddrSel, iodata_t wb); +#if 1 + // 20231103 taylor + void (*_read_data_buf) (uint32_t AddrSel, iodata_t* pBuf, int16_t len, uint8_t addrinc); ///< Read @ref iodata_t as many as len from @ref _WIZCHIP_ through BUS + void (*_write_data_buf) (uint32_t AddrSel, iodata_t* pBuf, int16_t len, uint8_t addrinc); ///< Write @ref iodata_t data as many as len to @ref _WIZCHIP_ through BUS +#endif + } BUS; + + /** + For SPI interface IO + */ + struct { + uint8_t (*_read_byte) (void); + void (*_write_byte) (uint8_t wb); + void (*_read_burst) (uint8_t* pBuf, uint16_t len); + void (*_write_burst) (uint8_t* pBuf, uint16_t len); + } SPI; + + /** + For QSPI interface IO + */ + //teddy 240122 + struct { + void (*_read_qspi) (uint8_t opcode, uint16_t addr, uint8_t* pBuf, uint16_t len); + void (*_write_qspi) (uint8_t opcode, uint16_t addr, uint8_t* pBuf, uint16_t len); + } QSPI; + // To be added + // + } IF; +} _WIZCHIP; + +extern _WIZCHIP WIZCHIP; + +/** + @ingroup DATA_TYPE + WIZCHIP control type enumration used in @ref ctlwizchip(). +*/ +typedef enum { + CW_SYS_LOCK, ///< Lock or Unlock @ref _WIZCHIP_ with @ref SYS_CHIP_LOCK, @ref SYS_PHY_LOCK, and @ref SYS_NET_LOCK + CW_SYS_UNLOCK, ///< Lock or Unlock @ref _WIZCHIP_ with @ref SYS_CHIP_LOCK, @ref SYS_PHY_LOCK, and @ref SYS_NET_LOCK + CW_GET_SYSLOCK, ///< Get the lock status of @ref _WIZCHIP_ with @ref SYS_CHIP_LOCK, @ref SYS_PHY_LOCK, and @ref SYS_NET_LOCK + + CW_RESET_WIZCHIP, ///< Reset @ref _WIZCHIP_ by software + CW_INIT_WIZCHIP, ///< Initialize to SOCKETn buffer size with n byte array typed uint8_t + CW_GET_INTERRUPT, ///< Get the interrupt status with @ref intr_kind + CW_CLR_INTERRUPT, ///< Clear the interrupt with @ref intr_kind + CW_SET_INTRMASK, ///< Set the interrupt mask with @ref intr_kind + CW_GET_INTRMASK, ///< Get the interrupt mask with @ref intr_kind + CW_SET_INTRTIME, ///< Set the interrupt pending time + CW_GET_INTRTIME, ///< Get the interrupt pending time + CW_SET_IEN, ///< Set the global interrupt enable only when @ref SYS_CHIP_LOCK is not set + CW_GET_IEN, ///< Get the global interrupt enable + + CW_GET_ID, ///< Get @ref _WIZCHIP_ name. + CW_GET_VER, ///< Get the version of TCP/IP TOE engine + + CW_SET_SYSCLK, ///< Set the system clock with @ref SYSCLK_100MHZ or SYSCLK_10MHZ only when @ref SYS_CHIP_LOCK is unlock + CW_GET_SYSCLK, ///< Get the system clock with @ref SYSCLK_100MHZ or SYSCLK_10MHZ + + CW_RESET_PHY, ///< Reset PHY + CW_SET_PHYCONF, ///< Set PHY operation mode (Manual/Auto, 10/100, Half/Full) with @ref wiz_PhyConf + CW_GET_PHYCONF, ///< Get PHY operation mode (Manual/Auto, 10/100, Half/Full) with @ref wiz_PhyConf + CW_GET_PHYSTATUS, ///< Get real operation mode with @ref wiz_PhyConf when PHY is linked up. + CW_SET_PHYPOWMODE, ///< Set PHY power mode with @ref PHY_POWER_NORM or PHY_POWER_DOWN + CW_GET_PHYPOWMODE, ///< Get PHY Power mode with @ref PHY_POWER_NORM or PHY_POWER_DOWN + CW_GET_PHYLINK ///< Get PHY Link status with @ref PHY_LINK_ON or @ref PHY_LINK_OFF +} ctlwizchip_type; + +/** + @ingroup DATA_TYPE + Network control type enumration used in @ref ctlnetwork(). +*/ +typedef enum { + CN_SET_NETINFO, ///< Set Network with @ref wiz_NetInfo + CN_GET_NETINFO, ///< Get Network with @ref wiz_NetInfo + CN_SET_NETMODE, ///< Set network mode as WOL, PPPoE, Ping Block, and Force ARP mode + CN_GET_NETMODE, ///< Get network mode as WOL, PPPoE, Ping Block, and Force ARP mode + CN_SET_TIMEOUT, ///< Set network timeout as retry count and time. + CN_GET_TIMEOUT, ///< Get network timeout as retry count and time. + //teddy 240122 +#if ((_WIZCHIP_ == W6100)||(_WIZCHIP_ == W6300)) + CN_SET_PREFER, ///< Set the preferred source IPv6 address of @ref _SLCR_.\n Refer to @ref IPV6_ADDR_AUTO, @ref IPV6_ADDR_LLA, @ref IPV6_ADDR_GUA + CN_GET_PREFER, ///< Get the preferred source IPv6 address of @ref _SLCR_.\n Refer to @ref IPV6_ADDR_AUTO, @ref IPV6_ADDR_LLA, @ref IPV6_ADDR_GUA +#endif +} ctlnetwork_type; + +//teddy 240122 +#if ((_WIZCHIP_ == W6100)||(_WIZCHIP_ == W6300)) +/** + @ingroup DATA_TYPE + @brief Network Service Control Type enumeration + @details @ref ctlnetservice_type includes network management or monitor functions for @ref _WIZCHIP_. + @sa ctlnetservice(), wiz_IPAddress, wiz_Prefix +*/ +typedef enum { + CNS_ARP, ///< ARP process with @ref wiz_IPAddress + CNS_PING, ///< PING process with @ref wiz_IPAddress + CNS_DAD, ///< Duplicated IPv6 Address Detection + /** + @brief Stateless Address Auto-configuration(SLAAC) with @ref wiz_Prefix. + @details @ref CNS_SLAAC sends first RS message to all-router and then receives RA message from a router. + @note It is valid only when the first received RA option is the source link-layer address(0x01) and the second is prefix information(0x03).\n + Refer to @ref SLIR_RS. + @sa ctlnetservice() + @sa CNS_GET_PREFIX + */ + CNS_SLAAC, + CNS_UNSOL_NA, ///< Unsolicited Neighbor Advertisement for update @ref _WIZCHIP_ network information to neighbors + /** + @brief Get prefix information with @ref wiz_Prefix. + @details @ref CNS_GET_PREFIX can get prefix information of RA message to be sent by a router without RS message. + @note It is valid only when @ref IK_SOCKL_RA is set and the prefix information(0x03) of RA option is first received. + @sa ctlnetservice() + @sa CNS_SLAAC + */ + CNS_GET_PREFIX +} ctlnetservice_type; +#endif + +#if (_WIZCHIP_ == W5100 || _WIZCHIP_ == W5100S || _WIZCHIP_ == W5200 || _WIZCHIP_ == W5300 || _WIZCHIP_ == W5500) +/** + @ingroup DATA_TYPE + Interrupt kind when CW_SET_INTRRUPT, CW_GET_INTERRUPT, CW_SET_INTRMASK + and CW_GET_INTRMASK is used in @ref ctlnetwork(). + It can be used with OR operation. +*/ +typedef enum { +#if _WIZCHIP_ == W5500 + IK_WOL = (1 << 4), ///< Wake On Lan by receiving the magic packet. Valid in W500. +#elif _WIZCHIP_ == W5300 + IK_FMTU = (1 << 4), ///< Received a ICMP message (Fragment MTU) +#endif + + IK_PPPOE_TERMINATED = (1 << 5), ///< PPPoE Disconnected + +#if _WIZCHIP_ != W5200 + IK_DEST_UNREACH = (1 << 6), ///< Destination IP & Port Unreachable, No use in W5200 +#endif + + IK_IP_CONFLICT = (1 << 7), ///< IP conflict occurred + + IK_SOCK_0 = (1 << 8), ///< Socket 0 interrupt + IK_SOCK_1 = (1 << 9), ///< Socket 1 interrupt + IK_SOCK_2 = (1 << 10), ///< Socket 2 interrupt + IK_SOCK_3 = (1 << 11), ///< Socket 3 interrupt +#if _WIZCHIP_ > W5100S + IK_SOCK_4 = (1 << 12), ///< Socket 4 interrupt, No use in 5100 + IK_SOCK_5 = (1 << 13), ///< Socket 5 interrupt, No use in 5100 + IK_SOCK_6 = (1 << 14), ///< Socket 6 interrupt, No use in 5100 + IK_SOCK_7 = (1 << 15), ///< Socket 7 interrupt, No use in 5100 +#endif + +#if _WIZCHIP_ > W5100S + IK_SOCK_ALL = (0xFF << 8) ///< All Socket interrupt +#else + IK_SOCK_ALL = (0x0F << 8) ///< All Socket interrupt +#endif +} intr_kind; +//teddy 240122 +#elif ((_WIZCHIP_ == W6100)||(_WIZCHIP_ == W6300)) +/** + @ingroup DATA_TYPE + @brief Interrupt Kind + @details @ref intr_kind can be used as the interrupt bits of @ref _IR_, @ref _SIR_, and @ref _SLIR_,\n + It can be used as the interrupt mask bits of @ref _IMR_, @ref _SIMR_, and @ref _SLIMR_,\n + and also, It can be used as the interrupt clear bits of @ref _IRCLR_, @ref _Sn_IRCLR_, and @ref _SLIRCLR_. + @note It can be used with @b OR operation. + @sa ctlwizchip(), CW_GET_INTERRUPT, CW_CLR_INTERRUPT, CW_GET_INTRMASK, CW_SET_INTRMASK + @sa ctlnetservice(), ctlnetservice_type + @sa wizchip_getinterrupt(), wizchip_clrinterrupt(), wizchip_getinterruptmask(), wizchip_setinterruptmask() +*/ +typedef enum { + IK_PPPOE_TERMINATED = (1 << 0), ///< PPPoE Termination Interrupt + IK_DEST_UNREACH = (1 << 1), ///< ICMPv4 Destination Unreachable Interrupt + IK_IP_CONFLICT = (1 << 2), ///< IPv4 Address Conflict Interrupt + IK_DEST_UNREACH6 = (1 << 4), ///< ICMPv6 Destination Unreachable Interrupt + IK_WOL = (1 << 7), ///< WOL magic packet Interrupt + IK_NET_ALL = (0x97), ///< All Network Interrupt + + IK_SOCK_0 = (1 << 8), ///< Socket 0 Interrupt + IK_SOCK_1 = (1 << 9), ///< Socket 1 Interrupt + IK_SOCK_2 = (1 << 10), ///< Socket 2 Interrupt + IK_SOCK_3 = (1 << 11), ///< Socket 3 Interrupt + IK_SOCK_4 = (1 << 12), ///< Socket 4 Interrupt + IK_SOCK_5 = (1 << 13), ///< Socket 5 Interrupt + IK_SOCK_6 = (1 << 14), ///< Socket 6 Interrupt + IK_SOCK_7 = (1 << 15), ///< Socket 7 Interrupt + IK_SOCK_ALL = (0xFF << 8), ///< All Socket Interrupt + + IK_SOCKL_TOUT = (1 << 16), ///< @ref _SLCR_ Timeout Interrupt.\n Refer to @ref ctlnetservice_type. + IK_SOCKL_ARP4 = (1 << 17), ///< @ref _SLCR_ APR4 Interrupt.\n Refer to @ref CNS_ARP. + IK_SOCKL_PING4 = (1 << 18), ///< @ref _SLCR_ PING4 Interrupt.\n Refer to @ref CNS_PING. + IK_SOCKL_ARP6 = (1 << 19), ///< @ref _SLCR_ ARP6 Interrupt.\n Refer to @ref CNS_ARP. + IK_SOCKL_PING6 = (1 << 20), ///< @ref _SLCR_ PING6 Interrupt.\n Refer to @ref CNS_PING. + IK_SOCKL_NS = (1 << 21), ///< @ref _SLCR_ NS Interrupt.\n Refer to @ref CNS_DAD. + IK_SOCKL_RS = (1 << 22), ///< @ref _SLCR_ RS Interrupt.\n Refer to @ref CNS_SLAAC. + IK_SOCKL_RA = (1 << 23), ///< @ref _SLCR_ RA Interrupt.\n Refer to @ref CNS_GET_PREFIX. + IK_SOCKL_ALL = (0xFF << 16), ///< @ref _SLCR_ All Interrupt + + IK_INT_ALL = (0x00FFFF97) ///< All Interrupt +} intr_kind; +#endif + +//teddy 240122 +#if ((_WIZCHIP_ == W6100)||(_WIZCHIP_ == W6300)) +#define SYS_CHIP_LOCK (1<<2) ///< CHIP LOCK. \n Refer to @ref CW_SYS_LOCK, @ref CW_SYS_UNLOCK, and @ref CW_GET_SYSLOCK. +#define SYS_NET_LOCK (1<<1) ///< NETWORK Information LOCK. \n Refer to @ref CW_SYS_LOCK, @ref CW_SYS_UNLOCK, and @ref CW_GET_SYSLOCK. +#define SYS_PHY_LOCK (1<<0) ///< PHY LOCK.\n Refer to @ref CW_SYS_LOCK, @ref CW_SYS_UNLOCK, and @ref CW_GET_SYSLOCK. + +#define SYSCLK_100MHZ 0 ///< System Clock 100MHz.\n Refer to Refer to @ref CW_SET_SYSCLK and @ref CW_GET_SYSCLK. +#define SYSCLK_25MHZ 1 ///< System Clock 25MHz.\n Refer to Refer to @ref CW_SET_SYSCLK and @ref CW_GET_SYSCLK. + +#define PHY_MODE_MANUAL 0 ///< Configured PHY operation mode with user setting.\n Refer to @ref CW_SET_PHYCONF and @ref CW_GET_PHYCONF. +#define PHY_MODE_AUTONEGO 1 ///< Configured PHY operation mode with auto-negotiation.\n Refer to @ref CW_SET_PHYCONF and @ref CW_GET_PHYCONF. +#define PHY_MODE_TE 2 + +#define IPV6_ADDR_AUTO 0x00 ///< IPv6 Address Type : Auto.\n Refer to @ref CN_SET_PREFER, @ref CN_GET_PREFER. +#define IPV6_ADDR_LLA 0x02 ///< IPv6 Address Type : LLA. \n Refer to @ref CN_SET_PREFER, @ref CN_GET_PREFER, @ref CNS_DAD. +#define IPV6_ADDR_GUA 0x03 ///< IPv6 Address Type : GUA. \n Refer to @ref CN_SET_PREFER, @ref CN_GET_PREFER, @ref CNS_DAD. +#endif + +#define PHY_CONFBY_HW 0 ///< Configured PHY operation mode by HW pin +#define PHY_CONFBY_SW 1 ///< Configured PHY operation mode by SW register +#define PHY_MODE_MANUAL 0 ///< Configured PHY operation mode with user setting. +#define PHY_MODE_AUTONEGO 1 ///< Configured PHY operation mode with auto-negotiation +#define PHY_SPEED_10 0 ///< Link Speed 10 +#define PHY_SPEED_100 1 ///< Link Speed 100 +#define PHY_DUPLEX_HALF 0 ///< Link Half-Duplex +#define PHY_DUPLEX_FULL 1 ///< Link Full-Duplex +#define PHY_LINK_OFF 0 ///< Link Off +#define PHY_LINK_ON 1 ///< Link On +#define PHY_POWER_NORM 0 ///< PHY power normal mode +#define PHY_POWER_DOWN 1 ///< PHY power down mode + + +//teddy 240122 +#if _WIZCHIP_ == W5100S || _WIZCHIP_ == W5500 || _WIZCHIP_ == W6100 || _WIZCHIP_ == W6300 +/** + @ingroup DATA_TYPE + It configures PHY configuration when CW_SET PHYCONF or CW_GET_PHYCONF in W5500, + and it indicates the real PHY status configured by HW or SW in all WIZCHIP. \n + Valid only in W5500. +*/ +typedef struct wiz_PhyConf_t { + uint8_t by; ///< set by @ref PHY_CONFBY_HW or @ref PHY_CONFBY_SW + uint8_t mode; ///< set by @ref PHY_MODE_MANUAL or @ref PHY_MODE_AUTONEGO + uint8_t speed; ///< set by @ref PHY_SPEED_10 or @ref PHY_SPEED_100 + uint8_t duplex; ///< set by @ref PHY_DUPLEX_HALF @ref PHY_DUPLEX_FULL + //uint8_t power; ///< set by @ref PHY_POWER_NORM or @ref PHY_POWER_DOWN + //uint8_t link; ///< Valid only in CW_GET_PHYSTATUS. set by @ref PHY_LINK_ON or PHY_DUPLEX_OFF +} wiz_PhyConf; +#endif + +#if (_WIZCHIP_ == W5100 || _WIZCHIP_ == W5100S || _WIZCHIP_ == W5200 || _WIZCHIP_ == W5300 || _WIZCHIP_ == W5500) +/** + @ingroup DATA_TYPE + It used in setting dhcp_mode of @ref wiz_NetInfo. +*/ +typedef enum { + NETINFO_STATIC = 1, ///< Static IP configuration by manually. + NETINFO_DHCP ///< Dynamic IP configruation from a DHCP sever +} dhcp_mode; + +/** + @ingroup DATA_TYPE + Network Information for WIZCHIP +*/ +typedef struct wiz_NetInfo_t { + uint8_t mac[6]; ///< Source Mac Address + uint8_t ip[4]; ///< Source IP Address + uint8_t sn[4]; ///< Subnet Mask + uint8_t gw[4]; ///< Gateway IP Address + uint8_t dns[4]; ///< DNS server IP Address + dhcp_mode dhcp; ///< 1 - Static, 2 - DHCP +} wiz_NetInfo; + +/** + @ingroup DATA_TYPE + Network mode +*/ +typedef enum { +#if _WIZCHIP_ == W5500 + NM_FORCEARP = (1 << 1), ///< Force to APP send whenever udp data is sent. Valid only in W5500 +#endif + NM_WAKEONLAN = (1 << 5), ///< Wake On Lan + NM_PINGBLOCK = (1 << 4), ///< Block ping-request + NM_PPPOE = (1 << 3), ///< PPPoE mode +} netmode_type; + +/** + @ingroup DATA_TYPE + Used in CN_SET_TIMEOUT or CN_GET_TIMEOUT of @ref ctlwizchip() for timeout configruation. +*/ +typedef struct wiz_NetTimeout_t { + uint8_t retry_cnt; ///< retry count + uint16_t time_100us; ///< time unit 100us +} wiz_NetTimeout; +//teddy 240122 +#elif ((_WIZCHIP_ == W6100)||(_WIZCHIP_ == W6300)) +/** + @ingroup DATA_TYPE + @brief IP Address Configuration Mode + @details @ref ipconf_mode can be used to save the DHCP mode running on your system. + @sa ctlnetwork(), CN_SET_NETINFO, CN_GET_NETINFO + @sa wizchip_setnetinfo(), wizchip_getnetinfo(), wiz_NetInfo +*/ +typedef enum { + NETINFO_NONE = 0x00, ///< No use DHCP + NETINFO_STATIC_V4 = 0x01, ///< Static IPv4 configuration by manually. + NETINFO_STATIC_V6 = 0x02, ///< Static IPv6 configuration by manually. + NETINFO_STATIC_ALL = 0x03, ///< Static IPv4 and IPv6 configuration by manually. + NETINFO_SLAAC_V6 = 0x04, ///< Stateless Adders Auto Configuration for IPv6 + NETINFO_DHCP_V4 = 0x10, ///< Dynamic IPv4 configuration from a DHCP sever + NETINFO_DHCP_V6 = 0x20, ///< Dynamic IPv6 configuration from a DHCP sever + NETINFO_DHCP_ALL = 0x30 ///< Dynamic IPv4 and IPv6 configuration from a DHCP sever +} ipconf_mode; + +/** + @ingroup DATA_TYPE + @brief Network Information for @ref _WIZCHIP_ + @details @ref wiz_NetInfo is a structure type to configure or indicate the network information of @ref _WIZCHIP_. + @sa ctlnetwork(), CN_SET_NETINFO, CN_GET_NETINFO + @sa wizchip_setnetinfo(), wizchip_getnetinfo() +*/ + +typedef enum { + NETINFO_STATIC = 1, ///< Static IP configuration by manually. + NETINFO_DHCP ///< Dynamic IP configruation from a DHCP sever +} dhcp_mode; + +typedef struct wiz_NetInfo_t { + uint8_t mac[6]; ///< Source Hardware Address + uint8_t ip[4]; ///< Source IPv4 Address + uint8_t sn[4]; ///< Subnet Mask value + uint8_t gw[4]; ///< Gateway IPv4 Address + uint8_t lla[16]; ///< Source Link Local Address + uint8_t gua[16]; ///< Source Global Unicast Address + uint8_t sn6[16]; ///< IPv6 Prefix + uint8_t gw6[16]; ///< Gateway IPv6 Address + uint8_t dns[4]; ///< DNS server IPv4 Address + uint8_t dns6[16]; ///< DNS server IPv6 Address + ipconf_mode ipmode; ///< IP Configuration Mode + dhcp_mode dhcp; ///< 1 - Static, 2 - DHCP +} wiz_NetInfo; + +/** + @ingroup DATA_TYPE + @brief Network mode Configuration + @details @ref netmode_type includes the network mode control function such as ping, TCP/RST block and etc. + @sa ctlnetwork(), CN_SET_NETMODE, CN_GET_NETMODE +*/ +typedef enum { + // NETMR Bit Values + NM_IPB_V4 = (1 << 0), ///< IPv4 Packet Block + NM_IPB_V6 = (1 << 1), ///< IPv6 Packet Block + NM_WOL = (1 << 2), ///< Wake On Lan(WOL) Mode + NM_PB6_MULTI = (1 << 4), ///< PING6 request from multicasting group address Block + NM_PB6_ALLNODE = (1 << 5), ///< PING6 request from all-node multicasting address Block + NM_MR_MASK = (0x37), ///< @ref _NETMR_ Mask value + + // NETMR2 Bit Values + NM_PPPoE = (1 << 8), ///< PPPoE Mode + NM_DHA_SELECT = (1 << 15), ///< Destination Hardware Address Select + NM_MR2_MASK = (0x09 << 8), ///< @ref _NETMR2_ Mask value + + //NET4MR Bit Values + NM_PB4_ALL = (1 << 16), ///< All PING4 request Block + NM_TRSTB_V4 = (1 << 17), ///< TCP RST packet for IPv4 Send Block + NM_PARP_V4 = (1 << 18), ///< ARP request for IPv4 before PINGv4 Replay + NM_UNRB_V4 = (1 << 19), ///< Unreachable Destination for IPv4 Block + NM_NET4_MASK = (0x0F << 16), ///< @ref _NET4MR_ Mask value + + //NET4MR Bit Values + NM_PB6_ALL = (1 << 24), ///< All PING6 request Block + NM_TRSTB_V6 = (1 << 25), ///< TCP RST packet for IPv6 Send Block + NM_PARP_V6 = (1 << 26), ///< ARP request for IPv6 before PINGv4 Replay + NM_UNRB_V6 = (1 << 27), ///< Unreachable Destination for IPv6 Block + NM_NET6_MASK = (0x0F << 24), ///< @ref _NET6MR_ Mask value + + NM_MASK_ALL = (0x0F0F0937) ///< @ref netmode_type all mask value +} netmode_type; + +/** + @ingroup DATA_TYPE + @brief Network Timeout for @ref _WIZCHIP_ + @details @ref wiz_NetInfo is a structure type to configure or indicate the network timeout of @ref _WIZCHIP_. + @sa ctlnetwork(), CN_SET_TIMEOUT, CN_GET_TIMEOUT + @sa wizchip_settimeout(), wizchip_gettimeout() +*/ +typedef struct wiz_NetTimeout_t { + uint8_t s_retry_cnt; ///< The default retry count of SOCKETn + uint16_t s_time_100us; ///< The retransmission time of SOCKETn (unit 100us) + uint8_t sl_retry_cnt; ///< The retry count of SOCKET-less + uint16_t sl_time_100us; ///< The retransmission time of SOCKET-less (unit 100us) +} wiz_NetTimeout; + +/** + @ingroup DATA_TYPE + @brief Destination Information for Network Service of @ref _WIZCHIP_ + @details @ref wiz_NetInfo is a structure type to configure or indicate a destination information of network service. + @sa ctlnetservice(), CNS_ARP, CNS_PING + @sa IK_SOCKL_TOUT, IK_SOCKL_ARP4, IK_SOCKL_ARP6, IK_SOCKL_PING4, IK_SOCKL_PING6 +*/ +typedef struct wiz_IPAddress_t { + uint8_t ip[16]; ///< Destination IP Address. \n IPv4 index : 0 to 3, IPv6 index : 0 to 15 + uint8_t len; ///< Destination IP Address Length.\n IPv4 : 4, IPv6 : 16. +} wiz_IPAddress; + +/** + @ingroup DATA_TYPE + @brief Prefix Information + @details @ref wiz_Prefix is a structure type to indicate a prefix information(0x03) of received RA message from a router. + @sa ctlnetservice(), CNS_SLAAC, IK_SOCKL_RS + @sa IK_SOCKL_TOUT, IK_SOCKL_RA, CNS_GET_PREFIX +*/ +typedef struct wiz_Prefix_t { + uint8_t len; ///< Prefix Length. \n It is used to set @ref _SUB6R_ to 1 as many as len from LSB bit. + uint8_t flag; ///< Prefix Flag + uint32_t valid_lifetime; ///< Valid Lifetime + uint32_t preferred_lifetime; ///< Preferred Lifetime + uint8_t prefix[16]; ///< Prefix +} wiz_Prefix; + +/** + @ingroup DATA_TYPE + @brief Destination Information & Destination Hardware Address for @ref CNS_ARP + @details @ref wiz_ARP is a structure type to set a destination IP address for ARP-request or \n + indicate a destination hardware address in APR-reply. + @sa ctlnetservice(), CNS_ARP + @sa IK_SOCKL_TOUT, IK_SOCKL_ARP4, IK_SOCKL_ARP6 +*/ +typedef struct wiz_ARP_t { + wiz_IPAddress destinfo; ///< Destination IP address for ARP-request + uint8_t dha[6]; ///< Destination Hardware Address when ARP-reply is received from the destination. +} wiz_ARP; + +/** + @ingroup DATA_TYPE + @brief Destination Information & Destination Hardware Address for @ref CNS_ARP + @details @ref wiz_PING is a structure type to set a ID, sequence number, destination IP address for PING-request. + @sa ctlnetservice(), CNS_PING + @sa IK_SOCKL_TOUT, IK_SOCKL_PING4, IK_SOCKL_PING6 +*/ +typedef struct wiz_PING_t { + uint16_t id; + uint16_t seq; + wiz_IPAddress destinfo; +} wiz_PING; +#endif + +/** + @brief Registers call back function for critical section of I/O functions such as + \ref WIZCHIP_READ, @ref WIZCHIP_WRITE, @ref WIZCHIP_READ_BUF and @ref WIZCHIP_WRITE_BUF. + @param cris_en : callback function for critical section enter. + @param cris_ex : callback function for critical section exit. + @todo Describe @ref WIZCHIP_CRITICAL_ENTER and @ref WIZCHIP_CRITICAL_EXIT marco or register your functions. + @note If you do not describe or register, default functions(@ref wizchip_cris_enter & @ref wizchip_cris_exit) is called. +*/ +void reg_wizchip_cris_cbfunc(void(*cris_en)(void), void(*cris_ex)(void)); + + +/** + @brief Registers call back function for WIZCHIP select & deselect. + @param cs_sel : callback function for WIZCHIP select + @param cs_desel : callback fucntion for WIZCHIP deselect + @todo Describe @ref wizchip_cs_select and @ref wizchip_cs_deselect function or register your functions. + @note If you do not describe or register, null function is called. +*/ +void reg_wizchip_cs_cbfunc(void(*cs_sel)(void), void(*cs_desel)(void)); + +/** + @brief Registers call back function for bus interface. + @param bus_rb : callback function to read byte data using system bus + @param bus_wb : callback function to write byte data using system bus + @todo Describe @ref wizchip_bus_readbyte and @ref wizchip_bus_writebyte function + or register your functions. + @note If you do not describe or register, null function is called. +*/ +//M20150601 : For integrating with W5300 +//void reg_wizchip_bus_cbfunc(uint8_t (*bus_rb)(uint32_t addr), void (*bus_wb)(uint32_t addr, uint8_t wb)); +void reg_wizchip_bus_cbfunc(iodata_t (*bus_rb)(uint32_t addr), void (*bus_wb)(uint32_t addr, iodata_t wb)); + +/** + @brief Registers call back function for SPI interface. + @param spi_rb : callback function to read byte using SPI + @param spi_wb : callback function to write byte using SPI + @todo Describe \ref wizchip_spi_readbyte and \ref wizchip_spi_writebyte function + or register your functions. + @note If you do not describe or register, null function is called. +*/ +#if _WIZCHIP_ == W6100 +void reg_wizchip_spi_cbfunc(uint8_t (*spi_rb)(void), + void (*spi_wb)(uint8_t wb), + void (*spi_rbuf)(uint8_t* buf, datasize_t len), + void (*spi_wbuf)(uint8_t* buf, datasize_t len)); +#else +void reg_wizchip_spi_cbfunc(uint8_t (*spi_rb)(void), void (*spi_wb)(uint8_t wb)); +#endif + +/** + @brief Registers call back function for SPI interface. + @param spi_rb : callback function to burst read using SPI + @param spi_wb : callback function to burst write using SPI + @todo Describe \ref wizchip_spi_readbyte and \ref wizchip_spi_writebyte function + or register your functions. + @note If you do not describe or register, null function is called. +*/ +void reg_wizchip_spiburst_cbfunc(void (*spi_rb)(uint8_t* pBuf, uint16_t len), void (*spi_wb)(uint8_t* pBuf, uint16_t len)); + +//teddy 240122 +/** + @brief Registers call back function for QSPI interface. + @param spi_rb : callback function to read using QSPI + @param spi_wb : callback function to write using QSPI + @todo Describe \ref wizchip_qspi_read and \ref wizchip_qspi_write function + or register your functions. + @note If you do not describe or register, null function is called. +*/ +void reg_wizchip_qspi_cbfunc(void (*qspi_rb)(uint8_t opcode, uint16_t addr, uint8_t* pBuf, uint16_t len), void (*qspi_wb)(uint8_t opcode, uint16_t addr, uint8_t* pBuf, uint16_t len)); + +/** + @ingroup extra_functions + @brief Controls to the WIZCHIP. + @details Resets WIZCHIP & internal PHY, Configures PHY mode, Monitor PHY(Link,Speed,Half/Full/Auto), + controls interrupt & mask and so on. + @param cwtype : Decides to the control type + @param arg : arg type is dependent on cwtype. + @return 0 : Success \n + -1 : Fail because of invalid \ref ctlwizchip_type or unsupported \ref ctlwizchip_type in WIZCHIP +*/ +int8_t ctlwizchip(ctlwizchip_type cwtype, void* arg); + +/** + @ingroup extra_functions + @brief Controls to network. + @details Controls to network environment, mode, timeout and so on. + @param cntype : Input. Decides to the control type + @param arg : Inout. arg type is dependent on cntype. + @return -1 : Fail because of invalid \ref ctlnetwork_type or unsupported \ref ctlnetwork_type in WIZCHIP \n + 0 : Success +*/ +int8_t ctlnetwork(ctlnetwork_type cntype, void* arg); + +//teddy 240122 +#if ((_WIZCHIP_ == W6100)||(_WIZCHIP_ == W6300)) +/** + @ingroup extra_functions + @brief Controls to network service. + @details Controls to network environment, mode, timeout and so on. + @param cnstype : Decides to the control type + @param arg : arg type is dependent on cnstype. + @return -1 : Fail because of invalid @ref ctlnetwork_type or unsupported @ref ctlnetwork_type \n + 0 : Success +*/ +int8_t ctlnetservice(ctlnetservice_type cnstype, void* arg); +#endif + +/* + The following functions are implemented for internal use. + but You can call these functions for code size reduction instead of ctlwizchip() and ctlnetwork(). +*/ + +/** + @ingroup extra_functions + @brief Reset WIZCHIP by softly. +*/ +void wizchip_sw_reset(void); + +/** + @ingroup extra_functions + @brief Initializes WIZCHIP with socket buffer size + @param txsize Socket tx buffer sizes. If null, initialized the default size 2KB. + @param rxsize Socket rx buffer sizes. If null, initialized the default size 2KB. + @return 0 : succcess \n + -1 : fail. Invalid buffer size +*/ +int8_t wizchip_init(uint8_t* txsize, uint8_t* rxsize); + +/** + @ingroup extra_functions + @brief Clear Interrupt of WIZCHIP. + @param intr : @ref intr_kind value operated OR. It can type-cast to uint16_t. +*/ +void wizchip_clrinterrupt(intr_kind intr); + +/** + @ingroup extra_functions + @brief Get Interrupt of WIZCHIP. + @return @ref intr_kind value operated OR. It can type-cast to uint16_t. +*/ +intr_kind wizchip_getinterrupt(void); + +/** + @ingroup extra_functions + @brief Mask or Unmask Interrupt of WIZCHIP. + @param intr : @ref intr_kind value operated OR. It can type-cast to uint16_t. +*/ +void wizchip_setinterruptmask(intr_kind intr); + +/** + @ingroup extra_functions + @brief Get Interrupt mask of WIZCHIP. + @return : The operated OR vaule of @ref intr_kind. It can type-cast to uint16_t. +*/ +intr_kind wizchip_getinterruptmask(void); + +//todo +#if _WIZCHIP_ > W5100 +int8_t wizphy_getphylink(void); ///< get the link status of phy in WIZCHIP. No use in W5100 +int8_t wizphy_getphypmode(void); ///< get the power mode of PHY in WIZCHIP. No use in W5100 +#endif + +#if _WIZCHIP_ == W5100S || _WIZCHIP_ == W5500 +void wizphy_reset(void); ///< Reset phy. Vailid only in W5500 +/** + @ingroup extra_functions + @brief Set the phy information for WIZCHIP without power mode + @param phyconf : @ref wiz_PhyConf +*/ +void wizphy_setphyconf(wiz_PhyConf* phyconf); +/** + @ingroup extra_functions + @brief Get phy configuration information. + @param phyconf : @ref wiz_PhyConf +*/ +void wizphy_getphyconf(wiz_PhyConf* phyconf); +/** + @ingroup extra_functions + @brief Get phy status. + @param phyconf : @ref wiz_PhyConf +*/ +void wizphy_getphystat(wiz_PhyConf* phyconf); +/** + @ingroup extra_functions + @brief set the power mode of phy inside WIZCHIP. Refer to @ref PHYCFGR in W5500, @ref PHYSTATUS in W5200 + @param pmode Settig value of power down mode. +*/ +int8_t wizphy_setphypmode(uint8_t pmode); +//teddy 240122 +#elif ((_WIZCHIP_ == W6100)||(_WIZCHIP_ == W6300)) +/** + @ingroup extra_functions + @brief Reset the integrated PHY. + @details @ref wizphy_reset() resets the integrated Ethernet PHY \n + through @ref _PHY_IO_MODE_PHYCR_ or @ref _PHY_IO_MODE_MII_. \n + @note In @ref _PHY_IO_MODE_PHYCR_, It needs a stable reset time. \n + So you need to wait for the stable reset time.\n + The stable reset time for each @ref _WIZCHIP_ maybe different. + @sa ctlwizchip(), CW_RESET_PHY + @sa _PHY_IO_MODE_ +*/ +void wizphy_reset(void); ///< Reset phy. Vailid only in W5500 + +/** + @ingroup extra_functions + @details @ref wizphy_setphyconf() set a operation mode of the integrated Ethernet PHY \n + through @ref _PHY_IO_MODE_PHYCR_ or @ref _PHY_IO_MODE_MII_.\n + @param phyconf : @ref wiz_PhyConf + @note The operation mode can be applied to Ethernet PHY after the Ethernet PHY is reset by @ref wizphy_reset(). + @sa ctlwizchip(), CW_SET_PHYCONF, CW_GET_PHYCONF, CW_GET_PHYSTATUS, CW_RESET_PHY + @sa _PHY_IO_MODE_, wizphy_getphyconf(), wizphy_getphystatus(), wizphy_reset() +*/ +void wizphy_setphyconf(wiz_PhyConf* phyconf); + +/** + @ingroup extra_functions + @brief Get the integrated Ethernet PHY operation mode. + @details @ref wizphy_getphyconf() gets a operation mode of the integrated Ethernet PHY \n + through @ref _PHY_IO_MODE_PHYCR_ or @ref _PHY_IO_MODE_MII_.\n + @param phyconf : @ref wiz_PhyConf + @note It gets just the configured value for PHY operation, not real PHY operation.\n + To get real PHY operation, you can call @ref wizphy_getphystatus() + @sa ctlwizchip(), CW_GET_PHYCONF, CW_SET_PHYCONF, CW_GET_PHYSTATUS + @sa _PHY_IO_MODE_, wizphy_setphyconf(), wizphy_getphystatus() +*/ +void wizphy_getphyconf(wiz_PhyConf* phyconf); + +/** + @ingroup extra_functions + @brief Get the real PHY operation status when link is established. + @details @ref wizphy_getphystatus() gets a operation mode of the integrated Ethernet PHY. \n + @param phyconf : @ref wiz_PhyConf + @sa ctlwizchip(), CW_GET_PHYSTATUS, CW_GET_PHYCONF, CW_SET_PHYCONF + @sa wizphy_setphyconf(), wizphy_getphyconf() +*/ +void wizphy_getphystat(wiz_PhyConf* phyconf); + +/** + @ingroup extra_functions + @brief Set the power mode of integrated Ethernet PHY. + @details @ref wizphy_setphypmode() sets a power mode of the integrated Ethernet PHY \n + through @ref _PHY_IO_MODE_PHYCR_ or @ref _PHY_IO_MODE_MII_.\n + @param pmode @ref PHY_POWER_NORM or @ref PHY_POWER_DOWN + @note When the integrated Ethernet PHY enters in power down mode, \n + the system clock of @ref _WIZCHIP_ is changed to the lowest speed. \n + So, you should adjust the access time of @ref _WIZCHIP_ to the changed system clock. + @sa ctlwizchip(), CW_SET_PHYPOWMODE, CW_GET_PHYPOWMODE + @sa _PHY_IO_MODE_, wizphy_setphypmode(), wizphy_getphypmode() +*/ +void wizphy_setphypmode(uint8_t pmode); + +/** + @ingroup extra_functions + @brief get the power mode of integrated Ethernet PHY. + @details @ref wizphy_getphypmode() gets a power mode of the integrated Ethernet PHY \n + through @ref _PHY_IO_MODE_PHYCR_ or @ref _PHY_IO_MODE_MII_.\n + @return @ref PHY_POWER_NORM or @ref PHY_POWER_DOWN + @note When the integrated Ethernet PHY enters in power down mode,\n + the system clock of @ref _WIZCHIP_ is changed to the lowest speed. \n + So, you should adjust the access time of @ref _WIZCHIP_ to the changed system clock. + @sa ctlwizchip(), CW_SET_PHYPOWMODE, CW_GET_PHYPOWMODE + @sa _PHY_IO_MODE_, wizphy_setphypmode(), wizphy_getphypmode() +*/ +int8_t wizphy_getphypmode(void); + +/** + @ingroup extra_functions + @brief Set the network information for @ref _WIZCHIP_ + @param pnetinfo : @ref wiz_NetInfo + @sa ctlnetwork(), CN_SET_NETINFO, CN_GET_NETINFO + @sa wizchip_getnetinfo() +*/ +void wizchip_setnetinfo(wiz_NetInfo* pnetinfo); + +/** + @ingroup extra_functions + @brief Get the network information of @ref _WIZCHIP_ + @param pnetinfo : @ref wiz_NetInfo + @sa ctlnetwork(), CN_GET_NETINFO, CN_SET_NETINFO + @sa wizchip_setnetinfo() +*/ +void wizchip_getnetinfo(wiz_NetInfo* pnetinfo); + +/** + @ingroup extra_functions + @brief Set the network mode such as WOL, PPPoE, PING Block, and etc. + @param netmode : @ref netmode_type. + @sa ctlnetwork(), CN_SET_NETMODE, CN_GET_NETMODE + @sa wizchip_getnetmode() +*/ +void wizchip_setnetmode(netmode_type netmode); + +/** + @ingroup extra_functions + @brief Get the network mode such as WOL, PPPoE, PING Block, and etc. + @return @ref netmode_type. + @sa ctlnetwork(), CN_GET_NETMODE, CN_SET_NETMODE + @sa wizchip_setnetmode() +*/ +netmode_type wizchip_getnetmode(void); + +/** + @ingroup extra_functions + @brief Set retransmission time values and retry counts. + @param nettime : @ref wiz_NetTimeout. + @sa ctlnetwork(), CN_SET_TIMEOUT, CN_GET_TIMEOUT + @sa wizchip_gettimeout() +*/ +void wizchip_settimeout(wiz_NetTimeout* nettime); + +/** + @ingroup extra_functions + @brief Get retransmission time values and retry counts. + @param nettime : @ref wiz_NetTimeout. + @sa ctlnetwork(), CN_GET_TIMEOUT, CN_SET_TIMEOUT + @sa wizchip_settimeout() +*/ +void wizchip_gettimeout(wiz_NetTimeout* nettime); + +/** + @ingroup extra_functions + @brief ARP process. + @details @ref wizchip_arp() processes ARP. \n + It sends the APR-request to destination and waits to receive the ARP-reply. + @param arp @ref wiz_ARP.\n + It sets a destination IP address and indicates the destination hardware address. + @return 0 : success, destination hardware address is valid.\n + -1 : fail. destination hardware address is invalid because timeout is occurred.\n + @sa ctlnetservice(), CNS_ARP +*/ +int8_t wizchip_arp(wiz_ARP* arp); + +/** + @ingroup extra_functions + @brief PING process. + @details @ref wizchip_ping() processes PING. \n + It sends the PING-request to destination and waits to receive the PING-reply. + @param ping @ref wiz_PING, It sets a destination IP address, ID, SEQ of PING-request message + @return 0 : success, PING-reply is successfully received.\n + -1 : fail. Timeout is occurred.\n + @sa ctlnetservice(), CNS_PING +*/ +int8_t wizchip_ping(wiz_PING* ping); + +/** + @ingroup extra_functions + @brief DAD(Duplcated Address Detection) process. + @details @ref wizchip_dad() detects the duplication of source IPv6 address.\n + It sends a NA message for DAD to all-node multicasting address(FF02::01). + @param ipv6 : IPv6 address to be detected the duplication. + @return 0 : success, There is no duplicated address. \n + -1 : fail. @ref _WIZCHIP_ source IP address to use is duplicated with a neighbor's one. + @sa ctlnetservice(), CNS_DAD +*/ +int8_t wizchip_dad(uint8_t* ipv6); + +/** + @ingroup extra_functions + @brief Stateless Address Auto Configuration(SLAAC) process. + @details @ref wizchip_slaac() get a prefix information from a router for SLAAC.\n + It sends first a RS message to all-router and waits to receive a RS message with prefix information option from a router. + @param prefix @ref wiz_Prefix + @return 0 : success, RA message is successfully received, and prefix is valid. \n + -1 : fail. Timeout is occurred. + @note It is valid only when the prefix information type(0x03) of RA option received first.\n + The prefix option should be in the order of prefix length, prefix flag, valid lifetime, default lifetime and prefix address. \n + For more detail, Refer to @ref SLIR_RS. + @sa ctlnetservice(), CNS_SLAAC +*/ +int8_t wizchip_slaac(wiz_Prefix* prefix); + +/** + @ingroup extra_functions + @brief Unsolicited NA process. + @details @ref wizchip_unsolicited() updates the network information of @ref _WIZCHIP_ to neighbors.\n + It sends a unsolicited NA message with @ref _LLAR_ or @ref _GUAR_ to neighbors \n + in order to update the network information of @ref _WIZCHIP_.\n + Because the unsolicited NA message have no reply, timeout is always occurred. + @return always 0. Timeout is occurred. + @sa ctlnetservice(), CNS_UNSOL +*/ +int8_t wizchip_unsolicited(void); + +/** + @ingroup extra_functions + @brief Get a prefix information of RA message from a router. + @details @ref wizchip_getprefix() get a prefix information of RA is periodically sent by a router. \n + @return 0 : success, a RS message is successfully received from a router. + -1 : fail, a RS message is not received from a router yet. + @note It is valid only when the prefix information type(0x03) of RA option received first.\n + The prefix option should be in the order of prefix length, prefix flag, valid lifetime, default lifetime and prefix address. \n + For more detail, Refer to @ref SLIR_RS. + @sa ctlnetservice(), CNS_GET_PREFIX +*/ +int8_t wizchip_getprefix(wiz_Prefix * prefix); +#endif + +#if (_WIZCHIP_ == W5100 || _WIZCHIP_ == W5100S || _WIZCHIP_ == W5200 || _WIZCHIP_ == W5300 || _WIZCHIP_ == W5500) +/** + @ingroup extra_functions + @brief Set the network information for WIZCHIP + @param pnetinfo : @ref wizNetInfo +*/ +void wizchip_setnetinfo(wiz_NetInfo* pnetinfo); + +/** + @ingroup extra_functions + @brief Get the network information for WIZCHIP + @param pnetinfo : @ref wizNetInfo +*/ +void wizchip_getnetinfo(wiz_NetInfo* pnetinfo); + +/** + @ingroup extra_functions + @brief Set the network mode such WOL, PPPoE, Ping Block, and etc. + @param pnetinfo Value of network mode. Refer to @ref netmode_type. +*/ +int8_t wizchip_setnetmode(netmode_type netmode); + +/** + @ingroup extra_functions + @brief Get the network mode such WOL, PPPoE, Ping Block, and etc. + @return Value of network mode. Refer to @ref netmode_type. +*/ +netmode_type wizchip_getnetmode(void); + +/** + @ingroup extra_functions + @brief Set retry time value(@ref _RTR_) and retry count(@ref _RCR_). + @details @ref _RTR_ configures the retransmission timeout period and @ref _RCR_ configures the number of time of retransmission. + @param nettime @ref _RTR_ value and @ref _RCR_ value. Refer to @ref wiz_NetTimeout. +*/ +void wizchip_settimeout(wiz_NetTimeout* nettime); + +/** + @ingroup extra_functions + @brief Get retry time value(@ref _RTR_) and retry count(@ref _RCR_). + @details @ref _RTR_ configures the retransmission timeout period and @ref _RCR_ configures the number of time of retransmission. + @param nettime @ref _RTR_ value and @ref _RCR_ value. Refer to @ref wiz_NetTimeout. +*/ +void wizchip_gettimeout(wiz_NetTimeout* nettime); +//teddy 240122 +#elif ((_WIZCHIP_ == W6100)||(_WIZCHIP_ == W6300)) +/** + @ingroup extra_functions + @brief Set the network information for @ref _WIZCHIP_ + @param pnetinfo : @ref wiz_NetInfo + @sa ctlnetwork(), CN_SET_NETINFO, CN_GET_NETINFO + @sa wizchip_getnetinfo() +*/ +void wizchip_setnetinfo(wiz_NetInfo* pnetinfo); + +/** + @ingroup extra_functions + @brief Get the network information of @ref _WIZCHIP_ + @param pnetinfo : @ref wiz_NetInfo + @sa ctlnetwork(), CN_GET_NETINFO, CN_SET_NETINFO + @sa wizchip_setnetinfo() +*/ +void wizchip_getnetinfo(wiz_NetInfo* pnetinfo); + +/** + @ingroup extra_functions + @brief Set the network mode such as WOL, PPPoE, PING Block, and etc. + @param netmode : @ref netmode_type. + @sa ctlnetwork(), CN_SET_NETMODE, CN_GET_NETMODE + @sa wizchip_getnetmode() +*/ +void wizchip_setnetmode(netmode_type netmode); + +/** + @ingroup extra_functions + @brief Get the network mode such as WOL, PPPoE, PING Block, and etc. + @return @ref netmode_type. + @sa ctlnetwork(), CN_GET_NETMODE, CN_SET_NETMODE + @sa wizchip_setnetmode() +*/ +netmode_type wizchip_getnetmode(void); + +/** + @ingroup extra_functions + @brief Set retransmission time values and retry counts. + @param nettime : @ref wiz_NetTimeout. + @sa ctlnetwork(), CN_SET_TIMEOUT, CN_GET_TIMEOUT + @sa wizchip_gettimeout() +*/ +void wizchip_settimeout(wiz_NetTimeout* nettime); + +/** + @ingroup extra_functions + @brief Get retransmission time values and retry counts. + @param nettime : @ref wiz_NetTimeout. + @sa ctlnetwork(), CN_GET_TIMEOUT, CN_SET_TIMEOUT + @sa wizchip_settimeout() +*/ +void wizchip_gettimeout(wiz_NetTimeout* nettime); + +#endif + +#ifdef __cplusplus +} +#endif + +#endif // _WIZCHIP_CONF_H_ diff --git a/Internet/AAC/AddressAutoConfig.c b/Internet/AAC/AddressAutoConfig.c new file mode 100644 index 0000000..1d3b333 --- /dev/null +++ b/Internet/AAC/AddressAutoConfig.c @@ -0,0 +1,681 @@ +//* **************************************************************************** +//! \file AddressAutoConfig.c +//! \brief IPv6 AddressAutoConfig Source File. +//! \version 1.0.0 +//! \date 2019/01/01 +//! \par Revision history +//! <2019/01/01> 1st Release +//! \author WIZnet +//! \copyright +//! +//! Copyright (c) 2019, WIZnet Co., LTD. +//! +//! 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 "AddressAutoConfig.h" + +#if (_WIZCHIP_ == W6100) + +#define MY_MAX_DHCP6_RETRY 3 +uint8_t AAC_SOCKET; // Socket number for AddressAutoConfi + +/** + @brief + +*/ +extern uint8_t DNS6_Address[16]; + +/** + @brief + + @param netinfo + @param test_buf + @return uint8_t +*/ +uint8_t AddressAutoConfig_Init(uint8_t s, wiz_NetInfo *netinfo) { + uint8_t MO_flag; + uint8_t result_aac = 0; + uint8_t data_buf[2048] = { + 0, + }; + + AAC_SOCKET = s; // SOCK_AAC + + // DAD LLA + printf("Duplicate_Address_Detection\r\n"); + Duplicate_Address_Detection(netinfo); + ctlnetwork(CN_SET_NETINFO, netinfo); + print_network_information(); + + // RSRA + printf("Address_Auto_Configuration Start\r\n"); + MO_flag = Address_Auto_Config_RA(AAC_SOCKET, data_buf, sizeof(data_buf), netinfo); + ctlnetwork(CN_SET_NETINFO, netinfo); + print_network_information(); + + if (MO_flag == SLAAC_RDNSS) { + // Completed + + printf("Address_Auto_Configuration Succeed\r\n"); + result_aac = 1; + } else if (MO_flag == SLAAC_DHCP6) { + // Need Stateless DHCP + // Get Other Information + + printf("Address_Auto_Configuration Failed\r\n"); + printf("Stateless DHCP Start\r\n"); + + memset(data_buf, 0, sizeof(data_buf)); + result_aac = Address_Auto_Config_SLDHCP(AAC_SOCKET, data_buf); + if (result_aac == 1) { + printf(" Stateless DHCP Succeed\r\n"); + } else { + printf(" Stateless DHCP Failed\r\n"); + } + } else if (MO_flag == SFAAC_DHCP6) { + // Need Stateful DHCP + // Get Managed Information + + printf("Address_Auto_Configuration Failed\r\n"); + printf("Stateful DHCP Start\r\n"); + + memset(data_buf, 0, sizeof(data_buf)); + result_aac = Address_Auto_Config_SFDHCP(AAC_SOCKET, data_buf, netinfo); + if (result_aac == 1) { + printf("Stateful DHCP Succeed\r\n"); + } else { + printf("Stateful DHCP Failed\r\n"); + } + + ctlnetwork(CN_SET_NETINFO, netinfo); + print_network_information(); + } else { + printf("Address_Auto_Configuration Failed MO_Flag : 0x%x\r\n", MO_flag); + result_aac = 0; + } + + while (SOCK_OK != close(AAC_SOCKET)); + + return result_aac; +} + +/** + @brief + + @param sn + @param test_buf + @return uint8_t +*/ +uint8_t Address_Auto_Config_SLDHCP(uint8_t sn, uint8_t *test_buf) { + uint8_t result = 0; + uint8_t tmp[16]; + uint32_t toggle = 1; + uint32_t my_dhcp_retry = 0; + + DHCP6_init(sn, test_buf); + + while (1) { + switch (DHCP6_run2()) { + case DHCP6_IP_ASSIGN: + case DHCP6_IP_CHANGED: + /* If this block empty, act with default_ip_assign & default_ip_update */ + // + // This example calls the registered 'my_ip_assign' in the two case. + // + // Add to ... + // + // + toggle = 1; + if (toggle) { + getGAR(tmp); + printf("> DHCP GW : %d.%d.%d.%d\r\n", tmp[0], tmp[1], tmp[2], tmp[3]); + getSUBR(tmp); + printf("> DHCP SN : %d.%d.%d.%d\r\n", tmp[0], tmp[1], tmp[2], tmp[3]); + getSIPR(tmp); + printf("> DHCP IP : %d.%d.%d.%d\r\n", tmp[0], tmp[1], tmp[2], tmp[3]); + toggle = 0; + close(sn); /* + If renewal IP address was defferent previous IP address, + socket becomes to disconnect or close for new connection. +*/ + } + break; + case DHCP6_IP_LEASED: + // + if (toggle) { + getSHAR(tmp); + printf("Mac address : %.2x:%.2x:%.2x:%.2x:%.2x:%.2x \r\n", tmp[0], tmp[1], tmp[2], tmp[3], tmp[4], tmp[5]); + getLLAR(tmp); + printf("your Link Local IP is %.2x%.2x:%.2x%.2x:%.2x%.2x:%.2x%.2x:%.2x%.2x:%.2x%.2x:%.2x%.2x:%.2x%.2x \r\n", tmp[0], tmp[1], tmp[2], tmp[3], + tmp[4], tmp[5], tmp[6], tmp[7], + tmp[8], tmp[9], tmp[10], tmp[11], + tmp[12], tmp[13], tmp[14], tmp[15]); + getGUAR(tmp); + printf("your Global IP is %.2x%.2x:%.2x%.2x:%.2x%.2x:%.2x%.2x:%.2x%.2x:%.2x%.2x:%.2x%.2x:%.2x%.2x \r\n", tmp[0], tmp[1], tmp[2], tmp[3], + tmp[4], tmp[5], tmp[6], tmp[7], + tmp[8], tmp[9], tmp[10], tmp[11], + tmp[12], tmp[13], tmp[14], tmp[15]); + getGA6R(tmp); + printf("your Gateway IP is %.2x%.2x:%.2x%.2x:%.2x%.2x:%.2x%.2x:%.2x%.2x:%.2x%.2x:%.2x%.2x:%.2x%.2x \r\n", tmp[0], tmp[1], tmp[2], tmp[3], + tmp[4], tmp[5], tmp[6], tmp[7], + tmp[8], tmp[9], tmp[10], tmp[11], + tmp[12], tmp[13], tmp[14], tmp[15]); + + printf("your DNSv6 is %.2x%.2x:%.2x%.2x:%.2x%.2x:%.2x%.2x:%.2x%.2x:%.2x%.2x:%.2x%.2x:%.2x%.2x \r\n", DNS6_Address[0], DNS6_Address[1], DNS6_Address[2], DNS6_Address[3], + DNS6_Address[4], DNS6_Address[5], DNS6_Address[6], DNS6_Address[7], + DNS6_Address[8], DNS6_Address[9], DNS6_Address[10], DNS6_Address[11], + DNS6_Address[12], DNS6_Address[13], DNS6_Address[14], DNS6_Address[15]); + toggle = 0; + } + return 1; + + case DHCP6_FAILED: + /* ===== Example pseudo code ===== */ + // The below code can be replaced your code or omitted. + // if omitted, retry to process DHCP + my_dhcp_retry++; + if (my_dhcp_retry > MY_MAX_DHCP6_RETRY) { +#if DEBUG_MODE != DEBUG_NO + printf(">> DHCP %d Failed\r\n", my_dhcp_retry); +#endif + my_dhcp_retry = 0; + DHCP6_stop(); // if restart, recall DHCP6_init() + } + break; + default: + break; + } + } + + return result; +} + +/** + @brief + + @param sn + @param test_buf + @return uint8_t +*/ +uint8_t Address_Auto_Config_SFDHCP(uint8_t sn, uint8_t *test_buf, wiz_NetInfo *netinfo) { + uint8_t result; + uint8_t tmp[16]; + uint32_t toggle = 1; + uint32_t my_dhcp_retry = 0; + + DHCP6_init(sn, test_buf); + + while (1) { + switch (DHCP6_run(netinfo)) { + case DHCP6_IP_ASSIGN: + case DHCP6_IP_CHANGED: + /* If this block empty, act with default_ip_assign & default_ip_update */ + // + // This example calls the registered 'my_ip_assign' in the two case. + // + // Add to ... + // + // + toggle = 1; + if (toggle) { + // getGAR(tmp); printf("> DHCP GW : %d.%d.%d.%d\r\n", tmp[0], tmp[1], tmp[2], tmp[3]); + // getSUBR(tmp); printf("> DHCP SN : %d.%d.%d.%d\r\n", tmp[0], tmp[1], tmp[2], tmp[3]); + // getSIPR(tmp); printf("> DHCP IP : %d.%d.%d.%d\r\n", tmp[0], tmp[1], tmp[2], tmp[3]); + toggle = 0; + close(sn); /* + If renewal IP address was defferent previous IP address, + socket becomes to disconnect or close for new connection. +*/ + } + break; + case DHCP6_IP_LEASED: + // + if (toggle) { + getSHAR(tmp); + printf("Mac address : %.2x:%.2x:%.2x:%.2x:%.2x:%.2x \r\n", tmp[0], tmp[1], tmp[2], tmp[3], tmp[4], tmp[5]); + getLLAR(tmp); + printf("your Link Local IP is %.2x%.2x:%.2x%.2x:%.2x%.2x:%.2x%.2x:%.2x%.2x:%.2x%.2x:%.2x%.2x:%.2x%.2x \r\n", tmp[0], tmp[1], tmp[2], tmp[3], + tmp[4], tmp[5], tmp[6], tmp[7], + tmp[8], tmp[9], tmp[10], tmp[11], + tmp[12], tmp[13], tmp[14], tmp[15]); + getGUAR(tmp); + printf("your Global IP is %.2x%.2x:%.2x%.2x:%.2x%.2x:%.2x%.2x:%.2x%.2x:%.2x%.2x:%.2x%.2x:%.2x%.2x \r\n", tmp[0], tmp[1], tmp[2], tmp[3], + tmp[4], tmp[5], tmp[6], tmp[7], + tmp[8], tmp[9], tmp[10], tmp[11], + tmp[12], tmp[13], tmp[14], tmp[15]); + getGA6R(tmp); + printf("your Gateway IP is %.2x%.2x:%.2x%.2x:%.2x%.2x:%.2x%.2x:%.2x%.2x:%.2x%.2x:%.2x%.2x:%.2x%.2x \r\n", tmp[0], tmp[1], tmp[2], tmp[3], + tmp[4], tmp[5], tmp[6], tmp[7], + tmp[8], tmp[9], tmp[10], tmp[11], + tmp[12], tmp[13], tmp[14], tmp[15]); + + printf("your DNSv6 is %.2x%.2x:%.2x%.2x:%.2x%.2x:%.2x%.2x:%.2x%.2x:%.2x%.2x:%.2x%.2x:%.2x%.2x \r\n", DNS6_Address[0], DNS6_Address[1], DNS6_Address[2], DNS6_Address[3], + DNS6_Address[4], DNS6_Address[5], DNS6_Address[6], DNS6_Address[7], + DNS6_Address[8], DNS6_Address[9], DNS6_Address[10], DNS6_Address[11], + DNS6_Address[12], DNS6_Address[13], DNS6_Address[14], DNS6_Address[15]); + toggle = 0; + } + return 1; + + case DHCP6_FAILED: + /* ===== Example pseudo code ===== */ + // The below code can be replaced your code or omitted. + // if omitted, retry to process DHCP + my_dhcp_retry++; + if (my_dhcp_retry > MY_MAX_DHCP6_RETRY) { +#if DEBUG_MODE != DEBUG_NO + printf(">> DHCP %d Failed\r\n", my_dhcp_retry); +#endif + my_dhcp_retry = 0; + DHCP6_stop(); // if restart, recall DHCP6_init() + return 0; + } + break; + default: + break; + } + } + + return result; +} + +/** + @brief + + @param sn + @param icmpbuf + @param buf_size + @param netinfo + @return uint8_t +*/ +uint8_t Address_Auto_Config_RA(uint8_t sn, uint8_t *icmpbuf, uint16_t buf_size, wiz_NetInfo *netinfo) { + uint8_t result; + + volatile uint16_t size; + uint8_t destip[16]; + uint16_t destport; + uint8_t addr_len, o_len; + uint8_t flags; + + uint8_t *p; + uint8_t *e; + int i; + uint8_t o_type, type, code, RA_flag, MO_flag; //, O_flag; + uint16_t Router_lifetime; + uint32_t Reachable_time, Retrans_time; + uint32_t end_point; + uint8_t prefix_len, pi_flag; + uint32_t validtime, prefertime, dnstime; + uint8_t prefix[16]; + + if (getSLCR() != 0x00) { //check clear CMD +#if (AutoConfig_debug == debug_on) + printf("ERROR : RQCMD is not clear\r\n"); +#endif + result = ERROR_SLCMD; + return result; + } + + setICMP6BLKR(ICMP6BLKR_RA); + printf("getICMP6BLKR() = 0x%x\r\n", getICMP6BLKR()); // 0X4 + + setSn_PNR(sn, PROTOCOL_NUM_ICMPv6); //ICMPv6 : 58 + printf("getSn_PROTOR(%d) = 0x%x\r\n", sn, getSn_PNR(sn)); // 0X3a + + socket(sn, Sn_MR_IPRAW6, 0, 0); + +#if 1 + printf("Sn_SR : %x \r\n", getSn_SR(sn)); // 0X21 33 +#else +#if (AutoConfig_debug == debug_on) + printf("Sn_SR : %x \r\n", getSn_SR(sn)); +#endif +#endif + + setSLRTR(4000); + printf("getSLRTR() = 0x%x\r\n", getSLRTR()); // 0xfa0 4000 + + setSLRCR(0); + printf("getSLRCR() = 0x%x\r\n", getSLRCR()); // 0 + + setSLCR(SLCR_RS); + printf("getSLCR() = 0x%x\r\n", getSLCR()); // 0 + printf("getSLIR() = 0x%x\r\n", getSLIR()); // 0 +#if (AutoConfig_debug == debug_on) + printf("Wait SLIR.....\r\n"); +#endif + + do { + if (getSn_RX_RSR(sn) > 0) { + printf("getSLIR() = 0x%x\r\n", getSLIR()); // 0 + + printf("getSn_RX_RSR(%d) = 0x%x\r\n", sn, getSn_RX_RSR(sn)); // 0x4a 74 + printf("size : %d \r\n", sizeof(icmpbuf)); + size = recvfrom(sn, icmpbuf, buf_size, destip, &destport, &addr_len); + printf("recvfrom IP : %x%x:%x%x:%x%x:%x%x:%x%x:%x%x:%x%x:%x%x \r\n", destip[0], destip[1], destip[2], destip[3], destip[4], destip[5], destip[6], destip[7], destip[8], destip[9], destip[10], destip[11], destip[12], destip[13], destip[14], destip[15]); + // ================================================= + // 20190402 + // Taylor + // + // Set Gateway from source + memcpy(netinfo->gw6, destip, 16); + + // ================================================= + } + + p = icmpbuf; + } while (*p != ROUTER_ADVERTISEMENT); + + e = p + size; + switch (*p) { + case ROUTER_ADVERTISEMENT: + printf("RA\r\n"); + type = *p++; + printf("type : %x \r\n", type); + code = *p++; + printf("code : %x \r\n", code); + p++; + p++; //checksum + p++; //Cur hop limit + RA_flag = *p++; + printf("RA_flag : %x \r\n", RA_flag); + Router_lifetime = *p++ << 8; + Router_lifetime = Router_lifetime + (*p++); + printf("Router_lifetime : %d s \r\n", Router_lifetime); + Reachable_time = *p++ << 24; + Reachable_time = Reachable_time + (*p++ << 16); + Reachable_time = Reachable_time + (*p++ << 8); + Reachable_time = Reachable_time + (*p++); + printf("Reachable_time : %d ms \r\n", Reachable_time); + Retrans_time = *p++ << 24; + Retrans_time = Retrans_time + (*p++ << 16); + Retrans_time = Retrans_time + (*p++ << 8); + Retrans_time = Retrans_time + (*p++); + printf("Retrans_time : %d ms \r\n", Retrans_time); + + while (p < e) { + switch (*p) { + case RAO_SLLA: + o_type = *p++; + printf("Option Type : %d (Source LLA) \r\n", o_type); + o_len = (*p++) * 8; + printf("Option length : %d \r\n", o_len); + p += (o_len - 2); + break; + case RAO_TLLA: + o_type = *p++; + printf("Option Type : %d (Target LLA) \r\n", o_type); + o_len = (*p++) * 8; + printf("Option length : %d \r\n", o_len); + p += (o_len - 2); + break; + case RAO_PI: + o_type = *p++; + printf("Option Type : %d (Prefix information) \r\n", o_type); + o_len = (*p++) * 8; + printf("Option length : %d \r\n", o_len); + end_point = (uint32_t)p - 2 + o_len; + prefix_len = *p++; + printf("Prefix Length : %d \r\n", prefix_len); + pi_flag = *p++; + printf("Prefix Information Flag : %.2x \r\n", pi_flag); + validtime = (*p++ << 24); + validtime += (*p++ << 16); + validtime += (*p++ << 8); + validtime += (*p++); + printf("valid lifetime : %d \r\n", validtime); + prefertime = (*p++ << 24); + prefertime += (*p++ << 16); + prefertime += (*p++ << 8); + prefertime += (*p++); + printf("preferred lifetime : %d \r\n", prefertime); + p++; + p++; + p++; + p++; //reserved + getLLAR(prefix); + for (int i = 0; i < prefix_len / 8; i++) { + prefix[i] = *p++; + + // ================================================= + // 20190416 + // Taylor + // + // Set Subnet Mask from prefix + + netinfo->sn6[i] = 0xFF; + + // ================================================= + } + + memcpy(netinfo->gua, prefix, 16); + + while ((uint32_t)p != end_point) { + p++; + } + printf("prefix : "); + for (i = 0; i < prefix_len / 8; i++) { + printf("%.2x", prefix[i]); + if (1 == (i % 2)) { + printf(":"); + } + } + printf(":\r\n"); + break; + case RAO_RH: + o_type = *p++; + printf("Option Type : %d (Redirected Header) \r\n", o_type); + o_len = (*p++) * 8; + printf("Option length : %d \r\n", o_len); + p += (o_len - 2); + break; + case RAO_MTU: + o_type = *p++; + printf("Option Type : %d (MTU) \r\n", o_type); + o_len = (*p++) * 8; + printf("Option length : %d \r\n", o_len); + p += (o_len - 2); + break; + case RAO_RDNS: + o_type = *p++; + printf("Option Type : %d (Recursive DNS Server) \r\n", o_type); + o_len = (*p++) * 8; + printf("Option length : %d \r\n", o_len); + end_point = (uint32_t)p - 2 + o_len; + p++; + p++; //reserved + dnstime = (*p++ << 24); + dnstime += (*p++ << 16); + dnstime += (*p++ << 8); + dnstime += (*p++); + printf("DNS lifetime : %d \r\n", dnstime); + DNS6_Address[0] = *p++; + DNS6_Address[1] = *p++; + DNS6_Address[2] = *p++; + DNS6_Address[3] = *p++; + DNS6_Address[4] = *p++; + DNS6_Address[5] = *p++; + DNS6_Address[6] = *p++; + DNS6_Address[7] = *p++; + DNS6_Address[8] = *p++; + DNS6_Address[9] = *p++; + DNS6_Address[10] = *p++; + DNS6_Address[11] = *p++; + DNS6_Address[12] = *p++; + DNS6_Address[13] = *p++; + DNS6_Address[14] = *p++; + DNS6_Address[15] = *p++; + while ((uint32_t)p != end_point) { + p++; + } + printf("DNS IP : "); + for (i = 0; i < 15; i++) { + printf("%.2x", DNS6_Address[i]); + if (1 == (i % 2)) { + printf(":"); + } + } + printf("%x\r\n", DNS6_Address[15]); + break; + default: + printf("default\r\n"); + o_type = *p++; + printf("o_type : %d \r\n", o_type); + o_len = (*p++) * 8; + printf("o_len : %d \r\n", o_len); +#if 1 + // 20231106 taylor + if (o_len > 0) { + p += (o_len - 2); + } else { + p ++; + } +#else + p += (o_len - 2); +#endif + break; + } // ICMP option + } //while + } + + close(sn); + + printf("RA : %x \r\n", RA_flag); + + //M_flag = RA_flag >> 7; + MO_flag = RA_flag >> 6; + + printf("MO : %x \r\n", MO_flag); + + result = MO_flag; + + return result; +} + +/** + @brief + + @param netinfo + @return uint8_t +*/ +uint8_t Duplicate_Address_Detection(wiz_NetInfo *netinfo) { + uint8_t result; + + uint8_t WIZ_LLA[16] = {0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0}; + + uint8_t flags; + uint8_t tmp_array[16]; + uint16_t i; + + setSLRTR(2000); + setSLRCR(5); + + Generate_EUI64(netinfo->mac, WIZ_LLA); + + setSLDIP6R(WIZ_LLA); //target address setting + + //setSLIMR(SLIR_TIOUT|SLIR_NS); //only external interrupt??? + + if (getSLCR() != 0x00) { //check clear CMD +#if (AutoConfig_debug == debug_on) + printf("ERROR : RQCMD is not clear %x \r\n", getSLCR()); +#endif + while (1) + ; + } + + setSLCR(SLCR_NS); + +#if (AutoConfig_debug == debug_on) + printf("Wait RQIR.....\r\n"); +#endif + + do { + flags = getSLIR(); + + if (flags & SLIR_TOUT) { +#if (AutoConfig_debug == debug_on) + printf("\r\nTimeout !!! DAD SUCCESSED\r\n"); +#endif +#if 0 + // 20190401 + NETCFG_UNLOCK(); +#endif + //-- Set Link Local Address + memcpy(netinfo->lla, WIZ_LLA, 16); + +#if 0 + // 20190404 + // Display memcpy result + + printf("WIZ_LLA:\r\n"); + for (i = 0; i < 16; i += 2) { + printf("%.2x%.2x:", WIZ_LLA[i], WIZ_LLA[i + 1]); + } + printf("\r\n"); + + printf("netinfo->mac:\r\n"); + for (i = 0; i < 16; i += 2) { + printf("%.2x%.2x:", netinfo->lla[i], netinfo->lla[i + 1]); + } + printf("\r\n"); +#endif + +#if 0 + // 20190401 + NETCFG_LOCK(); +#endif + result = SUCCESS; + } else if (flags & SLIR_NS) { +#if (AutoConfig_debug == debug_on) + printf("\r\nReceived NA !!! DAD FAILED\r\n"); +#endif + result = ERROR_DAD_FAIL; + } + } while (!((flags & SLIR_TOUT) || (flags & SLIR_NS))); + printf("\r\nflags = 0x%x\r\n", flags); + setSLIRCLR(flags); + + return result; +} + +/** + @brief + + @param mac_addr + @param Link_Local_Addr +*/ +void Generate_EUI64(uint8_t *mac_addr, uint8_t *Link_Local_Addr) { + *Link_Local_Addr = 0xfe; + *(Link_Local_Addr + 1) = 0x80; + //00:00:00:00:00:00 + *(Link_Local_Addr + 8) = *(mac_addr); //flip the 7th bit of 1st byte + *(Link_Local_Addr + 8) ^= 1 << 1; + *(Link_Local_Addr + 9) = *(mac_addr + 1); + *(Link_Local_Addr + 10) = *(mac_addr + 2); + *(Link_Local_Addr + 11) = 0xFF; + *(Link_Local_Addr + 12) = 0xFE; + *(Link_Local_Addr + 13) = *(mac_addr + 3); + *(Link_Local_Addr + 14) = *(mac_addr + 4); + *(Link_Local_Addr + 15) = *(mac_addr + 5); +} + +#endif diff --git a/Internet/AAC/AddressAutoConfig.h b/Internet/AAC/AddressAutoConfig.h new file mode 100644 index 0000000..934e284 --- /dev/null +++ b/Internet/AAC/AddressAutoConfig.h @@ -0,0 +1,133 @@ +//* **************************************************************************** +//! \file AddressAutoConfig.h +//! \brief IPv6 AddressAutoConfig Header File. +//! \version 1.0.0 +//! \date 2019/01/01 +//! \par Revision history +//! <2019/01/01> 1st Release +//! \author WIZnet +//! \copyright +//! +//! Copyright (c) 2019, WIZnet Co., LTD. +//! +//! 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 _ADDRESSAUTOCONFIG_H_ +#define _ADDRESSAUTOCONFIG_H_ + +#include "stdio.h" +#include "stdint.h" +#if 1 +// 20231020 taylor +#if 0 +#endif +#else +#include "w6100.h" +#endif +#include "socket.h" +#if 1 +// 20231020 taylor +#include "../DHCP6/dhcpv6.h" +#else +#include "dhcpv6.h" +#endif + +#if (_WIZCHIP_ == W6100) + +#define AutoConfig_debug debug_on +#define debug_on 1 +#define debug_off 0 + +#define PROTOCOL_NUM_ICMPv6 58 + +#define ROUTER_ADVERTISEMENT 134 + +#define SUCCESS 0 +#define ERROR_DAD_FAIL -1 +#define ERROR_SLCMD -2 +#define ERROR_TIMEOUT -3 + +#define SLAAC_RDNSS 0 +#define SLAAC_DHCP6 1 +#define SFAAC_DHCP6 3 + +#define RAO_SLLA 1 +#define RAO_TLLA 2 +#define RAO_PI 3 +#define RAO_RH 4 +#define RAO_MTU 5 +#define RAO_RDNS 25 + +/** + @brief + + @param netinfo + @return uint8_t +*/ +uint8_t AddressAutoConfig_Init(uint8_t s, wiz_NetInfo* netinfo); + +/** + @brief + + @param mac_addr + @param Link_Local_Addr +*/ +void Generate_EUI64(uint8_t *mac_addr, uint8_t *Link_Local_Addr); + +/** + @brief + + @param netinfo + @return uint8_t +*/ +uint8_t Duplicate_Address_Detection(wiz_NetInfo* netinfo); + +/** + @brief + + @param sn + @param icmpbuf + @param buf_size + @param netinfo + @return uint8_t +*/ +uint8_t Address_Auto_Config_RA(uint8_t sn, uint8_t *icmpbuf, uint16_t buf_size, wiz_NetInfo* netinfo); + +/** + @brief + + @param sn + @param test_buf + @return uint8_t +*/ +uint8_t Address_Auto_Config_SLDHCP(uint8_t sn, uint8_t* test_buf); + +/** + @brief + + @param sn + @param test_buf + @return uint8_t +*/ +uint8_t Address_Auto_Config_SFDHCP(uint8_t sn, uint8_t* test_buf, wiz_NetInfo* netinfo); + +#endif +#endif // _ADDRESSAUTOCONFIG_H_ diff --git a/Internet/DHCP/dhcp.c b/Internet/DHCP/dhcp.c new file mode 100644 index 0000000..3925ca8 --- /dev/null +++ b/Internet/DHCP/dhcp.c @@ -0,0 +1,1118 @@ +//***************************************************************************** +// +//! \file dhcp.c +//! \brief DHCP APIs implement file. +//! \details Processing DHCP protocol as DISCOVER, OFFER, REQUEST, ACK, NACK and DECLINE. +//! \version 1.1.1 +//! \date 2019/10/08 +//! \par Revision history +//! <2019/10/08> compare DHCP server ip address +//! <2013/11/18> 1st Release +//! <2012/12/20> V1.1.0 +//! 1. Optimize code +//! 2. Add reg_dhcp_cbfunc() +//! 3. Add DHCP_stop() +//! 4. Integrate check_DHCP_state() & DHCP_run() to DHCP_run() +//! 5. Don't care system endian +//! 6. Add comments +//! <2012/12/26> V1.1.1 +//! 1. Modify variable declaration: dhcp_tick_1s is declared volatile for code optimization +//! \author Eric Jung & MidnightCow +//! \copyright +//! +//! Copyright (c) 2013, WIZnet Co., 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: +//! +//! * 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 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 "socket.h" +#include "dhcp.h" + +/* If you want to display debug & processing message, Define _DHCP_DEBUG_ in dhcp.h */ + +#ifdef _DHCP_DEBUG_ +#include +#endif + +/* DHCP state machine. */ +#define STATE_DHCP_INIT 0 ///< Initialize +#define STATE_DHCP_DISCOVER 1 ///< send DISCOVER and wait OFFER +#define STATE_DHCP_REQUEST 2 ///< send REQEUST and wait ACK or NACK +#define STATE_DHCP_LEASED 3 ///< ReceiveD ACK and IP leased +#define STATE_DHCP_REREQUEST 4 ///< send REQUEST for maintaining leased IP +#define STATE_DHCP_RELEASE 5 ///< No use +#define STATE_DHCP_STOP 6 ///< Stop processing DHCP + +#define DHCP_FLAGSBROADCAST 0x8000 ///< The broadcast value of flags in @ref RIP_MSG +#define DHCP_FLAGSUNICAST 0x0000 ///< The unicast value of flags in @ref RIP_MSG + +/* DHCP message OP code */ +#define DHCP_BOOTREQUEST 1 ///< Request Message used in op of @ref RIP_MSG +#define DHCP_BOOTREPLY 2 ///< Reply Message used i op of @ref RIP_MSG + +/* DHCP message type */ +#define DHCP_DISCOVER 1 ///< DISCOVER message in OPT of @ref RIP_MSG +#define DHCP_OFFER 2 ///< OFFER message in OPT of @ref RIP_MSG +#define DHCP_REQUEST 3 ///< REQUEST message in OPT of @ref RIP_MSG +#define DHCP_DECLINE 4 ///< DECLINE message in OPT of @ref RIP_MSG +#define DHCP_ACK 5 ///< ACK message in OPT of @ref RIP_MSG +#define DHCP_NAK 6 ///< NACK message in OPT of @ref RIP_MSG +#define DHCP_RELEASE 7 ///< RELEASE message in OPT of @ref RIP_MSG. No use +#define DHCP_INFORM 8 ///< INFORM message in OPT of @ref RIP_MSG. No use + +#define DHCP_HTYPE10MB 1 ///< Used in type of @ref RIP_MSG +#define DHCP_HTYPE100MB 2 ///< Used in type of @ref RIP_MSG + +#define DHCP_HLENETHERNET 6 ///< Used in hlen of @ref RIP_MSG +#define DHCP_HOPS 0 ///< Used in hops of @ref RIP_MSG +#define DHCP_SECS 0 ///< Used in secs of @ref RIP_MSG + +#define INFINITE_LEASETIME 0xffffffff ///< Infinite lease time + +#define OPT_SIZE 312 /// Max OPT size of @ref RIP_MSG +#define RIP_MSG_SIZE (236+OPT_SIZE) /// Max size of @ref RIP_MSG + +/* + @brief DHCP option and value (cf. RFC1533) +*/ +enum { + padOption = 0, + subnetMask = 1, + timerOffset = 2, + routersOnSubnet = 3, + timeServer = 4, + nameServer = 5, + dns = 6, + logServer = 7, + cookieServer = 8, + lprServer = 9, + impressServer = 10, + resourceLocationServer = 11, + hostName = 12, + bootFileSize = 13, + meritDumpFile = 14, + domainName = 15, + swapServer = 16, + rootPath = 17, + extentionsPath = 18, + IPforwarding = 19, + nonLocalSourceRouting = 20, + policyFilter = 21, + maxDgramReasmSize = 22, + defaultIPTTL = 23, + pathMTUagingTimeout = 24, + pathMTUplateauTable = 25, + ifMTU = 26, + allSubnetsLocal = 27, + broadcastAddr = 28, + performMaskDiscovery = 29, + maskSupplier = 30, + performRouterDiscovery = 31, + routerSolicitationAddr = 32, + staticRoute = 33, + trailerEncapsulation = 34, + arpCacheTimeout = 35, + ethernetEncapsulation = 36, + tcpDefaultTTL = 37, + tcpKeepaliveInterval = 38, + tcpKeepaliveGarbage = 39, + nisDomainName = 40, + nisServers = 41, + ntpServers = 42, + vendorSpecificInfo = 43, + netBIOSnameServer = 44, + netBIOSdgramDistServer = 45, + netBIOSnodeType = 46, + netBIOSscope = 47, + xFontServer = 48, + xDisplayManager = 49, + dhcpRequestedIPaddr = 50, + dhcpIPaddrLeaseTime = 51, + dhcpOptionOverload = 52, + dhcpMessageType = 53, + dhcpServerIdentifier = 54, + dhcpParamRequest = 55, + dhcpMsg = 56, + dhcpMaxMsgSize = 57, + dhcpT1value = 58, + dhcpT2value = 59, + dhcpClassIdentifier = 60, + dhcpClientIdentifier = 61, + endOption = 255 +}; + +/* + @brief DHCP message format +*/ +typedef struct { + uint8_t op; ///< @ref DHCP_BOOTREQUEST or @ref DHCP_BOOTREPLY + uint8_t htype; ///< @ref DHCP_HTYPE10MB or @ref DHCP_HTYPE100MB + uint8_t hlen; ///< @ref DHCP_HLENETHERNET + uint8_t hops; ///< @ref DHCP_HOPS + uint32_t xid; ///< @ref DHCP_XID This increase one every DHCP transaction. + uint16_t secs; ///< @ref DHCP_SECS + uint16_t flags; ///< @ref DHCP_FLAGSBROADCAST or @ref DHCP_FLAGSUNICAST + uint8_t ciaddr[4]; ///< @ref Request IP to DHCP sever + uint8_t yiaddr[4]; ///< @ref Offered IP from DHCP server + uint8_t siaddr[4]; ///< No use + uint8_t giaddr[4]; ///< No use + uint8_t chaddr[16]; ///< DHCP client 6bytes MAC address. Others is filled to zero + uint8_t sname[64]; ///< No use + uint8_t file[128]; ///< No use + uint8_t OPT[OPT_SIZE]; ///< Option +} RIP_MSG; + + + +uint8_t DHCP_SOCKET; // Socket number for DHCP + +uint8_t DHCP_SIP[4]; // DHCP Server IP address +uint8_t DHCP_REAL_SIP[4]; // For extract my DHCP server in a few DHCP server + +// Network information from DHCP Server +uint8_t OLD_allocated_ip[4] = {0, }; // Previous IP address +uint8_t DHCP_allocated_ip[4] = {0, }; // IP address from DHCP +uint8_t DHCP_allocated_gw[4] = {0, }; // Gateway address from DHCP +uint8_t DHCP_allocated_sn[4] = {0, }; // Subnet mask from DHCP +uint8_t DHCP_allocated_dns[4] = {0, }; // DNS address from DHCP + + +int8_t dhcp_state = STATE_DHCP_INIT; // DHCP state +int8_t dhcp_retry_count = 0; + +uint32_t dhcp_lease_time = INFINITE_LEASETIME; +volatile uint32_t dhcp_tick_1s = 0; // unit 1 second +uint32_t dhcp_tick_next = DHCP_WAIT_TIME ; + +uint32_t DHCP_XID; // Any number + +RIP_MSG* pDHCPMSG; // Buffer pointer for DHCP processing + +uint8_t HOST_NAME[] = DCHP_HOST_NAME; + +uint8_t DHCP_CHADDR[6]; // DHCP Client MAC address. + +/* The default callback function */ +void default_ip_assign(void); +void default_ip_update(void); +void default_ip_conflict(void); + +/* Callback handler */ +void (*dhcp_ip_assign)(void) = default_ip_assign; /* handler to be called when the IP address from DHCP server is first assigned */ +void (*dhcp_ip_update)(void) = default_ip_update; /* handler to be called when the IP address from DHCP server is updated */ +void (*dhcp_ip_conflict)(void) = default_ip_conflict; /* handler to be called when the IP address from DHCP server is conflict */ + +void reg_dhcp_cbfunc(void(*ip_assign)(void), void(*ip_update)(void), void(*ip_conflict)(void)); + +char NibbleToHex(uint8_t nibble); + +/* send DISCOVER message to DHCP server */ +void send_DHCP_DISCOVER(void); + +/* send REQEUST message to DHCP server */ +void send_DHCP_REQUEST(void); + +/* send DECLINE message to DHCP server */ +void send_DHCP_DECLINE(void); + +/* IP conflict check by sending ARP-request to leased IP and wait ARP-response. */ +int8_t check_DHCP_leasedIP(void); + +/* check the timeout in DHCP process */ +uint8_t check_DHCP_timeout(void); + +/* Initialize to timeout process. */ +void reset_DHCP_timeout(void); + +/* Parse message as OFFER and ACK and NACK from DHCP server.*/ +int8_t parseDHCPCMSG(void); + +/* The default handler of ip assign first */ +void default_ip_assign(void) { + setSIPR(DHCP_allocated_ip); + setSUBR(DHCP_allocated_sn); + setGAR (DHCP_allocated_gw); +} + +/* The default handler of ip changed */ +void default_ip_update(void) { + /* WIZchip Software Reset */ +#if 1 + // 20231019 taylor//teddy 240122 +#if (_WIZCHIP_ == 6100)||(_WIZCHIP_ == 6300) + CHIPUNLOCK(); + setSYCR0(SYCR0_RST); + CHIPLOCK(); + getSYSR(); +#else + setMR(MR_RST); + getMR(); // for delay +#endif +#else + setMR(MR_RST); + getMR(); // for delay +#endif + default_ip_assign(); +#if _WIZCHIP_ == W6100 + NETUNLOCK(); + setSHAR(DHCP_CHADDR); + NETLOCK(); +#else + setSHAR(DHCP_CHADDR); +#endif +} + +/* The default handler of ip changed */ +void default_ip_conflict(void) { + // WIZchip Software Reset +#if 1 + // 20231019 taylor//teddy 240122 +#if (_WIZCHIP_ == 6100)||(_WIZCHIP_ == 6300) + // 20231019 taylor + CHIPUNLOCK(); + setSYCR0(SYCR0_RST); + CHIPLOCK(); + getSYSR(); +#else + setMR(MR_RST); + getMR(); // for delay +#endif +#else + setMR(MR_RST); + getMR(); // for delay +#endif +#if _WIZCHIP_ == W6100 + NETUNLOCK(); + setSHAR(DHCP_CHADDR); + NETLOCK(); +#else + setSHAR(DHCP_CHADDR); +#endif +} + +/* register the call back func. */ +void reg_dhcp_cbfunc(void(*ip_assign)(void), void(*ip_update)(void), void(*ip_conflict)(void)) { + dhcp_ip_assign = default_ip_assign; + dhcp_ip_update = default_ip_update; + dhcp_ip_conflict = default_ip_conflict; + if (ip_assign) { + dhcp_ip_assign = ip_assign; + } + if (ip_update) { + dhcp_ip_update = ip_update; + } + if (ip_conflict) { + dhcp_ip_conflict = ip_conflict; + } +} + +/* make the common DHCP message */ +void makeDHCPMSG(void) { + uint8_t bk_mac[6]; + uint8_t* ptmp; + uint8_t i; + getSHAR(bk_mac); + pDHCPMSG->op = DHCP_BOOTREQUEST; + pDHCPMSG->htype = DHCP_HTYPE10MB; + pDHCPMSG->hlen = DHCP_HLENETHERNET; + pDHCPMSG->hops = DHCP_HOPS; + ptmp = (uint8_t*)(&pDHCPMSG->xid); + *(ptmp + 0) = (uint8_t)((DHCP_XID & 0xFF000000) >> 24); + *(ptmp + 1) = (uint8_t)((DHCP_XID & 0x00FF0000) >> 16); + *(ptmp + 2) = (uint8_t)((DHCP_XID & 0x0000FF00) >> 8); + *(ptmp + 3) = (uint8_t)((DHCP_XID & 0x000000FF) >> 0); + pDHCPMSG->secs = DHCP_SECS; + ptmp = (uint8_t*)(&pDHCPMSG->flags); + *(ptmp + 0) = (uint8_t)((DHCP_FLAGSBROADCAST & 0xFF00) >> 8); + *(ptmp + 1) = (uint8_t)((DHCP_FLAGSBROADCAST & 0x00FF) >> 0); + + pDHCPMSG->ciaddr[0] = 0; + pDHCPMSG->ciaddr[1] = 0; + pDHCPMSG->ciaddr[2] = 0; + pDHCPMSG->ciaddr[3] = 0; + + pDHCPMSG->yiaddr[0] = 0; + pDHCPMSG->yiaddr[1] = 0; + pDHCPMSG->yiaddr[2] = 0; + pDHCPMSG->yiaddr[3] = 0; + + pDHCPMSG->siaddr[0] = 0; + pDHCPMSG->siaddr[1] = 0; + pDHCPMSG->siaddr[2] = 0; + pDHCPMSG->siaddr[3] = 0; + + pDHCPMSG->giaddr[0] = 0; + pDHCPMSG->giaddr[1] = 0; + pDHCPMSG->giaddr[2] = 0; + pDHCPMSG->giaddr[3] = 0; + + pDHCPMSG->chaddr[0] = DHCP_CHADDR[0]; + pDHCPMSG->chaddr[1] = DHCP_CHADDR[1]; + pDHCPMSG->chaddr[2] = DHCP_CHADDR[2]; + pDHCPMSG->chaddr[3] = DHCP_CHADDR[3]; + pDHCPMSG->chaddr[4] = DHCP_CHADDR[4]; + pDHCPMSG->chaddr[5] = DHCP_CHADDR[5]; + + for (i = 6; i < 16; i++) { + pDHCPMSG->chaddr[i] = 0; + } + for (i = 0; i < 64; i++) { + pDHCPMSG->sname[i] = 0; + } + for (i = 0; i < 128; i++) { + pDHCPMSG->file[i] = 0; + } + + // MAGIC_COOKIE + pDHCPMSG->OPT[0] = (uint8_t)((MAGIC_COOKIE & 0xFF000000) >> 24); + pDHCPMSG->OPT[1] = (uint8_t)((MAGIC_COOKIE & 0x00FF0000) >> 16); + pDHCPMSG->OPT[2] = (uint8_t)((MAGIC_COOKIE & 0x0000FF00) >> 8); + pDHCPMSG->OPT[3] = (uint8_t) (MAGIC_COOKIE & 0x000000FF) >> 0; +} + +/* SEND DHCP DISCOVER */ +void send_DHCP_DISCOVER(void) { + uint16_t i; + uint8_t ip[4]; + uint16_t k = 0; + + makeDHCPMSG(); + DHCP_SIP[0] = 0; + DHCP_SIP[1] = 0; + DHCP_SIP[2] = 0; + DHCP_SIP[3] = 0; + DHCP_REAL_SIP[0] = 0; + DHCP_REAL_SIP[1] = 0; + DHCP_REAL_SIP[2] = 0; + DHCP_REAL_SIP[3] = 0; + + k = 4; // because MAGIC_COOKIE already made by makeDHCPMSG() + + // Option Request Param + pDHCPMSG->OPT[k++] = dhcpMessageType; + pDHCPMSG->OPT[k++] = 0x01; + pDHCPMSG->OPT[k++] = DHCP_DISCOVER; + + // Client identifier + pDHCPMSG->OPT[k++] = dhcpClientIdentifier; + pDHCPMSG->OPT[k++] = 0x07; + pDHCPMSG->OPT[k++] = 0x01; + pDHCPMSG->OPT[k++] = DHCP_CHADDR[0]; + pDHCPMSG->OPT[k++] = DHCP_CHADDR[1]; + pDHCPMSG->OPT[k++] = DHCP_CHADDR[2]; + pDHCPMSG->OPT[k++] = DHCP_CHADDR[3]; + pDHCPMSG->OPT[k++] = DHCP_CHADDR[4]; + pDHCPMSG->OPT[k++] = DHCP_CHADDR[5]; + + // host name + pDHCPMSG->OPT[k++] = hostName; + pDHCPMSG->OPT[k++] = 0; // fill zero length of hostname + for (i = 0 ; HOST_NAME[i] != 0; i++) { + pDHCPMSG->OPT[k++] = HOST_NAME[i]; + } + pDHCPMSG->OPT[k++] = NibbleToHex(DHCP_CHADDR[3] >> 4); + pDHCPMSG->OPT[k++] = NibbleToHex(DHCP_CHADDR[3]); + pDHCPMSG->OPT[k++] = NibbleToHex(DHCP_CHADDR[4] >> 4); + pDHCPMSG->OPT[k++] = NibbleToHex(DHCP_CHADDR[4]); + pDHCPMSG->OPT[k++] = NibbleToHex(DHCP_CHADDR[5] >> 4); + pDHCPMSG->OPT[k++] = NibbleToHex(DHCP_CHADDR[5]); + pDHCPMSG->OPT[k - (i + 6 + 1)] = i + 6; // length of hostname + + pDHCPMSG->OPT[k++] = dhcpParamRequest; + pDHCPMSG->OPT[k++] = 0x06; // length of request + pDHCPMSG->OPT[k++] = subnetMask; + pDHCPMSG->OPT[k++] = routersOnSubnet; + pDHCPMSG->OPT[k++] = dns; + pDHCPMSG->OPT[k++] = domainName; + pDHCPMSG->OPT[k++] = dhcpT1value; + pDHCPMSG->OPT[k++] = dhcpT2value; + pDHCPMSG->OPT[k++] = endOption; + + for (i = k; i < OPT_SIZE; i++) { + pDHCPMSG->OPT[i] = 0; + } + + // send broadcasting packet + ip[0] = 255; + ip[1] = 255; + ip[2] = 255; + ip[3] = 255; + +#ifdef _DHCP_DEBUG_ + printf("> Send DHCP_DISCOVER\r\n"); +#endif + +#if 1 + // 20231016 taylor//teddy 240122 +#if ((_WIZCHIP_ == 6100)|| (_WIZCHIP_ == 6300)) + sendto(DHCP_SOCKET, (uint8_t *)pDHCPMSG, RIP_MSG_SIZE, ip, DHCP_SERVER_PORT, 4); +#else + sendto(DHCP_SOCKET, (uint8_t *)pDHCPMSG, RIP_MSG_SIZE, ip, DHCP_SERVER_PORT); +#endif +#else + sendto(DHCP_SOCKET, (uint8_t *)pDHCPMSG, RIP_MSG_SIZE, ip, DHCP_SERVER_PORT); +#endif +} + +/* SEND DHCP REQUEST */ +void send_DHCP_REQUEST(void) { + int i; + uint8_t ip[4]; + uint16_t k = 0; + + makeDHCPMSG(); + + if (dhcp_state == STATE_DHCP_LEASED || dhcp_state == STATE_DHCP_REREQUEST) { + *((uint8_t*)(&pDHCPMSG->flags)) = ((DHCP_FLAGSUNICAST & 0xFF00) >> 8); + *((uint8_t*)(&pDHCPMSG->flags) +1) = (DHCP_FLAGSUNICAST & 0x00FF); + pDHCPMSG->ciaddr[0] = DHCP_allocated_ip[0]; + pDHCPMSG->ciaddr[1] = DHCP_allocated_ip[1]; + pDHCPMSG->ciaddr[2] = DHCP_allocated_ip[2]; + pDHCPMSG->ciaddr[3] = DHCP_allocated_ip[3]; + ip[0] = DHCP_SIP[0]; + ip[1] = DHCP_SIP[1]; + ip[2] = DHCP_SIP[2]; + ip[3] = DHCP_SIP[3]; + } else { + ip[0] = 255; + ip[1] = 255; + ip[2] = 255; + ip[3] = 255; + } + + k = 4; // because MAGIC_COOKIE already made by makeDHCPMSG() + + // Option Request Param. + pDHCPMSG->OPT[k++] = dhcpMessageType; + pDHCPMSG->OPT[k++] = 0x01; + pDHCPMSG->OPT[k++] = DHCP_REQUEST; + + pDHCPMSG->OPT[k++] = dhcpClientIdentifier; + pDHCPMSG->OPT[k++] = 0x07; + pDHCPMSG->OPT[k++] = 0x01; + pDHCPMSG->OPT[k++] = DHCP_CHADDR[0]; + pDHCPMSG->OPT[k++] = DHCP_CHADDR[1]; + pDHCPMSG->OPT[k++] = DHCP_CHADDR[2]; + pDHCPMSG->OPT[k++] = DHCP_CHADDR[3]; + pDHCPMSG->OPT[k++] = DHCP_CHADDR[4]; + pDHCPMSG->OPT[k++] = DHCP_CHADDR[5]; + + if (ip[3] == 255) { // if(dchp_state == STATE_DHCP_LEASED || dchp_state == DHCP_REREQUEST_STATE) + pDHCPMSG->OPT[k++] = dhcpRequestedIPaddr; + pDHCPMSG->OPT[k++] = 0x04; + pDHCPMSG->OPT[k++] = DHCP_allocated_ip[0]; + pDHCPMSG->OPT[k++] = DHCP_allocated_ip[1]; + pDHCPMSG->OPT[k++] = DHCP_allocated_ip[2]; + pDHCPMSG->OPT[k++] = DHCP_allocated_ip[3]; + + pDHCPMSG->OPT[k++] = dhcpServerIdentifier; + pDHCPMSG->OPT[k++] = 0x04; + pDHCPMSG->OPT[k++] = DHCP_SIP[0]; + pDHCPMSG->OPT[k++] = DHCP_SIP[1]; + pDHCPMSG->OPT[k++] = DHCP_SIP[2]; + pDHCPMSG->OPT[k++] = DHCP_SIP[3]; + } + + // host name + pDHCPMSG->OPT[k++] = hostName; + pDHCPMSG->OPT[k++] = 0; // length of hostname + for (i = 0 ; HOST_NAME[i] != 0; i++) { + pDHCPMSG->OPT[k++] = HOST_NAME[i]; + } + pDHCPMSG->OPT[k++] = NibbleToHex(DHCP_CHADDR[3] >> 4); + pDHCPMSG->OPT[k++] = NibbleToHex(DHCP_CHADDR[3]); + pDHCPMSG->OPT[k++] = NibbleToHex(DHCP_CHADDR[4] >> 4); + pDHCPMSG->OPT[k++] = NibbleToHex(DHCP_CHADDR[4]); + pDHCPMSG->OPT[k++] = NibbleToHex(DHCP_CHADDR[5] >> 4); + pDHCPMSG->OPT[k++] = NibbleToHex(DHCP_CHADDR[5]); + pDHCPMSG->OPT[k - (i + 6 + 1)] = i + 6; // length of hostname + + pDHCPMSG->OPT[k++] = dhcpParamRequest; + pDHCPMSG->OPT[k++] = 0x08; + pDHCPMSG->OPT[k++] = subnetMask; + pDHCPMSG->OPT[k++] = routersOnSubnet; + pDHCPMSG->OPT[k++] = dns; + pDHCPMSG->OPT[k++] = domainName; + pDHCPMSG->OPT[k++] = dhcpT1value; + pDHCPMSG->OPT[k++] = dhcpT2value; + pDHCPMSG->OPT[k++] = performRouterDiscovery; + pDHCPMSG->OPT[k++] = staticRoute; + pDHCPMSG->OPT[k++] = endOption; + + for (i = k; i < OPT_SIZE; i++) { + pDHCPMSG->OPT[i] = 0; + } + +#ifdef _DHCP_DEBUG_ + printf("> Send DHCP_REQUEST\r\n"); +#endif + +#if 1 + // 20231016 taylor//teddy 240122 +#if ((_WIZCHIP_ == 6100) || (_WIZCHIP_ == 6300)) + sendto(DHCP_SOCKET, (uint8_t *)pDHCPMSG, RIP_MSG_SIZE, ip, DHCP_SERVER_PORT, 4); +#else + sendto(DHCP_SOCKET, (uint8_t *)pDHCPMSG, RIP_MSG_SIZE, ip, DHCP_SERVER_PORT); +#endif +#else + sendto(DHCP_SOCKET, (uint8_t *)pDHCPMSG, RIP_MSG_SIZE, ip, DHCP_SERVER_PORT); +#endif + +} + +/* SEND DHCP DHCPDECLINE */ +void send_DHCP_DECLINE(void) { + int i; + uint8_t ip[4]; + uint16_t k = 0; + + makeDHCPMSG(); + + k = 4; // because MAGIC_COOKIE already made by makeDHCPMSG() + + *((uint8_t*)(&pDHCPMSG->flags)) = ((DHCP_FLAGSUNICAST & 0xFF00) >> 8); + *((uint8_t*)(&pDHCPMSG->flags) +1) = (DHCP_FLAGSUNICAST & 0x00FF); + + // Option Request Param. + pDHCPMSG->OPT[k++] = dhcpMessageType; + pDHCPMSG->OPT[k++] = 0x01; + pDHCPMSG->OPT[k++] = DHCP_DECLINE; + + pDHCPMSG->OPT[k++] = dhcpClientIdentifier; + pDHCPMSG->OPT[k++] = 0x07; + pDHCPMSG->OPT[k++] = 0x01; + pDHCPMSG->OPT[k++] = DHCP_CHADDR[0]; + pDHCPMSG->OPT[k++] = DHCP_CHADDR[1]; + pDHCPMSG->OPT[k++] = DHCP_CHADDR[2]; + pDHCPMSG->OPT[k++] = DHCP_CHADDR[3]; + pDHCPMSG->OPT[k++] = DHCP_CHADDR[4]; + pDHCPMSG->OPT[k++] = DHCP_CHADDR[5]; + + pDHCPMSG->OPT[k++] = dhcpRequestedIPaddr; + pDHCPMSG->OPT[k++] = 0x04; + pDHCPMSG->OPT[k++] = DHCP_allocated_ip[0]; + pDHCPMSG->OPT[k++] = DHCP_allocated_ip[1]; + pDHCPMSG->OPT[k++] = DHCP_allocated_ip[2]; + pDHCPMSG->OPT[k++] = DHCP_allocated_ip[3]; + + pDHCPMSG->OPT[k++] = dhcpServerIdentifier; + pDHCPMSG->OPT[k++] = 0x04; + pDHCPMSG->OPT[k++] = DHCP_SIP[0]; + pDHCPMSG->OPT[k++] = DHCP_SIP[1]; + pDHCPMSG->OPT[k++] = DHCP_SIP[2]; + pDHCPMSG->OPT[k++] = DHCP_SIP[3]; + + pDHCPMSG->OPT[k++] = endOption; + + for (i = k; i < OPT_SIZE; i++) { + pDHCPMSG->OPT[i] = 0; + } + + //send broadcasting packet + ip[0] = 0xFF; + ip[1] = 0xFF; + ip[2] = 0xFF; + ip[3] = 0xFF; + +#ifdef _DHCP_DEBUG_ + printf("\r\n> Send DHCP_DECLINE\r\n"); +#endif + +#if 1 + // 20231016 taylor//teddy 240122 +#if ((_WIZCHIP_ == 6100) || (_WIZCHIP_ == 6300)) + sendto(DHCP_SOCKET, (uint8_t *)pDHCPMSG, RIP_MSG_SIZE, ip, DHCP_SERVER_PORT, 4); +#else + sendto(DHCP_SOCKET, (uint8_t *)pDHCPMSG, RIP_MSG_SIZE, ip, DHCP_SERVER_PORT); +#endif +#else + sendto(DHCP_SOCKET, (uint8_t *)pDHCPMSG, RIP_MSG_SIZE, ip, DHCP_SERVER_PORT); +#endif +} + +/* PARSE REPLY pDHCPMSG */ +int8_t parseDHCPMSG(void) { + uint8_t svr_addr[6]; + uint16_t svr_port; + uint16_t len; + + uint8_t * p; + uint8_t * e; + uint8_t type = 0; + uint8_t opt_len; +#if 1 + // 20231019 taylor + uint8_t addr_len; +#endif + + if ((len = getSn_RX_RSR(DHCP_SOCKET)) > 0) { +#if 1 + // 20231019 taylor//teddy 240122 +#if ((_WIZCHIP_ == 6100) || (_WIZCHIP_ == 6300)) + len = recvfrom(DHCP_SOCKET, (uint8_t *)pDHCPMSG, len, svr_addr, &svr_port, &addr_len); +#else + len = recvfrom(DHCP_SOCKET, (uint8_t *)pDHCPMSG, len, svr_addr, &svr_port); +#endif +#else + len = recvfrom(DHCP_SOCKET, (uint8_t *)pDHCPMSG, len, svr_addr, &svr_port); +#endif +#ifdef _DHCP_DEBUG_ + printf("DHCP message : %d.%d.%d.%d(%d) %d received. \r\n", svr_addr[0], svr_addr[1], svr_addr[2], svr_addr[3], svr_port, len); +#endif + } else { + return 0; + } + if (svr_port == DHCP_SERVER_PORT) { + // compare mac address + if ((pDHCPMSG->chaddr[0] != DHCP_CHADDR[0]) || (pDHCPMSG->chaddr[1] != DHCP_CHADDR[1]) || + (pDHCPMSG->chaddr[2] != DHCP_CHADDR[2]) || (pDHCPMSG->chaddr[3] != DHCP_CHADDR[3]) || + (pDHCPMSG->chaddr[4] != DHCP_CHADDR[4]) || (pDHCPMSG->chaddr[5] != DHCP_CHADDR[5])) { +#ifdef _DHCP_DEBUG_ + printf("No My DHCP Message. This message is ignored.\r\n"); +#endif + return 0; + } + //compare DHCP server ip address + if ((DHCP_SIP[0] != 0) || (DHCP_SIP[1] != 0) || (DHCP_SIP[2] != 0) || (DHCP_SIP[3] != 0)) { + if (((svr_addr[0] != DHCP_SIP[0]) || (svr_addr[1] != DHCP_SIP[1]) || (svr_addr[2] != DHCP_SIP[2]) || (svr_addr[3] != DHCP_SIP[3])) && + ((svr_addr[0] != DHCP_REAL_SIP[0]) || (svr_addr[1] != DHCP_REAL_SIP[1]) || (svr_addr[2] != DHCP_REAL_SIP[2]) || (svr_addr[3] != DHCP_REAL_SIP[3]))) { +#ifdef _DHCP_DEBUG_ + printf("Another DHCP sever send a response message. This is ignored.\r\n"); +#endif + return 0; + } + } + p = (uint8_t *)(&pDHCPMSG->op); + p = p + 240; // 240 = sizeof(RIP_MSG) + MAGIC_COOKIE size in RIP_MSG.opt - sizeof(RIP_MSG.opt) + e = p + (len - 240); + + while (p < e) { + + switch (*p) { + + case endOption : + p = e; // for break while(p < e) + break; + case padOption : + p++; + break; + case dhcpMessageType : + p++; + p++; + type = *p++; + break; + case subnetMask : + p++; + p++; + DHCP_allocated_sn[0] = *p++; + DHCP_allocated_sn[1] = *p++; + DHCP_allocated_sn[2] = *p++; + DHCP_allocated_sn[3] = *p++; + break; + case routersOnSubnet : + p++; + opt_len = *p++; + DHCP_allocated_gw[0] = *p++; + DHCP_allocated_gw[1] = *p++; + DHCP_allocated_gw[2] = *p++; + DHCP_allocated_gw[3] = *p++; + p = p + (opt_len - 4); + break; + case dns : + p++; + opt_len = *p++; + DHCP_allocated_dns[0] = *p++; + DHCP_allocated_dns[1] = *p++; + DHCP_allocated_dns[2] = *p++; + DHCP_allocated_dns[3] = *p++; + p = p + (opt_len - 4); + break; + case dhcpIPaddrLeaseTime : + p++; + opt_len = *p++; + dhcp_lease_time = *p++; + dhcp_lease_time = (dhcp_lease_time << 8) + *p++; + dhcp_lease_time = (dhcp_lease_time << 8) + *p++; + dhcp_lease_time = (dhcp_lease_time << 8) + *p++; +#ifdef _DHCP_DEBUG_ + dhcp_lease_time = 10; +#endif + break; + case dhcpServerIdentifier : + p++; + opt_len = *p++; + DHCP_SIP[0] = *p++; + DHCP_SIP[1] = *p++; + DHCP_SIP[2] = *p++; + DHCP_SIP[3] = *p++; + DHCP_REAL_SIP[0] = svr_addr[0]; + DHCP_REAL_SIP[1] = svr_addr[1]; + DHCP_REAL_SIP[2] = svr_addr[2]; + DHCP_REAL_SIP[3] = svr_addr[3]; + break; + default : + p++; + opt_len = *p++; + p += opt_len; + break; + } // switch + } // while + } // if + return type; +} + +uint8_t DHCP_run(void) { + uint8_t type; + uint8_t ret; + + if (dhcp_state == STATE_DHCP_STOP) { + return DHCP_STOPPED; + } + + if (getSn_SR(DHCP_SOCKET) != SOCK_UDP) { + socket(DHCP_SOCKET, Sn_MR_UDP, DHCP_CLIENT_PORT, 0x00); + } + + ret = DHCP_RUNNING; + type = parseDHCPMSG(); + + switch (dhcp_state) { + case STATE_DHCP_INIT : + DHCP_allocated_ip[0] = 0; + DHCP_allocated_ip[1] = 0; + DHCP_allocated_ip[2] = 0; + DHCP_allocated_ip[3] = 0; + send_DHCP_DISCOVER(); + dhcp_state = STATE_DHCP_DISCOVER; + break; + case STATE_DHCP_DISCOVER : + if (type == DHCP_OFFER) { +#ifdef _DHCP_DEBUG_ + printf("> Receive DHCP_OFFER\r\n"); +#endif + DHCP_allocated_ip[0] = pDHCPMSG->yiaddr[0]; + DHCP_allocated_ip[1] = pDHCPMSG->yiaddr[1]; + DHCP_allocated_ip[2] = pDHCPMSG->yiaddr[2]; + DHCP_allocated_ip[3] = pDHCPMSG->yiaddr[3]; + + send_DHCP_REQUEST(); + dhcp_state = STATE_DHCP_REQUEST; + } else { + ret = check_DHCP_timeout(); + } + break; + + case STATE_DHCP_REQUEST : + if (type == DHCP_ACK) { + +#ifdef _DHCP_DEBUG_ + printf("> Receive DHCP_ACK\r\n"); +#endif + if (check_DHCP_leasedIP()) { + // Network info assignment from DHCP + dhcp_ip_assign(); + reset_DHCP_timeout(); + + dhcp_state = STATE_DHCP_LEASED; + } else { + // IP address conflict occurred + reset_DHCP_timeout(); + dhcp_ip_conflict(); + dhcp_state = STATE_DHCP_INIT; + } + } else if (type == DHCP_NAK) { + +#ifdef _DHCP_DEBUG_ + printf("> Receive DHCP_NACK\r\n"); +#endif + + reset_DHCP_timeout(); + + dhcp_state = STATE_DHCP_DISCOVER; + } else { + ret = check_DHCP_timeout(); + } + break; + + case STATE_DHCP_LEASED : + ret = DHCP_IP_LEASED; + if ((dhcp_lease_time != INFINITE_LEASETIME) && ((dhcp_lease_time / 2) < dhcp_tick_1s)) { + +#ifdef _DHCP_DEBUG_ + printf("> Maintains the IP address \r\n"); +#endif + + type = 0; + OLD_allocated_ip[0] = DHCP_allocated_ip[0]; + OLD_allocated_ip[1] = DHCP_allocated_ip[1]; + OLD_allocated_ip[2] = DHCP_allocated_ip[2]; + OLD_allocated_ip[3] = DHCP_allocated_ip[3]; + + DHCP_XID++; + + send_DHCP_REQUEST(); + + reset_DHCP_timeout(); + + dhcp_state = STATE_DHCP_REREQUEST; + } + break; + + case STATE_DHCP_REREQUEST : + ret = DHCP_IP_LEASED; + if (type == DHCP_ACK) { + dhcp_retry_count = 0; + if (OLD_allocated_ip[0] != DHCP_allocated_ip[0] || + OLD_allocated_ip[1] != DHCP_allocated_ip[1] || + OLD_allocated_ip[2] != DHCP_allocated_ip[2] || + OLD_allocated_ip[3] != DHCP_allocated_ip[3]) { + ret = DHCP_IP_CHANGED; + dhcp_ip_update(); +#ifdef _DHCP_DEBUG_ + printf(">IP changed.\r\n"); +#endif + + } +#ifdef _DHCP_DEBUG_ + else { + printf(">IP is continued.\r\n"); + } +#endif + reset_DHCP_timeout(); + dhcp_state = STATE_DHCP_LEASED; + } else if (type == DHCP_NAK) { + +#ifdef _DHCP_DEBUG_ + printf("> Receive DHCP_NACK, Failed to maintain ip\r\n"); +#endif + + reset_DHCP_timeout(); + + dhcp_state = STATE_DHCP_DISCOVER; + } else { + ret = check_DHCP_timeout(); + } + break; + default : + break; + } + + return ret; +} + +void DHCP_stop(void) { + close(DHCP_SOCKET); + dhcp_state = STATE_DHCP_STOP; +} + +uint8_t check_DHCP_timeout(void) { + uint8_t ret = DHCP_RUNNING; + + if (dhcp_retry_count < MAX_DHCP_RETRY) { + if (dhcp_tick_next < dhcp_tick_1s) { + + switch (dhcp_state) { + case STATE_DHCP_DISCOVER : + // printf("<> state : STATE_DHCP_DISCOVER\r\n"); + send_DHCP_DISCOVER(); + break; + + case STATE_DHCP_REQUEST : + // printf("<> state : STATE_DHCP_REQUEST\r\n"); + + send_DHCP_REQUEST(); + break; + + case STATE_DHCP_REREQUEST : + // printf("<> state : STATE_DHCP_REREQUEST\r\n"); + + send_DHCP_REQUEST(); + break; + + default : + break; + } + + dhcp_tick_1s = 0; + dhcp_tick_next = dhcp_tick_1s + DHCP_WAIT_TIME; + dhcp_retry_count++; + } + } else { // timeout occurred + + switch (dhcp_state) { + case STATE_DHCP_DISCOVER: + dhcp_state = STATE_DHCP_INIT; + ret = DHCP_FAILED; + break; + case STATE_DHCP_REQUEST: + case STATE_DHCP_REREQUEST: + send_DHCP_DISCOVER(); + dhcp_state = STATE_DHCP_DISCOVER; + break; + default : + break; + } + reset_DHCP_timeout(); + } + return ret; +} + +int8_t check_DHCP_leasedIP(void) { + uint8_t tmp; + int32_t ret; + + //WIZchip RCR value changed for ARP Timeout count control + tmp = getRCR(); + setRCR(0x03); + + // IP conflict detection : ARP request - ARP reply + // Broadcasting ARP Request for check the IP conflict using UDP sendto() function +#if 1 + // 20231016 taylor//teddy 240122 +#if ((_WIZCHIP_ == 6100) || (_WIZCHIP_ == 6300)) + ret = sendto(DHCP_SOCKET, (uint8_t *)"CHECK_IP_CONFLICT", 17, DHCP_allocated_ip, 5000, 4); +#else + ret = sendto(DHCP_SOCKET, (uint8_t *)"CHECK_IP_CONFLICT", 17, DHCP_allocated_ip, 5000); +#endif +#else + ret = sendto(DHCP_SOCKET, (uint8_t *)"CHECK_IP_CONFLICT", 17, DHCP_allocated_ip, 5000); +#endif + + // RCR value restore + setRCR(tmp); + + if (ret == SOCKERR_TIMEOUT) { + // UDP send Timeout occurred : allocated IP address is unique, DHCP Success + +#ifdef _DHCP_DEBUG_ + printf("\r\n> Check leased IP - OK\r\n"); +#endif + + return 1; + } else { + // Received ARP reply or etc : IP address conflict occur, DHCP Failed + send_DHCP_DECLINE(); + + ret = dhcp_tick_1s; + while ((dhcp_tick_1s - ret) < 2) ; // wait for 1s over; wait to complete to send DECLINE message; + + return 0; + } +} + +void DHCP_init(uint8_t s, uint8_t * buf) { + uint8_t zeroip[4] = {0, 0, 0, 0}; + getSHAR(DHCP_CHADDR); + if ((DHCP_CHADDR[0] | DHCP_CHADDR[1] | DHCP_CHADDR[2] | DHCP_CHADDR[3] | DHCP_CHADDR[4] | DHCP_CHADDR[5]) == 0x00) { + // assigning temporary mac address, you should be set SHAR before call this function. + DHCP_CHADDR[0] = 0x00; + DHCP_CHADDR[1] = 0x08; + DHCP_CHADDR[2] = 0xdc; + DHCP_CHADDR[3] = 0x00; + DHCP_CHADDR[4] = 0x00; + DHCP_CHADDR[5] = 0x00; +#if _WIZCHIP_ == W6100 + NETUNLOCK(); + setSHAR(DHCP_CHADDR); + NETLOCK(); +#else + setSHAR(DHCP_CHADDR); +#endif + } + + DHCP_SOCKET = s; // SOCK_DHCP + pDHCPMSG = (RIP_MSG*)buf; + DHCP_XID = 0x12345678; + { + DHCP_XID += DHCP_CHADDR[3]; + DHCP_XID += DHCP_CHADDR[4]; + DHCP_XID += DHCP_CHADDR[5]; + DHCP_XID += (DHCP_CHADDR[3] ^ DHCP_CHADDR[4] ^ DHCP_CHADDR[5]); + } + // WIZchip Netinfo Clear + setSIPR(zeroip); + setGAR(zeroip); + + reset_DHCP_timeout(); + dhcp_state = STATE_DHCP_INIT; +} + + +/* Reset the DHCP timeout count and retry count. */ +void reset_DHCP_timeout(void) { + dhcp_tick_1s = 0; + dhcp_tick_next = DHCP_WAIT_TIME; + dhcp_retry_count = 0; +} + +void DHCP_time_handler(void) { + dhcp_tick_1s++; +} + +void getIPfromDHCP(uint8_t* ip) { + ip[0] = DHCP_allocated_ip[0]; + ip[1] = DHCP_allocated_ip[1]; + ip[2] = DHCP_allocated_ip[2]; + ip[3] = DHCP_allocated_ip[3]; +} + +void getGWfromDHCP(uint8_t* ip) { + ip[0] = DHCP_allocated_gw[0]; + ip[1] = DHCP_allocated_gw[1]; + ip[2] = DHCP_allocated_gw[2]; + ip[3] = DHCP_allocated_gw[3]; +} + +void getSNfromDHCP(uint8_t* ip) { + ip[0] = DHCP_allocated_sn[0]; + ip[1] = DHCP_allocated_sn[1]; + ip[2] = DHCP_allocated_sn[2]; + ip[3] = DHCP_allocated_sn[3]; +} + +void getDNSfromDHCP(uint8_t* ip) { + ip[0] = DHCP_allocated_dns[0]; + ip[1] = DHCP_allocated_dns[1]; + ip[2] = DHCP_allocated_dns[2]; + ip[3] = DHCP_allocated_dns[3]; +} + +uint32_t getDHCPLeasetime(void) { + return dhcp_lease_time; +} + +char NibbleToHex(uint8_t nibble) { + nibble &= 0x0F; + if (nibble <= 9) { + return nibble + '0'; + } else { + return nibble + ('A' - 0x0A); + } +} + + diff --git a/Internet/DHCP/dhcp.h b/Internet/DHCP/dhcp.h new file mode 100644 index 0000000..7d13a32 --- /dev/null +++ b/Internet/DHCP/dhcp.h @@ -0,0 +1,163 @@ +//***************************************************************************** +// +//! \file dhcp.h +//! \brief DHCP APIs Header file. +//! \details Processig DHCP protocol as DISCOVER, OFFER, REQUEST, ACK, NACK and DECLINE. +//! \version 1.1.1 +//! \date 2019/10/08 +//! \par Revision history +//! <2019/10/08> compare DHCP server ip address +//! <2013/11/18> 1st Release +//! <2012/12/20> V1.1.0 +//! 1. Move unreferenced DEFINE to dhcp.c +//! <2012/12/26> V1.1.1 +//! \author Eric Jung & MidnightCow +//! \copyright +//! +//! Copyright (c) 2013, WIZnet Co., 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: +//! +//! * 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 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 _DHCP_H_ +#define _DHCP_H_ + +#ifdef __cplusplus +extern "C" { +#endif + +/* + @brief + @details If you want to display debug & processing message, Define _DHCP_DEBUG_ + @note If defined, it depends on +*/ +#if 0 +// 20231023 taylor +#define _DHCP_DEBUG_ +#endif + + +/* Retry to processing DHCP */ +#define MAX_DHCP_RETRY 2 ///< Maximum retry count +#define DHCP_WAIT_TIME 10 ///< Wait Time 10s + + +/* UDP port numbers for DHCP */ +#define DHCP_SERVER_PORT 67 ///< DHCP server port number +#define DHCP_CLIENT_PORT 68 ///< DHCP client port number + + +#define MAGIC_COOKIE 0x63825363 ///< You should not modify it number. + +#define DCHP_HOST_NAME "WIZnet\0" + +/* + @brief return value of @ref DHCP_run() +*/ +enum { + DHCP_FAILED = 0, ///< Processing Fail + DHCP_RUNNING, ///< Processing DHCP protocol + DHCP_IP_ASSIGN, ///< First Occupy IP from DHPC server (if cbfunc == null, act as default default_ip_assign) + DHCP_IP_CHANGED, ///< Change IP address by new ip from DHCP (if cbfunc == null, act as default default_ip_update) + DHCP_IP_LEASED, ///< Stand by + DHCP_STOPPED ///< Stop processing DHCP protocol +}; + +/* + @brief DHCP client initialization (outside of the main loop) + @param s - socket number + @param buf - buffer for processing DHCP message +*/ +void DHCP_init(uint8_t s, uint8_t * buf); + +/* + @brief DHCP 1s Tick Timer handler + @note SHOULD BE register to your system 1s Tick timer handler +*/ +void DHCP_time_handler(void); + +/* + @brief Register call back function + @param ip_assign - callback func when IP is assigned from DHCP server first + @param ip_update - callback func when IP is changed + @param ip_conflict - callback func when the assigned IP is conflict with others. +*/ +void reg_dhcp_cbfunc(void(*ip_assign)(void), void(*ip_update)(void), void(*ip_conflict)(void)); + +/* + @brief DHCP client in the main loop + @return The value is as the follow \n + @ref DHCP_FAILED \n + @ref DHCP_RUNNING \n + @ref DHCP_IP_ASSIGN \n + @ref DHCP_IP_CHANGED \n + @ref DHCP_IP_LEASED \n + @ref DHCP_STOPPED \n + + @note This function is always called by you main task. +*/ +uint8_t DHCP_run(void); + +/* + @brief Stop DHCP processing + @note If you want to restart. call DHCP_init() and DHCP_run() +*/ +void DHCP_stop(void); + +/* Get Network information assigned from DHCP server */ +/* + @brief Get IP address + @param ip - IP address to be returned +*/ +void getIPfromDHCP(uint8_t* ip); +/* + @brief Get Gateway address + @param ip - Gateway address to be returned +*/ +void getGWfromDHCP(uint8_t* ip); +/* + @brief Get Subnet mask value + @param ip - Subnet mask to be returned +*/ +void getSNfromDHCP(uint8_t* ip); +/* + @brief Get DNS address + @param ip - DNS address to be returned +*/ +void getDNSfromDHCP(uint8_t* ip); + +/* + @brief Get the leased time by DHCP sever + @return unit 1s +*/ +uint32_t getDHCPLeasetime(void); + +#ifdef __cplusplus +} +#endif + +#endif /* _DHCP_H_ */ diff --git a/Internet/DHCP6/dhcpv6.c b/Internet/DHCP6/dhcpv6.c new file mode 100644 index 0000000..a894cc8 --- /dev/null +++ b/Internet/DHCP6/dhcpv6.c @@ -0,0 +1,1219 @@ +//***************************************************************************** +// +//! \file dhcpv6.c +//! \brief DHCPv6 APIs implement file. +//! \details Processig DHCPv6 protocol as SOLICIT, ADVERTISE. +//! \version 0.0.1 +//! \date 2016/06/08 +//! \par Revision history +//! <2016/07/18> 1st Release +//! \author JustinKim +//! \copyright +//! +//! Copyright (c) 2016, WIZnet Co., 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: +//! +//! * 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 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 "dhcpv6.h" +#include +#include +#include + +#if (_WIZCHIP_ == W6100) + +/* If you want to display debug & procssing message, Define _DHCP6_DEBUG_ in dhcpv6.h */ +#define _DHCP6_DEBUG_ +#ifdef _DHCP6_DEBUG_ +#include +#endif + +/* DHCP6 state machine. */ +#define STATE_DHCP6_INIT 0 ///< Initialize +#define STATE_DHCP6_SOLICIT 1 ///< send DISCOVER and wait OFFER +#define STATE_DHCP6_REQUEST 2 ///< send REQEUST and wait ACK or NACK +#define STATE_DHCP6_LEASED 3 ///< ReceiveD ACK and IP leased +#define STATE_DHCP6_REREQUEST 4 ///< send REQUEST for maintaining leased IP +#define STATE_DHCP6_RELEASE 5 ///< No use +#define STATE_DHCP6_STOP 6 ///< Stop procssing DHCPv6 + +/* DHCP6 message type */ +#define DHCP6_SOLICIT 1 ///< DISCOVER message in OPT of @ref RIP_MSG +#define DHCP6_ADVERTISE 2 ///< OFFER message in OPT of @ref RIP_MSG +#define DHCP6_REQUEST 3 ///< REQUEST message in OPT of @ref RIP_MSG +#define DHCP6_CONFIRM 4 ///< DECLINE message in OPT of @ref RIP_MSG +#define DHCP6_RENEW 5 ///< ACK message in OPT of @ref RIP_MSG +#define DHCP6_REBIND 6 ///< NACK message in OPT of @ref RIP_MSG +#define DHCP6_REPLY 7 ///< RELEASE message in OPT of @ref RIP_MSG. No use +#define DHCP6_RELEASE 8 ///< INFORM message in OPT of @ref RIP_MSG. No use +#define DHCP6_DECLINE 9 ///< INFORM message in OPT of @ref RIP_MSG. No use +#define DHCP6_RECONFIGURE 10 ///< INFORM message in OPT of @ref RIP_MSG. No use +#define DHCP6_INFO_REQUEST 11 ///< INFORM message in OPT of @ref RIP_MSG. No use + +uint8_t DNS6_Address[16] = { + 0, +}; +//todo + +/* + @brief DHCPv6 option (cf. RFC3315) +*/ +enum { + OPT_CLIENTID = 1, + OPT_SERVERID = 2, + OPT_IANA = 3, + OPT_IATA = 4, + OPT_IAADDR = 5, + OPT_REQUEST = 6, + OPT_PREFERENCE = 7, + OPT_ELAPSED_TIME = 8, + OPT_RELAY_MSG = 9, + OPT_AUTH = 11, + OPT_UNICAST = 12, + OPT_STATUS_CODE = 13, + OPT_RAPID_COMMIT = 14, + OPT_USER_CLASS = 15, + OPT_VENDOR_CLASS = 16, + OPT_VENDOR_OPTS = 17, + OPT_INTERFACE_ID = 18, + OPT_RECONF_MSG = 19, + OPT_RECONF_ACCEPT = 20, + SIP_Server_DNL = 21, + SIP_Server_V6ADDR = 22, + DNS_RecursiveNameServer = 23, + Domain_Search_List = 24, + OPT_IAPD = 25, + OPT_IAPREFIX = 26, + OPT_NIS_SERVERS = 27, + OPT_NISP_SERVERS = 28, + OPT_NIS_DOMAIN_NAME = 29, + OPT_NISP_DOMAIN_NAME = 30, + OPT_LIFETIME = 32, + FQ_DOMAIN_NAME = 39 +}; + +/* + @brief DHCPv6 message format +*/ +typedef struct { + uint8_t *OPT; ///< Option +} __attribute__((packed)) RIP_MSG; + +uint8_t DHCP6_SOCKET; // Socket number for DHCPv6 + +// Network information from DHCPv6 Server +uint8_t DHCP6_allocated_ip[16] = { + 0, +}; // IP address from DHCPv6 +int8_t dhcp6_state = STATE_DHCP6_INIT; // DHCPv6 state +int8_t dhcp6_retry_count = 0; + +volatile uint32_t dhcp6_tick_1s = 0; // unit 1 second +uint32_t dhcp6_tick_next = DHCP6_WAIT_TIME; + +uint32_t DHCP6_XID; // Any number + +RIP_MSG pDHCP6MSG; // Buffer pointer for DHCPv6 processing + +uint8_t HOST_NAME6[] = DCHP6_HOST_NAME; + +uint8_t DHCP6_CHADDR[6]; // DHCPv6 Client MAC address. + + +uint16_t DUID_type_s; +uint16_t Hardware_type_s; +uint8_t Time_s[4]; +uint32_t Enterprise_num_s; +uint8_t Server_MAC[6]; +uint8_t recv_IP[16]; +uint32_t PreLifeTime; +uint32_t ValidLifeTime; +uint16_t code; +uint8_t IAID[4]; +uint8_t T1[4]; +uint8_t T2[4]; +uint16_t iana_len; +uint16_t iaaddr_len; +uint16_t statuscode_len; +uint16_t Lstatuscode_len; +uint16_t serverid_len; +uint16_t clientid_len; +uint8_t status_msg[] = ""; + +unsigned size; +unsigned num; +unsigned num2 = 0; +unsigned growby; + +/** + @brief + + @param asize + @param agrowby +*/ +void InitDhcp6Option(unsigned asize, unsigned agrowby) { + size = asize; + growby = agrowby; + num = 0; +} + +/** + @brief + + @param value +*/ +void AppendDhcp6Option(uint8_t value) { + uint32_t need; + + need = num + 1; + if (need > size) { + size++; + } + pDHCP6MSG.OPT[num] = value; + num++; +} + +/** + @brief + + @param sMark +*/ +void DumpDhcp6Option(char *sMark) { + unsigned i; + printf("%20s => size=%02d,num=%02d : ", sMark, size, num); + for (i = num2; i < num; i++) { + printf("%.2x ", pDHCP6MSG.OPT[i]); + } + printf("\r\n"); + num2 = num; +} + +/** + @brief + + @param option +*/ +void DHCP6_Option_Select(uint8_t option) { + switch (option) + case OPT_CLIENTID: +case OPT_SERVERID: +case OPT_IANA: +case OPT_IATA: +case OPT_IAADDR: +case OPT_REQUEST: +case OPT_PREFERENCE: +case OPT_ELAPSED_TIME: +case OPT_RELAY_MSG: +case OPT_AUTH: +case OPT_UNICAST: +case OPT_STATUS_CODE: +case OPT_RAPID_COMMIT: +case OPT_USER_CLASS: +case OPT_VENDOR_CLASS: +case OPT_VENDOR_OPTS: +case OPT_INTERFACE_ID: +case OPT_RECONF_MSG: +case OPT_RECONF_ACCEPT: +case SIP_Server_DNL: +case SIP_Server_V6ADDR: +case DNS_RecursiveNameServer: +case Domain_Search_List: +case OPT_IAPD: +case OPT_IAPREFIX: +case OPT_NIS_SERVERS: +case OPT_NISP_SERVERS: +case OPT_NIS_DOMAIN_NAME: +case OPT_NISP_DOMAIN_NAME: +case FQ_DOMAIN_NAME: + break; +} + +/** + @brief + +*/ +void send_DHCP6_SOLICIT(void) { + uint16_t j; + uint8_t ip[16]; + uint8_t rip_msg_size; + + size = 0; + num = 0; + growby = 0; + + InitDhcp6Option(34, 1); + DumpDhcp6Option("option init"); + + AppendDhcp6Option(DHCP6_SOLICIT); + AppendDhcp6Option((uint8_t)((DHCP6_XID & 0x00FF0000) >> 16)); + AppendDhcp6Option((uint8_t)((DHCP6_XID & 0x00FF0000) >> 8)); + AppendDhcp6Option((uint8_t)((DHCP6_XID & 0x00FF0000) >> 0)); + DumpDhcp6Option("Type&XID"); + + // Elapsed time + // AppendDhcp6Option(0x00);AppendDhcp6Option(OPT_ELAPSED_TIME); + // AppendDhcp6Option(0x00);AppendDhcp6Option(0x02); + // AppendDhcp6Option(0x0c);AppendDhcp6Option(0x1c);DumpDhcp6Option("Option Elapsed Time"); + + // Client Identifier + AppendDhcp6Option(0x00); + AppendDhcp6Option(OPT_CLIENTID); + AppendDhcp6Option(0x00); + AppendDhcp6Option(0x0a); //length + AppendDhcp6Option(0x00); + AppendDhcp6Option(0x03); //DUID_Type + AppendDhcp6Option(0x00); + AppendDhcp6Option(0x01); //Hard_Type + + AppendDhcp6Option(DHCP6_CHADDR[0]); + AppendDhcp6Option(DHCP6_CHADDR[1]); // MAC Addr + AppendDhcp6Option(DHCP6_CHADDR[2]); + AppendDhcp6Option(DHCP6_CHADDR[3]); + AppendDhcp6Option(DHCP6_CHADDR[4]); + AppendDhcp6Option(DHCP6_CHADDR[5]); + DumpDhcp6Option("Option Client ID"); + + // Identity Association for Non-temporary Address + AppendDhcp6Option(0x00); + AppendDhcp6Option(OPT_IANA); + AppendDhcp6Option(0x00); + AppendDhcp6Option(0x0c); // length + AppendDhcp6Option(0x03); + AppendDhcp6Option(0x00); // IAID + AppendDhcp6Option(0x08); + AppendDhcp6Option(0xdc); + AppendDhcp6Option(0x00); + AppendDhcp6Option(0x00); // T1 + AppendDhcp6Option(0x00); + AppendDhcp6Option(0x00); + AppendDhcp6Option(0x00); + AppendDhcp6Option(0x00); // T2 + AppendDhcp6Option(0x00); + AppendDhcp6Option(0x00); + DumpDhcp6Option("Option IANA"); + + // Fully Qualified Domain Name + // AppendDhcp6Option(0x00);AppendDhcp6Option(39); + // AppendDhcp6Option(0x00);AppendDhcp6Option(0x06); // length + // AppendDhcp6Option(0x00);AppendDhcp6Option(0x04); + // AppendDhcp6Option(0x44);AppendDhcp6Option(0x45); + // AppendDhcp6Option(0x44);AppendDhcp6Option(0x59);DumpDhcp6Option("Option FQ Domain Name"); + + // Vendor Class + // AppendDhcp6Option(0x00);AppendDhcp6Option(16); + // AppendDhcp6Option(0x00);AppendDhcp6Option(0x0e); // length + // AppendDhcp6Option(0x00);AppendDhcp6Option(0x00); + // AppendDhcp6Option(0x01);AppendDhcp6Option(0x37); + // AppendDhcp6Option(0x00);AppendDhcp6Option(0x08); + // AppendDhcp6Option(0x4d);AppendDhcp6Option(0x53); + // AppendDhcp6Option(0x46);AppendDhcp6Option(0x54); + // AppendDhcp6Option(0x20);AppendDhcp6Option(0x35); + // AppendDhcp6Option(0x2e);AppendDhcp6Option(0x30);DumpDhcp6Option("Option Vendor Class"); + + // Option Request + // AppendDhcp6Option(0x00);AppendDhcp6Option(OPT_REQUEST); + // AppendDhcp6Option(0x00);AppendDhcp6Option(0x08); // length + // AppendDhcp6Option(0x00);AppendDhcp6Option(OPT_VENDOR_OPTS); + // AppendDhcp6Option(0x00);AppendDhcp6Option(DNS_RecursiveNameServer); + // AppendDhcp6Option(0x00);AppendDhcp6Option(Domain_Search_List); + // AppendDhcp6Option(0x00);AppendDhcp6Option(FQ_DOMAIN_NAME);DumpDhcp6Option("Option Request"); + + // send broadcasting packet + ip[0] = 0xff; + ip[1] = 0x02; + + for (j = 2; j < 13; j++) { + ip[j] = 0x00; + } + + ip[13] = 0x01; + ip[14] = 0x00; + ip[15] = 0x02; + + rip_msg_size = size; + +#ifdef _DHCP_DEBUG_ + printf("> Send DHCP_DISCOVER\r\n"); +#endif + + sendto(DHCP6_SOCKET, (uint8_t *)pDHCP6MSG.OPT, rip_msg_size, ip, DHCP6_SERVER_PORT, 16); + +#ifdef _DHCP_DEBUG_ + printf("> %d, %d\r\n", ret, rip_msg_size); +#endif + + //return ret +} + +/** + @brief + + @return uint8_t +*/ +uint8_t send_DHCP6_REQUEST(void) { + //uint16_t i; + uint16_t j; + uint8_t ip[16]; + uint8_t rip_msg_size; + uint8_t ret = 1; + + size = 0; + num = 0; + growby = 0; + + if (iana_len == 0) { + return 9; + } + printf("req : %x%x:%x%x:%x%x:%x%x:%x%x:%x%x:%x%x:%x%x \r\n", recv_IP[0], recv_IP[1], recv_IP[2], recv_IP[3], recv_IP[4], recv_IP[5], recv_IP[6], recv_IP[7], recv_IP[8], recv_IP[9], recv_IP[10], recv_IP[11], recv_IP[12], recv_IP[13], recv_IP[14], recv_IP[15]); + + InitDhcp6Option(60, 1); + DumpDhcp6Option("option init"); + + AppendDhcp6Option(DHCP6_REQUEST); + AppendDhcp6Option((uint8_t)((DHCP6_XID & 0x00FF0000) >> 16)); + AppendDhcp6Option((uint8_t)((DHCP6_XID & 0x0000FF00) >> 8)); + AppendDhcp6Option((uint8_t)((DHCP6_XID & 0x000000FF) >> 0)); + DumpDhcp6Option("Type&XID"); + + // Elapsed time + //AppendDhcp6Option(0x00);AppendDhcp6Option(OPT_ELAPSED_TIME); + //AppendDhcp6Option(0x00);AppendDhcp6Option(0x02); + //AppendDhcp6Option(0x0c);AppendDhcp6Option(0x1c);DumpDhcp6Option("Option Elapsed Time"); + + // Identity Association for Non-temporary Address + AppendDhcp6Option(0x00); + AppendDhcp6Option(OPT_IANA); + AppendDhcp6Option((uint8_t)(iana_len >> 8)); + AppendDhcp6Option((uint8_t)iana_len); // length + AppendDhcp6Option(IAID[0]); + AppendDhcp6Option(IAID[1]); // IAID + AppendDhcp6Option(IAID[2]); + AppendDhcp6Option(IAID[3]); + AppendDhcp6Option(T1[0]); + AppendDhcp6Option(T1[1]); // T1 + AppendDhcp6Option(T1[2]); + AppendDhcp6Option(T1[3]); + AppendDhcp6Option(T2[0]); + AppendDhcp6Option(T2[1]); // T2 + AppendDhcp6Option(T2[2]); + AppendDhcp6Option(T2[3]); + DumpDhcp6Option("Option IANA"); + + // IA Address + AppendDhcp6Option(0x00); + AppendDhcp6Option(OPT_IAADDR); + AppendDhcp6Option((uint8_t)(iaaddr_len >> 8)); + AppendDhcp6Option((uint8_t)iaaddr_len); // length + AppendDhcp6Option(recv_IP[0]); + AppendDhcp6Option(recv_IP[1]); // IP + AppendDhcp6Option(recv_IP[2]); + AppendDhcp6Option(recv_IP[3]); + AppendDhcp6Option(recv_IP[4]); + AppendDhcp6Option(recv_IP[5]); + AppendDhcp6Option(recv_IP[6]); + AppendDhcp6Option(recv_IP[7]); + AppendDhcp6Option(recv_IP[8]); + AppendDhcp6Option(recv_IP[9]); + AppendDhcp6Option(recv_IP[10]); + AppendDhcp6Option(recv_IP[11]); + AppendDhcp6Option(recv_IP[12]); + AppendDhcp6Option(recv_IP[13]); + AppendDhcp6Option(recv_IP[14]); + AppendDhcp6Option(recv_IP[15]); + AppendDhcp6Option((uint8_t)(PreLifeTime >> 24)); + AppendDhcp6Option((uint8_t)(PreLifeTime >> 16)); + AppendDhcp6Option((uint8_t)(PreLifeTime >> 8)); + AppendDhcp6Option((uint8_t)PreLifeTime); + AppendDhcp6Option((uint8_t)(ValidLifeTime >> 24)); + AppendDhcp6Option((uint8_t)(ValidLifeTime >> 16)); + AppendDhcp6Option((uint8_t)(ValidLifeTime >> 8)); + AppendDhcp6Option((uint8_t)ValidLifeTime); + DumpDhcp6Option("Option IA_addr"); + + // Status code +#if 0 + // 20190318 + AppendDhcp6Option(0x00); AppendDhcp6Option(OPT_STATUS_CODE); DumpDhcp6Option("Option status_code type"); + AppendDhcp6Option((uint8_t)(Lstatuscode_len >> 8)); AppendDhcp6Option((uint8_t)Lstatuscode_len); DumpDhcp6Option("Option status_code length"); // length + AppendDhcp6Option((uint8_t)(code >> 8)); AppendDhcp6Option((uint8_t)code); DumpDhcp6Option("Option status_code code"); // code +#endif + // for(i=0; i<(statuscode_len-2); i++) + // AppendDhcp6Option(status_msg[i]); + // DumpDhcp6Option("Option status_code msg"); + +#if 0 + // 20190318 + AppendDhcp6Option(0x41); AppendDhcp6Option(0x73); + AppendDhcp6Option(0x73); AppendDhcp6Option(0x69); + AppendDhcp6Option(0x67); AppendDhcp6Option(0x6e); + AppendDhcp6Option(0x65); AppendDhcp6Option(0x64); + AppendDhcp6Option(0x20); AppendDhcp6Option(0x61); + AppendDhcp6Option(0x6e); AppendDhcp6Option(0x20); + AppendDhcp6Option(0x61); AppendDhcp6Option(0x64); + AppendDhcp6Option(0x64); AppendDhcp6Option(0x72); + AppendDhcp6Option(0x65); AppendDhcp6Option(0x73); + AppendDhcp6Option(0x73); AppendDhcp6Option(0x2e); +#endif + + // Client Identifier + AppendDhcp6Option(0x00); + AppendDhcp6Option(OPT_CLIENTID); + AppendDhcp6Option(0x00); + AppendDhcp6Option(0x0a); //length + AppendDhcp6Option(0x00); + AppendDhcp6Option(0x03); //DUID_Type + AppendDhcp6Option(0x00); + AppendDhcp6Option(0x01); //Hard_Type + + AppendDhcp6Option(DHCP6_CHADDR[0]); + AppendDhcp6Option(DHCP6_CHADDR[1]); // MAC Addr + AppendDhcp6Option(DHCP6_CHADDR[2]); + AppendDhcp6Option(DHCP6_CHADDR[3]); + AppendDhcp6Option(DHCP6_CHADDR[4]); + AppendDhcp6Option(DHCP6_CHADDR[5]); + DumpDhcp6Option("Option Client ID"); + // AppendDhcp6Option(0x00);AppendDhcp6Option(OPT_CLIENTID); + // AppendDhcp6Option((uint8_t)(clientid_len>>8));AppendDhcp6Option((uint8_t)clientid_len); //length + // AppendDhcp6Option((uint8_t)(DUID_type>>8));AppendDhcp6Option((uint8_t)DUID_type); //DUID_Type + // AppendDhcp6Option((uint8_t)(Hardware_type>>8));AppendDhcp6Option((uint8_t)Hardware_type); //Hard_Type + // AppendDhcp6Option(DHCP_CHADDR[0]);AppendDhcp6Option(DHCP_CHADDR[1]); // MAC Addr + // AppendDhcp6Option(DHCP_CHADDR[2]);AppendDhcp6Option(DHCP_CHADDR[3]); + // AppendDhcp6Option(DHCP_CHADDR[4]);AppendDhcp6Option(DHCP_CHADDR[5]);DumpDhcp6Option("Option Client ID"); + + //Server Identifier + AppendDhcp6Option(0x00); + AppendDhcp6Option(OPT_SERVERID); + AppendDhcp6Option((uint8_t)(serverid_len >> 8)); + AppendDhcp6Option((uint8_t)serverid_len); //length + AppendDhcp6Option((uint8_t)(DUID_type_s >> 8)); + AppendDhcp6Option((uint8_t)DUID_type_s); //DUID_Type + AppendDhcp6Option((uint8_t)(Hardware_type_s >> 8)); + AppendDhcp6Option((uint8_t)Hardware_type_s); //Hard_Type +#if 0 + // 20190318 + AppendDhcp6Option(Time_s[0]); AppendDhcp6Option(Time_s[1]); // Time + AppendDhcp6Option(Time_s[2]); AppendDhcp6Option(Time_s[3]); +#endif + AppendDhcp6Option(Server_MAC[0]); + AppendDhcp6Option(Server_MAC[1]); // MAC Addr + AppendDhcp6Option(Server_MAC[2]); + AppendDhcp6Option(Server_MAC[3]); + AppendDhcp6Option(Server_MAC[4]); + AppendDhcp6Option(Server_MAC[5]); + DumpDhcp6Option("Option Server ID"); + + // Fully Qualified Domain Name + // AppendDhcp6Option(0x00);AppendDhcp6Option(39); + // AppendDhcp6Option(0x00);AppendDhcp6Option(0x06); // length + // AppendDhcp6Option(0x00);AppendDhcp6Option(0x04); + // AppendDhcp6Option(0x44);AppendDhcp6Option(0x45); + // AppendDhcp6Option(0x44);AppendDhcp6Option(0x59);DumpDhcp6Option("Option FQ Domain Name"); + + // Vendor Class + // AppendDhcp6Option(0x00);AppendDhcp6Option(16); + // AppendDhcp6Option(0x00);AppendDhcp6Option(0x0e); // length + // AppendDhcp6Option(0x00);AppendDhcp6Option(0x00); + // AppendDhcp6Option(0x01);AppendDhcp6Option(0x37); + // AppendDhcp6Option(0x00);AppendDhcp6Option(0x08); + // AppendDhcp6Option(0x4d);AppendDhcp6Option(0x53); + // AppendDhcp6Option(0x46);AppendDhcp6Option(0x54); + // AppendDhcp6Option(0x20);AppendDhcp6Option(0x35); + // AppendDhcp6Option(0x2e);AppendDhcp6Option(0x30);DumpDhcp6Option("Option Vendor Class"); + + // Option Request + // AppendDhcp6Option(0x00);AppendDhcp6Option(OPT_REQUEST); + // AppendDhcp6Option(0x00);AppendDhcp6Option(0x08); // length + // AppendDhcp6Option(0x00);AppendDhcp6Option(OPT_VENDOR_OPTS); + // AppendDhcp6Option(0x00);AppendDhcp6Option(DNS_RecursiveNameServer); + // AppendDhcp6Option(0x00);AppendDhcp6Option(Domain_Search_List); + // AppendDhcp6Option(0x00);AppendDhcp6Option(FQ_DOMAIN_NAME);DumpDhcp6Option("Option Request"); + + // send broadcasting packet + ip[0] = 0xff; + ip[1] = 0x02; + + for (j = 2; j < 13; j++) { + ip[j] = 0x00; + } + + ip[13] = 0x01; + ip[14] = 0x00; + ip[15] = 0x02; + + rip_msg_size = size; + +#ifdef _DHCP_DEBUG_ + printf("> Send DHCP_REQUEST\r\n"); +#endif + + sendto(DHCP6_SOCKET, (uint8_t *)pDHCP6MSG.OPT, rip_msg_size, ip, DHCP6_SERVER_PORT, 16); +#ifdef _DHCP_DEBUG_ + printf("> %d, %d\r\n", ret, rip_msg_size); +#endif + + return ret; +} + +/** + @brief + + @return uint8_t +*/ +uint8_t send_DHCP_INFOREQ(void) { + //uint16_t i; + uint16_t j; + uint8_t ip[16]; + uint8_t rip_msg_size; + uint8_t ret = 0; + + size = 0; + num = 0; + growby = 0; + + //printf("req : %x%x:%x%x:%x%x:%x%x:%x%x:%x%x:%x%x:%x%x \r\n",recv_IP[0],recv_IP[1],recv_IP[2],recv_IP[3],recv_IP[4],recv_IP[5],recv_IP[6],recv_IP[7],recv_IP[8],recv_IP[9],recv_IP[10],recv_IP[11],recv_IP[12],recv_IP[13],recv_IP[14],recv_IP[15]); + InitDhcp6Option(30, 1); + DumpDhcp6Option("option init"); + + AppendDhcp6Option(DHCP6_INFO_REQUEST); + AppendDhcp6Option((uint8_t)((DHCP6_XID & 0x00FF0000) >> 16)); + AppendDhcp6Option((uint8_t)((DHCP6_XID & 0x0000FF00) >> 8)); + AppendDhcp6Option((uint8_t)((DHCP6_XID & 0x000000FF) >> 0)); + DumpDhcp6Option("Type&XID"); + + // // Elapsed time + // AppendDhcp6Option(0x00);AppendDhcp6Option(OPT_ELAPSED_TIME); + // AppendDhcp6Option(0x00);AppendDhcp6Option(0x02); + // AppendDhcp6Option(0x0c);AppendDhcp6Option(0x1c);DumpDhcp6Option("Option Elapsed Time"); + + // Client Identifier + AppendDhcp6Option(0x00); + AppendDhcp6Option(OPT_CLIENTID); + AppendDhcp6Option(0x00); + AppendDhcp6Option(0x0a); //length + AppendDhcp6Option(0x00); + AppendDhcp6Option(0x03); //DUID_Type + AppendDhcp6Option(0x00); + AppendDhcp6Option(0x01); //Hard_Type + + AppendDhcp6Option(DHCP6_CHADDR[0]); + AppendDhcp6Option(DHCP6_CHADDR[1]); // MAC Addr + AppendDhcp6Option(DHCP6_CHADDR[2]); + AppendDhcp6Option(DHCP6_CHADDR[3]); + AppendDhcp6Option(DHCP6_CHADDR[4]); + AppendDhcp6Option(DHCP6_CHADDR[5]); + DumpDhcp6Option("Option Client ID"); + + // Option Request + AppendDhcp6Option(0x00); + AppendDhcp6Option(OPT_REQUEST); + AppendDhcp6Option(0x00); + AppendDhcp6Option(0x06); // length + //AppendDhcp6Option(0x00);AppendDhcp6Option(OPT_VENDOR_OPTS); + AppendDhcp6Option(0x00); + AppendDhcp6Option(DNS_RecursiveNameServer); + AppendDhcp6Option(0x00); + AppendDhcp6Option(Domain_Search_List); + AppendDhcp6Option(0x00); + AppendDhcp6Option(OPT_LIFETIME); + DumpDhcp6Option("Option Request"); + + // send broadcasting packet + ip[0] = 0xff; + ip[1] = 0x02; + + for (j = 2; j < 13; j++) { + ip[j] = 0x00; + } + + ip[13] = 0x01; + ip[14] = 0x00; + ip[15] = 0x02; + + rip_msg_size = size; + +#ifdef _DHCP_DEBUG_ + printf("> Send DHCP_REQUEST\r\n"); +#endif + + sendto(DHCP6_SOCKET, (uint8_t *)pDHCP6MSG.OPT, rip_msg_size, ip, DHCP6_SERVER_PORT, 16); + +#ifdef _DHCP_DEBUG_ + printf("> %d, %d\r\n", ret, rip_msg_size); +#endif + + return ret; +} + +/** + @brief + + @return int8_t +*/ +int8_t parseDHCP6MSG(void) { + uint8_t svr_addr[16]; + uint16_t svr_port; + uint8_t addlen; + uint16_t len; + uint8_t *p; + uint8_t *e; + uint8_t type, i; + uint16_t opt_len; + uint32_t end_point; + + if ((len = getSn_RX_RSR(DHCP6_SOCKET)) > 0) { + len = recvfrom(DHCP6_SOCKET, (uint8_t *)pDHCP6MSG.OPT, len, svr_addr, (uint16_t *)&svr_port, &addlen); +#ifdef _DHCP6_DEBUG_ + printf("DHCP message : %.2x%.2x:%.2x%.2x:%.2x%.2x:%.2x%.2x:%.2x%.2x:%.2x%.2x:%.2x%.2x:%.2x%.2x(%d) %d received. \r\n", svr_addr[0], svr_addr[1], svr_addr[2], svr_addr[3], svr_addr[4], svr_addr[5], svr_addr[6], svr_addr[7], svr_addr[8], svr_addr[9], svr_addr[10], svr_addr[11], svr_addr[12], svr_addr[13], svr_addr[14], svr_addr[15], svr_port, len); +#endif + } else { + return 0; + } + + type = 0; + p = (uint8_t *)(pDHCP6MSG.OPT); + e = p + len; +#ifdef _DHCP6_DEBUG_ + printf("in server port %x\r\n", *p); +#endif + i = 0; + /* + while(p Receive DHCP_ADVERTISE\r\n"); +#endif + + DHCP6_allocated_ip[0] = recv_IP[0]; + DHCP6_allocated_ip[1] = recv_IP[1]; + DHCP6_allocated_ip[2] = recv_IP[2]; + DHCP6_allocated_ip[3] = recv_IP[3]; + DHCP6_allocated_ip[4] = recv_IP[4]; + DHCP6_allocated_ip[5] = recv_IP[5]; + DHCP6_allocated_ip[6] = recv_IP[6]; + DHCP6_allocated_ip[7] = recv_IP[7]; + DHCP6_allocated_ip[8] = recv_IP[8]; + DHCP6_allocated_ip[9] = recv_IP[9]; + DHCP6_allocated_ip[10] = recv_IP[10]; + DHCP6_allocated_ip[11] = recv_IP[11]; + DHCP6_allocated_ip[12] = recv_IP[12]; + DHCP6_allocated_ip[13] = recv_IP[13]; + DHCP6_allocated_ip[14] = recv_IP[14]; + DHCP6_allocated_ip[15] = recv_IP[15]; + + ret = send_DHCP_REQUEST(); + if (ret == 9) { + return 0; + } + dhcp6_state = STATE_DHCP6_REQUEST; + } //else ret = check_DHCP_timeout(); + break; + case STATE_DHCP6_REQUEST: + // 20190318 + //NETUNLOCK(); + + memcpy(netinfo->gua, recv_IP, 16); + + //NETLOCK(); + return DHCP6_IP_LEASED; + default: + break; + } + return ret; +} + +/** + @brief + +*/ +void DHCP6_stop(void) { + close(DHCP6_SOCKET); + dhcp6_state = STATE_DHCP6_STOP; +} + +/** + @brief + + @return uint8_t +*/ +uint8_t check_DHCP6_timeout(void) { + uint8_t ret = DHCP6_RUNNING; + + if (dhcp6_retry_count < MAX_DHCP6_RETRY) { + if (dhcp6_tick_next < dhcp6_tick_1s) { + switch (dhcp6_state) { + case STATE_DHCP6_SOLICIT: { +#ifdef _DHCP6_DEBUG_ + printf("<> state : STATE_DHCP_DISCOVER\r\n"); +#endif + send_DHCP6_SOLICIT(); + break; + } + default: { + break; + } + } + + dhcp6_tick_1s = 0; + dhcp6_tick_next = dhcp6_tick_1s + DHCP6_WAIT_TIME; + dhcp6_retry_count++; + } + } else { + // timeout occurred + + switch (dhcp6_state) { + case STATE_DHCP6_SOLICIT: + dhcp6_state = STATE_DHCP6_INIT; + ret = DHCP6_FAILED; + break; + default: + break; + } + reset_DHCP6_timeout(); + } + return ret; +} + +/** + @brief + + @param s + @param buf +*/ +void DHCP6_init(uint8_t s, uint8_t *buf) { + uint8_t zeroip[16] = {0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0}; + getSHAR(DHCP6_CHADDR); + if ((DHCP6_CHADDR[0] | DHCP6_CHADDR[1] | DHCP6_CHADDR[2] | DHCP6_CHADDR[3] | DHCP6_CHADDR[4] | DHCP6_CHADDR[5]) == 0x00) { +#ifdef _DHCP6_DEBUG_ + printf("DHCP_init-set MAC\r\n"); +#endif + // assing temporary mac address, you should be set SHAR before call this function. + DHCP6_CHADDR[0] = 0x00; + DHCP6_CHADDR[1] = 0x08; + DHCP6_CHADDR[2] = 0xdc; + DHCP6_CHADDR[3] = 0x00; + DHCP6_CHADDR[4] = 0x00; + DHCP6_CHADDR[5] = 0x00; + setSHAR(DHCP6_CHADDR); + } + + DHCP6_SOCKET = s; // SOCK_DHCP + + memset(buf, 0, sizeof(buf)); + pDHCP6MSG.OPT = buf; + DHCP6_XID = 0x515789; + + reset_DHCP_timeout(); + dhcp6_state = STATE_DHCP6_INIT; +} + +/** + @brief + +*/ +void reset_DHCP6_timeout(void) { + dhcp6_tick_1s = 0; + dhcp6_tick_next = DHCP6_WAIT_TIME; + dhcp6_retry_count = 0; +} + +/** + @brief + +*/ +void DHCP6_time_handler(void) { + dhcp6_tick_1s++; +} + +#endif diff --git a/Internet/DHCP6/dhcpv6.h b/Internet/DHCP6/dhcpv6.h new file mode 100644 index 0000000..b2ff927 --- /dev/null +++ b/Internet/DHCP6/dhcpv6.h @@ -0,0 +1,162 @@ +//***************************************************************************** +// +//! \file dhcpv6.h +//! \brief DHCPv6 APIs Header file. +//! \details Processig DHCPv6 protocol as SOLICIT, ADVERTISE. +//! \version 0.0.1 +//! \date 2016/06/08 +//! \par Revision history +//! <2016/07/18> 1st Release +//! \author JustinKim +//! \copyright +//! +//! Copyright (c) 2016, WIZnet Co., 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: +//! +//! * 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 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 _DHCP6_H_ +#define _DHCP6_H_ + +#include +#if 1 +// 20231020 taylor +#if 0 +#include "W6100.h" +#endif +#else +#include "W6100.h" +#endif +#include "socket.h" + +#if (_WIZCHIP_ == W6100) + +/* + @brief + @details If you want to display debug & procssing message, Define _DHCP_DEBUG_ + @note If defined, it dependens on +*/ +#if 0 +#define _DHCP6_DEBUG_ +#endif + +/* Retry to processing DHCPv6 */ +#define MAX_DHCP6_RETRY 2 ///< Maxium retry count +#define DHCP6_WAIT_TIME 10 ///< Wait Time 10s + +/* UDP port numbers for DHCPv6 */ +#define DHCP6_SERVER_PORT 547 ///< DHCP6 server port number +#define DHCP6_CLIENT_PORT 546 ///< DHCP6 client port number + +#define DCHP6_HOST_NAME "WIZnet\0" + +/* + @brief return value of @ref DHCP6_run() +*/ +enum { + DHCP6_FAILED = 0, ///< Procssing Fail + DHCP6_RUNNING, ///< Procssing DHCPv6 proctocol + DHCP6_IP_ASSIGN, ///< First Occupy IP from DHCPv6 server (if cbfunc == null, act as default default_ip_assign) + DHCP6_IP_CHANGED, ///< Change IP address by new ip from DHCPv6 (if cbfunc == null, act as default default_ip_update) + DHCP6_IP_LEASED, ///< Stand by + DHCP6_STOPPED ///< Stop procssing DHCPv6 protocol +}; + +/** + @brief + + @param asize + @param agrowby +*/ +void InitDhcp6Option(unsigned asize, unsigned agrowby); +/** + @brief + + @param value +*/ +void AppendDhcp6Option(uint8_t value); +/** + @brief + + @param sMark +*/ +void DumpDhcp6Option(char *sMark); +/** + @brief + + @param Option +*/ +void DHCP6_Option_Select(uint8_t Option); +/* + @brief DHCPv6 client initialization (outside of the main loop) + @param s - socket number + @param buf - buffer for procssing DHCPv6 message +*/ +void DHCP6_init(uint8_t s, uint8_t *buf); + +/* + @brief DHCPv6 1s Tick Timer handler + @note SHOULD BE register to your system 1s Tick timer handler +*/ +void DHCP6_time_handler(void); + +/** + @brief + + @param netinfo + @return uint8_t +*/ +uint8_t DHCP6_run(wiz_NetInfo *netinfo); + +/** + @brief + + @return uint8_t +*/ +uint8_t DHCP6_run2(void); + +/* + @brief Stop DHCPv6 procssing + @note If you want to restart. call DHCP6_init() and DHCP_run() +*/ +void DHCP6_stop(void); + +/* send DISCOVER message to DHCPv6 server */ +void send_DHCP6_SOLICIT(void); +uint8_t send_DHCP6_REQUEST(void); + +/* check the timeout in DHCPv6 process */ +uint8_t check_DHCP6_timeout(void); + +/* Intialize to timeout process. */ +void reset_DHCP6_timeout(void); + +int8_t parseDHCP6MSG(void); +uint8_t DHCP6_run2(void); + +#endif +#endif /* _DHCP6_H_ */ diff --git a/Internet/DNS/dns.c b/Internet/DNS/dns.c new file mode 100644 index 0000000..e4e1969 --- /dev/null +++ b/Internet/DNS/dns.c @@ -0,0 +1,615 @@ +//***************************************************************************** +// +//! \file dns.c +//! \brief DNS APIs Implement file. +//! \details Send DNS query & Receive DNS reponse. \n +//! It depends on stdlib.h & string.h in ansi-c library +//! \version 1.1.0 +//! \date 2013/11/18 +//! \par Revision history +//! <2013/10/21> 1st Release +//! <2013/12/20> V1.1.0 +//! 1. Remove secondary DNS server in DNS_run +//! If 1st DNS_run failed, call DNS_run with 2nd DNS again +//! 2. DNS_timerHandler -> DNS_time_handler +//! 3. Remove the unused define +//! 4. Integrated dns.h dns.c & dns_parse.h dns_parse.c into dns.h & dns.c +//! <2013/12/20> V1.1.0 +//! +//! \author Eric Jung & MidnightCow +//! \copyright +//! +//! Copyright (c) 2013, WIZnet Co., 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: +//! +//! * 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 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 "socket.h" +#include "dns.h" + +#ifdef _DNS_DEBUG_ +#include +#endif + +#define INITRTT 2000L /* Initial smoothed response time */ +#define MAXCNAME (MAX_DOMAIN_NAME + (MAX_DOMAIN_NAME>>1)) /* Maximum amount of cname recursion */ + +#define TYPE_A 1 /* Host address */ +#define TYPE_NS 2 /* Name server */ +#define TYPE_MD 3 /* Mail destination (obsolete) */ +#define TYPE_MF 4 /* Mail forwarder (obsolete) */ +#define TYPE_CNAME 5 /* Canonical name */ +#define TYPE_SOA 6 /* Start of Authority */ +#define TYPE_MB 7 /* Mailbox name (experimental) */ +#define TYPE_MG 8 /* Mail group member (experimental) */ +#define TYPE_MR 9 /* Mail rename name (experimental) */ +#define TYPE_NULL 10 /* Null (experimental) */ +#define TYPE_WKS 11 /* Well-known sockets */ +#define TYPE_PTR 12 /* Pointer record */ +#define TYPE_HINFO 13 /* Host information */ +#define TYPE_MINFO 14 /* Mailbox information (experimental)*/ +#define TYPE_MX 15 /* Mail exchanger */ +#define TYPE_TXT 16 /* Text strings */ +#define TYPE_ANY 255 /* Matches any type */ + +#define CLASS_IN 1 /* The ARPA Internet */ + +/* Round trip timing parameters */ +#define AGAIN 8 /* Average RTT gain = 1/8 */ +#define LAGAIN 3 /* Log2(AGAIN) */ +#define DGAIN 4 /* Mean deviation gain = 1/4 */ +#define LDGAIN 2 /* log2(DGAIN) */ + +/* Header for all domain messages */ +struct dhdr { + uint16_t id; /* Identification */ + uint8_t qr; /* Query/Response */ +#define QUERY 0 +#define RESPONSE 1 + uint8_t opcode; +#define IQUERY 1 + uint8_t aa; /* Authoratative answer */ + uint8_t tc; /* Truncation */ + uint8_t rd; /* Recursion desired */ + uint8_t ra; /* Recursion available */ + uint8_t rcode; /* Response code */ +#define NO_ERROR 0 +#define FORMAT_ERROR 1 +#define SERVER_FAIL 2 +#define NAME_ERROR 3 +#define NOT_IMPL 4 +#define REFUSED 5 + uint16_t qdcount; /* Question count */ + uint16_t ancount; /* Answer count */ + uint16_t nscount; /* Authority (name server) count */ + uint16_t arcount; /* Additional record count */ +}; + + +uint8_t* pDNSMSG; // DNS message buffer +uint8_t DNS_SOCKET; // SOCKET number for DNS +uint16_t DNS_MSGID; // DNS message ID + +uint32_t dns_1s_tick; // for timout of DNS processing +static uint8_t retry_count; + +/* converts uint16_t from network buffer to a host byte order integer. */ +uint16_t get16(uint8_t * s) { + uint16_t i; + i = *s++ << 8; + i = i + *s; + return i; +} + +/* copies uint16_t to the network buffer with network byte order. */ +uint8_t * put16(uint8_t * s, uint16_t i) { + *s++ = i >> 8; + *s++ = i; + return s; +} + + +/* + CONVERT A DOMAIN NAME TO THE HUMAN-READABLE FORM + + Description : This function converts a compressed domain name to the human-readable form + Arguments : msg - is a pointer to the reply message + compressed - is a pointer to the domain name in reply message. + buf - is a pointer to the buffer for the human-readable form name. + len - is the MAX. size of buffer. + Returns : the length of compressed message +*/ +int parse_name(uint8_t * msg, uint8_t * compressed, char * buf, int16_t len) { + uint16_t slen; /* Length of current segment */ + uint8_t * cp; + int clen = 0; /* Total length of compressed name */ + int indirect = 0; /* Set if indirection encountered */ + int nseg = 0; /* Total number of segments in name */ + + cp = compressed; + + for (;;) { + slen = *cp++; /* Length of this segment */ + + if (!indirect) { + clen++; + } + + if ((slen & 0xc0) == 0xc0) { + if (!indirect) { + clen++; + } + indirect = 1; + /* Follow indirection */ + cp = &msg[((slen & 0x3f) << 8) + *cp]; + slen = *cp++; + } + + if (slen == 0) { /* zero length == all done */ + break; + } + + len -= slen + 1; + + if (len < 0) { + return -1; + } + + if (!indirect) { + clen += slen; + } + + while (slen-- != 0) { + *buf++ = (char) * cp++; + } + *buf++ = '.'; + nseg++; + } + + if (nseg == 0) { + /* Root name; represent as single dot */ + *buf++ = '.'; + len--; + } + + *buf++ = '\0'; + len--; + + return clen; /* Length of compressed message */ +} + +/* + PARSE QUESTION SECTION + + Description : This function parses the qeustion record of the reply message. + Arguments : msg - is a pointer to the reply message + cp - is a pointer to the qeustion record. + Returns : a pointer the to next record. +*/ +uint8_t * dns_question(uint8_t * msg, uint8_t * cp) { + int len; + char name[MAXCNAME]; + + len = parse_name(msg, cp, name, MAXCNAME); + + + if (len == -1) { + return 0; + } + + cp += len; + cp += 2; /* type */ + cp += 2; /* class */ + + return cp; +} + + +/* + PARSE ANSER SECTION + + Description : This function parses the answer record of the reply message. + Arguments : msg - is a pointer to the reply message + cp - is a pointer to the answer record. + Returns : a pointer the to next record. +*/ +uint8_t * dns_answer(uint8_t * msg, uint8_t * cp, uint8_t * ip_from_dns) { + int len, type; + char name[MAXCNAME]; + + len = parse_name(msg, cp, name, MAXCNAME); + + if (len == -1) { + return 0; + } + + cp += len; + type = get16(cp); + cp += 2; /* type */ + cp += 2; /* class */ + cp += 4; /* ttl */ + cp += 2; /* len */ + + + switch (type) { + case TYPE_A: + /* Just read the address directly into the structure */ + ip_from_dns[0] = *cp++; + ip_from_dns[1] = *cp++; + ip_from_dns[2] = *cp++; + ip_from_dns[3] = *cp++; + break; + case TYPE_CNAME: + case TYPE_MB: + case TYPE_MG: + case TYPE_MR: + case TYPE_NS: + case TYPE_PTR: + /* These types all consist of a single domain name */ + /* convert it to ascii format */ + len = parse_name(msg, cp, name, MAXCNAME); + if (len == -1) { + return 0; + } + + cp += len; + break; + case TYPE_HINFO: + len = *cp++; + cp += len; + + len = *cp++; + cp += len; + break; + case TYPE_MX: + cp += 2; + /* Get domain name of exchanger */ + len = parse_name(msg, cp, name, MAXCNAME); + if (len == -1) { + return 0; + } + + cp += len; + break; + case TYPE_SOA: + /* Get domain name of name server */ + len = parse_name(msg, cp, name, MAXCNAME); + if (len == -1) { + return 0; + } + + cp += len; + + /* Get domain name of responsible person */ + len = parse_name(msg, cp, name, MAXCNAME); + if (len == -1) { + return 0; + } + + cp += len; + + cp += 4; + cp += 4; + cp += 4; + cp += 4; + cp += 4; + break; + case TYPE_TXT: + /* Just stash */ + break; + default: + /* Ignore */ + break; + } + + return cp; +} + +/* + PARSE THE DNS REPLY + + Description : This function parses the reply message from DNS server. + Arguments : dhdr - is a pointer to the header for DNS message + buf - is a pointer to the reply message. + len - is the size of reply message. + Returns : -1 - Domain name lenght is too big + 0 - Fail (Timout or parse error) + 1 - Success, +*/ +int8_t parseDNSMSG(struct dhdr * pdhdr, uint8_t * pbuf, uint8_t * ip_from_dns) { + uint16_t tmp; + uint16_t i; + uint8_t * msg; + uint8_t * cp; + + msg = pbuf; + memset(pdhdr, 0, sizeof(*pdhdr)); + + pdhdr->id = get16(&msg[0]); + tmp = get16(&msg[2]); + if (tmp & 0x8000) { + pdhdr->qr = 1; + } + + pdhdr->opcode = (tmp >> 11) & 0xf; + + if (tmp & 0x0400) { + pdhdr->aa = 1; + } + if (tmp & 0x0200) { + pdhdr->tc = 1; + } + if (tmp & 0x0100) { + pdhdr->rd = 1; + } + if (tmp & 0x0080) { + pdhdr->ra = 1; + } + + pdhdr->rcode = tmp & 0xf; + pdhdr->qdcount = get16(&msg[4]); + pdhdr->ancount = get16(&msg[6]); + pdhdr->nscount = get16(&msg[8]); + pdhdr->arcount = get16(&msg[10]); + + + /* Now parse the variable length sections */ + cp = &msg[12]; + + /* Question section */ + for (i = 0; i < pdhdr->qdcount; i++) { + cp = dns_question(msg, cp); +#ifdef _DNS_DEUBG_ + printf("MAX_DOMAIN_NAME is too small, it should be redfine in dns.h"); +#endif + if (!cp) { + return -1; + } + } + + /* Answer section */ + for (i = 0; i < pdhdr->ancount; i++) { + cp = dns_answer(msg, cp, ip_from_dns); +#ifdef _DNS_DEUBG_ + printf("MAX_DOMAIN_NAME is too small, it should be redfine in dns.h"); +#endif + if (!cp) { + return -1; + } + } + + /* Name server (authority) section */ + for (i = 0; i < pdhdr->nscount; i++) { + ; + } + + /* Additional section */ + for (i = 0; i < pdhdr->arcount; i++) { + ; + } + + if (pdhdr->rcode == 0) { + return 1; // No error + } else { + return 0; + } +} + + +/* + MAKE DNS QUERY MESSAGE + + Description : This function makes DNS query message. + Arguments : op - Recursion desired + name - is a pointer to the domain name. + buf - is a pointer to the buffer for DNS message. + len - is the MAX. size of buffer. + Returns : the pointer to the DNS message. +*/ +int16_t dns_makequery(uint16_t op, char * name, uint8_t * buf, uint16_t len) { + uint8_t *cp; + char *cp1; + char sname[MAXCNAME]; + char *dname; + uint16_t p; + uint16_t dlen; + + cp = buf; + + DNS_MSGID++; + cp = put16(cp, DNS_MSGID); + p = (op << 11) | 0x0100; /* Recursion desired */ + cp = put16(cp, p); + cp = put16(cp, 1); + cp = put16(cp, 0); + cp = put16(cp, 0); + cp = put16(cp, 0); + + strcpy(sname, name); + dname = sname; + dlen = strlen(dname); + for (;;) { + /* Look for next dot */ + cp1 = strchr(dname, '.'); + + if (cp1 != NULL) { + len = cp1 - dname; /* More to come */ + } else { + len = dlen; /* Last component */ + } + + *cp++ = len; /* Write length of component */ + if (len == 0) { + break; + } + + /* Copy component up to (but not including) dot */ + strncpy((char *)cp, dname, len); + cp += len; + if (cp1 == NULL) { + *cp++ = 0; /* Last one; write null and finish */ + break; + } + dname += len + 1; + dlen -= len + 1; + } + + cp = put16(cp, 0x0001); /* type */ + cp = put16(cp, 0x0001); /* class */ + + return ((int16_t)((uint32_t)(cp) - (uint32_t)(buf))); +} + +/* + CHECK DNS TIMEOUT + + Description : This function check the DNS timeout + Arguments : None. + Returns : -1 - timeout occurred, 0 - timer over, but no timeout, 1 - no timer over, no timeout occur + Note : timeout : retry count and timer both over. +*/ + +int8_t check_DNS_timeout(void) { + + if (dns_1s_tick >= DNS_WAIT_TIME) { + dns_1s_tick = 0; + if (retry_count >= MAX_DNS_RETRY) { + retry_count = 0; + return -1; // timeout occurred + } + retry_count++; + return 0; // timer over, but no timeout + } + + return 1; // no timer over, no timeout occur +} + + + +/* DNS CLIENT INIT */ +void DNS_init(uint8_t s, uint8_t * buf) { + DNS_SOCKET = s; // SOCK_DNS + pDNSMSG = buf; // User's shared buffer + DNS_MSGID = DNS_MSG_ID; +} + +/* DNS CLIENT RUN */ +int8_t DNS_run(uint8_t * dns_ip, uint8_t * name, uint8_t * ip_from_dns) { + int8_t ret; + struct dhdr dhp; + uint8_t ip[4]; + uint16_t len, port; + int8_t ret_check_timeout; + + retry_count = 0; + dns_1s_tick = 0; +#if 1 + // 20231019 taylor + uint8_t addr_len; +#endif + + // Socket open + socket(DNS_SOCKET, Sn_MR_UDP, 0, 0); + +#ifdef _DNS_DEBUG_ + printf("> DNS Query to DNS Server : %d.%d.%d.%d\r\n", dns_ip[0], dns_ip[1], dns_ip[2], dns_ip[3]); +#endif + + len = dns_makequery(0, (char *)name, pDNSMSG, MAX_DNS_BUF_SIZE); +#if 1 + // 20231016 taylor//teddy 240122 +#if ((_WIZCHIP_ == 6100) || (_WIZCHIP_ == 6300)) + sendto(DNS_SOCKET, pDNSMSG, len, dns_ip, IPPORT_DOMAIN, 4); +#else + sendto(DNS_SOCKET, pDNSMSG, len, dns_ip, IPPORT_DOMAIN); +#endif +#else + sendto(DNS_SOCKET, pDNSMSG, len, dns_ip, IPPORT_DOMAIN); +#endif + + while (1) { + if ((len = getSn_RX_RSR(DNS_SOCKET)) > 0) { + if (len > MAX_DNS_BUF_SIZE) { + len = MAX_DNS_BUF_SIZE; + } +#if 1 + // 20231019 taylor//teddy 240122 +#if ((_WIZCHIP_ == 6100) || (_WIZCHIP_ == 6300)) + len = recvfrom(DNS_SOCKET, pDNSMSG, len, ip, &port, &addr_len); +#else + len = recvfrom(DNS_SOCKET, pDNSMSG, len, ip, &port); +#endif +#else + len = recvfrom(DNS_SOCKET, pDNSMSG, len, ip, &port); +#endif +#ifdef _DNS_DEBUG_ + printf("> Receive DNS message from %d.%d.%d.%d(%d). len = %d\r\n", ip[0], ip[1], ip[2], ip[3], port, len); +#endif + ret = parseDNSMSG(&dhp, pDNSMSG, ip_from_dns); + break; + } + // Check Timeout + ret_check_timeout = check_DNS_timeout(); + if (ret_check_timeout < 0) { + +#ifdef _DNS_DEBUG_ + printf("> DNS Server is not responding : %d.%d.%d.%d\r\n", dns_ip[0], dns_ip[1], dns_ip[2], dns_ip[3]); +#endif + close(DNS_SOCKET); + return 0; // timeout occurred + } else if (ret_check_timeout == 0) { + +#ifdef _DNS_DEBUG_ + printf("> DNS Timeout\r\n"); +#endif +#if 1 + // 20231016 taylor//teddy 240122 +#if ((_WIZCHIP_ == 6100) || (_WIZCHIP_ == 6300)) + sendto(DNS_SOCKET, pDNSMSG, len, dns_ip, IPPORT_DOMAIN, 4); +#else + sendto(DNS_SOCKET, pDNSMSG, len, dns_ip, IPPORT_DOMAIN); +#endif +#else + sendto(DNS_SOCKET, pDNSMSG, len, dns_ip, IPPORT_DOMAIN); +#endif + } + } + close(DNS_SOCKET); + // Return value + // 0 > : failed / 1 - success + return ret; +} + + +/* DNS TIMER HANDLER */ +void DNS_time_handler(void) { + dns_1s_tick++; +} diff --git a/Internet/DNS/dns.h b/Internet/DNS/dns.h new file mode 100644 index 0000000..8d0e242 --- /dev/null +++ b/Internet/DNS/dns.h @@ -0,0 +1,109 @@ +//***************************************************************************** +// +//! \file dns.h +//! \brief DNS APIs Header file. +//! \details Send DNS query & Receive DNS reponse. +//! \version 1.1.0 +//! \date 2013/11/18 +//! \par Revision history +//! <2013/10/21> 1st Release +//! <2013/12/20> V1.1.0 +//! 1. Remove secondary DNS server in DNS_run +//! If 1st DNS_run failed, call DNS_run with 2nd DNS again +//! 2. DNS_timerHandler -> DNS_time_handler +//! 3. Move the no reference define to dns.c +//! 4. Integrated dns.h dns.c & dns_parse.h dns_parse.c into dns.h & dns.c +//! <2013/12/20> V1.1.0 +//! +//! \author Eric Jung & MidnightCow +//! \copyright +//! +//! Copyright (c) 2013, WIZnet Co., 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: +//! +//! * 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 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 _DNS_H_ +#define _DNS_H_ + +#ifdef __cplusplus +extern "C" { +#endif + +#include +/* + @brief Define it for Debug & Monitor DNS processing. + @note If defined, it dependens on +*/ +//#define _DNS_DEBUG_ + +#define MAX_DNS_BUF_SIZE 256 ///< maximum size of DNS buffer. */ +/* + @brief Maxium length of your queried Domain name + @todo SHOULD BE defined it equal as or greater than your Domain name lenght + null character(1) + @note SHOULD BE careful to stack overflow because it is allocated 1.5 times as MAX_DOMAIN_NAME in stack. +*/ +#define MAX_DOMAIN_NAME 128 // for example "www.google.com" + +#define MAX_DNS_RETRY 2 ///< Requery Count +#define DNS_WAIT_TIME 3 ///< Wait response time. unit 1s. + +#define IPPORT_DOMAIN 53 ///< DNS server port number + +#define DNS_MSG_ID 0x1122 ///< ID for DNS message. You can be modifyed it any number +/* + @brief DNS process initialize + @param s : Socket number for DNS + @param buf : Buffer for DNS message +*/ +void DNS_init(uint8_t s, uint8_t * buf); + +/* + @brief DNS process + @details Send DNS query and receive DNS response + @param dns_ip : DNS server ip + @param name : Domain name to be queryed + @param ip_from_dns : IP address from DNS server + @return -1 : failed. @ref MAX_DOMIN_NAME is too small \n + 0 : failed (Timeout or Parse error)\n + 1 : success + @note This funtion blocks until success or fail. max time = @ref MAX_DNS_RETRY * @ref DNS_WAIT_TIME +*/ +int8_t DNS_run(uint8_t * dns_ip, uint8_t * name, uint8_t * ip_from_dns); + +/* + @brief DNS 1s Tick Timer handler + @note SHOULD BE register to your system 1s Tick timer handler +*/ +void DNS_time_handler(void); + +#ifdef __cplusplus +} +#endif + +#endif /* _DNS_H_ */ diff --git a/Internet/MQTT/MQTTClient.c b/Internet/MQTT/MQTTClient.c new file mode 100644 index 0000000..8a7c9f6 --- /dev/null +++ b/Internet/MQTT/MQTTClient.c @@ -0,0 +1,572 @@ +/******************************************************************************* + Copyright (c) 2014, 2015 IBM Corp. + + All rights reserved. This program and the accompanying materials + are made available under the terms of the Eclipse Public License v1.0 + and Eclipse Distribution License v1.0 which accompany this distribution. + + The Eclipse Public License is available at + http://www.eclipse.org/legal/epl-v10.html + and the Eclipse Distribution License is available at + http://www.eclipse.org/org/documents/edl-v10.php. + + Contributors: + Allan Stockdill-Mander/Ian Craggs - initial API and implementation and/or initial documentation + *******************************************************************************/ +#include "MQTTClient.h" + +static void NewMessageData(MessageData* md, MQTTString* aTopicName, MQTTMessage* aMessage) { + md->topicName = aTopicName; + md->message = aMessage; +} + + +static int getNextPacketId(MQTTClient *c) { + return c->next_packetid = (c->next_packetid == MAX_PACKET_ID) ? 1 : c->next_packetid + 1; +} + + +static int sendPacket(MQTTClient* c, int length, Timer* timer) { + int rc = FAILURE, + sent = 0; + + while (sent < length && !TimerIsExpired(timer)) { + rc = c->ipstack->mqttwrite(c->ipstack, &c->buf[sent], length, TimerLeftMS(timer)); + if (rc < 0) { // there was an error writing the data + break; + } + sent += rc; + } + if (sent == length) { + TimerCountdown(&c->ping_timer, c->keepAliveInterval); // record the fact that we have successfully sent the packet + rc = SUCCESSS; + } else { + rc = FAILURE; + } + return rc; +} + + +void MQTTClientInit(MQTTClient* c, Network* network, unsigned int command_timeout_ms, + unsigned char* sendbuf, size_t sendbuf_size, unsigned char* readbuf, size_t readbuf_size) { + int i; + c->ipstack = network; + + for (i = 0; i < MAX_MESSAGE_HANDLERS; ++i) { + c->messageHandlers[i].topicFilter = 0; + } + c->command_timeout_ms = command_timeout_ms; + c->buf = sendbuf; + c->buf_size = sendbuf_size; + c->readbuf = readbuf; + c->readbuf_size = readbuf_size; + c->isconnected = 0; + c->ping_outstanding = 0; + c->defaultMessageHandler = NULL; + c->next_packetid = 1; + TimerInit(&c->ping_timer); +#if defined(MQTT_TASK) + MutexInit(&c->mutex); +#endif +} + + +static int decodePacket(MQTTClient* c, int* value, int timeout) { + unsigned char i; + int multiplier = 1; + int len = 0; + const int MAX_NO_OF_REMAINING_LENGTH_BYTES = 4; + + *value = 0; + do { + int rc = MQTTPACKET_READ_ERROR; + + if (++len > MAX_NO_OF_REMAINING_LENGTH_BYTES) { + rc = MQTTPACKET_READ_ERROR; /* bad data */ + goto exit; + } + rc = c->ipstack->mqttread(c->ipstack, &i, 1, timeout); + if (rc != 1) { + goto exit; + } + *value += (i & 127) * multiplier; + multiplier *= 128; + } while ((i & 128) != 0); +exit: + return len; +} + + +static int readPacket(MQTTClient* c, Timer* timer) { + int rc = FAILURE; + MQTTHeader header = {0}; + int len = 0; + int rem_len = 0; + + /* 1. read the header byte. This has the packet type in it */ + if (c->ipstack->mqttread(c->ipstack, c->readbuf, 1, TimerLeftMS(timer)) != 1) { + goto exit; + } + + len = 1; + /* 2. read the remaining length. This is variable in itself */ + decodePacket(c, &rem_len, TimerLeftMS(timer)); + len += MQTTPacket_encode(c->readbuf + 1, rem_len); /* put the original remaining length back into the buffer */ + + /* 3. read the rest of the buffer using a callback to supply the rest of the data */ + if (rem_len > 0 && (c->ipstack->mqttread(c->ipstack, c->readbuf + len, rem_len, TimerLeftMS(timer)) != rem_len)) { + goto exit; + } + + header.byte = c->readbuf[0]; + rc = header.bits.type; +exit: + return rc; +} + + +// assume topic filter and name is in correct format +// # can only be at end +// + and # can only be next to separator +static char isTopicMatched(char* topicFilter, MQTTString* topicName) { + char* curf = topicFilter; + char* curn = topicName->lenstring.data; + char* curn_end = curn + topicName->lenstring.len; + + while (*curf && curn < curn_end) { + if (*curn == '/' && *curf != '/') { + break; + } + if (*curf != '+' && *curf != '#' && *curf != *curn) { + break; + } + if (*curf == '+') { + // skip until we meet the next separator, or end of string + char* nextpos = curn + 1; + while (nextpos < curn_end && *nextpos != '/') { + nextpos = ++curn + 1; + } + } else if (*curf == '#') { + curn = curn_end - 1; // skip until end of string + } + curf++; + curn++; + }; + + return (curn == curn_end) && (*curf == '\0'); +} + + +int deliverMessage(MQTTClient* c, MQTTString* topicName, MQTTMessage* message) { + int i; + int rc = FAILURE; + + // we have to find the right message handler - indexed by topic + for (i = 0; i < MAX_MESSAGE_HANDLERS; ++i) { + if (c->messageHandlers[i].topicFilter != 0 && (MQTTPacket_equals(topicName, (char *)c->messageHandlers[i].topicFilter) || + isTopicMatched((char *)c->messageHandlers[i].topicFilter, topicName))) { + if (c->messageHandlers[i].fp != NULL) { + MessageData md; + NewMessageData(&md, topicName, message); + c->messageHandlers[i].fp(&md); + rc = SUCCESSS; + } + } + } + + if (rc == FAILURE && c->defaultMessageHandler != NULL) { + MessageData md; + NewMessageData(&md, topicName, message); + c->defaultMessageHandler(&md); + rc = SUCCESSS; + } + + return rc; +} + + +int keepalive(MQTTClient* c) { + int rc = FAILURE; + + if (c->keepAliveInterval == 0) { + rc = SUCCESSS; + goto exit; + } + + if (TimerIsExpired(&c->ping_timer)) { + if (!c->ping_outstanding) { + Timer timer; + TimerInit(&timer); + TimerCountdownMS(&timer, 1000); + int len = MQTTSerialize_pingreq(c->buf, c->buf_size); + if (len > 0 && (rc = sendPacket(c, len, &timer)) == SUCCESSS) { // send the ping packet + c->ping_outstanding = 1; + } + } + } + +exit: + return rc; +} + + +int cycle(MQTTClient* c, Timer* timer) { + // read the socket, see what work is due + unsigned short packet_type = readPacket(c, timer); + + int len = 0, + rc = SUCCESSS; + + switch (packet_type) { + case CONNACK: + case PUBACK: + case SUBACK: + break; + case PUBLISH: { + MQTTString topicName; + MQTTMessage msg; + int intQoS; + if (MQTTDeserialize_publish(&msg.dup, &intQoS, &msg.retained, &msg.id, &topicName, + (unsigned char * *)&msg.payload, (int *)&msg.payloadlen, c->readbuf, c->readbuf_size) != 1) { + goto exit; + } + msg.qos = (enum QoS)intQoS; + deliverMessage(c, &topicName, &msg); + if (msg.qos != QOS0) { + if (msg.qos == QOS1) { + len = MQTTSerialize_ack(c->buf, c->buf_size, PUBACK, 0, msg.id); + } else if (msg.qos == QOS2) { + len = MQTTSerialize_ack(c->buf, c->buf_size, PUBREC, 0, msg.id); + } + if (len <= 0) { + rc = FAILURE; + } else { + rc = sendPacket(c, len, timer); + } + if (rc == FAILURE) { + goto exit; // there was a problem + } + } + break; + } + case PUBREC: { + unsigned short mypacketid; + unsigned char dup, type; + if (MQTTDeserialize_ack(&type, &dup, &mypacketid, c->readbuf, c->readbuf_size) != 1) { + rc = FAILURE; + } else if ((len = MQTTSerialize_ack(c->buf, c->buf_size, PUBREL, 0, mypacketid)) <= 0) { + rc = FAILURE; + } else if ((rc = sendPacket(c, len, timer)) != SUCCESSS) { // send the PUBREL packet + rc = FAILURE; // there was a problem + } + if (rc == FAILURE) { + goto exit; // there was a problem + } + break; + } + case PUBCOMP: + break; + case PINGRESP: + c->ping_outstanding = 0; + break; + } + keepalive(c); +exit: + if (rc == SUCCESSS) { + rc = packet_type; + } + return rc; +} + + +int MQTTYield(MQTTClient* c, int timeout_ms) { + int rc = SUCCESSS; + Timer timer; + + TimerInit(&timer); + TimerCountdownMS(&timer, timeout_ms); + + if (cycle(c, &timer) == FAILURE) { + rc = FAILURE; + } + + return rc; +} + + +void MQTTRun(void* parm) { + Timer timer; + MQTTClient* c = (MQTTClient*)parm; + + TimerInit(&timer); + + while (1) { +#if defined(MQTT_TASK) + MutexLock(&c->mutex); +#endif + TimerCountdownMS(&timer, 500); /* Don't wait too long if no traffic is incoming */ + cycle(c, &timer); +#if defined(MQTT_TASK) + MutexUnlock(&c->mutex); +#endif + } +} + + +#if defined(MQTT_TASK) +int MQTTStartTask(MQTTClient* client) { + return ThreadStart(&client->thread, &MQTTRun, client); +} +#endif + + +int waitfor(MQTTClient* c, int packet_type, Timer* timer) { + int rc = FAILURE; + + do { + if (TimerIsExpired(timer)) { + break; // we timed out + } + } while ((rc = cycle(c, timer)) != packet_type); + + return rc; +} + + +int MQTTConnect(MQTTClient* c, MQTTPacket_connectData* options) { + Timer connect_timer; + int rc = FAILURE; + MQTTPacket_connectData default_options = MQTTPacket_connectData_initializer; + int len = 0; + +#if defined(MQTT_TASK) + MutexLock(&c->mutex); +#endif + if (c->isconnected) { /* don't send connect packet again if we are already connected */ + goto exit; + } + + TimerInit(&connect_timer); + TimerCountdownMS(&connect_timer, c->command_timeout_ms); + + if (options == 0) { + options = &default_options; /* set default options if none were supplied */ + } + + c->keepAliveInterval = options->keepAliveInterval; + TimerCountdown(&c->ping_timer, c->keepAliveInterval); + if ((len = MQTTSerialize_connect(c->buf, c->buf_size, options)) <= 0) { + goto exit; + } + if ((rc = sendPacket(c, len, &connect_timer)) != SUCCESSS) { // send the connect packet + goto exit; // there was a problem + } + + // this will be a blocking call, wait for the connack + if (waitfor(c, CONNACK, &connect_timer) == CONNACK) { + unsigned char connack_rc = 255; + unsigned char sessionPresent = 0; + if (MQTTDeserialize_connack(&sessionPresent, &connack_rc, c->readbuf, c->readbuf_size) == 1) { + rc = connack_rc; + } else { + rc = FAILURE; + } + } else { + rc = FAILURE; + } + +exit: + if (rc == SUCCESSS) { + c->isconnected = 1; + } + +#if defined(MQTT_TASK) + MutexUnlock(&c->mutex); +#endif + + return rc; +} + + +int MQTTSubscribe(MQTTClient* c, const char* topicFilter, enum QoS qos, messageHandler messageHandler) { + int rc = FAILURE; + Timer timer; + int len = 0; + MQTTString topic = MQTTString_initializer; + topic.cstring = (char *)topicFilter; + // This was added because enum QoS was previously typed to *int which resulted in HardFault and unaligned integer read. + // This coping below makes sure the parameter for MQTTSerialize_subscribe is always char no matter what compiler is using for enums + char charQos = (char)qos; + +#if defined(MQTT_TASK) + MutexLock(&c->mutex); +#endif + if (!c->isconnected) { + goto exit; + } + + TimerInit(&timer); + TimerCountdownMS(&timer, c->command_timeout_ms); + + len = MQTTSerialize_subscribe(c->buf, c->buf_size, 0, getNextPacketId(c), 1, &topic, &charQos); + if (len <= 0) { + goto exit; + } + if ((rc = sendPacket(c, len, &timer)) != SUCCESSS) { // send the subscribe packet + goto exit; // there was a problem + } + + if (waitfor(c, SUBACK, &timer) == SUBACK) { // wait for suback + int count = 0, grantedQoS = -1; + unsigned short mypacketid; + if (MQTTDeserialize_suback(&mypacketid, 1, &count, &grantedQoS, c->readbuf, c->readbuf_size) == 1) { + rc = grantedQoS; // 0, 1, 2 or 0x80 + } + if (rc != 0x80) { + int i; + for (i = 0; i < MAX_MESSAGE_HANDLERS; ++i) { + if (c->messageHandlers[i].topicFilter == 0) { + c->messageHandlers[i].topicFilter = topicFilter; + c->messageHandlers[i].fp = messageHandler; + rc = 0; + break; + } + } + } + } else { + rc = FAILURE; + } + +exit: +#if defined(MQTT_TASK) + MutexUnlock(&c->mutex); +#endif + return rc; +} + + +int MQTTUnsubscribe(MQTTClient* c, const char* topicFilter) { + int rc = FAILURE; + Timer timer; + MQTTString topic = MQTTString_initializer; + topic.cstring = (char *)topicFilter; + int len = 0; + +#if defined(MQTT_TASK) + MutexLock(&c->mutex); +#endif + if (!c->isconnected) { + goto exit; + } + + TimerInit(&timer); + TimerCountdownMS(&timer, c->command_timeout_ms); + + if ((len = MQTTSerialize_unsubscribe(c->buf, c->buf_size, 0, getNextPacketId(c), 1, &topic)) <= 0) { + goto exit; + } + if ((rc = sendPacket(c, len, &timer)) != SUCCESSS) { // send the subscribe packet + goto exit; // there was a problem + } + + if (waitfor(c, UNSUBACK, &timer) == UNSUBACK) { + unsigned short mypacketid; // should be the same as the packetid above + if (MQTTDeserialize_unsuback(&mypacketid, c->readbuf, c->readbuf_size) == 1) { + rc = 0; + } + } else { + rc = FAILURE; + } + +exit: +#if defined(MQTT_TASK) + MutexUnlock(&c->mutex); +#endif + return rc; +} + + +int MQTTPublish(MQTTClient* c, const char* topicName, MQTTMessage* message) { + int rc = FAILURE; + Timer timer; + MQTTString topic = MQTTString_initializer; + topic.cstring = (char *)topicName; + int len = 0; + +#if defined(MQTT_TASK) + MutexLock(&c->mutex); +#endif + if (!c->isconnected) { + goto exit; + } + + TimerInit(&timer); + TimerCountdownMS(&timer, c->command_timeout_ms); + + if (message->qos == QOS1 || message->qos == QOS2) { + message->id = getNextPacketId(c); + } + + len = MQTTSerialize_publish(c->buf, c->buf_size, 0, message->qos, message->retained, message->id, + topic, (unsigned char*)message->payload, message->payloadlen); + if (len <= 0) { + goto exit; + } + if ((rc = sendPacket(c, len, &timer)) != SUCCESSS) { // send the subscribe packet + goto exit; // there was a problem + } + + if (message->qos == QOS1) { + if (waitfor(c, PUBACK, &timer) == PUBACK) { + unsigned short mypacketid; + unsigned char dup, type; + if (MQTTDeserialize_ack(&type, &dup, &mypacketid, c->readbuf, c->readbuf_size) != 1) { + rc = FAILURE; + } + } else { + rc = FAILURE; + } + } else if (message->qos == QOS2) { + if (waitfor(c, PUBCOMP, &timer) == PUBCOMP) { + unsigned short mypacketid; + unsigned char dup, type; + if (MQTTDeserialize_ack(&type, &dup, &mypacketid, c->readbuf, c->readbuf_size) != 1) { + rc = FAILURE; + } + } else { + rc = FAILURE; + } + } + +exit: +#if defined(MQTT_TASK) + MutexUnlock(&c->mutex); +#endif + return rc; +} + + +int MQTTDisconnect(MQTTClient* c) { + int rc = FAILURE; + Timer timer; // we might wait for incomplete incoming publishes to complete + int len = 0; + +#if defined(MQTT_TASK) + MutexLock(&c->mutex); +#endif + TimerInit(&timer); + TimerCountdownMS(&timer, c->command_timeout_ms); + + len = MQTTSerialize_disconnect(c->buf, c->buf_size); + if (len > 0) { + rc = sendPacket(c, len, &timer); // send the disconnect packet + } + + c->isconnected = 0; + +#if defined(MQTT_TASK) + MutexUnlock(&c->mutex); +#endif + return rc; +} + diff --git a/Internet/MQTT/MQTTClient.h b/Internet/MQTT/MQTTClient.h new file mode 100644 index 0000000..0818404 --- /dev/null +++ b/Internet/MQTT/MQTTClient.h @@ -0,0 +1,178 @@ +/******************************************************************************* + Copyright (c) 2014, 2015 IBM Corp. + + All rights reserved. This program and the accompanying materials + are made available under the terms of the Eclipse Public License v1.0 + and Eclipse Distribution License v1.0 which accompany this distribution. + + The Eclipse Public License is available at + http://www.eclipse.org/legal/epl-v10.html + and the Eclipse Distribution License is available at + http://www.eclipse.org/org/documents/edl-v10.php. + + Contributors: + Allan Stockdill-Mander/Ian Craggs - initial API and implementation and/or initial documentation + Ian Craggs - documentation and platform specific header + *******************************************************************************/ + +#if !defined(__MQTT_CLIENT_C_) +#define __MQTT_CLIENT_C_ + +#if defined(__cplusplus) +extern "C" { +#endif + +#if defined(WIN32_DLL) || defined(WIN64_DLL) +#define DLLImport __declspec(dllimport) +#define DLLExport __declspec(dllexport) +#elif defined(LINUX_SO) +#define DLLImport extern +#define DLLExport __attribute__ ((visibility ("default"))) +#else +#define DLLImport +#define DLLExport +#endif + +#include "./MQTTPacket/src/MQTTPacket.h" +#include "stdio.h" +#include "mqtt_interface.h" + +#define MAX_PACKET_ID 65535 /* according to the MQTT specification - do not change! */ + +#if !defined(MAX_MESSAGE_HANDLERS) +#define MAX_MESSAGE_HANDLERS 5 /* redefinable - how many subscriptions do you want? */ +#endif + +enum QoS { QOS0, QOS1, QOS2 }; + +/* all failure return codes must be negative */ +enum returnCode { BUFFER_OVERFLOW = -2, FAILURE = -1, SUCCESSS = 0 }; + +/* The Platform specific header must define the Network and Timer structures and functions + which operate on them. + + typedef struct Network + { + int (*mqttread)(Network*, unsigned char* read_buffer, int, int); + int (*mqttwrite)(Network*, unsigned char* send_buffer, int, int); + } Network;*/ + +/* The Timer structure must be defined in the platform specific header, + and have the following functions to operate on it. */ +extern void TimerInit(Timer*); +extern char TimerIsExpired(Timer*); +extern void TimerCountdownMS(Timer*, unsigned int); +extern void TimerCountdown(Timer*, unsigned int); +extern int TimerLeftMS(Timer*); + +typedef struct MQTTMessage { + enum QoS qos; + unsigned char retained; + unsigned char dup; + unsigned short id; + void *payload; + size_t payloadlen; +} MQTTMessage; + +typedef struct MessageData { + MQTTMessage* message; + MQTTString* topicName; +} MessageData; + +typedef void (*messageHandler)(MessageData*); + +typedef struct MQTTClient { + unsigned int next_packetid, + command_timeout_ms; + size_t buf_size, + readbuf_size; + unsigned char *buf, + *readbuf; + unsigned int keepAliveInterval; + char ping_outstanding; + int isconnected; + + struct MessageHandlers { + const char* topicFilter; + void (*fp) (MessageData*); + } messageHandlers[MAX_MESSAGE_HANDLERS]; /* Message handlers are indexed by subscription topic */ + + void (*defaultMessageHandler) (MessageData*); + + Network* ipstack; + Timer ping_timer; +#if defined(MQTT_TASK) + Mutex mutex; + Thread thread; +#endif +} MQTTClient; + +#define DefaultClient {0, 0, 0, 0, NULL, NULL, 0, 0, 0} + + +/** + Create an MQTT client object + @param client + @param network + @param command_timeout_ms + @param +*/ +DLLExport void MQTTClientInit(MQTTClient* client, Network* network, unsigned int command_timeout_ms, + unsigned char* sendbuf, size_t sendbuf_size, unsigned char* readbuf, size_t readbuf_size); + +/** MQTT Connect - send an MQTT connect packet down the network and wait for a Connack + The nework object must be connected to the network endpoint before calling this + @param options - connect options + @return success code +*/ +DLLExport int MQTTConnect(MQTTClient* client, MQTTPacket_connectData* options); + +/** MQTT Publish - send an MQTT publish packet and wait for all acks to complete for all QoSs + @param client - the client object to use + @param topic - the topic to publish to + @param message - the message to send + @return success code +*/ +DLLExport int MQTTPublish(MQTTClient* client, const char*, MQTTMessage*); + +/** MQTT Subscribe - send an MQTT subscribe packet and wait for suback before returning. + @param client - the client object to use + @param topicFilter - the topic filter to subscribe to + @param message - the message to send + @return success code +*/ +DLLExport int MQTTSubscribe(MQTTClient* client, const char* topicFilter, enum QoS, messageHandler); + +/** MQTT Subscribe - send an MQTT unsubscribe packet and wait for unsuback before returning. + @param client - the client object to use + @param topicFilter - the topic filter to unsubscribe from + @return success code +*/ +DLLExport int MQTTUnsubscribe(MQTTClient* client, const char* topicFilter); + +/** MQTT Disconnect - send an MQTT disconnect packet and close the connection + @param client - the client object to use + @return success code +*/ +DLLExport int MQTTDisconnect(MQTTClient* client); + +/** MQTT Yield - MQTT background + @param client - the client object to use + @param time - the time, in milliseconds, to yield for + @return success code +*/ +DLLExport int MQTTYield(MQTTClient* client, int time); + +#if defined(MQTT_TASK) +/** MQTT start background thread for a client. After this, MQTTYield should not be called. + @param client - the client object to use + @return success code +*/ +DLLExport int MQTTStartTask(MQTTClient* client); +#endif + +#if defined(__cplusplus) +} +#endif + +#endif diff --git a/Internet/MQTT/MQTTPacket/src/MQTTConnect.h b/Internet/MQTT/MQTTPacket/src/MQTTConnect.h new file mode 100644 index 0000000..3a68e2f --- /dev/null +++ b/Internet/MQTT/MQTTPacket/src/MQTTConnect.h @@ -0,0 +1,128 @@ +/******************************************************************************* + Copyright (c) 2014 IBM Corp. + + All rights reserved. This program and the accompanying materials + are made available under the terms of the Eclipse Public License v1.0 + and Eclipse Distribution License v1.0 which accompany this distribution. + + The Eclipse Public License is available at + http://www.eclipse.org/legal/epl-v10.html + and the Eclipse Distribution License is available at + http://www.eclipse.org/org/documents/edl-v10.php. + + Contributors: + Ian Craggs - initial API and implementation and/or initial documentation + Xiang Rong - 442039 Add makefile to Embedded C client + *******************************************************************************/ + +#ifndef MQTTCONNECT_H_ +#define MQTTCONNECT_H_ + +#if !defined(DLLImport) +#define DLLImport +#endif +#if !defined(DLLExport) +#define DLLExport +#endif + + +typedef union { + unsigned char all; /**< all connect flags */ +#if defined(REVERSED) + struct { + unsigned int username : 1; /**< 3.1 user name */ + unsigned int password : 1; /**< 3.1 password */ + unsigned int willRetain : 1; /**< will retain setting */ + unsigned int willQoS : 2; /**< will QoS value */ + unsigned int will : 1; /**< will flag */ + unsigned int cleansession : 1; /**< clean session flag */ + unsigned int : 1; /**< unused */ + } bits; +#else + struct { + unsigned int : 1; /**< unused */ + unsigned int cleansession : 1; /**< cleansession flag */ + unsigned int will : 1; /**< will flag */ + unsigned int willQoS : 2; /**< will QoS value */ + unsigned int willRetain : 1; /**< will retain setting */ + unsigned int password : 1; /**< 3.1 password */ + unsigned int username : 1; /**< 3.1 user name */ + } bits; +#endif +} MQTTConnectFlags; /**< connect flags byte */ + + + +/** + Defines the MQTT "Last Will and Testament" (LWT) settings for + the connect packet. +*/ +typedef struct { + /** The eyecatcher for this structure. must be MQTW. */ + char struct_id[4]; + /** The version number of this structure. Must be 0 */ + int struct_version; + /** The LWT topic to which the LWT message will be published. */ + MQTTString topicName; + /** The LWT payload. */ + MQTTString message; + /** + The retained flag for the LWT message (see MQTTAsync_message.retained). + */ + unsigned char retained; + /** + The quality of service setting for the LWT message (see + MQTTAsync_message.qos and @ref qos). + */ + char qos; +} MQTTPacket_willOptions; + + +#define MQTTPacket_willOptions_initializer { {'M', 'Q', 'T', 'W'}, 0, {NULL, {0, NULL}}, {NULL, {0, NULL}}, 0, 0 } + + +typedef struct { + /** The eyecatcher for this structure. must be MQTC. */ + char struct_id[4]; + /** The version number of this structure. Must be 0 */ + int struct_version; + /** Version of MQTT to be used. 3 = 3.1 4 = 3.1.1 + */ + unsigned char MQTTVersion; + MQTTString clientID; + unsigned short keepAliveInterval; + unsigned char cleansession; + unsigned char willFlag; + MQTTPacket_willOptions will; + MQTTString username; + MQTTString password; +} MQTTPacket_connectData; + +typedef union { + unsigned char all; /**< all connack flags */ +#if defined(REVERSED) + struct { + unsigned int sessionpresent : 1; /**< session present flag */ + unsigned int : 7; /**< unused */ + } bits; +#else + struct { + unsigned int : 7; /**< unused */ + unsigned int sessionpresent : 1; /**< session present flag */ + } bits; +#endif +} MQTTConnackFlags; /**< connack flags byte */ + +#define MQTTPacket_connectData_initializer { {'M', 'Q', 'T', 'C'}, 0, 4, {NULL, {0, NULL}}, 60, 1, 0, \ + MQTTPacket_willOptions_initializer, {NULL, {0, NULL}}, {NULL, {0, NULL}} } + +DLLExport int MQTTSerialize_connect(unsigned char* buf, int buflen, MQTTPacket_connectData* options); +DLLExport int MQTTDeserialize_connect(MQTTPacket_connectData* data, unsigned char* buf, int len); + +DLLExport int MQTTSerialize_connack(unsigned char* buf, int buflen, unsigned char connack_rc, unsigned char sessionPresent); +DLLExport int MQTTDeserialize_connack(unsigned char* sessionPresent, unsigned char* connack_rc, unsigned char* buf, int buflen); + +DLLExport int MQTTSerialize_disconnect(unsigned char* buf, int buflen); +DLLExport int MQTTSerialize_pingreq(unsigned char* buf, int buflen); + +#endif /* MQTTCONNECT_H_ */ diff --git a/Internet/MQTT/MQTTPacket/src/MQTTConnectClient.c b/Internet/MQTT/MQTTPacket/src/MQTTConnectClient.c new file mode 100644 index 0000000..fe76faa --- /dev/null +++ b/Internet/MQTT/MQTTPacket/src/MQTTConnectClient.c @@ -0,0 +1,211 @@ +/******************************************************************************* + Copyright (c) 2014 IBM Corp. + + All rights reserved. This program and the accompanying materials + are made available under the terms of the Eclipse Public License v1.0 + and Eclipse Distribution License v1.0 which accompany this distribution. + + The Eclipse Public License is available at + http://www.eclipse.org/legal/epl-v10.html + and the Eclipse Distribution License is available at + http://www.eclipse.org/org/documents/edl-v10.php. + + Contributors: + Ian Craggs - initial API and implementation and/or initial documentation + *******************************************************************************/ + +#include "MQTTPacket.h" +#include "StackTrace.h" + +#include + +/** + Determines the length of the MQTT connect packet that would be produced using the supplied connect options. + @param options the options to be used to build the connect packet + @return the length of buffer needed to contain the serialized version of the packet +*/ +int MQTTSerialize_connectLength(MQTTPacket_connectData* options) { + int len = 0; + + FUNC_ENTRY; + + if (options->MQTTVersion == 3) { + len = 12; /* variable depending on MQTT or MQIsdp */ + } else if (options->MQTTVersion == 4) { + len = 10; + } + + len += MQTTstrlen(options->clientID) +2; + if (options->willFlag) { + len += MQTTstrlen(options->will.topicName) +2 + MQTTstrlen(options->will.message) +2; + } + if (options->username.cstring || options->username.lenstring.data) { + len += MQTTstrlen(options->username) +2; + } + if (options->password.cstring || options->password.lenstring.data) { + len += MQTTstrlen(options->password) +2; + } + + FUNC_EXIT_RC(len); + return len; +} + + +/** + Serializes the connect options into the buffer. + @param buf the buffer into which the packet will be serialized + @param len the length in bytes of the supplied buffer + @param options the options to be used to build the connect packet + @return serialized length, or error if 0 +*/ +int MQTTSerialize_connect(unsigned char* buf, int buflen, MQTTPacket_connectData* options) { + unsigned char *ptr = buf; + MQTTHeader header = {0}; + MQTTConnectFlags flags = {0}; + int len = 0; + int rc = -1; + + FUNC_ENTRY; + if (MQTTPacket_len(len = MQTTSerialize_connectLength(options)) > buflen) { + rc = MQTTPACKET_BUFFER_TOO_SHORT; + goto exit; + } + + header.byte = 0; + header.bits.type = CONNECT; + writeChar(&ptr, header.byte); /* write header */ + + ptr += MQTTPacket_encode(ptr, len); /* write remaining length */ + + if (options->MQTTVersion == 4) { + writeCString(&ptr, "MQTT"); + writeChar(&ptr, (char) 4); + } else { + writeCString(&ptr, "MQIsdp"); + writeChar(&ptr, (char) 3); + } + + flags.all = 0; + flags.bits.cleansession = options->cleansession; + flags.bits.will = (options->willFlag) ? 1 : 0; + if (flags.bits.will) { + flags.bits.willQoS = options->will.qos; + flags.bits.willRetain = options->will.retained; + } + + if (options->username.cstring || options->username.lenstring.data) { + flags.bits.username = 1; + } + if (options->password.cstring || options->password.lenstring.data) { + flags.bits.password = 1; + } + + writeChar(&ptr, flags.all); + writeInt(&ptr, options->keepAliveInterval); + writeMQTTString(&ptr, options->clientID); + if (options->willFlag) { + writeMQTTString(&ptr, options->will.topicName); + writeMQTTString(&ptr, options->will.message); + } + if (flags.bits.username) { + writeMQTTString(&ptr, options->username); + } + if (flags.bits.password) { + writeMQTTString(&ptr, options->password); + } + + rc = ptr - buf; + +exit: FUNC_EXIT_RC(rc); + return rc; +} + + +/** + Deserializes the supplied (wire) buffer into connack data - return code + @param sessionPresent the session present flag returned (only for MQTT 3.1.1) + @param connack_rc returned integer value of the connack return code + @param buf the raw buffer data, of the correct length determined by the remaining length field + @param len the length in bytes of the data in the supplied buffer + @return error code. 1 is success, 0 is failure +*/ +int MQTTDeserialize_connack(unsigned char* sessionPresent, unsigned char* connack_rc, unsigned char* buf, int buflen) { + MQTTHeader header = {0}; + unsigned char* curdata = buf; + unsigned char* enddata = NULL; + int rc = 0; + int mylen; + MQTTConnackFlags flags = {0}; + + FUNC_ENTRY; + header.byte = readChar(&curdata); + if (header.bits.type != CONNACK) { + goto exit; + } + + curdata += (rc = MQTTPacket_decodeBuf(curdata, &mylen)); /* read remaining length */ + enddata = curdata + mylen; + if (enddata - curdata < 2) { + goto exit; + } + + flags.all = readChar(&curdata); + *sessionPresent = flags.bits.sessionpresent; + *connack_rc = readChar(&curdata); + + rc = 1; +exit: + FUNC_EXIT_RC(rc); + return rc; +} + + +/** + Serializes a 0-length packet into the supplied buffer, ready for writing to a socket + @param buf the buffer into which the packet will be serialized + @param buflen the length in bytes of the supplied buffer, to avoid overruns + @param packettype the message type + @return serialized length, or error if 0 +*/ +int MQTTSerialize_zero(unsigned char* buf, int buflen, unsigned char packettype) { + MQTTHeader header = {0}; + int rc = -1; + unsigned char *ptr = buf; + + FUNC_ENTRY; + if (buflen < 2) { + rc = MQTTPACKET_BUFFER_TOO_SHORT; + goto exit; + } + header.byte = 0; + header.bits.type = packettype; + writeChar(&ptr, header.byte); /* write header */ + + ptr += MQTTPacket_encode(ptr, 0); /* write remaining length */ + rc = ptr - buf; +exit: + FUNC_EXIT_RC(rc); + return rc; +} + + +/** + Serializes a disconnect packet into the supplied buffer, ready for writing to a socket + @param buf the buffer into which the packet will be serialized + @param buflen the length in bytes of the supplied buffer, to avoid overruns + @return serialized length, or error if 0 +*/ +int MQTTSerialize_disconnect(unsigned char* buf, int buflen) { + return MQTTSerialize_zero(buf, buflen, DISCONNECT); +} + + +/** + Serializes a disconnect packet into the supplied buffer, ready for writing to a socket + @param buf the buffer into which the packet will be serialized + @param buflen the length in bytes of the supplied buffer, to avoid overruns + @return serialized length, or error if 0 +*/ +int MQTTSerialize_pingreq(unsigned char* buf, int buflen) { + return MQTTSerialize_zero(buf, buflen, PINGREQ); +} diff --git a/Internet/MQTT/MQTTPacket/src/MQTTConnectServer.c b/Internet/MQTT/MQTTPacket/src/MQTTConnectServer.c new file mode 100644 index 0000000..c0701cd --- /dev/null +++ b/Internet/MQTT/MQTTPacket/src/MQTTConnectServer.c @@ -0,0 +1,148 @@ +/******************************************************************************* + Copyright (c) 2014 IBM Corp. + + All rights reserved. This program and the accompanying materials + are made available under the terms of the Eclipse Public License v1.0 + and Eclipse Distribution License v1.0 which accompany this distribution. + + The Eclipse Public License is available at + http://www.eclipse.org/legal/epl-v10.html + and the Eclipse Distribution License is available at + http://www.eclipse.org/org/documents/edl-v10.php. + + Contributors: + Ian Craggs - initial API and implementation and/or initial documentation + *******************************************************************************/ + +#include "StackTrace.h" +#include "MQTTPacket.h" +#include + +#define min(a, b) ((a < b) ? a : b) + + +/** + Validates MQTT protocol name and version combinations + @param protocol the MQTT protocol name as an MQTTString + @param version the MQTT protocol version number, as in the connect packet + @return correct MQTT combination? 1 is true, 0 is false +*/ +int MQTTPacket_checkVersion(MQTTString* protocol, int version) { + int rc = 0; + + if (version == 3 && memcmp(protocol->lenstring.data, "MQIsdp", + min(6, protocol->lenstring.len)) == 0) { + rc = 1; + } else if (version == 4 && memcmp(protocol->lenstring.data, "MQTT", + min(4, protocol->lenstring.len)) == 0) { + rc = 1; + } + return rc; +} + + +/** + Deserializes the supplied (wire) buffer into connect data structure + @param data the connect data structure to be filled out + @param buf the raw buffer data, of the correct length determined by the remaining length field + @param len the length in bytes of the data in the supplied buffer + @return error code. 1 is success, 0 is failure +*/ +int MQTTDeserialize_connect(MQTTPacket_connectData* data, unsigned char* buf, int len) { + MQTTHeader header = {0}; + MQTTConnectFlags flags = {0}; + unsigned char* curdata = buf; + unsigned char* enddata = &buf[len]; + int rc = 0; + MQTTString Protocol; + int version; + int mylen = 0; + + FUNC_ENTRY; + header.byte = readChar(&curdata); + if (header.bits.type != CONNECT) { + goto exit; + } + + curdata += MQTTPacket_decodeBuf(curdata, &mylen); /* read remaining length */ + + if (!readMQTTLenString(&Protocol, &curdata, enddata) || + enddata - curdata < 0) { /* do we have enough data to read the protocol version byte? */ + goto exit; + } + + version = (int)readChar(&curdata); /* Protocol version */ + /* If we don't recognize the protocol version, we don't parse the connect packet on the + basis that we don't know what the format will be. + */ + if (MQTTPacket_checkVersion(&Protocol, version)) { + flags.all = readChar(&curdata); + data->cleansession = flags.bits.cleansession; + data->keepAliveInterval = readInt(&curdata); + if (!readMQTTLenString(&data->clientID, &curdata, enddata)) { + goto exit; + } + data->willFlag = flags.bits.will; + if (flags.bits.will) { + data->will.qos = flags.bits.willQoS; + data->will.retained = flags.bits.willRetain; + if (!readMQTTLenString(&data->will.topicName, &curdata, enddata) || + !readMQTTLenString(&data->will.message, &curdata, enddata)) { + goto exit; + } + } + if (flags.bits.username) { + if (enddata - curdata < 3 || !readMQTTLenString(&data->username, &curdata, enddata)) { + goto exit; /* username flag set, but no username supplied - invalid */ + } + if (flags.bits.password && + (enddata - curdata < 3 || !readMQTTLenString(&data->password, &curdata, enddata))) { + goto exit; /* password flag set, but no password supplied - invalid */ + } + } else if (flags.bits.password) { + goto exit; /* password flag set without username - invalid */ + } + rc = 1; + } +exit: + FUNC_EXIT_RC(rc); + return rc; +} + + +/** + Serializes the connack packet into the supplied buffer. + @param buf the buffer into which the packet will be serialized + @param buflen the length in bytes of the supplied buffer + @param connack_rc the integer connack return code to be used + @param sessionPresent the MQTT 3.1.1 sessionPresent flag + @return serialized length, or error if 0 +*/ +int MQTTSerialize_connack(unsigned char* buf, int buflen, unsigned char connack_rc, unsigned char sessionPresent) { + MQTTHeader header = {0}; + int rc = 0; + unsigned char *ptr = buf; + MQTTConnackFlags flags = {0}; + + FUNC_ENTRY; + if (buflen < 2) { + rc = MQTTPACKET_BUFFER_TOO_SHORT; + goto exit; + } + header.byte = 0; + header.bits.type = CONNACK; + writeChar(&ptr, header.byte); /* write header */ + + ptr += MQTTPacket_encode(ptr, 2); /* write remaining length */ + + flags.all = 0; + flags.bits.sessionpresent = sessionPresent; + writeChar(&ptr, flags.all); + writeChar(&ptr, connack_rc); + + rc = ptr - buf; +exit: + FUNC_EXIT_RC(rc); + return rc; +} + diff --git a/Internet/MQTT/MQTTPacket/src/MQTTDeserializePublish.c b/Internet/MQTT/MQTTPacket/src/MQTTDeserializePublish.c new file mode 100644 index 0000000..f53855e --- /dev/null +++ b/Internet/MQTT/MQTTPacket/src/MQTTDeserializePublish.c @@ -0,0 +1,109 @@ +/******************************************************************************* + Copyright (c) 2014 IBM Corp. + + All rights reserved. This program and the accompanying materials + are made available under the terms of the Eclipse Public License v1.0 + and Eclipse Distribution License v1.0 which accompany this distribution. + + The Eclipse Public License is available at + http://www.eclipse.org/legal/epl-v10.html + and the Eclipse Distribution License is available at + http://www.eclipse.org/org/documents/edl-v10.php. + + Contributors: + Ian Craggs - initial API and implementation and/or initial documentation + *******************************************************************************/ + +#include "StackTrace.h" +#include "MQTTPacket.h" +#include + +#define min(a, b) ((a < b) ? 1 : 0) + +/** + Deserializes the supplied (wire) buffer into publish data + @param dup returned integer - the MQTT dup flag + @param qos returned integer - the MQTT QoS value + @param retained returned integer - the MQTT retained flag + @param packetid returned integer - the MQTT packet identifier + @param topicName returned MQTTString - the MQTT topic in the publish + @param payload returned byte buffer - the MQTT publish payload + @param payloadlen returned integer - the length of the MQTT payload + @param buf the raw buffer data, of the correct length determined by the remaining length field + @param buflen the length in bytes of the data in the supplied buffer + @return error code. 1 is success +*/ +int MQTTDeserialize_publish(unsigned char* dup, int* qos, unsigned char* retained, unsigned short* packetid, MQTTString* topicName, + unsigned char** payload, int* payloadlen, unsigned char* buf, int buflen) { + MQTTHeader header = {0}; + unsigned char* curdata = buf; + unsigned char* enddata = NULL; + int rc = 0; + int mylen = 0; + + FUNC_ENTRY; + header.byte = readChar(&curdata); + if (header.bits.type != PUBLISH) { + goto exit; + } + *dup = header.bits.dup; + *qos = header.bits.qos; + *retained = header.bits.retain; + + curdata += (rc = MQTTPacket_decodeBuf(curdata, &mylen)); /* read remaining length */ + enddata = curdata + mylen; + + if (!readMQTTLenString(topicName, &curdata, enddata) || + enddata - curdata < 0) { /* do we have enough data to read the protocol version byte? */ + goto exit; + } + + if (*qos > 0) { + *packetid = readInt(&curdata); + } + + *payloadlen = enddata - curdata; + *payload = curdata; + rc = 1; +exit: + FUNC_EXIT_RC(rc); + return rc; +} + + + +/** + Deserializes the supplied (wire) buffer into an ack + @param packettype returned integer - the MQTT packet type + @param dup returned integer - the MQTT dup flag + @param packetid returned integer - the MQTT packet identifier + @param buf the raw buffer data, of the correct length determined by the remaining length field + @param buflen the length in bytes of the data in the supplied buffer + @return error code. 1 is success, 0 is failure +*/ +int MQTTDeserialize_ack(unsigned char* packettype, unsigned char* dup, unsigned short* packetid, unsigned char* buf, int buflen) { + MQTTHeader header = {0}; + unsigned char* curdata = buf; + unsigned char* enddata = NULL; + int rc = 0; + int mylen; + + FUNC_ENTRY; + header.byte = readChar(&curdata); + *dup = header.bits.dup; + *packettype = header.bits.type; + + curdata += (rc = MQTTPacket_decodeBuf(curdata, &mylen)); /* read remaining length */ + enddata = curdata + mylen; + + if (enddata - curdata < 2) { + goto exit; + } + *packetid = readInt(&curdata); + + rc = 1; +exit: + FUNC_EXIT_RC(rc); + return rc; +} + diff --git a/Internet/MQTT/MQTTPacket/src/MQTTFormat.c b/Internet/MQTT/MQTTPacket/src/MQTTFormat.c new file mode 100644 index 0000000..c0c4447 --- /dev/null +++ b/Internet/MQTT/MQTTPacket/src/MQTTFormat.c @@ -0,0 +1,241 @@ +/******************************************************************************* + Copyright (c) 2014 IBM Corp. + + All rights reserved. This program and the accompanying materials + are made available under the terms of the Eclipse Public License v1.0 + and Eclipse Distribution License v1.0 which accompany this distribution. + + The Eclipse Public License is available at + http://www.eclipse.org/legal/epl-v10.html + and the Eclipse Distribution License is available at + http://www.eclipse.org/org/documents/edl-v10.php. + + Contributors: + Ian Craggs - initial API and implementation and/or initial documentation + *******************************************************************************/ + +#include "StackTrace.h" +#include "MQTTPacket.h" + +#include + + +const char* MQTTPacket_names[] = { + "RESERVED", "CONNECT", "CONNACK", "PUBLISH", "PUBACK", "PUBREC", "PUBREL", + "PUBCOMP", "SUBSCRIBE", "SUBACK", "UNSUBSCRIBE", "UNSUBACK", + "PINGREQ", "PINGRESP", "DISCONNECT" +}; + + +const char* MQTTPacket_getName(unsigned short packetid) { + return MQTTPacket_names[packetid]; +} + + +int MQTTStringFormat_connect(char* strbuf, int strbuflen, MQTTPacket_connectData* data) { + int strindex = 0; + + strindex = snprintf(strbuf, strbuflen, + "CONNECT MQTT version %d, client id %.*s, clean session %d, keep alive %d", + (int)data->MQTTVersion, data->clientID.lenstring.len, data->clientID.lenstring.data, + (int)data->cleansession, data->keepAliveInterval); + if (data->willFlag) + strindex += snprintf(&strbuf[strindex], strbuflen - strindex, + ", will QoS %d, will retain %d, will topic %.*s, will message %.*s", + data->will.qos, data->will.retained, + data->will.topicName.lenstring.len, data->will.topicName.lenstring.data, + data->will.message.lenstring.len, data->will.message.lenstring.data); + if (data->username.lenstring.data && data->username.lenstring.len > 0) + strindex += snprintf(&strbuf[strindex], strbuflen - strindex, + ", user name %.*s", data->username.lenstring.len, data->username.lenstring.data); + if (data->password.lenstring.data && data->password.lenstring.len > 0) + strindex += snprintf(&strbuf[strindex], strbuflen - strindex, + ", password %.*s", data->password.lenstring.len, data->password.lenstring.data); + return strindex; +} + + +int MQTTStringFormat_connack(char* strbuf, int strbuflen, unsigned char connack_rc, unsigned char sessionPresent) { + int strindex = snprintf(strbuf, strbuflen, "CONNACK session present %d, rc %d", sessionPresent, connack_rc); + return strindex; +} + + +int MQTTStringFormat_publish(char* strbuf, int strbuflen, unsigned char dup, int qos, unsigned char retained, + unsigned short packetid, MQTTString topicName, unsigned char* payload, int payloadlen) { + int strindex = snprintf(strbuf, strbuflen, + "PUBLISH dup %d, QoS %d, retained %d, packet id %d, topic %.*s, payload length %d, payload %.*s", + dup, qos, retained, packetid, + (topicName.lenstring.len < 20) ? topicName.lenstring.len : 20, topicName.lenstring.data, + payloadlen, (payloadlen < 20) ? payloadlen : 20, payload); + return strindex; +} + + +int MQTTStringFormat_ack(char* strbuf, int strbuflen, unsigned char packettype, unsigned char dup, unsigned short packetid) { + int strindex = snprintf(strbuf, strbuflen, "%s, packet id %d", MQTTPacket_names[packettype], packetid); + if (dup) { + strindex += snprintf(strbuf + strindex, strbuflen - strindex, ", dup %d", dup); + } + return strindex; +} + + +int MQTTStringFormat_subscribe(char* strbuf, int strbuflen, unsigned char dup, unsigned short packetid, int count, + MQTTString topicFilters[], int requestedQoSs[]) { + return snprintf(strbuf, strbuflen, + "SUBSCRIBE dup %d, packet id %d count %d topic %.*s qos %d", + dup, packetid, count, + topicFilters[0].lenstring.len, topicFilters[0].lenstring.data, + requestedQoSs[0]); +} + + +int MQTTStringFormat_suback(char* strbuf, int strbuflen, unsigned short packetid, int count, int* grantedQoSs) { + return snprintf(strbuf, strbuflen, + "SUBACK packet id %d count %d granted qos %d", packetid, count, grantedQoSs[0]); +} + + +int MQTTStringFormat_unsubscribe(char* strbuf, int strbuflen, unsigned char dup, unsigned short packetid, + int count, MQTTString topicFilters[]) { + return snprintf(strbuf, strbuflen, + "UNSUBSCRIBE dup %d, packet id %d count %d topic %.*s", + dup, packetid, count, + topicFilters[0].lenstring.len, topicFilters[0].lenstring.data); +} + + +char* MQTTFormat_toClientString(char* strbuf, int strbuflen, unsigned char* buf, int buflen) { + int index = 0; + int rem_length = 0; + MQTTHeader header = {0}; + header.byte = buf[index++]; + index += MQTTPacket_decodeBuf(&buf[index], &rem_length); + + switch (header.bits.type) { + case CONNACK: { + unsigned char sessionPresent, connack_rc; + if (MQTTDeserialize_connack(&sessionPresent, &connack_rc, buf, buflen) == 1) { + MQTTStringFormat_connack(strbuf, strbuflen, connack_rc, sessionPresent); + } + } + break; + case PUBLISH: { + unsigned char dup, retained, *payload; + unsigned short packetid; + int qos, payloadlen; + MQTTString topicName = MQTTString_initializer; + if (MQTTDeserialize_publish(&dup, &qos, &retained, &packetid, &topicName, + &payload, &payloadlen, buf, buflen) == 1) + MQTTStringFormat_publish(strbuf, strbuflen, dup, qos, retained, packetid, + topicName, payload, payloadlen); + } + break; + case PUBACK: + case PUBREC: + case PUBREL: + case PUBCOMP: { + unsigned char packettype, dup; + unsigned short packetid; + if (MQTTDeserialize_ack(&packettype, &dup, &packetid, buf, buflen) == 1) { + MQTTStringFormat_ack(strbuf, strbuflen, packettype, dup, packetid); + } + } + break; + case SUBACK: { + unsigned short packetid; + int maxcount = 1, count = 0; + int grantedQoSs[1]; + if (MQTTDeserialize_suback(&packetid, maxcount, &count, grantedQoSs, buf, buflen) == 1) { + MQTTStringFormat_suback(strbuf, strbuflen, packetid, count, grantedQoSs); + } + } + break; + case UNSUBACK: { + unsigned short packetid; + if (MQTTDeserialize_unsuback(&packetid, buf, buflen) == 1) { + MQTTStringFormat_ack(strbuf, strbuflen, UNSUBACK, 0, packetid); + } + } + break; + case PINGREQ: + case PINGRESP: + case DISCONNECT: + snprintf(strbuf, strbuflen, "%s", MQTTPacket_names[header.bits.type]); + break; + } + return strbuf; +} + + +char* MQTTFormat_toServerString(char* strbuf, int strbuflen, unsigned char* buf, int buflen) { + int index = 0; + int rem_length = 0; + MQTTHeader header = {0}; + + header.byte = buf[index++]; + index += MQTTPacket_decodeBuf(&buf[index], &rem_length); + + switch (header.bits.type) { + case CONNECT: { + MQTTPacket_connectData data; + int rc; + if ((rc = MQTTDeserialize_connect(&data, buf, buflen)) == 1) { + MQTTStringFormat_connect(strbuf, strbuflen, &data); + } + } + break; + case PUBLISH: { + unsigned char dup, retained, *payload; + unsigned short packetid; + int qos, payloadlen; + MQTTString topicName = MQTTString_initializer; + if (MQTTDeserialize_publish(&dup, &qos, &retained, &packetid, &topicName, + &payload, &payloadlen, buf, buflen) == 1) + MQTTStringFormat_publish(strbuf, strbuflen, dup, qos, retained, packetid, + topicName, payload, payloadlen); + } + break; + case PUBACK: + case PUBREC: + case PUBREL: + case PUBCOMP: { + unsigned char packettype, dup; + unsigned short packetid; + if (MQTTDeserialize_ack(&packettype, &dup, &packetid, buf, buflen) == 1) { + MQTTStringFormat_ack(strbuf, strbuflen, packettype, dup, packetid); + } + } + break; + case SUBSCRIBE: { + unsigned char dup; + unsigned short packetid; + int maxcount = 1, count = 0; + MQTTString topicFilters[1]; + int requestedQoSs[1]; + if (MQTTDeserialize_subscribe(&dup, &packetid, maxcount, &count, + topicFilters, requestedQoSs, buf, buflen) == 1) { + MQTTStringFormat_subscribe(strbuf, strbuflen, dup, packetid, count, topicFilters, requestedQoSs); + }; + } + break; + case UNSUBSCRIBE: { + unsigned char dup; + unsigned short packetid; + int maxcount = 1, count = 0; + MQTTString topicFilters[1]; + if (MQTTDeserialize_unsubscribe(&dup, &packetid, maxcount, &count, topicFilters, buf, buflen) == 1) { + MQTTStringFormat_unsubscribe(strbuf, strbuflen, dup, packetid, count, topicFilters); + } + } + break; + case PINGREQ: + case PINGRESP: + case DISCONNECT: + snprintf(strbuf, strbuflen, "%s", MQTTPacket_names[header.bits.type]); + break; + } + strbuf[strbuflen] = '\0'; + return strbuf; +} diff --git a/Internet/MQTT/MQTTPacket/src/MQTTFormat.h b/Internet/MQTT/MQTTPacket/src/MQTTFormat.h new file mode 100644 index 0000000..a6f8fe5 --- /dev/null +++ b/Internet/MQTT/MQTTPacket/src/MQTTFormat.h @@ -0,0 +1,37 @@ +/******************************************************************************* + Copyright (c) 2014 IBM Corp. + + All rights reserved. This program and the accompanying materials + are made available under the terms of the Eclipse Public License v1.0 + and Eclipse Distribution License v1.0 which accompany this distribution. + + The Eclipse Public License is available at + http://www.eclipse.org/legal/epl-v10.html + and the Eclipse Distribution License is available at + http://www.eclipse.org/org/documents/edl-v10.php. + + Contributors: + Ian Craggs - initial API and implementation and/or initial documentation + *******************************************************************************/ + +#if !defined(MQTTFORMAT_H) +#define MQTTFORMAT_H + +#include "StackTrace.h" +#include "MQTTPacket.h" + +const char* MQTTPacket_getName(unsigned short packetid); +int MQTTStringFormat_connect(char* strbuf, int strbuflen, MQTTPacket_connectData* data); +int MQTTStringFormat_connack(char* strbuf, int strbuflen, unsigned char connack_rc, unsigned char sessionPresent); +int MQTTStringFormat_publish(char* strbuf, int strbuflen, unsigned char dup, int qos, unsigned char retained, + unsigned short packetid, MQTTString topicName, unsigned char* payload, int payloadlen); +int MQTTStringFormat_ack(char* strbuf, int strbuflen, unsigned char packettype, unsigned char dup, unsigned short packetid); +int MQTTStringFormat_subscribe(char* strbuf, int strbuflen, unsigned char dup, unsigned short packetid, int count, + MQTTString topicFilters[], int requestedQoSs[]); +int MQTTStringFormat_suback(char* strbuf, int strbuflen, unsigned short packetid, int count, int* grantedQoSs); +int MQTTStringFormat_unsubscribe(char* strbuf, int strbuflen, unsigned char dup, unsigned short packetid, + int count, MQTTString topicFilters[]); +char* MQTTFormat_toClientString(char* strbuf, int strbuflen, unsigned char* buf, int buflen); +char* MQTTFormat_toServerString(char* strbuf, int strbuflen, unsigned char* buf, int buflen); + +#endif diff --git a/Internet/MQTT/MQTTPacket/src/MQTTPacket.c b/Internet/MQTT/MQTTPacket/src/MQTTPacket.c new file mode 100644 index 0000000..b1fdfee --- /dev/null +++ b/Internet/MQTT/MQTTPacket/src/MQTTPacket.c @@ -0,0 +1,401 @@ +/******************************************************************************* + Copyright (c) 2014 IBM Corp. + + All rights reserved. This program and the accompanying materials + are made available under the terms of the Eclipse Public License v1.0 + and Eclipse Distribution License v1.0 which accompany this distribution. + + The Eclipse Public License is available at + http://www.eclipse.org/legal/epl-v10.html + and the Eclipse Distribution License is available at + http://www.eclipse.org/org/documents/edl-v10.php. + + Contributors: + Ian Craggs - initial API and implementation and/or initial documentation + Sergio R. Caprile - non-blocking packet read functions for stream transport + *******************************************************************************/ + +#include "StackTrace.h" +#include "MQTTPacket.h" + +#include + +/** + Encodes the message length according to the MQTT algorithm + @param buf the buffer into which the encoded data is written + @param length the length to be encoded + @return the number of bytes written to buffer +*/ +int MQTTPacket_encode(unsigned char* buf, int length) { + int rc = 0; + + FUNC_ENTRY; + do { + char d = length % 128; + length /= 128; + /* if there are more digits to encode, set the top bit of this digit */ + if (length > 0) { + d |= 0x80; + } + buf[rc++] = d; + } while (length > 0); + FUNC_EXIT_RC(rc); + return rc; +} + + +/** + Decodes the message length according to the MQTT algorithm + @param getcharfn pointer to function to read the next character from the data source + @param value the decoded length returned + @return the number of bytes read from the socket +*/ +int MQTTPacket_decode(int (*getcharfn)(unsigned char*, int), int* value) { + unsigned char c; + int multiplier = 1; + int len = 0; +#define MAX_NO_OF_REMAINING_LENGTH_BYTES 4 + + FUNC_ENTRY; + *value = 0; + do { + int rc = MQTTPACKET_READ_ERROR; + + if (++len > MAX_NO_OF_REMAINING_LENGTH_BYTES) { + rc = MQTTPACKET_READ_ERROR; /* bad data */ + goto exit; + } + rc = (*getcharfn)(&c, 1); + if (rc != 1) { + goto exit; + } + *value += (c & 127) * multiplier; + multiplier *= 128; + } while ((c & 128) != 0); +exit: + FUNC_EXIT_RC(len); + return len; +} + + +int MQTTPacket_len(int rem_len) { + rem_len += 1; /* header byte */ + + /* now remaining_length field */ + if (rem_len < 128) { + rem_len += 1; + } else if (rem_len < 16384) { + rem_len += 2; + } else if (rem_len < 2097151) { + rem_len += 3; + } else { + rem_len += 4; + } + return rem_len; +} + + +static unsigned char* bufptr; + +int bufchar(unsigned char* c, int count) { + int i; + + for (i = 0; i < count; ++i) { + *c = *bufptr++; + } + return count; +} + + +int MQTTPacket_decodeBuf(unsigned char* buf, int* value) { + bufptr = buf; + return MQTTPacket_decode(bufchar, value); +} + + +/** + Calculates an integer from two bytes read from the input buffer + @param pptr pointer to the input buffer - incremented by the number of bytes used & returned + @return the integer value calculated +*/ +int readInt(unsigned char** pptr) { + unsigned char* ptr = *pptr; + int len = 256 * (*ptr) + (*(ptr + 1)); + *pptr += 2; + return len; +} + + +/** + Reads one character from the input buffer. + @param pptr pointer to the input buffer - incremented by the number of bytes used & returned + @return the character read +*/ +char readChar(unsigned char** pptr) { + char c = **pptr; + (*pptr)++; + return c; +} + + +/** + Writes one character to an output buffer. + @param pptr pointer to the output buffer - incremented by the number of bytes used & returned + @param c the character to write +*/ +void writeChar(unsigned char** pptr, char c) { + **pptr = c; + (*pptr)++; +} + + +/** + Writes an integer as 2 bytes to an output buffer. + @param pptr pointer to the output buffer - incremented by the number of bytes used & returned + @param anInt the integer to write +*/ +void writeInt(unsigned char** pptr, int anInt) { + **pptr = (unsigned char)(anInt / 256); + (*pptr)++; + **pptr = (unsigned char)(anInt % 256); + (*pptr)++; +} + + +/** + Writes a "UTF" string to an output buffer. Converts C string to length-delimited. + @param pptr pointer to the output buffer - incremented by the number of bytes used & returned + @param string the C string to write +*/ +void writeCString(unsigned char** pptr, const char* string) { + int len = strlen(string); + writeInt(pptr, len); + memcpy(*pptr, string, len); + *pptr += len; +} + + +int getLenStringLen(char* ptr) { + int len = 256 * ((unsigned char)(*ptr)) + (unsigned char)(*(ptr + 1)); + return len; +} + + +void writeMQTTString(unsigned char** pptr, MQTTString mqttstring) { + if (mqttstring.lenstring.len > 0) { + writeInt(pptr, mqttstring.lenstring.len); + memcpy(*pptr, mqttstring.lenstring.data, mqttstring.lenstring.len); + *pptr += mqttstring.lenstring.len; + } else if (mqttstring.cstring) { + writeCString(pptr, mqttstring.cstring); + } else { + writeInt(pptr, 0); + } +} + + +/** + @param mqttstring the MQTTString structure into which the data is to be read + @param pptr pointer to the output buffer - incremented by the number of bytes used & returned + @param enddata pointer to the end of the data: do not read beyond + @return 1 if successful, 0 if not +*/ +int readMQTTLenString(MQTTString* mqttstring, unsigned char** pptr, unsigned char* enddata) { + int rc = 0; + + FUNC_ENTRY; + /* the first two bytes are the length of the string */ + if (enddata - (*pptr) > 1) { /* enough length to read the integer? */ + mqttstring->lenstring.len = readInt(pptr); /* increments pptr to point past length */ + if (&(*pptr)[mqttstring->lenstring.len] <= enddata) { + mqttstring->lenstring.data = (char*)*pptr; + *pptr += mqttstring->lenstring.len; + rc = 1; + } + } + mqttstring->cstring = NULL; + FUNC_EXIT_RC(rc); + return rc; +} + + +/** + Return the length of the MQTTstring - C string if there is one, otherwise the length delimited string + @param mqttstring the string to return the length of + @return the length of the string +*/ +int MQTTstrlen(MQTTString mqttstring) { + int rc = 0; + + if (mqttstring.cstring) { + rc = strlen(mqttstring.cstring); + } else { + rc = mqttstring.lenstring.len; + } + return rc; +} + + +/** + Compares an MQTTString to a C string + @param a the MQTTString to compare + @param bptr the C string to compare + @return boolean - equal or not +*/ +int MQTTPacket_equals(MQTTString* a, char* bptr) { + int alen = 0, + blen = 0; + char *aptr; + + if (a->cstring) { + aptr = a->cstring; + alen = strlen(a->cstring); + } else { + aptr = a->lenstring.data; + alen = a->lenstring.len; + } + blen = strlen(bptr); + + return (alen == blen) && (strncmp(aptr, bptr, alen) == 0); +} + + +/** + Helper function to read packet data from some source into a buffer + @param buf the buffer into which the packet will be serialized + @param buflen the length in bytes of the supplied buffer + @param getfn pointer to a function which will read any number of bytes from the needed source + @return integer MQTT packet type, or -1 on error + @note the whole message must fit into the caller's buffer +*/ +int MQTTPacket_read(unsigned char* buf, int buflen, int (*getfn)(unsigned char*, int)) { + int rc = -1; + MQTTHeader header = {0}; + int len = 0; + int rem_len = 0; + + /* 1. read the header byte. This has the packet type in it */ + if ((*getfn)(buf, 1) != 1) { + goto exit; + } + + len = 1; + /* 2. read the remaining length. This is variable in itself */ + MQTTPacket_decode(getfn, &rem_len); + len += MQTTPacket_encode(buf + 1, rem_len); /* put the original remaining length back into the buffer */ + + /* 3. read the rest of the buffer using a callback to supply the rest of the data */ + if ((rem_len + len) > buflen) { + goto exit; + } + if ((*getfn)(buf + len, rem_len) != rem_len) { + goto exit; + } + + header.byte = buf[0]; + rc = header.bits.type; +exit: + return rc; +} + +/** + Decodes the message length according to the MQTT algorithm, non-blocking + @param trp pointer to a transport structure holding what is needed to solve getting data from it + @param value the decoded length returned + @return integer the number of bytes read from the socket, 0 for call again, or -1 on error +*/ +static int MQTTPacket_decodenb(MQTTTransport *trp) { + unsigned char c; + int rc = MQTTPACKET_READ_ERROR; + + FUNC_ENTRY; + if (trp->len == 0) { /* initialize on first call */ + trp->multiplier = 1; + trp->rem_len = 0; + } + do { + int frc; + if (++(trp->len) > MAX_NO_OF_REMAINING_LENGTH_BYTES) { + goto exit; + } + if ((frc = (*trp->getfn)(trp->sck, &c, 1)) == -1) { + goto exit; + } + if (frc == 0) { + rc = 0; + goto exit; + } + trp->rem_len += (c & 127) * trp->multiplier; + trp->multiplier *= 128; + } while ((c & 128) != 0); + rc = trp->len; +exit: + FUNC_EXIT_RC(rc); + return rc; +} + +/** + Helper function to read packet data from some source into a buffer, non-blocking + @param buf the buffer into which the packet will be serialized + @param buflen the length in bytes of the supplied buffer + @param trp pointer to a transport structure holding what is needed to solve getting data from it + @return integer MQTT packet type, 0 for call again, or -1 on error + @note the whole message must fit into the caller's buffer +*/ +int MQTTPacket_readnb(unsigned char* buf, int buflen, MQTTTransport *trp) { + int rc = -1, frc; + MQTTHeader header = {0}; + + switch (trp->state) { + default: + trp->state = 0; + /*FALLTHROUGH*/ + case 0: + /* read the header byte. This has the packet type in it */ + if ((frc = (*trp->getfn)(trp->sck, buf, 1)) == -1) { + goto exit; + } + if (frc == 0) { + return 0; + } + trp->len = 0; + ++trp->state; + /*FALLTHROUGH*/ + /* read the remaining length. This is variable in itself */ + case 1: + if ((frc = MQTTPacket_decodenb(trp)) == MQTTPACKET_READ_ERROR) { + goto exit; + } + if (frc == 0) { + return 0; + } + trp->len = 1 + MQTTPacket_encode(buf + 1, trp->rem_len); /* put the original remaining length back into the buffer */ + if ((trp->rem_len + trp->len) > buflen) { + goto exit; + } + ++trp->state; + /*FALLTHROUGH*/ + case 2: + /* read the rest of the buffer using a callback to supply the rest of the data */ + if ((frc = (*trp->getfn)(trp->sck, buf + trp->len, trp->rem_len)) == -1) { + goto exit; + } + if (frc == 0) { + return 0; + } + trp->rem_len -= frc; + trp->len += frc; + if (trp->rem_len) { + return 0; + } + + header.byte = buf[0]; + rc = header.bits.type; + break; + } + +exit: + trp->state = 0; + return rc; +} + diff --git a/Internet/MQTT/MQTTPacket/src/MQTTPacket.h b/Internet/MQTT/MQTTPacket/src/MQTTPacket.h new file mode 100644 index 0000000..b83598b --- /dev/null +++ b/Internet/MQTT/MQTTPacket/src/MQTTPacket.h @@ -0,0 +1,126 @@ +/******************************************************************************* + Copyright (c) 2014 IBM Corp. + + All rights reserved. This program and the accompanying materials + are made available under the terms of the Eclipse Public License v1.0 + and Eclipse Distribution License v1.0 which accompany this distribution. + + The Eclipse Public License is available at + http://www.eclipse.org/legal/epl-v10.html + and the Eclipse Distribution License is available at + http://www.eclipse.org/org/documents/edl-v10.php. + + Contributors: + Ian Craggs - initial API and implementation and/or initial documentation + Xiang Rong - 442039 Add makefile to Embedded C client + *******************************************************************************/ + +#ifndef MQTTPACKET_H_ +#define MQTTPACKET_H_ + +#if defined(__cplusplus) /* If this is a C++ compiler, use C linkage */ +extern "C" { +#endif + +#if defined(WIN32_DLL) || defined(WIN64_DLL) +#define DLLImport __declspec(dllimport) +#define DLLExport __declspec(dllexport) +#elif defined(LINUX_SO) +#define DLLImport extern +#define DLLExport __attribute__ ((visibility ("default"))) +#else +#define DLLImport +#define DLLExport +#endif + +enum errors { + MQTTPACKET_BUFFER_TOO_SHORT = -2, + MQTTPACKET_READ_ERROR = -1, + MQTTPACKET_READ_COMPLETE +}; + +enum msgTypes { + CONNECT = 1, CONNACK, PUBLISH, PUBACK, PUBREC, PUBREL, + PUBCOMP, SUBSCRIBE, SUBACK, UNSUBSCRIBE, UNSUBACK, + PINGREQ, PINGRESP, DISCONNECT +}; + +/** + Bitfields for the MQTT header byte. +*/ +typedef union { + unsigned char byte; /**< the whole byte */ +#if defined(REVERSED) + struct { + unsigned int type : 4; /**< message type nibble */ + unsigned int dup : 1; /**< DUP flag bit */ + unsigned int qos : 2; /**< QoS value, 0, 1 or 2 */ + unsigned int retain : 1; /**< retained flag bit */ + } bits; +#else + struct { + unsigned int retain : 1; /**< retained flag bit */ + unsigned int qos : 2; /**< QoS value, 0, 1 or 2 */ + unsigned int dup : 1; /**< DUP flag bit */ + unsigned int type : 4; /**< message type nibble */ + } bits; +#endif +} MQTTHeader; + +typedef struct { + int len; + char* data; +} MQTTLenString; + +typedef struct { + char* cstring; + MQTTLenString lenstring; +} MQTTString; + +#define MQTTString_initializer {NULL, {0, NULL}} + +int MQTTstrlen(MQTTString mqttstring); + +#include "MQTTConnect.h" +#include "MQTTPublish.h" +#include "MQTTSubscribe.h" +#include "MQTTUnsubscribe.h" +#include "MQTTFormat.h" + +int MQTTSerialize_ack(unsigned char* buf, int buflen, unsigned char type, unsigned char dup, unsigned short packetid); +int MQTTDeserialize_ack(unsigned char* packettype, unsigned char* dup, unsigned short* packetid, unsigned char* buf, int buflen); + +int MQTTPacket_len(int rem_len); +int MQTTPacket_equals(MQTTString* a, char* b); + +int MQTTPacket_encode(unsigned char* buf, int length); +int MQTTPacket_decode(int (*getcharfn)(unsigned char*, int), int* value); +int MQTTPacket_decodeBuf(unsigned char* buf, int* value); + +int readInt(unsigned char** pptr); +char readChar(unsigned char** pptr); +void writeChar(unsigned char** pptr, char c); +void writeInt(unsigned char** pptr, int anInt); +int readMQTTLenString(MQTTString* mqttstring, unsigned char** pptr, unsigned char* enddata); +void writeCString(unsigned char** pptr, const char* string); +void writeMQTTString(unsigned char** pptr, MQTTString mqttstring); + +DLLExport int MQTTPacket_read(unsigned char* buf, int buflen, int (*getfn)(unsigned char*, int)); + +typedef struct { + int (*getfn)(void *, unsigned char*, int); /* must return -1 for error, 0 for call again, or the number of bytes read */ + void *sck; /* pointer to whatever the system may use to identify the transport */ + int multiplier; + int rem_len; + int len; + char state; +} MQTTTransport; + +int MQTTPacket_readnb(unsigned char* buf, int buflen, MQTTTransport *trp); + +#ifdef __cplusplus /* If this is a C++ compiler, use C linkage */ +} +#endif + + +#endif /* MQTTPACKET_H_ */ diff --git a/Internet/MQTT/MQTTPacket/src/MQTTPublish.h b/Internet/MQTT/MQTTPacket/src/MQTTPublish.h new file mode 100644 index 0000000..867321d --- /dev/null +++ b/Internet/MQTT/MQTTPacket/src/MQTTPublish.h @@ -0,0 +1,38 @@ +/******************************************************************************* + Copyright (c) 2014 IBM Corp. + + All rights reserved. This program and the accompanying materials + are made available under the terms of the Eclipse Public License v1.0 + and Eclipse Distribution License v1.0 which accompany this distribution. + + The Eclipse Public License is available at + http://www.eclipse.org/legal/epl-v10.html + and the Eclipse Distribution License is available at + http://www.eclipse.org/org/documents/edl-v10.php. + + Contributors: + Ian Craggs - initial API and implementation and/or initial documentation + Xiang Rong - 442039 Add makefile to Embedded C client + *******************************************************************************/ + +#ifndef MQTTPUBLISH_H_ +#define MQTTPUBLISH_H_ + +#if !defined(DLLImport) +#define DLLImport +#endif +#if !defined(DLLExport) +#define DLLExport +#endif + +DLLExport int MQTTSerialize_publish(unsigned char* buf, int buflen, unsigned char dup, int qos, unsigned char retained, unsigned short packetid, + MQTTString topicName, unsigned char* payload, int payloadlen); + +DLLExport int MQTTDeserialize_publish(unsigned char* dup, int* qos, unsigned char* retained, unsigned short* packetid, MQTTString* topicName, + unsigned char** payload, int* payloadlen, unsigned char* buf, int len); + +DLLExport int MQTTSerialize_puback(unsigned char* buf, int buflen, unsigned short packetid); +DLLExport int MQTTSerialize_pubrel(unsigned char* buf, int buflen, unsigned char dup, unsigned short packetid); +DLLExport int MQTTSerialize_pubcomp(unsigned char* buf, int buflen, unsigned short packetid); + +#endif /* MQTTPUBLISH_H_ */ diff --git a/Internet/MQTT/MQTTPacket/src/MQTTSerializePublish.c b/Internet/MQTT/MQTTPacket/src/MQTTSerializePublish.c new file mode 100644 index 0000000..9f18007 --- /dev/null +++ b/Internet/MQTT/MQTTPacket/src/MQTTSerializePublish.c @@ -0,0 +1,163 @@ +/******************************************************************************* + Copyright (c) 2014 IBM Corp. + + All rights reserved. This program and the accompanying materials + are made available under the terms of the Eclipse Public License v1.0 + and Eclipse Distribution License v1.0 which accompany this distribution. + + The Eclipse Public License is available at + http://www.eclipse.org/legal/epl-v10.html + and the Eclipse Distribution License is available at + http://www.eclipse.org/org/documents/edl-v10.php. + + Contributors: + Ian Craggs - initial API and implementation and/or initial documentation + Ian Craggs - fix for https://bugs.eclipse.org/bugs/show_bug.cgi?id=453144 + *******************************************************************************/ + +#include "MQTTPacket.h" +#include "StackTrace.h" + +#include + + +/** + Determines the length of the MQTT publish packet that would be produced using the supplied parameters + @param qos the MQTT QoS of the publish (packetid is omitted for QoS 0) + @param topicName the topic name to be used in the publish + @param payloadlen the length of the payload to be sent + @return the length of buffer needed to contain the serialized version of the packet +*/ +int MQTTSerialize_publishLength(int qos, MQTTString topicName, int payloadlen) { + int len = 0; + + len += 2 + MQTTstrlen(topicName) + payloadlen; + if (qos > 0) { + len += 2; /* packetid */ + } + return len; +} + + +/** + Serializes the supplied publish data into the supplied buffer, ready for sending + @param buf the buffer into which the packet will be serialized + @param buflen the length in bytes of the supplied buffer + @param dup integer - the MQTT dup flag + @param qos integer - the MQTT QoS value + @param retained integer - the MQTT retained flag + @param packetid integer - the MQTT packet identifier + @param topicName MQTTString - the MQTT topic in the publish + @param payload byte buffer - the MQTT publish payload + @param payloadlen integer - the length of the MQTT payload + @return the length of the serialized data. <= 0 indicates error +*/ +int MQTTSerialize_publish(unsigned char* buf, int buflen, unsigned char dup, int qos, unsigned char retained, unsigned short packetid, + MQTTString topicName, unsigned char* payload, int payloadlen) { + unsigned char *ptr = buf; + MQTTHeader header = {0}; + int rem_len = 0; + int rc = 0; + + FUNC_ENTRY; + if (MQTTPacket_len(rem_len = MQTTSerialize_publishLength(qos, topicName, payloadlen)) > buflen) { + rc = MQTTPACKET_BUFFER_TOO_SHORT; + goto exit; + } + + header.bits.type = PUBLISH; + header.bits.dup = dup; + header.bits.qos = qos; + header.bits.retain = retained; + writeChar(&ptr, header.byte); /* write header */ + + ptr += MQTTPacket_encode(ptr, rem_len); /* write remaining length */; + + writeMQTTString(&ptr, topicName); + + if (qos > 0) { + writeInt(&ptr, packetid); + } + + memcpy(ptr, payload, payloadlen); + ptr += payloadlen; + + rc = ptr - buf; + +exit: + FUNC_EXIT_RC(rc); + return rc; +} + + + +/** + Serializes the ack packet into the supplied buffer. + @param buf the buffer into which the packet will be serialized + @param buflen the length in bytes of the supplied buffer + @param type the MQTT packet type + @param dup the MQTT dup flag + @param packetid the MQTT packet identifier + @return serialized length, or error if 0 +*/ +int MQTTSerialize_ack(unsigned char* buf, int buflen, unsigned char packettype, unsigned char dup, unsigned short packetid) { + MQTTHeader header = {0}; + int rc = 0; + unsigned char *ptr = buf; + + FUNC_ENTRY; + if (buflen < 4) { + rc = MQTTPACKET_BUFFER_TOO_SHORT; + goto exit; + } + header.bits.type = packettype; + header.bits.dup = dup; + header.bits.qos = (packettype == PUBREL) ? 1 : 0; + writeChar(&ptr, header.byte); /* write header */ + + ptr += MQTTPacket_encode(ptr, 2); /* write remaining length */ + writeInt(&ptr, packetid); + rc = ptr - buf; +exit: + FUNC_EXIT_RC(rc); + return rc; +} + + +/** + Serializes a puback packet into the supplied buffer. + @param buf the buffer into which the packet will be serialized + @param buflen the length in bytes of the supplied buffer + @param packetid integer - the MQTT packet identifier + @return serialized length, or error if 0 +*/ +int MQTTSerialize_puback(unsigned char* buf, int buflen, unsigned short packetid) { + return MQTTSerialize_ack(buf, buflen, PUBACK, 0, packetid); +} + + +/** + Serializes a pubrel packet into the supplied buffer. + @param buf the buffer into which the packet will be serialized + @param buflen the length in bytes of the supplied buffer + @param dup integer - the MQTT dup flag + @param packetid integer - the MQTT packet identifier + @return serialized length, or error if 0 +*/ +int MQTTSerialize_pubrel(unsigned char* buf, int buflen, unsigned char dup, unsigned short packetid) { + return MQTTSerialize_ack(buf, buflen, PUBREL, dup, packetid); +} + + +/** + Serializes a pubrel packet into the supplied buffer. + @param buf the buffer into which the packet will be serialized + @param buflen the length in bytes of the supplied buffer + @param packetid integer - the MQTT packet identifier + @return serialized length, or error if 0 +*/ +int MQTTSerialize_pubcomp(unsigned char* buf, int buflen, unsigned short packetid) { + return MQTTSerialize_ack(buf, buflen, PUBCOMP, 0, packetid); +} + + diff --git a/Internet/MQTT/MQTTPacket/src/MQTTSubscribe.h b/Internet/MQTT/MQTTPacket/src/MQTTSubscribe.h new file mode 100644 index 0000000..3c851ca --- /dev/null +++ b/Internet/MQTT/MQTTPacket/src/MQTTSubscribe.h @@ -0,0 +1,39 @@ +/******************************************************************************* + Copyright (c) 2014 IBM Corp. + + All rights reserved. This program and the accompanying materials + are made available under the terms of the Eclipse Public License v1.0 + and Eclipse Distribution License v1.0 which accompany this distribution. + + The Eclipse Public License is available at + http://www.eclipse.org/legal/epl-v10.html + and the Eclipse Distribution License is available at + http://www.eclipse.org/org/documents/edl-v10.php. + + Contributors: + Ian Craggs - initial API and implementation and/or initial documentation + Xiang Rong - 442039 Add makefile to Embedded C client + *******************************************************************************/ + +#ifndef MQTTSUBSCRIBE_H_ +#define MQTTSUBSCRIBE_H_ + +#if !defined(DLLImport) +#define DLLImport +#endif +#if !defined(DLLExport) +#define DLLExport +#endif + +DLLExport int MQTTSerialize_subscribe(unsigned char* buf, int buflen, unsigned char dup, unsigned short packetid, + int count, MQTTString topicFilters[], char requestedQoSs[]); + +DLLExport int MQTTDeserialize_subscribe(unsigned char* dup, unsigned short* packetid, + int maxcount, int* count, MQTTString topicFilters[], int requestedQoSs[], unsigned char* buf, int len); + +DLLExport int MQTTSerialize_suback(unsigned char* buf, int buflen, unsigned short packetid, int count, int* grantedQoSs); + +DLLExport int MQTTDeserialize_suback(unsigned short* packetid, int maxcount, int* count, int grantedQoSs[], unsigned char* buf, int len); + + +#endif /* MQTTSUBSCRIBE_H_ */ diff --git a/Internet/MQTT/MQTTPacket/src/MQTTSubscribeClient.c b/Internet/MQTT/MQTTPacket/src/MQTTSubscribeClient.c new file mode 100644 index 0000000..24124d9 --- /dev/null +++ b/Internet/MQTT/MQTTPacket/src/MQTTSubscribeClient.c @@ -0,0 +1,133 @@ +/******************************************************************************* + Copyright (c) 2014 IBM Corp. + + All rights reserved. This program and the accompanying materials + are made available under the terms of the Eclipse Public License v1.0 + and Eclipse Distribution License v1.0 which accompany this distribution. + + The Eclipse Public License is available at + http://www.eclipse.org/legal/epl-v10.html + and the Eclipse Distribution License is available at + http://www.eclipse.org/org/documents/edl-v10.php. + + Contributors: + Ian Craggs - initial API and implementation and/or initial documentation + *******************************************************************************/ + +#include "MQTTPacket.h" +#include "StackTrace.h" + +#include + +/** + Determines the length of the MQTT subscribe packet that would be produced using the supplied parameters + @param count the number of topic filter strings in topicFilters + @param topicFilters the array of topic filter strings to be used in the publish + @return the length of buffer needed to contain the serialized version of the packet +*/ +int MQTTSerialize_subscribeLength(int count, MQTTString topicFilters[]) { + int i; + int len = 2; /* packetid */ + + for (i = 0; i < count; ++i) { + len += 2 + MQTTstrlen(topicFilters[i]) + 1; /* length + topic + req_qos */ + } + return len; +} + + +/** + Serializes the supplied subscribe data into the supplied buffer, ready for sending + @param buf the buffer into which the packet will be serialized + @param buflen the length in bytes of the supplied bufferr + @param dup integer - the MQTT dup flag + @param packetid integer - the MQTT packet identifier + @param count - number of members in the topicFilters and reqQos arrays + @param topicFilters - array of topic filter names + @param requestedQoSs - array of requested QoS + @return the length of the serialized data. <= 0 indicates error +*/ +int MQTTSerialize_subscribe(unsigned char* buf, int buflen, unsigned char dup, unsigned short packetid, int count, + MQTTString topicFilters[], char requestedQoSs[]) { + unsigned char *ptr = buf; + MQTTHeader header = {0}; + int rem_len = 0; + int rc = 0; + int i = 0; + + FUNC_ENTRY; + if (MQTTPacket_len(rem_len = MQTTSerialize_subscribeLength(count, topicFilters)) > buflen) { + rc = MQTTPACKET_BUFFER_TOO_SHORT; + goto exit; + } + + header.byte = 0; + header.bits.type = SUBSCRIBE; + header.bits.dup = dup; + header.bits.qos = 1; + writeChar(&ptr, header.byte); /* write header */ + + ptr += MQTTPacket_encode(ptr, rem_len); /* write remaining length */; + + writeInt(&ptr, packetid); + + for (i = 0; i < count; ++i) { + writeMQTTString(&ptr, topicFilters[i]); + writeChar(&ptr, requestedQoSs[i]); + } + + rc = ptr - buf; +exit: + FUNC_EXIT_RC(rc); + return rc; +} + + + +/** + Deserializes the supplied (wire) buffer into suback data + @param packetid returned integer - the MQTT packet identifier + @param maxcount - the maximum number of members allowed in the grantedQoSs array + @param count returned integer - number of members in the grantedQoSs array + @param grantedQoSs returned array of integers - the granted qualities of service + @param buf the raw buffer data, of the correct length determined by the remaining length field + @param buflen the length in bytes of the data in the supplied buffer + @return error code. 1 is success, 0 is failure +*/ +int MQTTDeserialize_suback(unsigned short* packetid, int maxcount, int* count, int grantedQoSs[], unsigned char* buf, int buflen) { + MQTTHeader header = {0}; + unsigned char* curdata = buf; + unsigned char* enddata = NULL; + int rc = 0; + int mylen; + + FUNC_ENTRY; + header.byte = readChar(&curdata); + if (header.bits.type != SUBACK) { + goto exit; + } + + curdata += (rc = MQTTPacket_decodeBuf(curdata, &mylen)); /* read remaining length */ + enddata = curdata + mylen; + if (enddata - curdata < 2) { + goto exit; + } + + *packetid = readInt(&curdata); + + *count = 0; + while (curdata < enddata) { + if (*count > maxcount) { + rc = -1; + goto exit; + } + grantedQoSs[(*count)++] = readChar(&curdata); + } + + rc = 1; +exit: + FUNC_EXIT_RC(rc); + return rc; +} + + diff --git a/Internet/MQTT/MQTTPacket/src/MQTTSubscribeServer.c b/Internet/MQTT/MQTTPacket/src/MQTTSubscribeServer.c new file mode 100644 index 0000000..789952d --- /dev/null +++ b/Internet/MQTT/MQTTPacket/src/MQTTSubscribeServer.c @@ -0,0 +1,112 @@ +/******************************************************************************* + Copyright (c) 2014 IBM Corp. + + All rights reserved. This program and the accompanying materials + are made available under the terms of the Eclipse Public License v1.0 + and Eclipse Distribution License v1.0 which accompany this distribution. + + The Eclipse Public License is available at + http://www.eclipse.org/legal/epl-v10.html + and the Eclipse Distribution License is available at + http://www.eclipse.org/org/documents/edl-v10.php. + + Contributors: + Ian Craggs - initial API and implementation and/or initial documentation + *******************************************************************************/ + +#include "MQTTPacket.h" +#include "StackTrace.h" + +#include + + +/** + Deserializes the supplied (wire) buffer into subscribe data + @param dup integer returned - the MQTT dup flag + @param packetid integer returned - the MQTT packet identifier + @param maxcount - the maximum number of members allowed in the topicFilters and requestedQoSs arrays + @param count - number of members in the topicFilters and requestedQoSs arrays + @param topicFilters - array of topic filter names + @param requestedQoSs - array of requested QoS + @param buf the raw buffer data, of the correct length determined by the remaining length field + @param buflen the length in bytes of the data in the supplied buffer + @return the length of the serialized data. <= 0 indicates error +*/ +int MQTTDeserialize_subscribe(unsigned char* dup, unsigned short* packetid, int maxcount, int* count, MQTTString topicFilters[], + int requestedQoSs[], unsigned char* buf, int buflen) { + MQTTHeader header = {0}; + unsigned char* curdata = buf; + unsigned char* enddata = NULL; + int rc = -1; + int mylen = 0; + + FUNC_ENTRY; + header.byte = readChar(&curdata); + if (header.bits.type != SUBSCRIBE) { + goto exit; + } + *dup = header.bits.dup; + + curdata += (rc = MQTTPacket_decodeBuf(curdata, &mylen)); /* read remaining length */ + enddata = curdata + mylen; + + *packetid = readInt(&curdata); + + *count = 0; + while (curdata < enddata) { + if (!readMQTTLenString(&topicFilters[*count], &curdata, enddata)) { + goto exit; + } + if (curdata >= enddata) { /* do we have enough data to read the req_qos version byte? */ + goto exit; + } + requestedQoSs[*count] = readChar(&curdata); + (*count)++; + } + + rc = 1; +exit: + FUNC_EXIT_RC(rc); + return rc; +} + + +/** + Serializes the supplied suback data into the supplied buffer, ready for sending + @param buf the buffer into which the packet will be serialized + @param buflen the length in bytes of the supplied buffer + @param packetid integer - the MQTT packet identifier + @param count - number of members in the grantedQoSs array + @param grantedQoSs - array of granted QoS + @return the length of the serialized data. <= 0 indicates error +*/ +int MQTTSerialize_suback(unsigned char* buf, int buflen, unsigned short packetid, int count, int* grantedQoSs) { + MQTTHeader header = {0}; + int rc = -1; + unsigned char *ptr = buf; + int i; + + FUNC_ENTRY; + if (buflen < 2 + count) { + rc = MQTTPACKET_BUFFER_TOO_SHORT; + goto exit; + } + header.byte = 0; + header.bits.type = SUBACK; + writeChar(&ptr, header.byte); /* write header */ + + ptr += MQTTPacket_encode(ptr, 2 + count); /* write remaining length */ + + writeInt(&ptr, packetid); + + for (i = 0; i < count; ++i) { + writeChar(&ptr, grantedQoSs[i]); + } + + rc = ptr - buf; +exit: + FUNC_EXIT_RC(rc); + return rc; +} + + diff --git a/Internet/MQTT/MQTTPacket/src/MQTTUnsubscribe.h b/Internet/MQTT/MQTTPacket/src/MQTTUnsubscribe.h new file mode 100644 index 0000000..b32d302 --- /dev/null +++ b/Internet/MQTT/MQTTPacket/src/MQTTUnsubscribe.h @@ -0,0 +1,38 @@ +/******************************************************************************* + Copyright (c) 2014 IBM Corp. + + All rights reserved. This program and the accompanying materials + are made available under the terms of the Eclipse Public License v1.0 + and Eclipse Distribution License v1.0 which accompany this distribution. + + The Eclipse Public License is available at + http://www.eclipse.org/legal/epl-v10.html + and the Eclipse Distribution License is available at + http://www.eclipse.org/org/documents/edl-v10.php. + + Contributors: + Ian Craggs - initial API and implementation and/or initial documentation + Xiang Rong - 442039 Add makefile to Embedded C client + *******************************************************************************/ + +#ifndef MQTTUNSUBSCRIBE_H_ +#define MQTTUNSUBSCRIBE_H_ + +#if !defined(DLLImport) +#define DLLImport +#endif +#if !defined(DLLExport) +#define DLLExport +#endif + +DLLExport int MQTTSerialize_unsubscribe(unsigned char* buf, int buflen, unsigned char dup, unsigned short packetid, + int count, MQTTString topicFilters[]); + +DLLExport int MQTTDeserialize_unsubscribe(unsigned char* dup, unsigned short* packetid, int max_count, int* count, MQTTString topicFilters[], + unsigned char* buf, int len); + +DLLExport int MQTTSerialize_unsuback(unsigned char* buf, int buflen, unsigned short packetid); + +DLLExport int MQTTDeserialize_unsuback(unsigned short* packetid, unsigned char* buf, int len); + +#endif /* MQTTUNSUBSCRIBE_H_ */ diff --git a/Internet/MQTT/MQTTPacket/src/MQTTUnsubscribeClient.c b/Internet/MQTT/MQTTPacket/src/MQTTUnsubscribeClient.c new file mode 100644 index 0000000..4767207 --- /dev/null +++ b/Internet/MQTT/MQTTPacket/src/MQTTUnsubscribeClient.c @@ -0,0 +1,105 @@ +/******************************************************************************* + Copyright (c) 2014 IBM Corp. + + All rights reserved. This program and the accompanying materials + are made available under the terms of the Eclipse Public License v1.0 + and Eclipse Distribution License v1.0 which accompany this distribution. + + The Eclipse Public License is available at + http://www.eclipse.org/legal/epl-v10.html + and the Eclipse Distribution License is available at + http://www.eclipse.org/org/documents/edl-v10.php. + + Contributors: + Ian Craggs - initial API and implementation and/or initial documentation + *******************************************************************************/ + +#include "MQTTPacket.h" +#include "StackTrace.h" + +#include + +/** + Determines the length of the MQTT unsubscribe packet that would be produced using the supplied parameters + @param count the number of topic filter strings in topicFilters + @param topicFilters the array of topic filter strings to be used in the publish + @return the length of buffer needed to contain the serialized version of the packet +*/ +int MQTTSerialize_unsubscribeLength(int count, MQTTString topicFilters[]) { + int i; + int len = 2; /* packetid */ + + for (i = 0; i < count; ++i) { + len += 2 + MQTTstrlen(topicFilters[i]); /* length + topic*/ + } + return len; +} + + +/** + Serializes the supplied unsubscribe data into the supplied buffer, ready for sending + @param buf the raw buffer data, of the correct length determined by the remaining length field + @param buflen the length in bytes of the data in the supplied buffer + @param dup integer - the MQTT dup flag + @param packetid integer - the MQTT packet identifier + @param count - number of members in the topicFilters array + @param topicFilters - array of topic filter names + @return the length of the serialized data. <= 0 indicates error +*/ +int MQTTSerialize_unsubscribe(unsigned char* buf, int buflen, unsigned char dup, unsigned short packetid, + int count, MQTTString topicFilters[]) { + unsigned char *ptr = buf; + MQTTHeader header = {0}; + int rem_len = 0; + int rc = -1; + int i = 0; + + FUNC_ENTRY; + if (MQTTPacket_len(rem_len = MQTTSerialize_unsubscribeLength(count, topicFilters)) > buflen) { + rc = MQTTPACKET_BUFFER_TOO_SHORT; + goto exit; + } + + header.byte = 0; + header.bits.type = UNSUBSCRIBE; + header.bits.dup = dup; + header.bits.qos = 1; + writeChar(&ptr, header.byte); /* write header */ + + ptr += MQTTPacket_encode(ptr, rem_len); /* write remaining length */; + + writeInt(&ptr, packetid); + + for (i = 0; i < count; ++i) { + writeMQTTString(&ptr, topicFilters[i]); + } + + rc = ptr - buf; +exit: + FUNC_EXIT_RC(rc); + return rc; +} + + +/** + Deserializes the supplied (wire) buffer into unsuback data + @param packetid returned integer - the MQTT packet identifier + @param buf the raw buffer data, of the correct length determined by the remaining length field + @param buflen the length in bytes of the data in the supplied buffer + @return error code. 1 is success, 0 is failure +*/ +int MQTTDeserialize_unsuback(unsigned short* packetid, unsigned char* buf, int buflen) { + unsigned char type = 0; + unsigned char dup = 0; + int rc = 0; + + FUNC_ENTRY; + rc = MQTTDeserialize_ack(&type, &dup, packetid, buf, buflen); + if (type == UNSUBACK) { + rc = 1; + } + FUNC_EXIT_RC(rc); + return rc; +} + + diff --git a/Internet/MQTT/MQTTPacket/src/MQTTUnsubscribeServer.c b/Internet/MQTT/MQTTPacket/src/MQTTUnsubscribeServer.c new file mode 100644 index 0000000..207e6ac --- /dev/null +++ b/Internet/MQTT/MQTTPacket/src/MQTTUnsubscribeServer.c @@ -0,0 +1,100 @@ +/******************************************************************************* + Copyright (c) 2014 IBM Corp. + + All rights reserved. This program and the accompanying materials + are made available under the terms of the Eclipse Public License v1.0 + and Eclipse Distribution License v1.0 which accompany this distribution. + + The Eclipse Public License is available at + http://www.eclipse.org/legal/epl-v10.html + and the Eclipse Distribution License is available at + http://www.eclipse.org/org/documents/edl-v10.php. + + Contributors: + Ian Craggs - initial API and implementation and/or initial documentation + *******************************************************************************/ + +#include "MQTTPacket.h" +#include "StackTrace.h" + +#include + + +/** + Deserializes the supplied (wire) buffer into unsubscribe data + @param dup integer returned - the MQTT dup flag + @param packetid integer returned - the MQTT packet identifier + @param maxcount - the maximum number of members allowed in the topicFilters and requestedQoSs arrays + @param count - number of members in the topicFilters and requestedQoSs arrays + @param topicFilters - array of topic filter names + @param buf the raw buffer data, of the correct length determined by the remaining length field + @param buflen the length in bytes of the data in the supplied buffer + @return the length of the serialized data. <= 0 indicates error +*/ +int MQTTDeserialize_unsubscribe(unsigned char* dup, unsigned short* packetid, int maxcount, int* count, MQTTString topicFilters[], + unsigned char* buf, int len) { + MQTTHeader header = {0}; + unsigned char* curdata = buf; + unsigned char* enddata = NULL; + int rc = 0; + int mylen = 0; + + FUNC_ENTRY; + header.byte = readChar(&curdata); + if (header.bits.type != UNSUBSCRIBE) { + goto exit; + } + *dup = header.bits.dup; + + curdata += (rc = MQTTPacket_decodeBuf(curdata, &mylen)); /* read remaining length */ + enddata = curdata + mylen; + + *packetid = readInt(&curdata); + + *count = 0; + while (curdata < enddata) { + if (!readMQTTLenString(&topicFilters[*count], &curdata, enddata)) { + goto exit; + } + (*count)++; + } + + rc = 1; +exit: + FUNC_EXIT_RC(rc); + return rc; +} + + +/** + Serializes the supplied unsuback data into the supplied buffer, ready for sending + @param buf the buffer into which the packet will be serialized + @param buflen the length in bytes of the supplied buffer + @param packetid integer - the MQTT packet identifier + @return the length of the serialized data. <= 0 indicates error +*/ +int MQTTSerialize_unsuback(unsigned char* buf, int buflen, unsigned short packetid) { + MQTTHeader header = {0}; + int rc = 0; + unsigned char *ptr = buf; + + FUNC_ENTRY; + if (buflen < 2) { + rc = MQTTPACKET_BUFFER_TOO_SHORT; + goto exit; + } + header.byte = 0; + header.bits.type = UNSUBACK; + writeChar(&ptr, header.byte); /* write header */ + + ptr += MQTTPacket_encode(ptr, 2); /* write remaining length */ + + writeInt(&ptr, packetid); + + rc = ptr - buf; +exit: + FUNC_EXIT_RC(rc); + return rc; +} + + diff --git a/Internet/MQTT/MQTTPacket/src/StackTrace.h b/Internet/MQTT/MQTTPacket/src/StackTrace.h new file mode 100644 index 0000000..c02daaf --- /dev/null +++ b/Internet/MQTT/MQTTPacket/src/StackTrace.h @@ -0,0 +1,78 @@ +/******************************************************************************* + Copyright (c) 2014 IBM Corp. + + All rights reserved. This program and the accompanying materials + are made available under the terms of the Eclipse Public License v1.0 + and Eclipse Distribution License v1.0 which accompany this distribution. + + The Eclipse Public License is available at + http://www.eclipse.org/legal/epl-v10.html + and the Eclipse Distribution License is available at + http://www.eclipse.org/org/documents/edl-v10.php. + + Contributors: + Ian Craggs - initial API and implementation and/or initial documentation + Ian Craggs - fix for bug #434081 + *******************************************************************************/ + +#ifndef STACKTRACE_H_ +#define STACKTRACE_H_ + +#include +#define NOSTACKTRACE 1 + +#if defined(NOSTACKTRACE) +#define FUNC_ENTRY +#define FUNC_ENTRY_NOLOG +#define FUNC_ENTRY_MED +#define FUNC_ENTRY_MAX +#define FUNC_EXIT +#define FUNC_EXIT_NOLOG +#define FUNC_EXIT_MED +#define FUNC_EXIT_MAX +#define FUNC_EXIT_RC(x) +#define FUNC_EXIT_MED_RC(x) +#define FUNC_EXIT_MAX_RC(x) + +#else + +#if defined(WIN32) +#define inline __inline +#define FUNC_ENTRY StackTrace_entry(__FUNCTION__, __LINE__, TRACE_MINIMUM) +#define FUNC_ENTRY_NOLOG StackTrace_entry(__FUNCTION__, __LINE__, -1) +#define FUNC_ENTRY_MED StackTrace_entry(__FUNCTION__, __LINE__, TRACE_MEDIUM) +#define FUNC_ENTRY_MAX StackTrace_entry(__FUNCTION__, __LINE__, TRACE_MAXIMUM) +#define FUNC_EXIT StackTrace_exit(__FUNCTION__, __LINE__, NULL, TRACE_MINIMUM) +#define FUNC_EXIT_NOLOG StackTrace_exit(__FUNCTION__, __LINE__, -1) +#define FUNC_EXIT_MED StackTrace_exit(__FUNCTION__, __LINE__, NULL, TRACE_MEDIUM) +#define FUNC_EXIT_MAX StackTrace_exit(__FUNCTION__, __LINE__, NULL, TRACE_MAXIMUM) +#define FUNC_EXIT_RC(x) StackTrace_exit(__FUNCTION__, __LINE__, &x, TRACE_MINIMUM) +#define FUNC_EXIT_MED_RC(x) StackTrace_exit(__FUNCTION__, __LINE__, &x, TRACE_MEDIUM) +#define FUNC_EXIT_MAX_RC(x) StackTrace_exit(__FUNCTION__, __LINE__, &x, TRACE_MAXIMUM) +#else +#define FUNC_ENTRY StackTrace_entry(__func__, __LINE__, TRACE_MINIMUM) +#define FUNC_ENTRY_NOLOG StackTrace_entry(__func__, __LINE__, -1) +#define FUNC_ENTRY_MED StackTrace_entry(__func__, __LINE__, TRACE_MEDIUM) +#define FUNC_ENTRY_MAX StackTrace_entry(__func__, __LINE__, TRACE_MAXIMUM) +#define FUNC_EXIT StackTrace_exit(__func__, __LINE__, NULL, TRACE_MINIMUM) +#define FUNC_EXIT_NOLOG StackTrace_exit(__func__, __LINE__, NULL, -1) +#define FUNC_EXIT_MED StackTrace_exit(__func__, __LINE__, NULL, TRACE_MEDIUM) +#define FUNC_EXIT_MAX StackTrace_exit(__func__, __LINE__, NULL, TRACE_MAXIMUM) +#define FUNC_EXIT_RC(x) StackTrace_exit(__func__, __LINE__, &x, TRACE_MINIMUM) +#define FUNC_EXIT_MED_RC(x) StackTrace_exit(__func__, __LINE__, &x, TRACE_MEDIUM) +#define FUNC_EXIT_MAX_RC(x) StackTrace_exit(__func__, __LINE__, &x, TRACE_MAXIMUM) + +void StackTrace_entry(const char* name, int line, int trace); +void StackTrace_exit(const char* name, int line, void* return_value, int trace); + +void StackTrace_printStack(FILE* dest); +char* StackTrace_get(unsigned long); + +#endif + +#endif + + + + +#endif /* STACKTRACE_H_ */ diff --git a/Internet/MQTT/mqtt_interface.c b/Internet/MQTT/mqtt_interface.c new file mode 100644 index 0000000..19de0e2 --- /dev/null +++ b/Internet/MQTT/mqtt_interface.c @@ -0,0 +1,190 @@ +//***************************************************************************** +//! \file mqtt_interface.c +//! \brief Paho MQTT to WIZnet Chip interface implement file. +//! \details The process of porting an interface to use paho MQTT. +//! \version 1.0.0 +//! \date 2016/12/06 +//! \par Revision history +//! <2016/12/06> 1st Release +//! +//! \author Peter Bang & Justin Kim +//! \copyright +//! +//! Copyright (c) 2016, WIZnet Co., 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: +//! +//! * 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 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 "mqtt_interface.h" +#include "wizchip_conf.h" +#include "socket.h" + +unsigned long MilliTimer; + +/* + @brief MQTT MilliTimer handler + @note MUST BE register to your system 1m Tick timer handler. +*/ +void MilliTimer_Handler(void) { + MilliTimer++; +} + +/* + @brief Timer Initialize + @param timer : pointer to a Timer structure + that contains the configuration information for the Timer. +*/ +void TimerInit(Timer* timer) { + timer->end_time = 0; +} + +/* + @brief expired Timer + @param timer : pointer to a Timer structure + that contains the configuration information for the Timer. +*/ +char TimerIsExpired(Timer* timer) { + long left = timer->end_time - MilliTimer; + return (left < 0); +} + +/* + @brief Countdown millisecond Timer + @param timer : pointer to a Timer structure + that contains the configuration information for the Timer. + timeout : setting timeout millisecond. +*/ +void TimerCountdownMS(Timer* timer, unsigned int timeout) { + timer->end_time = MilliTimer + timeout; +} + +/* + @brief Countdown second Timer + @param timer : pointer to a Timer structure + that contains the configuration information for the Timer. + timeout : setting timeout millisecond. +*/ +void TimerCountdown(Timer* timer, unsigned int timeout) { + timer->end_time = MilliTimer + (timeout * 1000); +} + +/* + @brief left millisecond Timer + @param timer : pointer to a Timer structure + that contains the configuration information for the Timer. +*/ +int TimerLeftMS(Timer* timer) { + long left = timer->end_time - MilliTimer; + return (left < 0) ? 0 : left; +} + +/* + @brief New network setting + @param n : pointer to a Network structure + that contains the configuration information for the Network. + sn : socket number where x can be (0..7). + @retval None +*/ +void NewNetwork(Network* n, int sn) { + n->my_socket = sn; + n->mqttread = w5x00_read; + n->mqttwrite = w5x00_write; + n->disconnect = w5x00_disconnect; +} + +/* + @brief read function + @param n : pointer to a Network structure + that contains the configuration information for the Network. + buffer : pointer to a read buffer. + len : buffer length. + @retval received data length or SOCKERR code +*/ +int w5x00_read(Network* n, unsigned char* buffer, int len, long time) { + + if ((getSn_SR(n->my_socket) == SOCK_ESTABLISHED) && (getSn_RX_RSR(n->my_socket) > 0)) { + return recv(n->my_socket, buffer, len); + } + + return SOCK_ERROR; +} + +/* + @brief write function + @param n : pointer to a Network structure + that contains the configuration information for the Network. + buffer : pointer to a read buffer. + len : buffer length. + @retval length of data sent or SOCKERR code +*/ +int w5x00_write(Network* n, unsigned char* buffer, int len, long time) { + if (getSn_SR(n->my_socket) == SOCK_ESTABLISHED) { + return send(n->my_socket, buffer, len); + } + + return SOCK_ERROR; +} + +/* + @brief disconnect function + @param n : pointer to a Network structure + that contains the configuration information for the Network. +*/ +void w5x00_disconnect(Network* n) { + disconnect(n->my_socket); +} + +/* + @brief connect network function + @param n : pointer to a Network structure + that contains the configuration information for the Network. + ip : server iP. + port : server port. + @retval SOCKOK code or SOCKERR code +*/ +int ConnectNetwork(Network* n, uint8_t* ip, uint16_t port) { + uint16_t myport = 12345; + + if (socket(n->my_socket, Sn_MR_TCP, myport, 0) != n->my_socket) { + return SOCK_ERROR; + } + +#if 1 + // 20231016 taylor//teddy 240122 +#if ((_WIZCHIP_ == 6100) || (_WIZCHIP_ == 6300)) + if (connect(n->my_socket, ip, port, 4) != SOCK_OK) +#else + if (connect(n->my_socket, ip, port) != SOCK_OK) +#endif +#else + if (connect(n->my_socket, ip, port) != SOCK_OK) +#endif + return SOCK_ERROR; + + return SOCK_OK; +} diff --git a/Internet/MQTT/mqtt_interface.h b/Internet/MQTT/mqtt_interface.h new file mode 100644 index 0000000..ad90421 --- /dev/null +++ b/Internet/MQTT/mqtt_interface.h @@ -0,0 +1,270 @@ +//***************************************************************************** +//! \file mqtt_interface.h +//! \brief Paho MQTT to WIZnet Chip interface Header file. +//! \details The process of porting an interface to use paho MQTT. +//! \version 1.0.0 +//! \date 2016/12/06 +//! \par Revision history +//! <2016/12/06> 1st Release +//! +//! \author Peter Bang & Justin Kim +//! \copyright +//! +//! Copyright (c) 2016, WIZnet Co., 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: +//! +//! * 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 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. +// +//***************************************************************************** + +/* MQTT subscribe Example.... W5500 + STM32F103(IoT board) + //Include: Board configuration + #include "IoTEVB.h" + + //Include: MCU peripheral Library + #include "stm32f10x_rcc.h" + #include "stm32f10x.h" + + //Include: W5500 iolibrary + #include "w5500.h" + #include "wizchip_conf.h" + #include "misc.h" + + //Include: Internet iolibrary + #include "MQTTClient.h" + + //Include: MCU Specific W5500 driver + #include "W5500HardwareDriver.h" + + //Include: Standard IO Library + #include + + //Socket number defines + #define TCP_SOCKET 0 + + //Receive Buffer Size define + #define BUFFER_SIZE 2048 + + //Global variables + unsigned char targetIP[4] = {}; // mqtt server IP + unsigned int targetPort = 1883; // mqtt server port + uint8_t mac_address[6] = {}; + wiz_NetInfo gWIZNETINFO = { .mac = {}, //user MAC + .ip = {}, //user IP + .sn = {}, + .gw = {}, + .dns = {}, + .dhcp = NETINFO_STATIC}; + + unsigned char tempBuffer[BUFFER_SIZE] = {}; + + struct opts_struct + { + char* clientid; + int nodelimiter; + char* delimiter; + enum QoS qos; + char* username; + char* password; + char* host; + int port; + int showtopics; + } opts ={ (char*)"stdout-subscriber", 0, (char*)"\n", QOS0, NULL, NULL, targetIP, targetPort, 0 }; + + + // @brief messageArrived callback function + void messageArrived(MessageData* md) + { + unsigned char testbuffer[100]; + MQTTMessage* message = md->message; + + if (opts.showtopics) + { + memcpy(testbuffer,(char*)message->payload,(int)message->payloadlen); + (testbuffer + (int)message->payloadlen + 1) = "\n"; + printf("%s\r\n",testbuffer); + } + + if (opts.nodelimiter) + printf("%.*s", (int)message->payloadlen, (char*)message->payload); + else + printf("%.*s%s", (int)message->payloadlen, (char*)message->payload, opts.delimiter); + } + + + // @brief 1 millisecond Tick Timer setting + void NVIC_configuration(void) + { + NVIC_InitTypeDef NVIC_InitStructure; + SysTick_CLKSourceConfig(SysTick_CLKSource_HCLK); + SysTick_Config(72000); + NVIC_InitStructure.NVIC_IRQChannel = SysTick_IRQn; + NVIC_InitStructure.NVIC_IRQChannelPreemptionPriority = 0; // Highest priority + NVIC_InitStructure.NVIC_IRQChannelSubPriority = 0; + NVIC_InitStructure.NVIC_IRQChannelCmd = ENABLE; + NVIC_Init(&NVIC_InitStructure); + } + + // @brief 1 millisecond Tick Timer Handler setting + void SysTick_Handler(void) + { + MilliTimer_Handler(); + } + + int main(void) + { + led_ctrl led1,led2; + int i; + int rc = 0; + unsigned char buf[100]; + //Usart initialization for Debug. + USART1Initialze(); + printf("USART initialized.\n\r"); + + I2C1Initialize(); + printf("I2C initialized.\n\r"); + + MACEEP_Read(mac_address,0xfa,6); + + printf("Mac address\n\r"); + for(i = 0 ; i < 6 ; i++) + { + printf("%02x ",mac_address[i]); + } + printf("\n\r"); + + //LED initialization. + led_initialize(); + led1 = led2 = ON; + + led2Ctrl(led2); + led1Ctrl(led1); + + //W5500 initialization. + W5500HardwareInitilize(); + printf("W5500 hardware interface initialized.\n\r"); + + W5500Initialze(); + printf("W5500 IC initialized.\n\r"); + + //Set network informations + wizchip_setnetinfo(&gWIZNETINFO); + + setSHAR(mac_address); + + print_network_information(); + + Network n; + MQTTClient c; + + NewNetwork(&n, TCP_SOCKET); + ConnectNetwork(&n, targetIP, targetPort); + MQTTClientInit(&c,&n,1000,buf,100,tempBuffer,2048); + + MQTTPacket_connectData data = MQTTPacket_connectData_initializer; + data.willFlag = 0; + data.MQTTVersion = 3; + data.clientID.cstring = opts.clientid; + data.username.cstring = opts.username; + data.password.cstring = opts.password; + + data.keepAliveInterval = 60; + data.cleansession = 1; + + rc = MQTTConnect(&c, &data); + printf("Connected %d\r\n", rc); + opts.showtopics = 1; + + printf("Subscribing to %s\r\n", "hello/wiznet"); + rc = MQTTSubscribe(&c, "hello/wiznet", opts.qos, messageArrived); + printf("Subscribed %d\r\n", rc); + + while(1) + { + MQTTYield(&c, data.keepAliveInterval); + } + } +*/ + +#ifndef __MQTT_INTERFACE_H_ +#define __MQTT_INTERFACE_H_ + +#include + +#ifdef __cplusplus +extern "C" { +#endif + + +/* + @brief MQTT MilliTimer handler + @note MUST BE register to your system 1m Tick timer handler +*/ +void MilliTimer_Handler(void); + +/* + @brief Timer structure +*/ +typedef struct Timer Timer; +struct Timer { + unsigned long systick_period; + unsigned long end_time; +}; + +/* + @brief Network structure +*/ +typedef struct Network Network; +struct Network { + int my_socket; + int (*mqttread) (Network*, unsigned char*, int, long); + int (*mqttwrite) (Network*, unsigned char*, int, long); + void (*disconnect) (Network*); +}; + +/* + @brief Timer function +*/ +void TimerInit(Timer*); +char TimerIsExpired(Timer*); +void TimerCountdownMS(Timer*, unsigned int); +void TimerCountdown(Timer*, unsigned int); +int TimerLeftMS(Timer*); + +/* + @brief Network interface porting +*/ +int w5x00_read(Network*, unsigned char*, int, long); +int w5x00_write(Network*, unsigned char*, int, long); +void w5x00_disconnect(Network*); +void NewNetwork(Network* n, int sn); +int ConnectNetwork(Network* n, uint8_t* ip, uint16_t port); + +#ifdef __cplusplus +} +#endif + +#endif //__MQTT_INTERFACE_H_ diff --git a/Internet/SNMP/snmp.c b/Internet/SNMP/snmp.c new file mode 100644 index 0000000..2ba75e5 --- /dev/null +++ b/Internet/SNMP/snmp.c @@ -0,0 +1,917 @@ +#include +#include +#include +#include +#include + +#include "socket.h" +#include "snmp.h" +#include "snmp_custom.h" + +/********************************************************************************************/ +/* SNMP : Functions declaration */ +/********************************************************************************************/ +// SNMP Parsing functions +int32_t findEntry(uint8_t *oid, int32_t len); +int32_t getOID(int32_t id, uint8_t *oid, uint8_t *len); +int32_t getValue(uint8_t *vptr, int32_t vlen); +int32_t getEntry(int32_t id, uint8_t *dataType, void *ptr, int32_t *len); +int32_t setEntry(int32_t id, void *val, int32_t vlen, uint8_t dataType, int32_t index); +int32_t makeTrapVariableBindings(dataEntryType *oid_data, void *ptr, uint32_t *len); + +int32_t parseLength(const uint8_t *msg, int32_t *len); +int32_t parseTLV(const uint8_t *msg, int32_t index, tlvStructType *tlv); +void insertRespLen(int32_t reqStart, int32_t respStart, int32_t size); +int32_t parseVarBind(int32_t reqType, int32_t index); +int32_t parseSequence(int32_t reqType, int32_t index); +int32_t parseSequenceOf(int32_t reqType); +int32_t parseRequest(); +int32_t parseCommunity(); +int32_t parseVersion(); +int32_t parseSNMPMessage(); + +// Debugging function +#ifdef _SNMP_DEBUG_ +void dumpCode(uint8_t* header, uint8_t* tail, uint8_t *buff, int32_t len); +#endif + +// Utils +void ipToByteArray(int8_t *ip, uint8_t *pDes); + +/********************************************************************************************/ +/* SNMP : Variable declaration */ +/********************************************************************************************/ +// SNMP message structures +struct messageStruct request_msg; +struct messageStruct response_msg; + +// SNMP Time counter +static time_t startTime = 0; +volatile uint32_t snmp_tick_10ms = 0; //volatile uint32_t snmp_tick_1ms = 0; + +// SNMP Sockets +static uint8_t SOCK_SNMP_AGENT; +static uint8_t SOCK_SNMP_TRAP; + +uint8_t packet_trap[MAX_TRAPMSG_LEN] = {0,}; +uint8_t errorStatus, errorIndex; + + +/********************************************************************************************/ +/* SNMP : Time handler */ +/********************************************************************************************/ +void currentUptime(void *ptr, uint8_t *len) { + time_t curTime = getSNMPTimeTick(); + + //*(uint32_t *)ptr = (uint32_t)(curTime - startTime) / 10; // calculation for 1ms tick + *(uint32_t *)ptr = (uint32_t)(curTime - startTime); // calculation for 10ms tick + *len = 4; +} + +void SNMP_time_handler(void) { + //snmp_tick_1ms++; + snmp_tick_10ms++; +} + +uint32_t getSNMPTimeTick(void) { + //return snmp_tick_1ms; + return snmp_tick_10ms; +} + + +/********************************************************************************************/ +/* SNMP : Library Part */ +/********************************************************************************************/ +/** + @addtogroup snmp_module + @{ +*/ + +/** + Initialize SNMP Daemon. + This should be called just one time at first time + + @param none + @return none +*/ +void snmpd_init(uint8_t * managerIP, uint8_t * agentIP, uint8_t sn_agent, uint8_t sn_trap) { +#ifdef _SNMP_DEBUG_ + printf("\r\n - SNMP : Start SNMP Agent Daemon\r\n"); +#endif + SOCK_SNMP_AGENT = sn_agent; + SOCK_SNMP_TRAP = sn_trap; + + if ((SOCK_SNMP_AGENT > _WIZCHIP_SOCK_NUM_) || (SOCK_SNMP_TRAP > _WIZCHIP_SOCK_NUM_)) { + return; + } + + startTime = getSNMPTimeTick(); // Start time (unit: 10ms) + initTable(); // Settings for OID entry values + + initial_Trap(managerIP, agentIP); + + /* + // Example Codes for SNMP Trap + { + dataEntryType enterprise_oid = {0x0a, {0x2b, 0x06, 0x01, 0x04, 0x01, 0x81, 0x9b, 0x19, 0x01, 0x00}, + SNMPDTYPE_OBJ_ID, 0x0a, {"\x2b\x06\x01\x04\x01\x81\x9b\x19\x10\x00"}, NULL, NULL}; + + dataEntryType trap_oid1 = {8, {0x2b, 6, 1, 4, 1, 0, 11, 0}, SNMPDTYPE_OCTET_STRING, 30, {""}, NULL, NULL}; + dataEntryType trap_oid2 = {8, {0x2b, 6, 1, 4, 1, 0, 12, 0}, SNMPDTYPE_INTEGER, 4, {""}, NULL, NULL}; + + strcpy((char *)trap_oid1.u.octetstring, "Alert!!!"); // String added + trap_oid2.u.intval = 123456; // Integer value added + + // Generic Trap: warmStart + snmp_sendTrap((void *)"192.168.0.214", (void *)"192.168.0.112", (void *)"public", enterprise_oid, SNMPTRAP_WARMSTART, 0, 0); + + // Enterprise-Specific Trap + snmp_sendTrap((void *)"192.168.0.214", (void *)"192.168.0.112", (void *)"public", enterprise_oid, 6, 0, 2, &trap_oid1, &trap_oid2); + } + */ +} + + +/** + SNMP Process Handler. + UDP Socket and SNMP Agent transaction handling. + + @param none + @return none +*/ + +int32_t snmpd_run(void) { + int32_t ret; + int32_t len = 0; + + uint8_t svr_addr[6]; + uint16_t svr_port; +#if 1 + // 20231019 taylor + uint8_t addr_len; +#endif + + if (SOCK_SNMP_AGENT > _WIZCHIP_SOCK_NUM_) { + return -99; + } + + switch (getSn_SR(SOCK_SNMP_AGENT)) { + case SOCK_UDP : + if ((len = getSn_RX_RSR(SOCK_SNMP_AGENT)) > 0) { +#if 1 + // 20231019 taylor//teddy 240122 +#if ((_WIZCHIP_ == 6100) || (_WIZCHIP_ == 6300)) + request_msg.len = recvfrom(SOCK_SNMP_AGENT, request_msg.buffer, len, svr_addr, &svr_port, &addr_len); +#else + request_msg.len = recvfrom(SOCK_SNMP_AGENT, request_msg.buffer, len, svr_addr, &svr_port); +#endif +#else + request_msg.len = recvfrom(SOCK_SNMP_AGENT, request_msg.buffer, len, svr_addr, &svr_port); +#endif + } else { + request_msg.len = 0; + } + + if (request_msg.len > 0) { +#ifdef _SNMP_DEBUG_ + dumpCode((void *)"\r\n[Request]\r\n", (void *)"\r\n", request_msg.buffer, request_msg.len); +#endif + // Initialize + request_msg.index = 0; + response_msg.index = 0; + errorStatus = errorIndex = 0; + memset(response_msg.buffer, 0x00, MAX_SNMPMSG_LEN); + + // Received message parsing and send response process + if (parseSNMPMessage() != -1) { +#if 1 + // 20231016 taylor//teddy 240122 +#if ((_WIZCHIP_ == 6100) || (_WIZCHIP_ == 6300)) + sendto(SOCK_SNMP_AGENT, response_msg.buffer, response_msg.index, svr_addr, svr_port, 4); +#else + sendto(SOCK_SNMP_AGENT, response_msg.buffer, response_msg.index, svr_addr, svr_port); +#endif +#else + sendto(SOCK_SNMP_AGENT, response_msg.buffer, response_msg.index, svr_addr, svr_port); +#endif + } + +#ifdef _SNMP_DEBUG_ + dumpCode((void *)"\r\n[Response]\r\n", (void *)"\r\n", response_msg.buffer, response_msg.index); +#endif + } + break; + + case SOCK_CLOSED : + if ((ret = socket(SOCK_SNMP_AGENT, Sn_MR_UDP, PORT_SNMP_AGENT, 0x00)) != SOCK_SNMP_AGENT) { + return ret; + } +#ifdef _SNMP_DEBUG_ + printf(" - [%d] UDP Socket for SNMP Agent, port [%d]\r\n", SOCK_SNMP_AGENT, PORT_SNMP_AGENT); +#endif + break; + + default : + break; + } + + + return 1; +} + + +int32_t findEntry(uint8_t *oid, int32_t len) { + int32_t i; + + for (i = 0 ; i < maxData ; i++) { + if (len == snmpData[i].oidlen) { + if (!memcmp(snmpData[i].oid, oid, len)) { + return (i); + } + } + } + + return OID_NOT_FOUND; +} + + +int32_t getOID(int32_t id, uint8_t *oid, uint8_t *len) { + int32_t j; + + if (!((id >= 0) && (id < maxData))) { + return INVALID_ENTRY_ID; + } + + *len = snmpData[id].oidlen; + + for (j = 0 ; j < *len ; j++) { + oid[j] = snmpData[id].oid[j]; + } + + return SNMP_SUCCESS; +} + + +int32_t getValue(uint8_t *vptr, int32_t vlen) { + int32_t index = 0; + int32_t value = 0; + + while (index < vlen) { + if (index != 0) { + value <<= 8; + } + value |= vptr[index++]; + } + + return value; +} + + +int32_t getEntry(int32_t id, uint8_t *dataType, void *ptr, int32_t *len) { + uint8_t * ptr_8; + int32_t value; + + uint8_t * string; + int32_t j; + + if (!((id >= 0) && (id < maxData))) { + return INVALID_ENTRY_ID; + } + + *dataType = snmpData[id].dataType; + + switch (*dataType) { + case SNMPDTYPE_OCTET_STRING : + case SNMPDTYPE_OBJ_ID : { + string = ptr; + + if (snmpData[id].getfunction != NULL) { + snmpData[id].getfunction((void *)&snmpData[id].u.octetstring, &snmpData[id].dataLen); + } + + if ((*dataType) == SNMPDTYPE_OCTET_STRING) { + snmpData[id].dataLen = (uint8_t)strlen((char const*)&snmpData[id].u.octetstring); + } + + *len = snmpData[id].dataLen; + for (j = 0 ; j < *len ; j++) { + string[j] = snmpData[id].u.octetstring[j]; + } + } + break; + + case SNMPDTYPE_INTEGER : + case SNMPDTYPE_TIME_TICKS : + case SNMPDTYPE_COUNTER : + case SNMPDTYPE_GAUGE : { + if (snmpData[id].getfunction != NULL) { + snmpData[id].getfunction((void *)&snmpData[id].u.intval, &snmpData[id].dataLen); + } + + if (snmpData[id].dataLen) { + *len = snmpData[id].dataLen; + } else { + *len = sizeof(uint32_t); + } + + /* + // Original code (IAR, STM32) + // This code is not working in NXP+LPCXpresso (32-bit pointer operation error) + value = (int32_t *)ptr; + value = HTONL(snmpData[id].u.intval); + */ + + ptr_8 = ptr; + //value = HTONL(snmpData[id].u.intval); // Endian convert when processing 32bit pointer operation + value = snmpData[id].u.intval; + + for (j = 0 ; j < *len ; j++) { + ptr_8[j] = (uint8_t)((value >> ((*len - j - 1) * 8))); + } + } + break; + + default : + return INVALID_DATA_TYPE; + } + + return SNMP_SUCCESS; +} + + +int32_t setEntry(int32_t id, void *val, int32_t vlen, uint8_t dataType, int32_t index) { + + int32_t retStatus = OID_NOT_FOUND; + int32_t j; + + if (snmpData[id].dataType != dataType) { + errorStatus = BAD_VALUE; + errorIndex = index; + return INVALID_DATA_TYPE; + } + + switch (snmpData[id].dataType) { + case SNMPDTYPE_OCTET_STRING : + case SNMPDTYPE_OBJ_ID : { + uint8_t *string = val; + for (j = 0 ; j < vlen ; j++) { + snmpData[id].u.octetstring[j] = string[j]; + } + snmpData[id].dataLen = vlen; + } + retStatus = SNMP_SUCCESS; + break; + + case SNMPDTYPE_INTEGER : + case SNMPDTYPE_TIME_TICKS : + case SNMPDTYPE_COUNTER : + case SNMPDTYPE_GAUGE : { + snmpData[id].u.intval = getValue((uint8_t *)val, vlen); + snmpData[id].dataLen = vlen; + + if (snmpData[id].setfunction != NULL) { + snmpData[id].setfunction(snmpData[id].u.intval); + } + + } + retStatus = SNMP_SUCCESS; + break; + + default : + retStatus = INVALID_DATA_TYPE; + break; + + } + + return retStatus; +} + + +int32_t parseLength(const uint8_t *msg, int32_t *len) { + int32_t i = 1; + + if (msg[0] & 0x80) { + int32_t tlen = (msg[0] & 0x7f) - 1; + *len = msg[i++]; + + while (tlen--) { + *len <<= 8; + *len |= msg[i++]; + } + } else { + *len = msg[0]; + } + + return i; +} + + +int32_t parseTLV(const uint8_t *msg, int32_t index, tlvStructType *tlv) { + int32_t Llen = 0; + + tlv->start = index; + + Llen = parseLength((const uint8_t *)&msg[index + 1], &tlv->len); + + tlv->vstart = index + Llen + 1; + + switch (msg[index]) { + case SNMPDTYPE_SEQUENCE: + case GET_REQUEST: + case GET_NEXT_REQUEST: + case SET_REQUEST: + tlv->nstart = tlv->vstart; + break; + default: + tlv->nstart = tlv->vstart + tlv->len; + break; + } + + return 0; +} + + +void insertRespLen(int32_t reqStart, int32_t respStart, int32_t size) { + int32_t indexStart, lenLength; + uint32_t mask = 0xff; + int32_t shift = 0; + + if (request_msg.buffer[reqStart + 1] & 0x80) { + lenLength = request_msg.buffer[reqStart + 1] & 0x7f; + indexStart = respStart + 2; + + while (lenLength--) { + response_msg.buffer[indexStart + lenLength] = + (uint8_t)((size & mask) >> shift); + shift += 8; + mask <<= shift; + } + } else { + response_msg.buffer[respStart + 1] = (uint8_t)(size & 0xff); + } +} + +int32_t parseVarBind(int32_t reqType, int32_t index) { + int32_t seglen = 0, id; + tlvStructType name, value; + int32_t size = 0; + + //extern const int32_t maxData; + + parseTLV(request_msg.buffer, request_msg.index, &name); + + if (request_msg.buffer[name.start] != SNMPDTYPE_OBJ_ID) { + return -1; + } + + id = findEntry(&request_msg.buffer[name.vstart], name.len); + + if ((reqType == GET_REQUEST) || (reqType == SET_REQUEST)) { + seglen = name.nstart - name.start; + COPY_SEGMENT(name); + size = seglen; + } else if (reqType == GET_NEXT_REQUEST) { + response_msg.buffer[response_msg.index] = request_msg.buffer[name.start]; + + if (++id >= maxData) { + id = OID_NOT_FOUND; + seglen = name.nstart - name.start; + COPY_SEGMENT(name); + size = seglen; + } else { + request_msg.index += name.nstart - name.start; + + getOID(id, &response_msg.buffer[response_msg.index + 2], &response_msg.buffer[response_msg.index + 1]); + + seglen = response_msg.buffer[response_msg.index + 1] + 2; + response_msg.index += seglen ; + size = seglen; + } + } + + parseTLV(request_msg.buffer, request_msg.index, &value); + + if (id != OID_NOT_FOUND) { + uint8_t dataType; + int32_t len; + + if ((reqType == GET_REQUEST) || (reqType == GET_NEXT_REQUEST)) { + getEntry(id, &dataType, &response_msg.buffer[response_msg.index + 2], &len); + + response_msg.buffer[response_msg.index] = dataType; + response_msg.buffer[response_msg.index + 1] = len; + seglen = (2 + len); + response_msg.index += seglen; + + request_msg.index += (value.nstart - value.start); + + } else if (reqType == SET_REQUEST) { + setEntry(id, &request_msg.buffer[value.vstart], value.len, request_msg.buffer[value.start], index); + seglen = value.nstart - value.start; + COPY_SEGMENT(value); + } + } else { + seglen = value.nstart - value.start; + COPY_SEGMENT(value); + + errorIndex = index; + errorStatus = NO_SUCH_NAME; + } + + size += seglen; + + return size; +} + + +int32_t parseSequence(int32_t reqType, int32_t index) { + int32_t seglen; + tlvStructType seq; + int32_t size = 0, respLoc; + + parseTLV(request_msg.buffer, request_msg.index, &seq); + + if (request_msg.buffer[seq.start] != SNMPDTYPE_SEQUENCE) { + return -1; + } + + seglen = seq.vstart - seq.start; + respLoc = response_msg.index; + COPY_SEGMENT(seq); + + size = parseVarBind(reqType, index); + insertRespLen(seq.start, respLoc, size); + size += seglen; + + return size; +} + + +int32_t parseSequenceOf(int32_t reqType) { + int32_t seglen; + tlvStructType seqof; + int32_t size = 0, respLoc; + int32_t index = 0; + + parseTLV(request_msg.buffer, request_msg.index, &seqof); + + if (request_msg.buffer[seqof.start] != SNMPDTYPE_SEQUENCE_OF) { + return -1; + } + + seglen = seqof.vstart - seqof.start; + respLoc = response_msg.index; + COPY_SEGMENT(seqof); + + while (request_msg.index < request_msg.len) { + size += parseSequence(reqType, index++); + } + + insertRespLen(seqof.start, respLoc, size); + + return size; +} + + +int32_t parseRequest() { + int32_t ret, seglen; + tlvStructType snmpreq, requestid, errStatus, errIndex; + int32_t size = 0, respLoc, reqType; + + parseTLV(request_msg.buffer, request_msg.index, &snmpreq); + + reqType = request_msg.buffer[snmpreq.start]; + + if (!VALID_REQUEST(reqType)) { + return -1; + } + + seglen = snmpreq.vstart - snmpreq.start; + respLoc = snmpreq.start; + size += seglen; + COPY_SEGMENT(snmpreq); + + response_msg.buffer[snmpreq.start] = GET_RESPONSE; + + parseTLV(request_msg.buffer, request_msg.index, &requestid); + seglen = requestid.nstart - requestid.start; + size += seglen; + COPY_SEGMENT(requestid); + + parseTLV(request_msg.buffer, request_msg.index, &errStatus); + seglen = errStatus.nstart - errStatus.start; + size += seglen; + COPY_SEGMENT(errStatus); + + parseTLV(request_msg.buffer, request_msg.index, &errIndex); + seglen = errIndex.nstart - errIndex.start; + size += seglen; + COPY_SEGMENT(errIndex); + + ret = parseSequenceOf(reqType); + if (ret == -1) { + return -1; + } else { + size += ret; + } + + insertRespLen(snmpreq.start, respLoc, size); + + if (errorStatus) { + response_msg.buffer[errStatus.vstart] = errorStatus; + response_msg.buffer[errIndex.vstart] = errorIndex + 1; + } + + return size; +} + + +int32_t parseCommunity() { + int32_t seglen; + tlvStructType community; + int32_t size = 0; + + parseTLV(request_msg.buffer, request_msg.index, &community); + + if (!((request_msg.buffer[community.start] == SNMPDTYPE_OCTET_STRING) && (community.len == COMMUNITY_SIZE))) { + return -1; + } + + if (!memcmp(&request_msg.buffer[community.vstart], (int8_t *)COMMUNITY, COMMUNITY_SIZE)) { + seglen = community.nstart - community.start; + size += seglen; + COPY_SEGMENT(community); + + size += parseRequest(); + } else { + return -1; + } + + return size; +} + + +int32_t parseVersion() { + int32_t size = 0, seglen; + tlvStructType tlv; + + size = parseTLV(request_msg.buffer, request_msg.index, &tlv); + + if (!((request_msg.buffer[tlv.start] == SNMPDTYPE_INTEGER) && (request_msg.buffer[tlv.vstart] == SNMP_V1))) { + return -1; + } + + seglen = tlv.nstart - tlv.start; + size += seglen; + COPY_SEGMENT(tlv); + size = parseCommunity(); + + if (size == -1) { + return size; + } else { + return (size + seglen); + } +} + + +int32_t parseSNMPMessage() { + int32_t size = 0, seglen, respLoc; + tlvStructType tlv; + + parseTLV(request_msg.buffer, request_msg.index, &tlv); + + if (request_msg.buffer[tlv.start] != SNMPDTYPE_SEQUENCE_OF) { + return -1; + } + + seglen = tlv.vstart - tlv.start; + respLoc = tlv.start; + COPY_SEGMENT(tlv); + + size = parseVersion(); + + if (size == -1) { + return -1; + } else { + size += seglen; + } + + insertRespLen(tlv.start, respLoc, size); + + return 0; +} + +void ipToByteArray(int8_t *ip, uint8_t *pDes) { + uint32_t i, ip1 = 0, ip2 = 0, ip3 = 0, ip4 = 0; + int8_t buff[32]; + uint32_t len = (uint32_t)strlen((char const*)ip); + strcpy((char *)buff, (char const*)ip); + + for (i = 0; i < len; i++) { + if (buff[i] == '.') { + buff[i] = ' '; + } + } + + sscanf((char const*)buff, "%u %u %u %u", &ip1, &ip2, &ip3, &ip4); + pDes[0] = ip1; pDes[1] = ip2; pDes[2] = ip3; pDes[3] = ip4; +} + + +int32_t makeTrapVariableBindings(dataEntryType *oid_data, void *ptr, uint32_t *len) { + uint32_t j; + + ((uint8_t*)ptr)[0] = 0x30; + ((uint8_t*)ptr)[1] = 0xff; + ((uint8_t*)ptr)[2] = 0x06; + ((uint8_t*)ptr)[3] = oid_data->oidlen; + + for (j = 0 ; j < oid_data->oidlen ; j++) { + ((uint8_t*)ptr)[j + 4] = oid_data->oid[j]; + } + + switch (oid_data->dataType) { + case SNMPDTYPE_OCTET_STRING : + case SNMPDTYPE_OBJ_ID : { + uint8_t *string = &((uint8_t*)ptr)[4 + oid_data->oidlen + 2]; + + if (oid_data->dataType == SNMPDTYPE_OCTET_STRING) { + oid_data->dataLen = (uint8_t)strlen((char const*)&oid_data->u.octetstring); + } + for (j = 0 ; j < oid_data->dataLen ; j++) { + string[j] = oid_data->u.octetstring[j]; + } + + ((uint8_t*)ptr)[4 + oid_data->oidlen] = oid_data->dataType; + ((uint8_t*)ptr)[4 + oid_data->oidlen + 1] = oid_data->dataLen; + ((uint8_t*)ptr)[1] = 2 + oid_data->oidlen + 2 + oid_data->dataLen; + *len = 4 + oid_data->oidlen + 2 + oid_data->dataLen; + } + break; + + case SNMPDTYPE_INTEGER : + case SNMPDTYPE_TIME_TICKS : + case SNMPDTYPE_COUNTER : + case SNMPDTYPE_GAUGE : { + oid_data->dataLen = 4; + + *(int32_t*)(&((uint8_t*)ptr)[4 + oid_data->oidlen + 2]) = HTONL(oid_data->u.intval); + + ((uint8_t*)ptr)[4 + oid_data->oidlen] = oid_data->dataType; + ((uint8_t*)ptr)[4 + oid_data->oidlen + 1] = oid_data->dataLen; + ((uint8_t*)ptr)[1] = 2 + oid_data->oidlen + 2 + oid_data->dataLen; + *len = 4 + oid_data->oidlen + 2 + oid_data->dataLen; + } + break; + + default : + return INVALID_DATA_TYPE; + } + + return SNMP_SUCCESS; +} + + +int32_t snmp_sendTrap(uint8_t * managerIP, uint8_t * agentIP, int8_t* community, dataEntryType enterprise_oid, uint32_t genericTrap, uint32_t specificTrap, uint32_t va_count, ...) { + uint32_t i; + int32_t packet_index = 0; + int32_t packet_buff1 = 0; + int32_t packet_buff2 = 0; + int32_t packet_buff3 = 0; + + va_list ap; + uint32_t length_var_bindings = 0; + uint32_t length_buff = 0; + + //SNMP Trap packet generation + packet_trap[packet_index++] = 0x30; // ASN.1 Header + + packet_trap[packet_index] = 0xff; // pdu_length, temp + packet_buff1 = packet_index++; + + packet_trap[packet_index++] = 0x02; // Version + packet_trap[packet_index++] = 0x01; + packet_trap[packet_index++] = 0x00; + + packet_trap[packet_index++] = 0x04; // Community + packet_trap[packet_index++] = (uint8_t)strlen((char const*)community); + memcpy(&(packet_trap[packet_index]), community, strlen((char const*)community)); + + packet_index = packet_index + (uint8_t)strlen((char const*)community); + + packet_trap[packet_index++] = 0xa4; // trap + packet_trap[packet_index] = 0xff; // length, temp + packet_buff2 = packet_index++; + + packet_trap[packet_index++] = 0x06; // enterprise_oid + packet_trap[packet_index++] = enterprise_oid.oidlen; + for (i = 0; i < enterprise_oid.oidlen; i++) { + packet_trap[packet_index++] = enterprise_oid.oid[i]; + } + + packet_trap[packet_index++] = 0x40; // agent ip + packet_trap[packet_index++] = 0x04; + packet_trap[packet_index++] = agentIP[0]; + packet_trap[packet_index++] = agentIP[1]; + packet_trap[packet_index++] = agentIP[2]; + packet_trap[packet_index++] = agentIP[3]; + + packet_trap[packet_index++] = 0x02; // Generic Trap + packet_trap[packet_index++] = 0x01; + packet_trap[packet_index++] = (uint8_t)genericTrap; + + packet_trap[packet_index++] = 0x02; // Specific Trap + packet_trap[packet_index++] = 0x01; + packet_trap[packet_index++] = (uint8_t)specificTrap; + + packet_trap[packet_index++] = 0x43; // Timestamp + packet_trap[packet_index++] = 0x01; + packet_trap[packet_index++] = 0x00; + + packet_trap[packet_index++] = 0x30; // Sequence of variable-bindings + packet_trap[packet_index] = 0xff; + packet_buff3 = packet_index++; + + // variable-bindings + { + va_start(ap, va_count); + + for (i = 0; i < va_count; i++) { + dataEntryType* fff = va_arg(ap, dataEntryType*); + makeTrapVariableBindings(fff, &(packet_trap[packet_index]), &length_buff); + packet_index = packet_index + length_buff; + length_var_bindings = length_var_bindings + length_buff; + } + + packet_trap[packet_buff3] = length_var_bindings; + + va_end(ap); + } + + + packet_trap[packet_buff1] = packet_index - 2; + packet_trap[packet_buff2] = packet_index - (9 + (uint8_t)strlen((char const*)community)); + + // Send SNMP Trap Packet to NMS + { + socket(SOCK_SNMP_TRAP, Sn_MR_UDP, PORT_SNMP_TRAP, 0); +#if 1 + // 20231016 taylor//teddy 240122 +#if ((_WIZCHIP_ == 6100) || (_WIZCHIP_ == 6300)) + sendto(SOCK_SNMP_TRAP, packet_trap, packet_index, managerIP, PORT_SNMP_TRAP, 4); +#else + sendto(SOCK_SNMP_TRAP, packet_trap, packet_index, managerIP, PORT_SNMP_TRAP); +#endif +#else + sendto(SOCK_SNMP_TRAP, packet_trap, packet_index, managerIP, PORT_SNMP_TRAP); +#endif + + close(SOCK_SNMP_TRAP); + return 0; + } +} + +#ifdef _SNMP_DEBUG_ +void dumpCode(uint8_t* header, uint8_t* tail, uint8_t *buff, int32_t len) { + int i; + + printf((char const*)header); + + for (i = 0; i < len; i++) { + if (i % 16 == 0) { + printf("0x%04x : ", i); + } + printf("%02x ", buff[i]); + + if (i % 16 - 15 == 0) { + int j; + printf(" "); + for (j = i - 15; j <= i; j++) { + if (isprint(buff[j])) { + printf("%c", buff[j]); + } else { + printf("."); + } + } + printf("\r\n"); + } + } + + if (i % 16 != 0) { + int j; + int spaces = (len - i + 16 - i % 16) * 3 + 2; + for (j = 0; j < spaces; j++) { + printf(" "); + } + for (j = i - i % 16; j < len; j++) { + if (isprint(buff[j])) { + printf("%c", buff[j]); + } else { + printf("."); + } + } + } + printf((char const*)tail); +} +#endif + diff --git a/Internet/SNMP/snmp.h b/Internet/SNMP/snmp.h new file mode 100644 index 0000000..d197dfb --- /dev/null +++ b/Internet/SNMP/snmp.h @@ -0,0 +1,122 @@ +#ifndef _SNMP_H_ +#define _SNMP_H_ + +#ifdef __cplusplus +extern "C" { +#endif + +// SNMP Debug Message (dump) Enable +#define _SNMP_DEBUG_ + +#define PORT_SNMP_AGENT 161 +#define PORT_SNMP_TRAP 162 + +#define SNMP_V1 0 + +#define MAX_OID 12 +#define MAX_STRING 64 +#define MAX_SNMPMSG_LEN 512 +#define MAX_TRAPMSG_LEN 512 + +// SNMP Error code +#define SNMP_SUCCESS 0 +#define OID_NOT_FOUND -1 +#define TABLE_FULL -2 +#define ILLEGAL_LENGTH -3 +#define INVALID_ENTRY_ID -4 +#define INVALID_DATA_TYPE -5 + +#define NO_SUCH_NAME 2 +#define BAD_VALUE 3 + +// SNMPv1 Commands +#define GET_REQUEST 0xa0 +#define GET_NEXT_REQUEST 0xa1 +#define GET_RESPONSE 0xa2 +#define SET_REQUEST 0xa3 + +// Macros: SNMPv1 request validation checker +#define VALID_REQUEST(x) ((x == GET_REQUEST) || (x == GET_NEXT_REQUEST) || (x == SET_REQUEST)) + +// SNMPv1 Return Types +#define SNMPDTYPE_INTEGER 0x02 +#define SNMPDTYPE_OCTET_STRING 0x04 +#define SNMPDTYPE_NULL_ITEM 0x05 +#define SNMPDTYPE_OBJ_ID 0x06 +#define SNMPDTYPE_SEQUENCE 0x30 +#define SNMPDTYPE_SEQUENCE_OF SNMPDTYPE_SEQUENCE + +#define SNMPDTYPE_COUNTER 0x41 +#define SNMPDTYPE_GAUGE 0x42 +#define SNMPDTYPE_TIME_TICKS 0x43 +#define SNMPDTYPE_OPAQUE 0x44 + +// SNMP Trap: Standard Trap Types (Generic) +#define SNMPTRAP_COLDSTART 0x00 // Generic trap-type 0: Cold Start +#define SNMPTRAP_WARMSTART 0x01 // Generic trap-type 1: Warm Start +#define SNMPTRAP_LINKDOWN 0x02 // Generic trap-type 2: Link Down +#define SNMPTRAP_LINKUP 0x03 // Generic trap-type 3: Link Up +#define SNMPTRAP_AUTHENTICATION 0x04 // Generic trap-type 4: Authentication Failure +#define SNMPTRAP_EGPNEIGHBORLOSS 0x05 // Generic trap-type 5: EGP Neighbor Loss + +// Macros +#define COPY_SEGMENT(x) \ +{ \ + request_msg.index += seglen; \ + memcpy(&response_msg.buffer[response_msg.index], &request_msg.buffer[x.start], seglen ); \ + response_msg.index += seglen; \ +} + +#ifndef HTONL +#define HTONL(x) \ + ((((x) >> 24) & 0x000000ff) | \ + (((x) >> 8) & 0x0000ff00) | \ + (((x) << 8) & 0x00ff0000) | \ + (((x) << 24) & 0xff000000)) +#endif + +typedef struct { + uint8_t oidlen; + uint8_t oid[MAX_OID]; + uint8_t dataType; + uint8_t dataLen; + union { + uint8_t octetstring[MAX_STRING]; + uint32_t intval; + } u; + void (*getfunction)(void *, uint8_t *); + void (*setfunction)(int32_t); +} dataEntryType; + +struct messageStruct { + uint8_t buffer[MAX_SNMPMSG_LEN]; + int32_t len; + int32_t index; +}; + +typedef struct { + int32_t start; /* Absolute Index of the TLV */ + int32_t len; /* The L value of the TLV */ + int32_t vstart; /* Absolute Index of this TLV's Value */ + int32_t nstart; /* Absolute Index of the next TLV */ +} tlvStructType; + + +/********************************************************************************************/ +/* SNMP : Functions */ +/********************************************************************************************/ +// SNMP Main functions +void snmpd_init(uint8_t * managerIP, uint8_t * agentIP, uint8_t sn_agent, uint8_t sn_trap); +int32_t snmpd_run(void); +int32_t snmp_sendTrap(uint8_t * managerIP, uint8_t * agentIP, int8_t* community, dataEntryType enterprise_oid, uint32_t genericTrap, uint32_t specificTrap, uint32_t va_count, ...); + +// SNMP Time handler functions +void SNMP_time_handler(void); +uint32_t getSNMPTimeTick(void); +void currentUptime(void *ptr, uint8_t *len); + +#ifdef __cplusplus +} +#endif + +#endif diff --git a/Internet/SNMP/snmp_custom.c b/Internet/SNMP/snmp_custom.c new file mode 100644 index 0000000..89a7d65 --- /dev/null +++ b/Internet/SNMP/snmp_custom.c @@ -0,0 +1,178 @@ + +/******************************************************************************************** + SNMP : User Customization Part + - OID Registration + - User defined functions for OID related + + Integer value, String + + I/O control / Chip registers + + Network Informations + + Etc. + + *********************************************************************************************/ +#include "snmp_custom.h" + +#ifdef _USE_WIZNET_W5500_EVB_ +#include "board.h" +#endif + +dataEntryType snmpData[] = { + // System MIB + // SysDescr Entry + { + 8, {0x2b, 6, 1, 2, 1, 1, 1, 0}, + SNMPDTYPE_OCTET_STRING, 30, {"WIZnet Embedded SNMP Agent"}, + NULL, NULL + }, + + // SysObjectID Entry + { + 8, {0x2b, 6, 1, 2, 1, 1, 2, 0}, + SNMPDTYPE_OBJ_ID, 8, {"\x2b\x06\x01\x02\x01\x01\x02\x00"}, + NULL, NULL + }, + + // SysUptime Entry + { + 8, {0x2b, 6, 1, 2, 1, 1, 3, 0}, + SNMPDTYPE_TIME_TICKS, 0, {""}, + currentUptime, NULL + }, + + // sysContact Entry + { + 8, {0x2b, 6, 1, 2, 1, 1, 4, 0}, + SNMPDTYPE_OCTET_STRING, 30, {"http://www.wizwiki.net/forum"}, + NULL, NULL + }, + + // sysName Entry + { + 8, {0x2b, 6, 1, 2, 1, 1, 5, 0}, + SNMPDTYPE_OCTET_STRING, 30, {"http://www.wiznet.co.kr"}, + NULL, NULL + }, + + // Location Entry + { + 8, {0x2b, 6, 1, 2, 1, 1, 6, 0}, + SNMPDTYPE_OCTET_STRING, 30, {"4F Humax Village"}, + NULL, NULL + }, + + // SysServices + { + 8, {0x2b, 6, 1, 2, 1, 1, 7, 0}, + SNMPDTYPE_INTEGER, 4, {""}, + NULL, NULL + }, + +#ifdef _USE_WIZNET_W5500_EVB_ + // Get the WIZnet W5500-EVB LED Status + { + 8, {0x2b, 6, 1, 4, 1, 6, 1, 0}, + SNMPDTYPE_OCTET_STRING, 40, {""}, + get_LEDStatus_all, NULL + }, + + // Set the LED_R (RGB LED) + { + 8, {0x2b, 6, 1, 4, 1, 6, 1, 1}, + SNMPDTYPE_INTEGER, 4, {""}, + NULL, set_LEDStatus_R + }, + + // Set the LED_G (RGB LED) + { + 8, {0x2b, 6, 1, 4, 1, 6, 1, 2}, + SNMPDTYPE_INTEGER, 4, {""}, + NULL, set_LEDStatus_G + }, + + // Set the LED_B (RGB LED) + { + 8, {0x2b, 6, 1, 4, 1, 6, 1, 3}, + SNMPDTYPE_INTEGER, 4, {""}, + NULL, set_LEDStatus_B + }, +#endif + + // OID Test #1 (long-length OID example, 19865) + { + 0x0a, {0x2b, 0x06, 0x01, 0x04, 0x01, 0x81, 0x9b, 0x19, 0x01, 0x00}, + SNMPDTYPE_OCTET_STRING, 30, {"long-length OID Test #1"}, + NULL, NULL + }, + + // OID Test #2 (long-length OID example, 22210) + { + 0x0a, {0x2b, 0x06, 0x01, 0x04, 0x01, 0x81, 0xad, 0x42, 0x01, 0x00}, + SNMPDTYPE_OCTET_STRING, 35, {"long-length OID Test #2"}, + NULL, NULL + }, + + // OID Test #2: SysObjectID Entry + { + 0x0a, {0x2b, 0x06, 0x01, 0x04, 0x01, 0x81, 0xad, 0x42, 0x02, 0x00}, + SNMPDTYPE_OBJ_ID, 0x0a, {"\x2b\x06\x01\x04\x01\x81\xad\x42\x02\x00"}, + NULL, NULL + }, +}; + +const int32_t maxData = (sizeof(snmpData) / sizeof(dataEntryType)); + +void initTable() { + // Example integer value for [OID 1.3.6.1.2.1.1.7.0] + snmpData[6].u.intval = -5; + +} + + +// W5500-EVB: LED Control /////////////////////////////////////////////////////////////////////////// +#ifdef _USE_WIZNET_W5500_EVB_ +void get_LEDStatus_all(void *ptr, uint8_t *len) { + uint8_t led_status[3] = {0, }; + + led_status[LED_R] = (uint8_t)Board_LED_Test(LED_R); + led_status[LED_G] = (uint8_t)Board_LED_Test(LED_G); + led_status[LED_B] = (uint8_t)Board_LED_Test(LED_B); + + *len = sprintf((char *)ptr, "LED R [%s] / G [%s] / B [%s]", led_status[LED_R] ? "On" : "Off", led_status[LED_G] ? "On" : "Off", led_status[LED_B] ? "On" : "Off"); +} + +void set_LEDStatus_R(int32_t val) { + if (val == 0) { + Board_LED_Set(LED_R, false); + } else { + Board_LED_Set(LED_R, true); + } +} + +void set_LEDStatus_G(int32_t val) { + if (val == 0) { + Board_LED_Set(LED_G, false); + } else { + Board_LED_Set(LED_G, true); + } +} + +void set_LEDStatus_B(int32_t val) { + if (val == 0) { + Board_LED_Set(LED_B, false); + } else { + Board_LED_Set(LED_B, true); + } +} +#endif +///////////////////////////////////////////////////////////////////////////////////////////////////// + +void initial_Trap(uint8_t * managerIP, uint8_t * agentIP) { + // SNMP Trap: WarmStart(1) Trap + { + dataEntryType enterprise_oid = {0x0a, {0x2b, 0x06, 0x01, 0x04, 0x01, 0x81, 0x9b, 0x19, 0x01, 0x00}, + SNMPDTYPE_OBJ_ID, 0x0a, {"\x2b\x06\x01\x04\x01\x81\x9b\x19\x10\x00"}, NULL, NULL + }; + // Generic Trap: warmStart COMMUNITY + snmp_sendTrap(managerIP, agentIP, (void *)COMMUNITY, enterprise_oid, SNMPTRAP_WARMSTART, 0, 0); + } + +} diff --git a/Internet/SNMP/snmp_custom.h b/Internet/SNMP/snmp_custom.h new file mode 100644 index 0000000..c200565 --- /dev/null +++ b/Internet/SNMP/snmp_custom.h @@ -0,0 +1,41 @@ +#ifndef _SNMP_CUSTOM_H_ +#define _SNMP_CUSTOM_H_ + +#ifdef __cplusplus +extern "C" { +#endif + +#include +#include +#include +#include + +#include "snmp.h" + +extern dataEntryType snmpData[]; +extern const int32_t maxData; + +// Define for using W5500-EVB: H/W Dependency (e.g., LEDs...) +//#define _USE_WIZNET_W5500_EVB_ + +#define COMMUNITY "public\0" +#define COMMUNITY_SIZE (strlen(COMMUNITY)) + +/* Predefined function: Response value control */ +void initTable(); + +/* User defined functions: LED control examples */ +#ifdef _USE_WIZNET_W5500_EVB_ +void get_LEDStatus_all(void *ptr, uint8_t *len); +void set_LEDStatus_R(int32_t val); +void set_LEDStatus_G(int32_t val); +void set_LEDStatus_B(int32_t val); +#endif +/* SNMP Trap: warmStart(1) */ +void initial_Trap(uint8_t * managerIP, uint8_t * agentIP); + +#ifdef __cplusplus +} +#endif + +#endif diff --git a/Internet/SNMP/tools/OID_Converter/Readme.txt b/Internet/SNMP/tools/OID_Converter/Readme.txt new file mode 100644 index 0000000..4476586 --- /dev/null +++ b/Internet/SNMP/tools/OID_Converter/Readme.txt @@ -0,0 +1,45 @@ +============================================================ + +============================================================ + ++ Example OID for convert + 1.3.6.1.4.1.19865.1.0 + +(1) Convert Usage + CMD>>oid 1.3.6.1.4.1.19865.1.0 + => 06 0A 2B 06 01 04 01 81 9B 19 01 00 + + >> TLV(tag-length-value) Example OID + (06) Tag + (0A) Length + [2B] 1(iso).3(identified-organization) (in ASN.1 BER encoding, i.e. 1*40+3 = 0x2b) + [06] 6(dod) + [01] 1(internet) + [04] 4(private) + [01] 1(enterprise) + [81 9B 19] 19865(Vendor-Specific) + ... + +(2) Add the entry to OID table in source code (DataEntryType, put the converted value to array) + {0x0a, {0x2b, 0x06, 0x01, 0x04, 0x01, 0x81, 0x9b, 0x19, 0x01, 0x00}, + SNMPDTYPE_OCTET_STRING, 30, {"long-length OID Test"}, + NULL, NULL}, + +============================================================ +OID Converter: OID encoder/decoder +v1.3 - Matthias Gaertner 1999/2001 - Freeware +============================================================ + +The OID converter is a handy little tool to convert ASN.1 OIDs from readable dotted decimal notation to binary hexadecimal Distinguished Encoding Rules (DER) representation and vice versa. +If you're into x.509 certificates, this may be useful to you, too. + +Usage: + OID [-c|-C] [-o] {-i|1.2.3.4} + converts dotted form to ASCII HEX DER output. + OID -x [-o] {-i|hex-digits} + decodes ASCII HEX DER and gives dotted form. + +If you need more information, please refer to Matthias Gaertner's page, +http://www.rtner.de/software/oid.html + +=============================================================================================== \ No newline at end of file diff --git a/Internet/SNMP/tools/net-snmp-5.7(win32-bin)/snmptrapd.conf b/Internet/SNMP/tools/net-snmp-5.7(win32-bin)/snmptrapd.conf new file mode 100644 index 0000000..494e4ec --- /dev/null +++ b/Internet/SNMP/tools/net-snmp-5.7(win32-bin)/snmptrapd.conf @@ -0,0 +1,33 @@ +# +# net-snmp (or ucd-snmp) persistent data file. +# +############################################################################ +# STOP STOP STOP STOP STOP STOP STOP STOP STOP +# +# **** DO NOT EDIT THIS FILE **** +# +# STOP STOP STOP STOP STOP STOP STOP STOP STOP +############################################################################ +# +# DO NOT STORE CONFIGURATION ENTRIES HERE. +# Please save normal configuration tokens for snmptrapd in SNMPCONFPATH/snmptrapd.conf. +# Only "createUser" tokens should be placed here by snmptrapd administrators. +# (Did I mention: do not edit this file?) +# + + +authCommunity log,execute,net public + + + + + + + + + + + + +engineBoots 1 +oldEngineID 0x80001f88803d6f00001ba7934e00000000 diff --git a/Internet/SNTP/sntp.c b/Internet/SNTP/sntp.c new file mode 100644 index 0000000..0a0424d --- /dev/null +++ b/Internet/SNTP/sntp.c @@ -0,0 +1,469 @@ +/* + sntp.c + + Created on: 2014. 12. 15. + Author: Administrator +*/ + + +#include + +#include "sntp.h" +#include "socket.h" + +ntpformat NTPformat; +datetime Nowdatetime; +uint8_t ntpmessage[48]; +uint8_t *data_buf; +uint8_t NTP_SOCKET; +uint8_t time_zone; +uint16_t ntp_retry_cnt = 0; //counting the ntp retry number + +/* + 00)UTC-12:00 Baker Island, Howland Island (both uninhabited) + 01) UTC-11:00 American Samoa, Samoa + 02) UTC-10:00 (Summer)French Polynesia (most), United States (Aleutian Islands, Hawaii) + 03) UTC-09:30 Marquesas Islands + 04) UTC-09:00 Gambier Islands;(Summer)United States (most of Alaska) + 05) UTC-08:00 (Summer)Canada (most of British Columbia), Mexico (Baja California) + 06) UTC-08:00 United States (California, most of Nevada, most of Oregon, Washington (state)) + 07) UTC-07:00 Mexico (Sonora), United States (Arizona); (Summer)Canada (Alberta) + 08) UTC-07:00 Mexico (Chihuahua), United States (Colorado) + 09) UTC-06:00 Costa Rica, El Salvador, Ecuador (Galapagos Islands), Guatemala, Honduras + 10) UTC-06:00 Mexico (most), Nicaragua;(Summer)Canada (Manitoba, Saskatchewan), United States (Illinois, most of Texas) + 11) UTC-05:00 Colombia, Cuba, Ecuador (continental), Haiti, Jamaica, Panama, Peru + 12) UTC-05:00 (Summer)Canada (most of Ontario, most of Quebec) + 13) UTC-05:00 United States (most of Florida, Georgia, Massachusetts, most of Michigan, New York, North Carolina, Ohio, Washington D.C.) + 14) UTC-04:30 Venezuela + 15) UTC-04:00 Bolivia, Brazil (Amazonas), Chile (continental), Dominican Republic, Canada (Nova Scotia), Paraguay, + 16) UTC-04:00 Puerto Rico, Trinidad and Tobago + 17) UTC-03:30 Canada (Newfoundland) + 18) UTC-03:00 Argentina; (Summer) Brazil (Brasilia, Rio de Janeiro, Sao Paulo), most of Greenland, Uruguay + 19) UTC-02:00 Brazil (Fernando de Noronha), South Georgia and the South Sandwich Islands + 20) UTC-01:00 Portugal (Azores), Cape Verde + 21) UTC±00:00 Cote d'Ivoire, Faroe Islands, Ghana, Iceland, Senegal; (Summer) Ireland, Portugal (continental and Madeira) + 22) UTC±00:00 Spain (Canary Islands), Morocco, United Kingdom + 23) UTC+01:00 Angola, Cameroon, Nigeria, Tunisia; (Summer)Albania, Algeria, Austria, Belgium, Bosnia and Herzegovina, + 24) UTC+01:00 Spain (continental), Croatia, Czech Republic, Denmark, Germany, Hungary, Italy, Kinshasa, Kosovo, + 25) UTC+01:00 Macedonia, France (metropolitan), the Netherlands, Norway, Poland, Serbia, Slovakia, Slovenia, Sweden, Switzerland + 26) UTC+02:00 Libya, Egypt, Malawi, Mozambique, South Africa, Zambia, Zimbabwe, (Summer)Bulgaria, Cyprus, Estonia, + 27) UTC+02:00 Finland, Greece, Israel, Jordan, Latvia, Lebanon, Lithuania, Moldova, Palestine, Romania, Syria, Turkey, Ukraine + 28) UTC+03:00 Belarus, Djibouti, Eritrea, Ethiopia, Iraq, Kenya, Madagascar, Russia (Kaliningrad Oblast), Saudi Arabia, + 29) UTC+03:00 South Sudan, Sudan, Somalia, South Sudan, Tanzania, Uganda, Yemen + 30) UTC+03:30 (Summer)Iran + 31) UTC+04:00 Armenia, Azerbaijan, Georgia, Mauritius, Oman, Russia (European), Seychelles, United Arab Emirates + 32) UTC+04:30 Afghanistan + 33) UTC+05:00 Kazakhstan (West), Maldives, Pakistan, Uzbekistan + 34) UTC+05:30 India, Sri Lanka + 35) UTC+05:45 Nepal + 36) UTC+06:00 Kazakhstan (most), Bangladesh, Russia (Ural: Sverdlovsk Oblast, Chelyabinsk Oblast) + 37) UTC+06:30 Cocos Islands, Myanmar + 38) UTC+07:00 Jakarta, Russia (Novosibirsk Oblast), Thailand, Vietnam + 39) UTC+08:00 China, Hong Kong, Russia (Krasnoyarsk Krai), Malaysia, Philippines, Singapore, Taiwan, most of Mongolia, Western Australia + 40) UTC+09:00 Korea, East Timor, Russia (Irkutsk Oblast), Japan + 41) UTC+09:30 Australia (Northern Territory);(Summer)Australia (South Australia)) + 42) UTC+10:00 Russia (Zabaykalsky Krai); (Summer)Australia (New South Wales, Queensland, Tasmania, Victoria) + 43) UTC+10:30 Lord Howe Island + 44) UTC+11:00 New Caledonia, Russia (Primorsky Krai), Solomon Islands + 45) UTC+11:30 Norfolk Island + 46) UTC+12:00 Fiji, Russia (Kamchatka Krai);(Summer)New Zealand + 47) UTC+12:45 (Summer)New Zealand + 48) UTC+13:00 Tonga + 49) UTC+14:00 Kiribati (Line Islands) +*/ +void get_seconds_from_ntp_server(uint8_t *buf, uint16_t idx) { + tstamp seconds = 0; + uint8_t i = 0; + for (i = 0; i < 4; i++) { + seconds = (seconds << 8) | buf[idx + i]; + } + switch (time_zone) { + case 0: + seconds -= 12 * 3600; + break; + case 1: + seconds -= 11 * 3600; + break; + case 2: + seconds -= 10 * 3600; + break; + case 3: + seconds -= (9 * 3600 + 30 * 60); + break; + case 4: + seconds -= 9 * 3600; + break; + case 5: + case 6: + seconds -= 8 * 3600; + break; + case 7: + case 8: + seconds -= 7 * 3600; + break; + case 9: + case 10: + seconds -= 6 * 3600; + break; + case 11: + case 12: + case 13: + seconds -= 5 * 3600; + break; + case 14: + seconds -= (4 * 3600 + 30 * 60); + break; + case 15: + case 16: + seconds -= 4 * 3600; + break; + case 17: + seconds -= (3 * 3600 + 30 * 60); + break; + case 18: + seconds -= 3 * 3600; + break; + case 19: + seconds -= 2 * 3600; + break; + case 20: + seconds -= 1 * 3600; + break; + case 21: //�? + case 22: + break; + case 23: + case 24: + case 25: + seconds += 1 * 3600; + break; + case 26: + case 27: + seconds += 2 * 3600; + break; + case 28: + case 29: + seconds += 3 * 3600; + break; + case 30: + seconds += (3 * 3600 + 30 * 60); + break; + case 31: + seconds += 4 * 3600; + break; + case 32: + seconds += (4 * 3600 + 30 * 60); + break; + case 33: + seconds += 5 * 3600; + break; + case 34: + seconds += (5 * 3600 + 30 * 60); + break; + case 35: + seconds += (5 * 3600 + 45 * 60); + break; + case 36: + seconds += 6 * 3600; + break; + case 37: + seconds += (6 * 3600 + 30 * 60); + break; + case 38: + seconds += 7 * 3600; + break; + case 39: + seconds += 8 * 3600; + break; + case 40: + seconds += 9 * 3600; + break; + case 41: + seconds += (9 * 3600 + 30 * 60); + break; + case 42: + seconds += 10 * 3600; + break; + case 43: + seconds += (10 * 3600 + 30 * 60); + break; + case 44: + seconds += 11 * 3600; + break; + case 45: + seconds += (11 * 3600 + 30 * 60); + break; + case 46: + seconds += 12 * 3600; + break; + case 47: + seconds += (12 * 3600 + 45 * 60); + break; + case 48: + seconds += 13 * 3600; + break; + case 49: + seconds += 14 * 3600; + break; + + } + + //calculation for date + calcdatetime(seconds); +} + +void SNTP_init(uint8_t s, uint8_t *ntp_server, uint8_t tz, uint8_t *buf) { + NTP_SOCKET = s; + + NTPformat.dstaddr[0] = ntp_server[0]; + NTPformat.dstaddr[1] = ntp_server[1]; + NTPformat.dstaddr[2] = ntp_server[2]; + NTPformat.dstaddr[3] = ntp_server[3]; + + time_zone = tz; + + data_buf = buf; + + uint8_t Flag; + NTPformat.leap = 0; /* leap indicator */ + NTPformat.version = 4; /* version number */ + NTPformat.mode = 3; /* mode */ + NTPformat.stratum = 0; /* stratum */ + NTPformat.poll = 0; /* poll interval */ + NTPformat.precision = 0; /* precision */ + NTPformat.rootdelay = 0; /* root delay */ + NTPformat.rootdisp = 0; /* root dispersion */ + NTPformat.refid = 0; /* reference ID */ + NTPformat.reftime = 0; /* reference time */ + NTPformat.org = 0; /* origin timestamp */ + NTPformat.rec = 0; /* receive timestamp */ + NTPformat.xmt = 1; /* transmit timestamp */ + + Flag = (NTPformat.leap << 6) + (NTPformat.version << 3) + NTPformat.mode; //one byte Flag + memcpy(ntpmessage, (void const*)(&Flag), 1); +} + +int8_t SNTP_run(datetime *time) { + uint16_t RSR_len; + uint32_t destip = 0; + uint16_t destport; + uint16_t startindex = 40; //last 8-byte of data_buf[size is 48 byte] is xmt, so the startindex should be 40 +#if 1 + // 20231019 taylor + uint8_t addr_len; +#endif + + switch (getSn_SR(NTP_SOCKET)) { + case SOCK_UDP: + if ((RSR_len = getSn_RX_RSR(NTP_SOCKET)) > 0) { + if (RSR_len > MAX_SNTP_BUF_SIZE) { + RSR_len = MAX_SNTP_BUF_SIZE; // if Rx data size is lager than TX_RX_MAX_BUF_SIZE + } +#if 1 + // 20231019 taylor//teddy 240122 +#if ((_WIZCHIP_ == 6100) || (_WIZCHIP_ == 6300)) + recvfrom(NTP_SOCKET, data_buf, RSR_len, (uint8_t *)&destip, &destport, &addr_len); +#else + recvfrom(NTP_SOCKET, data_buf, RSR_len, (uint8_t *)&destip, &destport); +#endif +#else + recvfrom(NTP_SOCKET, data_buf, RSR_len, (uint8_t *)&destip, &destport); +#endif + + get_seconds_from_ntp_server(data_buf, startindex); + time->yy = Nowdatetime.yy; + time->mo = Nowdatetime.mo; + time->dd = Nowdatetime.dd; + time->hh = Nowdatetime.hh; + time->mm = Nowdatetime.mm; + time->ss = Nowdatetime.ss; + + ntp_retry_cnt = 0; + close(NTP_SOCKET); + + return 1; + } + + if (ntp_retry_cnt < 0xFFFF) { + if (ntp_retry_cnt == 0) { //first send request, no need to wait +#if 1 + // 20231016 taylor//teddy 240122 +#if ((_WIZCHIP_ == 6100) || (_WIZCHIP_ == 6300)) + sendto(NTP_SOCKET, ntpmessage, sizeof(ntpmessage), NTPformat.dstaddr, ntp_port, 4); +#else + sendto(NTP_SOCKET, ntpmessage, sizeof(ntpmessage), NTPformat.dstaddr, ntp_port); +#endif +#else + sendto(NTP_SOCKET, ntpmessage, sizeof(ntpmessage), NTPformat.dstaddr, ntp_port); +#endif + ntp_retry_cnt++; + } else { // send request again? it should wait for a while + if ((ntp_retry_cnt % 0xFFF) == 0) { //wait time +#if 1 + // 20231016 taylor//teddy 240122 +#if ((_WIZCHIP_ == 6100) || (_WIZCHIP_ == 6300)) + sendto(NTP_SOCKET, ntpmessage, sizeof(ntpmessage), NTPformat.dstaddr, ntp_port, 4); +#else + sendto(NTP_SOCKET, ntpmessage, sizeof(ntpmessage), NTPformat.dstaddr, ntp_port); +#endif +#else + sendto(NTP_SOCKET, ntpmessage, sizeof(ntpmessage), NTPformat.dstaddr, ntp_port); +#endif +#ifdef _SNTP_DEBUG_ + printf("ntp retry: %d\r\n", ntp_retry_cnt); +#endif + ntp_retry_cnt++; + } + } + } else { //ntp retry fail + ntp_retry_cnt = 0; +#ifdef _SNTP_DEBUG_ + printf("ntp retry failed!\r\n"); +#endif + close(NTP_SOCKET); + } + break; + case SOCK_CLOSED: + socket(NTP_SOCKET, Sn_MR_UDP, ntp_port, 0); + break; + } + // Return value + // 0 - failed / 1 - success + return 0; +} + +void calcdatetime(tstamp seconds) { + uint8_t yf = 0; + uint8_t leap; + tstamp n = 0, d = 0, total_d = 0, rz = 0; + uint16_t y = 0, r = 0, yr = 0; + signed long long yd = 0; + + n = seconds; + total_d = seconds / (SECS_PERDAY); + d = 0; + uint32_t p_year_total_sec = SECS_PERDAY * 365; + uint32_t r_year_total_sec = SECS_PERDAY * 366; + + while (1) { + leap = 0; + if (((EPOCH + r) % 400 == 0) || + (((EPOCH + r) % 100 != 0) && ((EPOCH + r) % 4 == 0))) { + leap = 1; + } + + if (leap) { + if (n < r_year_total_sec) { + break; + } + n -= r_year_total_sec; + d += 366; + } else { + if (n < p_year_total_sec) { + break; + } + n -= p_year_total_sec; + d += 365; + } + + r++; + y++; + } + + y += EPOCH; + + Nowdatetime.yy = y; + + yd = 0; + yd = total_d - d; + + yf = 1; + while (yd >= 28) { + + if (yf == 1 || yf == 3 || yf == 5 || yf == 7 || yf == 8 || yf == 10 || yf == 12) { + yd -= 31; + if (yd < 0) { + break; + } + rz += 31; + } + + if (yf == 2) { + if (y % 400 == 0 || (y % 100 != 0 && y % 4 == 0)) { + yd -= 29; + if (yd < 0) { + break; + } + rz += 29; + } else { + yd -= 28; + if (yd < 0) { + break; + } + rz += 28; + } + } + if (yf == 4 || yf == 6 || yf == 9 || yf == 11) { + yd -= 30; + if (yd < 0) { + break; + } + rz += 30; + } + yf += 1; + + } + Nowdatetime.mo = yf; + yr = total_d - d - rz; + + yr += 1; + + Nowdatetime.dd = yr; + + //calculation for time + seconds = seconds % SECS_PERDAY; + Nowdatetime.hh = seconds / 3600; + Nowdatetime.mm = (seconds % 3600) / 60; + Nowdatetime.ss = (seconds % 3600) % 60; + +} + +tstamp changedatetime_to_seconds(void) { + tstamp seconds = 0; + uint32_t total_day = 0; + uint16_t i = 0, run_year_cnt = 0, l = 0; + + l = Nowdatetime.yy;//low + + + for (i = EPOCH; i < l; i++) { + if ((i % 400 == 0) || ((i % 100 != 0) && (i % 4 == 0))) { + run_year_cnt += 1; + } + } + + total_day = (l - EPOCH - run_year_cnt) * 365 + run_year_cnt * 366; + + for (i = 1; i <= Nowdatetime.mo; i++) { + if (i == 5 || i == 7 || i == 10 || i == 12) { + total_day += 30; + } + if (i == 3) { + if (l % 400 == 0 || l % 100 != 0 && l % 4 == 0) { + total_day += 29; + } else { + total_day += 28; + } + } + if (i == 2 || i == 4 || i == 6 || i == 8 || i == 9 || i == 11) { + total_day += 31; + } + } + + seconds = (total_day + Nowdatetime.dd - 1) * 24 * 3600; + seconds += Nowdatetime.ss;//seconds + seconds += Nowdatetime.mm * 60; //minute + seconds += Nowdatetime.hh * 3600; //hour + + return seconds; +} diff --git a/Internet/SNTP/sntp.h b/Internet/SNTP/sntp.h new file mode 100644 index 0000000..2327abd --- /dev/null +++ b/Internet/SNTP/sntp.h @@ -0,0 +1,74 @@ +/* + sntp.h + + Created on: 2014. 12. 15. + Author: Administrator +*/ + +#ifndef SNTP_H_ +#define SNTP_H_ + +#ifdef __cplusplus +extern "C" { +#endif + +#include + +/* + @brief Define it for Debug & Monitor DNS processing. + @note If defined, it dependens on +*/ +//#define _SNTP_DEBUG_ + +#define MAX_SNTP_BUF_SIZE sizeof(ntpformat) ///< maximum size of DNS buffer. */ + +/* for ntpclient */ +typedef signed char s_char; +typedef unsigned long long tstamp; +typedef unsigned int tdist; + +typedef struct _ntpformat { + + uint8_t dstaddr[4]; /* destination (local) address */ + char version; /* version number */ + char leap; /* leap indicator */ + char mode; /* mode */ + char stratum; /* stratum */ + char poll; /* poll interval */ + s_char precision; /* precision */ + tdist rootdelay; /* root delay */ + tdist rootdisp; /* root dispersion */ + char refid; /* reference ID */ + tstamp reftime; /* reference time */ + tstamp org; /* origin timestamp */ + tstamp rec; /* receive timestamp */ + tstamp xmt; /* transmit timestamp */ + + +} ntpformat; + +typedef struct _datetime { + uint16_t yy; + uint8_t mo; + uint8_t dd; + uint8_t hh; + uint8_t mm; + uint8_t ss; +} datetime; + +#define ntp_port 123 //ntp server port number +#define SECS_PERDAY 86400UL // seconds in a day = 60*60*24 +#define UTC_ADJ_HRS 9 // SEOUL : GMT+9 +#define EPOCH 1900 // NTP start year + +void get_seconds_from_ntp_server(uint8_t *buf, uint16_t idx); +void SNTP_init(uint8_t s, uint8_t *ntp_server, uint8_t tz, uint8_t *buf); +int8_t SNTP_run(datetime *time); +tstamp changedatetime_to_seconds(void); +void calcdatetime(tstamp seconds); + +#ifdef __cplusplus +} +#endif + +#endif /* SNTP_H_ */ diff --git a/Internet/TFTP/netutil.c b/Internet/TFTP/netutil.c new file mode 100644 index 0000000..aebcfc0 --- /dev/null +++ b/Internet/TFTP/netutil.c @@ -0,0 +1,151 @@ +#include +#include +#include +#include "netutil.h" + +/** + Convert a 32bit Address into a Dotted Decimal Format string. + + @param addr 32bit address. + @return Dotted Decimal Format string. +*/ +int8_t* inet_ntoa(uint32_t addr) { + static int8_t addr_str[16]; + memset(addr_str, 0, 16); + sprintf((char*)addr_str, "%d.%d.%d.%d", (int32_t)(addr >> 24 & 0xFF), (int32_t)(addr >> 16 & 0xFF), (int32_t)(addr >> 8 & 0xFF), (int32_t)(addr & 0xFF)); + return addr_str; +} + +/** + Convert a 32bit Address into a Dotted Decimal Format string. + This is differ from inet_ntoa in fixed length. + + @param addr 32bit address. + @return Dotted Decimal Format string. +*/ +int8_t* inet_ntoa_pad(uint32_t addr) { + static int8_t addr_str[16]; + memset(addr_str, 0, 16); + sprintf((char*)addr_str, "%03d.%03d.%03d.%03d", (int32_t)(addr >> 24 & 0xFF), (int32_t)(addr >> 16 & 0xFF), (int32_t)(addr >> 8 & 0xFF), (int32_t)(addr & 0xFF)); + return addr_str; +} + +/** + Converts a string containing an (Ipv4) Internet Protocol decimal dotted address into a 32bit address. + + @param addr Dotted Decimal Format string. + @return 32bit address. +*/ +uint32_t inet_addr(uint8_t* addr) { + int8_t i; + uint32_t inetaddr = 0; + int8_t taddr[30]; + int8_t * nexttok; + int32_t num; + strcpy((char*)taddr, (char*)addr); + + nexttok = taddr; + for (i = 0; i < 4 ; i++) { + nexttok = (int8_t*)strtok((char*)nexttok, "."); + if (nexttok[0] == '0' && nexttok[1] == 'x') { + num = strtol((char*)nexttok + 2, NULL, 16); + } else { + num = strtol((char*)nexttok, NULL, 10); + } + inetaddr = inetaddr << 8; + inetaddr |= (num & 0xFF); + nexttok = NULL; + } + return inetaddr; +} + +/** + Swap the byte order of 16bit(short) wide variable. + + @param i 16bit value to swap + @return Swapped value +*/ +uint16_t swaps(uint16_t i) { + uint16_t ret = 0; + ret = (i & 0xFF) << 8; + ret |= ((i >> 8) & 0xFF); + return ret; +} + +/** + Swap the byte order of 32bit(long) wide variable. + + @param l 32bit value to convert + @return Swapped value +*/ +uint32_t swapl(uint32_t l) { + uint32_t ret = 0; + ret = (l & 0xFF) << 24; + ret |= ((l >> 8) & 0xFF) << 16; + ret |= ((l >> 16) & 0xFF) << 8; + ret |= ((l >> 24) & 0xFF); + return ret; +} + +/** + htons function converts a unsigned short from host to TCP/IP network byte order (which is big-endian). + + @param hostshort The value to convert. + @return The value in TCP/IP network byte order. +*/ +uint16_t htons(uint16_t hostshort) { +#ifdef SYSTEM_LITTLE_ENDIAN + return swaps(hostshort); +#else + return hostshort; +#endif +} + + +/** + htonl function converts a unsigned long from host to TCP/IP network byte order (which is big-endian). + + @param hostlong The value to convert. + @return The value in TCP/IP network byte order. +*/ +uint32_t htonl(uint32_t hostlong) { +#ifdef SYSTEM_LITTLE_ENDIAN + return swapl(hostlong); +#else + return hostlong; +#endif +} + + +/** + ntohs function converts a unsigned short from TCP/IP network byte order + to host byte order (which is little-endian on Intel processors). + + @param netshort The value to convert. + @return A 16-bit number in host byte order +*/ +uint32_t ntohs(uint16_t netshort) { +#ifdef SYSTEM_LITTLE_ENDIAN + return htons(netshort); +#else + return netshort; +#endif +} + +/** + converts a unsigned long from TCP/IP network byte order to host byte order + (which is little-endian on Intel processors). + + @param netlong The value to convert. + @return A 16-bit number in host byte order +*/ +uint32_t ntohl(uint32_t netlong) { +#ifdef SYSTEM_LITTLE_ENDIAN + return swapl(netlong); +#else + return netlong; +#endif +} +/** + @} +*/ diff --git a/Internet/TFTP/netutil.h b/Internet/TFTP/netutil.h new file mode 100644 index 0000000..08375a3 --- /dev/null +++ b/Internet/TFTP/netutil.h @@ -0,0 +1,27 @@ + +#ifndef __NETUTIL_H__ +#define __NETUTIL_H__ + +#ifdef __cplusplus +extern "C" { +#endif + +#include + +#define SYSTEM_LITTLE_ENDIAN + +int8_t* inet_ntoa(uint32_t addr); +int8_t* inet_ntoa_pad(uint32_t addr); +uint32_t inet_addr(uint8_t* addr); +uint16_t swaps(uint16_t i); +uint32_t swapl(uint32_t l); +uint16_t htons(uint16_t hostshort); +uint32_t htonl(uint32_t hostlong); +uint32_t ntohs(uint16_t netshort); +uint32_t ntohl(uint32_t netlong); + +#ifdef __cplusplus +} +#endif + +#endif diff --git a/Internet/TFTP/tftp.c b/Internet/TFTP/tftp.c new file mode 100644 index 0000000..176c971 --- /dev/null +++ b/Internet/TFTP/tftp.c @@ -0,0 +1,639 @@ +/** + @file tftp.c + @brief TFTP Source File. + @version 0.1.0 + @author Sang-sik Kim +*/ + +/* Includes -----------------------------------------------------*/ +#include +#include "tftp.h" +#include "socket.h" +#include "netutil.h" + +/* define -------------------------------------------------------*/ + +/* typedef ------------------------------------------------------*/ + +/* Extern Variable ----------------------------------------------*/ + +/* Extern Functions ---------------------------------------------*/ +#ifdef F_STORAGE +extern void save_data(uint8_t *data, uint32_t data_len, uint16_t block_number); +#endif + +/* Global Variable ----------------------------------------------*/ +static int g_tftp_socket = -1; + +static uint8_t g_filename[FILE_NAME_SIZE]; + +static uint32_t g_server_ip = 0; +static uint16_t g_server_port = 0; +static uint16_t g_local_port = 0; + +static uint32_t g_tftp_state = STATE_NONE; +static uint16_t g_block_num = 0; + +static uint32_t g_timeout = 5; +static uint32_t g_resend_flag = 0; +static uint32_t tftp_time_cnt = 0; +static uint32_t tftp_retry_cnt = 0; + +static uint8_t *g_tftp_rcv_buf = NULL; + +static TFTP_OPTION default_tftp_opt = { + .code = (uint8_t *)"timeout", + .value = (uint8_t *)"5" +}; + +uint8_t g_progress_state = TFTP_PROGRESS; + +#ifdef __TFTP_DEBUG__ +int dbg_level = (INFO_DBG | ERROR_DBG | IPC_DBG); +#endif + +/* static function define ---------------------------------------*/ +static void set_filename(uint8_t *file, uint32_t file_size) { + memcpy(g_filename, file, file_size); +} + +static inline void set_server_ip(uint32_t ipaddr) { + g_server_ip = ipaddr; +} + +static inline uint32_t get_server_ip() { + return g_server_ip; +} + +static inline void set_server_port(uint16_t port) { + g_server_port = port; +} + +static inline uint16_t get_server_port() { + return g_server_port; +} + +static inline void set_local_port(uint16_t port) { + g_local_port = port; +} + +static inline uint16_t get_local_port() { + return g_local_port; +} + +static inline uint16_t genernate_port() { + /* TODO */ + return 0; +} + +static inline void set_tftp_state(uint32_t state) { + g_tftp_state = state; +} + +static inline uint32_t get_tftp_state() { + return g_tftp_state; +} + +static inline void set_tftp_timeout(uint32_t timeout) { + g_timeout = timeout; +} + +static inline uint32_t get_tftp_timeout() { + return g_timeout; +} + +static inline void set_block_number(uint16_t block_number) { + g_block_num = block_number; +} + +static inline uint16_t get_block_number() { + return g_block_num; +} + +static int open_tftp_socket(uint8_t sock) { + uint8_t sd, sck_state; + + sd = socket(sock, Sn_MR_UDP, 51000, SF_IO_NONBLOCK); + if (sd != sock) { + //DBG_PRINT(ERROR_DBG, "[%s] socket error\r\n", __func__); + return -1; + } + + do { + getsockopt(sd, SO_STATUS, &sck_state); + } while (sck_state != SOCK_UDP); + + return sd; +} + +static int send_udp_packet(int socket, uint8_t *packet, uint32_t len, uint32_t ip, uint16_t port) { + int snd_len; + + ip = htonl(ip); + +#if 1 + // 20231016 taylor//teddy 240122 +#if ((_WIZCHIP_ == 6100) || (_WIZCHIP_ == 6300)) + snd_len = sendto(socket, packet, len, (uint8_t *)&ip, port, 4); +#else + snd_len = sendto(socket, packet, len, (uint8_t *)&ip, port); +#endif +#else + snd_len = sendto(socket, packet, len, (uint8_t *)&ip, port); +#endif + if (snd_len != len) { + //DBG_PRINT(ERROR_DBG, "[%s] sendto error\r\n", __func__); + return -1; + } + + return snd_len; +} + +static int recv_udp_packet(int socket, uint8_t *packet, uint32_t len, uint32_t *ip, uint16_t *port) { + int ret; + uint8_t sck_state; + uint16_t recv_len; +#if 1 + // 20231019 taylor + uint8_t addr_len; +#endif + + /* Receive Packet Process */ + ret = getsockopt(socket, SO_STATUS, &sck_state); + if (ret != SOCK_OK) { + //DBG_PRINT(ERROR_DBG, "[%s] getsockopt SO_STATUS error\r\n", __func__); + return -1; + } + + if (sck_state == SOCK_UDP) { + ret = getsockopt(socket, SO_RECVBUF, &recv_len); + if (ret != SOCK_OK) { + //DBG_PRINT(ERROR_DBG, "[%s] getsockopt SO_RECVBUF error\r\n", __func__); + return -1; + } + + if (recv_len) { +#if 1 + // 20231019 taylor//teddy 240122 +#if ((_WIZCHIP_ == 6100) || (_WIZCHIP_ == 6300)) + recv_len = recvfrom(socket, packet, len, (uint8_t *)ip, port, &addr_len); +#else + recv_len = recvfrom(socket, packet, len, (uint8_t *)ip, port); +#endif +#else + recv_len = recvfrom(socket, packet, len, (uint8_t *)ip, port); +#endif + if (recv_len < 0) { + //DBG_PRINT(ERROR_DBG, "[%s] recvfrom error\r\n", __func__); + return -1; + } + + *ip = ntohl(*ip); + + return recv_len; + } + } + return -1; +} + +static void close_tftp_socket(int socket) { + close(socket); +} + + +static void init_tftp(void) { + g_filename[0] = 0; + + set_server_ip(0); + set_server_port(0); + set_local_port(0); + + set_tftp_state(STATE_NONE); + set_block_number(0); + + /* timeout flag */ + g_resend_flag = 0; + tftp_retry_cnt = tftp_time_cnt = 0; + + g_progress_state = TFTP_PROGRESS; +} + +static void tftp_cancel_timeout(void) { + if (g_resend_flag) { + g_resend_flag = 0; + tftp_retry_cnt = tftp_time_cnt = 0; + } +} + +static void tftp_reg_timeout() { + if (g_resend_flag == 0) { + g_resend_flag = 1; + tftp_retry_cnt = tftp_time_cnt = 0; + } +} + +static void process_tftp_option(uint8_t *msg, uint32_t msg_len) { + /* TODO Option Process */ +} + +static void send_tftp_rrq(uint8_t *filename, uint8_t *mode, TFTP_OPTION *opt, uint8_t opt_len) { + uint8_t snd_buf[MAX_MTU_SIZE]; + uint8_t *pkt = snd_buf; + uint32_t i, len; + + *((uint16_t *)pkt) = htons(TFTP_RRQ); + pkt += 2; + strcpy((char *)pkt, (const char *)filename); + pkt += strlen((char *)filename) + 1; + strcpy((char *)pkt, (const char *)mode); + pkt += strlen((char *)mode) + 1; + + for (i = 0 ; i < opt_len ; i++) { + strcpy((char *)pkt, (const char *)opt[i].code); + pkt += strlen((char *)opt[i].code) + 1; + strcpy((char *)pkt, (const char *)opt[i].value); + pkt += strlen((char *)opt[i].value) + 1; + } + + len = pkt - snd_buf; + + send_udp_packet(g_tftp_socket, snd_buf, len, get_server_ip(), TFTP_SERVER_PORT); + set_tftp_state(STATE_RRQ); + set_filename(filename, strlen((char *)filename) + 1); + tftp_reg_timeout(); +#ifdef __TFTP_DEBUG__ + DBG_PRINT(IPC_DBG, ">> TFTP RRQ : FileName(%s), Mode(%s)\r\n", filename, mode); +#endif +} + +#if 0 // 2014.07.01 sskim +static void send_tftp_wrq(uint8_t *filename, uint8_t *mode, TFTP_OPTION *opt, uint8_t opt_len) { + uint8_t snd_buf[MAX_MTU_SIZE]; + uint8_t *pkt = snd_buf; + uint32_t i, len; + + *((uint16_t *)pkt) = htons((uint16_t)TFTP_WRQ); + pkt += 2; + strcpy((char *)pkt, (const char *)filename); + pkt += strlen((char *)filename) + 1; + strcpy((char *)pkt, (const char *)mode); + pkt += strlen((char *)mode) + 1; + + for (i = 0 ; i < opt_len ; i++) { + strcpy((char *)pkt, (const char *)opt[i].code); + pkt += strlen((char *)opt[i].code) + 1; + strcpy((char *)pkt, (const char *)opt[i].value); + pkt += strlen((char *)opt[i].value) + 1; + } + + len = pkt - snd_buf; + + send_udp_packet(g_tftp_socket, snd_buf, len, get_server_ip(), TFTP_SERVER_PORT); + set_tftp_state(STATE_WRQ); + set_filename(filename, strlen((char *)filename) + 1); + tftp_reg_timeout(); +#ifdef __TFTP_DEBUG__ + DBG_PRINT(IPC_DBG, ">> TFTP WRQ : FileName(%s), Mode(%s)\r\n", filename, mode); +#endif +} +#endif + +#if 0 // 2014.07.01 sskim +static void send_tftp_data(uint16_t block_number, uint8_t *data, uint16_t data_len) { + uint8_t snd_buf[MAX_MTU_SIZE]; + uint8_t *pkt = snd_buf; + uint32_t len; + + *((uint16_t *)pkt) = htons((uint16_t)TFTP_DATA); + pkt += 2; + *((uint16_t *)pkt) = htons(block_number); + pkt += 2; + memcpy(pkt, data, data_len); + pkt += data_len; + + len = pkt - snd_buf; + + send_udp_packet(g_tftp_socket, snd_buf, len, get_server_ip(), get_server_port()); + tftp_reg_timeout(); +#ifdef __TFTP_DEBUG__ + DBG_PRINT(IPC_DBG, ">> TFTP DATA : Block Number(%d), Data Length(%d)\r\n", block_number, data_len); +#endif +} +#endif + +static void send_tftp_ack(uint16_t block_number) { + uint8_t snd_buf[4]; + uint8_t *pkt = snd_buf; + + *((uint16_t *)pkt) = htons((uint16_t)TFTP_ACK); + pkt += 2; + *((uint16_t *)pkt) = htons(block_number); + pkt += 2; + + send_udp_packet(g_tftp_socket, snd_buf, 4, get_server_ip(), get_server_port()); + tftp_reg_timeout(); +#ifdef __TFTP_DEBUG__ + DBG_PRINT(IPC_DBG, ">> TFTP ACK : Block Number(%d)\r\n", block_number); +#endif +} + +#if 0 // 2014.07.01 sskim +static void send_tftp_oack(TFTP_OPTION *opt, uint8_t opt_len) { + uint8_t snd_buf[MAX_MTU_SIZE]; + uint8_t *pkt = snd_buf; + uint32_t i, len; + + *((uint16_t *)pkt) = htons((uint16_t)TFTP_OACK); + pkt += 2; + + for (i = 0 ; i < opt_len ; i++) { + strcpy((char *)pkt, (const char *)opt[i].code); + pkt += strlen((char *)opt[i].code) + 1; + strcpy((char *)pkt, (const char *)opt[i].value); + pkt += strlen((char *)opt[i].value) + 1; + } + + len = pkt - snd_buf; + + send_udp_packet(g_tftp_socket, snd_buf, len, get_server_ip(), get_server_port()); + tftp_reg_timeout(); +#ifdef __TFTP_DEBUG__ + DBG_PRINT(IPC_DBG, ">> TFTP OACK \r\n"); +#endif +} +#endif + +#if 0 // 2014.07.01 sskim +static void send_tftp_error(uint16_t error_number, uint8_t *error_message) { + uint8_t snd_buf[MAX_MTU_SIZE]; + uint8_t *pkt = snd_buf; + uint32_t len; + + *((uint16_t *)pkt) = htons((uint16_t)TFTP_ERROR); + pkt += 2; + *((uint16_t *)pkt) = htons(error_number); + pkt += 2; + strcpy((char *)pkt, (const char *)error_message); + pkt += strlen((char *)error_message) + 1; + + len = pkt - snd_buf; + + send_udp_packet(g_tftp_socket, snd_buf, len, get_server_ip(), get_server_port()); + tftp_reg_timeout(); +#ifdef __TFTP_DEBUG__ + DBG_PRINT(IPC_DBG, ">> TFTP ERROR : Error Number(%d)\r\n", error_number); +#endif +} +#endif + +static void recv_tftp_rrq(uint8_t *msg, uint32_t msg_len) { + /* When TFTP Server Mode */ +} + +static void recv_tftp_wrq(uint8_t *msg, uint32_t msg_len) { + /* When TFTP Server Mode */ +} + +static void recv_tftp_data(uint8_t *msg, uint32_t msg_len) { + TFTP_DATA_T *data = (TFTP_DATA_T *)msg; + + data->opcode = ntohs(data->opcode); + data->block_num = ntohs(data->block_num); +#ifdef __TFTP_DEBUG__ + DBG_PRINT(IPC_DBG, "<< TFTP_DATA : opcode(%d), block_num(%d)\r\n", data->opcode, data->block_num); +#endif + + switch (get_tftp_state()) { + case STATE_RRQ : + case STATE_OACK : + if (data->block_num == 1) { + set_tftp_state(STATE_DATA); + set_block_number(data->block_num); +#ifdef F_STORAGE + save_data(data->data, msg_len - 4, data->block_num); +#endif + tftp_cancel_timeout(); + } + send_tftp_ack(data->block_num); + + if ((msg_len - 4) < TFTP_BLK_SIZE) { + init_tftp(); + g_progress_state = TFTP_SUCCESS; + } + + break; + + case STATE_DATA : + if (data->block_num == (get_block_number() + 1)) { + set_block_number(data->block_num); +#ifdef F_STORAGE + save_data(data->data, msg_len - 4, data->block_num); +#endif + tftp_cancel_timeout(); + } + send_tftp_ack(data->block_num); + + if ((msg_len - 4) < TFTP_BLK_SIZE) { + init_tftp(); + g_progress_state = TFTP_SUCCESS; + } + + break; + + default : + /* invalid message */ + break; + } +} + +static void recv_tftp_ack(uint8_t *msg, uint32_t msg_len) { +#ifdef __TFTP_DEBUG__ + DBG_PRINT(IPC_DBG, "<< TFTP_ACK : \r\n"); +#endif + + switch (get_tftp_state()) { + case STATE_WRQ : + break; + + case STATE_ACK : + break; + + default : + /* invalid message */ + break; + } +} + +static void recv_tftp_oack(uint8_t *msg, uint32_t msg_len) { +#ifdef __TFTP_DEBUG__ + DBG_PRINT(IPC_DBG, "<< TFTP_OACK : \r\n"); +#endif + + switch (get_tftp_state()) { + case STATE_RRQ : + process_tftp_option(msg, msg_len); + set_tftp_state(STATE_OACK); + tftp_cancel_timeout(); + send_tftp_ack(0); + break; + + case STATE_WRQ : + process_tftp_option(msg, msg_len); + set_tftp_state(STATE_ACK); + tftp_cancel_timeout(); + + /* TODO DATA Transfer */ + //send_tftp_data(...); + break; + + default : + /* invalid message */ + break; + } +} + +static void recv_tftp_error(uint8_t *msg, uint32_t msg_len) { + TFTP_ERROR_T *data = (TFTP_ERROR_T *)msg; + + data->opcode = ntohs(data->opcode); + data->error_code = ntohs(data->error_code); + +#ifdef __TFTP_DEBUG__ + DBG_PRINT(IPC_DBG, "<< TFTP_ERROR : %d (%s)\r\n", data->error_code, data->error_msg); + DBG_PRINT(ERROR_DBG, "[%s] Error Code : %d (%s)\r\n", __func__, data->error_code, data->error_msg); +#endif + init_tftp(); + g_progress_state = TFTP_FAIL; +} + +static void recv_tftp_packet(uint8_t *packet, uint32_t packet_len, uint32_t from_ip, uint16_t from_port) { + uint16_t opcode; + + /* Verify Server IP */ + if (from_ip != get_server_ip()) { +#ifdef __TFTP_DEBUG__ + DBG_PRINT(ERROR_DBG, "[%s] Server IP faults\r\n", __func__); + DBG_PRINT(ERROR_DBG, "from IP : %08x, Server IP : %08x\r\n", from_ip, get_server_ip()); +#endif + return; + } + + opcode = ntohs(*((uint16_t *)packet)); + + /* Set Server Port */ + if ((get_tftp_state() == STATE_WRQ) || (get_tftp_state() == STATE_RRQ)) { + set_server_port(from_port); +#ifdef __TFTP_DEBUG__ + DBG_PRINT(INFO_DBG, "[%s] Set Server Port : %d\r\n", __func__, from_port); +#endif + } + + switch (opcode) { + case TFTP_RRQ : /* When Server */ + recv_tftp_rrq(packet, packet_len); + break; + case TFTP_WRQ : /* When Server */ + recv_tftp_wrq(packet, packet_len); + break; + case TFTP_DATA : + recv_tftp_data(packet, packet_len); + break; + case TFTP_ACK : + recv_tftp_ack(packet, packet_len); + break; + case TFTP_OACK : + recv_tftp_oack(packet, packet_len); + break; + case TFTP_ERROR : + recv_tftp_error(packet, packet_len); + break; + + default : + // Unknown Mesage + break; + } +} + +/* Functions ----------------------------------------------------*/ +void TFTP_init(uint8_t socket, uint8_t *buf) { + init_tftp(); + + g_tftp_socket = open_tftp_socket(socket); + g_tftp_rcv_buf = buf; +} + +void TFTP_exit(void) { + init_tftp(); + + close_tftp_socket(g_tftp_socket); + g_tftp_socket = -1; + + g_tftp_rcv_buf = NULL; +} + +int TFTP_run(void) { + uint16_t len, from_port; + uint32_t from_ip; + + /* Timeout Process */ + if (g_resend_flag) { + if (tftp_time_cnt >= g_timeout) { + switch (get_tftp_state()) { + case STATE_WRQ: // 미구현 + break; + + case STATE_RRQ: + send_tftp_rrq(g_filename, (uint8_t *)TRANS_BINARY, &default_tftp_opt, 1); + break; + + case STATE_OACK: + case STATE_DATA: + send_tftp_ack(get_block_number()); + break; + + case STATE_ACK: // 미구현 + break; + + default: + break; + } + + tftp_time_cnt = 0; + tftp_retry_cnt++; + + if (tftp_retry_cnt >= 5) { + init_tftp(); + g_progress_state = TFTP_FAIL; + } + } + } + + /* Receive Packet Process */ + len = recv_udp_packet(g_tftp_socket, g_tftp_rcv_buf, MAX_MTU_SIZE, &from_ip, &from_port); + if (len < 0) { +#ifdef __TFTP_DEBUG__ + DBG_PRINT(ERROR_DBG, "[%s] recv_udp_packet error\r\n", __func__); +#endif + return g_progress_state; + } + + recv_tftp_packet(g_tftp_rcv_buf, len, from_ip, from_port); + + return g_progress_state; +} + +void TFTP_read_request(uint32_t server_ip, uint8_t *filename) { + set_server_ip(server_ip); +#ifdef __TFTP_DEBUG__ + DBG_PRINT(INFO_DBG, "[%s] Set Tftp Server : %x\r\n", __func__, server_ip); +#endif + + g_progress_state = TFTP_PROGRESS; + send_tftp_rrq(filename, (uint8_t *)TRANS_BINARY, &default_tftp_opt, 1); +} + +void tftp_timeout_handler(void) { + if (g_resend_flag) { + tftp_time_cnt++; + } +} diff --git a/Internet/TFTP/tftp.h b/Internet/TFTP/tftp.h new file mode 100644 index 0000000..699e39f --- /dev/null +++ b/Internet/TFTP/tftp.h @@ -0,0 +1,102 @@ +/** + @file tftp.h + @brief TFTP Header File. + @version 0.1.0 + @author Sang-sik Kim +*/ +#ifndef __TFTP_H__ +#define __TFTP_H__ + +#ifdef __cplusplus +extern "C" { +#endif + +#include +#include + +#define F_APP_TFTP +#define __TFTP_DEBUG__ + +// #define F_STORAGE // If your target support a storage, you have to activate this feature and implement. + +#define SOCK_TFTP 1 + +#define INFO_DBG 0x01 +#define ERROR_DBG 0x02 +#define DEBUG_DBG 0x04 +#define IPC_DBG 0x08 + +#define DBG_PRINT(level, format, args...) { \ + if(dbg_level & level) \ + printf(format, ##args); \ + } + +#define NORMAL_MODE 0 +#define TFTP_MODE 1 + +extern int dbg_level; + +/* tftp message */ +#define TFTP_RRQ 1 +#define TFTP_WRQ 2 +#define TFTP_DATA 3 +#define TFTP_ACK 4 +#define TFTP_ERROR 5 +#define TFTP_OACK 6 + +/* tftp state */ +#define STATE_NONE 0 +#define STATE_RRQ 1 +#define STATE_WRQ 2 +#define STATE_DATA 3 +#define STATE_ACK 4 +#define STATE_OACK 5 + +/* tftp transfer mode */ +#define TRANS_ASCII "netascii" +#define TRANS_BINARY "octet" + +/* tftp progress state */ +#define TFTP_PROGRESS 0 +#define TFTP_FAIL 1 +#define TFTP_SUCCESS 2 + +/* define */ +#define TFTP_SERVER_PORT 69 +#define TFTP_TEMP_PORT 51000 +#define TFTP_BLK_SIZE 512 +#define MAX_MTU_SIZE 1514 +#define FILE_NAME_SIZE 20 + +//#define __TFTP_DEBUG__ + +/* typedef */ +typedef struct tftp_data { + uint16_t opcode; + uint16_t block_num; + uint8_t data[0]; +} TFTP_DATA_T; + +typedef struct tftp_error { + uint16_t opcode; + uint16_t error_code; + uint8_t error_msg[0]; +} TFTP_ERROR_T; + +typedef struct tftp_option { + uint8_t *code; + uint8_t *value; +} TFTP_OPTION; + +/* Functions */ +void TFTP_init(uint8_t socket, uint8_t *buf); +void TFTP_exit(void); +int TFTP_run(void); +void TFTP_read_request(uint32_t server_ip, uint8_t *filename); +void tftp_timeout_handler(void); + +#ifdef __cplusplus +} +#endif + +#endif /*__TFTP_H__ */ diff --git a/Internet/httpServer/httpParser.c b/Internet/httpServer/httpParser.c new file mode 100644 index 0000000..b7c77e8 --- /dev/null +++ b/Internet/httpServer/httpParser.c @@ -0,0 +1,430 @@ +/** + @file httpd.c + @brief functions associated http processing +*/ + +#include +#include +#include "socket.h" +#include "httpParser.h" + +/***************************************************************************** + Public types/enumerations/variables + ****************************************************************************/ +//uint8_t BUFPUB[2048]; +uint8_t BUFPUB[256]; + +/***************************************************************************** + Private functions + ****************************************************************************/ +static void replacetochar(uint8_t * str, uint8_t oldchar, uint8_t newchar); /* Replace old character with new character in the string */ +static uint8_t C2D(uint8_t c); /* Convert a character to HEX */ + +/** + @brief convert escape characters(%XX) to ASCII character +*/ +void unescape_http_url( + char * url /**< pointer to be converted ( escape characters )*/ +) { + int x, y; + + for (x = 0, y = 0; url[y]; ++x, ++y) { + if ((url[x] = url[y]) == '%') { + url[x] = C2D(url[y + 1]) * 0x10+C2D(url[y + 2]); + y += 2; + } + } + url[x] = '\0'; +} + + +/** + @brief make response header such as html, gif, jpeg,etc. +*/ +void make_http_response_head( + char * buf, /**< pointer to response header to be made */ + char type, /**< response type */ + uint32_t len /**< size of response header */ +) { + char * head; + char tmp[10]; + + /* file type*/ + if (type == PTYPE_HTML) { + head = RES_HTMLHEAD_OK; + } else if (type == PTYPE_GIF) { + head = RES_GIFHEAD_OK; + } else if (type == PTYPE_TEXT) { + head = RES_TEXTHEAD_OK; + } else if (type == PTYPE_JPEG) { + head = RES_JPEGHEAD_OK; + } else if (type == PTYPE_FLASH) { + head = RES_FLASHHEAD_OK; + } else if (type == PTYPE_XML) { + head = RES_XMLHEAD_OK; + } else if (type == PTYPE_CSS) { + head = RES_CSSHEAD_OK; + } else if (type == PTYPE_JSON) { + head = RES_JSONHEAD_OK; + } else if (type == PTYPE_JS) { + head = RES_JSHEAD_OK; + } else if (type == PTYPE_CGI) { + head = RES_CGIHEAD_OK; + } else if (type == PTYPE_PNG) { + head = RES_PNGHEAD_OK; + } else if (type == PTYPE_ICO) { + head = RES_ICOHEAD_OK; + } else if (type == PTYPE_TTF) { + head = RES_TTFHEAD_OK; + } else if (type == PTYPE_OTF) { + head = RES_OTFHEAD_OK; + } else if (type == PTYPE_WOFF) { + head = RES_WOFFHEAD_OK; + } else if (type == PTYPE_EOT) { + head = RES_EOTHEAD_OK; + } else if (type == PTYPE_SVG) { + head = RES_SVGHEAD_OK; + } +#ifdef _HTTPPARSER_DEBUG_ + else { + head = NULL; + printf("\r\n\r\n-MAKE HEAD UNKNOWN-\r\n"); + } +#else + else { + head = NULL; + } +#endif + + sprintf(tmp, "%ld", len); + strcpy(buf, head); + strcat(buf, tmp); + strcat(buf, "\r\n\r\n"); +} + + +/** + @brief find MIME type of a file +*/ +void find_http_uri_type( + uint8_t * type, /**< type to be returned */ + uint8_t * buff /**< file name */ +) { + /* Decide type according to extension*/ + + char * buf; + buf = (char *)buff; + + if (strstr(buf, ".htm") || strstr(buf, ".html")) { + *type = PTYPE_HTML; + } else if (strstr(buf, ".gif")) { + *type = PTYPE_GIF; + } else if (strstr(buf, ".text") || strstr(buf, ".txt")) { + *type = PTYPE_TEXT; + } else if (strstr(buf, ".jpeg") || strstr(buf, ".jpg")) { + *type = PTYPE_JPEG; + } else if (strstr(buf, ".swf")) { + *type = PTYPE_FLASH; + } else if (strstr(buf, ".cgi") || strstr(buf, ".CGI")) { + *type = PTYPE_CGI; + } else if (strstr(buf, ".json") || strstr(buf, ".JSON")) { + *type = PTYPE_JSON; + } else if (strstr(buf, ".js") || strstr(buf, ".JS")) { + *type = PTYPE_JS; + } else if (strstr(buf, ".CGI") || strstr(buf, ".cgi")) { + *type = PTYPE_CGI; + } else if (strstr(buf, ".xml") || strstr(buf, ".XML")) { + *type = PTYPE_XML; + } else if (strstr(buf, ".css") || strstr(buf, ".CSS")) { + *type = PTYPE_CSS; + } else if (strstr(buf, ".png") || strstr(buf, ".PNG")) { + *type = PTYPE_PNG; + } else if (strstr(buf, ".ico") || strstr(buf, ".ICO")) { + *type = PTYPE_ICO; + } else if (strstr(buf, ".ttf") || strstr(buf, ".TTF")) { + *type = PTYPE_TTF; + } else if (strstr(buf, ".otf") || strstr(buf, ".OTF")) { + *type = PTYPE_OTF; + } else if (strstr(buf, ".woff") || strstr(buf, ".WOFF")) { + *type = PTYPE_WOFF; + } else if (strstr(buf, ".eot") || strstr(buf, ".EOT")) { + *type = PTYPE_EOT; + } else if (strstr(buf, ".svg") || strstr(buf, ".SVG")) { + *type = PTYPE_SVG; + } else { + *type = PTYPE_ERR; + } +} + + +/** + @brief parse http request from a peer +*/ +void parse_http_request( + st_http_request * request, /**< request to be returned */ + uint8_t * buf /**< pointer to be parsed */ +) { + char * nexttok; + nexttok = strtok((char*)buf, " "); + if (!nexttok) { + request->METHOD = METHOD_ERR; + return; + } + if (!strcmp(nexttok, "GET") || !strcmp(nexttok, "get")) { + request->METHOD = METHOD_GET; + nexttok = strtok(NULL, " "); + + } else if (!strcmp(nexttok, "HEAD") || !strcmp(nexttok, "head")) { + request->METHOD = METHOD_HEAD; + nexttok = strtok(NULL, " "); + + } else if (!strcmp(nexttok, "POST") || !strcmp(nexttok, "post")) { + nexttok = strtok(NULL, "\0"); + request->METHOD = METHOD_POST; + } else { + request->METHOD = METHOD_ERR; + } + + if (!nexttok) { + request->METHOD = METHOD_ERR; + return; + } + strcpy((char *)request->URI, nexttok); +} + +#ifdef _OLD_ +/** + @brief get next parameter value in the request +*/ +uint8_t * get_http_param_value( + char* uri, + char* param_name +) { + char tempURI[MAX_URI_SIZE]; + uint8_t * name = 0; + + + if (!uri || !param_name) { + return 0; + } + + strcpy((char*)tempURI, uri); + if ((name = (uint8_t *)strstr(tempURI, param_name))) { + name += strlen(param_name) + 1; // strlen(para_name) + strlen("=") + if ((name = (uint8_t *)strtok((char *)name, "& \r\n\t\0"))) { + unescape_http_url((char *)name); + replacetochar(name, '+', ' '); + } + } +#ifdef _HTTPPARSER_DEBUG_ + printf(" %s=%s", param_name, name); +#endif + + return name; +} +#else +/** + @brief get next parameter value in the request +*/ +uint8_t * get_http_param_value(char* uri, char* param_name) { + + uint8_t * name = 0; + uint8_t * ret = BUFPUB; + uint8_t * pos2; + uint16_t len = 0, content_len = 0; + uint8_t tmp_buf[10] = {0x00, }; + + if (!uri || !param_name) { + return 0; + } + + /***************/ + mid(uri, "Content-Length: ", "\r\n", (char *)tmp_buf); + content_len = ATOI(tmp_buf, 10); + uri = strstr(uri, "\r\n\r\n"); + uri += 4; + uri[content_len] = 0; + /***************/ + + if ((name = (uint8_t *)strstr(uri, param_name))) { + name += strlen(param_name) + 1; + pos2 = (uint8_t*)strstr((char*)name, "&"); + if (!pos2) { + pos2 = name + strlen((char*)name); + } + len = pos2 - name; + + if (len) { + ret[len] = 0; + strncpy((char*)ret, (char*)name, len); + unescape_http_url((char *)ret); + replacetochar(ret, '+', ' '); + //ret[len] = 0; + //ret[strlen((int8*)ret)] = 0; + //printf("len=%d\r\n",len); + } else { + ret[0] = 0; + } + } else { + return 0; + } +#ifdef _HTTPPARSER_DEBUG_ + printf(" %s=%s\r\n", param_name, ret); +#endif + return ret; +} +#endif + +#ifdef _OLD_ +uint8_t * get_http_uri_name(uint8_t * uri) { + char tempURI[MAX_URI_SIZE]; + uint8_t * uri_name; + + if (!uri) { + return 0; + } + + strcpy(tempURI, (char *)uri); + + uri_name = (uint8_t *)strtok(tempURI, " ?"); + + if (strcmp((char *)uri_name, "/")) { + uri_name++; + } + +#ifdef _HTTPPARSER_DEBUG_ + printf(" uri_name = %s\r\n", uri_name); +#endif + + return uri_name; +} +#else + +uint8_t get_http_uri_name(uint8_t * uri, uint8_t * uri_buf) { + uint8_t * uri_ptr; + if (!uri) { + return 0; + } + + strcpy((char *)uri_buf, (char *)uri); + + uri_ptr = (uint8_t *)strtok((char *)uri_buf, " ?"); + + if (strcmp((char *)uri_ptr, "/")) { + uri_ptr++; + } + strcpy((char *)uri_buf, (char *)uri_ptr); + +#ifdef _HTTPPARSER_DEBUG_ + printf(" uri_name = %s\r\n", uri_buf); +#endif + + return 1; +} + +#endif + +void inet_addr_(uint8_t * addr, uint8_t *ip) { + uint8_t i; + uint8_t taddr[30]; + uint8_t * nexttok; + uint8_t num; + + strcpy((char *)taddr, (char *)addr); + + nexttok = taddr; + for (i = 0; i < 4 ; i++) { + nexttok = (uint8_t *)strtok((char *)nexttok, "."); + if (nexttok[0] == '0' && nexttok[1] == 'x') { + num = ATOI(nexttok + 2, 0x10); + } else { + num = ATOI(nexttok, 10); + } + ip[i] = num; + nexttok = NULL; + } +} + + +/** + @brief CONVERT STRING INTO INTEGER + @return a integer number +*/ +uint16_t ATOI( + uint8_t * str, /**< is a pointer to convert */ + uint8_t base /**< is a base value (must be in the range 2 - 16) */ +) { + unsigned int num = 0; + // debug_2013_11_25 + // while (*str !=0) + while ((*str != 0) && (*str != 0x20)) { // not include the space(0x020) + num = num * base + C2D(*str++); + } + return num; +} + +/** + @brief Check strings and then execute callback function by each string. + @param src The information of URI + @param s1 The start string to be researched + @param s2 The end string to be researched + @param sub The string between s1 and s2 + @return The length value atfer working +*/ +void mid(char* src, char* s1, char* s2, char* sub) { + char* sub1; + char* sub2; + uint16_t n; + + sub1 = strstr((char*)src, (char*)s1); + sub1 += strlen((char*)s1); + sub2 = strstr((char*)sub1, (char*)s2); + + n = sub2 - sub1; + strncpy((char*)sub, (char*)sub1, n); + sub[n] = '\0'; +} + +//////////////////////////////////////////////////////////////////// +// Static functions +//////////////////////////////////////////////////////////////////// + +/** + @brief replace the specified character in a string with new character +*/ +static void replacetochar( + uint8_t * str, /**< pointer to be replaced */ + uint8_t oldchar, /**< old character */ + uint8_t newchar /**< new character */ +) { + int x; + for (x = 0; str[x]; x++) + if (str[x] == oldchar) { + str[x] = newchar; + } +} + +/** + @brief CONVERT CHAR INTO HEX + @return HEX + + This function converts HEX(0-F) to a character +*/ +static uint8_t C2D( + uint8_t c /**< is a character('0'-'F') to convert to HEX */ +) { + if (c >= '0' && c <= '9') { + return c - '0'; + } + if (c >= 'a' && c <= 'f') { + return 10 + c - 'a'; + } + if (c >= 'A' && c <= 'F') { + return 10 + c - 'A'; + } + + return (char)c; +} + + + diff --git a/Internet/httpServer/httpParser.h b/Internet/httpServer/httpParser.h new file mode 100644 index 0000000..58e0021 --- /dev/null +++ b/Internet/httpServer/httpParser.h @@ -0,0 +1,157 @@ +/** + @file httpd.h + @brief Define Constants and fucntions associated with HTTP protocol. +*/ + +#include + +#ifndef __HTTPPARSER_H__ +#define __HTTPPARSER_H__ + +#ifdef __cplusplus +extern "C" { +#endif + +//#define _HTTPPARSER_DEBUG_ + +#define HTTP_SERVER_PORT 80 /**< HTTP server well-known port number */ + +/* HTTP Method */ +#define METHOD_ERR 0 /**< Error Method. */ +#define METHOD_GET 1 /**< GET Method. */ +#define METHOD_HEAD 2 /**< HEAD Method. */ +#define METHOD_POST 3 /**< POST Method. */ + +/* HTTP GET Method */ +#define PTYPE_ERR 0 /**< Error file. */ +#define PTYPE_HTML 1 /**< HTML file. */ +#define PTYPE_GIF 2 /**< GIF file. */ +#define PTYPE_TEXT 3 /**< TEXT file. */ +#define PTYPE_JPEG 4 /**< JPEG file. */ +#define PTYPE_FLASH 5 /**< FLASH file. */ +#define PTYPE_MPEG 6 /**< MPEG file. */ +#define PTYPE_PDF 7 /**< PDF file. */ +#define PTYPE_CGI 8 /**< CGI file. */ +#define PTYPE_XML 9 /**< XML file. */ +#define PTYPE_CSS 10 /**< CSS file. */ +#define PTYPE_JS 11 /**< JavaScript file. */ +#define PTYPE_JSON 12 /**< JSON (JavaScript Standard Object Notation) file. */ +#define PTYPE_PNG 13 /**< PNG file. */ +#define PTYPE_ICO 14 /**< ICON file. */ + +#define PTYPE_TTF 20 /**< Font type: TTF file. */ +#define PTYPE_OTF 21 /**< Font type: OTF file. */ +#define PTYPE_WOFF 22 /**< Font type: WOFF file. */ +#define PTYPE_EOT 23 /**< Font type: EOT file. */ +#define PTYPE_SVG 24 /**< Font type: SVG file. */ + + +/* HTTP response */ +#define STATUS_OK 200 +#define STATUS_CREATED 201 +#define STATUS_ACCEPTED 202 +#define STATUS_NO_CONTENT 204 +#define STATUS_MV_PERM 301 +#define STATUS_MV_TEMP 302 +#define STATUS_NOT_MODIF 304 +#define STATUS_BAD_REQ 400 +#define STATUS_UNAUTH 401 +#define STATUS_FORBIDDEN 403 +#define STATUS_NOT_FOUND 404 +#define STATUS_INT_SERR 500 +#define STATUS_NOT_IMPL 501 +#define STATUS_BAD_GATEWAY 502 +#define STATUS_SERV_UNAVAIL 503 + +/* HTML Doc. for ERROR */ +static const char ERROR_HTML_PAGE[] = "HTTP/1.1 404 Not Found\r\nContent-Type: text/html\r\nContent-Length: 78\r\n\r\n\r\n\r\nSorry, the page you requested was not found.\r\n\r\n\r\n\0"; +static const char ERROR_REQUEST_PAGE[] = "HTTP/1.1 400 OK\r\nContent-Type: text/html\r\nContent-Length: 50\r\n\r\n\r\n\r\nInvalid request.\r\n\r\n\r\n\0"; + +/* HTML Doc. for CGI result */ +#define HTML_HEADER "HTTP/1.1 200 OK\r\nContent-Type: text/html\r\nContent-Length: " + +/* Response header for HTML*/ +#define RES_HTMLHEAD_OK "HTTP/1.1 200 OK\r\nContent-Type: text/html\r\nConnection: keep-alive\r\nContent-Length: " + +/* Response head for TEXT */ +#define RES_TEXTHEAD_OK "HTTP/1.1 200 OK\r\nContent-Type: text/plain\r\nContent-Length: " + +/* Response head for GIF */ +#define RES_GIFHEAD_OK "HTTP/1.1 200 OK\r\nContent-Type: image/gif\r\nContent-Length: " + +/* Response head for JPEG */ +#define RES_JPEGHEAD_OK "HTTP/1.1 200 OK\r\nContent-Type: image/jpeg\r\nContent-Length: " + +/* Response head for PNG */ +#define RES_PNGHEAD_OK "HTTP/1.1 200 OK\r\nContent-Type: image/png\r\nContent-Length: " + +/* Response head for FLASH */ +#define RES_FLASHHEAD_OK "HTTP/1.1 200 OK\r\nContent-Type: application/x-shockwave-flash\r\nContent-Length: " + +/* Response head for XML */ +#define RES_XMLHEAD_OK "HTTP/1.1 200 OK\r\nContent-Type: text/xml\r\nConnection: keep-alive\r\nContent-Length: " + +/* Response head for CSS */ +#define RES_CSSHEAD_OK "HTTP/1.1 200 OK\r\nContent-Type: text/css\r\nContent-Length: " + +/* Response head for JavaScript */ +#define RES_JSHEAD_OK "HTTP/1.1 200 OK\r\nContent-Type: application/javascript\r\nContent-Length: " + +/* Response head for JSON */ +#define RES_JSONHEAD_OK "HTTP/1.1 200 OK\r\nContent-Type: application/json\r\nContent-Length: " + +/* Response head for ICO */ +#define RES_ICOHEAD_OK "HTTP/1.1 200 OK\r\nContent-Type: image/x-icon\r\nContent-Length: " + +/* Response head for CGI */ +#define RES_CGIHEAD_OK "HTTP/1.1 200 OK\r\nContent-Type: text/html\r\nContent-Length: " + +/* Response head for TTF, Font */ +#define RES_TTFHEAD_OK "HTTP/1.1 200 OK\r\nContent-Type: application/x-font-truetype\r\nContent-Length: " + +/* Response head for OTF, Font */ +#define RES_OTFHEAD_OK "HTTP/1.1 200 OK\r\nContent-Type: application/x-font-opentype\r\nContent-Length: " + +/* Response head for WOFF, Font */ +#define RES_WOFFHEAD_OK "HTTP/1.1 200 OK\r\nContent-Type: application/font-woff\r\nContent-Length: " + +/* Response head for EOT, Font */ +#define RES_EOTHEAD_OK "HTTP/1.1 200 OK\r\nContent-Type: application/vnd.ms-fontobject\r\nContent-Length: " + +/* Response head for SVG, Font */ +#define RES_SVGHEAD_OK "HTTP/1.1 200 OK\r\nContent-Type: image/svg+xml\r\nContent-Length: " + +/** + @brief Structure of HTTP REQUEST +*/ + +//#define MAX_URI_SIZE 1461 +#define MAX_URI_SIZE 512 + +typedef struct _st_http_request { + uint8_t METHOD; /**< request method(METHOD_GET...). */ + uint8_t TYPE; /**< request type(PTYPE_HTML...). */ + uint8_t URI[MAX_URI_SIZE]; /**< request file name. */ +} st_http_request; + +// HTTP Parsing functions +void unescape_http_url(char * url); /* convert escape character to ascii */ +void parse_http_request(st_http_request *, uint8_t *); /* parse request from peer */ +void find_http_uri_type(uint8_t *, uint8_t *); /* find MIME type of a file */ +void make_http_response_head(char *, char, uint32_t); /* make response header */ +uint8_t * get_http_param_value(char* uri, char* param_name); /* get the user-specific parameter value */ +uint8_t get_http_uri_name(uint8_t * uri, uint8_t * uri_buf); /* get the requested URI name */ +#ifdef _OLD_ +uint8_t * get_http_uri_name(uint8_t * uri); +#endif + +// Utility functions +uint16_t ATOI(uint8_t * str, uint8_t base); +void mid(char* src, char* s1, char* s2, char* sub); +void inet_addr_(uint8_t * addr, uint8_t * ip); + +#ifdef __cplusplus +} +#endif + +#endif /* end of __HTTPPARSER_H__ */ diff --git a/Internet/httpServer/httpServer.c b/Internet/httpServer/httpServer.c new file mode 100644 index 0000000..1663561 --- /dev/null +++ b/Internet/httpServer/httpServer.c @@ -0,0 +1,707 @@ +#include +#include +#include + +#include "socket.h" +#include "wizchip_conf.h" + +#include "httpServer.h" +#include "httpParser.h" +#include "httpUtil.h" + +#ifdef _USE_SDCARD_ +#include "ff.h" // header file for FatFs library (FAT file system) +#endif + +#ifndef DATA_BUF_SIZE +#define DATA_BUF_SIZE 2048 +#endif + +/***************************************************************************** + Private types/enumerations/variables + ****************************************************************************/ +static uint8_t HTTPSock_Num[_WIZCHIP_SOCK_NUM_] = {0, }; +static st_http_request * http_request; /**< Pointer to received HTTP request */ +static st_http_request * parsed_http_request; /**< Pointer to parsed HTTP request */ +static uint8_t * http_response; /**< Pointer to HTTP response */ + +// ## For Debugging +//static uint8_t uri_buf[128]; + +// Number of registered web content in code flash memory +static uint16_t total_content_cnt = 0; +/***************************************************************************** + Public types/enumerations/variables + ****************************************************************************/ +uint8_t * pHTTP_TX; +uint8_t * pHTTP_RX; + +volatile uint32_t httpServer_tick_1s = 0; +st_http_socket HTTPSock_Status[_WIZCHIP_SOCK_NUM_] = { {STATE_HTTP_IDLE, }, }; +httpServer_webContent web_content[MAX_CONTENT_CALLBACK]; + +#ifdef _USE_SDCARD_ +FIL fs; // FatFs: File object +FRESULT fr; // FatFs: File function return code +#endif + +/***************************************************************************** + Private functions + ****************************************************************************/ +void httpServer_Sockinit(uint8_t cnt, uint8_t * socklist); +static uint8_t getHTTPSocketNum(uint8_t seqnum); +static int8_t getHTTPSequenceNum(uint8_t socket); +static int8_t http_disconnect(uint8_t sn); + +static void http_process_handler(uint8_t s, st_http_request * p_http_request); +static void send_http_response_header(uint8_t s, uint8_t content_type, uint32_t body_len, uint16_t http_status); +static void send_http_response_body(uint8_t s, uint8_t * uri_name, uint8_t * buf, uint32_t start_addr, uint32_t file_len); +static void send_http_response_cgi(uint8_t s, uint8_t * buf, uint8_t * http_body, uint16_t file_len); + +/***************************************************************************** + Public functions + ****************************************************************************/ +// Callback functions definition: MCU Reset / WDT Reset +void default_mcu_reset(void) {;} +void default_wdt_reset(void) {;} +void (*HTTPServer_ReStart)(void) = default_mcu_reset; +void (*HTTPServer_WDT_Reset)(void) = default_wdt_reset; + +void httpServer_Sockinit(uint8_t cnt, uint8_t * socklist) { + uint8_t i; + + for (i = 0; i < cnt; i++) { + // Mapping the H/W socket numbers to the sequential index numbers + HTTPSock_Num[i] = socklist[i]; + } +} + +static uint8_t getHTTPSocketNum(uint8_t seqnum) { + // Return the 'H/W socket number' corresponding to the index number + return HTTPSock_Num[seqnum]; +} + +static int8_t getHTTPSequenceNum(uint8_t socket) { + uint8_t i; + + for (i = 0; i < _WIZCHIP_SOCK_NUM_; i++) + if (HTTPSock_Num[i] == socket) { + return i; + } + + return -1; +} + +void httpServer_init(uint8_t * tx_buf, uint8_t * rx_buf, uint8_t cnt, uint8_t * socklist) { + // User's shared buffer + pHTTP_TX = tx_buf; + pHTTP_RX = rx_buf; + + // H/W Socket number mapping + httpServer_Sockinit(cnt, socklist); +} + + +/* Register the call back functions for HTTP Server */ +void reg_httpServer_cbfunc(void(*mcu_reset)(void), void(*wdt_reset)(void)) { + // Callback: HW Reset and WDT reset function for each MCU platforms + if (mcu_reset) { + HTTPServer_ReStart = mcu_reset; + } + if (wdt_reset) { + HTTPServer_WDT_Reset = wdt_reset; + } +} + + +void httpServer_run(uint8_t seqnum) { + uint8_t s; // socket number + uint16_t len; + uint32_t gettime = 0; + +#ifdef _HTTPSERVER_DEBUG_ + uint8_t destip[4] = {0, }; + uint16_t destport = 0; +#endif + + http_request = (st_http_request *)pHTTP_RX; // Structure of HTTP Request + parsed_http_request = (st_http_request *)pHTTP_TX; + + // Get the H/W socket number + s = getHTTPSocketNum(seqnum); + + /* HTTP Service Start */ + switch (getSn_SR(s)) { + case SOCK_ESTABLISHED: + // Interrupt clear + if (getSn_IR(s) & Sn_IR_CON) { + setSn_IR(s, Sn_IR_CON); + } + + // HTTP Process states + switch (HTTPSock_Status[seqnum].sock_status) { + + case STATE_HTTP_IDLE : + if ((len = getSn_RX_RSR(s)) > 0) { + if (len > DATA_BUF_SIZE) { + len = DATA_BUF_SIZE; + } + len = recv(s, (uint8_t *)http_request, len); + + *(((uint8_t *)http_request) + len) = '\0'; + + parse_http_request(parsed_http_request, (uint8_t *)http_request); +#ifdef _HTTPSERVER_DEBUG_ + getSn_DIPR(s, destip); + destport = getSn_DPORT(s); + printf("\r\n"); + printf("> HTTPSocket[%d] : HTTP Request received ", s); + printf("from %d.%d.%d.%d : %d\r\n", destip[0], destip[1], destip[2], destip[3], destport); +#endif +#ifdef _HTTPSERVER_DEBUG_ + printf("> HTTPSocket[%d] : [State] STATE_HTTP_REQ_DONE\r\n", s); +#endif + // HTTP 'response' handler; includes send_http_response_header / body function + http_process_handler(s, parsed_http_request); + + gettime = get_httpServer_timecount(); + // Check the TX socket buffer for End of HTTP response sends + while (getSn_TX_FSR(s) != (getSn_TxMAX(s))) { + if ((get_httpServer_timecount() - gettime) > 3) { +#ifdef _HTTPSERVER_DEBUG_ + printf("> HTTPSocket[%d] : [State] STATE_HTTP_REQ_DONE: TX Buffer clear timeout\r\n", s); +#endif + break; + } + } + + if (HTTPSock_Status[seqnum].file_len > 0) { + HTTPSock_Status[seqnum].sock_status = STATE_HTTP_RES_INPROC; + } else { + HTTPSock_Status[seqnum].sock_status = STATE_HTTP_RES_DONE; // Send the 'HTTP response' end + } + } + break; + + case STATE_HTTP_RES_INPROC : + /* Repeat: Send the remain parts of HTTP responses */ +#ifdef _HTTPSERVER_DEBUG_ + printf("> HTTPSocket[%d] : [State] STATE_HTTP_RES_INPROC\r\n", s); +#endif + // Repeatedly send remaining data to client + send_http_response_body(s, 0, http_response, 0, 0); + + if (HTTPSock_Status[seqnum].file_len == 0) { + HTTPSock_Status[seqnum].sock_status = STATE_HTTP_RES_DONE; + } + break; + + case STATE_HTTP_RES_DONE : +#ifdef _HTTPSERVER_DEBUG_ + printf("> HTTPSocket[%d] : [State] STATE_HTTP_RES_DONE\r\n", s); +#endif + // Socket file info structure re-initialize + HTTPSock_Status[seqnum].file_len = 0; + HTTPSock_Status[seqnum].file_offset = 0; + HTTPSock_Status[seqnum].file_start = 0; + HTTPSock_Status[seqnum].sock_status = STATE_HTTP_IDLE; + + //#ifdef _USE_SDCARD_ + // f_close(&fs); + //#endif +#ifdef _USE_WATCHDOG_ + HTTPServer_WDT_Reset(); +#endif + http_disconnect(s); + break; + + default : + break; + } + break; + + case SOCK_CLOSE_WAIT: +#ifdef _HTTPSERVER_DEBUG_ + printf("> HTTPSocket[%d] : ClOSE_WAIT\r\n", s); // if a peer requests to close the current connection +#endif + disconnect(s); + break; + + case SOCK_CLOSED: +#ifdef _HTTPSERVER_DEBUG_ + printf("> HTTPSocket[%d] : CLOSED\r\n", s); +#endif + if (socket(s, Sn_MR_TCP, HTTP_SERVER_PORT, 0x00) == s) { /* Reinitialize the socket */ +#ifdef _HTTPSERVER_DEBUG_ + printf("> HTTPSocket[%d] : OPEN\r\n", s); +#endif + } + break; + + case SOCK_INIT: + listen(s); + break; + + case SOCK_LISTEN: + break; + + default : + break; + + } // end of switch + +#ifdef _USE_WATCHDOG_ + HTTPServer_WDT_Reset(); +#endif +} + +//////////////////////////////////////////// +// Private Functions +//////////////////////////////////////////// +static void send_http_response_header(uint8_t s, uint8_t content_type, uint32_t body_len, uint16_t http_status) { + switch (http_status) { + case STATUS_OK: // HTTP/1.1 200 OK + if ((content_type != PTYPE_CGI) && (content_type != PTYPE_XML)) { // CGI/XML type request does not respond HTTP header +#ifdef _HTTPSERVER_DEBUG_ + printf("> HTTPSocket[%d] : HTTP Response Header - STATUS_OK\r\n", s); +#endif + make_http_response_head((char*)http_response, content_type, body_len); + } else { +#ifdef _HTTPSERVER_DEBUG_ + printf("> HTTPSocket[%d] : HTTP Response Header - NONE / CGI or XML\r\n", s); +#endif + // CGI/XML type request does not respond HTTP header to client + http_status = 0; + } + break; + case STATUS_BAD_REQ: // HTTP/1.1 400 OK +#ifdef _HTTPSERVER_DEBUG_ + printf("> HTTPSocket[%d] : HTTP Response Header - STATUS_BAD_REQ\r\n", s); +#endif + memcpy(http_response, ERROR_REQUEST_PAGE, sizeof(ERROR_REQUEST_PAGE)); + break; + case STATUS_NOT_FOUND: // HTTP/1.1 404 Not Found +#ifdef _HTTPSERVER_DEBUG_ + printf("> HTTPSocket[%d] : HTTP Response Header - STATUS_NOT_FOUND\r\n", s); +#endif + memcpy(http_response, ERROR_HTML_PAGE, sizeof(ERROR_HTML_PAGE)); + break; + default: + break; + } + + // Send the HTTP Response 'header' + if (http_status) { +#ifdef _HTTPSERVER_DEBUG_ + printf("> HTTPSocket[%d] : [Send] HTTP Response Header [ %d ]byte\r\n", s, (uint16_t)strlen((char *)http_response)); +#endif + send(s, http_response, strlen((char *)http_response)); + } +} + +static void send_http_response_body(uint8_t s, uint8_t * uri_name, uint8_t * buf, uint32_t start_addr, uint32_t file_len) { + int8_t get_seqnum; + uint32_t send_len; + + uint8_t flag_datasend_end = 0; + +#ifdef _USE_SDCARD_ + uint16_t blocklen; +#endif +#ifdef _USE_FLASH_ + uint32_t addr = 0; +#endif + + if ((get_seqnum = getHTTPSequenceNum(s)) == -1) { + return; // exception handling; invalid number + } + + // Send the HTTP Response 'body'; requested file + if (!HTTPSock_Status[get_seqnum].file_len) { // ### Send HTTP response body: First part ### + if (file_len > DATA_BUF_SIZE - 1) { + HTTPSock_Status[get_seqnum].file_start = start_addr; + HTTPSock_Status[get_seqnum].file_len = file_len; + send_len = DATA_BUF_SIZE - 1; + + ///////////////////////////////////////////////////////////////////////////////////////////////// + // ## 20141219 Eric added, for 'File object structure' (fs) allocation reduced (8 -> 1) + memset(HTTPSock_Status[get_seqnum].file_name, 0x00, MAX_CONTENT_NAME_LEN); + strcpy((char *)HTTPSock_Status[get_seqnum].file_name, (char *)uri_name); +#ifdef _HTTPSERVER_DEBUG_ + printf("> HTTPSocket[%d] : HTTP Response body - file name [ %s ]\r\n", s, HTTPSock_Status[get_seqnum].file_name); +#endif + ///////////////////////////////////////////////////////////////////////////////////////////////// + +#ifdef _HTTPSERVER_DEBUG_ + printf("> HTTPSocket[%d] : HTTP Response body - file len [ %ld ]byte\r\n", s, file_len); +#endif + } else { + // Send process end + send_len = file_len; + +#ifdef _HTTPSERVER_DEBUG_ + printf("> HTTPSocket[%d] : HTTP Response end - file len [ %ld ]byte\r\n", s, send_len); +#endif + } +#ifdef _USE_FLASH_ + if (HTTPSock_Status[get_seqnum]->storage_type == DATAFLASH) { + addr = start_addr; + } +#endif + } else { // remained parts +#ifdef _USE_FLASH_ + if (HTTPSock_Status[get_seqnum]->storage_type == DATAFLASH) { + addr = HTTPSock_Status[get_seqnum].file_start + HTTPSock_Status[get_seqnum].file_offset; + } +#endif + send_len = HTTPSock_Status[get_seqnum].file_len - HTTPSock_Status[get_seqnum].file_offset; + + if (send_len > DATA_BUF_SIZE - 1) { + send_len = DATA_BUF_SIZE - 1; + //HTTPSock_Status[get_seqnum]->file_offset += send_len; + } else { +#ifdef _HTTPSERVER_DEBUG_ + printf("> HTTPSocket[%d] : HTTP Response end - file len [ %ld ]byte\r\n", s, HTTPSock_Status[get_seqnum].file_len); +#endif + // Send process end + flag_datasend_end = 1; + } +#ifdef _HTTPSERVER_DEBUG_ + printf("> HTTPSocket[%d] : HTTP Response body - send len [ %ld ]byte\r\n", s, send_len); +#endif + } + + /*****************************************************/ + //HTTPSock_Status[get_seqnum]->storage_type == NONE + //HTTPSock_Status[get_seqnum]->storage_type == CODEFLASH + //HTTPSock_Status[get_seqnum]->storage_type == SDCARD + //HTTPSock_Status[get_seqnum]->storage_type == DATAFLASH + /*****************************************************/ + + if (HTTPSock_Status[get_seqnum].storage_type == CODEFLASH) { + if (HTTPSock_Status[get_seqnum].file_len) { + start_addr = HTTPSock_Status[get_seqnum].file_start; + } + read_userReg_webContent(start_addr, &buf[0], HTTPSock_Status[get_seqnum].file_offset, send_len); + } +#ifdef _USE_SDCARD_ + else if (HTTPSock_Status[get_seqnum].storage_type == SDCARD) { + // Data read from SD Card + fr = f_read(&fs, &buf[0], send_len, (void *)&blocklen); + if (fr != FR_OK) { + send_len = 0; +#ifdef _HTTPSERVER_DEBUG_ + printf("> HTTPSocket[%d] : [FatFs] Error code return: %d (File Read) / HTTP Send Failed - %s\r\n", s, fr, HTTPSock_Status[get_seqnum].file_name); +#endif + } else { + *(buf + send_len + 1) = 0; // Insert '/0' for indicates the 'End of String' (null terminated) + } + } +#endif + +#ifdef _USE_FLASH_ + else if (HTTPSock_Status[get_seqnum]->storage_type == DATAFLASH) { + // Data read from external data flash memory + read_from_flashbuf(addr, &buf[0], send_len); + *(buf + send_len + 1) = 0; // Insert '/0' for indicates the 'End of String' (null terminated) + } +#endif + else { + send_len = 0; + } + // Requested content send to HTTP client +#ifdef _HTTPSERVER_DEBUG_ + printf("> HTTPSocket[%d] : [Send] HTTP Response body [ %ld ]byte\r\n", s, send_len); +#endif + + if (send_len) { + send(s, buf, send_len); + } else { + flag_datasend_end = 1; + } + + if (flag_datasend_end) { + HTTPSock_Status[get_seqnum].file_start = 0; + HTTPSock_Status[get_seqnum].file_len = 0; + HTTPSock_Status[get_seqnum].file_offset = 0; + flag_datasend_end = 0; + } else { + HTTPSock_Status[get_seqnum].file_offset += send_len; +#ifdef _HTTPSERVER_DEBUG_ + printf("> HTTPSocket[%d] : HTTP Response body - offset [ %ld ]\r\n", s, HTTPSock_Status[get_seqnum].file_offset); +#endif + } + + // ## 20141219 Eric added, for 'File object structure' (fs) allocation reduced (8 -> 1) +#ifdef _USE_SDCARD_ + f_close(&fs); +#endif + // ## 20141219 added end +} + +static void send_http_response_cgi(uint8_t s, uint8_t * buf, uint8_t * http_body, uint16_t file_len) { + uint16_t send_len = 0; + +#ifdef _HTTPSERVER_DEBUG_ + printf("> HTTPSocket[%d] : HTTP Response Header + Body - CGI\r\n", s); +#endif + send_len = sprintf((char *)buf, "%s%d\r\n\r\n%s", RES_CGIHEAD_OK, file_len, http_body); +#ifdef _HTTPSERVER_DEBUG_ + printf("> HTTPSocket[%d] : HTTP Response Header + Body - send len [ %d ]byte\r\n", s, send_len); +#endif + + send(s, buf, send_len); +} + + +static int8_t http_disconnect(uint8_t sn) { + setSn_CR(sn, Sn_CR_DISCON); + /* wait to process the command... */ + while (getSn_CR(sn)); + + return SOCK_OK; +} + + +static void http_process_handler(uint8_t s, st_http_request * p_http_request) { + uint8_t * uri_name; + uint32_t content_addr = 0; + uint16_t content_num = 0; + uint32_t file_len = 0; + + uint8_t uri_buf[MAX_URI_SIZE] = {0x00, }; + + uint16_t http_status; + int8_t get_seqnum; + uint8_t content_found; + + if ((get_seqnum = getHTTPSequenceNum(s)) == -1) { + return; // exception handling; invalid number + } + + http_status = 0; + http_response = pHTTP_RX; + file_len = 0; + + //method Analyze + switch (p_http_request->METHOD) { + case METHOD_ERR : + http_status = STATUS_BAD_REQ; + send_http_response_header(s, 0, 0, http_status); + break; + + case METHOD_HEAD : + case METHOD_GET : + get_http_uri_name(p_http_request->URI, uri_buf); + uri_name = uri_buf; + + if (!strcmp((char *)uri_name, "/")) { + strcpy((char *)uri_name, INITIAL_WEBPAGE); // If URI is "/", respond by index.html + } + if (!strcmp((char *)uri_name, "m")) { + strcpy((char *)uri_name, M_INITIAL_WEBPAGE); + } + if (!strcmp((char *)uri_name, "mobile")) { + strcpy((char *)uri_name, MOBILE_INITIAL_WEBPAGE); + } + find_http_uri_type(&p_http_request->TYPE, uri_name); // Checking requested file types (HTML, TEXT, GIF, JPEG and Etc. are included) + +#ifdef _HTTPSERVER_DEBUG_ + printf("\r\n> HTTPSocket[%d] : HTTP Method GET\r\n", s); + printf("> HTTPSocket[%d] : Request Type = %d\r\n", s, p_http_request->TYPE); + printf("> HTTPSocket[%d] : Request URI = %s\r\n", s, uri_name); +#endif + + if (p_http_request->TYPE == PTYPE_CGI) { + content_found = http_get_cgi_handler(uri_name, pHTTP_TX, &file_len); + if (content_found && (file_len <= (DATA_BUF_SIZE - (strlen(RES_CGIHEAD_OK) +8)))) { + send_http_response_cgi(s, http_response, pHTTP_TX, (uint16_t)file_len); + } else { + send_http_response_header(s, PTYPE_CGI, 0, STATUS_NOT_FOUND); + } + } else { + // Find the User registered index for web content + if (find_userReg_webContent(uri_buf, &content_num, &file_len)) { + content_found = 1; // Web content found in code flash memory + content_addr = (uint32_t)content_num; + HTTPSock_Status[get_seqnum].storage_type = CODEFLASH; + } + // Not CGI request, Web content in 'SD card' or 'Data flash' requested +#ifdef _USE_SDCARD_ +#ifdef _HTTPSERVER_DEBUG_ + printf("\r\n> HTTPSocket[%d] : Searching the requested content\r\n", s); +#endif + if ((fr = f_open(&fs, (const char *)uri_name, FA_READ)) == 0) { + content_found = 1; // file open succeed + + file_len = fs.fsize; + content_addr = fs.sclust; + HTTPSock_Status[get_seqnum].storage_type = SDCARD; + } +#elif _USE_FLASH_ + else if (/* Read content from Dataflash */) { + content_found = 1; + HTTPSock_Status[get_seqnum]->storage_type = DATAFLASH; + ; // To do + } +#endif + else { + content_found = 0; // fail to find content + } + + if (!content_found) { +#ifdef _HTTPSERVER_DEBUG_ + printf("> HTTPSocket[%d] : Unknown Page Request\r\n", s); +#endif + http_status = STATUS_NOT_FOUND; + } else { +#ifdef _HTTPSERVER_DEBUG_ + printf("> HTTPSocket[%d] : Find Content [%s] ok - Start [%ld] len [ %ld ]byte\r\n", s, uri_name, content_addr, file_len); +#endif + http_status = STATUS_OK; + } + + // Send HTTP header + if (http_status) { +#ifdef _HTTPSERVER_DEBUG_ + printf("> HTTPSocket[%d] : Requested content len = [ %ld ]byte\r\n", s, file_len); +#endif + send_http_response_header(s, p_http_request->TYPE, file_len, http_status); + } + + // Send HTTP body (content) + if (http_status == STATUS_OK) { + send_http_response_body(s, uri_name, http_response, content_addr, file_len); + } + } + break; + + case METHOD_POST : + mid((char *)p_http_request->URI, "/", " HTTP", (char *)uri_buf); + uri_name = uri_buf; + find_http_uri_type(&p_http_request->TYPE, uri_name); // Check file type (HTML, TEXT, GIF, JPEG are included) + +#ifdef _HTTPSERVER_DEBUG_ + printf("\r\n> HTTPSocket[%d] : HTTP Method POST\r\n", s); + printf("> HTTPSocket[%d] : Request URI = %s ", s, uri_name); + printf("Type = %d\r\n", p_http_request->TYPE); +#endif + + if (p_http_request->TYPE == PTYPE_CGI) { // HTTP POST Method; CGI Process + content_found = http_post_cgi_handler(uri_name, p_http_request, http_response, &file_len); +#ifdef _HTTPSERVER_DEBUG_ + printf("> HTTPSocket[%d] : [CGI: %s] / Response len [ %ld ]byte\r\n", s, content_found ? "Content found" : "Content not found", file_len); +#endif + if (content_found && (file_len <= (DATA_BUF_SIZE - (strlen(RES_CGIHEAD_OK) +8)))) { + send_http_response_cgi(s, pHTTP_TX, http_response, (uint16_t)file_len); + + // Reset the H/W for apply to the change configuration information + if (content_found == HTTP_RESET) { + HTTPServer_ReStart(); + } + } else { + send_http_response_header(s, PTYPE_CGI, 0, STATUS_NOT_FOUND); + } + } else { // HTTP POST Method; Content not found + send_http_response_header(s, 0, 0, STATUS_NOT_FOUND); + } + break; + + default : + http_status = STATUS_BAD_REQ; + send_http_response_header(s, 0, 0, http_status); + break; + } +} + +void httpServer_time_handler(void) { + httpServer_tick_1s++; +} + +uint32_t get_httpServer_timecount(void) { + return httpServer_tick_1s; +} + +void reg_httpServer_webContent(uint8_t * content_name, uint8_t * content) { + uint16_t name_len; + uint32_t content_len; + + if (content_name == NULL || content == NULL) { + return; + } else if (total_content_cnt >= MAX_CONTENT_CALLBACK) { + return; + } + + name_len = strlen((char *)content_name); + content_len = strlen((char *)content); + + web_content[total_content_cnt].content_name = malloc(name_len + 1); + strcpy((char *)web_content[total_content_cnt].content_name, (const char *)content_name); + web_content[total_content_cnt].content_len = content_len; + web_content[total_content_cnt].content = content; + + total_content_cnt++; +} + +uint8_t display_reg_webContent_list(void) { + uint16_t i; + uint8_t ret; + + if (total_content_cnt == 0) { + printf(">> Web content file not found\r\n"); + ret = 0; + } else { + printf("\r\n=== List of Web content in code flash ===\r\n"); + for (i = 0; i < total_content_cnt; i++) { + printf(" [%d] ", i + 1); + printf("%s, ", web_content[i].content_name); + printf("%ld byte, ", web_content[i].content_len); + + if (web_content[i].content_len < 30) { + printf("[%s]\r\n", web_content[i].content); + } else { + printf("[ ... ]\r\n"); + } + } + printf("=========================================\r\n\r\n"); + ret = 1; + } + + return ret; +} + +uint8_t find_userReg_webContent(uint8_t * content_name, uint16_t * content_num, uint32_t * file_len) { + uint16_t i; + uint8_t ret = 0; // '0' means 'File Not Found' + + for (i = 0; i < total_content_cnt; i++) { + if (!strcmp((char *)content_name, (char *)web_content[i].content_name)) { + *file_len = web_content[i].content_len; + *content_num = i; + ret = 1; // If the requested content found, ret set to '1' (Found) + break; + } + } + return ret; +} + + +uint16_t read_userReg_webContent(uint16_t content_num, uint8_t * buf, uint32_t offset, uint16_t size) { + uint16_t ret = 0; + uint8_t * ptr; + + if (content_num > total_content_cnt) { + return 0; + } + + ptr = web_content[content_num].content; + if (offset) { + ptr += offset; + } + + strncpy((char *)buf, (char *)ptr, size); + *(buf + size) = 0; // Insert '/0' for indicates the 'End of String' (null terminated) + + ret = strlen((void *)buf); + return ret; +} diff --git a/Internet/httpServer/httpServer.h b/Internet/httpServer/httpServer.h new file mode 100644 index 0000000..4ccd476 --- /dev/null +++ b/Internet/httpServer/httpServer.h @@ -0,0 +1,108 @@ +/** + @file httpServer.h + @brief Define constants and functions related HTTP Web server. +*/ + +#include + +#ifndef __HTTPSERVER_H__ +#define __HTTPSERVER_H__ + +#ifdef __cplusplus +extern "C" { +#endif + +// HTTP Server debug message enable +#define _HTTPSERVER_DEBUG_ + +#define INITIAL_WEBPAGE "index.html" +#define M_INITIAL_WEBPAGE "m/index.html" +#define MOBILE_INITIAL_WEBPAGE "mobile/index.html" + +/* Web Server Content Storage Select */ +//#define _USE_SDCARD_ +#ifndef _USE_SDCARD_ +//#define _USE_FLASH_ +#endif + +#if !defined(_USE_SDCARD_) && !defined(_USE_FLASH_) +#define _NOTUSED_STORAGE_ +#endif + + +/* Watchdog timer */ +//#define _USE_WATCHDOG_ + +/********************************************* + HTTP Process states list +*********************************************/ +#define STATE_HTTP_IDLE 0 /* IDLE, Waiting for data received (TCP established) */ +#define STATE_HTTP_REQ_INPROC 1 /* Received HTTP request from HTTP client */ +#define STATE_HTTP_REQ_DONE 2 /* The end of HTTP request parse */ +#define STATE_HTTP_RES_INPROC 3 /* Sending the HTTP response to HTTP client (in progress) */ +#define STATE_HTTP_RES_DONE 4 /* The end of HTTP response send (HTTP transaction ended) */ + +/********************************************* + HTTP Simple Return Value +*********************************************/ +#define HTTP_FAILED 0 +#define HTTP_OK 1 +#define HTTP_RESET 2 + +/********************************************* + HTTP Content NAME length +*********************************************/ +#define MAX_CONTENT_NAME_LEN 128 + +/********************************************* + HTTP Timeout +*********************************************/ +#define HTTP_MAX_TIMEOUT_SEC 3 // Sec. + +typedef enum { + NONE, ///< Web storage none + CODEFLASH, ///< Code flash memory + SDCARD, ///< SD card + DATAFLASH ///< External data flash memory +} StorageType; + +typedef struct _st_http_socket { + uint8_t sock_status; + uint8_t file_name[MAX_CONTENT_NAME_LEN]; + uint32_t file_start; + uint32_t file_len; + uint32_t file_offset; // (start addr + sent size...) + uint8_t storage_type; // Storage type; Code flash, SDcard, Data flash ... +} st_http_socket; + +// Web content structure for file in code flash memory +#define MAX_CONTENT_CALLBACK 20 + +typedef struct _httpServer_webContent { + uint8_t * content_name; + uint32_t content_len; + uint8_t * content; +} httpServer_webContent; + + +void httpServer_init(uint8_t * tx_buf, uint8_t * rx_buf, uint8_t cnt, uint8_t * socklist); +void reg_httpServer_cbfunc(void(*mcu_reset)(void), void(*wdt_reset)(void)); +void httpServer_run(uint8_t seqnum); + +void reg_httpServer_webContent(uint8_t * content_name, uint8_t * content); +uint8_t find_userReg_webContent(uint8_t * content_name, uint16_t * content_num, uint32_t * file_len); +uint16_t read_userReg_webContent(uint16_t content_num, uint8_t * buf, uint32_t offset, uint16_t size); +uint8_t display_reg_webContent_list(void); + +/* + @brief HTTP Server 1sec Tick Timer handler + @note SHOULD BE register to your system 1s Tick timer handler +*/ +void httpServer_time_handler(void); +uint32_t get_httpServer_timecount(void); + +#ifdef __cplusplus +} +#endif + +#endif diff --git a/Internet/httpServer/httpUtil.c b/Internet/httpServer/httpUtil.c new file mode 100644 index 0000000..442613d --- /dev/null +++ b/Internet/httpServer/httpUtil.c @@ -0,0 +1,65 @@ +/** + @file httpUtil.c + @brief HTTP Server Utilities + @version 1.0 + @date 2014/07/15 + @par Revision + 2014/07/15 - 1.0 Release + @author + \n\n @par Copyright (C) 1998 - 2014 WIZnet. All rights reserved. +*/ + +#include +#include +#include +#include "httpUtil.h" + +uint8_t http_get_cgi_handler(uint8_t * uri_name, uint8_t * buf, uint32_t * file_len) { + uint8_t ret = HTTP_OK; + uint16_t len = 0; + + if (predefined_get_cgi_processor(uri_name, buf, &len)) { + ; + } else if (strcmp((const char *)uri_name, "example.cgi") == 0) { + // To do + ; + } else { + // CGI file not found + ret = HTTP_FAILED; + } + + if (ret) { + *file_len = len; + } + return ret; +} + +uint8_t http_post_cgi_handler(uint8_t * uri_name, st_http_request * p_http_request, uint8_t * buf, uint32_t * file_len) { + uint8_t ret = HTTP_OK; + uint16_t len = 0; + uint8_t val = 0; + + if (predefined_set_cgi_processor(uri_name, p_http_request->URI, buf, &len)) { + ; + } else if (strcmp((const char *)uri_name, "example.cgi") == 0) { + // To do + val = 1; + len = sprintf((char *)buf, "%d", val); + } else { + // CGI file not found + ret = HTTP_FAILED; + } + + if (ret) { + *file_len = len; + } + return ret; +} + +uint8_t predefined_get_cgi_processor(uint8_t * uri_name, uint8_t * buf, uint16_t * len) { + ; +} + +uint8_t predefined_set_cgi_processor(uint8_t * uri_name, uint8_t * uri, uint8_t * buf, uint16_t * en) { + ; +} diff --git a/Internet/httpServer/httpUtil.h b/Internet/httpServer/httpUtil.h new file mode 100644 index 0000000..8e670b9 --- /dev/null +++ b/Internet/httpServer/httpUtil.h @@ -0,0 +1,32 @@ +/** + @file httpUtil.h + @brief Header File for HTTP Server Utilities + @version 1.0 + @date 2014/07/15 + @par Revision + 2014/07/15 - 1.0 Release + @author + \n\n @par Copyright (C) 1998 - 2014 WIZnet. All rights reserved. +*/ + +#ifndef __HTTPUTIL_H__ +#define __HTTPUTIL_H__ + +#ifdef __cplusplus +extern "C" { +#endif + +#include "httpServer.h" +#include "httpParser.h" + +uint8_t http_get_cgi_handler(uint8_t * uri_name, uint8_t * buf, uint32_t * file_len); +uint8_t http_post_cgi_handler(uint8_t * uri_name, st_http_request * p_http_request, uint8_t * buf, uint32_t * file_len); + +uint8_t predefined_get_cgi_processor(uint8_t * uri_name, uint8_t * buf, uint16_t * len); +uint8_t predefined_set_cgi_processor(uint8_t * uri_name, uint8_t * uri, uint8_t * buf, uint16_t * len); + +#ifdef __cplusplus +} +#endif + +#endif diff --git a/README.md b/README.md new file mode 100644 index 0000000..3d153bb --- /dev/null +++ b/README.md @@ -0,0 +1,140 @@ +# ioLibrary Driver +The ioLibrary means “Internet Offload Library” for WIZnet chip. It includes drivers and application protocols. +The driver (ioLibrary) can be used for the application design of WIZnet TCP/IP chips as W6300, W6100, [W5500](https://docs.wiznet.io/Product/iEthernet/W5500/overview), W5300, W5200, W5100 [W5100S](https://docs.wiznet.io/Product/iEthernet/W5100S/overview). + +## ioLibrary +This driver provides the Berkeley Socket type APIs. +- The tree of Directory + + +```1 +ioLibrary + ┣ Application + ┃ ┣ loopback + ┃ ┃ ┣ loopback.c + ┃ ┃ ┗ loopback.h + ┃ ┗ multicast + ┃ ┣ multicast.c + ┃ ┗ multicast.h + ┣ Ethernet + ┃ ┣ W5100 + ┃ ┃ ┣ w5100.c + ┃ ┃ ┗ w5100.h + ┃ ┣ W5100S + ┃ ┃ ┣ w5100s.c + ┃ ┃ ┗ w5100s.h + ┃ ┣ W5200 + ┃ ┃ ┣ w5200.c + ┃ ┃ ┗ w5200.h + ┃ ┣ W5300 + ┃ ┃ ┣ w5300.c + ┃ ┃ ┗ w5300.h + ┃ ┣ W5500 + ┃ ┃ ┣ w5500.c + ┃ ┃ ┗ w5500.h + ┃ ┣ W6100 + ┃ ┃ ┣ w6100.c + ┃ ┃ ┗ w6100.h + ┃ ┗ W6300 + ┃ ┣ w6300.c + ┃ ┗ w6300.h + ┗ Internet + ┣ AAC + ┃ ┣ AddressAutoConfig.c + ┃ ┗ AddressAutoConfig.h + ┣ DHCP + ┃ ┣ dhcp.c + ┃ ┗ dhcp.h + ┣ DHCP6 + ┃ ┣ dhcp6.c + ┃ ┗ dhcp6.h + ┣ DNS + ┃ ┣ dns.c + ┃ ┗ dns.h + ┣ FTPClient + ┃ ┣ ftpc.c + ┃ ┣ ftpc.h + ┃ ┗ stdio_private.h + ┣ FTPServer + ┃ ┣ ftpd.c + ┃ ┣ ftpd.h + ┃ ┣ REAME.md + ┃ ┗ stdio_private.h + ┣ httpServer + ┃ ┣ httpParser.c + ┃ ┣ httpParser.h + ┃ ┣ httpServer.c + ┃ ┣ httpServer.h + ┃ ┣ httpUtil.c + ┃ ┗ httpUtil.h + ┣ MQTT + ┃ ┣ MQTTPacket + ┃ ┣ mqtt_interface.c + ┃ ┣ mqtt_interface.h + ┃ ┣ MQTTClient.c + ┃ ┗ MQTTClient.h + ┣ SNMP + ┃ ┣ tools + ┃ ┣ snmp.c + ┃ ┣ snmp.h + ┃ ┣ snmp_custom.c + ┃ ┗ snmp_custom.h + ┣ SNTP + ┃ ┣ sntp.c + ┃ ┗ sntp.h + ┗ TFTP + ┣ netutil.c + ┣ netutil.h + ┣ tftp.c + ┗ tftp.h + +``` + +- Ethernet : SOCKET APIs like BSD & WIZCHIP([W5500](https://docs.wiznet.io/Product/iEthernet/W5500/overview) / W5300 / W5200 / W5100 / [W5100S](https://docs.wiznet.io/Product/iEthernet/W5100S/overview)) Driver +- Internet : + - DHCP client + - DNS client + - FTP client + - FTP server + - SNMP agent/trap + - SNTP client + - TFTP client + - HTTP server + - MQTT Client + - Others will be added. + +## How to add an ioLibrary in project through github site. + - Example, refer to https://www.youtube.com/watch?v=mt815RBGdsA + - [ioLibrary Doxygen doument](https://github.com/Wiznet/ioLibrary_Driver/blob/master/Ethernet/Socket_APIs_V3.0.3.chm) : Refer to **TODO** in this document + - Define what chip is used in **wizchip_conf.h** + - Define what Host I/F mode is used in **wizchip_conf.h** + +## Revision History + * ioLibrary V4.0.0 Released : 29, MAR, 2018 + * New features added: Library for W5100S added. + * ioLibrary V3.1.1 Released : 14, Dec, 2016 + * Bug fixed : In Socket.c Fixed MACraw & IPraw sendto function. + * ioLibrary V3.1.0 Released : 05, Dec, 2016 + * Internet application protocol add to MQTT Client (using paho MQTT 3.11) + * ioLibrary V3.0.3 Released : 03, May, 2016 + * In W5300, Fixed some compile errors in close(). Refer to M20160503 + * In close(), replace socket() with some command sequences. + * ioLibrary V3.0.2 Released : 26, April, 2016 + * Applied the erratum #1 in close() of socket.c (Refer to A20160426) + * ioLibrary V3.0.1 Released : 15, July, 2015 + * Bug fixed : In W5100, Fixed CS control problem in read/write buffer with SPI. Refer to M20150715. + * ioLibrary V3.0 Released : 01, June, 2015 + * Add to W5300 + * Typing Error in comments + * Refer to 20150601 in sources. + + * Type casting error Fixed : 09, April. 2015 + In socket.c, send() : Refer to M20150409 + + * ioLibrary V2.0 released : April. 2015 + * Added to W5100, W5200 + * Correct to some typing error + * Fixed the warning of type casting. + + * Last release : Nov. 2014 + diff --git a/iolibrary.chm b/iolibrary.chm new file mode 100644 index 0000000000000000000000000000000000000000..22ed4b035835460d42e84baa02c5e1fdb965850c GIT binary patch literal 4728334 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