Example 展示了 choice 函数, 它用来从一个序列里分拣出一个随机项目. 它可以用于列表, 元组, 以及其他序列 当然, 非空的. Example 展示了如何在旧版本中实现该函数. random 模块也包含了非恒定分布的随机生成器函数. Example 使用了 gauss 高斯 函数来生成满足高斯分的布随机数字. 你可以在 Python Library Reference 找到更多关于非恒定分布随机生成器函数的信息. 这个模块早在 2. 请使用 random 代替. Example 展示了 whrandom , 它提供了一个伪随机数生成器. 基于 Wichmann 和 Hill, 的数学运算理论. 除非你需要不共享状态的多个生成器 如多线程程序 , 请使用 random 模块代替.

Example 展示了如何使用 whrandom 类实例创建多个生成器. md5 Message-Digest Algorithm 5 模块用于计算信息密文 信息摘要. md5 算法计算一个强壮的位密文. 这意味着如果两个字符串是不同的, 那么有极高可能它们的 md5 也不同. 也就是说, 给定一个 md5 密文, 那么几乎没有可能再找到另个字符串的密文与此相同. Example 展示了如何使用 md5 模块. Example 展示了如何获得一个十六进制或 base64 编码的字符串. Example 展示了如何使用 md5 校验和来处理口令的发送与应答的验证 不过我们将稍候讨论这里使用随机数字所带来的问题.

Example 提供了 md5 的一个变种, 你可以通过标记信息来判断它是否在网络传输过程中被修改 丢失. copy 方法会对这个内部对象状态做一个快照 snapshot. 这允许你预先计算部分密文摘要 例如 Example 中的 padded key. txt by Krawczyk, 或其他. sha 模块提供了计算信息摘要 密文 的另种方法, 如 Example 所示. 它与 md5 模块类似, 但生成的是 位签名. 关于 sha 密文的使用, 请参阅 md5 中的例子.

可选, 只用于 Unix crypt 模块实现了单向的 DES 加密, Unix 系统使用这个加密算法来储存密码, 这个模块真正也就只在检查这样的密码时有用. Example 展示了如何使用 crypt. crypt 来加密一个密码, 将密码和 salt 组合起来然后传递给函数, 这里的 salt 包含两位随机字符.

确认密码时, 只需要用新密码调用加密函数, 并取加密后字符串的前两位作为 salt 即可. 如 果结果和加密后字符串匹配, 那么密码就是正确的. Example 使用 pwd 模块来获取已知用户的加密后密码. 关于其他实现验证的方法请参阅 md5 模块一节. 这个模块在 2. 可选 rotor 模块实现了一个简单的加密算法. 它的算法基于 WWII Enigma engine. 可选 zlib 模块为 "zlib" 压缩提供支持. 这种压缩方法是 "deflate". Example 展示了如何使用 compress 和 decompress 函数接受字符串参数. 文件的内容决定了压缩比率, Example 说明了这点.

你也可以实时地压缩或解压缩数据, 如 Example 所示. Example 把解码对象封装到了一个类似文件对象的类中, 实现了一些文件对象的方法, 这样使得读取压缩文件更方便. code 模块提供了一些用于模拟标准交互解释器行为的函数. 在 Example 中, 我们一行一行地编译一个程序, 编译完成后会执行所得到的代码对象 code object. 注意只有我们到达第 2 个括号, 元组的赋值操作能编译完成. InteractiveConsole 类实现了一个交互控制台, 类似你启动的 Python 解释器交互模式. 控制台可以是活动的 自动调用函数到达下一行 或是被动的 当有新数据时调用 push 方法. 如果你想使用另个输入函数, 你可以使用相同的名称重载这个方法. Example 展示了如何使用 code 模块来模拟交互解释器. Example 中的脚本定义了一个 keyboard 函数.

本章将介绍标准 Python 解释器中所提供的线程支持模块. 注意线程支持模块是可选的, 有可能在一些 Python 解释器中不可用. 本章还涵盖了一些 Unix 和 Windows 下用于执行外部进程的模块. 执行 Python 程序的时候, 是按照从主模块顶端向下执行的. 循环用于重复执行部分代码, 函数和方法会将控制临时移交到程序的另一部分. 通过线程, 你的程序可以在同时处理多个任务. 所以你可以在一个线程里从文件读取数据, 另个向屏幕输出内容. 为了保证两个线程可以同时访问相同的内部数据, Python 使用了 global interpreter lock 全局解释器锁.

在同一时间只可能有一个线程执行 Python 代码; Python 实际上是自动地在一段很短的时间后切换到下个线程执行, 或者等待 一个线程执行一项需要时间的操作 例如等待通过 socket 传输的数据, 或是从文件中读取数据. 多个线程尝试访问相同的数据会导致异常 状态. 大多时候这样做没有问题, 但在某些时候会导致严重错误. 不过你可以使用 lock objects 来同步线程. 一个线程只能拥有一个 lock object , 这样就可以确保某个时刻 只有一个线程执行 getitem 函数.

在大多现代操作系统中, 每个程序在它自身的 进程 process 内执行. Python 允许你在一个脚本内执行一个新的程序. 大多进程相关函数通过 os 模块定义. 相关内容请参阅 第 1. 可选 threading 模块为线程提供了一个高级接口, 如 Example 所示. 它源自 Java 的线程实现. 和低级的 thread 模块相同, 只有你在编译解释器时打开了线程支持才可以使用它. 你只需要继承 Thread 类, 定义好 run 方法, 就可以创建一 个新的线程. 使用时首先创建该类的一个或多个实例, 然后调用 start 方法. 这样每个实例的 run 方法都会运行在它自己的线程里. Example 使用了 Lock 对象来在全局 Counter 对象里创建临界区 critical section. 如果删除了 acquire 和 release 语句, 那么 Counter 很可能不会到达 Queue 模块提供了一个线程安全的队列 queue 实现, 如 Example 所示.

Example 展示了如何限制队列的大小. 如果队列满了, 那么控制主线程 producer threads 被阻塞, 等待项目被弹出 pop off. 你可以通过继承 Queue 类来修改它的行为. Example 为我们展示了一个简单的具有优先级的队列. 它接受一个元组作为参数, 元组的第一个成员表示优先级 数值越小优先级越高. Example 展示了一个简单的堆栈 stack 实现 末尾添加, 头部弹出, 而非头部添加, 头部弹出.

如果没有特殊需要, 最好使用高级接口 threading 模块替代. 注意当主程序退出的时候, 所有的线程也随着退出. 而 threading 模块不存在这个问题. 只用于 Unix commands 模块包含一些用于执行外部命令的函数. Example 展示了这个模块. 只用于 Unix pipes 模块提供了 "转换管道 conversion pipelines " 的支持. popen2 模块允许你执行外部命令, 并通过流来分别访问它的 stdin 和 stdout 可能还有 stderr. 在 python 1. Example 展示了如何使用该模块来给字符串排序. Example 展示了如何使用该模块控制应用程序. 你可以使用 signal 模块配置你自己的信号处理器 signal handler , 如 Example 所示. 当解释器收到某个信号时, 信号处理器会立即执行.

