The world’s first scent-inspired hackathon

English / 日本語

Hackaroma Official Site

Overview
- Applications open May 13th. Livestreaming demos June 19th.
- Official rules: PDF
- Proposal Screening Round (5/13 ~ 5/28):
  - Proposal guidelines, suggestions, things to know → A short guide
  - Sample Proposal
- Development Round (5/28 ~ 6/19):
  - Six finalists (individuals or teams) will develop their ideas. We will do what we can to get an Aroma Shooter dev kit to you quickly, however finalists may start development with or without a device. Dev kits will include a set of cartridges. The plan is to send the same set of cartridges to all finalists, the list of which you’ll find below.
  - On the final day, June 19th (Friday) JST, at a TBD time, we will host an online pitch event where finalists demo their projects such that pre-selected audience members with Aroma Shooters will be able to smell the scents in the demo simultaneously. This may in fact be the world’s first scent data livestreaming.
  - Aroma Shooters are controlled through the Internet using AWS IoT, of which SDKs are available for iOS, Android, Java, Javascript, Python, C++, and more. Learn more here. More details and guides specific to the Aroma Shooter coming soon.
Example Aroma Shooter solutions:
What types of scents will be available for the development round?
- Each finalist will receive the following with their Aroma Shooter kit:
  - Imitation Chanel #5
  - Mango
  - Coffee
  - Lavender
  - Forest
  - Hinoki
  - Spearmint
  - お香 (Incense)
  - Lemon
  - Fresh Cut Grass
  - Burnt Rubber
  - Ocean
  - Caramel
- There are 13 (we have recently decided to add Caramel to the list) here, of which you may use 6 in one Aroma Shooter simultaneously. What do you think? Do these spark your creativity?
How do I communicate with other Aroma Shooters through the Internet? (Old setup)

HTTP-based Aroma Shooter control flow.

Flow of controlling Aroma Shooter via Internet

Steps
- Connect your Aroma Shooter to a local network which is connected with the Internet. If you don’t know how, please refer to this document.
- Send HTTP request to control.　※ The device will automatically disconnect after roughly 1 hour without any receiving request. If it happens, please plug the device out from the power source and then plug it in again.
Unicast vs. Broadcast
- Unicast is a casting type by which you control only your device.
- Broadcast is a casting type by which you control all devices in a pre-registered list (including your own).
- During the development period, both unicast and broadcast casting types will only control your device.
- There is a rehearsal time (we will meet with each finalist individually), where broadcasting will control a set of testing devices at our office.
- On the day of the final pitch, broadcasting will control all registered devices, including yours, ours, judges’ and probably others’. So on the day of the final pitch, please DO NOT broadcast unless it is your turn to demo.
Which credentials are required?
- API Key: this will be mailed to each of you.
- Private Key: this will be mailed to each of you. Each finalist has a distinct key.

What is the design of the HTTP API?

Warning!: Continuously diffusing for more than 10 seconds from one channel might damage your Aroma Shooter. If you want to diffuse for 15 seconds from channel 3, it is recommended that you diffuse for 5 seconds, pause for 5 seconds, then diffuse again for 5 seconds. For these purposes, the ‘booster’ is considered its own channel. More info on that below.
URL: https://lvxcf3yn35.execute-api.us-west-2.amazonaws.com/prod/as2/control
Type of request: POST
Header must include the API Key.

Attachment: JSON data, which includes the following fields

To diffuse:

  {
      "private_key":"your_private_key_that_we_provide",
      "casting":"unicast/broadcast", // choose between unicast or broadcast
      "type":"diffuse", // leave this alone
      "duration":"time_to_diffuse_in_milliseconds", // make sure this is less than 10000
      "booster":"true/false", // "true" will activate the Aroma Shooter's extra fan, which pushes scents slightly farther
      "channel":"1~6", // corresponds to the channel number of the cartridge you want to activate
      "intensity":"0-100" // choose any integer between 0 and 100. 100 is full intensity, 0 will not diffuse
  }

Example:

  {
      "private_key":"qaLUDC7w", // use your own private key
      "casting":"unicast",
      "type":"diffuse",
      "duration":"3000",
      "booster":"true",
      "channel":"1",
      "intensity":"75"
  }

To halt diffusion of a specific cartridge:

{
    "private_key":"your_private_key_that_we_provide",
    "casting":"unicast/broadcast", // choose between unicast or broadcast
    "type": "stop", // leave this alone
    "channel":"1~6", // corresponds to the channel number of the cartridge you want to stop
}

Example:

{
    "private_key":"qaLUDC7w", // use your own private key
    "casting":"broadcast",
    "type":"stop",
    "channel":"1"
}

How can I test sending HTTP requests?
- We highly recommend using Postman (Set up URL and header) (Set up JSON data)
How many times can I send requests per day?
- This API server is running on AWS Serverless framework, which is a paid service. We prepared it for roughly up to 5000 requests per day.
- This is the total number of requests this server can receive per day. If you find this too restrictive, ask us about using our local HTTP API on days where you expect to make an excessive number of requests, and please try to wait until the following day when the limit refreshes.
- Roughly, each finalist has more than 800 requests/day. Please be mindful.
Finally, should you have any technical questions, feel free to reach out via hackaroma@aromajoin.com.

hackaroma

Hackaroma

The world’s first scent-inspired hackathon