Skip to content

Commit

Permalink
Update docs + changelog. Bump version.
Browse files Browse the repository at this point in the history
  • Loading branch information
brocaar committed Jan 13, 2020
1 parent 0fb5f29 commit f9c45ce
Show file tree
Hide file tree
Showing 4 changed files with 70 additions and 2 deletions.
2 changes: 1 addition & 1 deletion docs/config.toml
Original file line number Diff line number Diff line change
Expand Up @@ -62,5 +62,5 @@ theme = "chirpstack-hugo-theme"
weight = 8

[params]
version = "3.5.0"
version = "3.6.0"
component = "chirpstack-gateway-bridge"
24 changes: 24 additions & 0 deletions docs/content/overview/changelog.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,30 @@ description: Lists the changes per ChirpStack Gateway Bridge release, including

# Changelog

## v3.6.0

### Features

#### Raw packet-forwarder events / commands

Using the raw packet-forwarder events and commands, it is possible to use the
[BasicStation Remote Command](https://doc.sm.tc/station/tcproto.html#remote-command)
and [BasicStation Remote Shell](https://doc.sm.tc/station/tcproto.html#remote-shell)
features.

#### Terminate on connect error

The `terminate_on_connect_error` will terminate the ChirpStack Gateway Bridge
process when it can't connect to the MQTT broker. In some cases this is
preferred over the retry loop.

### Improvements

#### FSK FDev

Before the frequency deviation was always set to the FSK `datarate / 2`. It
is now possible to set it manually (falling back on `datarate / 2` when unset).

## v3.5.0

### Features
Expand Down
22 changes: 22 additions & 0 deletions docs/content/payloads/commands.md
Original file line number Diff line number Diff line change
Expand Up @@ -136,3 +136,25 @@ variables that are already exposed to the "main" process.
### Protobuf

This message is defined by the `GatewayCommandExecRequest` Protobuf message.

## `raw` - Raw packet-forwarder command

This payload is used for raw packet-forwarder commands that are not integrated
with the ChirpStack Gateway Bridge. Currently these are the:

* [BasicStation Remote Command](https://doc.sm.tc/station/tcproto.html#remote-command)
* [BaiscStation Remote Shell](https://doc.sm.tc/station/tcproto.html#remote-shell)

### JSON

{{<highlight json>}}
{
"gatewayID": "cnb/AC4GLBg=",
"rawID": "gsy9FN+rTwOEL8YzJJo+Kw==",
"payload": "[BASE64 ENCODED BLOB]"
}
{{</highlight>}}

### Protobuf

This message is defined by the `RawPacketForwarderCommand` Protobuf message.
24 changes: 23 additions & 1 deletion docs/content/payloads/events.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ description: Events are uplinks, acks and statistics sent by the gateway.
Events are generated by the ChirpStack Gateway Bridge and forwarded to the configured
integration. Depending the `marshaler` configuration, these are sent as JSON or
[Protobuf](https://developers.google.com/protocol-buffers/). For the Protobuf
definitions, please refer to [gw.proto](https://github.com/brocaar/chirpstack-network-server/blob/master/api/gw/gw.proto).
definitions, please refer to [gw.proto](https://github.com/brocaar/chirpstack-api/blob/master/protobuf/gw/gw.proto).

* The Protocol Buffers [JSON Mapping](https://developers.google.com/protocol-buffers/docs/proto3#json)
defines that bytes must be encoded as base64 strings. This also affects the `gatewayID` field.
Expand Down Expand Up @@ -138,3 +138,25 @@ execution output (or possible error).
### Protobuf

This message is defined by the `GatewayCommandExecResponse` Protobuf message.

## `raw` - Raw packet-forwarder event

This payload is used for raw packet-forwarder events that are not integrated
with the ChirpStack Gateway Bridge. Currently these are the:

* [BasicStation Remote Command](https://doc.sm.tc/station/tcproto.html#remote-command)
* [BaiscStation Remote Shell](https://doc.sm.tc/station/tcproto.html#remote-shell)

### JSON

{{<highlight json>}}
{
"gatewayID": "cnb/AC4GLBg=",
"rawID": "gsy9FN+rTwOEL8YzJJo+Kw==",
"payload": "[BASE64 ENCODED BLOB]"
}
{{</highlight>}}

### Protobuf

This message is defined by the `RawPacketForwarderEvent` Protobuf message.

0 comments on commit f9c45ce

Please sign in to comment.