本章描述了一些用于在 Python 对象和其他数据表示类型间相互转换的模块. struct 模块用于在 二进制数据结构 例如 C 中的 struct 和 Python 元组间转换. array 模块将二进制数据阵列 C arrays 封装为 Python 序列对象. marshal 模块使用了简单的自描述格式 Self-Describing Formats , 它支持大多的内建数据类型, 包括 code 对象. Python 自身也使用了这个格式来储存编译后代码.

pyc 文件. pickle 模块提供了更复杂的格式, 它支持用户定义的类, 自引用数据结构等等. pickle 是用 Python 写的, 相对来说速度较慢, 不过还有一个 cPickle 模块, 使用 C 实现了相同的功能, 速度和 marshal 不相上下. pprint 模块几乎可以将任何 Python 数据结构很好地打印出来 提高可读性. repr 模块可以用来替换内建同名函数. 该模块与内建函数不同的是它限制了很多输出形式: 他只会 输出字符串的前 30 个字符, 它只打印嵌套数据结构的几个等级, 等等. Python 支持大部分常见二进制编码, 例如 base64 , binhex 一种 Macintosh 格式 , quoted printable , 以及 uu 编码. array 模块实现了一个有效的阵列储存类型. 阵列和列表类似, 但其中所有的项目必须为相同的 类型. Examples 到 都是很简单的范例. Example 创建了一个 array 对象, 然后使用 tostring 方法将内部缓冲区 internal buffer 复制到字符串.

array 对象可以作为一个普通列表对待, 如 Example 所示. 不过, 你不能连接两个不同类型的阵列. 该模块还提供了用于转换原始二进制数据到整数序列 或浮点数数列, 具体情况决定 的方法, 如 Example 所示. 最后, Example 展示了如何使用该模块判断当前平台的字节序 endianess. byteorder 属性, 可以更简单地判断字节序 属性值为 " little " 或 " big " , 如 Example 所示. struct 模块用于转换二进制字符串和 Python 元组. pack 函数接受格式字符串以及额外参数, 根据指定格式将额外参数转换为二进制字符串. upack 函数接受一个字符串作为参数, 返回一个元组.

xdrlib 模块用于在 Python 数据类型和 Sun 的 external data representation XDR 间相互转化, 如 Example 所示. Sun 在 remote procedure call RPC 协议中使用了 XDR 格式. Example 虽然不完整, 但它展示了如何建立一个 RPC 请求包. marshal 模块可以把不连续的数据组合起来 - 与字符串相互转化, 这样它们就可以写入文件或是在网络中传输. marshal 模块使用了简单的自描述格式. 对于每个数据项目, 格式化后的字符串都包含一个类型代码, 然后是一个或多个类型标识区域. 整数使用小字节序 little-endian order 储存, 字符串储存时和它自身内容长度相同 可能包含空字节 , 元组由组成它的对象组合表示. marshal 模块还可以处理 code 对象 它用于储存预编译的 Python 模块. pickle 模块同 marshal 模块相同, 将数据连续化, 便于保存传输.

它比 marshal 要慢一些, 但它可以处理类实例, 共享的元素, 以及递归数据结构等. 默认情况下, pickle 使用急于文本的格式. 你也可以使用二进制格式, 这样数字和二进制 字符串就会以紧密的格式储存, 这样文件就会更小点. 可选, 注意大小写 cPickle 模块是针对 pickle 模块的一个更快的实现. 这样 pickle 和 copy 模块就会知道 如何处理非标准类型. 例如, 标准的 pickle 实现不能用来处理 Python code 对象, 如下所示:. 我们可以注册一个 code 对象处理器来完成目标. 处理器应包含两个部分: 一个 pickler , 接受 code 对象 并返回一个只包含简单数据类型的元组, 以及一个 unpickler , 作用相反, 接受这样的元组作为参数. 如果你是在网络中传输 pickle 后的数据, 那么请确保自定义的 unpickler 在数据接收端也是可用的. Example 展示了如何实现 pickle 一个打开的文件对象.

pprint 模块 pretty printer 用于打印 Python 数据结构. 当你在命令行下打印 特定数据结构时你会发现它很有用 输出格式比较整齐, 便于阅读. repr 模块提供了内建 repr 函数的另个版本. 它限制了很多 字符串长度, 递归等. Example 展示了如何使用该模块. base64 编码体系用于将任意二进制数据转换为纯文本. 它将一个 3 字节的二进制字节组 转换为 4 个文本字符组储存, 而且规定只允许以下集合中的字符出现:. Example 展示了如何使用 encode 和 decode 函数操作文件对象.

Example 展示了如何使用 encodestring 和 decodestring 函数在字符串间转换. 它们是 encode 和 decode 函数的顶层封装. 使用 StringIO 对象处理输入和输出. Example 展示了如何将用户名和密码转换为 HTTP 基本身份验证字符串. 最后, Example 展示了一个实用小工具, 它可以把 GIF 格式转换为 Python 脚本, 便于使用 Tkinter 库. binhex 模块用于到 Macintosh BinHex 格式的相互转化. 该模块有两个函数 binhex 和 hexbin. quopri 模块基于 MIME 标准实现了引用的可打印编码 quoted printable encoding. ASCII 文本的信息, 例如大多欧洲语言, 中文, 转换为只包含 U. ASCII 的信息.

在一些老式的 mail 代理中你会发现这很有用, 因为它们一般不支持特殊. 如 Example 所示, 非 U. 所以如果你没有用太多的怪异字符的话, 编码后字符串依然可读性很好. Europeans generally hate this encoding and strongly believe that certain U. programmers deserve to be slapped in the head with a huge great fish to the jolly music of Edward German uu 编码体系用于将任意二进制数据转换为普通文本格式.

该格式在新闻组中很流行, 但逐渐被 base64 编码取代. uu 编码将每个 3 字节 24 位 的数据组转换为 4 个可打印字符 每个字符 6 位 , 使用从 chr 32 空格 到 chr 95 的字符. 一个编码后的数据流以一个新行开始, 它包含文件的权限 Unix 格式 和文件名, 以 end 行结尾:. uu 模块提供了两个函数: encode 和 decode. encode infile, outfile, filename 函数从编码输入文件中的数据, 然后写入到输出文件中. infile 和 outfile 可以是文件名或文件对象. filename 参数作为起始域的文件名写入.

decode infile, outfile 函数用来解码 uu 编码的数据. 同样地, 参数可以是文件名也可以是文件对象. binascii 提供了多个编码的支持函数, 包括 base64 , binhex , 以及 uu. Python 提供了一些用于处理可扩展标记语言 Extensible Markup Language , XML 和超文本标记语言 Hypertext Markup Language , HTML 的扩展. Python 同样提供了对 标准通用标记语言 Standard Generalized Markup Language , SGML 的支持. 所有这些格式都有着相同的结构, 因为 HTML 和 XML 都来自 SGML. 每个文档都是由 起始标签 start tags , 结束标签 end tags , 文本 又叫字符数据 , 以及实体引用 entity references 构成:.

