add convenience mapping methods. Add documentation for new protocol.