起始标签可以包含多个属性, 比如这里的 name 属性. 起始标签和它对应的结束标签中的任何东西被称为 元素 element. 这里 document 元素包含 header 和 body 两个元素. 虽然 XML , HTML , SGML 使用相同的结构块, 但它们还有一些不同点. 在 XML 中, 所有元素必须有起始和结束标签, 所有标签必须正确嵌套 well-formed.

HTML 也是区分大小写的. 另一方面, XML 允许你定义任何元素, 而 HTML 使用一些由 HTML 规范定义的固定元素. SGML 有着更高的灵活性, 你可以使用自己的声明 declaration 定义源文件如何转换到元素结构, DTD document type description , 文件类型定义 可以用来 检查结构并补全缺失标签. 技术上来说, HTML 和 XML 都是 SGML 应用, 有各自的 SGML 声明, 而且 HTML 有一个标准 DTD. Python 提供了多个 makeup 语言分析器. 由于 SGML 是最灵活的格式, Python 的 sgmllib 事实上很简单.

它不会去处理 DTD , 不过你可以继承它来提供更复杂的功能. Python 的 HTML 支持基于 SGML 分析器. htmllib 将具体的格式输出工作交给 formatter 对象. formatter 模块包含一些标准格式化标志. Python 的 XML 支持模块很复杂. 先前是只有与 sgmllib 类似的 xmllib , 后来加入了更高级的 expat 模块 可选. 而最新版本中已经准备废弃 xmllib ,启用 xml 包作为工具集. ConfigParser 模块用于读取简单的配置文件, 类似 Windows 下的 INI 文件. netrc 模块用于读取. netrc 配置文件, shlex 模块用于读取类似 shell 脚本语法的配置文件. Python 的标准库提供了对 GZIP 和 ZIP 2. 基于 zlib 模块, gzip 和 zipfile 模块分别用来处理这类文件. xmllib 已在当前版本中申明不支持. xmlib 模块提供了一个简单的 XML 语法分析器, 使用正则表达式将 XML 数据分离, 如 Example 所示.

语法分析器只对文档做基本的检查, 例如是否只有一个顶层元素, 所有的标签是否匹配. XML 数据一块一块地发送给 xmllib 分析器 例如在网路中传输的数据. 分析器在遇到起始标签, 数据区域, 结束标签, 和实体的时候调用不同的方法. 这些 start 函数使用它们对应标签的属性作为参数调用 传递时为一个字典. Example 展示了一个简单 不完整 的内容输出引擎 rendering engine. 生成器会在 style 字典中查询当前标签的层次, 如果不存在, 它将根据样式表创建一个新的样式描述. 可选 xml. expat 模块是 James Clark's Expat XML parser 的接口.

Example 展示了这个功能完整且性能很好的语法分析器. 注意即使你传入的是普通的文本, 这里的分析器仍然会返回 Unicode 字符串. 默认情况下, 分析器将源文本作为 UTF-8 解析. 如果要使用其他编码, 请确保 XML 文件包含 encoding 说明. sgmllib 模块, 提供了一个基本的 SGML 语法分析器. 它与 xmllib 分析器基本相同, 但限制更少 而且不是很完善. 和在 xmllib 中一样, 这个分析器在遇到起始标签, 数据区域, 结束标签以及实体时调用内部方法. 如果你只是对某些标签感兴趣, 那么你可以定义特殊的方法. Example 检查 SGML 文档是否是如 XML 那样 "正确格式化", 所有的元素是否正确嵌套, 起始和结束标签是否匹配等. 我们使用列表保存所有起始标签, 然后检查每个结束标签是否匹配前个起始标签.

最后, Example 中的类可以用来过滤 HTML 和 SGML 文档. 继承这个类, 然后实现 start 和 end 方法即可. htmlib 模块包含了一个标签驱动的 tag-driven HTML 语法分析器, 它会将数据发送至一个格式化对象. 更多关于如何解析 HTML 的例子请参阅 formatter 模块. 如果你只是想解析一个 HTML 文件, 而不是将它交给输出设备, 那么 sgmllib 模块会是更好的选择.

htmlentitydefs 模块包含一个由 HTML 中 ISO Latin-1 字符实体构成的字典. Example 展示了如何将正则表达式与这个字典结合起来翻译字符串中的实体 cgi. escape 的逆向操作. 最后, Example 展示了如何将 XML 保留字符和 ISO Latin-1 字符转换为 XML 字符串. 与 cgi. escape 相似, 但它会替换非 ASCII 字符. formatter 模块提供了一些可用于 htmllib 的格式类 formatter classes. 这些类有两种, formatter 和 writer.

formatter 将 HTML 解析器的标签和数据流转换为适合输出设备的事件流 event stream , 而 writer 将事件流输出到设备上. 大多情况下, 你可以使用 AbstractFormatter 类进行格式化. 它会根据不同的格式化事件调用 writer 对象的方法. AbstractWriter 类在每次方法调用时打印一条信息. formatter 模块还提供了 NullWriter 类, 它会将任何传递给它的事件忽略; 以及 DumbWriter 类, 它会将事件流转换为纯文本文档. Example 提供了一个自定义的 Writer , 它继承自 DumbWriter 类, 会记录当前字体样式并根据字体美化输出格式. ConfigParser 模块用于读取配置文件. 配置文件的格式与 Windows INI 文件类似, 可以包含一个或多个区域 section , 每个区域可以有多个配置条目. 这里有个样例配置文件, 在 Example 用到了这个文件:. Example 使用 ConfigParser 模块读取这个配制文件.

netrc 模块可以用来解析. netrc 配置文件, 如 Example 所示. 该文件用于在用户的 home 目录储存 FTP 用户名和密码. netrc," 这样只有当前用户能访问. shlex 模块为基于 Unix shell 语法的语言提供了一个简单的 lexer 也就是 tokenizer. 使用 namelist 和 infolist 方法可以列出压缩档的内容, 前者返回由文件名组成的列表, 后者返回由 ZipInfo 实例组成的列表.

调用 read 方法就可以从 ZIP 文档中读取数据. 它接受一个文件名作为参数, 返回字符串. 向压缩档加入文件很简单, 将文件名, 文件在 ZIP 档中的名称传递给 write 方法即可. Example 将 samples 目录中的所有文件打包为一个 ZIP 文件. write 方法的第三个可选参数用于控制是否使用压缩.

默认为 zipfile. 如果安装了 zlib 模块, 那么就可以使用 zipfile. zipfile 模块也可以向档案中添加字符串. 不过, 这需要一点技巧, 你需要创建一个 ZipInfo 实例, 并正确配置它. Example 提供了一种简单的解决办法. gzip 模块用来读写 gzip 格式的压缩文件, 如 Example 所示. 标准的实现并不支持 seek 和 tell 方法. 不过 Example 可以解决这个问题. Python 有大量用于处理邮件和新闻组的模块, 其中包括了许多常见的邮件格式.

rfc 模块包括了一个邮件和新闻组的解析器 也可用于其它符合 RFC 标准的消息, 比如 HTTP 头. 通常, RFC 格式的消息包含一些标头字段, 后面至少有一个空行, 然后是信息主体. For example, here's a short mail message. The first five lines make up the message header, and the actual message a single line, in this case follows after an empty line:. 前五行组成了消息标头, 隔一个空行后是消息主体. 消息解析器读取标头字段后会返回一个以消息标头为键的类字典对象, 如 Example 所示. 消息对象 message object 还提供了一些用于解析地址字段和数据的, 如 Example 所示. 地址字段被解析为 实际名称, 邮件地址 这样的元组.

数据字段被解析为 9 元时间元组, 可以使用 time 模块处理. 多用途因特网邮件扩展 Multipurpose Internet Mail Extensions, MIME 标准定义了如何在 RFC 格式的消息中储存非 ASCII 文本, 图像以及其它数据. mimetools 模块包含一些读写 MIME 信息的工具. 它还提供了一个类似 rfc 模块中 Message 的类, 用于处理 MIME 编码的信息. MimeWriter 模块用于生成符合 MIME 邮件标准的 "多部分" 的信息, 如 Example 所示. mailbox 模块用来处理各种不同类型的邮箱格式, 如 Example 所示. 大部分邮箱格式使用文本文件储存纯 RFC 信息, 用分割行区别不同的信息. mailcap 模块用于处理 mailcap 文件, 该文件指定了不同的文档格式的处理方法 Unix 系统下.

Example 中, 系统使用 pilview 来预览 view 所有类型的图片, 使用 ghostscript viewer 预览 PostScript 文档. Example 展示了如何使用 mailcap 获得特定操作的命令. mimetypes 模块可以判断给定 url uniform resource locator , 统一资源定位符 的 MIME 类型. 它基于一个内建的表, 还可能搜索 Apache 和 Netscape 的配置文件. 已废弃 packmail 模块可以用来创建 Unix shell 档案. 如果安装了合适的工具, 那么你就可以直接通过运行来解开这样的档案.

Example 展示了如何打包单个文件, Example 则打包了整个目录树. 注意, 这个模块不能处理二进制文件, 例如声音或者图像文件. mimify 模块用于在 MIME 编码的文本信息和普通文本信息 例如 ISO Latin 1 文本 间相互转换. 它可以用作命令行工具, 或是特定邮件代理的转换过滤器:. 作为模块使用, 如 Example 所示. 这里是一个包含两部分的 MIME 信息, 一个是引用的可打印信息, 另个是 base64 编码信息. unmimify 的第三个参数决定是否自动解码 base64 编码的部分:. 解码结果如下 可读性相对来说更好些 :.

Example 展示了如何编码信息. multifile 模块允许你将一个多部分的 MIME 信息的每部分作为单独的文件处理. 本章描述了 Python 的 socket 协议支持以及其他建立在 socket 模块上的网络 模块. 这些包含了对大多流行 Internet 协议客户端的支持, 以及一些可用来 实现 Internet 服务器的框架. 对于那些本章中的底层的例子, 我将使用两个协议作为样例: Internet Time Protocol Internet 时间协议 以及 Hypertext Transfer Protocol 超文本传输协议, HTTP 协议.

Internet 时间协议 RFC , Postel 和 Harrenstien, 可以让 一个网络客户端获得一个服务器的当前时间. 因为这个协议是轻量级的, 许多 Unix 系统 但不是所有 都提供了这个服务. 服务器等待连接请求并在连接后返回当前时间 4 字节整数, 自从 年 1 月 1 日到当前的秒数. 协议很简单, 这里我们提供规格书给大家:. 超文本传输协议 HTTP, RFC 是另个完全不同的东西. 最近的格式说明书 Version 1. 从它最简单的格式来看, 这个协议是很简单的. 客户端发送如下的请求到服务器, 请求一个文件:.

socket 模块实现了到 socket 通讯层的接口. 你可以使用该模块创建 客户端或是服务器的 socket. 我们首先以一个客户端为例, Example 中的客户端连接到一个时间协议服务器, 读取 4 字节的返回数据, 并把它转换为一个时间值. socket 工厂函数 factory function 根据给定类型 该例子中为 Internet stream socket , 即就是 TCP socket 创建一个新的 socket. connect 方法尝试将这个 socket 连接到指定服务器上.

成功后, 就可以使用 recv 方法读取数据. 创建一个服务器 socket 使用的是相同的方法, 不过这里不是连接到服务器, 而是将 socket bind 绑定 到本机的一个端口上, 告诉它去监听连接请求, 然后尽快处理每个到达的请求. Example 创建了一个时间服务器, 绑定到本机的 端口 前的所有端口 是为系统服务保留的, Unix 系统下访问它们你必须要有 root 权限. listen 函数的调用告诉 socket 我们期望接受连接. 参数代表连接 的队列 用于在程序没有处理前保持连接 大小. 最后 accept 循环将当前时间返回 给每个连接的客户端. 注意这里的 accept 函数返回一个新的 socket 对象, 这个对象是直接连接到客户端 的.

而原 socket 只是用来保持连接; 所有后来的数据传输操作都使用新的 socket. 我们可以使用 Example , Example 的通用化版本 来测试这个服务器,. Example 所示的脚本也可以作为模块使用; 你只需要导入 timeclient 模块, 然后调用它的 gettime 函数. 目前为止, 我们已经使用了流 TCP socket. 时间协议还提到了 UDP sockets 报文. 流 socket 的工作模式和电话线类似; 你会知道在远端 是否有人拿起接听器, 在对方挂断的时候你也会注意到.

相比之下, 发送报文更像 是在一间黑屋子里大声喊. 可能某人会在那里, 但你只有在他回复的时候才会知道. 如 Example 所示, 你不需要在通过报文 socket 发送数据时连接远程机器. 只需使用 sendto 方法, 它接受数据和接收者地址作为参数. 读取报文的时候使用 recvfrom 方法. 这里的 recvfrom 返回两个值: 数据和发送者的地址. Example 展示了对应的服务器代码. Example 使用 socket 模块实现一个报文时间服务器. 最主要的不同在于服务器使用 bind 来分配一个已知端口给 socket , 根据 recvfrom 函数返回的地址向客户端发送数据. select 模块允许你检查一个或多个 socket , 管道, 以及其他流兼容对象所接受的数据, 如 Example 所示. 你可以将一个或更多 socket 传递给 select 函数, 然后等待它们状态改变 可读, 可写, 或是发送错误信号 :. 在 Example 中, 我们等待监听 socket 变成可读状态, 这代表有一个连接请求到达.

我们用和之前一样的方法处理 channel socket , 因为它不可能因为等待 4 字节而填充网络 缓冲区. 如果你设置 socket 为 非阻塞 模式 通过调用 setblocking 方法 , 那么你就可以使用 select 来等待 socket 连接. 不过 asyncore 模块 参见下一节 提供了一个强大的框架, 它自动为你处理好了这一切. 所以我不准备在这里多说什么, 看下一节吧. asyncore 模块提供了一个 "反馈性的 reactive " socket 实现. 该模块允许你定义特定过程完成后所执行的代码, 而不是创建 socket 对象, 调用它们的方法. 你只需要继承 dispatcher 类, 然后重载如下方法 可以选择重载某一个或多个 就可以实现异步的 socket 处理器.

Example 展示了一个时间客户端, 和 socket 模块中的那个类似. 如果你不想记录任何信息, 那么你可以在你的 dispatcher 类里重载 log 方法. Example 展示了对应的时间服务器. 注意这里它使用了两个 dispatcher 子类, 一个用于监听 socket , 另个用于与客户端通讯.

当你创建一个它的实例后, 它会发出一个 HTTP GET 请求并把 接受到的数据发送到一个 "consumer" 目标对象. Example 中的小脚本展示了如何使用这个类. 这里的 consumer 接口设计时是为了与 htmllib 和 xmllib 分析器兼容的, 这样你就可以直接方便地解析 HTML 或是 XML 数据.

Example 的一个问题是它不能很好地处理重定向资源. Example 加入了一个额外的 consumer 层, 它可以很好地处理重定向. 如果服务器返回状态 永久重定向 或者是 临时重定向 , 重定向的 consumer 会关闭当前请求并向新地址发出新请求. 所有对 consumer 的其他调用传递给原来的 consumer. asynchat 模块是对 asyncore 的一个扩展.

它提供对面向行 line-oriented 的协议的额外支持. 它还提供了增强的缓冲区支持 通过 push 方法和 "producer" 机制. Example 实现了一个很小的 HTTP 服务器. 它只是简单地返回包含 HTTP 请求信息的 HTML 文档 浏览器窗口出现的输出. producer 接口允许你传入 "push" 太大以至于无法在内存中储存的对象. asyncore 在需要更多数据的时候自动调用 producer 的 more 方法. 另外, 它使用一个空字符串标记文件的末尾. Example 实现了一个很简单的基于文件的 HTTP 服务器, 它使用了一个简单的 FileProducer 类来从文件中读取数据, 每次只读取几 kb. urlib 模块为 HTTP , FTP , 以及 gopher 提供了一个统一的客户端接口. 它会自动地根据 URL 选择合适的协议处理器.

从 URL 获取数据是非常简单的. 只需要调用 urlopen 方法, 然后从返回的流对象中读取数据即可, 如 Example 所示. headers 是一个 Message 对象 在 mimetools 模块中定义 , url 是实际的 URL. urlopen 函数实际上是一个辅助函数, 它会创建一个 FancyURLopener 类的实例并调用它的 open 方法.

例如 Example 中的类会自动地 在必要时登陆服务器. urlparse 模块包含用于处理 URL 的函数, 可以在 URL 和平台特定的文件名间相互转换. 一个常见用途就是把 HTTP URL 分割为主机名和路径组件 一个 HTTP 请求会涉及到 主机名以及请求路径 , 如 Example 所示. Example 展示了如何使用 urlunparse 函数将各组成部分合并回一个 URL. Example 使用 urljoin 函数将绝对路径和相对路径组合起来. Example 展示了它的使用. txt 文件, 该文件用于 Robot Exclusion Protocol 搜索机器人排除协议? 如果你实现的一个 HTTP 机器人会访问网路上的任意站点 并不只是你自己的站点 , 那么最好还是用该模块检查下你所做的一切是不是受欢迎的. Example 展示了该模块的使用. ftplib 模块包含了一个 File Transfer Protocol FTP , 文件传输协议 客户端的实现.

Example 展示了如何登陆并获得登陆目录的文件列表. 下载文件很简单; 使用合适的 retr 函数即可. 注意当你下载文本文件时, 你必须自己加上行结束符. Example 中使用了一个 lambda 表达式完成这项工作. 最后, Example 将文件复制到 FTP 服务器上. 这个脚本使用文件扩展名来 判断文件是文本文件还是二进制文件. gopherlib 模块包含了一个 gopher 客户端实现, 如 Example 所示. httplib 模块提供了一个 HTTP 客户端接口, 如 Example 所示. 注意 httplib 提供的 HTTP 客户端在等待服务器回复的时候会阻塞程序. 异步的解决方法请参阅 asyncore 模块中的例子. httplib 可以用来发送其他 HTTP 命令, 例如 POST , 如 Example 所示. poplib 模块 如 Example 所示 提供了一个 Post Office Protocol POP3 协议 客户端实现.

这个协议用来从邮件服务器 "pop" 拷贝 信息到你的个人电脑. imaplib 模块提供了一个 Internet Message Access Protocol IMAP, Internet 消息访问协议 的客户端实现. 这个协议允许你访问邮件服务器的邮件目录, 就好像是在本机访问一样. smtplib 模块提供了一个 Simple Mail Transfer Protocol SMTP , 简单邮件传输协议 客户端实现. 该协议用于通过 Unix 邮件服务器发送邮件, 如 Example 所示. 读取邮件请使用 poplib 或 imaplib 模块. telnetlib 模块提供了一个 telnet 客户端实现.

Example 连接到一台 Unix 计算机, 登陆, 然后请求一个目录的列表. nntplib 模块提供了一个网络新闻传输协议 Network News Transfer Protocol, NNTP 客户端的实现. 从新闻服务器上读取消息之前, 你必须连接这个服务器并选择一个新闻组. Example 中的脚本会从服务器下载一个完成的消息列表, 然后根据列表做简单的统计. 下载消息是很简单的, 只需要调用 article 方法, 如 Example 所示. Example 展示了如何进一步处理这些消息, 你可以把它封装到一个 Message 对象中 使用 rfc 模块. 到这一步后, 你可以使用 htmllib , uu , 以及 base64 继续处理这些消息. SocketServer 为各种基于 socket 的服务器提供了一个框架. 该模块提供了大量的类, 你可以用它们来创建不同的服务器.

Example 使用该模块实现了一个 Internet 时间协议服务器. 你可以用前边的 timeclient 脚本连接它. 这是一个建立在 SocketServer 框架上的基本框架, 用于 HTTP 服务器. Example 在每次重新载入页面时会生成一条随机信息. path 变量包含当前 URL , 你可以使用它为不同的 URL 生成不同的内容 访问除根目录的其他任何 path 该脚本都会返回一个错误页面. 更有扩展性的 HTTP 框架请参阅 SimpleHTTPServer 和 CGIHTTPServer 模块. SimpleHTTPServer 模块是一个简单的 HTTP 服务器, 它提供了标准的 GET 和 HEAD 请求处理器.

客户端请求的路径名称会被翻译为一个相对文件名 相对于服务器启动时的当前路径. 但它并没有任何访问验证处理, 所以请小心使用. Example 实现了个迷你的 web 代理. 发送给代理的 HTTP 请求必须包含目标服务器的完整 URI. 代理服务器使用 urllib 来获取目标服务器的数据. CGIHTTPServer 模块是一个可以通过公共网关接口 common gateway interface , CGI 调用外部脚本的 HTTP 服务器.

cgi 模块为 CGI 脚本提供了函数和类支持. 它还可以处理 CGI 表单数据. Example 展示了一个简单的 CGI 脚本, 它返回给定目录下的文件列表 相对于脚本中指定的根目录. 它提供了一个 open 函数, 接受文件名或 URL 作为参数, 然后在浏览器中打开它. 如果你又一次调用 open 函数, 那么它会尝试在相同的窗口打开新页面. 在 Unix 下, 该模块支持 lynx , Netscape , Mosaic , Konquerer , 和 Grail. 在 Windows 和 Macintosh 下, 它会调用标准浏览器 在注册表或是 Internet 选项面板中定义. locale 模块提供了 C 本地化 localization 函数的接口, 如 Example 所示. 同时提供相关函数, 实现基于当前 locale 设置的数字, 字符串转换. 而 int , float , 以及 string 模块中的相关转换函数不受 locale 设置的影响. Example 展示了如何使用 locale 模块获得当前平台 locale 设置.

这影响到了 0xx4DB5 , 0x4Ex9FA5 , 以及 0xACD7A3 中的字符, 不过每个区间内的第一个字符属性是正确的, 我们可以把字符映射到起始 实现正常操作:. 仅适用于 2. Python 提供了一些用于处理图片和音频文件的模块. 译注: 别参阅 PST 了, 废了, 用 pymedia 代替吧. imghdr 模块可识别不同格式的图片文件. 当前版本可以识别 bmp , gif , jpeg , pbm , pgm , png , ppm , rast Sun raster , rgb SGI , tiff , 以及 xbm 图像.

sndhdr 模块, 可来识别不同的音频文件格式, 并提取文件内容相关信息. 执行成功后, what 函数将返回一个由文件类型, 采样频率, 声道数, 音轨数和每个采样点位数组成的元组. 具体含义请参考 help sndhdr. 已废弃 whatsound 是 sndhdr 模块的一个别名. aifc 模块用于读写 AIFF 和 AIFC 音频文件 在 SGI 和 Macintosh 的计算机上使用. sunau 模块用于读写 Sun AU 音频文件. sunaudio 模块用于识别 Sun AU 音频文件, 并提取其基本信息. sunau 模块为 Sun AU 文件提供了更完成的支持. wave 模块用于读写 Microsoft WAV 音频文件, 如 Example 所示. 只用于 Unix audiodev 为 Sun 和 SGI 计算机提供了音频播放支持. 只用于 Windows winsound 模块允许你在 Winodws 平台上播放 Wave 文件. Python 提供了多种相似数据库管理 database manager 的驱动, 它们的模型都基于 Unix 的 dbm 库.

这些数据库和普通的字典对象类似, 但这里需要注意的是它只能接受字符串作为键和值. shelve 模块可以处理任何类型的值. anydbm 模块为简单数据库驱动提供了统一标准的接口. 当第一次被导入的时候, anydbm 模块会自动寻找一个合适的数据库驱动, 按照 dbhash , gdbm , dbm , 或 dumbdbm 的顺序尝试. 如果没有找到任何模块, 它将引发一个 ImportError 异常. open 函数用于打开或创建一个数据库 使用导入时找到的数据库驱动 , 如 Example 所示.

whichdb 模块可以判断给定数据库文件的格式, 如 Example 所示. shelve 模块使用数据库驱动实现了字典对象的持久保存. shelve 对象使用字符串作为键, 但值可以是任意类型, 所有可以被 pickle 模块处理的对象都可以作为它的值. Example 展示了如何使用 shelve 处理给定的数据库驱动. 可选 dbhash 模块为 bsddb 数据库驱动提供了一个 dbm 兼容的接口. 可选 dbm 模块提供了一个到 dbm 数据库驱动的接口 在许多 Unix 平台上都可用. dumbdbm 模块是一个简单的数据库实现, 与 dbm 一类相似, 但使用纯 Python 实现. 它使用两个文件: 一个二进制文件. dat 用于储存数据, 一个文本文件. dir 用于数据描述.

可选 gdbm 模块提供了到 GNU dbm 数据驱动的接口, 如 Example 所示. dis 模块是 Python 的反汇编器. 当然 dis 也可以作为模块使用. dis 函数接受一个类, 方法, 函数, 或者 code 对象 作为单个参数. pdb 模块是标准 Python 调试器 debugger. 它基于 bdb 调试器框架. 你可以从命令行调用调试器 键入 n 或 进入下一行代码, 键入 help 获得可用命令列表 :. Example 展示了如何从程序中启动调试器. bdb 模块为提供了一个调试器框架. 你可以使用它来创建自定义的调试器, 如 Example 所示. 你需要做的只是继承 Bdb 类, 覆盖它的 user 方法 在每次调试器停止的时候被调用. 使用各种各样的 set 方法可以控制调试器. profile 模块是标准 Python 分析器. 和反汇编器, 调试器相同, 你可以从命令行调用分析器:. 如 Example 所示, 我们还可以从程序中调用 profile 来对程序性能做分析.

你可以使用 pstats 模块来修改结果报告的形式. pstats 模块用于分析 Python 分析器收集的数据. 当文件混合了 tab 和空格两种缩进时候, nanny 保姆 会立即给出提示. 在下边使用的 badtabs. py 文件中, if 语句后的第一行使用 4 个空格和 1 个 tab. 因为 Python 解释器把 tab 作为 8 个空格来处理, 所以这个脚本可以正常运行. 在所有符合代码标准 一个 tab 为 8 个空格 的编辑器中它也会正常显示. 当然, 这些都骗不过 nanny. Example 展示了如何在你自己的程序中使用 tabnanny. 将 sys.

stdout 重定向到一个 StringIO 对象就可以捕获输出. 比如 Unix , Windows 家族. 只用于 Unix fcntl 模块为 Unix上的 ioctl 和 fcntl 函数提供了一个接口. out of band management: 指使用分离的渠道进行设备管理.

这使系统管理员能在机器关机的时候对服务器, 网络进行监视和管理. 关于如何在平台上使用这些函数, 请查阅对应的 Unix man 手册. 该模块同时提供了 Unix 文件锁定机制的接口. Example 展示了如何使用 flock 函数, 更新文件时为文件设置一个 advisory lock. 输出结果是由同时运行 3 个副本得到的. 像这样 都在一句命令行里 :. 如果你注释掉对 flock 的调用, 那么 counter 文件不会正确地更新. PICs are also easy to program, however getting the project set up can some times be tricky.

These instructions will walk through the process of setting up the software, creating a new project, and programming some very simple functions to test the configuration and ensure everything is working. They are designed to be very open ended; after the project is created and the basics are finished the reader is encouraged to explore all the features and extras not covered in these instructions.

Also you will find that these instructions will start out walking through step by step, but as the instructions near the end the reader is encouraged to explore other ways of accomplishing the tasks and make the project their own.

What you will need To build a project with a PIC microcontroller only requires a few items. PIC microcontroller These instructions are for programming a PIC18F series MCU, although others are similar. Obtained from Microchips website. Microchip allows students with valid.

edu email addresses sample PIC's for free! The PIC I am using to create these instructions is a PIC18F22K80 PICkit 3 In-Circuit Debugger Available from Microchip. edu email address. There are also other programmers which will work just as well; however, this is the best one for starting out. Breadboard and breadboard wires LEDs, buttons, potentiometers, or anything else you would like to connect to the PIC.

Add Tip Ask Question Comment Download. Before doing any programming the first step is to build the hardware. Although the PIC18F portfolio is very large, many of the chips have several commonalities.

For more detailed information see the "Guidelines for Getting Started with PIC18Fxxxx Microcontrollers" section in your devices datasheet.

For detailed pin-outs of the PIC microcontroller see the "Pin Diagram" section in your devices datasheet. Connect the MCLR pin through a 1kΩ resistor to VDD. Connect a 0. Connect a 10μF capacitor between VCAP and Vss. Connect MCLR pin to pin 1 of the PICkit 3.

Connect VDD to pin 2 of the PICkit 3. Connect VSS to pin 3 of the PICkit 3. Connect PGD pin to pin 4 of the PICkit 3. Connect PGC pin to pin 5 of the PICkit 3. Leave pin 6 of the PICkit 3 unconnected. Connect any analog inputs to pins with ANx functionality where x is a number.

Connect any digital inputs or outputs to pins with Rxy functionality where x is a letter identifying the port, and y is a number identifying the bit. For my example I have an LED connected between RA0 and ground, the wiper of a potentiometer connected to AN1, and a DPST switch connected to RA2. You may find it easier to program the PIC if you have sketched down a schematic of your circuit. These instructions will use XC8 compiler and MPLAB X IDE by Microchip. This step will explain how to get these tools and ensure they have been installed correctly.

Note: If you are using Windows 8 you may need to run the installers in compatibility mode for Windows 7. If it is listed select OK and move on the next step. If it is not listed ensure that instillation has completed, and click Scan for Build Tools button.

If still not listed, look on Microchips forum for help with your specific problem. In this step we will create a new project based on a template from Microchip. In the new file dialog box expand Samples and select Microchip Embedded In the project box select PIC18 C Template Select Next Give the project any name you like Choose a location to save the project to in the Project Location box Leave the Project Folder as default options Check "Set as Main Project" box Select Finish The project will now show up in Project Explore on the left hand side of the screen.

Before we can get started programming we need to set the build parameters. Create Configuration Right click on the project name in the projects tool bar.

In the Project Properties dialog select Manage Configurations In the Configurations dialog select New In the New Configuration Name dialog enter Default and click OK In the Configurations dialog make sure Default is selected and click Set Active Click OK in the Configurations dialog Set Configuration Properties In the Project Properties dialog select "Conf: [Default]" in the Categories list In the Device box type the name of the device you are using.

In my case PIC18F26K80 In the Hardware Tools list select PICkit3 In the Compiler Toolchain select XC8 v is the version you have installed. Select Apply Under Conf: [Default] select PICkit 3 For Option categories select Power Check "Power target circuit from PICkit3 Select Apply. Under Conf: [Default] select XC8 compiler For Option categories select Optimizations Set "Optimization Set" to "none" Select Apply Click OK to close the dialog box Test the Configuration To test the configuration click the clean and build button the one with the hammer and broom.

Text will start scrolling in the output window at the bottom of the page. If you get an error, go back through this step making sure that you did not miss anything, and that everything was applied. The next step is setting the configuration bits. The configuration bits tell the MCU its initial conditions for when it turns on.

They are used to set the clock source and speed, watchdog time configuration, and other similar features. Configuration bits are device dependent, so check the data sheet for the chip you are using for more information. c Remove all the text below the endif line Notice a new tab has opened at the bottom of the screen Set the bits as needed for your project. Since these are chip dependent, check the data sheet for more information about what each does. Some common settings follow: Extended Instruction Set -- Should be set to OFF when using template Oscillator -- Used to select the processor.

Unless you are using an external crystal, leave set as Internal RC oscillator. See data sheet for other oscillator configurations. Note: CLKOUT will allow for easier debugging, and should be turned on if available.

PLL Enable -- Will allow for future use of the PLL. Note: this will not turn on the PLL, it will only enable it. It is recommended to enable it. Watchdog Timer -- The watch dog timer is used to ensure the processor will not lock up. It however makes it much harder to debug. It is recommended to disable it while initially programming, and only enable it after the project is nearly done. Leave all of these disabled. If unsure about a setting, it is usually safe to leave it default.

After all configuration bits have been set, click the "Generate Source Code to Output" button at the bottom of the panel. The panel will now switch to the Output tab.

c file and pres save. Clean and build the project again by clicking the broom and hammer icon. Ensure the build was successful. Also check to make sure there was no errors in the output If everything has worked move on to the next step. If there are errors or warnings fix them before moving on. The next step is to start programming; however, before we get to the application code we must program the system code.

The system code are the low level functions such as configuring the oscillator and basic delay functions. Determining Settings Before we can program the settings, we must choose what speed we would like to run at.

For this example I will use 16MHz as most PIC's can run at this speed. If you are using the internal oscillator then use the settings relating to INTIO1 On the next page or two you will find a schematic drawing of the oscillator similar to the one shown. It is helpful to trace the signal on this drawing to ensure the correct speed is being selected. The next step is to program these settings to the MCU.

This is done by setting registers. The first register to set is OSCCON. IDLEN -- used to control the action of the sleep command. Can be left as default. IRCF -- Oscillator selection. Since I am using the internal oscillator, I will set to 1x where x can be 0 or 1 The next register is OSCCON2; however, this register is mostly read only and not important at this point The last oscillator configuration register is OSCTUNE.

We will not tune the frequency for this project, however we must use this register to turn on the PLL using the PLLEN bit. Applying Settings Return to MPLAB In the project explorer under Source Files open system. c At the bottom of this file is the function ConfigureOscillator. Remove the comments in that function. To set the bits of a register type in all caps the register name, followed by the lowercase word bits and then a period and the bit name.

To set the bits follow that with an equal sign. To use binary type 0bXXXX where XXXX is the binary number. Lastly end the line with a semi-colon. Set all the bits as determined above for the OSCCON register. Example: OSCCONbits. See below for an example of a finished ConfigureOscillator function. This however is not a function in the standard library, and will need to be programmed by you.

For this implementation there will be a loop which will hold the processor until the given time has passed. PIC18F microcontrollers need 4 clock cycles to execute one line of assembly code. Since a for loop will take one instruction each time for the comparison, and two for the operation one for the body of the loop, it will work perfectly. We just need the for loop to loop time per milli-second. In system. The best way to test that everything is set up correctly is to blink an LED light.

If the light blinks at the expected rate then everything has been configured correctly. In this example the LED is connected to PORT A, Pin 0 RA0 on the datasheet.

If you have your LED connected to a different pin, use the appropriate registers and bits. Open main. c in the project viewer under source files.

ESP-WIFI-MESH 编程模型. 编写 ESP-WIFI-MESH 应用程序. API 参考. 有关 ESP-WIFI-MESH 协议的文档，请见 ESP-WIFI-MESH API 指南 。有关 ESP-WIFI-MESH 开发框架的更多内容，请见 ESP-WIFI-MESH 开发框架 。.

ESP-WIFI-MESH 软件栈 . 应用程序可通过 ESP-WIFI-MESH 事件 与 ESP-WIFI-MESH 交互。由于 ESP-WIFI-MESH 构建在 Wi-Fi 软件栈之上，因此也可以通过 Wi-Fi 事件任务 与 Wi-Fi 驱动程序进行交互。下图展示了 ESP-WIFI-MESH 应用程序中各种系统事件的接口。. ESP-WIFI-MESH 系统事件交付 . 应用程序无需通过 LwIP 层便可直接访问 ESP-WIFI-MESH 软件栈，LwIP 层仅在根节点和外部 IP 网络的数据发送与接收时会用到。但是，由于每个节点都有可能成为根节点（由于自动根节点选择机制的存在），每个节点仍必须初始化 LwIP 软件栈。. 初始化 Mesh. 配置 ESP-WIFI-MESH 网络. 启动 Mesh. 选择或选举根节点（见 建立网络 中的 自动根节点选择 ）. 选择首选的父节点（见 建立网络 中的 父节点选择 ）.

网络断开时自动重新连接（见 管理网络 中的 中间父节点失败 ）. 启用自组网功能后，ESP-WIFI-MESH 软件栈将内部调用 Wi-Fi API。因此， 在启用自组网功能时，应用层不得调用 Wi-Fi API，否则会干扰 ESP-WIFI-MESH 的工作。. bool enable 指定启用或禁用自组网功能。. ESP-WIFI-MESH 将尝试在启用自组网时保持节点的当前 Wi-Fi 状态。但是，根据节点类型以及是否选择了新的父节点，节点的 Wi-Fi 状态可能会发生变化。下表显示了启用自组网的效果。. 在有些情况下，应用程序可能希望在使用 ESP-WIFI-MESH 期间调用 Wi-Fi API。例如，应用程序可能需要手动扫描邻近的接入点 AP 。 但在应用程序调用任何 Wi-Fi API 之前，必须先禁用自组网。 否则，ESP-WIFI-MESH 软件栈可能会同时调用 Wi-Fi API，进而影响应用程序的正常调用。.

内部通信示例 展示了如何搭建 ESP-WIFI-MESH 网络，并让根节点向网络中的每个节点发送数据包。. 手动连网示例 展示了如何在禁用自组网功能的情况下使用 ESP-WIFI-MESH。此示例展示了如何对节点进行编程，以手动扫描潜在父节点的列表，并根据自定义标准选择父节点。.

Attention This API shall be called after Wi-Fi is started. Attention 　　This API shall be called after mesh initialization and configuration. to — [in] the address of the final destination of the packet If the packet is to the root, set this parameter to NULL.

If the packet is to an external IP network, set this parameter to the IPv4:PORT combination. This packet will be delivered to the root firstly, then the root will forward this packet to the final IP server address. In this option, the value field should be set to the target receiver addresses in this group.

Attention This API shall be called before mesh is started. Attention Mesh RX queue should be checked regularly to avoid running out of memory.

data — [out] pointer to the received mesh packet Field proto is the data protocol in use. Should follow it to parse the received data. If this size is too small, it will impact the efficiency on upstream. How to decide this value depends on the specific application scenarios. Attention This API is only called by the root. to — [out] the address contains remote IP address and port IPv4:PORT. data — [out] pointer to the received packet Contain the protocol and applications should follow it to parse the data.

Root shall forward this data to external IP network via the association with router. Mesh ID is an identifier of an MBSS. Nodes with the same mesh ID can communicate with each other. It means more than one mesh network is established with the same mesh ID. Because users might have such requirements of setting up routers with same SSID for the future replacement.

But in that case, if the above situations happen, please make sure applications implement forward functions on the root to guarantee devices in different mesh networks can communicate with each other. Attention This API shall be called before mesh is started after mesh is initialized. Attention This API is used to dynamically modify the router configuration after mesh is configured.

Attention This API is used to dynamically modify the mesh network ID. Self-organized networking has three main functions: select the root node; find a preferred parent; initiate reconnection if a disconnection is detected. Attention This API is used to dynamically modify whether to enable the self organizing. A device is elected root primarily based on RSSI from the external router.

In this API, users could specify a desired root address to replace itself or specify an attempts value to ask current root to initiate a new round of voting.

During the voting, a better root candidate would be expected to find to replace the current one. If no desired root candidate, the vote will try a specified number of attempts at least If no better root candidate is found, keep the current one. If a better candidate is found, the new better one will send a root switch request to the current root, current root will respond with a root switch acknowledgment.

After that, the new candidate will connect to the router to be a new root, the previous root will disconnect with the router and choose another parent instead. vote — [in] vote configuration If this parameter is set NULL, the vote will perform the default 15 times. During the networking, only obtaining vote percentage reaches this threshold, the device could be a root.

Attention The returned value might be incorrect when the network is changing. size — [out] pointer to the number of devices in routing table including itself. reachable — [in] this state represents whether the root is able to access external IP network. Attention This API can be called at any time after mesh is initialized.

Enabling fixed root disables automatic election of the root node via voting. Attention This API can be called at any time after mesh is configured. parent — [in] parent configuration, the SSID and the channel of the parent are mandatory. If the BSSID is set, make sure that the SSID and BSSID represent the same parent, otherwise the device will never find this specified parent.

nodes — [out] pointer to nodes in the subnet of a specific child. If the device is not in active state, it will neither transmit nor receive frames. Attention This API can be called at any time after mesh is started. If an existing NWK-DUTY-MASTER leaves the network, the root will take over as the NWK-DUTY-MASTER again. In a mesh network, devices are typically working with a certain duty-cycle transmitting, receiving and sleep to reduce the power consumption.

The running active duty cycle decides the amount of awake time within a beacon interval. At each start of beacon interval, all devices wake up, broadcast beacons, and transmit packets if they do have pending packets for their parents or for their children.

Note that Low-duty-cycle means devices may not be active in most of the time, the latency of data transmission might be greater. toDS state, devices shall check this state firstly before trying to send packets to external IP network.

This state indicates right now whether the root is capable of sending packets out. max vote attempts before a new root is elected automatically by mesh network. min, 15 by default. The new router might also be on a different channel. The default value is false. There is a risk that if the password is different between the new switched router and the previous one, the mesh network could be established but the root will never connect to the new switched router.

if false, attempts value shall be specified to make network start root election. in the situation of the root having been changed, identify this packet can be dropped by new root. requests to join a network PS without specifying a device duty cycle. After the device joins the network, a network duty cycle will be provided by the network.

the root is asked yield by a more powerful existing root. If self organized is disabled and this device is specified to be a root by users, users should set a new parent for this device. if self organized is enabled, this device will find a new parent by itself, users could ignore this event.

Fixed Root Setting of each device is variable as that setting changes of the root. the root stops reconnecting to the router and non-root devices stop reconnecting to their parents. when the channel field in mesh configuration is set to zero, mesh stack will perform a full channel scan to find a mesh network that can join, and return the channel value after finding it.

if users specify BSSID of the router in mesh configuration, when the root connects to another router with the same SSID, this event will be posted and the new router information is attached.

ESP-IDF 编程指南 Choose target Choose version Public Members int attempts  max vote attempts before a new root is elected automatically by mesh network. Public Members int toDS  to external DS int toSelf  to self.

It is recommended that request messages be sent asynchronously for improved efficiency; that is, the client software need not wait for a response to a prior request before sending another. Yes, it is possible. Remember me on this computer. Writing data to TEA The useful details about writing the byte and reading the byte can be obtained from page numbers 13 through 16 of the datasheet Rev. Many pins of the chip here have more than one function.

Categories:

• Forex Brokers
• Binary Options
• Binary Options online
• Forex Bitcoin
• Forex